# @spacefast/common

> Shared TypeScript contracts and utilities for Spacefast packages.

Latest version **0.5.0** (published 2026-09-27) · MIT license · 0 weekly downloads

## Install

```sh
npm install @spacefast/common
pnpm add @spacefast/common
yarn add @spacefast/common
bun add @spacefast/common
```

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.5.0 |
| Published | 2026-09-27 |
| First published | 2026-06-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=20 |
| Dependencies | 5 |
| Unpacked size | 5.4 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | bi |

## Links

- npm: https://www.npmjs.com/package/@spacefast/common
- Repository: https://github.com/spacefast/monorepo
- Homepage: https://github.com/spacefast/monorepo#readme
- Issues: https://github.com/spacefast/monorepo/issues
- npm.io page: https://npm.io/package/@spacefast/common

## Dependencies (5)

- [zod](https://npm.io/package/zod.md) ^4.4.3
- [mime](https://npm.io/package/mime.md) ^4.1.0
- [culori](https://npm.io/package/culori.md) ^4.0.2
- [parse5](https://npm.io/package/parse5.md) ^7.3.0
- [oauth4webapi](https://npm.io/package/oauth4webapi.md) 3.8.7

## Recent versions

- 0.5.0 (latest) — 2026-09-27
- 0.4.1 — 2026-09-10
- 0.2.2 — 2026-08-28
- 0.2.1 — 2026-08-28
- 0.0.26 — 2026-08-22
- 0.0.24 — 2026-08-12
- 0.0.23 — 2026-08-06
- 0.0.21 — 2026-08-05
- 0.0.20 — 2026-08-05
- 0.0.19 — 2026-08-05
- 0.0.18 — 2026-08-05
- 0.0.17 — 2026-08-05
- 0.0.13 — 2026-07-31
- 0.0.12 — 2026-07-27
- 0.0.11 — 2026-07-19
- … 8 more at https://npm.io/package/@spacefast/common/versions

## README

# `@spacefast/common`

Shared TypeScript contracts and utilities used by Spacefast first-party packages.

Most users should install the CLI or framework integrations instead:

```bash
curl -fsSL https://spacefast.com/install.sh | bash
```

Use this package directly only when you are building against Spacefast contracts or
need the same validation helpers used by the CLI and dashboard.

## Install

```bash
npm install @spacefast/common
```

## Exports

```ts
import { spacePatchSchema } from "@spacefast/common/contracts/spaces";
import { detectSpaFromPaths } from "@spacefast/common/utils/publish-detection";
```

The public exports are grouped by concern:

- `@spacefast/common/contracts/*` for shared API and CLI schemas.
- `@spacefast/common/utils/*` for small helpers used across Spacefast packages.
- `@spacefast/common/docs/*` for agent-facing setup text used by Spacefast surfaces.

This package is public so the Spacefast CLI and plugins can install cleanly from
npm. It is still an implementation package: prefer documented CLI and API
surfaces unless you need these exact contracts.

## Documentation

- [Spacefast docs](https://spacefast.com/docs)
- [CLI docs](https://spacefast.com/docs/cli)
- [API docs](https://spacefast.com/docs/api)
- [LLM guide](https://spacefast.com/docs/llms.txt)

---
_Source: https://npm.io/package/@spacefast/common · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._