cursedbelt 0.0.0 → 2.3.0

package/dist/react/data/useEngineResource.js

@@ -0,0 +1,176 @@
+/**
+ * `useEngineResource` (04 §5a) — the client half of the two-tier subscription
+ * model, and the fix for "the CDC push tier feeds nothing".
+ *
+ * The server side has been complete for two phases: every repository write emits
+ * a `MutationRecord`, `bridgeCdcToPush` republishes it per instance, and
+ * `createInstanceStreamHost` turns the SSE frame into a `cdc:<domain>.<table>`
+ * emission on the wire hub. Nothing consumed the last step, so a row created in
+ * one tab was invisible in another until a manual reload — the whole invalidation
+ * chain ran and ended in a hub nobody listened to.
+ *
+ * This hook closes it, under one rule that is also its gate:
+ *
+ *   **Exactly one re-pull per dirty transition.**
+ *
+ * Not one per frame. A burst of writes (an import, a job finishing) publishes
+ * many frames; refetching per frame is a request storm that scales with someone
+ * else's write rate. Frames raise a watermark; the effect refetches once per
+ * raised watermark, and frames that land while a refetch is in flight raise it
+ * again so nothing is missed. A frame on a channel this resource did not declare
+ * moves nothing at all — over-invalidation is a verifiable defect (V4
+ * `over-invalidation-risk`), not a harmless extra fetch.
+ *
+ * Paging composes over the landed `usePagedList` rather than reinventing cursor
+ * state: an un-paged resource is simply a one-page list, so both kinds return
+ * the same shape and a shell never branches on which it got.
+ */
+import { useEffect, useRef, useState } from 'react';
+import { usePagedList } from '../usePagedList';
+import { useEngineData } from './engineDataContext';
+import { requireParams } from './wireEnvelope';
+/**
+ * Resolve a resource's route, or `null` when a parent-scoped one has no parent
+ * yet — the caller turns that into "disabled", never into a request.
+ */
+const resolvePath = (path, keys) => {
+    if (typeof path === 'string')
+        return path;
+    const entries = Object.entries(keys ?? {});
+    if (entries.length === 0)
+        return null;
+    const resolved = {};
+    for (const [key, value] of entries) {
+        if (typeof value !== 'string' || value.length === 0)
+            return null;
+        resolved[key] = value;
+    }
+    return path(resolved);
+};
+export function useEngineResource(instanceId, resource, options = {}) {
+    const { client, hub } = useEngineData();
+    const { params, pathKeys, enabled = true, staleTime = 30_000 } = options;
+    const path = resolvePath(resource.path, pathKeys);
+    // A parent-scoped resource with no parent is not an error and not an empty
+    // fetch — it simply does not read. Folding that into `enabled` keeps the ONE
+    // "should this request happen" decision in one place.
+    const active = enabled && path !== null;
+    const page = usePagedList({
+        // The instance is part of the key: two instances of one engine may filter
+        // the same route differently, and sharing a cache entry would show one
+        // instance's rows in the other. The resolved PATH is in the key too, so a
+        // parent switch is a different query rather than a stale hit.
+        queryKey: ['cc-engine', instanceId, resource.id, path, params ?? null],
+        enabled: active,
+        staleTime,
+        fetchPage: async (cursor) => {
+            // A route that 4xxs without a parameter says so in its descriptor now
+            // (`requiredParams`). Dev/test throws a located error naming the missing
+            // keys; production still issues the request — it will 4xx exactly as it
+            // does today — and reports why, which is one more than it did before.
+            requireParams(resource.id, resource.requiredParams, params ?? {});
+            const body = await client.request(path ?? '', {
+                query: { ...(params ?? {}), ...(resource.paged && cursor ? { cursor } : {}) },
+            });
+            const parsed = resource.read(body, resource.id);
+            // An un-paged route that echoed a cursor would page forever against a
+            // response shape that has no second page.
+            return resource.paged ? parsed : { items: parsed.items };
+        },
+    });
+    /* ------------------------------------------------ CDC → exactly one re-pull */
+    const [watermark, setWatermark] = useState(0);
+    const [invalidations, setInvalidations] = useState(0);
+    /** The watermark already refetched for — the guard that makes it exactly once. */
+    const synced = useRef(0);
+    /** `refetch` identity changes every render; the effect must not re-run on it. */
+    const refetch = useRef(page.refetch);
+    refetch.current = page.refetch;
+    // The joined key IS the dependency: a resource declaring the same channels must
+    // not resubscribe just because its array is a fresh object. Channel names are
+    // `cdc:<domain>.<table>` and never contain a pipe, so the round-trip is exact.
+    const channelKey = resource.channels.join('|');
+    useEffect(() => {
+        const channels = channelKey === '' ? [] : channelKey.split('|');
+        if (!hub || !active || channels.length === 0)
+            return;
+        const teardowns = channels.map((channel) => 
+        // The hub already drops a redelivered `rev` (settle-by-revision), so this
+        // listener sees only genuine changes; the watermark then coalesces a burst
+        // of DIFFERENT revs into a single pull.
+        hub.subscribe(channel, (_envelope) => setWatermark((n) => n + 1)));
+        return () => {
+            for (const teardown of teardowns)
+                teardown();
+        };
+    }, [hub, active, channelKey]);
+    useEffect(() => {
+        if (watermark === 0 || watermark === synced.current)
+            return;
+        synced.current = watermark;
+        refetch.current();
+        setInvalidations((n) => n + 1);
+    }, [watermark]);
+    return {
+        items: page.items,
+        isLoading: page.isLoading,
+        isFetching: page.isFetching,
+        isError: page.isError,
+        error: page.error,
+        hasMore: page.hasMore,
+        loadMore: page.loadMore,
+        refetch: page.refetch,
+        invalidations,
+    };
+}
+/**
+ * A one-shot engine action (deploy, mark-done, rotate) with pending/error state
+ * and an explicit refresh of whatever it changed.
+ *
+ * Deliberately NOT a general mutation layer: the engine surfaces are small, and
+ * the failure mode worth preventing is an action that mutates and leaves the
+ * list it changed showing stale rows. Callers pass the resource results to
+ * refresh, so the refresh is written at the call site where the dependency is
+ * visible — never inferred from a cache-key prefix that silently stops matching.
+ */
+export function useEngineAction(perform, refresh = []) {
+    const [pending, setPending] = useState(false);
+    const [error, setError] = useState(null);
+    // Kept in refs so a caller can pass inline closures without re-creating `run`
+    // on every render (and without a stale closure over the first render's props).
+    // The failure is NOT re-reported to the app-error sink here: it already went
+    // through `EngineClient`'s `onError` on the way out, and reporting twice would
+    // raise the overlay for an error the action is about to render inline.
+    const performRef = useRef(perform);
+    performRef.current = perform;
+    const refreshRef = useRef(refresh);
+    refreshRef.current = refresh;
+    const alive = useRef(true);
+    useEffect(() => {
+        alive.current = true;
+        return () => {
+            alive.current = false;
+        };
+    }, []);
+    const run = useRef(async (arg) => {
+        setPending(true);
+        setError(null);
+        try {
+            await performRef.current(arg);
+            for (const resource of refreshRef.current)
+                resource.refetch();
+        }
+        catch (cause) {
+            // A late failure must not write into an unmounted tree (03 §6.2's abort
+            // discipline, applied on the client).
+            if (alive.current)
+                setError(cause);
+        }
+        finally {
+            if (alive.current)
+                setPending(false);
+        }
+    }).current;
+    return { run, pending, error };
+}
+//# sourceMappingURL=useEngineResource.js.map

