cursedbelt 2.8.0 → 3.0.0

package/dist/react/data/useEngineResource.js

@@ -1,176 +0,0 @@
-/**
- * `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

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

@@ -1,208 +0,0 @@
-/**
- * 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

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

@@ -1,239 +0,0 @@
-/**
- * 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

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