Monorepo set up: workspaces, contracts package, placeholders

npm workspaces (packages/*, apps/*) with shared TypeScript, ESLint and
Jest setup and `npm run check`. @crosscode/contracts builds to CommonJS
and ESM (tsup) with the crosscode.<name>/<major> schema-name helpers.
packages/ui and apps/{accounts,website,app} are placeholders.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-04 09:36:42 +02:00
co-authored by Claude Opus 5.5
commit 19f79dfb17
24 changed files with 7609 additions and 0 deletions
+7
View File
@@ -0,0 +1,7 @@
/**
* @crosscode/contracts — the shared JSON formats used by every Cross Code product
* (ROADMAP-v3 §2). Contracts to come in 1.0.0: `crosscode.event/1`, `crosscode.church/1`,
* `crosscode.identity/1` and Hub protocol v3.
*/
export { schemaName, parseSchemaName, isSchema } from "./schema-name";
export type { SchemaName } from "./schema-name";
+37
View File
@@ -0,0 +1,37 @@
/**
* Every payload that crosses between products carries its `schema` name, so a consumer always
* knows what it's reading (ROADMAP-v3 §2): `crosscode.<name>/<major>`, e.g. `crosscode.event/1`.
*
* Versioning:
* - Adding an optional field keeps the major version. Consumers ignore fields they don't know.
* - Removing or renaming a field, or changing its meaning, needs the next major (`/2`), served
* alongside the old one until every install has updated.
*/
const SCHEMA_NAME = /^crosscode\.([a-z][a-z0-9-]*)\/([1-9][0-9]*)$/;
export interface SchemaName {
name: string;
major: number;
}
/** Builds a schema name: `schemaName("event", 1)` → `"crosscode.event/1"`. */
export function schemaName<N extends string, M extends number>(name: N, major: M): `crosscode.${N}/${M}` {
const result = `crosscode.${name}/${major}` as const;
if (!SCHEMA_NAME.test(result)) throw new Error(`Invalid schema name: ${result}`);
return result;
}
/** Splits a schema name into its name and major version, or returns `null` if it isn't one. */
export function parseSchemaName(value: unknown): SchemaName | null {
if (typeof value !== "string") return null;
const match = SCHEMA_NAME.exec(value);
if (!match) return null;
return { name: match[1]!, major: Number(match[2]) };
}
/** True when `value` is a payload's `schema` for the given name and major version. */
export function isSchema(value: unknown, name: string, major: number): boolean {
const parsed = parseSchemaName(value);
return parsed !== null && parsed.name === name && parsed.major === major;
}