@antasphere/chassis-contract 0.0.0-stage → 1.0.0

package/dist/wire.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+/**
+ * The chassis's side of the hub–tool wire check (PRDCT-2677). The hub owns
+ * the messages the tools exchange with it and publishes them as ONE
+ * generated snapshot, `packages/contract/wire/hub-tool-messages.json` of the
+ * hub, built by its `packages/contract/src/wire.ts`. The block below, from
+ * `WIRE_SCHEMA_KEYS` to `buildWireSnapshot`, is the chassis's copy of that
+ * builder, kept VERBATIM so both sides compute the same picture: the same
+ * JSON Schema export, the same probe verdicts, the same occurrence table.
+ * The hub's inputs (its offsets and probe payloads) and its definitions are
+ * NOT copied: the inputs are read back from the hub's file
+ * (`wireInputsOf`), the definitions are this package's own copies
+ * (`CHASSIS_WIRE_DEFINITIONS`, from `entitlements.ts`).
+ *
+ * `compareWireSnapshots` names every difference by its dotted path;
+ * `scripts/hub-wire-check.mjs` (`pnpm --filter @antasphere/chassis-contract
+ * wire:check`, the `hub-wire` CI job against the hub's `dev`) fails on any.
+ * The check runs one way: the hub changes first, the chassis follows.
+ */
+/** The keys of the six shapes, the same on both sides. */
+export declare const WIRE_SCHEMA_KEYS: readonly ["usageEvent", "usageEventsBatch", "usageIngestResult", "usageEntitlements", "usageCheckRequest", "usageCheck"];
+export type WireSchemaKey = (typeof WIRE_SCHEMA_KEYS)[number];
+export interface WireConstants {
+    USAGE_WRITE_SCOPE: string;
+    BILLING_PLANS: readonly string[];
+    USAGE_EVENTS_BATCH_MAX: number;
+    USAGE_EVENT_MAX_PAST_MS: number;
+    USAGE_EVENT_MAX_FUTURE_MS: number;
+    USAGE_CHECK_REASONS: readonly string[];
+    USAGE_REJECT_REASONS: readonly string[];
+    USAGE_ROUTE_ERRORS: Readonly<Record<string, number>>;
+}
+export interface WireProbe {
+    name: string;
+    input: unknown;
+}
+export interface WireProbeResult extends WireProbe {
+    /** Whether the schema accepts the input. */
+    ok: boolean;
+}
+export interface WireOccurrence {
+    /** The event's `occurredAt` minus the receipt time, in milliseconds. */
+    offsetMs: number;
+    issue: {
+        path: 'occurredAt';
+        message: string;
+    } | null;
+}
+/** What one side feeds the builder: its own definitions. */
+export interface WireDefinitions {
+    constants: WireConstants;
+    schemas: Record<WireSchemaKey, z.ZodType>;
+    occurrenceIssue: (occurredAt: Date, receivedAt: Date) => {
+        path: 'occurredAt';
+        message: string;
+    } | null;
+}
+/** The inputs the snapshot is computed on: the hub's, read back by the chassis from the hub's file. */
+export interface WireInputs {
+    occurrenceOffsetsMs: readonly number[];
+    probes: Record<WireSchemaKey, readonly WireProbe[]>;
+}
+export interface HubToolWireSnapshot {
+    v: 1;
+    constants: WireConstants;
+    schemas: Record<WireSchemaKey, unknown>;
+    occurrence: WireOccurrence[];
+    probes: Record<WireSchemaKey, WireProbeResult[]>;
+}
+/**
+ * Build the snapshot from one side's definitions on the given inputs. The
+ * SAME function runs on both sides (the chassis carries a verbatim copy):
+ * the hub with its own inputs, the chassis with the inputs read from the
+ * hub's file. Deterministic: no clock, no randomness, no environment.
+ */
+export declare function buildWireSnapshot(defs: WireDefinitions, inputs: WireInputs): HubToolWireSnapshot;
+/** The chassis's definitions: this package's copies of the hub's shapes, under the hub's keys. */
+export declare const CHASSIS_WIRE_DEFINITIONS: WireDefinitions;
+/** The inputs the hub computed its snapshot on, read back from its file: the offsets and the probe payloads. */
+export declare function wireInputsOf(reference: HubToolWireSnapshot): WireInputs;
+/** The snapshot the chassis's copies give on the hub's own inputs: what must equal the hub's file. */
+export declare function chassisWireSnapshot(reference: HubToolWireSnapshot): HubToolWireSnapshot;
+/** One place where the hub's snapshot and the chassis's differ: its dotted path and the two values. */
+export interface WireDifference {
+    path: string;
+    hub: unknown;
+    chassis: unknown;
+}
+/**
+ * Every difference between the hub's snapshot and the chassis's, by dotted
+ * path (`constants.USAGE_CHECK_REASONS[2]`,
+ * `schemas.usageCheck.properties.reason.anyOf[0].enum`,
+ * `probes.usageCheck[3].ok`). Objects compare by the union of their keys,
+ * order ignored, an absent key and `undefined` being the same; arrays by
+ * index, a length difference being one difference at the array's path.
+ * Deterministic: keys sorted, arrays in order. Empty when they agree.
+ */
+export declare function compareWireSnapshots(hub: HubToolWireSnapshot, chassis: HubToolWireSnapshot): WireDifference[];
+/** One line of figures for a snapshot: `6 shapes, N constants, M probes, K occurrence offsets`. */
+export declare function describeWireSnapshot(snapshot: HubToolWireSnapshot): string;
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB;;;;;;;;;;;;;;;;;GAiBG;AAIH,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,0HAOnB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;IAClC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,4CAA4C;IAC5C,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACvD;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAC1C,eAAe,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,KAAK;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACzG;AAED,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,eAAe,EAAE,CAAC,CAAC;CAClD;AAKD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,GAAG,mBAAmB,CAiChG;AAID,kGAAkG;AAClG,eAAO,MAAM,wBAAwB,EAAE,eAoBtC,CAAC;AAEF,gHAAgH;AAChH,wBAAgB,YAAY,CAAC,SAAS,EAAE,mBAAmB,GAAG,UAAU,CASvE;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,mBAAmB,GAAG,mBAAmB,CAEvF;AAED,uGAAuG;AACvG,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AA+BD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,cAAc,EAAE,CAIlB;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAK1E"}

