@antasphere/chassis-contract 1.0.0 → 1.0.1

package/src/entitlements.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { BILLING_PLANS, billingPlanSchema, type BillingPlan } from '@antasphere/contract';
 import type { HeaderReader, Principal } from './seams.js';
 
 /**
@@ -15,241 +16,53 @@ import type { HeaderReader, Principal } from './seams.js';
  * read the same declarations without pulling the server.
  */
 
-/**
- * The plan tiers, a CLOSED enum the hub owns and this contract mirrors so a
- * tool cannot invent one (§8b). `free` is the default with no subscription;
- * `pro` is the paid plan. "Enterprise" is not a tier but a per-account
- * override the hub serves.
- */
-export const ENTITLEMENT_TIERS = ['free', 'pro'] as const;
-export type EntitlementTier = (typeof ENTITLEMENT_TIERS)[number];
-export const entitlementTierSchema = z.enum(ENTITLEMENT_TIERS);
-/** The hub's name for the same closed enum (`BILLING_PLANS` in `@antasphere/contract`). */
-export const BILLING_PLANS = ENTITLEMENT_TIERS;
+// ── The hub's half: the messages the tool exchanges with the hub ──────────
+//
+// The hub owns these shapes and publishes them as `@antasphere/contract`
+// (the hub's own contract package, on npm at the hub's version); this file
+// re-exports them under the names the chassis has always used, so a tool
+// reads exactly what the hub wrote and a change at the hub reaches every
+// tool through one dependency bump (PRDCT-3325; before it, a hand copy checked
+// against the hub's wire snapshot). The chassis's OWN half — the
+// declaration layer below — stays here.
+export {
+  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,
+  usageCheckRequestSchema,
+  usageCheckSchema,
+  usageEventOccurrenceIssue,
+  usageEventResultSchema,
+  usageEventSchema,
+  usageEventsBatchSchema,
+  usageIngestResultSchema,
+  usageRejectReasonSchema
+} from '@antasphere/contract';
+export type {
+  UsageCheck,
+  UsageCheckReason,
+  UsageCheckRequest,
+  UsageEventResult,
+  UsageEventsBatch,
+  UsageIngestResult,
+  UsageRejectReason,
+  UsageRouteError
+} from '@antasphere/contract';
 
 /**
- * The one scope of the tool → hub machine channel (§6): a `client_credentials`
- * token on the registry client, reaching `/usage/*` and nothing else.
+ * The plan tiers, a CLOSED enum the hub owns (`BILLING_PLANS` in
+ * `@antasphere/contract`), under the chassis's own names (§8b): `free` is the
+ * default with no subscription; `pro` is the paid plan. "Enterprise" is not
+ * a tier but a per-account override the hub serves.
  */
