@craftainer/crud-sdk 0.0.0-stage → 0.1.0

package/dist/events-Cqj9Rbon.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-Cqj9Rbon.mjs","names":[],"sources":["../src/cache/policy.ts","../node_modules/.pnpm/eventsource-parser@4.1.2/node_modules/eventsource-parser/dist/errors.js","../node_modules/.pnpm/eventsource-parser@4.1.2/node_modules/eventsource-parser/dist/parse.js","../src/events.ts"],"sourcesContent":["/** Per-resource cache policy, defaulted from the manifest `cache` hints. */\n\n/**\n * How one resource is cached. Times are seconds. `maxAge` and\n * `staleWhileRevalidate` only take effect while the resource's SSE stream is\n * running; without it every read revalidates. `statsTtl` bounds the staleness\n * of `stats`/`predict` on its own, as the server caches those bodies for the\n * same time. `revalidateOnly` means no fresh window and no\n * stale-while-revalidate.\n */\nexport interface CachePolicy {\n  readonly enabled: boolean;\n  readonly maxAge: number;\n  readonly statsTtl: number;\n  readonly staleWhileRevalidate: number;\n  readonly etag: boolean;\n  readonly revalidateOnly: boolean;\n}\n\n/** The manifest resource members a policy reads (I1); everything else is ignored. */\nexport interface ManifestCacheHints {\n  readonly cache?: {\n    readonly max_age?: unknown;\n    readonly stats_ttl?: unknown;\n    readonly stale_while_revalidate?: unknown;\n    readonly etag?: unknown;\n    readonly revalidate_only?: unknown;\n  } | null;\n}\n\nfunction seconds(value: unknown): number {\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? Math.max(value, 0)\n    : 0;\n}\n\n/** Build a policy from a manifest resource object; `overrides` win over the hints. */\nexport function cachePolicyFromManifest(\n  resource: ManifestCacheHints,\n  overrides: Partial<CachePolicy> = {},\n): CachePolicy {\n  const hints = resource.cache ?? {};\n  return {\n    enabled: overrides.enabled ?? true,\n    maxAge: overrides.maxAge ?? seconds(hints.max_age),\n    statsTtl: overrides.statsTtl ?? seconds(hints.stats_ttl),\n    staleWhileRevalidate:\n      overrides.staleWhileRevalidate ?? seconds(hints.stale_while_revalidate),\n    etag: overrides.etag ?? hints.etag !== false,\n    revalidateOnly: overrides.revalidateOnly ?? hints.revalidate_only === true,\n  };\n}\n\n/**\n * The policy to use under TanStack Query: its `staleTime` decides freshness,\n * so the SDK cache only revalidates (ETag/304) unless told otherwise.\n */\nexport function tanstackCachePolicy(\n  resource: ManifestCacheHints,\n  overrides: Partial<CachePolicy> = {},\n): CachePolicy {\n  return cachePolicyFromManifest(resource, {\n    revalidateOnly: true,\n    ...overrides,\n  });\n}\n","/**\n * Error thrown when encountering an issue during parsing.\n *\n * @public\n */\nexport class ParseError extends Error {\n    constructor(message, options) {\n        super(message);\n        this.name = 'ParseError';\n        this.type = options.type;\n        this.field = options.field;\n        this.value = options.value;\n        this.line = options.line;\n    }\n}\n//# sourceMappingURL=errors.js.map","/**\n * EventSource/Server-Sent Events parser\n * @see https://html.spec.whatwg.org/multipage/server-sent-events.html\n */\nimport { ParseError } from './errors.js';\n// ASCII codes used in the hot parsing paths.\nconst LF = 10;\nconst CR = 13;\nconst SPACE = 32;\nconst MAX_FIELD_PREFIX_LENGTH = 6;\n/**\n * Creates a new EventSource parser.\n *\n * @param config - Parser configuration. Accepts callbacks (see {@link ParserCallbacks})\n *   and options like `maxBufferSize` (see {@link ParserConfig}).\n *\n * @returns A new EventSource parser, with `feed` and `reset` methods.\n * @public\n */\nexport function createParser(config) {\n    if (typeof config === 'function') {\n        throw new TypeError('`config` must be an object, got a function instead. Did you mean `createParser({onEvent: fn})`?');\n    }\n    const { maxBufferSize, onComment, onError, onEvent, onId, onRetry } = config;\n    // Trailing bytes from prior `feed()` calls that did not yet form a complete line.\n    // Stored as an array of fragments and only joined when a line terminator arrives.\n    // Concatenating per-feed (`prefix + chunk`) is O(N²) when a single SSE line spans\n    // many chunks (e.g. a large `data:` payload streamed in tiny slices, or an MCP-style\n    // server that emits one giant content block). Buffering as fragments + joining once\n    // makes the same workload linear.\n    const pendingFragments = [];\n    // Running total of `pendingFragments` lengths, kept in sync with the array so the\n    // `maxBufferSize` check doesn't have to walk the fragment list on every feed.\n    let pendingFragmentsLength = 0;\n    // Empty or partial leading BOM; undefined once the BOM check is complete.\n    let bomPrefix = '';\n    let id;\n    let data = '';\n    let dataLines = 0;\n    let eventType;\n    // Set after a `maxBufferSize` overflow. Once tripped, `feed()` throws until\n    // `reset()` is called — see the comment on `maxBufferSize` in `ParserConfig`.\n    let terminated = false;\n    let skippingLine = false;\n    // Set when a line (parsed or discarded) was terminated by a trailing `\\r` at the very\n    // end of a chunk. That `\\r` is ambiguous: it may be a bare-CR terminator or the first\n    // half of a `\\r\\n` whose `\\n` lands in the next chunk. The line itself is complete\n    // either way, but we must remember to swallow a single leading `\\n` from the next\n    // chunk so the pair is treated as one terminator rather than a blank line (which\n    // would dispatch an event prematurely).\n    let skipNextLineFeed = false;\n    /**\n     * Feeds a chunk of the SSE stream to the parser. Any trailing bytes that do\n     * not yet form a complete line are held back and prepended to the next chunk,\n     * so callers can pass arbitrary slices of the stream without worrying about\n     * line boundaries.\n     *\n     * Per the SSE spec, one leading UTF-8 BOM is stripped before parsing,\n     * even when split across chunks. This handles both the raw 3-byte form (0xEF 0xBB\n     * 0xBF) and a single decoded U+FEFF, so a leading BOM is ignored regardless of\n     * how the caller decoded the bytes.\n     *\n     * @see https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream\n     */\n    function feed(chunk) {\n        if (terminated) {\n            throw new Error('Cannot feed parser: it was terminated after exceeding the configured max buffer size. Call `reset()` to resume parsing.');\n        }\n        if (bomPrefix !== undefined) {\n            chunk = bomPrefix + chunk;\n            // Wait only while the input could still be a raw BOM. Empty chunks must\n            // not finish the check, and a mismatched prefix must remain ordinary input.\n            if (chunk === '' || chunk === '\\xEF' || chunk === '\\xEF\\xBB') {\n                bomPrefix = chunk;\n                return;\n            }\n            bomPrefix = undefined;\n            // Strip exactly one leading BOM, in decoded or raw byte-valued form.\n            chunk = chunk.replace(/^(?:\\uFEFF|\\xEF\\xBB\\xBF)/, '');\n        }\n        // Rare resume states from a prior chunk boundary: a pending `\\r\\n` split or a\n        // line being discarded. Single combined check keeps the hot path to one branch;\n        // the actual handling lives out-of-line in `resumeAfterSkip`.\n        if (skippingLine || skipNextLineFeed) {\n            chunk = resumeAfterSkip(chunk);\n            if (!chunk) {\n                return;\n            }\n        }\n        // Hot path: no buffered prefix from a prior partial line. Hand the chunk\n        // straight to `processLines`, exactly like the original implementation.\n        // Zero new work in the common case (every chunk ends with `\\n\\n`).\n        if (!pendingFragments.length) {\n            const trailing = processLines(chunk);\n            if (trailing !== '') {\n                storeTrailing(trailing);\n            }\n            checkForBufferOverflow();\n            return;\n        }\n        // We have a buffered prefix. If this chunk also has no terminator, append\n        // to the buffer without concatenating — that's the O(N²) trap we're\n        // avoiding (large single `data:` payload split across many tiny chunks).\n        if (chunk.indexOf('\\n') === -1 && chunk.indexOf('\\r') === -1) {\n            if (pendingFragmentsLength < MAX_FIELD_PREFIX_LENGTH) {\n                const head = pendingFragments.join('') +\n                    chunk.slice(0, MAX_FIELD_PREFIX_LENGTH - pendingFragmentsLength);\n                if (!shouldBufferTrailing(head)) {\n                    pendingFragments.length = 0;\n                    pendingFragmentsLength = 0;\n                    skippingLine = true;\n                    return;\n                }\n            }\n            pendingFragments.push(chunk);\n            pendingFragmentsLength += chunk.length;\n            checkForBufferOverflow();\n            return;\n        }\n        // Terminator arrived. Join the accumulated fragments + this chunk once,\n        // process, and buffer any new trailing partial line.\n        pendingFragments.push(chunk);\n        const input = pendingFragments.join('');\n        pendingFragments.length = 0;\n        pendingFragmentsLength = 0;\n        storeTrailing(processLines(input));\n        checkForBufferOverflow();\n    }\n    // Out-of-line handler for the rare post-boundary states. `skipNextLineFeed` means a\n    // line (parsed or discarded) ended with a trailing `\\r` at the previous chunk boundary,\n    // so a single leading `\\n` must be swallowed to consume a split `\\r\\n` as one terminator.\n    // `skippingLine` means we are discarding an invalid line until its terminator arrives.\n    // The two states are mutually exclusive. Returns the remaining chunk to parse ('' if\n    // this chunk was fully consumed).\n    function resumeAfterSkip(chunk) {\n        if (chunk.length === 0) {\n            return chunk;\n        }\n        if (skipNextLineFeed) {\n            skipNextLineFeed = false;\n            return chunk.charCodeAt(0) === LF ? chunk.slice(1) : chunk;\n        }\n        const crIndex = chunk.indexOf('\\r');\n        const lfIndex = chunk.indexOf('\\n');\n        const lineEnd = crIndex === -1 ? lfIndex : lfIndex === -1 ? crIndex : crIndex < lfIndex ? crIndex : lfIndex;\n        if (lineEnd === -1) {\n            return '';\n        }\n        // Trailing `\\r` at the very end of the chunk: defer the CRLF/CR decision to the\n        // next chunk (see `skipNextLineFeed`) rather than greedily consuming just the `\\r`.\n        if (lineEnd === chunk.length - 1 && chunk.charCodeAt(lineEnd) === CR) {\n            skippingLine = false;\n            skipNextLineFeed = true;\n            return '';\n        }\n        skippingLine = false;\n        return chunk.slice(lineEnd + (chunk.charCodeAt(lineEnd) === CR && chunk.charCodeAt(lineEnd + 1) === LF ? 2 : 1));\n    }\n    function storeTrailing(trailing) {\n        if (!trailing)\n            return;\n        // A trailing that ends with `\\r` is not a partial line: the `\\r` terminates it,\n        // and only the CRLF-vs-CR ambiguity remains (the matching `\\n` may start the next\n        // chunk). Parse the completed line now — buffering it could grow unbounded through\n        // the no-terminator append path, and discarding it would eat the terminator and\n        // make skip mode swallow the next line.\n        if (trailing.charCodeAt(trailing.length - 1) === CR) {\n            parseLine(trailing, 0, trailing.length - 1);\n            if (checkForBufferOverflow())\n                return;\n            skipNextLineFeed = true;\n            return;\n        }\n        if (shouldBufferTrailing(trailing)) {\n            pendingFragments.push(trailing);\n            pendingFragmentsLength = trailing.length;\n            return;\n        }\n        skippingLine = true;\n    }\n    function shouldBufferTrailing(trailing) {\n        const firstCharCode = trailing.charCodeAt(0);\n        return ((firstCharCode === 58 && !!onComment) ||\n            (firstCharCode === 100 && isPotentialField(trailing, 'data')) ||\n            (firstCharCode === 101 && isPotentialField(trailing, 'event')) ||\n            (firstCharCode === 105 && isPotentialField(trailing, 'id')) ||\n            (firstCharCode === 114 && isPotentialField(trailing, 'retry')));\n    }\n    // Returns true when parsing must stop for the current chunk (the parser was already\n    // terminated or has just overflowed), and false when processing can continue.\n    function checkForBufferOverflow() {\n        if (terminated)\n            return true;\n        if (maxBufferSize === undefined)\n            return false;\n        if (pendingFragmentsLength + data.length <= maxBufferSize)\n            return false;\n        terminated = true;\n        pendingFragments.length = 0;\n        pendingFragmentsLength = 0;\n        id = undefined;\n        data = '';\n        dataLines = 0;\n        eventType = undefined;\n        skippingLine = false;\n        skipNextLineFeed = false;\n        onError === null || onError === void 0 ? void 0 : onError(new ParseError(`Buffered data exceeded max buffer size of ${maxBufferSize} characters`, {\n            type: 'max-buffer-size-exceeded',\n        }));\n        return true;\n    }\n    /**\n     * Splits `chunk` into SSE lines and dispatches each to the appropriate handler.\n     * Returns any trailing bytes that did not terminate with a line break, so the\n     * caller can prepend them to the next chunk.\n     *\n     * The SSE spec permits three line terminators: `\\n`, `\\r`, and `\\r\\n`. Real-world\n     * streams almost always use plain `\\n`, so we take a fast path when no `\\r` is\n     * present in the chunk. The slow path is spec-correct but does more work per line.\n     */\n    function processLines(chunk) {\n        let searchIndex = 0;\n        // Fast path: LF-only chunk (the common case for typical SSE servers).\n        // We can scan forward with a single `indexOf('\\n')` per line and inline\n        // the hot-path branches for `data:` and `event:` without the CR bookkeeping\n        // the slow path needs.\n        if (chunk.indexOf('\\r') === -1) {\n            let lfIndex = chunk.indexOf('\\n', searchIndex);\n            while (lfIndex !== -1) {\n                // Blank line: end-of-event marker. Dispatch the accumulated event (if any)\n                // and reset the buffered fields. This is hoisted out of `parseLine` because\n                // it's the single most common line shape after `data:` lines.\n                if (searchIndex === lfIndex) {\n                    if (id !== undefined) {\n                        onId === null || onId === void 0 ? void 0 : onId(id);\n                    }\n                    if (dataLines > 0) {\n                        onEvent === null || onEvent === void 0 ? void 0 : onEvent({ id, event: eventType, data });\n                    }\n                    id = undefined;\n                    data = '';\n                    dataLines = 0;\n                    eventType = undefined;\n                    searchIndex = lfIndex + 1;\n                    lfIndex = chunk.indexOf('\\n', searchIndex);\n                    continue;\n                }\n                const firstCharCode = chunk.charCodeAt(searchIndex);\n                if (isDataPrefix(chunk, searchIndex, firstCharCode)) {\n                    // `data:` line — append the value to the event's data buffer.\n                    // 'data:'.length === 5, 'data: '.length === 6\n                    const valueStart = chunk.charCodeAt(searchIndex + 5) === SPACE ? searchIndex + 6 : searchIndex + 5;\n                    const value = chunk.slice(valueStart, lfIndex);\n                    // Fast path within a fast path: if this is the first data line AND the\n                    // next char is another LF (i.e. `data:foo\\n\\n`), dispatch immediately\n                    // without ever writing to the `data` buffer. This is the shape of a\n                    // typical single-line SSE event (ChatGPT-style streams, etc.) and is\n                    // hot enough to be worth the duplication.\n                    if (dataLines === 0 && chunk.charCodeAt(lfIndex + 1) === LF) {\n                        if (id !== undefined) {\n                            onId === null || onId === void 0 ? void 0 : onId(id);\n                        }\n                        onEvent === null || onEvent === void 0 ? void 0 : onEvent({ id, event: eventType, data: value });\n                        id = undefined;\n                        data = '';\n                        eventType = undefined;\n                        searchIndex = lfIndex + 2;\n                        lfIndex = chunk.indexOf('\\n', searchIndex);\n                        continue;\n                    }\n                    // Multi-line data: concatenate with newline separator per spec.\n                    data = dataLines === 0 ? value : `${data}\\n${value}`;\n                    dataLines++;\n                }\n                else if (isEventPrefix(chunk, searchIndex, firstCharCode)) {\n                    // `event:` line — set the event type for the next dispatch. Per spec,\n                    // an empty value resets `event type` to its default (undefined here).\n                    // 'event:'.length === 6, 'event: '.length === 7\n                    eventType =\n                        chunk.slice(chunk.charCodeAt(searchIndex + 6) === SPACE ? searchIndex + 7 : searchIndex + 6, lfIndex) || undefined;\n                }\n                else {\n                    // Everything else: `id:`, `retry:`, comment lines (`:` prefix), unknown\n                    // fields, or malformed lines. These are rarer and go through the full\n                    // per-line parser, which handles the SSE field grammar in detail.\n                    parseLine(chunk, searchIndex, lfIndex);\n                }\n                if (checkForBufferOverflow())\n                    return '';\n                searchIndex = lfIndex + 1;\n                lfIndex = chunk.indexOf('\\n', searchIndex);\n            }\n            return chunk.slice(searchIndex);\n        }\n        // Slow path: the chunk contains at least one `\\r`, so lines may be terminated\n        // by `\\r`, `\\n`, or `\\r\\n`. We locate the next terminator by looking at both\n        // the nearest `\\r` and `\\n` and picking whichever comes first.\n        while (searchIndex < chunk.length) {\n            const crIndex = chunk.indexOf('\\r', searchIndex);\n            const lfIndex = chunk.indexOf('\\n', searchIndex);\n            let lineEnd = -1;\n            if (crIndex !== -1 && lfIndex !== -1) {\n                lineEnd = crIndex < lfIndex ? crIndex : lfIndex;\n            }\n            else if (crIndex !== -1) {\n                // A trailing `\\r` at the very end of the chunk is ambiguous: it could be\n                // a bare-CR terminator, or the first half of a `\\r\\n` whose `\\n` arrives\n                // in the next chunk. Defer until we see more input.\n                if (crIndex === chunk.length - 1) {\n                    lineEnd = -1;\n                }\n                else {\n                    lineEnd = crIndex;\n                }\n            }\n            else if (lfIndex !== -1) {\n                lineEnd = lfIndex;\n            }\n            if (lineEnd === -1) {\n                break;\n            }\n            parseLine(chunk, searchIndex, lineEnd);\n            if (checkForBufferOverflow())\n                return '';\n            searchIndex = lineEnd + 1;\n            // If we just consumed a `\\r` and the next char is `\\n`, skip it so the\n            // pair is treated as a single terminator rather than an empty line.\n            if (chunk.charCodeAt(searchIndex - 1) === CR && chunk.charCodeAt(searchIndex) === LF) {\n                searchIndex++;\n            }\n        }\n        return chunk.slice(searchIndex);\n    }\n    function parseLine(chunk, start, end) {\n        if (start === end) {\n            dispatchEvent();\n            return;\n        }\n        const firstCharCode = chunk.charCodeAt(start);\n        if (isDataPrefix(chunk, start, firstCharCode)) {\n            // 'data:'.length === 5, 'data: '.length === 6\n            const valueStart = chunk.charCodeAt(start + 5) === SPACE ? start + 6 : start + 5;\n            const value = chunk.slice(valueStart, end);\n            data = dataLines === 0 ? value : `${data}\\n${value}`;\n            dataLines++;\n            return;\n        }\n        if (isEventPrefix(chunk, start, firstCharCode)) {\n            // 'event:'.length === 6, 'event: '.length === 7\n            eventType =\n                chunk.slice(chunk.charCodeAt(start + 6) === SPACE ? start + 7 : start + 6, end) || undefined;\n            return;\n        }\n        // Fast path for \"id:\" — 'i' = 105, 'd' = 100, ':' = 58\n        if (firstCharCode === 105 &&\n            chunk.charCodeAt(start + 1) === 100 &&\n            chunk.charCodeAt(start + 2) === 58) {\n            // 'id:'.length === 3, 'id: '.length === 4\n            const value = chunk.slice(chunk.charCodeAt(start + 3) === SPACE ? start + 4 : start + 3, end);\n            // If the field value does not contain U+0000 NULL, then set the `ID` buffer to\n            // the field value. Otherwise, ignore the field.\n            if (!value.includes('\\0'))\n                id = value;\n            return;\n        }\n        // Comment line — ':' = 58\n        if (firstCharCode === 58) {\n            if (onComment) {\n                const line = chunk.slice(start, end);\n                // skip ':' (+1), or ': ' (+2) when a space follows\n                onComment(line.slice(chunk.charCodeAt(start + 1) === SPACE ? 2 : 1));\n            }\n            return;\n        }\n        const line = chunk.slice(start, end);\n        const fieldSeparatorIndex = line.indexOf(':');\n        if (fieldSeparatorIndex === -1) {\n            processField(line, '', line);\n            return;\n        }\n        const field = line.slice(0, fieldSeparatorIndex);\n        // skip ':' (+1), or ': ' (+2) when a space follows\n        const offset = line.charCodeAt(fieldSeparatorIndex + 1) === SPACE ? 2 : 1;\n        const value = line.slice(fieldSeparatorIndex + offset);\n        processField(field, value, line);\n    }\n    function processField(field, value, line) {\n        // Field names must be compared literally, with no case folding performed.\n        switch (field) {\n            case 'event':\n                // Set the `event type` buffer to field value\n                eventType = value || undefined;\n                break;\n            case 'data':\n                data = dataLines === 0 ? value : `${data}\\n${value}`;\n                dataLines++;\n                break;\n            case 'id':\n                // If the field value does not contain U+0000 NULL, then set the `ID` buffer to\n                // the field value. Otherwise, ignore the field.\n                if (!value.includes('\\0'))\n                    id = value;\n                break;\n            case 'retry':\n                // If the field value consists of only ASCII digits, then interpret the field value as an\n                // integer in base ten, and set the event stream's reconnection time to that integer.\n                // Otherwise, ignore the field.\n                if (/^\\d+$/.test(value)) {\n                    onRetry === null || onRetry === void 0 ? void 0 : onRetry(parseInt(value, 10));\n                }\n                else {\n                    onError === null || onError === void 0 ? void 0 : onError(new ParseError(`Invalid \\`retry\\` value: \"${value}\"`, {\n                        type: 'invalid-retry',\n                        value,\n                        line,\n                    }));\n                }\n                break;\n            default:\n                // Otherwise, the field is ignored.\n                onError === null || onError === void 0 ? void 0 : onError(new ParseError(`Unknown field \"${field.length > 20 ? `${field.slice(0, 20)}…` : field}\"`, { type: 'unknown-field', field, value, line }));\n                break;\n        }\n    }\n    function dispatchEvent() {\n        if (id !== undefined) {\n            onId === null || onId === void 0 ? void 0 : onId(id);\n        }\n        if (dataLines > 0) {\n            onEvent === null || onEvent === void 0 ? void 0 : onEvent({\n                id,\n                event: eventType,\n                data,\n            });\n        }\n        id = undefined;\n        data = '';\n        dataLines = 0;\n        eventType = undefined;\n    }\n    function reset(options = {}) {\n        if (options.consume && pendingFragments.length > 0) {\n            const incompleteLine = pendingFragments.join('');\n            parseLine(incompleteLine, 0, incompleteLine.length);\n        }\n        bomPrefix = '';\n        id = undefined;\n        data = '';\n        dataLines = 0;\n        eventType = undefined;\n        pendingFragments.length = 0;\n        pendingFragmentsLength = 0;\n        terminated = false;\n        skippingLine = false;\n        skipNextLineFeed = false;\n    }\n    return { feed, reset };\n}\n/**\n * Checks if `chunk` starts with the literal `data:` at index `i`.\n *\n * Equivalent to `chunk.startsWith('data:', i)`, but benchmarks show this\n * hand-unrolled char-code comparison is ~20% faster on common event types.\n * The caller passes `firstCharCode` (the code at `i`) so it can be reused\n * across prefix checks.\n *\n * ASCII: 'd' = 100, 'a' = 97, 't' = 116, 'a' = 97, ':' = 58\n */\nfunction isDataPrefix(chunk, i, firstCharCode) {\n    return (firstCharCode === 100 &&\n        chunk.charCodeAt(i + 1) === 97 &&\n        chunk.charCodeAt(i + 2) === 116 &&\n        chunk.charCodeAt(i + 3) === 97 &&\n        chunk.charCodeAt(i + 4) === 58);\n}\n/**\n * Checks if `chunk` starts with the literal `event:` at index `i`.\n *\n * See {@link isDataPrefix} for why this is hand-unrolled rather than using\n * `String.prototype.startsWith`.\n *\n * ASCII: 'e' = 101, 'v' = 118, 'e' = 101, 'n' = 110, 't' = 116, ':' = 58\n */\nfunction isEventPrefix(chunk, i, firstCharCode) {\n    return (firstCharCode === 101 &&\n        chunk.charCodeAt(i + 1) === 118 &&\n        chunk.charCodeAt(i + 2) === 101 &&\n        chunk.charCodeAt(i + 3) === 110 &&\n        chunk.charCodeAt(i + 4) === 116 &&\n        chunk.charCodeAt(i + 5) === 58);\n}\nfunction isPotentialField(line, field) {\n    let i = 1;\n    while (i < line.length && i < field.length) {\n        if (line.charCodeAt(i) !== field.charCodeAt(i)) {\n            return false;\n        }\n        i++;\n    }\n    return line.length <= field.length || line.charCodeAt(field.length) === 58;\n}\n//# sourceMappingURL=parse.js.map","/**\n * SSE subscriber that turns `GET {base_path}/events` into callbacks.\n *\n * One connection per (fetch, url), reference-counted and fanned out to every\n * subscriber. The caller passes an already authenticated `fetch`: this is\n * fetch streaming, not `EventSource`, because `EventSource` cannot send an\n * Authorization header. Frames carry no `event:` name: the first has\n * `id: 0` and `{\"subscriber_id\": ...}`; later ones are record events. A\n * reconnect passes `?{resume_param}=<subscriber_id>` explicitly (never\n * `Last-Event-ID`, which the server would read as a subscriber id) when the\n * stream replays, and always tells subscribers to reset, so the gap is\n * covered even without replay. A stream silent for three keep-alive\n * intervals is dead and is reconnected with exponential backoff and jitter.\n * Events invalidate; they never apply snapshots.\n */\nimport { createParser } from \"eventsource-parser\";\nimport type { EventSourceMessage } from \"eventsource-parser\";\nimport type { CrudEvent, MaybePromise } from \"./interfaces.ts\";\n\n/** The manifest's `capabilities.events` object (I1), plain. */\nexport interface EventsConfig {\n  /** The server's event label, not the manifest name. */\n  readonly resource: string;\n  readonly path?: string;\n  readonly resume_param?: string;\n  readonly replay?: \"persistent\" | \"none\";\n  readonly keepalive_seconds?: number;\n}\n\n/**\n * What a subscriber wants to hear. A handler that throws must not kill the\n * stream, so errors are swallowed; handlers run one after another, in order.\n */\nexport interface EventHandlers {\n  onEvent(event: CrudEvent): MaybePromise<void>;\n  /** After every connect (the first included), and for an event with no usable record id: clear the resource. */\n  onReset?(): MaybePromise<void>;\n  /** `true` when the stream is connected, `false` on any loss, exit or unsubscribe. */\n  onStatus?(connected: boolean): MaybePromise<void>;\n}\n\n/** A shared event stream: `subscribe` returns the (idempotent) unsubscribe. */\nexport interface EventHub {\n  subscribe(handlers: EventHandlers): () => void;\n}\n\nexport interface EventHubOptions {\n  /** Authenticated; shared hubs are keyed by this function and `url`. */\n  readonly fetch: typeof fetch;\n  /** Absolute URL of the events endpoint. */\n  readonly url: string;\n  readonly events: EventsConfig;\n  /** Jitter source in `[0, 1)`; defaults to `Math.random`. */\n  readonly random?: () => number;\n}\n\nexport interface SubscribeEventsOptions extends EventHubOptions, EventHandlers {\n  /** Aborting unsubscribes. */\n  readonly signal?: AbortSignal;\n}\n\nconst BACKOFF_START_MS = 1000;\nconst BACKOFF_MAX_MS = 30_000;\nconst DEFAULT_KEEPALIVE_S = 15;\nconst DEAD_AFTER_KEEPALIVES = 3;\nconst ACTIONS: ReadonlySet<unknown> = new Set([\n  \"create\",\n  \"update\",\n  \"delete\",\n  \"restore\",\n]);\n\nconst registry = new WeakMap<typeof fetch, Map<string, Hub>>();\n\nfunction sleep(ms: number, signal: AbortSignal): Promise<void> {\n  return new Promise((resolve) => {\n    if (signal.aborted) {\n      resolve();\n      return;\n    }\n    const done = (): void => {\n      clearTimeout(timer);\n      signal.removeEventListener(\"abort\", done);\n      resolve();\n    };\n    const timer = setTimeout(done, ms);\n    signal.addEventListener(\"abort\", done, { once: true });\n  });\n}\n\nclass Hub {\n  private readonly handlers = new Set<EventHandlers>();\n  private readonly options: EventHubOptions;\n  private readonly onEmpty: () => void;\n  private controller: AbortController | undefined;\n  private connected = false;\n  private subscriberId: string | undefined;\n  private attempt = 0;\n\n  constructor(options: EventHubOptions, onEmpty: () => void) {\n    this.options = options;\n    this.onEmpty = onEmpty;\n  }\n\n  subscribe(handlers: EventHandlers): () => void {\n    // The same object may subscribe twice; give each subscription its own identity.\n    const entry: EventHandlers = {\n      onEvent: (event) => handlers.onEvent(event),\n      onReset: () => handlers.onReset?.(),\n      onStatus: (connected) => handlers.onStatus?.(connected),\n    };\n    this.handlers.add(entry);\n    if (this.controller === undefined) {\n      this.controller = new AbortController();\n      void this.run(this.controller.signal);\n    } else if (this.connected) {\n      void this.guard(() => entry.onStatus?.(true));\n    }\n    return () => {\n      if (!this.handlers.delete(entry)) {\n        return;\n      }\n      void this.guard(() => entry.onStatus?.(false));\n      if (this.handlers.size === 0) {\n        // Abort the live stream instead of waiting for the next frame.\n        this.controller?.abort();\n        this.controller = undefined;\n        this.onEmpty();\n      }\n    };\n  }\n\n  private async guard(\n    call: () => MaybePromise<void> | undefined,\n  ): Promise<void> {\n    try {\n      await call();\n    } catch {\n      // A failing subscriber must not take the stream down.\n    }\n  }\n\n  private async fan(\n    call: (handlers: EventHandlers) => MaybePromise<void> | undefined,\n  ): Promise<void> {\n    for (const handlers of Array.from(this.handlers)) {\n      await this.guard(() => call(handlers));\n    }\n  }\n\n  private async setConnected(connected: boolean): Promise<void> {\n    if (this.connected === connected) {\n      return;\n    }\n    this.connected = connected;\n    await this.fan((handlers) => handlers.onStatus?.(connected));\n  }\n\n  private backoff(): number {\n    const base = Math.min(BACKOFF_START_MS * 2 ** this.attempt, BACKOFF_MAX_MS);\n    this.attempt += 1;\n    const jitter = (this.options.random ?? Math.random)();\n    return Math.min(base * (1 + 0.5 * jitter), BACKOFF_MAX_MS);\n  }\n\n  /** Connect, read and reconnect until aborted. */\n  private async run(signal: AbortSignal): Promise<void> {\n    try {\n      while (!signal.aborted) {\n        try {\n          await this.readOnce(signal);\n        } catch {\n          // Lost, refused or dead: reconnect below.\n        }\n        await this.setConnected(false);\n        await sleep(this.backoff(), signal);\n      }\n    } finally {\n      // On any exit, tell the subscribers so the freshness gate closes.\n      await this.setConnected(false);\n    }\n  }\n\n  private resumeUrl(): string {\n    const { url, events } = this.options;\n    if (events.replay !== \"persistent\" || this.subscriberId === undefined) {\n      return url;\n    }\n    const param = events.resume_param ?? \"subscriber_id\";\n    const separator = url.includes(\"?\") ? \"&\" : \"?\";\n    return `${url}${separator}${encodeURIComponent(param)}=${encodeURIComponent(this.subscriberId)}`;\n  }\n\n  private async readOnce(signal: AbortSignal): Promise<void> {\n    const keepalive = this.options.events.keepalive_seconds;\n    const deadMs =\n      (keepalive ?? DEFAULT_KEEPALIVE_S) * DEAD_AFTER_KEEPALIVES * 1000;\n    const conn = new AbortController();\n    const abortConn = (): void => {\n      conn.abort();\n    };\n    signal.addEventListener(\"abort\", abortConn, { once: true });\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    const arm = (): void => {\n      clearTimeout(timer);\n      timer = setTimeout(abortConn, deadMs);\n    };\n    try {\n      arm();\n      const response = await this.options.fetch(this.resumeUrl(), {\n        headers: { accept: \"text/event-stream\" },\n        signal: conn.signal,\n      });\n      if (!response.ok || response.body === null) {\n        throw new Error(`event stream refused: HTTP ${response.status}`);\n      }\n      const reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      const pending: EventSourceMessage[] = [];\n      const parser = createParser({\n        onEvent: (message) => {\n          pending.push(message);\n        },\n      });\n      for (;;) {\n        const { done, value } = await reader.read();\n        if (done) {\n          return;\n        }\n        arm(); // any byte, keep-alive comments included, proves the stream is alive\n        parser.feed(decoder.decode(value, { stream: true }));\n        for (const message of pending.splice(0)) {\n          await this.handle(message);\n        }\n      }\n    } finally {\n      clearTimeout(timer);\n      signal.removeEventListener(\"abort\", abortConn);\n      conn.abort(); // release the connection on every way out\n    }\n  }\n\n  private async handle(message: EventSourceMessage): Promise<void> {\n    let data: unknown;\n    try {\n      data = JSON.parse(message.data);\n    } catch {\n      return;\n    }\n    if (typeof data !== \"object\" || data === null || Array.isArray(data)) {\n      return;\n    }\n    const record = data as Record<string, unknown>;\n    if (\"subscriber_id\" in record) {\n      this.subscriberId = String(record[\"subscriber_id\"]);\n      this.attempt = 0;\n      // Every connect, the first included: entries stored before this stream\n      // (an earlier page session, a persisted store) may predate server changes.\n      await this.fan((handlers) => handlers.onReset?.());\n      await this.setConnected(true);\n      return;\n    }\n    if (record[\"resource\"] !== this.options.events.resource) {\n      return;\n    }\n    const action = record[\"action\"];\n    const recordId = record[\"record_id\"];\n    if (!ACTIONS.has(action) || !Number.isInteger(recordId)) {\n      await this.fan((handlers) => handlers.onReset?.());\n      return;\n    }\n    const snapshot = record[\"snapshot\"];\n    const event: CrudEvent = {\n      resource: String(record[\"resource\"]),\n      recordId: recordId as number,\n      action: action as CrudEvent[\"action\"],\n      snapshot:\n        typeof snapshot === \"object\" && snapshot !== null\n          ? (snapshot as Record<string, unknown>)\n          : {},\n      timestamp: String(record[\"timestamp\"] ?? \"\"),\n    };\n    await this.fan((handlers) => handlers.onEvent(event));\n  }\n}\n\n/**\n * The shared hub for `(fetch, url)`: the first subscriber opens the stream,\n * the last one aborts it. A later subscribe after that opens a fresh one.\n */\nexport function getEventHub(options: EventHubOptions): EventHub {\n  return {\n    subscribe(handlers) {\n      let hubs = registry.get(options.fetch);\n      if (hubs === undefined) {\n        hubs = new Map();\n        registry.set(options.fetch, hubs);\n      }\n      const byUrl = hubs;\n      let hub = byUrl.get(options.url);\n      if (hub === undefined) {\n        hub = new Hub(options, () => {\n          byUrl.delete(options.url);\n        });\n        byUrl.set(options.url, hub);\n      }\n      return hub.subscribe(handlers);\n    },\n  };\n}\n\n/**\n * Subscribe to one resource's event stream. Returns the unsubscribe; the\n * last unsubscribe aborts the stream. `signal` aborting unsubscribes too.\n */\nexport function subscribeEvents(options: SubscribeEventsOptions): () => void {\n  const { signal } = options;\n  if (signal?.aborted === true) {\n    return () => undefined;\n  }\n  const unsubscribe = getEventHub(options).subscribe(options);\n  signal?.addEventListener(\"abort\", unsubscribe, { once: true });\n  return () => {\n    signal?.removeEventListener(\"abort\", unsubscribe);\n    unsubscribe();\n  };\n}\n"],"ignoreList":[1,2],"mappings":"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"}