package/dist/wire.js

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import { BILLING_PLANS, USAGE_CHECK_REASONS, USAGE_EVENT_MAX_FUTURE_MS, USAGE_EVENT_MAX_PAST_MS, USAGE_EVENTS_BATCH_MAX, USAGE_REJECT_REASONS, USAGE_ROUTE_ERRORS, USAGE_WRITE_SCOPE, entitlementProfileSchema, usageCheckRequestSchema, usageCheckSchema, usageEventOccurrenceIssue, usageEventSchema, usageEventsBatchSchema, usageIngestResultSchema } from './entitlements.js';
+/**
+ * The chassis's side of the hub–tool wire check (PRDCT-2677). The hub owns
+ * the messages the tools exchange with it and publishes them as ONE
+ * generated snapshot, `packages/contract/wire/hub-tool-messages.json` of the
+ * hub, built by its `packages/contract/src/wire.ts`. The block below, from
+ * `WIRE_SCHEMA_KEYS` to `buildWireSnapshot`, is the chassis's copy of that
+ * builder, kept VERBATIM so both sides compute the same picture: the same
+ * JSON Schema export, the same probe verdicts, the same occurrence table.
+ * The hub's inputs (its offsets and probe payloads) and its definitions are
+ * NOT copied: the inputs are read back from the hub's file
+ * (`wireInputsOf`), the definitions are this package's own copies
+ * (`CHASSIS_WIRE_DEFINITIONS`, from `entitlements.ts`).
+ *
+ * `compareWireSnapshots` names every difference by its dotted path;
+ * `scripts/hub-wire-check.mjs` (`pnpm --filter @antasphere/chassis-contract
+ * wire:check`, the `hub-wire` CI job against the hub's `dev`) fails on any.
+ * The check runs one way: the hub changes first, the chassis follows.
+ */
+// ── Copied VERBATIM from the hub's packages/contract/src/wire.ts ──────────
+/** The keys of the six shapes, the same on both sides. */
+export const WIRE_SCHEMA_KEYS = [
+    'usageEvent',
+    'usageEventsBatch',
+    'usageIngestResult',
+    'usageEntitlements',
+    'usageCheckRequest',
+    'usageCheck'
+];
+/** A fixed receipt time, so the occurrence table is the same on every run. */
+const RECEIVED_AT = new Date('2026-09-23T12:00:00.000Z');
+/**
+ * Build the snapshot from one side's definitions on the given inputs. The
+ * SAME function runs on both sides (the chassis carries a verbatim copy):
+ * the hub with its own inputs, the chassis with the inputs read from the
+ * hub's file. Deterministic: no clock, no randomness, no environment.
+ */
+export function buildWireSnapshot(defs, inputs) {
+    const schemas = {};
+    const probes = {};
+    for (const key of WIRE_SCHEMA_KEYS) {
+        const schema = defs.schemas[key];
+        // A refinement has no JSON Schema form and is dropped on both sides
+        // alike; the probes below carry what it decides.
+        schemas[key] = z.toJSONSchema(schema, { unrepresentable: 'any' });
+        probes[key] = inputs.probes[key].map((probe) => ({
+            name: probe.name,
+            input: probe.input,
+            ok: schema.safeParse(probe.input).success
+        }));
+    }
+    return {
+        v: 1,
+        constants: {
+            USAGE_WRITE_SCOPE: defs.constants.USAGE_WRITE_SCOPE,
+            BILLING_PLANS: [...defs.constants.BILLING_PLANS],
+            USAGE_EVENTS_BATCH_MAX: defs.constants.USAGE_EVENTS_BATCH_MAX,
+            USAGE_EVENT_MAX_PAST_MS: defs.constants.USAGE_EVENT_MAX_PAST_MS,
+            USAGE_EVENT_MAX_FUTURE_MS: defs.constants.USAGE_EVENT_MAX_FUTURE_MS,
+            USAGE_CHECK_REASONS: [...defs.constants.USAGE_CHECK_REASONS],
+            USAGE_REJECT_REASONS: [...defs.constants.USAGE_REJECT_REASONS],
+            USAGE_ROUTE_ERRORS: { ...defs.constants.USAGE_ROUTE_ERRORS }
+        },
+        schemas,
+        occurrence: inputs.occurrenceOffsetsMs.map((offsetMs) => ({
+            offsetMs,
+            issue: defs.occurrenceIssue(new Date(RECEIVED_AT.getTime() + offsetMs), RECEIVED_AT)
+        })),
+        probes
+    };
+}
+// ── The chassis's own half ─────────────────────────────────────────────────
+/** The chassis's definitions: this package's copies of the hub's shapes, under the hub's keys. */
+export const CHASSIS_WIRE_DEFINITIONS = {
+    constants: {
+        USAGE_WRITE_SCOPE,
+        BILLING_PLANS,
+        USAGE_EVENTS_BATCH_MAX,
+        USAGE_EVENT_MAX_PAST_MS,
+        USAGE_EVENT_MAX_FUTURE_MS,
+        USAGE_CHECK_REASONS,
+        USAGE_REJECT_REASONS,
+        USAGE_ROUTE_ERRORS
+    },
+    schemas: {
+        usageEvent: usageEventSchema,
+        usageEventsBatch: usageEventsBatchSchema,
+        usageIngestResult: usageIngestResultSchema,
+        usageEntitlements: entitlementProfileSchema,
+        usageCheckRequest: usageCheckRequestSchema,
+        usageCheck: usageCheckSchema
+    },
+    occurrenceIssue: usageEventOccurrenceIssue
+};
+/** The inputs the hub computed its snapshot on, read back from its file: the offsets and the probe payloads. */
+export function wireInputsOf(reference) {
+    const probes = {};
+    for (const key of WIRE_SCHEMA_KEYS) {
+        probes[key] = (reference.probes[key] ?? []).map((probe) => ({ name: probe.name, input: probe.input }));
+    }
+    return {
+        occurrenceOffsetsMs: reference.occurrence.map((row) => row.offsetMs),
+        probes
+    };
+}
+/** The snapshot the chassis's copies give on the hub's own inputs: what must equal the hub's file. */
+export function chassisWireSnapshot(reference) {
+    return buildWireSnapshot(CHASSIS_WIRE_DEFINITIONS, wireInputsOf(reference));
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function childPath(parent, key) {
+    return /^[A-Za-z_$][\w$]*$/.test(key)
+        ? parent === ''
+            ? key
+            : `${parent}.${key}`
+        : `${parent}[${JSON.stringify(key)}]`;
+}
+function compareAt(path, hub, chassis, out) {
+    if (Array.isArray(hub) && Array.isArray(chassis)) {
+        if (hub.length !== chassis.length) {
+            out.push({ path, hub, chassis });
+            return;
+        }
+        for (let i = 0; i < hub.length; i += 1)
+            compareAt(`${path}[${i}]`, hub[i], chassis[i], out);
+        return;
+    }
+    if (isPlainObject(hub) && isPlainObject(chassis)) {
+        const keys = [...new Set([...Object.keys(hub), ...Object.keys(chassis)])].sort();
+        for (const key of keys)
+            compareAt(childPath(path, key), hub[key], chassis[key], out);
+        return;
+    }
+    if (!Object.is(hub, chassis))
+        out.push({ path, hub, chassis });
+}
+/**
+ * Every difference between the hub's snapshot and the chassis's, by dotted
+ * path (`constants.USAGE_CHECK_REASONS[2]`,
+ * `schemas.usageCheck.properties.reason.anyOf[0].enum`,
+ * `probes.usageCheck[3].ok`). Objects compare by the union of their keys,
+ * order ignored, an absent key and `undefined` being the same; arrays by
+ * index, a length difference being one difference at the array's path.
+ * Deterministic: keys sorted, arrays in order. Empty when they agree.
+ */
+export function compareWireSnapshots(hub, chassis) {
+    const out = [];
+    compareAt('', hub, chassis, out);
+    return out;
+}
+/** One line of figures for a snapshot: `6 shapes, N constants, M probes, K occurrence offsets`. */
+export function describeWireSnapshot(snapshot) {
+    const shapes = Object.keys(snapshot.schemas).length;
+    const constants = Object.keys(snapshot.constants).length;
+    const probes = Object.values(snapshot.probes).reduce((n, list) => n + list.length, 0);
+    return `${shapes} shapes, ${constants} constants, ${probes} probes, ${snapshot.occurrence.length} occurrence offsets`;
+}
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@antasphere/chassis-contract",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/antasphere/chassis.git",
+    "directory": "packages/chassis-contract"
+  },
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src",
+    "test",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./routes": {
+      "types": "./dist/routes/index.d.ts",
+      "default": "./dist/routes/index.js"
+    }
+  },
+  "dependencies": {
+    "@hono/zod-openapi": "^1.4.0",
+    "zod": "^4.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src test",
+    "test": "vitest run --passWithNoTests",
+    "wire:check": "node scripts/hub-wire-check.mjs"
+  }
 }