package/dist/react/data/useEngineResource.js.map

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

package/dist/react/data/wireEnvelope.d.ts

@@ -0,0 +1,208 @@
+/**
+ * The RESPONSE ENVELOPE contract — the one place a wire shape is checked
+ * (spec 01 §6, incremental step 1).
+ *
+ * ## What was wrong
+ *
+ * There is no compile-time contract between a Hono handler's `c.json({...})` and
+ * the React hook that reads it. `engineClient.request<T>` ends with
+ * `return (body ?? {}) as T` — `T` is a CALLER-SUPPLIED ASSERTION, not a
+ * measurement — and every `EngineResource.read` was `(body as Record<string,
+ * unknown>)?.[key]` followed by a cast. So renaming `items` to `rows` in a mixin
+ * left **both `tsc`s green, `lint` green, the `requiredFeature` and
+ * `engineResources` parity gates green** (they compare route strings and channel
+ * strings, never body shapes), **the browser gate green** — and the list
+ * rendering EMPTY in production.
+ *
+ * That is not hypothetical; it is this repo's own recurring bug. `ASSET_ITEMS`
+ * shipped half-declared for two arcs. `AssetService.remove` had no route for an
+ * arc while its docstring described the caller. `MediaCell` rendered a delete
+ * control no handler was passed to. Every one is the same missing contract,
+ * found by hand each time.
+ *
+ * ## Both halves are now closed
+ *
+ * The **envelope** half (landed first): a response whose expected key is absent,
+ * or present but not an array, is a LOCATED ERROR instead of an empty page.
+ *
+ * The **row** half (frontier item 16, this landing): {@link RowSpec} declares,
+ * per listing type, every field the view interface promises is ALWAYS there —
+ * and {@link checkRows} refuses a row that does not carry them. The two halves
+ * catch different failures and neither subsumes the other: the envelope catches
+ * a renamed container key, and the row check catches a row that arrives with a
+ * field missing or of the wrong type, which is what a `LEFT JOIN` that found
+ * nothing, a repository mapping a NULL column, or a service returning a partial
+ * projection actually produces.
+ *
+ * ## Why hand-written and not zod, for BOTH halves
+ *
+ * zod earns its place on nested, branching shapes that no other artifact
+ * describes. Here the shape is already described — by the `*View` interface the
+ * service returns — so a zod schema would be a SECOND declaration free to drift
+ * from the first. {@link RowSpec} cannot drift: it is a mapped type over the
+ * view, so a renamed field fails `tsc` in this package and a new REQUIRED field
+ * fails until the spec names it. That is the property zod would not have given
+ * us, and it costs no bytes in a bundle that ships to a browser.
+ *
+ * ## What a spec deliberately does not check
+ *
+ * Optional fields, nested object shapes, and string FORMATS (an ISO date, a
+ * uuid). A row is refused for the things whose absence breaks a render — the
+ * fields the interface says are unconditional — and nothing else. A checker that
+ * refused a valid row because a date was spelled differently would be a new
+ * outage in the name of preventing one.
+ *
+ * ## Import direction
+ *
+ * This module imports NOTHING — not from the server tier, not from the config
+ * tier. `§D`: "`import type` is erased from the emitted JS, NOT from the module
+ * graph the compiler walks", so a type-only reach into `server/mixins/services`
+ * would drag the server storage tier into a DOM-typed compile.
+ */
+/** Where a malformed response goes when we choose to degrade rather than throw. */
+export type WireErrorSink = (error: Error) => void;
+/**
+ * Route malformed-response reports somewhere a human will see them.
+ *
+ * `EngineDataProvider` installs one on mount — every generated app and the
+ * studio mount it, so the sink has a real caller rather than an aspirational
+ * docstring. It logs under the stable prefix `CC_WIRE_SHAPE` and deliberately
+ * does NOT raise the app-error overlay: that surface is what a CUSTOMER reads,
+ * and "the response has no `items` array" is a message for whoever ships the
+ * app. Degrading exists so the screen keeps working.
+ *
+ * Absent ⇒ `console.error`, which is still louder than the empty array this
+ * replaces.
+ */
+export declare function setWireErrorSink(next: WireErrorSink | null): void;
+/**
+ * 01 §6.2's policy: **THROW in dev/test, report and DEGRADE in production.**
+ *
+ * A schema bug must be impossible to miss while building, and must not blank a
+ * customer's screen after shipping — a wrong list is bad, an app that throws on
+ * every render is worse.
+ *
+ * It is a mutable module value with a setter rather than a build-time constant,
+ * and that is a deliberate trade. A `const` derived from `process.env.NODE_ENV`
+ * would let the bundler drop the throw branch — saving one `throw` statement —
+ * at the cost of making the DEGRADE branch untestable from a suite that runs
+ * under `NODE_ENV=test`. A test that "proves" the production path by catching
+ * the throw it is meant to avoid is a probe asserting against its own fixture,
+ * which `§D` records as a standing footgun. So the branch is real and reachable.
+ */
+export type WirePolicy = 'throw' | 'degrade';
+export declare function readWirePolicy(): WirePolicy;
+/** Override the policy. Pass `null` to restore the `NODE_ENV`-derived default. */
+export declare function setWirePolicy(next: WirePolicy | null): void;
+export declare class WireShapeError extends Error {
+    readonly detail: {
+        readonly resource: string;
+        readonly key: string;
+        readonly received: string;
+    };
+    constructor(message: string, detail: {
+        readonly resource: string;
+        readonly key: string;
+        readonly received: string;
+    });
+}
+/**
+ * Refuse a body that does not carry `key` as an array.
+ *
+ * `fallback` is what production returns after reporting. It is `[]` — the SAME
+ * value the old silent path returned — which is the point: the behavior a
+ * customer sees is unchanged, and the difference is that somebody now knows.
+ */
+export declare function requireArray<T>(resource: string, key: string, body: unknown): T[];
+/**
+ * Refuse a request that omits a query parameter its route REQUIRES.
+ *
+ * Found while building the both-directions gate: `/api/system/calendar` answers
+ * `400 CALENDAR_RANGE_MISSING` without `from`/`to`, the catalog said nothing
+ * about it, and the single existing consumer happened to pass them. A second
+ * consumer would have got a 400 that no type, no gate and no descriptor
+ * predicted — the same class of undeclared coupling this catalog exists to
+ * remove, one field over from the ones it already declares.
+ *
+ * Production still makes the request: it will 400, exactly as it does today, and
+ * the report says why. Dev/test throws, because there the omission is a bug
+ * being written rather than one already shipped.
+ */
+export declare function requireParams(resource: string, required: readonly string[], params: Readonly<Record<string, unknown>>): void;
+/**
+ * What a field must BE at runtime.
+ *
+ * `defined` is the escape for a field the view types as a union of kinds
+ * (`string | number | boolean` — a list cell's value): the guarantee is then
+ * "present and not undefined", which is still the guarantee that matters, and
+ * pretending to a precision the interface does not have would be worse than
+ * naming the looser one.
+ */
+export type FieldKind = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'defined';
+/**
+ * The kinds a spec may declare for a field of type `V`.
+ *
+ * This is the whole compile-time half. `RowSpec<T>` is a mapped type over the
+ * view interface, so:
+ *
+ *   * renaming `title` → `label` in the view makes every spec naming `title`
+ *     fail `tsc` — the excess-property check;
+ *   * adding a REQUIRED field to a view makes every spec for it fail until it is
+ *     named — the mapped type demands all required keys;
+ *   * declaring `position: 'string'` where the view says `number` fails, because
+ *     `KindFor<number>` does not include `'string'`.
+ *
+ * A zod schema beside the interface would have caught none of the three: it
+ * would be a second declaration, free to drift from the first.
+ */
+type ExactKind<V> = [V] extends [readonly unknown[]] ? 'array' : [V] extends [string] ? 'string' : [V] extends [number] ? 'number' : [V] extends [boolean] ? 'boolean' : [V] extends [object] ? 'object' : never;
+export type KindFor<V> = ExactKind<NonNullable<V>> | 'defined';
+type RequiredKeysOf<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? never : K;
+}[keyof T];
+/**
+ * Every field the view promises unconditionally, and what it must be.
+ *
+ * OPTIONAL view fields may be named too but need not be: a `title?: string` that
+ * is absent is data, not a defect, and a spec that demanded it would refuse rows
+ * the product itself calls valid.
+ */
+export type RowSpec<T> = {
+    readonly [K in RequiredKeysOf<T>]: KindFor<T[K]>;
+} & {
+    readonly [K in Exclude<keyof T, RequiredKeysOf<T>>]?: KindFor<T[K]>;
+};
+/** The erased form {@link checkRows} walks. Every `RowSpec<T>` is assignable. */
+export type RowSpecShape = Readonly<Record<string, FieldKind>>;
+/**
+ * How many rows a page is checked at, per {@link readWirePolicy}.
+ *
+ * A wire-shape defect is SYSTEMIC — every row of a page comes from one query
+ * through one mapper — so the first row answers the question the thousandth
+ * would. In dev/test we still walk the whole page, because there the cost is
+ * nothing and a heterogeneous page (a union listing whose second source maps
+ * differently) is exactly the kind of bug worth the walk. In production the
+ * check is O(1) per page and cannot become a rendering cost on a long list.
+ */
+export declare const DEGRADED_ROW_SAMPLE = 1;
+/**
+ * Refuse rows that do not carry what their view interface promises.
+ *
+ * Returns the rows UNCHANGED — in both policies. Under `throw` the caller never
+ * sees the return value, and under `degrade` a wrong-shaped row still renders
+ * whatever it can, which is the same thing the customer saw before this existed.
+ * Dropping the bad rows would be a silent, data-losing "fix" of the sort this
+ * whole module exists to stop.
+ */
+export declare function checkRows<T>(resource: string, spec: RowSpecShape | undefined, rows: T[]): T[];
+/**
+ * Read an OPTIONAL single entity under `key`.
+ *
+ * Deliberately NOT symmetric with {@link requireArray}: a detail route legitimately
+ * answers "no such row" — a deleted item, a stale link — and that is data, not a
+ * shape error. What IS refused is a body that is not an object at all, because
+ * that means the response was not the envelope this resource expects.
+ */
+export declare function readEntity<T>(resource: string, key: string, body: unknown): T[];
+export {};
+//# sourceMappingURL=wireEnvelope.d.ts.map