package/dist/events-DpSWzSN9.d.mts

@@ -0,0 +1,88 @@
+import { i as MaybePromise, r as CrudEvent } from "./interfaces-s73cVfIF.mjs";
+//#region src/cache/policy.d.ts
+/** Per-resource cache policy, defaulted from the manifest `cache` hints. */
+/**
+ * How one resource is cached. Times are seconds. `maxAge` and
+ * `staleWhileRevalidate` only take effect while the resource's SSE stream is
+ * running; without it every read revalidates. `statsTtl` bounds the staleness
+ * of `stats`/`predict` on its own, as the server caches those bodies for the
+ * same time. `revalidateOnly` means no fresh window and no
+ * stale-while-revalidate.
+ */
+interface CachePolicy {
+  readonly enabled: boolean;
+  readonly maxAge: number;
+  readonly statsTtl: number;
+  readonly staleWhileRevalidate: number;
+  readonly etag: boolean;
+  readonly revalidateOnly: boolean;
+}
+/** The manifest resource members a policy reads (I1); everything else is ignored. */
+interface ManifestCacheHints {
+  readonly cache?: {
+    readonly max_age?: unknown;
+    readonly stats_ttl?: unknown;
+    readonly stale_while_revalidate?: unknown;
+    readonly etag?: unknown;
+    readonly revalidate_only?: unknown;
+  } | null;
+}
+/** Build a policy from a manifest resource object; `overrides` win over the hints. */
+declare function cachePolicyFromManifest(resource: ManifestCacheHints, overrides?: Partial<CachePolicy>): CachePolicy;
+/**
+ * The policy to use under TanStack Query: its `staleTime` decides freshness,
+ * so the SDK cache only revalidates (ETag/304) unless told otherwise.
+ */
+declare function tanstackCachePolicy(resource: ManifestCacheHints, overrides?: Partial<CachePolicy>): CachePolicy;
+//#endregion
+//#region src/events.d.ts
+/** The manifest's `capabilities.events` object (I1), plain. */
+interface EventsConfig {
+  /** The server's event label, not the manifest name. */
+  readonly resource: string;
+  readonly path?: string;
+  readonly resume_param?: string;
+  readonly replay?: "persistent" | "none";
+  readonly keepalive_seconds?: number;
+}
+/**
+ * What a subscriber wants to hear. A handler that throws must not kill the
+ * stream, so errors are swallowed; handlers run one after another, in order.
+ */
+interface EventHandlers {
+  onEvent(event: CrudEvent): MaybePromise<void>;
+  /** After every connect (the first included), and for an event with no usable record id: clear the resource. */
+  onReset?(): MaybePromise<void>;
+  /** `true` when the stream is connected, `false` on any loss, exit or unsubscribe. */
+  onStatus?(connected: boolean): MaybePromise<void>;
+}
+/** A shared event stream: `subscribe` returns the (idempotent) unsubscribe. */
+interface EventHub {
+  subscribe(handlers: EventHandlers): () => void;
+}
+interface EventHubOptions {
+  /** Authenticated; shared hubs are keyed by this function and `url`. */
+  readonly fetch: typeof fetch;
+  /** Absolute URL of the events endpoint. */
+  readonly url: string;
+  readonly events: EventsConfig;
+  /** Jitter source in `[0, 1)`; defaults to `Math.random`. */
+  readonly random?: () => number;
+}
+interface SubscribeEventsOptions extends EventHubOptions, EventHandlers {
+  /** Aborting unsubscribes. */
+  readonly signal?: AbortSignal;
+}
+/**
+ * The shared hub for `(fetch, url)`: the first subscriber opens the stream,
+ * the last one aborts it. A later subscribe after that opens a fresh one.
+ */
+declare function getEventHub(options: EventHubOptions): EventHub;
+/**
+ * Subscribe to one resource's event stream. Returns the unsubscribe; the
+ * last unsubscribe aborts the stream. `signal` aborting unsubscribes too.
+ */
+declare function subscribeEvents(options: SubscribeEventsOptions): () => void;
+//#endregion
+export { SubscribeEventsOptions as a, CachePolicy as c, tanstackCachePolicy as d, EventsConfig as i, ManifestCacheHints as l, EventHub as n, getEventHub as o, EventHubOptions as r, subscribeEvents as s, EventHandlers as t, cachePolicyFromManifest as u };
+//# sourceMappingURL=events-DpSWzSN9.d.mts.map