package/src/define.ts

@@ -0,0 +1,64 @@
+import type { z } from 'zod';
+import { defineApiKeySchemas } from './schemas/api-keys.js';
+import { defineCliAuthSchemas } from './schemas/cli-auth.js';
+import { defineMeSchemas } from './schemas/me.js';
+import { defineScopeSchema, type ScopeSchema, type ScopeTuple } from './schemas/scope.js';
+
+/**
+ * The scope-dependent half of the chassis contract. Everything else in this
+ * package is a plain static export; these schemas transitively hold the
+ * tool's scope enum, so they are BUILT, once per tool, from the scopes the
+ * tool names — no module-level state, the returned object is the contract.
+ *
+ *   const { read, write, dataExport } = IDENTITY.scopes; // the tool's `ToolIdentity` value
+ *   const contract = defineChassisContract({ scopes: [read, write, dataExport] });
+ *   export const { scopeSchema, apiKeySchema, meResponseSchema } = contract;
+ *   export type Scope = ScopeOf<typeof contract>;
+ *
+ * The scopes are a TUPLE, in the order the enum publishes them: a tool with
+ * more scopes than the three parts of its identity appends them here.
+ *
+ * The route contracts over these schemas come from
+ * `defineChassisRoutes(contract, IDENTITY, copy)` on the `./routes` entry (it pulls
+ * Hono; this one stays client-safe).
+ */
+export function defineChassisContract<const TScopes extends ScopeTuple>(tool: {
+  scopes: TScopes;
+}): ChassisContract<TScopes[number]> {
+  return buildChassisContract(defineScopeSchema(tool.scopes));
+}
+
+function buildChassisContract<TScope extends string>(scopeSchema: ScopeSchema<TScope>) {
+  const apiKeys = defineApiKeySchemas(scopeSchema);
+  return {
+    scopeSchema,
+    ...apiKeys,
+    ...defineCliAuthSchemas(apiKeys.apiKeySchema),
+    ...defineMeSchemas(scopeSchema)
+  };
+}
+
+/** The contract a tool gets for its scopes (`TScope` = the union of the scope literals). */
+export type ChassisContract<TScope extends string> = ReturnType<typeof buildChassisContract<TScope>>;
+
+/** The loosest reading of a contract — what the `…Of` type helpers below accept. */
+export type ChassisContractShape = { [K in keyof ChassisContract<string>]: z.ZodType };
+
+/**
+ * The inferred types of an instantiated contract, under the names their
+ * schemas have always had: `type Scope = ScopeOf<typeof contract>`.
+ */
+export type ScopeOf<C extends Pick<ChassisContractShape, 'scopeSchema'>> = z.infer<C['scopeSchema']>;
+export type ApiKeyInfoOf<C extends Pick<ChassisContractShape, 'apiKeySchema'>> = z.infer<C['apiKeySchema']>;
+export type ApiKeyCreateOf<C extends Pick<ChassisContractShape, 'apiKeyCreateSchema'>> = z.infer<
+  C['apiKeyCreateSchema']
+>;
+export type ApiKeyCreatedOf<C extends Pick<ChassisContractShape, 'apiKeyCreatedSchema'>> = z.infer<
+  C['apiKeyCreatedSchema']
+>;
+export type CliAuthCompletedOf<C extends Pick<ChassisContractShape, 'cliAuthCompletedSchema'>> = z.infer<
+  C['cliAuthCompletedSchema']
+>;
+export type MeResponseOf<C extends Pick<ChassisContractShape, 'meResponseSchema'>> = z.infer<
+  C['meResponseSchema']
+>;