-export const USAGE_WRITE_SCOPE = 'usage:write';
-
-/**
- * The error codes the three tool routes of the hub (`POST /usage/events`,
- * `GET /usage/entitlements`, `POST /usage/check`) answer with, and the status
- * each rides on: the hub's `USAGE_ROUTE_ERRORS` (PRDCT-2677).
- * `tool_credential_required`: the caller is not a registry tool's machine
- * credential. `unknown_account`: no organization holds the `accountRef` (the
- * check and the entitlements read; the ingest answers it per event instead).
- * `validation_error`: the body or the query does not parse. The chassis maps
- * the check's two (`check.ts`): a 404 `unknown_account` and a 400 are the
- * hub's judgement, allowed and logged, never an outage.
- */
-export const USAGE_ROUTE_ERRORS = {
-  tool_credential_required: 401,
-  unknown_account: 404,
-  validation_error: 400
-} as const;
-export type UsageRouteError = keyof typeof USAGE_ROUTE_ERRORS;
-
-/**
- * The wire shape of one usage event as the hub ingests it: the hub's
- * `usageEventSchema` (`packages/contract/src/schemas/billing.ts` of the hub,
- * PRDCT-2625), copied here and checked against the hub's wire snapshot
- * (`wire.ts`, `pnpm --filter @antasphere/chassis-contract wire:check`, the
- * `hub-wire` CI job; PRDCT-2677), so the fake hub of the test kit refuses
- * exactly what the real hub refuses (PRDCT-2629). `userId` is the HUB user
- * (the SSO `sub`), never the tool's local id, and null when the actor is a
- * resource owner the tool could not name; `accountRef` is the hub
- * organization id (a uuid) the tool carries as its workspace's central
- * account id. `toolSlug` is accepted by the hub only when it equals the
- * calling token's registry slug — the chassis NEVER sends it: the token is
- * the only authority on the tool's name, the body never names the tool
- * (PRDCT-2629; `UsageEvent` in seams.ts has no such field).
- */
-export const usageEventSchema = z
-  .object({
-    id: z.string().regex(/^[0-9A-HJKMNP-TV-Z]{26}$/, 'a ULID'),
-    actionKey: z.string().min(1).max(120).optional(),
-    meter: z.string().min(1).max(120).optional(),
-    quantity: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
-    unit: z.string().min(1).max(40),
-    occurredAt: z.iso.datetime({ offset: true }),
-    workspaceId: z.string().min(1).max(128),
-    accountRef: z.uuid(),
-    userId: z.string().min(1).max(128).nullable().optional(),
-    via: z.enum(['session', 'api_key', 'oauth']),
-    resourceType: z.string().min(1).max(80).nullable().optional(),
-    resourceId: z.string().min(1).max(256).nullable().optional(),
-    toolSlug: z.string().min(1).max(64).optional(),
-    source: z.object({
-      instanceId: z.string().min(1).max(128),
-      edition: z.string().min(1).max(32),
-      version: z.string().min(1).max(64)
-    })
-  })
-  .refine((e) => e.actionKey !== undefined || e.meter !== undefined, {
-    message: 'actionKey (or its legacy alias meter) is required',
-    path: ['actionKey']
-  });
-
-/** The batch cap of `POST /usage/events` (the hub's `USAGE_EVENTS_BATCH_MAX`): at most this many events per post. */
-export const USAGE_EVENTS_BATCH_MAX = 500;
-
-/**
- * The body of `POST /usage/events` as the hub parses it (its
- * `usageEventsBatchSchema`): one to `USAGE_EVENTS_BATCH_MAX` elements, each
- * judged on its own against `usageEventSchema` afterwards.
- */
-export const usageEventsBatchSchema = z.object({
-  events: z.array(z.unknown()).min(1).max(USAGE_EVENTS_BATCH_MAX)
-});
-export type UsageEventsBatch = z.infer<typeof usageEventsBatchSchema>;
-
-/**
- * Why the hub did not accept an event (its `USAGE_REJECT_REASONS`, a closed
- * list): `unknown_account`, `unknown_user`, `tool_mismatch`, and
- * `invalid_event` (the element does not parse, its `occurredAt` falls outside
- * the window, or its price exceeds `Number.MAX_SAFE_INTEGER`; `details` names
- * the field).
- */
-export const USAGE_REJECT_REASONS = [
-  'unknown_account',
-  'unknown_user',
-  'tool_mismatch',
-  'invalid_event'
-] as const;
-export const usageRejectReasonSchema = z.enum(USAGE_REJECT_REASONS);
-export type UsageRejectReason = z.infer<typeof usageRejectReasonSchema>;
-
-/**
- * One element's answer. Since phase 2 an `accepted` result carries the
- * `credits` the hub debited for it (0 when the action has no price).
- */
-export const usageEventResultSchema = z.object({
-  id: z.string().nullable(),
-  status: z.enum(['accepted', 'duplicate', 'rejected']),
-  reason: usageRejectReasonSchema.optional(),
-  details: z.unknown().optional(),
-  credits: z.number().int().optional()
-});
-export type UsageEventResult = z.infer<typeof usageEventResultSchema>;
-
-/**
- * The hub's answer to `POST /usage/events`: one result per element, in the
- * batch's order, and the three counts (always sent).
- */
-export const usageIngestResultSchema = z.object({
-  results: z.array(usageEventResultSchema),
-  accepted: z.number().int(),
-  duplicate: z.number().int(),
-  rejected: z.number().int()
-});
-export type UsageIngestResult = z.infer<typeof usageIngestResultSchema>;
-
-// ── The hub's window on an event's date (PRDCT-2630 at the hub, PRDCT-2644 here) ──
-
-/**
- * The window an event's `occurredAt` must fall in, measured against the
- * moment the hub receives it: the hub's `USAGE_EVENT_MAX_PAST_MS` and
- * `USAGE_EVENT_MAX_FUTURE_MS` (`packages/contract/src/schemas/billing.ts`
- * of the hub), same names and values, checked against the hub's wire
- * snapshot (`wire.ts`, `wire:check`, the `hub-wire` CI job; PRDCT-2677). Backward, seven days:
- * the queue's retry budget is about eight and a half hours, so an outage of
- * a night is covered many times over, and a week also covers an operator
- * re-driving held jobs by hand. Forward, five minutes: the skew every JWT
- * verifier already tolerates; anything further is a clock that is wrong.
- * Outside the window the hub answers `rejected(invalid_event)` naming
- * `occurredAt` and never clamps, so the poster refuses BEFORE posting: an
- * event the hub would refuse on its date is held where it was made, never
- * counted as a rejection at the hub (PRDCT-2644).
- */
-export const USAGE_EVENT_MAX_PAST_MS = 7 * 24 * 60 * 60 * 1000;
-export const USAGE_EVENT_MAX_FUTURE_MS = 5 * 60 * 1000;
-
-/**
- * Why an event's `occurredAt` is refused against the receipt time, or null
- * when it falls inside the window (both bounds INCLUSIVE). The hub's
- * `usageEventOccurrenceIssue`, copied (the wire snapshot's occurrence table
- * checks it on the hub's offsets): the one comparison both
- * halves run, the hub at ingest against its own clock, the chassis before
- * posting against its best estimate of the receipt (its own clock), so the
- * two never disagree on the sign or the edge.
- */
-export function usageEventOccurrenceIssue(
-  occurredAt: Date,
-  receivedAt: Date
-): { path: 'occurredAt'; message: string } | null {
-  const delta = occurredAt.getTime() - receivedAt.getTime();
-  if (delta < -USAGE_EVENT_MAX_PAST_MS) {
-    return {
-      path: 'occurredAt',
-      message: `more than ${USAGE_EVENT_MAX_PAST_MS / 86_400_000} days before the hub received the event`
-    };
-  }
-  if (delta > USAGE_EVENT_MAX_FUTURE_MS) {
-    return {
-      path: 'occurredAt',
-      message: `more than ${USAGE_EVENT_MAX_FUTURE_MS / 60_000} minutes after the hub received the event`
-    };
-  }
-  return null;
-}
-
-// ── POST /usage/check: the price and the balance before an action (§5, §7 step 3) ──
-
-/**
- * The request of `POST /usage/check` (the hub's `UsageCheckRequest`,
- * PRDCT-2663): the paying account, the action key and the quantity of THIS
- * request. `unit` is accepted and ignored by the hub, which prices by its
- * own row; it is sent so the answer's unit can be compared and a mismatch
- * logged.
- */
-export const usageCheckRequestSchema = z.object({
-  accountRef: z.uuid(),
-  actionKey: z.string().min(1).max(120),
-  quantity: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
-  unit: z.string().min(1).max(40).optional()
-});
-export type UsageCheckRequest = z.infer<typeof usageCheckRequestSchema>;
-
-/**
- * The three reasons a check refuses (`null` when allowed), the hub's
- * `USAGE_CHECK_REASONS`: `account_suspended` (checked first, whatever the
- * price), `unpriceable` (the price of this quantity exceeds
- * `Number.MAX_SAFE_INTEGER`: the hub clamps `credits` to that bound, and the
- * ingest would reject the same event on its `quantity`) and
- * `insufficient_credits` (`balance < credits`). Each is a refusal, never an
- * outage (PRDCT-2677).
- */
-export const USAGE_CHECK_REASONS = ['insufficient_credits', 'account_suspended', 'unpriceable'] as const;
-export type UsageCheckReason = (typeof USAGE_CHECK_REASONS)[number];
-
-/**
- * The hub's answer to `POST /usage/check` (its `UsageCheck`, PRDCT-2663),
- * checked against the hub's wire snapshot (PRDCT-2677): advisory, no side effect. `credits` is the price of
- * this quantity from the price book row effective now (0 and `priced:
- * false` when the tool has no row for the action: views are never priced,
- * an unknown key is not a refusal); `balance` the account's; `allowed` is
- * `balance >= credits` unless the organization is suspended, which refuses
- * whatever the price. `topUpUrl` is always present: the hub's billing page
- * for that organization, what a `402 entitlement_denied` carries straight
- * off the answer. No lower bound on `quantity` or `credits`, as at the hub: a
- * copy stricter than the hub reads a valid answer as an outage.
- */
-export const usageCheckSchema = z.object({
-  accountRef: z.uuid(),
-  actionKey: z.string(),
-  quantity: z.number().int(),
-  allowed: z.boolean(),
-  credits: z.number().int(),
-  balance: z.number().int(),
-  unit: z.string().nullable(),
-  priced: z.boolean(),
-  plan: entitlementTierSchema,
-  reason: z.enum(USAGE_CHECK_REASONS).nullable(),
-  topUpUrl: z.string()
-});
-export type UsageCheck = z.infer<typeof usageCheckSchema>;
+export const ENTITLEMENT_TIERS = BILLING_PLANS;
+export type EntitlementTier = BillingPlan;
+export const entitlementTierSchema = billingPlanSchema;
 
 /** The wire code of a credit refusal (§7 step 4), and its `details`. */
 export const ENTITLEMENT_DENIED = 'entitlement_denied';
@@ -492,7 +305,7 @@ export type ToolEntitlements = z.infer<typeof toolEntitlementsSchema>;
 
 /**
  * The hub's answer to `GET /usage/entitlements?accountRef=` (§5): the hub's
- * `usageEntitlementsSchema` (PRDCT-2636), checked against the hub's wire
+ * `usageEntitlementsSchema` (PRDCT-2636), the hub's own shape in
  * snapshot (PRDCT-2677). The account's
  * plan, resolved from the tier's defaults and the account's overrides; in
  * phase 1 `limits` and `features` are empty and the tool's own declared

package/src/index.ts

@@ -33,6 +33,5 @@ export * from './schemas/teams.js';
 export * from './schemas/demo-passes.js';
 export * from './seams.js';
 export * from './entitlements.js';
-export * from './wire.js';
 export * from './define.js';
 export type { ToolIdentity } from './identity.js';

package/dist/wire.d.ts

@@ -1,101 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,161 +0,0 @@
-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

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