package/dist/index.d.mts

@@ -0,0 +1,98 @@
+import { a as Middleware, c as RequestContext, i as MaybePromise, l as TokenProvider, n as CacheStore, o as Next, r as CrudEvent, s as Op, t as CacheEntry, u as composeMiddleware } from "./interfaces-s73cVfIF.mjs";
+import { A as Pagination, C as Capabilities, D as JsonObject, E as GetJson, F as manifestUrlFromCatalog, I as parseManifest, M as Schemas, N as findResource, O as Manifest, P as loadManifest, S as CacheHints, T as FieldSpec, _ as encodeParams, a as PredictOptions, b as AuthSpec, c as RestoreOptions, d as createClient, f as Filters, g as buildQuery, h as Sort, i as ListOptions, j as Resource, k as PROFILE, l as StatsOptions, m as QueryParams, n as ClientOptions, o as RequestOptions, p as QueryField, r as CrudClient, s as ResourceClient, t as BulkResult, u as WriteOptions, v as formatScalar, w as EventsSpec, x as CATALOG_PATH, y as quote } from "./client-BLd126Jt.mjs";
+//#region src/auth.d.ts
+/** The scope of an anonymous caller. */
+export declare const ANON = "anon";
+/**
+ * Cache scope of a caller: `"anon"`, or the first 32 hex characters of the
+ * SHA-256 of the whole bearer token. Nothing in the token is trusted or
+ * decoded (a forged `sub` must not select another caller's entries), and the
+ * raw token never leaves this function.
+ */
+export declare function cacheScope(token: string | null | undefined): Promise<string>;
+/** A provider that always returns `token` (a refresh changes nothing). */
+export declare function staticToken(token: string | null): TokenProvider;
+//#endregion
+//#region src/errors.d.ts
+/**
+ * Error hierarchy: client-side errors and RFC 9457 problem details (ADR-0004).
+ * Mirrors the Python SDK class for class.
+ */
+/** Base class of every error this package throws on purpose. */
+export declare class CrudError extends Error {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** The call was refused before any request was sent. */
+export declare class ClientError extends CrudError {}
+/** The resource does not support the operation (manifest capability or path missing). */
+export declare class CapabilityError extends ClientError {}
+/** A filter, sort or paging argument is not valid for the resource. */
+export declare class InvalidQueryError extends ClientError {}
+/** The discovery document or the manifest is missing, unusable or of an unknown version. */
+export declare class ManifestError extends ClientError {}
+/** The manifest lists no such resource for this caller. */
+export declare class UnknownResourceError extends ClientError {}
+/** A successful response whose body is not the JSON the client expects; `cause` holds the parse error. */
+export declare class ResponseError extends CrudError {}
+/** The request never produced a response; `cause` holds the transport error. */
+export declare class ConnectionFailed extends CrudError {}
+/** One normalized validation error (`422`). */
+interface ProblemDetail {
+  readonly loc: readonly (string | number)[];
+  readonly msg: string;
+  readonly type: string;
+}
+/** Members of a {@link ProblemError}. */
+interface ProblemInit {
+  readonly status: number;
+  readonly title: string;
+  readonly detail?: string | undefined;
+  readonly type?: string | undefined;
+  readonly instance?: string | undefined;
+  readonly errors?: readonly ProblemDetail[] | undefined;
+  readonly headers?: Headers | undefined;
+  readonly response?: Response | undefined;
+}
+/** An error response, as RFC 9457 problem details. */
+export declare class ProblemError extends CrudError {
+  readonly status: number;
+  readonly title: string;
+  readonly detail: string | undefined;
+  readonly type: string;
+  readonly instance: string | undefined;
+  readonly errors: readonly ProblemDetail[];
+  readonly headers: Headers;
+  readonly response: Response | undefined;
+  constructor(init: ProblemInit);
+}
+/** 400. */
+export declare class BadRequest extends ProblemError {}
+/** 401; `wwwAuthenticate` keeps the challenge. */
+export declare class Unauthorized extends ProblemError {
+  get wwwAuthenticate(): string | undefined;
+}
+/** 403. */
+export declare class Forbidden extends ProblemError {}
+/** 404. */
+export declare class NotFound extends ProblemError {}
+/** 412: a stale `If-Match`. */
+export declare class PreconditionFailed extends ProblemError {}
+/** 422; `errors` holds normalized `{loc, msg, type}` entries. */
+export declare class ValidationFailed extends ProblemError {}
+/** 423. */
+export declare class Locked extends ProblemError {}
+/** 429; `retryAfter` is the `Retry-After` header in seconds, when it is a number. */
+export declare class RateLimited extends ProblemError {
+  get retryAfter(): number | undefined;
+}
+/** 5xx. */
+export declare class ServerError extends ProblemError {}
+/**
+ * Builds the matching `ProblemError` subclass from an error response. A body
+ * that is not a JSON object yields a synthesized problem from the status
+ * phrase. Reads a clone, so `response.body` stays readable.
+ */
+export declare function problemFromResponse(response: Response): Promise<ProblemError>;
+//#endregion
+export { type AuthSpec, type BulkResult, CATALOG_PATH, type CacheEntry, type CacheHints, type CacheStore, type Capabilities, type ClientOptions, CrudClient, type CrudEvent, type EventsSpec, type FieldSpec, type Filters, type GetJson, type JsonObject, type ListOptions, type Manifest, type MaybePromise, type Middleware, type Next, type Op, PROFILE, type Pagination, type PredictOptions, type ProblemDetail, type ProblemInit, type QueryField, type QueryParams, type RequestContext, type RequestOptions, type Resource, ResourceClient, type RestoreOptions, type Schemas, type Sort, type StatsOptions, type TokenProvider, type WriteOptions, buildQuery, composeMiddleware, createClient, encodeParams, findResource, formatScalar, loadManifest, manifestUrlFromCatalog, parseManifest, quote };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { A as UnknownResourceError, C as NotFound, D as ResponseError, E as RateLimited, M as problemFromResponse, N as composeMiddleware, O as ServerError, S as ManifestError, T as ProblemError, _ as ConnectionFailed, a as encodeParams, b as InvalidQueryError, c as CATALOG_PATH, d as loadManifest, f as manifestUrlFromCatalog, g as ClientError, h as CapabilityError, i as buildQuery, j as ValidationFailed, k as Unauthorized, l as PROFILE, m as BadRequest, n as ResourceClient, o as formatScalar, p as parseManifest, r as createClient, s as quote, t as CrudClient, u as findResource, v as CrudError, w as PreconditionFailed, x as Locked, y as Forbidden } from "./client-D0drumeA.mjs";
+import { n as cacheScope, r as staticToken, t as ANON } from "./auth-DwtNEKrw.mjs";
+export { ANON, BadRequest, CATALOG_PATH, CapabilityError, ClientError, ConnectionFailed, CrudClient, CrudError, Forbidden, InvalidQueryError, Locked, ManifestError, NotFound, PROFILE, PreconditionFailed, ProblemError, RateLimited, ResourceClient, ResponseError, ServerError, Unauthorized, UnknownResourceError, ValidationFailed, buildQuery, cacheScope, composeMiddleware, createClient, encodeParams, findResource, formatScalar, loadManifest, manifestUrlFromCatalog, parseManifest, problemFromResponse, quote, staticToken };

package/dist/interfaces-s73cVfIF.d.mts

@@ -0,0 +1,109 @@
+//#region src/interfaces.d.ts
+/**
+ * Contracts shared by the client core (TS1) and the cache layer (TS2).
+ * Fixed in TS0 (plan interface I3): change them only through the plan.
+ */
+/** A value or a promise of it. */
+type MaybePromise<T> = T | Promise<T>;
+/** What a request does, as classified by the client. */
+type Op = "manifest" | "list" | "record" | "filters" | "stats" | "predict" | "revisions" | "create" | "update" | "delete" | "bulk_update" | "bulk_delete" | "clone" | "draft" | "publish" | "restore" | "events";
+/**
+ * One stored `200` response. Times are epoch milliseconds (`Date.now()`).
+ * Structured-clone safe, so IndexedDB can store it as is.
+ */
+interface CacheEntry {
+  readonly status: number;
+  readonly headers: ReadonlyArray<readonly [string, string]>;
+  /** JSON text; the SDK only caches JSON. */
+  readonly body: string;
+  readonly storedAt: number;
+  /** `<= storedAt` means "always revalidate". */
+  readonly freshUntil: number;
+  /** End of the stale-while-revalidate window (`>= freshUntil`). */
+  readonly staleUntil: number;
+  readonly etag?: string;
+}
+/**
+ * Cache backend. Keys are opaque, slash-separated strings built by
+ * `./cache`'s `cacheKey`
+ * (`v1/{resource}/{kind}/{subject}/{apiVersion}/{scope}/{query}`, with `_`
+ * when there is no apiVersion).
+ * `ttlMs` is how long the backend may keep the entry (undefined = backend
+ * default); freshness lives in `CacheEntry`. `clear(prefix)` removes every
+ * key starting with `prefix`; `clear()` removes everything the store owns.
+ * Methods may be sync or async. They must not reject for a missing key
+ * (`get` resolves `undefined`), and a failing backend must not fail the
+ * request: the cache layer swallows store errors and treats them as a miss.
+ */
+interface CacheStore {
+  get(key: string): MaybePromise<CacheEntry | undefined>;
+  set(key: string, entry: CacheEntry, ttlMs?: number): MaybePromise<void>;
+  delete(key: string): MaybePromise<void>;
+  clear(prefix?: string): MaybePromise<void>;
+}
+/**
+ * What the client knows about a request that a bare `Request` does not. The
+ * client builds it for every call; middleware read it, so they never parse
+ * URLs or read Authorization.
+ */
+interface RequestContext {
+  /** The request about to be sent; replace it by passing a new context to `next`. */
+  readonly request: Request;
+  /** Manifest name; `undefined` for the manifest document itself. */
+  readonly resource: string | undefined;
+  readonly op: Op;
+  /** The record the request targets, when it targets one. */
+  readonly recordId: number | undefined;
+  /**
+   * "anon", or the first 32 hex characters of the SHA-256 of the
+   * Authorization credential actually sent.
+   */
+  readonly scope: string;
+  /**
+   * The resource's `api_version` from the manifest, or `null` when it has
+   * none. Part of the cache key, so versions never share entries (the cache
+   * layer renders `null` as `_`).
+   */
+  readonly apiVersion: string | null;
+  readonly signal: AbortSignal | undefined;
+}
+/** Calls the next middleware, or the network when none is left. */
+type Next = (ctx: RequestContext) => Promise<Response>;
+/**
+ * Onion middleware. In `chain = [a, b]`, `a` is outermost: the request runs
+ * a -> b -> fetch and the response returns fetch -> b -> a. A middleware may
+ * replace `ctx.request` (pass `{ ...ctx, request }` to `next`), return
+ * without calling `next` (short-circuit, e.g. a fresh cache hit), or replace
+ * the response (e.g. a `304` rebuilt from the cache). It must not consume
+ * `response.body` unless it returns a different `Response`; use
+ * `response.clone()` to read it.
+ */
+type Middleware = (ctx: RequestContext, next: Next) => Promise<Response>;
+/**
+ * Returns the bearer token, or `null`/`undefined` for an anonymous call.
+ * `refresh: true` is passed once after a `401`, to force a new token.
+ */
+type TokenProvider = (opts: {
+  readonly refresh: boolean;
+}) => MaybePromise<string | null | undefined>;
+/** One record-mutation event from `GET {basePath}/events` (the server's event envelope). */
+interface CrudEvent {
+  /** The server's event label (e.g. "hero"), not the manifest name. */
+  readonly resource: string;
+  readonly recordId: number;
+  readonly action: "create" | "update" | "delete" | "restore";
+  /** The read view of the record after the change. */
+  readonly snapshot: Readonly<Record<string, unknown>>;
+  /** ISO 8601, UTC. */
+  readonly timestamp: string;
+}
+/**
+ * Folds `chain` (outermost first) around `terminal`, usually the network
+ * `fetch`, into one `Next`. Each middleware's `next` is the rest of the
+ * chain; an empty chain is `terminal`. A throwing middleware yields a
+ * rejected promise.
+ */
+declare function composeMiddleware(chain: readonly Middleware[], terminal: Next): Next;
+//#endregion
+export { Middleware as a, RequestContext as c, MaybePromise as i, TokenProvider as l, CacheStore as n, Next as o, CrudEvent as r, Op as s, CacheEntry as t, composeMiddleware as u };
+//# sourceMappingURL=interfaces-s73cVfIF.d.mts.map

package/dist/tanstack/index.d.mts

@@ -0,0 +1,182 @@
+import { r as CrudEvent } from "../interfaces-s73cVfIF.mjs";
+import { a as SubscribeEventsOptions, c as CachePolicy, d as tanstackCachePolicy, i as EventsConfig, l as ManifestCacheHints, n as EventHub, o as getEventHub, r as EventHubOptions, s as subscribeEvents, t as EventHandlers } from "../events-DpSWzSN9.mjs";
+import { D as JsonObject, O as Manifest, r as CrudClient, s as ResourceClient } from "../client-BLd126Jt.mjs";
+import { DataTag, QueryClient } from "@tanstack/query-core";
+//#region src/tanstack/adapter.d.ts
+type Init = {
+  signal?: AbortSignal;
+};
+/** What `tanstackApi` returns: every slice the factories use, bound to one resource. */
+interface TanstackApi<Read, Create, Update> {
+  list(query: CrudQuery | undefined, init?: Init): Promise<Read[]>;
+  get(id: number, init?: Init): Promise<Read>;
+  stats(query: CrudQuery | undefined, init?: Init): Promise<JsonObject>;
+  predict(query: CrudQuery | undefined, init?: Init): Promise<JsonObject>;
+  revisions(id: number, init?: Init): Promise<JsonObject[]>;
+  /** The manifest the client already loaded (the client's loader takes no signal). */
+  manifest(init?: Init): Promise<Manifest>;
+  create(body: Create): Promise<Read>;
+  update(id: number, patch: Update, init?: {
+    ifMatch?: string;
+  }): Promise<Read>;
+  delete(id: number): Promise<void>;
+}
+/**
+ * A query is the client's `ListOptions`, `StatsOptions` or `PredictOptions`
+ * without `signal` (`{ filters, sort, skip, limit, ... }`); TanStack's signal
+ * is added per call.
+ */
+export declare function tanstackApi<Read extends object, Create extends object, Update extends object>(client: CrudClient, resource: ResourceClient<Read, Create, Update>): TanstackApi<Read, Create, Update>;
+//#endregion
+//#region src/tanstack/index.d.ts
+/** A query object as the client's query builder takes it. */
+export type CrudQuery = Readonly<Record<string, unknown>>;
+type Key = readonly unknown[];
+/** The key factory type. */
+export interface CrudKeys {
+  readonly all: readonly ["crud"];
+  /** Everything of one resource. */
+  resource(resource: string): readonly ["crud", string];
+  /** All lists of one resource, plain and infinite. */
+  lists(resource: string): readonly ["crud", string, "list"];
+  list(resource: string, query?: CrudQuery): Key;
+  infiniteList(resource: string, query: CrudQuery, limit: number): Key;
+  /** All record queries of one resource. */
+  records(resource: string): readonly ["crud", string, "record"];
+  record(resource: string, id: number): readonly ["crud", string, "record", number];
+  stats(resource: string, query?: CrudQuery): Key;
+  predict(resource: string, query?: CrudQuery): Key;
+  revisions(resource: string, id: number): readonly ["crud", string, "revisions", number];
+  /** The manifest, optionally of one caller scope. */
+  manifest(scope?: string): Key;
+}
+/** The key factory. Every key starts with `["crud", resource, ...]`, so prefixes invalidate by resource, kind or record. */
+export declare const crudKeys: CrudKeys;
+/** What a query function receives from TanStack Query (a subset). */
+export interface QueryContext {
+  readonly signal: AbortSignal;
+}
+export interface QueryOptionsInit {
+  /** TanStack's `staleTime` in milliseconds. Default 0 (the SDK cache revalidates for free). */
+  readonly staleTime?: number;
+}
+/** Plain query options with a typed key; spread into `useQuery`/`fetchQuery`. */
+export interface CrudQueryOptions<T> {
+  readonly queryKey: DataTag<Key, T, Error>;
+  readonly queryFn: (context: QueryContext) => Promise<T>;
+  readonly staleTime: number;
+}
+export interface CrudInfiniteQueryOptions<T> {
+  readonly queryKey: DataTag<Key, {
+    pages: T[][];
+    pageParams: number[];
+  }, Error>;
+  readonly queryFn: (context: QueryContext & {
+    pageParam: number;
+  }) => Promise<T[]>;
+  readonly initialPageParam: number;
+  /** `skip + limit` unless the page was short. */
+  readonly getNextPageParam: (lastPage: T[], allPages: T[][], lastPageParam: number) => number | undefined;
+  readonly staleTime: number;
+}
+/** The slices of a resource API the factories call (structural: TS1's resource client fits). */
+export interface ListApi<T> {
+  list(query: CrudQuery | undefined, init?: {
+    signal?: AbortSignal;
+  }): Promise<T[]>;
+}
+export interface RecordApi<T> {
+  get(id: number, init?: {
+    signal?: AbortSignal;
+  }): Promise<T>;
+}
+export interface StatsApi<S> {
+  stats(query: CrudQuery | undefined, init?: {
+    signal?: AbortSignal;
+  }): Promise<S>;
+}
+export interface PredictApi<P> {
+  predict(query: CrudQuery | undefined, init?: {
+    signal?: AbortSignal;
+  }): Promise<P>;
+}
+export interface RevisionsApi<R> {
+  revisions(id: number, init?: {
+    signal?: AbortSignal;
+  }): Promise<R[]>;
+}
+export interface ManifestApi<M> {
+  manifest(init?: {
+    signal?: AbortSignal;
+  }): Promise<M>;
+}
+export interface CreateApi<T, C> {
+  create(body: C): Promise<T>;
+}
+export interface UpdateApi<T, P> {
+  update(id: number, patch: P, init?: {
+    ifMatch?: string;
+  }): Promise<T>;
+}
+export interface DeleteApi {
+  delete(id: number): Promise<unknown>;
+}
+export declare function listOptions<T>(resource: string, api: ListApi<T>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<T[]>;
+export declare function recordOptions<T>(resource: string, api: RecordApi<T>, id: number, init?: QueryOptionsInit): CrudQueryOptions<T>;
+export declare function statsOptions<S>(resource: string, api: StatsApi<S>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<S>;
+export declare function predictOptions<P>(resource: string, api: PredictApi<P>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<P>;
+export declare function revisionsOptions<R>(resource: string, api: RevisionsApi<R>, id: number, init?: QueryOptionsInit): CrudQueryOptions<R[]>;
+export declare function manifestOptions<M>(api: ManifestApi<M>, scope?: string, init?: QueryOptionsInit): CrudQueryOptions<M>;
+export interface InfiniteListInit extends QueryOptionsInit {
+  /** Page size; default 100 (the server's default). */
+  readonly limit?: number;
+  /**
+   * Keys of the paging parameters in the query object handed to `api.list`.
+   * Default `skip`/`limit`, which is what `tanstackApi` (the client's
+   * `ListOptions`) reads; change them only for a hand-written `ListApi`. The
+   * client maps them to the manifest's `skip_param`/`limit_param` itself.
+   */
+  readonly skipKey?: string;
+  readonly limitKey?: string;
+}
+/** Offset paging: the next page starts at `skip + limit`, unless the last page was short. */
+export declare function infiniteListOptions<T>(resource: string, api: ListApi<T>, query?: CrudQuery, init?: InfiniteListInit): CrudInfiniteQueryOptions<T>;
+export type Invalidator = Pick<QueryClient, "invalidateQueries" | "removeQueries" | "setQueryData">;
+export interface CreateMutationOptions<T, C> {
+  readonly mutationKey: readonly ["crud", string, "create"];
+  readonly mutationFn: (body: C) => Promise<T>;
+  readonly onSuccess: () => Promise<void>;
+}
+export interface UpdateMutationOptions<T, P> {
+  readonly mutationKey: readonly ["crud", string, "update"];
+  readonly mutationFn: (variables: UpdateVariables<P>) => Promise<T>;
+  readonly onSuccess: (record: T, variables: UpdateVariables<P>) => Promise<void>;
+}
+export interface DeleteMutationOptions {
+  readonly mutationKey: readonly ["crud", string, "delete"];
+  readonly mutationFn: (id: number) => Promise<unknown>;
+  readonly onSuccess: (result: unknown, id: number) => Promise<void>;
+}
+/** Create: invalidate lists, stats and predict. */
+export declare function createMutationOptions<T, C>(client: Invalidator, resource: string, api: CreateApi<T, C>): CreateMutationOptions<T, C>;
+export interface UpdateVariables<P> {
+  readonly id: number;
+  readonly patch: P;
+  /** Sent as `If-Match`; a stale one fails with 412. */
+  readonly ifMatch?: string;
+}
+/** Update: `setQueryData` from the PATCH response, invalidate lists, stats, predict and revisions. */
+export declare function updateMutationOptions<T, P>(client: Invalidator, resource: string, api: UpdateApi<T, P>): UpdateMutationOptions<T, P>;
+/** Delete: drop the record query, invalidate lists, stats, predict and revisions. */
+export declare function deleteMutationOptions(client: Invalidator, resource: string, api: DeleteApi): DeleteMutationOptions;
+/**
+ * Invalidate TanStack queries from the resource's event stream. Events
+ * invalidate and never apply snapshots: `create` invalidates lists, stats and
+ * predict; `update`/`delete`/`restore` also the record and its revisions; a
+ * reconnect (or an event with no usable record id) invalidates the resource.
+ * Returns the unsubscribe.
+ */
+export declare function bridgeEvents(client: Pick<QueryClient, "invalidateQueries">, hub: EventHub, resource: string): () => void;
+//#endregion
+export { type CachePolicy, type CrudEvent, type EventHandlers, type EventHub, type EventHubOptions, type EventsConfig, type ManifestCacheHints, type SubscribeEventsOptions, type TanstackApi, getEventHub, subscribeEvents, tanstackCachePolicy };
+//# sourceMappingURL=index.d.mts.map