package/dist/react/data/wireEnvelope.d.ts.map

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

package/dist/react/data/wireEnvelope.js

@@ -0,0 +1,239 @@
+/**
+ * The RESPONSE ENVELOPE contract — the one place a wire shape is checked
+ * (spec 01 §6, incremental step 1).
+ *
+ * ## What was wrong
+ *
+ * There is no compile-time contract between a Hono handler's `c.json({...})` and
+ * the React hook that reads it. `engineClient.request<T>` ends with
+ * `return (body ?? {}) as T` — `T` is a CALLER-SUPPLIED ASSERTION, not a
+ * measurement — and every `EngineResource.read` was `(body as Record<string,
+ * unknown>)?.[key]` followed by a cast. So renaming `items` to `rows` in a mixin
+ * left **both `tsc`s green, `lint` green, the `requiredFeature` and
+ * `engineResources` parity gates green** (they compare route strings and channel
+ * strings, never body shapes), **the browser gate green** — and the list
+ * rendering EMPTY in production.
+ *
+ * That is not hypothetical; it is this repo's own recurring bug. `ASSET_ITEMS`
+ * shipped half-declared for two arcs. `AssetService.remove` had no route for an
+ * arc while its docstring described the caller. `MediaCell` rendered a delete
+ * control no handler was passed to. Every one is the same missing contract,
+ * found by hand each time.
+ *
+ * ## Both halves are now closed
+ *
+ * The **envelope** half (landed first): a response whose expected key is absent,
+ * or present but not an array, is a LOCATED ERROR instead of an empty page.
+ *
+ * The **row** half (frontier item 16, this landing): {@link RowSpec} declares,
+ * per listing type, every field the view interface promises is ALWAYS there —
+ * and {@link checkRows} refuses a row that does not carry them. The two halves
+ * catch different failures and neither subsumes the other: the envelope catches
+ * a renamed container key, and the row check catches a row that arrives with a
+ * field missing or of the wrong type, which is what a `LEFT JOIN` that found
+ * nothing, a repository mapping a NULL column, or a service returning a partial
+ * projection actually produces.
+ *
+ * ## Why hand-written and not zod, for BOTH halves
+ *
+ * zod earns its place on nested, branching shapes that no other artifact
+ * describes. Here the shape is already described — by the `*View` interface the
+ * service returns — so a zod schema would be a SECOND declaration free to drift
+ * from the first. {@link RowSpec} cannot drift: it is a mapped type over the
+ * view, so a renamed field fails `tsc` in this package and a new REQUIRED field
+ * fails until the spec names it. That is the property zod would not have given
+ * us, and it costs no bytes in a bundle that ships to a browser.
+ *
+ * ## What a spec deliberately does not check
+ *
+ * Optional fields, nested object shapes, and string FORMATS (an ISO date, a
+ * uuid). A row is refused for the things whose absence breaks a render — the
+ * fields the interface says are unconditional — and nothing else. A checker that
+ * refused a valid row because a date was spelled differently would be a new
+ * outage in the name of preventing one.
+ *
+ * ## Import direction
+ *
+ * This module imports NOTHING — not from the server tier, not from the config
+ * tier. `§D`: "`import type` is erased from the emitted JS, NOT from the module
+ * graph the compiler walks", so a type-only reach into `server/mixins/services`
+ * would drag the server storage tier into a DOM-typed compile.
+ */
+let sink = null;
+/**
+ * Route malformed-response reports somewhere a human will see them.
+ *
+ * `EngineDataProvider` installs one on mount — every generated app and the
+ * studio mount it, so the sink has a real caller rather than an aspirational
+ * docstring. It logs under the stable prefix `CC_WIRE_SHAPE` and deliberately
+ * does NOT raise the app-error overlay: that surface is what a CUSTOMER reads,
+ * and "the response has no `items` array" is a message for whoever ships the
+ * app. Degrading exists so the screen keeps working.
+ *
+ * Absent ⇒ `console.error`, which is still louder than the empty array this
+ * replaces.
+ */
+export function setWireErrorSink(next) {
+    sink = next;
+}
+/**
+ * `throw` only when the environment says so EXPLICITLY; otherwise `degrade`.
+ *
+ * The fail-safe direction matters and the obvious spelling (`env !== 'production'`)
+ * gets it backwards. A browser bundle has no `process` unless the builder
+ * defines one, so an unknown environment is the COMMON case in the shipped
+ * artifact — and defaulting that to `throw` would put an exception in front of a
+ * customer on the strength of a variable nobody set. Unknown ⇒ report and carry
+ * on; a developer's `NODE_ENV` is what turns the loud mode on.
+ */
+const defaultPolicy = () => {
+    try {
+        const env = globalThis.process?.env?.NODE_ENV;
+        return env === 'development' || env === 'test' ? 'throw' : 'degrade';
+    }
+    catch {
+        return 'degrade';
+    }
+};
+let policy = defaultPolicy();
+export function readWirePolicy() {
+    return policy;
+}
+/** Override the policy. Pass `null` to restore the `NODE_ENV`-derived default. */
+export function setWirePolicy(next) {
+    policy = next ?? defaultPolicy();
+}
+/** Throw or report-and-degrade, per {@link readWirePolicy}. */
+function refuse(error) {
+    if (policy === 'throw')
+        throw error;
+    (sink ?? ((e) => console.error(e)))(error);
+}
+export class WireShapeError extends Error {
+    detail;
+    constructor(message, detail) {
+        super(message);
+        this.detail = detail;
+        this.name = 'WireShapeError';
+    }
+}
+const describe = (value) => {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return `array(${value.length})`;
+    if (typeof value !== 'object')
+        return typeof value;
+    const keys = Object.keys(value);
+    return `object{${keys.slice(0, 8).join(',')}${keys.length > 8 ? ',…' : ''}}`;
+};
+/**
+ * Refuse a body that does not carry `key` as an array.
+ *
+ * `fallback` is what production returns after reporting. It is `[]` — the SAME
+ * value the old silent path returned — which is the point: the behavior a
+ * customer sees is unchanged, and the difference is that somebody now knows.
+ */
+export function requireArray(resource, key, body) {
+    const container = body;
+    const rows = container == null ? undefined : container[key];
+    if (Array.isArray(rows))
+        return rows;
+    refuse(new WireShapeError(`${resource}: the response has no \`${key}\` array — the route's envelope and this resource's reader disagree. Received ${describe(body)}.`, { resource, key, received: describe(body) }));
+    return [];
+}
+/**
+ * Refuse a request that omits a query parameter its route REQUIRES.
+ *
+ * Found while building the both-directions gate: `/api/system/calendar` answers
+ * `400 CALENDAR_RANGE_MISSING` without `from`/`to`, the catalog said nothing
+ * about it, and the single existing consumer happened to pass them. A second
+ * consumer would have got a 400 that no type, no gate and no descriptor
+ * predicted — the same class of undeclared coupling this catalog exists to
+ * remove, one field over from the ones it already declares.
+ *
+ * Production still makes the request: it will 400, exactly as it does today, and
+ * the report says why. Dev/test throws, because there the omission is a bug
+ * being written rather than one already shipped.
+ */
+export function requireParams(resource, required, params) {
+    const missing = required.filter((key) => params[key] === undefined || params[key] === '');
+    if (missing.length === 0)
+        return;
+    refuse(new WireShapeError(`${resource}: this route requires the query parameter(s) \`${missing.join('`, `')}\`, and the caller passed none. Pass them through \`params\` on the hook.`, { resource, key: missing.join(','), received: describe(params) }));
+}
+const kindOf = (value) => {
+    if (Array.isArray(value))
+        return 'array';
+    if (value === null)
+        return 'object';
+    const type = typeof value;
+    return type === 'string' || type === 'number' || type === 'boolean' || type === 'object' ? type : 'defined';
+};
+const matches = (kind, value) => {
+    if (value === undefined)
+        return false;
+    if (kind === 'defined')
+        return true;
+    if (kind === 'array')
+        return Array.isArray(value);
+    if (kind === 'object')
+        return typeof value === 'object' && value !== null && !Array.isArray(value);
+    return typeof value === kind;
+};
+/**
+ * How many rows a page is checked at, per {@link readWirePolicy}.
+ *
+ * A wire-shape defect is SYSTEMIC — every row of a page comes from one query
+ * through one mapper — so the first row answers the question the thousandth
+ * would. In dev/test we still walk the whole page, because there the cost is
+ * nothing and a heterogeneous page (a union listing whose second source maps
+ * differently) is exactly the kind of bug worth the walk. In production the
+ * check is O(1) per page and cannot become a rendering cost on a long list.
+ */
+export const DEGRADED_ROW_SAMPLE = 1;
+/**
+ * Refuse rows that do not carry what their view interface promises.
+ *
+ * Returns the rows UNCHANGED — in both policies. Under `throw` the caller never
+ * sees the return value, and under `degrade` a wrong-shaped row still renders
+ * whatever it can, which is the same thing the customer saw before this existed.
+ * Dropping the bad rows would be a silent, data-losing "fix" of the sort this
+ * whole module exists to stop.
+ */
+export function checkRows(resource, spec, rows) {
+    if (spec === undefined || rows.length === 0)
+        return rows;
+    const limit = policy === 'throw' ? rows.length : Math.min(rows.length, DEGRADED_ROW_SAMPLE);
+    for (let index = 0; index < limit; index += 1) {
+        const row = rows[index];
+        if (row === null || typeof row !== 'object' || Array.isArray(row)) {
+            refuse(new WireShapeError(`${resource}: row ${index} is not an object — the route returned ${describe(row)} where a record was expected.`, { resource, key: `[${index}]`, received: describe(row) }));
+            continue;
+        }
+        for (const [key, kind] of Object.entries(spec)) {
+            const value = row[key];
+            if (matches(kind, value))
+                continue;
+            refuse(new WireShapeError(`${resource}: row ${index} has no valid \`${key}\` — the view declares it as ${kind} and always present, and the route sent ${value === undefined ? 'nothing' : kindOf(value)}. The service's shape and this resource's contract disagree.`, { resource, key, received: value === undefined ? 'undefined' : describe(value) }));
+        }
+    }
+    return rows;
+}
+/**
+ * Read an OPTIONAL single entity under `key`.
+ *
+ * Deliberately NOT symmetric with {@link requireArray}: a detail route legitimately
+ * answers "no such row" — a deleted item, a stale link — and that is data, not a
+ * shape error. What IS refused is a body that is not an object at all, because
+ * that means the response was not the envelope this resource expects.
+ */
+export function readEntity(resource, key, body) {
+    if (body === null || typeof body !== 'object') {
+        refuse(new WireShapeError(`${resource}: the response is not an object envelope, so \`${key}\` cannot be read. Received ${describe(body)}.`, { resource, key, received: describe(body) }));
+        return [];
+    }
+    const entity = body[key];
+    return entity != null && typeof entity === 'object' ? [entity] : [];
+}
+//# sourceMappingURL=wireEnvelope.js.map

package/dist/react/data/wireEnvelope.js.map

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

package/dist/react/deep-link/index.d.ts

@@ -0,0 +1,4 @@
+export { defineDeepLinks, type DeepLinkLocation, type DeepLinkMode, type DeepLinkPatch, type DeepLinks, type DeepLinksOptions, type ViewSpec, } from './links';
+export { createResumeClient, resumeHrefOf, useResume, type ResumeClient, type ResumeClientOptions, type UseResumeOptions, type UseResumeResult, } from './resume';
+export { DeepLinkProvider, useDeepLink, type DeepLinkContextValue, type DeepLinkProviderProps, type NavItemProps, type UseDeepLinkResult, } from './useDeepLink';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/deep-link/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/deep-link/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,QAAQ,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC"}