@craftainer/crud-sdk 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -117,15 +117,46 @@ events }), "heroes")`; `fetch` must be authenticated. Events invalidate and
117
117
  `./tanstack` has no runtime dependency on `@tanstack/query-core`: `crudKeys`,
118
118
  `listOptions`/`recordOptions`/`statsOptions`/`predictOptions`/
119
119
  `revisionsOptions`/`manifestOptions`, `infiniteListOptions`, the
120
- `create`/`update`/`deleteMutationOptions` and `bridgeEvents(queryClient, hub,
121
- resource)`. Use `tanstackCachePolicy` so the SDK cache only revalidates and
122
- TanStack's `staleTime` owns freshness. The factories take structural slices (`list(query, { signal })`, ...), which
120
+ `create`/`update`/`deleteMutationOptions`, `invalidateResource`/
121
+ `invalidateCollections`/`invalidateRecord` (each takes `{ client, resource }`)
122
+ and `bridgeEvents(queryClient, hub, { client, resource })`, where `client` is
123
+ the id string (`client.id`) and `resource` the same string the keys use. Use
124
+ `tanstackCachePolicy` so the SDK cache only revalidates and TanStack's
125
+ `staleTime` owns freshness. The factories take structural slices (`list(query, { signal })`, ...), which
123
126
  the client's options-object methods do not match for `list`, `stats`,
124
127
  `predict` and the manifest. `tanstackApi(client, resource)` (from
125
128
  `./tanstack`) binds one `ResourceClient` to all of them; a query is the
126
129
  client's `ListOptions` (`{ filters, sort, skip, limit, ... }`) without
127
130
  `signal`, which TanStack's `signal` fills in.
128
131
 
132
+ **Query keys** are namespaced by client and caller scope, so clients or
133
+ callers sharing one `QueryClient` never see each other's data:
134
+
135
+ ```
136
+ ["crud", client, resource, scope, kind, ...rest] kind: list | record | stats | predict | revisions
137
+ ["crud", client, "_manifest", scope]
138
+ ```
139
+
140
+ `client` is `CrudClient.id` (`createClient({ id })`, default `baseUrl`; keep it
141
+ stable across reloads of a persisted cache). `scope` is `client.scope()`.
142
+ `await client.namespace()` returns the `{ client, scope }` that every factory
143
+ takes as its first argument (`listOptions(ns, resource, api, query)`,
144
+ `createMutationOptions(queryClient, ns, resource, api)`). `resource` is the
145
+ manifest name, or `name@apiVersion` for a pinned version (a different
146
+ string is a different resource: pass the same one to the invalidate helpers
147
+ and `bridgeEvents`; `_manifest` is reserved). The namespace is a snapshot: a
148
+ token change (login, logout, refresh to another identity) changes the scope,
149
+ so resolve it again then, for example in a provider keyed on the token.
150
+ Clients that share a `baseUrl` but differ in anything else need distinct ids.
151
+
152
+ Because `resource` precedes `scope`, "everything of resource X on client C" is
153
+ one prefix (`crudKeys.resource(c, x)`, or `invalidateResource(queryClient, c,
154
+ x)`), and `crudKeys.client(c)` clears a whole client. Narrowing by scope, kind
155
+ or record id uses `crudKeys.filter({ client, resource?, scope?, kinds?, id? })`,
156
+ which returns `{ queryKey }` or `{ predicate }` to spread into
157
+ `invalidateQueries`/`removeQueries`. Mutations and `bridgeEvents` invalidate
158
+ every scope of the client's resource, since a write changes what every caller sees.
159
+
129
160
  ```ts
130
161
  import { createClient } from "@craftainer/crud-sdk";
131
162
  import {
@@ -144,7 +175,7 @@ const client = createClient({
144
175
  middleware: [cache.middleware, cache.autoIfMatch],
145
176
  });
146
177
  const api = tanstackApi(client, await client.resource("heroes"));
147
- useQuery(listOptions("heroes", api, { limit: 50 }));
178
+ useQuery(listOptions(await client.namespace(), "heroes", api, { limit: 50 }));
148
179
  ```
149
180
 
150
181
  Cache keys carry no server origin, so a store shared between servers needs a
@@ -277,11 +277,19 @@ interface ClientOptions {
277
277
  readonly middleware?: readonly Middleware[] | undefined;
278
278
  /** Skips api-catalog discovery. */
279
279
  readonly manifestUrl?: string | undefined;
280
+ /**
281
+ * Stable identity of this client in TanStack query keys. Defaults to
282
+ * `baseUrl`; set it when two clients share a `baseUrl` but must not share
283
+ * cached data, and keep it constant across reloads of a persisted cache.
284
+ */
285
+ readonly id?: string | undefined;
280
286
  }
281
287
  /** Discovers the manifest and hands out {@link ResourceClient}s. */
282
288
  declare class CrudClient {
283
289
  #private;
284
290
  readonly baseUrl: string;
291
+ /** Stable identity in TanStack query keys (`ClientOptions.id`, else `baseUrl`). */
292
+ readonly id: string;
285
293
  constructor(options: ClientOptions);
286
294
  /** Adds middleware after the existing ones (innermost); it sees every later request. */
287
295
  use(middleware: Middleware): this;
@@ -289,6 +297,11 @@ declare class CrudClient {
289
297
  token(refresh?: boolean): Promise<string | null>;
290
298
  /** The cache scope of the current caller (`"anon"` or a hash of the token). */
291
299
  scope(): Promise<string>;
300
+ /** The `{ client, scope }` namespace the `./tanstack` key factory takes. */
301
+ namespace(): Promise<{
302
+ readonly client: string;
303
+ readonly scope: string;
304
+ }>;
292
305
  /** The manifest for this caller, loaded once per caller scope (`refresh: true` reloads). */
293
306
  manifest(options?: {
294
307
  readonly refresh?: boolean;
@@ -300,4 +313,4 @@ declare class CrudClient {
300
313
  declare function createClient(options: ClientOptions): CrudClient;
301
314
  //#endregion
302
315
  export { Pagination as A, Capabilities as C, JsonObject as D, GetJson as E, manifestUrlFromCatalog as F, parseManifest as I, Schemas as M, findResource as N, Manifest as O, loadManifest as P, CacheHints as S, FieldSpec as T, encodeParams as _, PredictOptions as a, AuthSpec as b, RestoreOptions as c, createClient as d, Filters as f, buildQuery as g, Sort as h, ListOptions as i, Resource as j, PROFILE as k, StatsOptions as l, QueryParams as m, ClientOptions as n, RequestOptions as o, QueryField as p, CrudClient as r, ResourceClient as s, BulkResult as t, WriteOptions as u, formatScalar as v, EventsSpec as w, CATALOG_PATH as x, quote as y };
303
- //# sourceMappingURL=client-BLd126Jt.d.mts.map
316
+ //# sourceMappingURL=client-B8fSsx4L.d.mts.map
@@ -773,6 +773,8 @@ var ResourceClient = class {
773
773
  /** Discovers the manifest and hands out {@link ResourceClient}s. */
774
774
  var CrudClient = class {
775
775
  baseUrl;
776
+ /** Stable identity in TanStack query keys (`ClientOptions.id`, else `baseUrl`). */
777
+ id;
776
778
  #fetch;
777
779
  #tokenProvider;
778
780
  #middleware;
@@ -781,6 +783,7 @@ var CrudClient = class {
781
783
  #transport;
782
784
  constructor(options) {
783
785
  this.baseUrl = options.baseUrl;
786
+ this.id = options.id ?? options.baseUrl;
784
787
  this.#fetch = options.fetch;
785
788
  this.#tokenProvider = options.tokenProvider;
786
789
  this.#middleware = [...options.middleware ?? []];
@@ -816,6 +819,13 @@ var CrudClient = class {
816
819
  async scope() {
817
820
  return cacheScope(await this.#token(false));
818
821
  }
822
+ /** The `{ client, scope }` namespace the `./tanstack` key factory takes. */
823
+ async namespace() {
824
+ return {
825
+ client: this.id,
826
+ scope: await this.scope()
827
+ };
828
+ }
819
829
  async #dispatch(call, token, signal) {
820
830
  const headers = new Headers({
821
831
  Accept: "application/json",
@@ -910,4 +920,4 @@ function createClient(options) {
910
920
  //#endregion
911
921
  export { UnknownResourceError as A, NotFound as C, ResponseError as D, RateLimited as E, problemFromResponse as M, composeMiddleware as N, ServerError as O, ManifestError as S, ProblemError as T, ConnectionFailed as _, encodeParams as a, InvalidQueryError as b, CATALOG_PATH as c, loadManifest as d, manifestUrlFromCatalog as f, ClientError as g, CapabilityError as h, buildQuery as i, ValidationFailed as j, Unauthorized as k, PROFILE as l, BadRequest as m, ResourceClient as n, formatScalar as o, parseManifest as p, createClient as r, quote as s, CrudClient as t, findResource as u, CrudError as v, PreconditionFailed as w, Locked as x, Forbidden as y };
912
922
 
913
- //# sourceMappingURL=client-D0drumeA.mjs.map
923
+ //# sourceMappingURL=client-Bv0yCuwC.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"client-D0drumeA.mjs","names":["isObject"],"sources":["../src/interfaces.ts","../src/errors.ts","../src/manifest.ts","../src/query.ts","../src/client.ts"],"sourcesContent":["/**\n * Contracts shared by the client core (TS1) and the cache layer (TS2).\n * Fixed in TS0 (plan interface I3): change them only through the plan.\n */\n\n/** A value or a promise of it. */\nexport type MaybePromise<T> = T | Promise<T>;\n\n/** What a request does, as classified by the client. */\nexport type Op =\n | \"manifest\"\n | \"list\"\n | \"record\"\n | \"filters\"\n | \"stats\"\n | \"predict\"\n | \"revisions\"\n | \"create\"\n | \"update\"\n | \"delete\"\n | \"bulk_update\"\n | \"bulk_delete\"\n | \"clone\"\n | \"draft\"\n | \"publish\"\n | \"restore\"\n | \"events\";\n\n/**\n * One stored `200` response. Times are epoch milliseconds (`Date.now()`).\n * Structured-clone safe, so IndexedDB can store it as is.\n */\nexport interface CacheEntry {\n readonly status: number;\n readonly headers: ReadonlyArray<readonly [string, string]>;\n /** JSON text; the SDK only caches JSON. */\n readonly body: string;\n readonly storedAt: number;\n /** `<= storedAt` means \"always revalidate\". */\n readonly freshUntil: number;\n /** End of the stale-while-revalidate window (`>= freshUntil`). */\n readonly staleUntil: number;\n readonly etag?: string;\n}\n\n/**\n * Cache backend. Keys are opaque, slash-separated strings built by\n * `./cache`'s `cacheKey`\n * (`v1/{resource}/{kind}/{subject}/{apiVersion}/{scope}/{query}`, with `_`\n * when there is no apiVersion).\n * `ttlMs` is how long the backend may keep the entry (undefined = backend\n * default); freshness lives in `CacheEntry`. `clear(prefix)` removes every\n * key starting with `prefix`; `clear()` removes everything the store owns.\n * Methods may be sync or async. They must not reject for a missing key\n * (`get` resolves `undefined`), and a failing backend must not fail the\n * request: the cache layer swallows store errors and treats them as a miss.\n */\nexport interface CacheStore {\n get(key: string): MaybePromise<CacheEntry | undefined>;\n set(key: string, entry: CacheEntry, ttlMs?: number): MaybePromise<void>;\n delete(key: string): MaybePromise<void>;\n clear(prefix?: string): MaybePromise<void>;\n}\n\n/**\n * What the client knows about a request that a bare `Request` does not. The\n * client builds it for every call; middleware read it, so they never parse\n * URLs or read Authorization.\n */\nexport interface RequestContext {\n /** The request about to be sent; replace it by passing a new context to `next`. */\n readonly request: Request;\n /** Manifest name; `undefined` for the manifest document itself. */\n readonly resource: string | undefined;\n readonly op: Op;\n /** The record the request targets, when it targets one. */\n readonly recordId: number | undefined;\n /**\n * \"anon\", or the first 32 hex characters of the SHA-256 of the\n * Authorization credential actually sent.\n */\n readonly scope: string;\n /**\n * The resource's `api_version` from the manifest, or `null` when it has\n * none. Part of the cache key, so versions never share entries (the cache\n * layer renders `null` as `_`).\n */\n readonly apiVersion: string | null;\n readonly signal: AbortSignal | undefined;\n}\n\n/** Calls the next middleware, or the network when none is left. */\nexport type Next = (ctx: RequestContext) => Promise<Response>;\n\n/**\n * Onion middleware. In `chain = [a, b]`, `a` is outermost: the request runs\n * a -> b -> fetch and the response returns fetch -> b -> a. A middleware may\n * replace `ctx.request` (pass `{ ...ctx, request }` to `next`), return\n * without calling `next` (short-circuit, e.g. a fresh cache hit), or replace\n * the response (e.g. a `304` rebuilt from the cache). It must not consume\n * `response.body` unless it returns a different `Response`; use\n * `response.clone()` to read it.\n */\nexport type Middleware = (ctx: RequestContext, next: Next) => Promise<Response>;\n\n/**\n * Returns the bearer token, or `null`/`undefined` for an anonymous call.\n * `refresh: true` is passed once after a `401`, to force a new token.\n */\nexport type TokenProvider = (opts: {\n readonly refresh: boolean;\n}) => MaybePromise<string | null | undefined>;\n\n/** One record-mutation event from `GET {basePath}/events` (the server's event envelope). */\nexport interface CrudEvent {\n /** The server's event label (e.g. \"hero\"), not the manifest name. */\n readonly resource: string;\n readonly recordId: number;\n readonly action: \"create\" | \"update\" | \"delete\" | \"restore\";\n /** The read view of the record after the change. */\n readonly snapshot: Readonly<Record<string, unknown>>;\n /** ISO 8601, UTC. */\n readonly timestamp: string;\n}\n\n/**\n * Folds `chain` (outermost first) around `terminal`, usually the network\n * `fetch`, into one `Next`. Each middleware's `next` is the rest of the\n * chain; an empty chain is `terminal`. A throwing middleware yields a\n * rejected promise.\n */\nexport function composeMiddleware(\n chain: readonly Middleware[],\n terminal: Next,\n): Next {\n const dispatch = async (\n index: number,\n ctx: RequestContext,\n ): Promise<Response> => {\n const middleware = chain[index];\n if (middleware === undefined) {\n return terminal(ctx);\n }\n return middleware(ctx, (next) => dispatch(index + 1, next));\n };\n return (ctx) => dispatch(0, ctx);\n}\n","/**\n * Error hierarchy: client-side errors and RFC 9457 problem details (ADR-0004).\n * Mirrors the Python SDK class for class.\n */\n\n/** Base class of every error this package throws on purpose. */\nexport class CrudError extends Error {\n constructor(message: string, options?: ErrorOptions) {\n super(message, options);\n this.name = new.target.name;\n }\n}\n\n/** The call was refused before any request was sent. */\nexport class ClientError extends CrudError {}\n\n/** The resource does not support the operation (manifest capability or path missing). */\nexport class CapabilityError extends ClientError {}\n\n/** A filter, sort or paging argument is not valid for the resource. */\nexport class InvalidQueryError extends ClientError {}\n\n/** The discovery document or the manifest is missing, unusable or of an unknown version. */\nexport class ManifestError extends ClientError {}\n\n/** The manifest lists no such resource for this caller. */\nexport class UnknownResourceError extends ClientError {}\n\n/** A successful response whose body is not the JSON the client expects; `cause` holds the parse error. */\nexport class ResponseError extends CrudError {}\n\n/** The request never produced a response; `cause` holds the transport error. */\nexport class ConnectionFailed extends CrudError {}\n\n/** One normalized validation error (`422`). */\nexport interface ProblemDetail {\n readonly loc: readonly (string | number)[];\n readonly msg: string;\n readonly type: string;\n}\n\n/** Members of a {@link ProblemError}. */\nexport interface ProblemInit {\n readonly status: number;\n readonly title: string;\n readonly detail?: string | undefined;\n readonly type?: string | undefined;\n readonly instance?: string | undefined;\n readonly errors?: readonly ProblemDetail[] | undefined;\n readonly headers?: Headers | undefined;\n readonly response?: Response | undefined;\n}\n\nconst NO_TYPE = \"about:blank\";\n\n/** An error response, as RFC 9457 problem details. */\nexport class ProblemError extends CrudError {\n readonly status: number;\n readonly title: string;\n readonly detail: string | undefined;\n readonly type: string;\n readonly instance: string | undefined;\n readonly errors: readonly ProblemDetail[];\n readonly headers: Headers;\n readonly response: Response | undefined;\n\n constructor(init: ProblemInit) {\n const errors = init.errors ?? [];\n let message = `${init.status} ${init.title}`;\n if (init.detail) {\n message += `: ${init.detail}`;\n } else if (errors.length > 0) {\n message += `: ${errors.map((e) => `${e.loc.join(\".\")}: ${e.msg}`).join(\"; \")}`;\n }\n super(message);\n this.status = init.status;\n this.title = init.title;\n this.detail = init.detail;\n this.type = init.type ?? NO_TYPE;\n this.instance = init.instance;\n this.errors = errors;\n this.headers = init.headers ?? new Headers();\n this.response = init.response;\n }\n}\n\n/** 400. */\nexport class BadRequest extends ProblemError {}\n\n/** 401; `wwwAuthenticate` keeps the challenge. */\nexport class Unauthorized extends ProblemError {\n get wwwAuthenticate(): string | undefined {\n return this.headers.get(\"www-authenticate\") ?? undefined;\n }\n}\n\n/** 403. */\nexport class Forbidden extends ProblemError {}\n\n/** 404. */\nexport class NotFound extends ProblemError {}\n\n/** 412: a stale `If-Match`. */\nexport class PreconditionFailed extends ProblemError {}\n\n/** 422; `errors` holds normalized `{loc, msg, type}` entries. */\nexport class ValidationFailed extends ProblemError {}\n\n/** 423. */\nexport class Locked extends ProblemError {}\n\n/** 429; `retryAfter` is the `Retry-After` header in seconds, when it is a number. */\nexport class RateLimited extends ProblemError {\n get retryAfter(): number | undefined {\n const raw = this.headers.get(\"retry-after\");\n if (raw === null || raw.trim() === \"\") {\n return undefined;\n }\n const seconds = Number(raw);\n return Number.isNaN(seconds) ? undefined : seconds;\n }\n}\n\n/** 5xx. */\nexport class ServerError extends ProblemError {}\n\nconst BY_STATUS: ReadonlyMap<number, typeof ProblemError> = new Map([\n [400, BadRequest],\n [401, Unauthorized],\n [403, Forbidden],\n [404, NotFound],\n [412, PreconditionFailed],\n [422, ValidationFailed],\n [423, Locked],\n [429, RateLimited],\n]);\n\n// Python's `http.HTTPStatus` phrases, so both SDKs synthesize the same title.\nconst PHRASES: ReadonlyMap<number, string> = new Map([\n [100, \"Continue\"],\n [101, \"Switching Protocols\"],\n [102, \"Processing\"],\n [103, \"Early Hints\"],\n [200, \"OK\"],\n [201, \"Created\"],\n [202, \"Accepted\"],\n [203, \"Non-Authoritative Information\"],\n [204, \"No Content\"],\n [205, \"Reset Content\"],\n [206, \"Partial Content\"],\n [207, \"Multi-Status\"],\n [208, \"Already Reported\"],\n [226, \"IM Used\"],\n [300, \"Multiple Choices\"],\n [301, \"Moved Permanently\"],\n [302, \"Found\"],\n [303, \"See Other\"],\n [304, \"Not Modified\"],\n [305, \"Use Proxy\"],\n [307, \"Temporary Redirect\"],\n [308, \"Permanent Redirect\"],\n [400, \"Bad Request\"],\n [401, \"Unauthorized\"],\n [402, \"Payment Required\"],\n [403, \"Forbidden\"],\n [404, \"Not Found\"],\n [405, \"Method Not Allowed\"],\n [406, \"Not Acceptable\"],\n [407, \"Proxy Authentication Required\"],\n [408, \"Request Timeout\"],\n [409, \"Conflict\"],\n [410, \"Gone\"],\n [411, \"Length Required\"],\n [412, \"Precondition Failed\"],\n [413, \"Content Too Large\"],\n [414, \"URI Too Long\"],\n [415, \"Unsupported Media Type\"],\n [416, \"Range Not Satisfiable\"],\n [417, \"Expectation Failed\"],\n [418, \"I'm a Teapot\"],\n [421, \"Misdirected Request\"],\n [422, \"Unprocessable Content\"],\n [423, \"Locked\"],\n [424, \"Failed Dependency\"],\n [425, \"Too Early\"],\n [426, \"Upgrade Required\"],\n [428, \"Precondition Required\"],\n [429, \"Too Many Requests\"],\n [431, \"Request Header Fields Too Large\"],\n [451, \"Unavailable For Legal Reasons\"],\n [500, \"Internal Server Error\"],\n [501, \"Not Implemented\"],\n [502, \"Bad Gateway\"],\n [503, \"Service Unavailable\"],\n [504, \"Gateway Timeout\"],\n [505, \"HTTP Version Not Supported\"],\n [506, \"Variant Also Negotiates\"],\n [507, \"Insufficient Storage\"],\n [508, \"Loop Detected\"],\n [510, \"Not Extended\"],\n [511, \"Network Authentication Required\"],\n]);\n\ntype Obj = Record<string, unknown>;\n\nconst isObject = (value: unknown): value is Obj =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nfunction normalizeErrors(items: readonly unknown[]): ProblemDetail[] {\n return items.map((item) => {\n if (isObject(item)) {\n return {\n loc: Array.isArray(item[\"loc\"])\n ? (item[\"loc\"] as (string | number)[])\n : [],\n msg: String(item[\"msg\"] ?? \"\"),\n type: String(item[\"type\"] ?? \"\"),\n };\n }\n return { loc: [], msg: String(item), type: \"\" };\n });\n}\n\n/**\n * Builds the matching `ProblemError` subclass from an error response. A body\n * that is not a JSON object yields a synthesized problem from the status\n * phrase. Reads a clone, so `response.body` stays readable.\n */\nexport async function problemFromResponse(\n response: Response,\n): Promise<ProblemError> {\n const status = response.status;\n const phrase = PHRASES.get(status) ?? \"Error\";\n let parsed: unknown;\n try {\n parsed = JSON.parse(await response.clone().text());\n } catch {\n parsed = undefined;\n }\n const body: Obj = isObject(parsed) ? parsed : {};\n const rawDetail = body[\"detail\"];\n const rawErrors = Array.isArray(rawDetail) ? rawDetail : body[\"errors\"];\n const Cls =\n BY_STATUS.get(status) ?? (status >= 500 ? ServerError : ProblemError);\n const instance = body[\"instance\"];\n return new Cls({\n status,\n title: String(body[\"title\"] || phrase),\n detail: typeof rawDetail === \"string\" ? rawDetail : undefined,\n type: String(body[\"type\"] || NO_TYPE),\n instance: typeof instance === \"string\" ? instance : undefined,\n errors: Array.isArray(rawErrors) ? normalizeErrors(rawErrors) : [],\n headers: response.headers,\n response,\n });\n}\n","/**\n * Typed models of the CRUD manifest (v1) and discovery via the api-catalog.\n * Members keep their wire names (`skip_param`, `max_age`, ...). Members this\n * version does not know are ignored, as the manifest spec requires.\n */\nimport { ManifestError } from \"./errors.ts\";\n\nexport const PROFILE = \"https://craftainer.github.io/schemas/crud-manifest/v1\";\nexport const CATALOG_PATH = \"/.well-known/api-catalog\";\n\n/** A JSON object. */\nexport type JsonObject = Record<string, unknown>;\n\n/** One filterable and sortable field. */\nexport interface FieldSpec {\n readonly name: string;\n readonly value_type: string;\n readonly filter_ops: readonly string[];\n readonly sortable: boolean;\n readonly choices: readonly string[] | null;\n readonly numeric: boolean;\n readonly categorical: boolean;\n readonly read_only: boolean;\n readonly required: boolean;\n}\n\n/** Offset paging parameters and bounds. */\nexport interface Pagination {\n readonly style: string;\n readonly skip_param: string;\n readonly limit_param: string;\n readonly sort_param: string;\n readonly default_limit: number;\n readonly max_limit: number;\n readonly total: boolean;\n}\n\n/** The SSE stream of a resource. */\nexport interface EventsSpec {\n readonly transport: string;\n readonly path: string;\n /** The server-side event label (not the manifest name). */\n readonly resource: string;\n readonly resume_param: string;\n readonly replay: string;\n readonly keepalive_seconds: number;\n readonly actions: readonly string[];\n}\n\n/** What the resource supports. */\nexport interface Capabilities {\n readonly bulk_update: boolean;\n readonly bulk_delete: boolean;\n readonly clone: boolean;\n readonly draft_publish: boolean;\n readonly archive_restore: boolean;\n readonly revisions: boolean;\n readonly events: EventsSpec | null;\n readonly stats: boolean;\n readonly predict: boolean;\n readonly conditional_requests: boolean;\n readonly owner_scoped: boolean;\n readonly schedulable: boolean;\n}\n\n/** Authentication scheme and roles. */\nexport interface AuthSpec {\n readonly scheme: string;\n readonly oidc_discovery_url: string | null;\n readonly public_read: boolean;\n readonly read_roles: readonly string[];\n readonly write_roles: readonly string[];\n readonly delete_roles: readonly string[];\n}\n\n/** The manifest `cache` hints of a resource. */\nexport interface CacheHints {\n readonly etag: boolean;\n readonly max_age: number;\n readonly stats_ttl: number | null;\n readonly stale_while_revalidate: number;\n readonly list_etag: string | null;\n readonly record_etag: string | null;\n readonly revalidate_only: boolean;\n}\n\n/** JSON Schemas of the record views (plain objects). */\nexport interface Schemas {\n readonly read: JsonObject;\n readonly create: JsonObject;\n readonly update: JsonObject;\n readonly draft: JsonObject | null;\n}\n\n/** One resource (`name` + `api_version`). */\nexport interface Resource {\n readonly name: string;\n readonly title: string;\n readonly api_version: string;\n readonly base_path: string;\n readonly formats: Readonly<Record<string, string>>;\n readonly id_field: string;\n readonly schemas: Schemas;\n readonly fields: readonly FieldSpec[];\n readonly pagination: Pagination;\n readonly capabilities: Capabilities;\n readonly paths: Readonly<Record<string, string>>;\n readonly bulk: { readonly max_matched: number };\n readonly auth: AuthSpec;\n readonly cache: CacheHints;\n}\n\n/** The manifest document, as filtered to the caller. */\nexport interface Manifest {\n readonly manifest_version: string;\n readonly service: { readonly name: string; readonly version: string };\n readonly resources: readonly Resource[];\n}\n\nconst isObject = (value: unknown): value is JsonObject =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nfunction bad(where: string, key: string, what: string): never {\n throw new ManifestError(`${where}.${key}: ${what}`);\n}\n\nfunction str(obj: JsonObject, key: string, where: string): string {\n const value = obj[key];\n return typeof value === \"string\"\n ? value\n : bad(where, key, \"missing or not a string\");\n}\n\nfunction bool(obj: JsonObject, key: string, where: string): boolean {\n const value = obj[key];\n return typeof value === \"boolean\"\n ? value\n : bad(where, key, \"missing or not a boolean\");\n}\n\nfunction num(obj: JsonObject, key: string, where: string): number {\n const value = obj[key];\n return typeof value === \"number\" && Number.isFinite(value)\n ? value\n : bad(where, key, \"missing or not a number\");\n}\n\nfunction int(obj: JsonObject, key: string, where: string): number {\n const value = num(obj, key, where);\n return Number.isInteger(value) ? value : bad(where, key, \"not an integer\");\n}\n\nfunction obj(parent: JsonObject, key: string, where: string): JsonObject {\n const value = parent[key];\n return isObject(value) ? value : bad(where, key, \"missing or not an object\");\n}\n\nfunction list(\n parent: JsonObject,\n key: string,\n where: string,\n): readonly unknown[] {\n const value = parent[key];\n return Array.isArray(value)\n ? value\n : bad(where, key, \"missing or not a list\");\n}\n\nfunction strs(\n parent: JsonObject,\n key: string,\n where: string,\n): readonly string[] {\n const items = list(parent, key, where);\n return items.every((item) => typeof item === \"string\")\n ? (items as readonly string[])\n : bad(where, key, \"expected a list of strings\");\n}\n\n/** A member that may be absent or `null`. */\nfunction opt<T>(\n parent: JsonObject,\n key: string,\n where: string,\n read: (parent: JsonObject, key: string, where: string) => T,\n): T | null {\n return parent[key] === undefined || parent[key] === null\n ? null\n : read(parent, key, where);\n}\n\nfunction stringMap(\n parent: JsonObject,\n key: string,\n where: string,\n): Record<string, string> {\n const out: Record<string, string> = {};\n for (const [k, v] of Object.entries(obj(parent, key, where))) {\n if (typeof v === \"string\") {\n out[k] = v;\n }\n }\n return out;\n}\n\nfunction objects(parent: JsonObject, key: string, where: string): JsonObject[] {\n return list(parent, key, where).map((item, i) =>\n isObject(item) ? item : bad(`${where}.${key}`, `[${i}]`, \"not an object\"),\n );\n}\n\nfunction parseField(o: JsonObject, w: string): FieldSpec {\n return {\n name: str(o, \"name\", w),\n value_type: str(o, \"value_type\", w),\n filter_ops: strs(o, \"filter_ops\", w),\n sortable: bool(o, \"sortable\", w),\n choices: opt(o, \"choices\", w, strs),\n numeric: bool(o, \"numeric\", w),\n categorical: bool(o, \"categorical\", w),\n read_only: bool(o, \"read_only\", w),\n required: bool(o, \"required\", w),\n };\n}\n\nfunction parseEvents(o: JsonObject, w: string): EventsSpec {\n return {\n transport: str(o, \"transport\", w),\n path: str(o, \"path\", w),\n resource: str(o, \"resource\", w),\n resume_param: str(o, \"resume_param\", w),\n replay: str(o, \"replay\", w),\n keepalive_seconds: num(o, \"keepalive_seconds\", w),\n actions: strs(o, \"actions\", w),\n };\n}\n\nfunction parseCapabilities(o: JsonObject, w: string): Capabilities {\n return {\n bulk_update: bool(o, \"bulk_update\", w),\n bulk_delete: bool(o, \"bulk_delete\", w),\n clone: bool(o, \"clone\", w),\n draft_publish: bool(o, \"draft_publish\", w),\n archive_restore: bool(o, \"archive_restore\", w),\n revisions: bool(o, \"revisions\", w),\n events: opt(o, \"events\", w, (p, k, ww) =>\n parseEvents(obj(p, k, ww), `${ww}.${k}`),\n ),\n stats: bool(o, \"stats\", w),\n predict: bool(o, \"predict\", w),\n conditional_requests: bool(o, \"conditional_requests\", w),\n owner_scoped: bool(o, \"owner_scoped\", w),\n schedulable: bool(o, \"schedulable\", w),\n };\n}\n\nfunction parseResource(o: JsonObject, w: string): Resource {\n const schemas = obj(o, \"schemas\", w);\n const pagination = obj(o, \"pagination\", w);\n const auth = obj(o, \"auth\", w);\n const cache = obj(o, \"cache\", w);\n const sw = `${w}.schemas`;\n return {\n name: str(o, \"name\", w),\n title: str(o, \"title\", w),\n api_version: str(o, \"api_version\", w),\n base_path: str(o, \"base_path\", w),\n formats: stringMap(o, \"formats\", w),\n id_field: str(o, \"id_field\", w),\n schemas: {\n read: obj(schemas, \"read\", sw),\n create: obj(schemas, \"create\", sw),\n update: obj(schemas, \"update\", sw),\n draft: opt(schemas, \"draft\", sw, obj),\n },\n fields: objects(o, \"fields\", w).map((f, i) =>\n parseField(f, `${w}.fields[${i}]`),\n ),\n pagination: {\n style: str(pagination, \"style\", w),\n skip_param: str(pagination, \"skip_param\", w),\n limit_param: str(pagination, \"limit_param\", w),\n sort_param: str(pagination, \"sort_param\", w),\n default_limit: int(pagination, \"default_limit\", w),\n max_limit: int(pagination, \"max_limit\", w),\n total: bool(pagination, \"total\", w),\n },\n capabilities: parseCapabilities(\n obj(o, \"capabilities\", w),\n `${w}.capabilities`,\n ),\n paths: stringMap(o, \"paths\", w),\n bulk: { max_matched: int(obj(o, \"bulk\", w), \"max_matched\", `${w}.bulk`) },\n auth: {\n scheme: str(auth, \"scheme\", w),\n oidc_discovery_url: opt(auth, \"oidc_discovery_url\", w, str),\n public_read: bool(auth, \"public_read\", w),\n read_roles: strs(auth, \"read_roles\", w),\n write_roles: strs(auth, \"write_roles\", w),\n delete_roles: strs(auth, \"delete_roles\", w),\n },\n cache: {\n etag: bool(cache, \"etag\", w),\n max_age: int(cache, \"max_age\", w),\n stats_ttl: opt(cache, \"stats_ttl\", w, int),\n stale_while_revalidate: int(cache, \"stale_while_revalidate\", w),\n list_etag: opt(cache, \"list_etag\", w, str),\n record_etag: opt(cache, \"record_etag\", w, str),\n revalidate_only: bool(cache, \"revalidate_only\", w),\n },\n };\n}\n\n/** Parses a manifest document; unknown members are ignored, unknown versions refused. */\nexport function parseManifest(document: unknown): Manifest {\n if (!isObject(document)) {\n throw new ManifestError(\"the manifest is not a JSON object\");\n }\n const version = str(document, \"manifest_version\", \"manifest\");\n if (version !== \"1\") {\n throw new ManifestError(`unsupported manifest_version \"${version}\"`);\n }\n const service = obj(document, \"service\", \"manifest\");\n return {\n manifest_version: version,\n service: {\n name: str(service, \"name\", \"manifest.service\"),\n version: str(service, \"version\", \"manifest.service\"),\n },\n resources: objects(document, \"resources\", \"manifest\").map((r, i) =>\n parseResource(r, `resources[${i}]`),\n ),\n };\n}\n\n/**\n * The resource called `name`: the one with `apiVersion` when given, else the\n * highest `api_version` (`v2` beats `v1`); `undefined` when there is none.\n */\nexport function findResource(\n manifest: Manifest,\n name: string,\n apiVersion?: string,\n): Resource | undefined {\n const rank = (r: Resource): number =>\n Number.parseInt(r.api_version.slice(1), 10) || 0;\n let best: Resource | undefined;\n for (const r of manifest.resources) {\n if (\n r.name === name &&\n (apiVersion === undefined || r.api_version === apiVersion)\n ) {\n if (best === undefined || rank(r) > rank(best)) {\n best = r;\n }\n }\n }\n return best;\n}\n\n/** The absolute manifest URL: the first `describedby` link with the manifest profile. */\nexport function manifestUrlFromCatalog(\n linkset: unknown,\n catalogUrl: string,\n): string {\n const entries = isObject(linkset) ? linkset[\"linkset\"] : undefined;\n for (const entry of Array.isArray(entries) ? entries : []) {\n const links = isObject(entry) ? entry[\"describedby\"] : undefined;\n for (const link of Array.isArray(links) ? links : []) {\n if (\n isObject(link) &&\n link[\"profile\"] === PROFILE &&\n typeof link[\"href\"] === \"string\"\n ) {\n const url = new URL(link[\"href\"], catalogUrl);\n if (url.origin !== new URL(catalogUrl).origin) {\n // The client sends its bearer token to this URL: stay on the server's origin.\n throw new ManifestError(\n `the api-catalog points at another origin (${url.origin}); pass manifestUrl to use it`,\n );\n }\n return url.href;\n }\n }\n }\n throw new ManifestError(\n `the api-catalog has no describedby link with profile ${PROFILE}`,\n );\n}\n\n/** Fetches a JSON document; `catalog` marks the api-catalog request (kept out of the manifest cache). */\nexport type GetJson = (url: string, catalog: boolean) => Promise<unknown>;\n\n/**\n * Loads and parses the manifest, via api-catalog discovery from `baseUrl` or\n * a direct `manifestUrl`.\n */\nexport async function loadManifest(\n getJson: GetJson,\n baseUrl: string,\n manifestUrl?: string,\n): Promise<Manifest> {\n let url = manifestUrl;\n if (url === undefined) {\n const catalogUrl = new URL(CATALOG_PATH, baseUrl).href;\n url = manifestUrlFromCatalog(await getJson(catalogUrl, true), catalogUrl);\n }\n return parseManifest(await getJson(url, false));\n}\n","/**\n * Query-string builder with `crud_query` semantics, validated against the\n * manifest fields. Produces the same bytes as the Python SDK.\n */\nimport { InvalidQueryError } from \"./errors.ts\";\nimport type { FieldSpec } from \"./manifest.ts\";\n\nconst MAX_REGEX_LENGTH = 200;\n\n/** The part of a manifest field the builder needs. */\nexport type QueryField = Pick<\n FieldSpec,\n \"name\" | \"value_type\" | \"filter_ops\" | \"sortable\" | \"choices\"\n>;\n\n/** Filter arguments: `field` (equality, emitted bare) or `field__op` -> value. */\nexport type Filters = Readonly<Record<string, unknown>>;\n\n/** `\"name,-other\"` or `[\"name\", \"-other\"]`. */\nexport type Sort = string | readonly string[];\n\n/** Everything {@link buildQuery} takes beside the fields. */\nexport interface QueryParams {\n readonly recordId?: number | undefined;\n readonly filters?: Filters | undefined;\n readonly sort?: Sort | undefined;\n readonly skip?: number | undefined;\n readonly limit?: number | undefined;\n readonly maxLimit?: number | undefined;\n readonly skipParam?: string | undefined;\n readonly limitParam?: string | undefined;\n readonly sortParam?: string | undefined;\n readonly includeArchived?: boolean | undefined;\n readonly includeUnpublished?: boolean | undefined;\n}\n\n/** Percent-encodes everything but the RFC 3986 unreserved characters `A-Za-z0-9-._~`. */\nexport function quote(text: string): string {\n return encodeURIComponent(text).replace(\n /[!'()*]/g,\n (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n}\n\n/** Joins already-stringified pairs, encoding keys and values. */\nexport function encodeParams(\n pairs: readonly (readonly [string, string])[],\n): string {\n return pairs.map(([k, v]) => `${quote(k)}=${quote(v)}`).join(\"&\");\n}\n\nfunction formatDatetime(value: Date): string | undefined {\n if (Number.isNaN(value.getTime())) {\n return undefined;\n }\n const iso = value.toISOString();\n if (iso.length !== 24) {\n return undefined; // expanded years (outside 0000-9999)\n }\n const millis = iso.slice(20, 23).replace(/0+$/, \"\");\n return millis === \"\"\n ? `${iso.slice(0, 19)}Z`\n : `${iso.slice(0, 19)}.${millis}Z`;\n}\n\nfunction formatDate(value: string): string | undefined {\n if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(value)) {\n return undefined;\n }\n const parsed = new Date(`${value}T00:00:00Z`);\n return Number.isNaN(parsed.getTime()) ||\n parsed.toISOString().slice(0, 10) !== value\n ? undefined\n : value;\n}\n\nfunction scalarText(kind: string, value: unknown): string | undefined {\n switch (kind) {\n case \"integer\":\n return typeof value === \"number\" && Number.isSafeInteger(value)\n ? String(value)\n : undefined;\n case \"number\":\n return typeof value === \"number\" && Number.isFinite(value)\n ? String(value)\n : undefined;\n case \"boolean\":\n return typeof value === \"boolean\" ? String(value) : undefined;\n case \"date\":\n return typeof value === \"string\" ? formatDate(value) : undefined;\n case \"datetime\":\n return value instanceof Date ? formatDatetime(value) : undefined;\n default:\n return typeof value === \"string\" ? value : undefined;\n }\n}\n\n/**\n * Wire form of one value for `field`; throws `InvalidQueryError` on a type\n * mismatch. Dates are `YYYY-MM-DD` strings, datetimes `Date`s (UTC, with\n * millisecond precision, trailing zeros trimmed).\n */\nexport function formatScalar(field: QueryField, value: unknown): string {\n const text = scalarText(field.value_type, value);\n if (text === undefined) {\n throw new InvalidQueryError(\n `field \"${field.name}\" (${field.value_type}) cannot take ${String(value)}`,\n );\n }\n if (\n field.value_type === \"enum\" &&\n field.choices !== null &&\n !field.choices.includes(text)\n ) {\n throw new InvalidQueryError(\n `field \"${field.name}\" accepts only ${JSON.stringify(field.choices)}, not \"${text}\"`,\n );\n }\n return text;\n}\n\nfunction filterPair(\n field: QueryField,\n op: string,\n value: unknown,\n): [string, string] {\n const key = op === \"eq\" ? field.name : `${field.name}__${op}`;\n if (op === \"in\") {\n if (!Array.isArray(value) || value.length === 0) {\n throw new InvalidQueryError(`\"${key}\" takes a non-empty array`);\n }\n const parts = value.map((item: unknown) => formatScalar(field, item));\n if (parts.some((part) => part.includes(\",\"))) {\n throw new InvalidQueryError(\n `\"${key}\": a value contains a comma, which separates the list`,\n );\n }\n return [key, parts.map(quote).join(\",\")];\n }\n const text = formatScalar(field, value);\n if (op === \"regex\" && [...text].length > MAX_REGEX_LENGTH) {\n throw new InvalidQueryError(\n `\"${key}\": a regex is limited to ${MAX_REGEX_LENGTH} characters`,\n );\n }\n return [key, quote(text)];\n}\n\nconst compare = (a: string, b: string): number => (a < b ? -1 : a > b ? 1 : 0);\n\nfunction filterPairs(\n fields: ReadonlyMap<string, QueryField>,\n filters: Filters,\n): [string, string][] {\n const parsed = new Map<\n string,\n { name: string; op: string; pair: [string, string] }\n >();\n for (const [rawKey, value] of Object.entries(filters)) {\n const at = rawKey.lastIndexOf(\"__\");\n const name = at < 0 ? rawKey : rawKey.slice(0, at);\n const op = at < 0 ? \"eq\" : rawKey.slice(at + 2);\n const field = fields.get(name);\n if (field === undefined) {\n throw new InvalidQueryError(`unknown filter field \"${name}\"`);\n }\n if (!field.filter_ops.includes(op)) {\n throw new InvalidQueryError(\n `field \"${name}\" does not support the \"${op}\" operator`,\n );\n }\n if (name === \"id\" && op === \"eq\") {\n throw new InvalidQueryError(\n \"filter on id with recordId, not an equality filter\",\n );\n }\n const id = `${name}\\u0000${op}`;\n if (parsed.has(id)) {\n throw new InvalidQueryError(`filter \"${name}\" \"${op}\" given twice`);\n }\n parsed.set(id, { name, op, pair: filterPair(field, op, value) });\n }\n return [...parsed.values()]\n .sort((a, b) => compare(a.name, b.name) || compare(a.op, b.op))\n .map((entry) => entry.pair);\n}\n\nfunction sortValue(\n fields: ReadonlyMap<string, QueryField>,\n sort: Sort,\n): string {\n const parts = typeof sort === \"string\" ? sort.split(\",\") : sort;\n const out = parts.map((part) => {\n const name = part.startsWith(\"-\") ? part.slice(1) : part;\n const field = fields.get(name);\n if (field === undefined || !field.sortable) {\n throw new InvalidQueryError(`cannot sort by \"${name}\"`);\n }\n return quote(part);\n });\n if (out.length === 0) {\n throw new InvalidQueryError(\"sort is empty\");\n }\n return out.join(\",\");\n}\n\nfunction intArg(name: string, value: unknown, minimum: number): string {\n if (\n typeof value !== \"number\" ||\n !Number.isSafeInteger(value) ||\n value < minimum\n ) {\n throw new InvalidQueryError(`${name} must be an integer >= ${minimum}`);\n }\n return String(value);\n}\n\n/**\n * The query string (no leading `?`) for a list, get or bulk call. Order of\n * parameters: `id`, filters sorted by (field, operator), sort, skip, limit,\n * `include_archived`, `include_unpublished`. The sort/skip/limit names are\n * `sortParam`/`skipParam`/`limitParam` (the manifest's `pagination`); the\n * `id` parameter is always `id`. Flags are emitted whenever they are not\n * `undefined`.\n */\nexport function buildQuery(\n fields: readonly QueryField[],\n params: QueryParams = {},\n): string {\n const byName = new Map(fields.map((f) => [f.name, f]));\n const parts: string[] = [];\n if (params.recordId !== undefined) {\n parts.push(`id=${intArg(\"recordId\", params.recordId, 0)}`);\n }\n for (const [key, value] of filterPairs(byName, params.filters ?? {})) {\n parts.push(`${quote(key)}=${value}`); // values arrive encoded; `in` keeps its commas\n }\n if (params.sort !== undefined) {\n parts.push(\n `${quote(params.sortParam ?? \"sort\")}=${sortValue(byName, params.sort)}`,\n );\n }\n if (params.skip !== undefined) {\n parts.push(\n `${quote(params.skipParam ?? \"skip\")}=${intArg(\"skip\", params.skip, 0)}`,\n );\n }\n if (params.limit !== undefined) {\n const text = intArg(\"limit\", params.limit, 1);\n if (params.maxLimit !== undefined && params.limit > params.maxLimit) {\n throw new InvalidQueryError(\n `limit ${params.limit} exceeds the server maximum ${params.maxLimit}`,\n );\n }\n parts.push(`${quote(params.limitParam ?? \"limit\")}=${text}`);\n }\n if (params.includeArchived !== undefined) {\n parts.push(`include_archived=${params.includeArchived}`);\n }\n if (params.includeUnpublished !== undefined) {\n parts.push(`include_unpublished=${params.includeUnpublished}`);\n }\n return parts.join(\"&\");\n}\n","/** Fetch client: manifest-driven resource handles over a middleware chain. */\nimport { cacheScope } from \"./auth.ts\";\nimport {\n CapabilityError,\n ConnectionFailed,\n InvalidQueryError,\n ManifestError,\n ResponseError,\n UnknownResourceError,\n problemFromResponse,\n} from \"./errors.ts\";\nimport { composeMiddleware } from \"./interfaces.ts\";\nimport type { Middleware, Op, TokenProvider } from \"./interfaces.ts\";\nimport { findResource, loadManifest } from \"./manifest.ts\";\nimport type { JsonObject, Manifest, Resource } from \"./manifest.ts\";\nimport { buildQuery, encodeParams } from \"./query.ts\";\nimport type { Filters, QueryParams, Sort } from \"./query.ts\";\n\n/** Per-call options. */\nexport interface RequestOptions {\n readonly signal?: AbortSignal | undefined;\n}\n\n/** Options of `list` and `iterAll`. */\nexport interface ListOptions extends RequestOptions {\n readonly filters?: Filters | undefined;\n readonly sort?: Sort | undefined;\n readonly skip?: number | undefined;\n readonly limit?: number | undefined;\n readonly includeArchived?: boolean | undefined;\n readonly includeUnpublished?: boolean | undefined;\n}\n\n/** Options of `update` and `delete`: `ifMatch` is an ETag (`412` when stale). */\nexport interface WriteOptions extends RequestOptions {\n readonly ifMatch?: string | undefined;\n}\n\n/** Options of `stats`. */\nexport interface StatsOptions extends RequestOptions {\n readonly bucket?: string | undefined;\n readonly includeArchived?: boolean | undefined;\n readonly includeUnpublished?: boolean | undefined;\n}\n\n/** Options of `predict`. */\nexport interface PredictOptions extends RequestOptions {\n readonly field?: string | undefined;\n readonly periods?: number | undefined;\n readonly bucket?: string | undefined;\n}\n\n/** Options of `restore`: exactly one of `id` and `filters`. */\nexport interface RestoreOptions extends RequestOptions {\n readonly id?: number | undefined;\n readonly filters?: Filters | undefined;\n}\n\n/** The result of a bulk call. */\nexport interface BulkResult {\n readonly matched: number;\n readonly ids: readonly number[];\n}\n\nexport interface Call {\n readonly method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n readonly url: string;\n readonly op: Op;\n readonly resource: string | undefined;\n readonly recordId: number | undefined;\n readonly apiVersion: string | null;\n readonly json?: unknown;\n readonly headers?: Readonly<Record<string, string>>;\n}\n\n/** What a {@link ResourceClient} needs from its client. */\nexport interface Transport {\n json(call: Call, signal: AbortSignal | undefined): Promise<unknown>;\n none(call: Call, signal: AbortSignal | undefined): Promise<void>;\n}\n\nconst joinUrl = (base: string, path: string): string =>\n new URL(path, base).href;\n\n/** Builds the requests of one resource. */\nclass Plan {\n readonly #baseUrl: string;\n readonly resource: Resource;\n\n constructor(baseUrl: string, resource: Resource) {\n this.#baseUrl = baseUrl;\n this.resource = resource;\n }\n\n #call(\n method: Call[\"method\"],\n op: Op,\n path: string,\n query = \"\",\n extra: {\n recordId?: number | undefined;\n json?: unknown;\n ifMatch?: string | undefined;\n } = {},\n ): Call {\n const url =\n joinUrl(this.#baseUrl, path) + (query === \"\" ? \"\" : `?${query}`);\n return {\n method,\n url,\n op,\n resource: this.resource.name,\n recordId: extra.recordId,\n apiVersion: this.resource.api_version,\n ...(extra.json === undefined ? {} : { json: extra.json }),\n ...(extra.ifMatch === undefined\n ? {}\n : { headers: { \"If-Match\": extra.ifMatch } }),\n };\n }\n\n #query(params: QueryParams = {}): string {\n const paging = this.resource.pagination;\n return buildQuery(this.resource.fields, {\n maxLimit: paging.max_limit,\n skipParam: paging.skip_param,\n limitParam: paging.limit_param,\n sortParam: paging.sort_param,\n ...params,\n });\n }\n\n #subPath(key: string, supported: boolean): string {\n const path = this.resource.paths[key];\n if (!supported || path === undefined) {\n throw new CapabilityError(\n `resource \"${this.resource.name}\" does not support ${key}`,\n );\n }\n return path;\n }\n\n #need(supported: boolean, what: string): void {\n if (!supported) {\n throw new CapabilityError(\n `resource \"${this.resource.name}\" does not support ${what}`,\n );\n }\n }\n\n #bulkFilters(filters: Filters): string {\n if (Object.keys(filters).length === 0) {\n throw new InvalidQueryError(\"a bulk operation needs at least one filter\");\n }\n return this.#query({ filters });\n }\n\n get #base(): string {\n return this.resource.base_path;\n }\n\n eventsUrl(): string {\n const events = this.resource.capabilities.events;\n if (events === null) {\n throw new CapabilityError(\n `resource \"${this.resource.name}\" does not support events`,\n );\n }\n return joinUrl(this.#baseUrl, events.path);\n }\n\n list(o: ListOptions): Call {\n const query = this.#query({\n filters: o.filters,\n sort: o.sort,\n skip: o.skip,\n limit: o.limit,\n includeArchived: o.includeArchived,\n includeUnpublished: o.includeUnpublished,\n });\n return this.#call(\"GET\", \"list\", this.#base, query);\n }\n\n get(id: number): Call {\n return this.#call(\n \"GET\",\n \"record\",\n this.#base,\n this.#query({ recordId: id }),\n {\n recordId: id,\n },\n );\n }\n\n create(data: unknown): Call {\n return this.#call(\"POST\", \"create\", this.#base, \"\", { json: data });\n }\n\n update(id: number, data: unknown, ifMatch: string | undefined): Call {\n return this.#call(\n \"PATCH\",\n \"update\",\n this.#base,\n this.#query({ recordId: id }),\n {\n recordId: id,\n json: data,\n ifMatch,\n },\n );\n }\n\n updateMany(filters: Filters, data: unknown): Call {\n this.#need(this.resource.capabilities.bulk_update, \"bulk_update\");\n return this.#call(\n \"PATCH\",\n \"bulk_update\",\n this.#base,\n this.#bulkFilters(filters),\n {\n json: data,\n },\n );\n }\n\n delete(id: number, ifMatch: string | undefined): Call {\n return this.#call(\n \"DELETE\",\n \"delete\",\n this.#base,\n this.#query({ recordId: id }),\n {\n recordId: id,\n ifMatch,\n },\n );\n }\n\n deleteMany(filters: Filters): Call {\n this.#need(this.resource.capabilities.bulk_delete, \"bulk_delete\");\n return this.#call(\n \"DELETE\",\n \"bulk_delete\",\n this.#base,\n this.#bulkFilters(filters),\n );\n }\n\n restore(id: number | undefined, filters: Filters | undefined): Call {\n const path = this.#subPath(\n \"restore\",\n this.resource.capabilities.archive_restore,\n );\n if ((id === undefined) === (filters === undefined)) {\n throw new InvalidQueryError(\n \"restore takes exactly one of id and filters\",\n );\n }\n const query =\n filters === undefined\n ? this.#query({ recordId: id })\n : this.#bulkFilters(filters);\n return this.#call(\"POST\", \"restore\", path, query, { recordId: id });\n }\n\n stats(o: StatsOptions): Call {\n const path = this.#subPath(\"stats\", this.resource.capabilities.stats);\n const pairs: [string, string][] =\n o.bucket === undefined ? [] : [[\"bucket\", o.bucket]];\n if (o.includeArchived !== undefined) {\n pairs.push([\"include_archived\", String(o.includeArchived)]);\n }\n if (o.includeUnpublished !== undefined) {\n pairs.push([\"include_unpublished\", String(o.includeUnpublished)]);\n }\n return this.#call(\"GET\", \"stats\", path, encodeParams(pairs));\n }\n\n predict(o: PredictOptions): Call {\n const path = this.#subPath(\"predict\", this.resource.capabilities.predict);\n const pairs: [string, string][] = [];\n if (o.field !== undefined) {\n const spec = this.resource.fields.find((f) => f.name === o.field);\n if (spec === undefined || !spec.numeric) {\n throw new InvalidQueryError(\n `cannot predict \"${o.field}\": not a numeric field`,\n );\n }\n pairs.push([\"field\", o.field]);\n }\n if (o.periods !== undefined) {\n if (!Number.isSafeInteger(o.periods) || o.periods < 1) {\n throw new InvalidQueryError(\"periods must be an integer >= 1\");\n }\n pairs.push([\"periods\", String(o.periods)]);\n }\n if (o.bucket !== undefined) {\n pairs.push([\"bucket\", o.bucket]);\n }\n return this.#call(\"GET\", \"predict\", path, encodeParams(pairs));\n }\n\n clone(id: number): Call {\n const path = this.#subPath(\"clone\", this.resource.capabilities.clone);\n return this.#call(\"POST\", \"clone\", path, this.#query({ recordId: id }), {\n recordId: id,\n });\n }\n\n draft(data: unknown): Call {\n const path = this.#subPath(\n \"draft\",\n this.resource.capabilities.draft_publish,\n );\n return this.#call(\"POST\", \"draft\", path, \"\", { json: data });\n }\n\n publish(id: number): Call {\n const path = this.#subPath(\n \"publish\",\n this.resource.capabilities.draft_publish,\n );\n return this.#call(\"POST\", \"publish\", path, this.#query({ recordId: id }), {\n recordId: id,\n });\n }\n\n filters(): Call {\n return this.#call(\"GET\", \"filters\", this.#subPath(\"filters\", true));\n }\n\n revisions(id: number): Call {\n const path = this.#subPath(\n \"revisions\",\n this.resource.capabilities.revisions,\n );\n return this.#call(\"GET\", \"revisions\", path, this.#query({ recordId: id }), {\n recordId: id,\n });\n }\n}\n\n/**\n * Operations on one resource. The type parameters are the record views;\n * `crud-sdk-codegen` writes interfaces to pass for them (they are not\n * checked against the manifest at runtime).\n */\nexport class ResourceClient<\n Read extends object = JsonObject,\n Create extends object = JsonObject,\n Update extends object = JsonObject,\n> {\n /** The manifest entry this handle is bound to. */\n readonly resource: Resource;\n readonly #plan: Plan;\n readonly #transport: Transport;\n\n /** Use `CrudClient.resource`. */\n constructor(baseUrl: string, resource: Resource, transport: Transport) {\n this.resource = resource;\n this.#plan = new Plan(baseUrl, resource);\n this.#transport = transport;\n }\n\n async #one<T>(call: Call, options: RequestOptions): Promise<T> {\n return (await this.#transport.json(call, options.signal)) as T;\n }\n\n /** One page of records. */\n async list(options: ListOptions = {}): Promise<Read[]> {\n return this.#one(this.#plan.list(options), options);\n }\n\n /** Every record, paging with `skip += limit` until a page shorter than `limit`. */\n async *iterAll(\n options: ListOptions = {},\n ): AsyncGenerator<Read, void, undefined> {\n const size = options.limit ?? this.resource.pagination.default_limit;\n let skip = options.skip ?? 0;\n for (;;) {\n const page = await this.list({ ...options, skip, limit: size });\n yield* page;\n if (page.length < size) {\n return;\n }\n skip += size;\n }\n }\n\n /** One record. */\n async get(id: number, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.get(id), options);\n }\n\n /** Creates a record. */\n async create(data: Create, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.create(data), options);\n }\n\n /** Patches one record; `ifMatch` is an ETag (`412` when stale). */\n async update(\n id: number,\n data: Update,\n options: WriteOptions = {},\n ): Promise<Read> {\n return this.#one(this.#plan.update(id, data, options.ifMatch), options);\n }\n\n /** Patches every record matching `filters`. */\n async updateMany(\n filters: Filters,\n data: Update,\n options: RequestOptions = {},\n ): Promise<BulkResult> {\n return this.#one(this.#plan.updateMany(filters, data), options);\n }\n\n /** Deletes one record; `ifMatch` as for `update`. */\n async delete(id: number, options: WriteOptions = {}): Promise<void> {\n await this.#transport.none(\n this.#plan.delete(id, options.ifMatch),\n options.signal,\n );\n }\n\n /** Deletes every record matching `filters`. */\n async deleteMany(\n filters: Filters,\n options: RequestOptions = {},\n ): Promise<BulkResult> {\n return this.#one(this.#plan.deleteMany(filters), options);\n }\n\n /** Restores archived records, by `id` or by `filters`. */\n async restore(options: RestoreOptions): Promise<BulkResult> {\n return this.#one(this.#plan.restore(options.id, options.filters), options);\n }\n\n /** Aggregates over the resource. */\n async stats(options: StatsOptions = {}): Promise<JsonObject> {\n return this.#one(this.#plan.stats(options), options);\n }\n\n /** A forecast. */\n async predict(options: PredictOptions = {}): Promise<JsonObject> {\n return this.#one(this.#plan.predict(options), options);\n }\n\n /** Copies a record; returns the copy. */\n async clone(id: number, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.clone(id), options);\n }\n\n /** Creates a draft (needs `draft_publish`). */\n async createDraft(data: Create, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.draft(data), options);\n }\n\n /** Publishes a draft (needs `draft_publish`). */\n async publish(id: number, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.publish(id), options);\n }\n\n /** The server's filter metadata (`kind` instead of `value_type`). */\n async filters(options: RequestOptions = {}): Promise<JsonObject[]> {\n return this.#one(this.#plan.filters(), options);\n }\n\n /** Revisions of one record, newest first. */\n async revisions(\n id: number,\n options: RequestOptions = {},\n ): Promise<JsonObject[]> {\n return this.#one(this.#plan.revisions(id), options);\n }\n\n /** Absolute URL of the resource's SSE stream. */\n eventsUrl(): string {\n return this.#plan.eventsUrl();\n }\n}\n\n/** Options of {@link createClient}. */\nexport interface ClientOptions {\n /** The server origin (or any URL on it). */\n readonly baseUrl: string;\n /** The network `fetch`; defaults to `globalThis.fetch`. */\n readonly fetch?: typeof fetch | undefined;\n /** Returns the bearer token; called again with `refresh: true` once after a `401`. */\n readonly tokenProvider?: TokenProvider | undefined;\n /** Outermost first; see `composeMiddleware`. */\n readonly middleware?: readonly Middleware[] | undefined;\n /** Skips api-catalog discovery. */\n readonly manifestUrl?: string | undefined;\n}\n\n/** Discovers the manifest and hands out {@link ResourceClient}s. */\nexport class CrudClient {\n readonly baseUrl: string;\n readonly #fetch: typeof fetch | undefined;\n readonly #tokenProvider: TokenProvider | undefined;\n readonly #middleware: Middleware[];\n readonly #manifestUrl: string | undefined;\n readonly #manifests = new Map<string, Promise<Manifest>>();\n readonly #transport: Transport;\n\n constructor(options: ClientOptions) {\n this.baseUrl = options.baseUrl;\n this.#fetch = options.fetch;\n this.#tokenProvider = options.tokenProvider;\n this.#middleware = [...(options.middleware ?? [])];\n this.#manifestUrl = options.manifestUrl;\n this.#transport = {\n json: async (call, signal) => {\n const response = await this.#send(call, signal);\n if (response.status === 204) {\n return undefined;\n }\n try {\n return (await response.json()) as unknown;\n } catch (error) {\n throw new ResponseError(\n `${call.method} ${call.url}: the ${response.status} response body is not valid JSON`,\n { cause: error },\n );\n }\n },\n none: async (call, signal) => {\n await (await this.#send(call, signal)).body?.cancel();\n },\n };\n }\n\n /** Adds middleware after the existing ones (innermost); it sees every later request. */\n use(middleware: Middleware): this {\n this.#middleware.push(middleware);\n return this;\n }\n\n async #token(refresh: boolean): Promise<string | null> {\n // An empty token sends no header, so it is anonymous for the scope too.\n return (await this.#tokenProvider?.({ refresh })) || null;\n }\n\n /** The current bearer token, or `null` when anonymous. */\n token(refresh = false): Promise<string | null> {\n return this.#token(refresh);\n }\n\n /** The cache scope of the current caller (`\"anon\"` or a hash of the token). */\n async scope(): Promise<string> {\n return cacheScope(await this.#token(false));\n }\n\n async #dispatch(\n call: Call,\n token: string | null,\n signal: AbortSignal | undefined,\n ): Promise<Response> {\n const headers = new Headers({\n Accept: \"application/json\",\n ...call.headers,\n });\n if (token !== null) {\n headers.set(\"Authorization\", `Bearer ${token}`);\n }\n const init: RequestInit = {\n method: call.method,\n headers,\n signal: signal ?? null,\n };\n if (call.json !== undefined) {\n headers.set(\"Content-Type\", \"application/json\");\n init.body = JSON.stringify(call.json);\n }\n const request = new Request(call.url, init);\n const terminal = async (ctx: {\n readonly request: Request;\n }): Promise<Response> => {\n try {\n return await (this.#fetch ?? globalThis.fetch)(ctx.request);\n } catch (error) {\n if (ctx.request.signal.aborted) {\n throw error;\n }\n throw new ConnectionFailed(\n error instanceof Error ? error.message : String(error),\n {\n cause: error,\n },\n );\n }\n };\n return composeMiddleware(\n this.#middleware,\n terminal,\n )({\n request,\n resource: call.resource,\n op: call.op,\n recordId: call.recordId,\n scope: await cacheScope(token),\n apiVersion: call.apiVersion,\n signal,\n });\n }\n\n /** Sends `call`, retrying once with a refreshed token after a `401`; throws on `>= 400`. */\n async #send(call: Call, signal: AbortSignal | undefined): Promise<Response> {\n const token = await this.#token(false);\n let response = await this.#dispatch(call, token, signal);\n if (response.status === 401 && this.#tokenProvider !== undefined) {\n const fresh = await this.#token(true);\n if (fresh !== null && fresh !== token) {\n await response.body?.cancel();\n response = await this.#dispatch(call, fresh, signal);\n }\n }\n if (response.status >= 400) {\n throw await problemFromResponse(response);\n }\n return response;\n }\n\n async #getJson(url: string, catalog: boolean): Promise<unknown> {\n const call: Call = {\n method: \"GET\",\n url,\n op: \"manifest\",\n resource: undefined,\n recordId: undefined,\n apiVersion: null,\n // The catalog shares the \"manifest\" op; no-store keeps it out of the manifest cache entry.\n ...(catalog ? { headers: { \"Cache-Control\": \"no-store\" } } : {}),\n };\n const response = await this.#send(call, undefined);\n try {\n return (await response.json()) as unknown;\n } catch (error) {\n throw new ManifestError(`${url} is not JSON`, { cause: error });\n }\n }\n\n /** The manifest for this caller, loaded once per caller scope (`refresh: true` reloads). */\n async manifest(\n options: { readonly refresh?: boolean } = {},\n ): Promise<Manifest> {\n const scope = await this.scope(); // the manifest is filtered per caller\n let loading = this.#manifests.get(scope);\n if (loading === undefined || options.refresh === true) {\n const started = loadManifest(\n (url, catalog) => this.#getJson(url, catalog),\n this.baseUrl,\n this.#manifestUrl,\n );\n loading = started;\n if (!this.#manifests.has(scope)) {\n this.#manifests.clear(); // rotated tokens must not pile up manifests\n }\n this.#manifests.set(scope, started);\n started.catch(() => {\n if (this.#manifests.get(scope) === started) {\n this.#manifests.delete(scope);\n }\n });\n }\n return loading;\n }\n\n /** A handle for `name` (the highest `api_version` unless given). */\n async resource<\n Read extends object = JsonObject,\n Create extends object = JsonObject,\n Update extends object = JsonObject,\n >(\n name: string,\n apiVersion?: string,\n ): Promise<ResourceClient<Read, Create, Update>> {\n const resource = findResource(await this.manifest(), name, apiVersion);\n if (resource === undefined) {\n throw new UnknownResourceError(\n `the manifest has no resource \"${name}\"${apiVersion === undefined ? \"\" : ` ${apiVersion}`} for this caller`,\n );\n }\n return new ResourceClient<Read, Create, Update>(\n this.baseUrl,\n resource,\n this.#transport,\n );\n }\n}\n\n/** Creates a client; the manifest loads on first use. */\nexport function createClient(options: ClientOptions): CrudClient {\n return new CrudClient(options);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"client-Bv0yCuwC.mjs","names":["isObject"],"sources":["../src/interfaces.ts","../src/errors.ts","../src/manifest.ts","../src/query.ts","../src/client.ts"],"sourcesContent":["/**\n * Contracts shared by the client core (TS1) and the cache layer (TS2).\n * Fixed in TS0 (plan interface I3): change them only through the plan.\n */\n\n/** A value or a promise of it. */\nexport type MaybePromise<T> = T | Promise<T>;\n\n/** What a request does, as classified by the client. */\nexport type Op =\n | \"manifest\"\n | \"list\"\n | \"record\"\n | \"filters\"\n | \"stats\"\n | \"predict\"\n | \"revisions\"\n | \"create\"\n | \"update\"\n | \"delete\"\n | \"bulk_update\"\n | \"bulk_delete\"\n | \"clone\"\n | \"draft\"\n | \"publish\"\n | \"restore\"\n | \"events\";\n\n/**\n * One stored `200` response. Times are epoch milliseconds (`Date.now()`).\n * Structured-clone safe, so IndexedDB can store it as is.\n */\nexport interface CacheEntry {\n readonly status: number;\n readonly headers: ReadonlyArray<readonly [string, string]>;\n /** JSON text; the SDK only caches JSON. */\n readonly body: string;\n readonly storedAt: number;\n /** `<= storedAt` means \"always revalidate\". */\n readonly freshUntil: number;\n /** End of the stale-while-revalidate window (`>= freshUntil`). */\n readonly staleUntil: number;\n readonly etag?: string;\n}\n\n/**\n * Cache backend. Keys are opaque, slash-separated strings built by\n * `./cache`'s `cacheKey`\n * (`v1/{resource}/{kind}/{subject}/{apiVersion}/{scope}/{query}`, with `_`\n * when there is no apiVersion).\n * `ttlMs` is how long the backend may keep the entry (undefined = backend\n * default); freshness lives in `CacheEntry`. `clear(prefix)` removes every\n * key starting with `prefix`; `clear()` removes everything the store owns.\n * Methods may be sync or async. They must not reject for a missing key\n * (`get` resolves `undefined`), and a failing backend must not fail the\n * request: the cache layer swallows store errors and treats them as a miss.\n */\nexport interface CacheStore {\n get(key: string): MaybePromise<CacheEntry | undefined>;\n set(key: string, entry: CacheEntry, ttlMs?: number): MaybePromise<void>;\n delete(key: string): MaybePromise<void>;\n clear(prefix?: string): MaybePromise<void>;\n}\n\n/**\n * What the client knows about a request that a bare `Request` does not. The\n * client builds it for every call; middleware read it, so they never parse\n * URLs or read Authorization.\n */\nexport interface RequestContext {\n /** The request about to be sent; replace it by passing a new context to `next`. */\n readonly request: Request;\n /** Manifest name; `undefined` for the manifest document itself. */\n readonly resource: string | undefined;\n readonly op: Op;\n /** The record the request targets, when it targets one. */\n readonly recordId: number | undefined;\n /**\n * \"anon\", or the first 32 hex characters of the SHA-256 of the\n * Authorization credential actually sent.\n */\n readonly scope: string;\n /**\n * The resource's `api_version` from the manifest, or `null` when it has\n * none. Part of the cache key, so versions never share entries (the cache\n * layer renders `null` as `_`).\n */\n readonly apiVersion: string | null;\n readonly signal: AbortSignal | undefined;\n}\n\n/** Calls the next middleware, or the network when none is left. */\nexport type Next = (ctx: RequestContext) => Promise<Response>;\n\n/**\n * Onion middleware. In `chain = [a, b]`, `a` is outermost: the request runs\n * a -> b -> fetch and the response returns fetch -> b -> a. A middleware may\n * replace `ctx.request` (pass `{ ...ctx, request }` to `next`), return\n * without calling `next` (short-circuit, e.g. a fresh cache hit), or replace\n * the response (e.g. a `304` rebuilt from the cache). It must not consume\n * `response.body` unless it returns a different `Response`; use\n * `response.clone()` to read it.\n */\nexport type Middleware = (ctx: RequestContext, next: Next) => Promise<Response>;\n\n/**\n * Returns the bearer token, or `null`/`undefined` for an anonymous call.\n * `refresh: true` is passed once after a `401`, to force a new token.\n */\nexport type TokenProvider = (opts: {\n readonly refresh: boolean;\n}) => MaybePromise<string | null | undefined>;\n\n/** One record-mutation event from `GET {basePath}/events` (the server's event envelope). */\nexport interface CrudEvent {\n /** The server's event label (e.g. \"hero\"), not the manifest name. */\n readonly resource: string;\n readonly recordId: number;\n readonly action: \"create\" | \"update\" | \"delete\" | \"restore\";\n /** The read view of the record after the change. */\n readonly snapshot: Readonly<Record<string, unknown>>;\n /** ISO 8601, UTC. */\n readonly timestamp: string;\n}\n\n/**\n * Folds `chain` (outermost first) around `terminal`, usually the network\n * `fetch`, into one `Next`. Each middleware's `next` is the rest of the\n * chain; an empty chain is `terminal`. A throwing middleware yields a\n * rejected promise.\n */\nexport function composeMiddleware(\n chain: readonly Middleware[],\n terminal: Next,\n): Next {\n const dispatch = async (\n index: number,\n ctx: RequestContext,\n ): Promise<Response> => {\n const middleware = chain[index];\n if (middleware === undefined) {\n return terminal(ctx);\n }\n return middleware(ctx, (next) => dispatch(index + 1, next));\n };\n return (ctx) => dispatch(0, ctx);\n}\n","/**\n * Error hierarchy: client-side errors and RFC 9457 problem details (ADR-0004).\n * Mirrors the Python SDK class for class.\n */\n\n/** Base class of every error this package throws on purpose. */\nexport class CrudError extends Error {\n constructor(message: string, options?: ErrorOptions) {\n super(message, options);\n this.name = new.target.name;\n }\n}\n\n/** The call was refused before any request was sent. */\nexport class ClientError extends CrudError {}\n\n/** The resource does not support the operation (manifest capability or path missing). */\nexport class CapabilityError extends ClientError {}\n\n/** A filter, sort or paging argument is not valid for the resource. */\nexport class InvalidQueryError extends ClientError {}\n\n/** The discovery document or the manifest is missing, unusable or of an unknown version. */\nexport class ManifestError extends ClientError {}\n\n/** The manifest lists no such resource for this caller. */\nexport class UnknownResourceError extends ClientError {}\n\n/** A successful response whose body is not the JSON the client expects; `cause` holds the parse error. */\nexport class ResponseError extends CrudError {}\n\n/** The request never produced a response; `cause` holds the transport error. */\nexport class ConnectionFailed extends CrudError {}\n\n/** One normalized validation error (`422`). */\nexport interface ProblemDetail {\n readonly loc: readonly (string | number)[];\n readonly msg: string;\n readonly type: string;\n}\n\n/** Members of a {@link ProblemError}. */\nexport interface ProblemInit {\n readonly status: number;\n readonly title: string;\n readonly detail?: string | undefined;\n readonly type?: string | undefined;\n readonly instance?: string | undefined;\n readonly errors?: readonly ProblemDetail[] | undefined;\n readonly headers?: Headers | undefined;\n readonly response?: Response | undefined;\n}\n\nconst NO_TYPE = \"about:blank\";\n\n/** An error response, as RFC 9457 problem details. */\nexport class ProblemError extends CrudError {\n readonly status: number;\n readonly title: string;\n readonly detail: string | undefined;\n readonly type: string;\n readonly instance: string | undefined;\n readonly errors: readonly ProblemDetail[];\n readonly headers: Headers;\n readonly response: Response | undefined;\n\n constructor(init: ProblemInit) {\n const errors = init.errors ?? [];\n let message = `${init.status} ${init.title}`;\n if (init.detail) {\n message += `: ${init.detail}`;\n } else if (errors.length > 0) {\n message += `: ${errors.map((e) => `${e.loc.join(\".\")}: ${e.msg}`).join(\"; \")}`;\n }\n super(message);\n this.status = init.status;\n this.title = init.title;\n this.detail = init.detail;\n this.type = init.type ?? NO_TYPE;\n this.instance = init.instance;\n this.errors = errors;\n this.headers = init.headers ?? new Headers();\n this.response = init.response;\n }\n}\n\n/** 400. */\nexport class BadRequest extends ProblemError {}\n\n/** 401; `wwwAuthenticate` keeps the challenge. */\nexport class Unauthorized extends ProblemError {\n get wwwAuthenticate(): string | undefined {\n return this.headers.get(\"www-authenticate\") ?? undefined;\n }\n}\n\n/** 403. */\nexport class Forbidden extends ProblemError {}\n\n/** 404. */\nexport class NotFound extends ProblemError {}\n\n/** 412: a stale `If-Match`. */\nexport class PreconditionFailed extends ProblemError {}\n\n/** 422; `errors` holds normalized `{loc, msg, type}` entries. */\nexport class ValidationFailed extends ProblemError {}\n\n/** 423. */\nexport class Locked extends ProblemError {}\n\n/** 429; `retryAfter` is the `Retry-After` header in seconds, when it is a number. */\nexport class RateLimited extends ProblemError {\n get retryAfter(): number | undefined {\n const raw = this.headers.get(\"retry-after\");\n if (raw === null || raw.trim() === \"\") {\n return undefined;\n }\n const seconds = Number(raw);\n return Number.isNaN(seconds) ? undefined : seconds;\n }\n}\n\n/** 5xx. */\nexport class ServerError extends ProblemError {}\n\nconst BY_STATUS: ReadonlyMap<number, typeof ProblemError> = new Map([\n [400, BadRequest],\n [401, Unauthorized],\n [403, Forbidden],\n [404, NotFound],\n [412, PreconditionFailed],\n [422, ValidationFailed],\n [423, Locked],\n [429, RateLimited],\n]);\n\n// Python's `http.HTTPStatus` phrases, so both SDKs synthesize the same title.\nconst PHRASES: ReadonlyMap<number, string> = new Map([\n [100, \"Continue\"],\n [101, \"Switching Protocols\"],\n [102, \"Processing\"],\n [103, \"Early Hints\"],\n [200, \"OK\"],\n [201, \"Created\"],\n [202, \"Accepted\"],\n [203, \"Non-Authoritative Information\"],\n [204, \"No Content\"],\n [205, \"Reset Content\"],\n [206, \"Partial Content\"],\n [207, \"Multi-Status\"],\n [208, \"Already Reported\"],\n [226, \"IM Used\"],\n [300, \"Multiple Choices\"],\n [301, \"Moved Permanently\"],\n [302, \"Found\"],\n [303, \"See Other\"],\n [304, \"Not Modified\"],\n [305, \"Use Proxy\"],\n [307, \"Temporary Redirect\"],\n [308, \"Permanent Redirect\"],\n [400, \"Bad Request\"],\n [401, \"Unauthorized\"],\n [402, \"Payment Required\"],\n [403, \"Forbidden\"],\n [404, \"Not Found\"],\n [405, \"Method Not Allowed\"],\n [406, \"Not Acceptable\"],\n [407, \"Proxy Authentication Required\"],\n [408, \"Request Timeout\"],\n [409, \"Conflict\"],\n [410, \"Gone\"],\n [411, \"Length Required\"],\n [412, \"Precondition Failed\"],\n [413, \"Content Too Large\"],\n [414, \"URI Too Long\"],\n [415, \"Unsupported Media Type\"],\n [416, \"Range Not Satisfiable\"],\n [417, \"Expectation Failed\"],\n [418, \"I'm a Teapot\"],\n [421, \"Misdirected Request\"],\n [422, \"Unprocessable Content\"],\n [423, \"Locked\"],\n [424, \"Failed Dependency\"],\n [425, \"Too Early\"],\n [426, \"Upgrade Required\"],\n [428, \"Precondition Required\"],\n [429, \"Too Many Requests\"],\n [431, \"Request Header Fields Too Large\"],\n [451, \"Unavailable For Legal Reasons\"],\n [500, \"Internal Server Error\"],\n [501, \"Not Implemented\"],\n [502, \"Bad Gateway\"],\n [503, \"Service Unavailable\"],\n [504, \"Gateway Timeout\"],\n [505, \"HTTP Version Not Supported\"],\n [506, \"Variant Also Negotiates\"],\n [507, \"Insufficient Storage\"],\n [508, \"Loop Detected\"],\n [510, \"Not Extended\"],\n [511, \"Network Authentication Required\"],\n]);\n\ntype Obj = Record<string, unknown>;\n\nconst isObject = (value: unknown): value is Obj =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nfunction normalizeErrors(items: readonly unknown[]): ProblemDetail[] {\n return items.map((item) => {\n if (isObject(item)) {\n return {\n loc: Array.isArray(item[\"loc\"])\n ? (item[\"loc\"] as (string | number)[])\n : [],\n msg: String(item[\"msg\"] ?? \"\"),\n type: String(item[\"type\"] ?? \"\"),\n };\n }\n return { loc: [], msg: String(item), type: \"\" };\n });\n}\n\n/**\n * Builds the matching `ProblemError` subclass from an error response. A body\n * that is not a JSON object yields a synthesized problem from the status\n * phrase. Reads a clone, so `response.body` stays readable.\n */\nexport async function problemFromResponse(\n response: Response,\n): Promise<ProblemError> {\n const status = response.status;\n const phrase = PHRASES.get(status) ?? \"Error\";\n let parsed: unknown;\n try {\n parsed = JSON.parse(await response.clone().text());\n } catch {\n parsed = undefined;\n }\n const body: Obj = isObject(parsed) ? parsed : {};\n const rawDetail = body[\"detail\"];\n const rawErrors = Array.isArray(rawDetail) ? rawDetail : body[\"errors\"];\n const Cls =\n BY_STATUS.get(status) ?? (status >= 500 ? ServerError : ProblemError);\n const instance = body[\"instance\"];\n return new Cls({\n status,\n title: String(body[\"title\"] || phrase),\n detail: typeof rawDetail === \"string\" ? rawDetail : undefined,\n type: String(body[\"type\"] || NO_TYPE),\n instance: typeof instance === \"string\" ? instance : undefined,\n errors: Array.isArray(rawErrors) ? normalizeErrors(rawErrors) : [],\n headers: response.headers,\n response,\n });\n}\n","/**\n * Typed models of the CRUD manifest (v1) and discovery via the api-catalog.\n * Members keep their wire names (`skip_param`, `max_age`, ...). Members this\n * version does not know are ignored, as the manifest spec requires.\n */\nimport { ManifestError } from \"./errors.ts\";\n\nexport const PROFILE = \"https://craftainer.github.io/schemas/crud-manifest/v1\";\nexport const CATALOG_PATH = \"/.well-known/api-catalog\";\n\n/** A JSON object. */\nexport type JsonObject = Record<string, unknown>;\n\n/** One filterable and sortable field. */\nexport interface FieldSpec {\n readonly name: string;\n readonly value_type: string;\n readonly filter_ops: readonly string[];\n readonly sortable: boolean;\n readonly choices: readonly string[] | null;\n readonly numeric: boolean;\n readonly categorical: boolean;\n readonly read_only: boolean;\n readonly required: boolean;\n}\n\n/** Offset paging parameters and bounds. */\nexport interface Pagination {\n readonly style: string;\n readonly skip_param: string;\n readonly limit_param: string;\n readonly sort_param: string;\n readonly default_limit: number;\n readonly max_limit: number;\n readonly total: boolean;\n}\n\n/** The SSE stream of a resource. */\nexport interface EventsSpec {\n readonly transport: string;\n readonly path: string;\n /** The server-side event label (not the manifest name). */\n readonly resource: string;\n readonly resume_param: string;\n readonly replay: string;\n readonly keepalive_seconds: number;\n readonly actions: readonly string[];\n}\n\n/** What the resource supports. */\nexport interface Capabilities {\n readonly bulk_update: boolean;\n readonly bulk_delete: boolean;\n readonly clone: boolean;\n readonly draft_publish: boolean;\n readonly archive_restore: boolean;\n readonly revisions: boolean;\n readonly events: EventsSpec | null;\n readonly stats: boolean;\n readonly predict: boolean;\n readonly conditional_requests: boolean;\n readonly owner_scoped: boolean;\n readonly schedulable: boolean;\n}\n\n/** Authentication scheme and roles. */\nexport interface AuthSpec {\n readonly scheme: string;\n readonly oidc_discovery_url: string | null;\n readonly public_read: boolean;\n readonly read_roles: readonly string[];\n readonly write_roles: readonly string[];\n readonly delete_roles: readonly string[];\n}\n\n/** The manifest `cache` hints of a resource. */\nexport interface CacheHints {\n readonly etag: boolean;\n readonly max_age: number;\n readonly stats_ttl: number | null;\n readonly stale_while_revalidate: number;\n readonly list_etag: string | null;\n readonly record_etag: string | null;\n readonly revalidate_only: boolean;\n}\n\n/** JSON Schemas of the record views (plain objects). */\nexport interface Schemas {\n readonly read: JsonObject;\n readonly create: JsonObject;\n readonly update: JsonObject;\n readonly draft: JsonObject | null;\n}\n\n/** One resource (`name` + `api_version`). */\nexport interface Resource {\n readonly name: string;\n readonly title: string;\n readonly api_version: string;\n readonly base_path: string;\n readonly formats: Readonly<Record<string, string>>;\n readonly id_field: string;\n readonly schemas: Schemas;\n readonly fields: readonly FieldSpec[];\n readonly pagination: Pagination;\n readonly capabilities: Capabilities;\n readonly paths: Readonly<Record<string, string>>;\n readonly bulk: { readonly max_matched: number };\n readonly auth: AuthSpec;\n readonly cache: CacheHints;\n}\n\n/** The manifest document, as filtered to the caller. */\nexport interface Manifest {\n readonly manifest_version: string;\n readonly service: { readonly name: string; readonly version: string };\n readonly resources: readonly Resource[];\n}\n\nconst isObject = (value: unknown): value is JsonObject =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nfunction bad(where: string, key: string, what: string): never {\n throw new ManifestError(`${where}.${key}: ${what}`);\n}\n\nfunction str(obj: JsonObject, key: string, where: string): string {\n const value = obj[key];\n return typeof value === \"string\"\n ? value\n : bad(where, key, \"missing or not a string\");\n}\n\nfunction bool(obj: JsonObject, key: string, where: string): boolean {\n const value = obj[key];\n return typeof value === \"boolean\"\n ? value\n : bad(where, key, \"missing or not a boolean\");\n}\n\nfunction num(obj: JsonObject, key: string, where: string): number {\n const value = obj[key];\n return typeof value === \"number\" && Number.isFinite(value)\n ? value\n : bad(where, key, \"missing or not a number\");\n}\n\nfunction int(obj: JsonObject, key: string, where: string): number {\n const value = num(obj, key, where);\n return Number.isInteger(value) ? value : bad(where, key, \"not an integer\");\n}\n\nfunction obj(parent: JsonObject, key: string, where: string): JsonObject {\n const value = parent[key];\n return isObject(value) ? value : bad(where, key, \"missing or not an object\");\n}\n\nfunction list(\n parent: JsonObject,\n key: string,\n where: string,\n): readonly unknown[] {\n const value = parent[key];\n return Array.isArray(value)\n ? value\n : bad(where, key, \"missing or not a list\");\n}\n\nfunction strs(\n parent: JsonObject,\n key: string,\n where: string,\n): readonly string[] {\n const items = list(parent, key, where);\n return items.every((item) => typeof item === \"string\")\n ? (items as readonly string[])\n : bad(where, key, \"expected a list of strings\");\n}\n\n/** A member that may be absent or `null`. */\nfunction opt<T>(\n parent: JsonObject,\n key: string,\n where: string,\n read: (parent: JsonObject, key: string, where: string) => T,\n): T | null {\n return parent[key] === undefined || parent[key] === null\n ? null\n : read(parent, key, where);\n}\n\nfunction stringMap(\n parent: JsonObject,\n key: string,\n where: string,\n): Record<string, string> {\n const out: Record<string, string> = {};\n for (const [k, v] of Object.entries(obj(parent, key, where))) {\n if (typeof v === \"string\") {\n out[k] = v;\n }\n }\n return out;\n}\n\nfunction objects(parent: JsonObject, key: string, where: string): JsonObject[] {\n return list(parent, key, where).map((item, i) =>\n isObject(item) ? item : bad(`${where}.${key}`, `[${i}]`, \"not an object\"),\n );\n}\n\nfunction parseField(o: JsonObject, w: string): FieldSpec {\n return {\n name: str(o, \"name\", w),\n value_type: str(o, \"value_type\", w),\n filter_ops: strs(o, \"filter_ops\", w),\n sortable: bool(o, \"sortable\", w),\n choices: opt(o, \"choices\", w, strs),\n numeric: bool(o, \"numeric\", w),\n categorical: bool(o, \"categorical\", w),\n read_only: bool(o, \"read_only\", w),\n required: bool(o, \"required\", w),\n };\n}\n\nfunction parseEvents(o: JsonObject, w: string): EventsSpec {\n return {\n transport: str(o, \"transport\", w),\n path: str(o, \"path\", w),\n resource: str(o, \"resource\", w),\n resume_param: str(o, \"resume_param\", w),\n replay: str(o, \"replay\", w),\n keepalive_seconds: num(o, \"keepalive_seconds\", w),\n actions: strs(o, \"actions\", w),\n };\n}\n\nfunction parseCapabilities(o: JsonObject, w: string): Capabilities {\n return {\n bulk_update: bool(o, \"bulk_update\", w),\n bulk_delete: bool(o, \"bulk_delete\", w),\n clone: bool(o, \"clone\", w),\n draft_publish: bool(o, \"draft_publish\", w),\n archive_restore: bool(o, \"archive_restore\", w),\n revisions: bool(o, \"revisions\", w),\n events: opt(o, \"events\", w, (p, k, ww) =>\n parseEvents(obj(p, k, ww), `${ww}.${k}`),\n ),\n stats: bool(o, \"stats\", w),\n predict: bool(o, \"predict\", w),\n conditional_requests: bool(o, \"conditional_requests\", w),\n owner_scoped: bool(o, \"owner_scoped\", w),\n schedulable: bool(o, \"schedulable\", w),\n };\n}\n\nfunction parseResource(o: JsonObject, w: string): Resource {\n const schemas = obj(o, \"schemas\", w);\n const pagination = obj(o, \"pagination\", w);\n const auth = obj(o, \"auth\", w);\n const cache = obj(o, \"cache\", w);\n const sw = `${w}.schemas`;\n return {\n name: str(o, \"name\", w),\n title: str(o, \"title\", w),\n api_version: str(o, \"api_version\", w),\n base_path: str(o, \"base_path\", w),\n formats: stringMap(o, \"formats\", w),\n id_field: str(o, \"id_field\", w),\n schemas: {\n read: obj(schemas, \"read\", sw),\n create: obj(schemas, \"create\", sw),\n update: obj(schemas, \"update\", sw),\n draft: opt(schemas, \"draft\", sw, obj),\n },\n fields: objects(o, \"fields\", w).map((f, i) =>\n parseField(f, `${w}.fields[${i}]`),\n ),\n pagination: {\n style: str(pagination, \"style\", w),\n skip_param: str(pagination, \"skip_param\", w),\n limit_param: str(pagination, \"limit_param\", w),\n sort_param: str(pagination, \"sort_param\", w),\n default_limit: int(pagination, \"default_limit\", w),\n max_limit: int(pagination, \"max_limit\", w),\n total: bool(pagination, \"total\", w),\n },\n capabilities: parseCapabilities(\n obj(o, \"capabilities\", w),\n `${w}.capabilities`,\n ),\n paths: stringMap(o, \"paths\", w),\n bulk: { max_matched: int(obj(o, \"bulk\", w), \"max_matched\", `${w}.bulk`) },\n auth: {\n scheme: str(auth, \"scheme\", w),\n oidc_discovery_url: opt(auth, \"oidc_discovery_url\", w, str),\n public_read: bool(auth, \"public_read\", w),\n read_roles: strs(auth, \"read_roles\", w),\n write_roles: strs(auth, \"write_roles\", w),\n delete_roles: strs(auth, \"delete_roles\", w),\n },\n cache: {\n etag: bool(cache, \"etag\", w),\n max_age: int(cache, \"max_age\", w),\n stats_ttl: opt(cache, \"stats_ttl\", w, int),\n stale_while_revalidate: int(cache, \"stale_while_revalidate\", w),\n list_etag: opt(cache, \"list_etag\", w, str),\n record_etag: opt(cache, \"record_etag\", w, str),\n revalidate_only: bool(cache, \"revalidate_only\", w),\n },\n };\n}\n\n/** Parses a manifest document; unknown members are ignored, unknown versions refused. */\nexport function parseManifest(document: unknown): Manifest {\n if (!isObject(document)) {\n throw new ManifestError(\"the manifest is not a JSON object\");\n }\n const version = str(document, \"manifest_version\", \"manifest\");\n if (version !== \"1\") {\n throw new ManifestError(`unsupported manifest_version \"${version}\"`);\n }\n const service = obj(document, \"service\", \"manifest\");\n return {\n manifest_version: version,\n service: {\n name: str(service, \"name\", \"manifest.service\"),\n version: str(service, \"version\", \"manifest.service\"),\n },\n resources: objects(document, \"resources\", \"manifest\").map((r, i) =>\n parseResource(r, `resources[${i}]`),\n ),\n };\n}\n\n/**\n * The resource called `name`: the one with `apiVersion` when given, else the\n * highest `api_version` (`v2` beats `v1`); `undefined` when there is none.\n */\nexport function findResource(\n manifest: Manifest,\n name: string,\n apiVersion?: string,\n): Resource | undefined {\n const rank = (r: Resource): number =>\n Number.parseInt(r.api_version.slice(1), 10) || 0;\n let best: Resource | undefined;\n for (const r of manifest.resources) {\n if (\n r.name === name &&\n (apiVersion === undefined || r.api_version === apiVersion)\n ) {\n if (best === undefined || rank(r) > rank(best)) {\n best = r;\n }\n }\n }\n return best;\n}\n\n/** The absolute manifest URL: the first `describedby` link with the manifest profile. */\nexport function manifestUrlFromCatalog(\n linkset: unknown,\n catalogUrl: string,\n): string {\n const entries = isObject(linkset) ? linkset[\"linkset\"] : undefined;\n for (const entry of Array.isArray(entries) ? entries : []) {\n const links = isObject(entry) ? entry[\"describedby\"] : undefined;\n for (const link of Array.isArray(links) ? links : []) {\n if (\n isObject(link) &&\n link[\"profile\"] === PROFILE &&\n typeof link[\"href\"] === \"string\"\n ) {\n const url = new URL(link[\"href\"], catalogUrl);\n if (url.origin !== new URL(catalogUrl).origin) {\n // The client sends its bearer token to this URL: stay on the server's origin.\n throw new ManifestError(\n `the api-catalog points at another origin (${url.origin}); pass manifestUrl to use it`,\n );\n }\n return url.href;\n }\n }\n }\n throw new ManifestError(\n `the api-catalog has no describedby link with profile ${PROFILE}`,\n );\n}\n\n/** Fetches a JSON document; `catalog` marks the api-catalog request (kept out of the manifest cache). */\nexport type GetJson = (url: string, catalog: boolean) => Promise<unknown>;\n\n/**\n * Loads and parses the manifest, via api-catalog discovery from `baseUrl` or\n * a direct `manifestUrl`.\n */\nexport async function loadManifest(\n getJson: GetJson,\n baseUrl: string,\n manifestUrl?: string,\n): Promise<Manifest> {\n let url = manifestUrl;\n if (url === undefined) {\n const catalogUrl = new URL(CATALOG_PATH, baseUrl).href;\n url = manifestUrlFromCatalog(await getJson(catalogUrl, true), catalogUrl);\n }\n return parseManifest(await getJson(url, false));\n}\n","/**\n * Query-string builder with `crud_query` semantics, validated against the\n * manifest fields. Produces the same bytes as the Python SDK.\n */\nimport { InvalidQueryError } from \"./errors.ts\";\nimport type { FieldSpec } from \"./manifest.ts\";\n\nconst MAX_REGEX_LENGTH = 200;\n\n/** The part of a manifest field the builder needs. */\nexport type QueryField = Pick<\n FieldSpec,\n \"name\" | \"value_type\" | \"filter_ops\" | \"sortable\" | \"choices\"\n>;\n\n/** Filter arguments: `field` (equality, emitted bare) or `field__op` -> value. */\nexport type Filters = Readonly<Record<string, unknown>>;\n\n/** `\"name,-other\"` or `[\"name\", \"-other\"]`. */\nexport type Sort = string | readonly string[];\n\n/** Everything {@link buildQuery} takes beside the fields. */\nexport interface QueryParams {\n readonly recordId?: number | undefined;\n readonly filters?: Filters | undefined;\n readonly sort?: Sort | undefined;\n readonly skip?: number | undefined;\n readonly limit?: number | undefined;\n readonly maxLimit?: number | undefined;\n readonly skipParam?: string | undefined;\n readonly limitParam?: string | undefined;\n readonly sortParam?: string | undefined;\n readonly includeArchived?: boolean | undefined;\n readonly includeUnpublished?: boolean | undefined;\n}\n\n/** Percent-encodes everything but the RFC 3986 unreserved characters `A-Za-z0-9-._~`. */\nexport function quote(text: string): string {\n return encodeURIComponent(text).replace(\n /[!'()*]/g,\n (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n}\n\n/** Joins already-stringified pairs, encoding keys and values. */\nexport function encodeParams(\n pairs: readonly (readonly [string, string])[],\n): string {\n return pairs.map(([k, v]) => `${quote(k)}=${quote(v)}`).join(\"&\");\n}\n\nfunction formatDatetime(value: Date): string | undefined {\n if (Number.isNaN(value.getTime())) {\n return undefined;\n }\n const iso = value.toISOString();\n if (iso.length !== 24) {\n return undefined; // expanded years (outside 0000-9999)\n }\n const millis = iso.slice(20, 23).replace(/0+$/, \"\");\n return millis === \"\"\n ? `${iso.slice(0, 19)}Z`\n : `${iso.slice(0, 19)}.${millis}Z`;\n}\n\nfunction formatDate(value: string): string | undefined {\n if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(value)) {\n return undefined;\n }\n const parsed = new Date(`${value}T00:00:00Z`);\n return Number.isNaN(parsed.getTime()) ||\n parsed.toISOString().slice(0, 10) !== value\n ? undefined\n : value;\n}\n\nfunction scalarText(kind: string, value: unknown): string | undefined {\n switch (kind) {\n case \"integer\":\n return typeof value === \"number\" && Number.isSafeInteger(value)\n ? String(value)\n : undefined;\n case \"number\":\n return typeof value === \"number\" && Number.isFinite(value)\n ? String(value)\n : undefined;\n case \"boolean\":\n return typeof value === \"boolean\" ? String(value) : undefined;\n case \"date\":\n return typeof value === \"string\" ? formatDate(value) : undefined;\n case \"datetime\":\n return value instanceof Date ? formatDatetime(value) : undefined;\n default:\n return typeof value === \"string\" ? value : undefined;\n }\n}\n\n/**\n * Wire form of one value for `field`; throws `InvalidQueryError` on a type\n * mismatch. Dates are `YYYY-MM-DD` strings, datetimes `Date`s (UTC, with\n * millisecond precision, trailing zeros trimmed).\n */\nexport function formatScalar(field: QueryField, value: unknown): string {\n const text = scalarText(field.value_type, value);\n if (text === undefined) {\n throw new InvalidQueryError(\n `field \"${field.name}\" (${field.value_type}) cannot take ${String(value)}`,\n );\n }\n if (\n field.value_type === \"enum\" &&\n field.choices !== null &&\n !field.choices.includes(text)\n ) {\n throw new InvalidQueryError(\n `field \"${field.name}\" accepts only ${JSON.stringify(field.choices)}, not \"${text}\"`,\n );\n }\n return text;\n}\n\nfunction filterPair(\n field: QueryField,\n op: string,\n value: unknown,\n): [string, string] {\n const key = op === \"eq\" ? field.name : `${field.name}__${op}`;\n if (op === \"in\") {\n if (!Array.isArray(value) || value.length === 0) {\n throw new InvalidQueryError(`\"${key}\" takes a non-empty array`);\n }\n const parts = value.map((item: unknown) => formatScalar(field, item));\n if (parts.some((part) => part.includes(\",\"))) {\n throw new InvalidQueryError(\n `\"${key}\": a value contains a comma, which separates the list`,\n );\n }\n return [key, parts.map(quote).join(\",\")];\n }\n const text = formatScalar(field, value);\n if (op === \"regex\" && [...text].length > MAX_REGEX_LENGTH) {\n throw new InvalidQueryError(\n `\"${key}\": a regex is limited to ${MAX_REGEX_LENGTH} characters`,\n );\n }\n return [key, quote(text)];\n}\n\nconst compare = (a: string, b: string): number => (a < b ? -1 : a > b ? 1 : 0);\n\nfunction filterPairs(\n fields: ReadonlyMap<string, QueryField>,\n filters: Filters,\n): [string, string][] {\n const parsed = new Map<\n string,\n { name: string; op: string; pair: [string, string] }\n >();\n for (const [rawKey, value] of Object.entries(filters)) {\n const at = rawKey.lastIndexOf(\"__\");\n const name = at < 0 ? rawKey : rawKey.slice(0, at);\n const op = at < 0 ? \"eq\" : rawKey.slice(at + 2);\n const field = fields.get(name);\n if (field === undefined) {\n throw new InvalidQueryError(`unknown filter field \"${name}\"`);\n }\n if (!field.filter_ops.includes(op)) {\n throw new InvalidQueryError(\n `field \"${name}\" does not support the \"${op}\" operator`,\n );\n }\n if (name === \"id\" && op === \"eq\") {\n throw new InvalidQueryError(\n \"filter on id with recordId, not an equality filter\",\n );\n }\n const id = `${name}\\u0000${op}`;\n if (parsed.has(id)) {\n throw new InvalidQueryError(`filter \"${name}\" \"${op}\" given twice`);\n }\n parsed.set(id, { name, op, pair: filterPair(field, op, value) });\n }\n return [...parsed.values()]\n .sort((a, b) => compare(a.name, b.name) || compare(a.op, b.op))\n .map((entry) => entry.pair);\n}\n\nfunction sortValue(\n fields: ReadonlyMap<string, QueryField>,\n sort: Sort,\n): string {\n const parts = typeof sort === \"string\" ? sort.split(\",\") : sort;\n const out = parts.map((part) => {\n const name = part.startsWith(\"-\") ? part.slice(1) : part;\n const field = fields.get(name);\n if (field === undefined || !field.sortable) {\n throw new InvalidQueryError(`cannot sort by \"${name}\"`);\n }\n return quote(part);\n });\n if (out.length === 0) {\n throw new InvalidQueryError(\"sort is empty\");\n }\n return out.join(\",\");\n}\n\nfunction intArg(name: string, value: unknown, minimum: number): string {\n if (\n typeof value !== \"number\" ||\n !Number.isSafeInteger(value) ||\n value < minimum\n ) {\n throw new InvalidQueryError(`${name} must be an integer >= ${minimum}`);\n }\n return String(value);\n}\n\n/**\n * The query string (no leading `?`) for a list, get or bulk call. Order of\n * parameters: `id`, filters sorted by (field, operator), sort, skip, limit,\n * `include_archived`, `include_unpublished`. The sort/skip/limit names are\n * `sortParam`/`skipParam`/`limitParam` (the manifest's `pagination`); the\n * `id` parameter is always `id`. Flags are emitted whenever they are not\n * `undefined`.\n */\nexport function buildQuery(\n fields: readonly QueryField[],\n params: QueryParams = {},\n): string {\n const byName = new Map(fields.map((f) => [f.name, f]));\n const parts: string[] = [];\n if (params.recordId !== undefined) {\n parts.push(`id=${intArg(\"recordId\", params.recordId, 0)}`);\n }\n for (const [key, value] of filterPairs(byName, params.filters ?? {})) {\n parts.push(`${quote(key)}=${value}`); // values arrive encoded; `in` keeps its commas\n }\n if (params.sort !== undefined) {\n parts.push(\n `${quote(params.sortParam ?? \"sort\")}=${sortValue(byName, params.sort)}`,\n );\n }\n if (params.skip !== undefined) {\n parts.push(\n `${quote(params.skipParam ?? \"skip\")}=${intArg(\"skip\", params.skip, 0)}`,\n );\n }\n if (params.limit !== undefined) {\n const text = intArg(\"limit\", params.limit, 1);\n if (params.maxLimit !== undefined && params.limit > params.maxLimit) {\n throw new InvalidQueryError(\n `limit ${params.limit} exceeds the server maximum ${params.maxLimit}`,\n );\n }\n parts.push(`${quote(params.limitParam ?? \"limit\")}=${text}`);\n }\n if (params.includeArchived !== undefined) {\n parts.push(`include_archived=${params.includeArchived}`);\n }\n if (params.includeUnpublished !== undefined) {\n parts.push(`include_unpublished=${params.includeUnpublished}`);\n }\n return parts.join(\"&\");\n}\n","/** Fetch client: manifest-driven resource handles over a middleware chain. */\nimport { cacheScope } from \"./auth.ts\";\nimport {\n CapabilityError,\n ConnectionFailed,\n InvalidQueryError,\n ManifestError,\n ResponseError,\n UnknownResourceError,\n problemFromResponse,\n} from \"./errors.ts\";\nimport { composeMiddleware } from \"./interfaces.ts\";\nimport type { Middleware, Op, TokenProvider } from \"./interfaces.ts\";\nimport { findResource, loadManifest } from \"./manifest.ts\";\nimport type { JsonObject, Manifest, Resource } from \"./manifest.ts\";\nimport { buildQuery, encodeParams } from \"./query.ts\";\nimport type { Filters, QueryParams, Sort } from \"./query.ts\";\n\n/** Per-call options. */\nexport interface RequestOptions {\n readonly signal?: AbortSignal | undefined;\n}\n\n/** Options of `list` and `iterAll`. */\nexport interface ListOptions extends RequestOptions {\n readonly filters?: Filters | undefined;\n readonly sort?: Sort | undefined;\n readonly skip?: number | undefined;\n readonly limit?: number | undefined;\n readonly includeArchived?: boolean | undefined;\n readonly includeUnpublished?: boolean | undefined;\n}\n\n/** Options of `update` and `delete`: `ifMatch` is an ETag (`412` when stale). */\nexport interface WriteOptions extends RequestOptions {\n readonly ifMatch?: string | undefined;\n}\n\n/** Options of `stats`. */\nexport interface StatsOptions extends RequestOptions {\n readonly bucket?: string | undefined;\n readonly includeArchived?: boolean | undefined;\n readonly includeUnpublished?: boolean | undefined;\n}\n\n/** Options of `predict`. */\nexport interface PredictOptions extends RequestOptions {\n readonly field?: string | undefined;\n readonly periods?: number | undefined;\n readonly bucket?: string | undefined;\n}\n\n/** Options of `restore`: exactly one of `id` and `filters`. */\nexport interface RestoreOptions extends RequestOptions {\n readonly id?: number | undefined;\n readonly filters?: Filters | undefined;\n}\n\n/** The result of a bulk call. */\nexport interface BulkResult {\n readonly matched: number;\n readonly ids: readonly number[];\n}\n\nexport interface Call {\n readonly method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n readonly url: string;\n readonly op: Op;\n readonly resource: string | undefined;\n readonly recordId: number | undefined;\n readonly apiVersion: string | null;\n readonly json?: unknown;\n readonly headers?: Readonly<Record<string, string>>;\n}\n\n/** What a {@link ResourceClient} needs from its client. */\nexport interface Transport {\n json(call: Call, signal: AbortSignal | undefined): Promise<unknown>;\n none(call: Call, signal: AbortSignal | undefined): Promise<void>;\n}\n\nconst joinUrl = (base: string, path: string): string =>\n new URL(path, base).href;\n\n/** Builds the requests of one resource. */\nclass Plan {\n readonly #baseUrl: string;\n readonly resource: Resource;\n\n constructor(baseUrl: string, resource: Resource) {\n this.#baseUrl = baseUrl;\n this.resource = resource;\n }\n\n #call(\n method: Call[\"method\"],\n op: Op,\n path: string,\n query = \"\",\n extra: {\n recordId?: number | undefined;\n json?: unknown;\n ifMatch?: string | undefined;\n } = {},\n ): Call {\n const url =\n joinUrl(this.#baseUrl, path) + (query === \"\" ? \"\" : `?${query}`);\n return {\n method,\n url,\n op,\n resource: this.resource.name,\n recordId: extra.recordId,\n apiVersion: this.resource.api_version,\n ...(extra.json === undefined ? {} : { json: extra.json }),\n ...(extra.ifMatch === undefined\n ? {}\n : { headers: { \"If-Match\": extra.ifMatch } }),\n };\n }\n\n #query(params: QueryParams = {}): string {\n const paging = this.resource.pagination;\n return buildQuery(this.resource.fields, {\n maxLimit: paging.max_limit,\n skipParam: paging.skip_param,\n limitParam: paging.limit_param,\n sortParam: paging.sort_param,\n ...params,\n });\n }\n\n #subPath(key: string, supported: boolean): string {\n const path = this.resource.paths[key];\n if (!supported || path === undefined) {\n throw new CapabilityError(\n `resource \"${this.resource.name}\" does not support ${key}`,\n );\n }\n return path;\n }\n\n #need(supported: boolean, what: string): void {\n if (!supported) {\n throw new CapabilityError(\n `resource \"${this.resource.name}\" does not support ${what}`,\n );\n }\n }\n\n #bulkFilters(filters: Filters): string {\n if (Object.keys(filters).length === 0) {\n throw new InvalidQueryError(\"a bulk operation needs at least one filter\");\n }\n return this.#query({ filters });\n }\n\n get #base(): string {\n return this.resource.base_path;\n }\n\n eventsUrl(): string {\n const events = this.resource.capabilities.events;\n if (events === null) {\n throw new CapabilityError(\n `resource \"${this.resource.name}\" does not support events`,\n );\n }\n return joinUrl(this.#baseUrl, events.path);\n }\n\n list(o: ListOptions): Call {\n const query = this.#query({\n filters: o.filters,\n sort: o.sort,\n skip: o.skip,\n limit: o.limit,\n includeArchived: o.includeArchived,\n includeUnpublished: o.includeUnpublished,\n });\n return this.#call(\"GET\", \"list\", this.#base, query);\n }\n\n get(id: number): Call {\n return this.#call(\n \"GET\",\n \"record\",\n this.#base,\n this.#query({ recordId: id }),\n {\n recordId: id,\n },\n );\n }\n\n create(data: unknown): Call {\n return this.#call(\"POST\", \"create\", this.#base, \"\", { json: data });\n }\n\n update(id: number, data: unknown, ifMatch: string | undefined): Call {\n return this.#call(\n \"PATCH\",\n \"update\",\n this.#base,\n this.#query({ recordId: id }),\n {\n recordId: id,\n json: data,\n ifMatch,\n },\n );\n }\n\n updateMany(filters: Filters, data: unknown): Call {\n this.#need(this.resource.capabilities.bulk_update, \"bulk_update\");\n return this.#call(\n \"PATCH\",\n \"bulk_update\",\n this.#base,\n this.#bulkFilters(filters),\n {\n json: data,\n },\n );\n }\n\n delete(id: number, ifMatch: string | undefined): Call {\n return this.#call(\n \"DELETE\",\n \"delete\",\n this.#base,\n this.#query({ recordId: id }),\n {\n recordId: id,\n ifMatch,\n },\n );\n }\n\n deleteMany(filters: Filters): Call {\n this.#need(this.resource.capabilities.bulk_delete, \"bulk_delete\");\n return this.#call(\n \"DELETE\",\n \"bulk_delete\",\n this.#base,\n this.#bulkFilters(filters),\n );\n }\n\n restore(id: number | undefined, filters: Filters | undefined): Call {\n const path = this.#subPath(\n \"restore\",\n this.resource.capabilities.archive_restore,\n );\n if ((id === undefined) === (filters === undefined)) {\n throw new InvalidQueryError(\n \"restore takes exactly one of id and filters\",\n );\n }\n const query =\n filters === undefined\n ? this.#query({ recordId: id })\n : this.#bulkFilters(filters);\n return this.#call(\"POST\", \"restore\", path, query, { recordId: id });\n }\n\n stats(o: StatsOptions): Call {\n const path = this.#subPath(\"stats\", this.resource.capabilities.stats);\n const pairs: [string, string][] =\n o.bucket === undefined ? [] : [[\"bucket\", o.bucket]];\n if (o.includeArchived !== undefined) {\n pairs.push([\"include_archived\", String(o.includeArchived)]);\n }\n if (o.includeUnpublished !== undefined) {\n pairs.push([\"include_unpublished\", String(o.includeUnpublished)]);\n }\n return this.#call(\"GET\", \"stats\", path, encodeParams(pairs));\n }\n\n predict(o: PredictOptions): Call {\n const path = this.#subPath(\"predict\", this.resource.capabilities.predict);\n const pairs: [string, string][] = [];\n if (o.field !== undefined) {\n const spec = this.resource.fields.find((f) => f.name === o.field);\n if (spec === undefined || !spec.numeric) {\n throw new InvalidQueryError(\n `cannot predict \"${o.field}\": not a numeric field`,\n );\n }\n pairs.push([\"field\", o.field]);\n }\n if (o.periods !== undefined) {\n if (!Number.isSafeInteger(o.periods) || o.periods < 1) {\n throw new InvalidQueryError(\"periods must be an integer >= 1\");\n }\n pairs.push([\"periods\", String(o.periods)]);\n }\n if (o.bucket !== undefined) {\n pairs.push([\"bucket\", o.bucket]);\n }\n return this.#call(\"GET\", \"predict\", path, encodeParams(pairs));\n }\n\n clone(id: number): Call {\n const path = this.#subPath(\"clone\", this.resource.capabilities.clone);\n return this.#call(\"POST\", \"clone\", path, this.#query({ recordId: id }), {\n recordId: id,\n });\n }\n\n draft(data: unknown): Call {\n const path = this.#subPath(\n \"draft\",\n this.resource.capabilities.draft_publish,\n );\n return this.#call(\"POST\", \"draft\", path, \"\", { json: data });\n }\n\n publish(id: number): Call {\n const path = this.#subPath(\n \"publish\",\n this.resource.capabilities.draft_publish,\n );\n return this.#call(\"POST\", \"publish\", path, this.#query({ recordId: id }), {\n recordId: id,\n });\n }\n\n filters(): Call {\n return this.#call(\"GET\", \"filters\", this.#subPath(\"filters\", true));\n }\n\n revisions(id: number): Call {\n const path = this.#subPath(\n \"revisions\",\n this.resource.capabilities.revisions,\n );\n return this.#call(\"GET\", \"revisions\", path, this.#query({ recordId: id }), {\n recordId: id,\n });\n }\n}\n\n/**\n * Operations on one resource. The type parameters are the record views;\n * `crud-sdk-codegen` writes interfaces to pass for them (they are not\n * checked against the manifest at runtime).\n */\nexport class ResourceClient<\n Read extends object = JsonObject,\n Create extends object = JsonObject,\n Update extends object = JsonObject,\n> {\n /** The manifest entry this handle is bound to. */\n readonly resource: Resource;\n readonly #plan: Plan;\n readonly #transport: Transport;\n\n /** Use `CrudClient.resource`. */\n constructor(baseUrl: string, resource: Resource, transport: Transport) {\n this.resource = resource;\n this.#plan = new Plan(baseUrl, resource);\n this.#transport = transport;\n }\n\n async #one<T>(call: Call, options: RequestOptions): Promise<T> {\n return (await this.#transport.json(call, options.signal)) as T;\n }\n\n /** One page of records. */\n async list(options: ListOptions = {}): Promise<Read[]> {\n return this.#one(this.#plan.list(options), options);\n }\n\n /** Every record, paging with `skip += limit` until a page shorter than `limit`. */\n async *iterAll(\n options: ListOptions = {},\n ): AsyncGenerator<Read, void, undefined> {\n const size = options.limit ?? this.resource.pagination.default_limit;\n let skip = options.skip ?? 0;\n for (;;) {\n const page = await this.list({ ...options, skip, limit: size });\n yield* page;\n if (page.length < size) {\n return;\n }\n skip += size;\n }\n }\n\n /** One record. */\n async get(id: number, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.get(id), options);\n }\n\n /** Creates a record. */\n async create(data: Create, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.create(data), options);\n }\n\n /** Patches one record; `ifMatch` is an ETag (`412` when stale). */\n async update(\n id: number,\n data: Update,\n options: WriteOptions = {},\n ): Promise<Read> {\n return this.#one(this.#plan.update(id, data, options.ifMatch), options);\n }\n\n /** Patches every record matching `filters`. */\n async updateMany(\n filters: Filters,\n data: Update,\n options: RequestOptions = {},\n ): Promise<BulkResult> {\n return this.#one(this.#plan.updateMany(filters, data), options);\n }\n\n /** Deletes one record; `ifMatch` as for `update`. */\n async delete(id: number, options: WriteOptions = {}): Promise<void> {\n await this.#transport.none(\n this.#plan.delete(id, options.ifMatch),\n options.signal,\n );\n }\n\n /** Deletes every record matching `filters`. */\n async deleteMany(\n filters: Filters,\n options: RequestOptions = {},\n ): Promise<BulkResult> {\n return this.#one(this.#plan.deleteMany(filters), options);\n }\n\n /** Restores archived records, by `id` or by `filters`. */\n async restore(options: RestoreOptions): Promise<BulkResult> {\n return this.#one(this.#plan.restore(options.id, options.filters), options);\n }\n\n /** Aggregates over the resource. */\n async stats(options: StatsOptions = {}): Promise<JsonObject> {\n return this.#one(this.#plan.stats(options), options);\n }\n\n /** A forecast. */\n async predict(options: PredictOptions = {}): Promise<JsonObject> {\n return this.#one(this.#plan.predict(options), options);\n }\n\n /** Copies a record; returns the copy. */\n async clone(id: number, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.clone(id), options);\n }\n\n /** Creates a draft (needs `draft_publish`). */\n async createDraft(data: Create, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.draft(data), options);\n }\n\n /** Publishes a draft (needs `draft_publish`). */\n async publish(id: number, options: RequestOptions = {}): Promise<Read> {\n return this.#one(this.#plan.publish(id), options);\n }\n\n /** The server's filter metadata (`kind` instead of `value_type`). */\n async filters(options: RequestOptions = {}): Promise<JsonObject[]> {\n return this.#one(this.#plan.filters(), options);\n }\n\n /** Revisions of one record, newest first. */\n async revisions(\n id: number,\n options: RequestOptions = {},\n ): Promise<JsonObject[]> {\n return this.#one(this.#plan.revisions(id), options);\n }\n\n /** Absolute URL of the resource's SSE stream. */\n eventsUrl(): string {\n return this.#plan.eventsUrl();\n }\n}\n\n/** Options of {@link createClient}. */\nexport interface ClientOptions {\n /** The server origin (or any URL on it). */\n readonly baseUrl: string;\n /** The network `fetch`; defaults to `globalThis.fetch`. */\n readonly fetch?: typeof fetch | undefined;\n /** Returns the bearer token; called again with `refresh: true` once after a `401`. */\n readonly tokenProvider?: TokenProvider | undefined;\n /** Outermost first; see `composeMiddleware`. */\n readonly middleware?: readonly Middleware[] | undefined;\n /** Skips api-catalog discovery. */\n readonly manifestUrl?: string | undefined;\n /**\n * Stable identity of this client in TanStack query keys. Defaults to\n * `baseUrl`; set it when two clients share a `baseUrl` but must not share\n * cached data, and keep it constant across reloads of a persisted cache.\n */\n readonly id?: string | undefined;\n}\n\n/** Discovers the manifest and hands out {@link ResourceClient}s. */\nexport class CrudClient {\n readonly baseUrl: string;\n /** Stable identity in TanStack query keys (`ClientOptions.id`, else `baseUrl`). */\n readonly id: string;\n readonly #fetch: typeof fetch | undefined;\n readonly #tokenProvider: TokenProvider | undefined;\n readonly #middleware: Middleware[];\n readonly #manifestUrl: string | undefined;\n readonly #manifests = new Map<string, Promise<Manifest>>();\n readonly #transport: Transport;\n\n constructor(options: ClientOptions) {\n this.baseUrl = options.baseUrl;\n this.id = options.id ?? options.baseUrl;\n this.#fetch = options.fetch;\n this.#tokenProvider = options.tokenProvider;\n this.#middleware = [...(options.middleware ?? [])];\n this.#manifestUrl = options.manifestUrl;\n this.#transport = {\n json: async (call, signal) => {\n const response = await this.#send(call, signal);\n if (response.status === 204) {\n return undefined;\n }\n try {\n return (await response.json()) as unknown;\n } catch (error) {\n throw new ResponseError(\n `${call.method} ${call.url}: the ${response.status} response body is not valid JSON`,\n { cause: error },\n );\n }\n },\n none: async (call, signal) => {\n await (await this.#send(call, signal)).body?.cancel();\n },\n };\n }\n\n /** Adds middleware after the existing ones (innermost); it sees every later request. */\n use(middleware: Middleware): this {\n this.#middleware.push(middleware);\n return this;\n }\n\n async #token(refresh: boolean): Promise<string | null> {\n // An empty token sends no header, so it is anonymous for the scope too.\n return (await this.#tokenProvider?.({ refresh })) || null;\n }\n\n /** The current bearer token, or `null` when anonymous. */\n token(refresh = false): Promise<string | null> {\n return this.#token(refresh);\n }\n\n /** The cache scope of the current caller (`\"anon\"` or a hash of the token). */\n async scope(): Promise<string> {\n return cacheScope(await this.#token(false));\n }\n\n /** The `{ client, scope }` namespace the `./tanstack` key factory takes. */\n async namespace(): Promise<{\n readonly client: string;\n readonly scope: string;\n }> {\n return { client: this.id, scope: await this.scope() };\n }\n\n async #dispatch(\n call: Call,\n token: string | null,\n signal: AbortSignal | undefined,\n ): Promise<Response> {\n const headers = new Headers({\n Accept: \"application/json\",\n ...call.headers,\n });\n if (token !== null) {\n headers.set(\"Authorization\", `Bearer ${token}`);\n }\n const init: RequestInit = {\n method: call.method,\n headers,\n signal: signal ?? null,\n };\n if (call.json !== undefined) {\n headers.set(\"Content-Type\", \"application/json\");\n init.body = JSON.stringify(call.json);\n }\n const request = new Request(call.url, init);\n const terminal = async (ctx: {\n readonly request: Request;\n }): Promise<Response> => {\n try {\n return await (this.#fetch ?? globalThis.fetch)(ctx.request);\n } catch (error) {\n if (ctx.request.signal.aborted) {\n throw error;\n }\n throw new ConnectionFailed(\n error instanceof Error ? error.message : String(error),\n {\n cause: error,\n },\n );\n }\n };\n return composeMiddleware(\n this.#middleware,\n terminal,\n )({\n request,\n resource: call.resource,\n op: call.op,\n recordId: call.recordId,\n scope: await cacheScope(token),\n apiVersion: call.apiVersion,\n signal,\n });\n }\n\n /** Sends `call`, retrying once with a refreshed token after a `401`; throws on `>= 400`. */\n async #send(call: Call, signal: AbortSignal | undefined): Promise<Response> {\n const token = await this.#token(false);\n let response = await this.#dispatch(call, token, signal);\n if (response.status === 401 && this.#tokenProvider !== undefined) {\n const fresh = await this.#token(true);\n if (fresh !== null && fresh !== token) {\n await response.body?.cancel();\n response = await this.#dispatch(call, fresh, signal);\n }\n }\n if (response.status >= 400) {\n throw await problemFromResponse(response);\n }\n return response;\n }\n\n async #getJson(url: string, catalog: boolean): Promise<unknown> {\n const call: Call = {\n method: \"GET\",\n url,\n op: \"manifest\",\n resource: undefined,\n recordId: undefined,\n apiVersion: null,\n // The catalog shares the \"manifest\" op; no-store keeps it out of the manifest cache entry.\n ...(catalog ? { headers: { \"Cache-Control\": \"no-store\" } } : {}),\n };\n const response = await this.#send(call, undefined);\n try {\n return (await response.json()) as unknown;\n } catch (error) {\n throw new ManifestError(`${url} is not JSON`, { cause: error });\n }\n }\n\n /** The manifest for this caller, loaded once per caller scope (`refresh: true` reloads). */\n async manifest(\n options: { readonly refresh?: boolean } = {},\n ): Promise<Manifest> {\n const scope = await this.scope(); // the manifest is filtered per caller\n let loading = this.#manifests.get(scope);\n if (loading === undefined || options.refresh === true) {\n const started = loadManifest(\n (url, catalog) => this.#getJson(url, catalog),\n this.baseUrl,\n this.#manifestUrl,\n );\n loading = started;\n if (!this.#manifests.has(scope)) {\n this.#manifests.clear(); // rotated tokens must not pile up manifests\n }\n this.#manifests.set(scope, started);\n started.catch(() => {\n if (this.#manifests.get(scope) === started) {\n this.#manifests.delete(scope);\n }\n });\n }\n return loading;\n }\n\n /** A handle for `name` (the highest `api_version` unless given). */\n async resource<\n Read extends object = JsonObject,\n Create extends object = JsonObject,\n Update extends object = JsonObject,\n >(\n name: string,\n apiVersion?: string,\n ): Promise<ResourceClient<Read, Create, Update>> {\n const resource = findResource(await this.manifest(), name, apiVersion);\n if (resource === undefined) {\n throw new UnknownResourceError(\n `the manifest has no resource \"${name}\"${apiVersion === undefined ? \"\" : ` ${apiVersion}`} for this caller`,\n );\n }\n return new ResourceClient<Read, Create, Update>(\n this.baseUrl,\n resource,\n this.#transport,\n );\n }\n}\n\n/** Creates a client; the manifest loads on first use. */\nexport function createClient(options: ClientOptions): CrudClient {\n return new CrudClient(options);\n}\n"],"mappings":";;;;;;;;AAmIA,SAAgB,kBACd,OACA,UACM;CACN,MAAM,WAAW,OACf,OACA,QACsB;EACtB,MAAM,aAAa,MAAM;EACzB,IAAI,eAAe,KAAA,GACjB,OAAO,SAAS,GAAG;EAErB,OAAO,WAAW,MAAM,SAAS,SAAS,QAAQ,GAAG,IAAI,CAAC;CAC5D;CACA,QAAQ,QAAQ,SAAS,GAAG,GAAG;AACjC;;;;;;;;AC5IA,IAAa,YAAb,cAA+B,MAAM;CACnC,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO,WAAW;CACzB;AACF;;AAGA,IAAa,cAAb,cAAiC,UAAU,CAAC;;AAG5C,IAAa,kBAAb,cAAqC,YAAY,CAAC;;AAGlD,IAAa,oBAAb,cAAuC,YAAY,CAAC;;AAGpD,IAAa,gBAAb,cAAmC,YAAY,CAAC;;AAGhD,IAAa,uBAAb,cAA0C,YAAY,CAAC;;AAGvD,IAAa,gBAAb,cAAmC,UAAU,CAAC;;AAG9C,IAAa,mBAAb,cAAsC,UAAU,CAAC;AAqBjD,MAAM,UAAU;;AAGhB,IAAa,eAAb,cAAkC,UAAU;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,MAAmB;EAC7B,MAAM,SAAS,KAAK,UAAU,CAAC;EAC/B,IAAI,UAAU,GAAG,KAAK,OAAO,GAAG,KAAK;EACrC,IAAI,KAAK,QACP,WAAW,KAAK,KAAK;OAChB,IAAI,OAAO,SAAS,GACzB,WAAW,KAAK,OAAO,KAAK,MAAM,GAAG,EAAE,IAAI,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI;EAE7E,MAAM,OAAO;EACb,KAAK,SAAS,KAAK;EACnB,KAAK,QAAQ,KAAK;EAClB,KAAK,SAAS,KAAK;EACnB,KAAK,OAAO,KAAK,QAAQ;EACzB,KAAK,WAAW,KAAK;EACrB,KAAK,SAAS;EACd,KAAK,UAAU,KAAK,WAAW,IAAI,QAAQ;EAC3C,KAAK,WAAW,KAAK;CACvB;AACF;;AAGA,IAAa,aAAb,cAAgC,aAAa,CAAC;;AAG9C,IAAa,eAAb,cAAkC,aAAa;CAC7C,IAAI,kBAAsC;EACxC,OAAO,KAAK,QAAQ,IAAI,kBAAkB,KAAK,KAAA;CACjD;AACF;;AAGA,IAAa,YAAb,cAA+B,aAAa,CAAC;;AAG7C,IAAa,WAAb,cAA8B,aAAa,CAAC;;AAG5C,IAAa,qBAAb,cAAwC,aAAa,CAAC;;AAGtD,IAAa,mBAAb,cAAsC,aAAa,CAAC;;AAGpD,IAAa,SAAb,cAA4B,aAAa,CAAC;;AAG1C,IAAa,cAAb,cAAiC,aAAa;CAC5C,IAAI,aAAiC;EACnC,MAAM,MAAM,KAAK,QAAQ,IAAI,aAAa;EAC1C,IAAI,QAAQ,QAAQ,IAAI,KAAK,MAAM,IACjC;EAEF,MAAM,UAAU,OAAO,GAAG;EAC1B,OAAO,OAAO,MAAM,OAAO,IAAI,KAAA,IAAY;CAC7C;AACF;;AAGA,IAAa,cAAb,cAAiC,aAAa,CAAC;AAE/C,MAAM,4BAAsD,IAAI,IAAI;CAClE,CAAC,KAAK,UAAU;CAChB,CAAC,KAAK,YAAY;CAClB,CAAC,KAAK,SAAS;CACf,CAAC,KAAK,QAAQ;CACd,CAAC,KAAK,kBAAkB;CACxB,CAAC,KAAK,gBAAgB;CACtB,CAAC,KAAK,MAAM;CACZ,CAAC,KAAK,WAAW;AACnB,CAAC;AAGD,MAAM,0BAAuC,IAAI,IAAI;CACnD,CAAC,KAAK,UAAU;CAChB,CAAC,KAAK,qBAAqB;CAC3B,CAAC,KAAK,YAAY;CAClB,CAAC,KAAK,aAAa;CACnB,CAAC,KAAK,IAAI;CACV,CAAC,KAAK,SAAS;CACf,CAAC,KAAK,UAAU;CAChB,CAAC,KAAK,+BAA+B;CACrC,CAAC,KAAK,YAAY;CAClB,CAAC,KAAK,eAAe;CACrB,CAAC,KAAK,iBAAiB;CACvB,CAAC,KAAK,cAAc;CACpB,CAAC,KAAK,kBAAkB;CACxB,CAAC,KAAK,SAAS;CACf,CAAC,KAAK,kBAAkB;CACxB,CAAC,KAAK,mBAAmB;CACzB,CAAC,KAAK,OAAO;CACb,CAAC,KAAK,WAAW;CACjB,CAAC,KAAK,cAAc;CACpB,CAAC,KAAK,WAAW;CACjB,CAAC,KAAK,oBAAoB;CAC1B,CAAC,KAAK,oBAAoB;CAC1B,CAAC,KAAK,aAAa;CACnB,CAAC,KAAK,cAAc;CACpB,CAAC,KAAK,kBAAkB;CACxB,CAAC,KAAK,WAAW;CACjB,CAAC,KAAK,WAAW;CACjB,CAAC,KAAK,oBAAoB;CAC1B,CAAC,KAAK,gBAAgB;CACtB,CAAC,KAAK,+BAA+B;CACrC,CAAC,KAAK,iBAAiB;CACvB,CAAC,KAAK,UAAU;CAChB,CAAC,KAAK,MAAM;CACZ,CAAC,KAAK,iBAAiB;CACvB,CAAC,KAAK,qBAAqB;CAC3B,CAAC,KAAK,mBAAmB;CACzB,CAAC,KAAK,cAAc;CACpB,CAAC,KAAK,wBAAwB;CAC9B,CAAC,KAAK,uBAAuB;CAC7B,CAAC,KAAK,oBAAoB;CAC1B,CAAC,KAAK,cAAc;CACpB,CAAC,KAAK,qBAAqB;CAC3B,CAAC,KAAK,uBAAuB;CAC7B,CAAC,KAAK,QAAQ;CACd,CAAC,KAAK,mBAAmB;CACzB,CAAC,KAAK,WAAW;CACjB,CAAC,KAAK,kBAAkB;CACxB,CAAC,KAAK,uBAAuB;CAC7B,CAAC,KAAK,mBAAmB;CACzB,CAAC,KAAK,iCAAiC;CACvC,CAAC,KAAK,+BAA+B;CACrC,CAAC,KAAK,uBAAuB;CAC7B,CAAC,KAAK,iBAAiB;CACvB,CAAC,KAAK,aAAa;CACnB,CAAC,KAAK,qBAAqB;CAC3B,CAAC,KAAK,iBAAiB;CACvB,CAAC,KAAK,4BAA4B;CAClC,CAAC,KAAK,yBAAyB;CAC/B,CAAC,KAAK,sBAAsB;CAC5B,CAAC,KAAK,eAAe;CACrB,CAAC,KAAK,cAAc;CACpB,CAAC,KAAK,iCAAiC;AACzC,CAAC;AAID,MAAMA,cAAY,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,SAAS,gBAAgB,OAA4C;CACnE,OAAO,MAAM,KAAK,SAAS;EACzB,IAAIA,WAAS,IAAI,GACf,OAAO;GACL,KAAK,MAAM,QAAQ,KAAK,MAAM,IACzB,KAAK,SACN,CAAC;GACL,KAAK,OAAO,KAAK,UAAU,EAAE;GAC7B,MAAM,OAAO,KAAK,WAAW,EAAE;EACjC;EAEF,OAAO;GAAE,KAAK,CAAC;GAAG,KAAK,OAAO,IAAI;GAAG,MAAM;EAAG;CAChD,CAAC;AACH;;;;;;AAOA,eAAsB,oBACpB,UACuB;CACvB,MAAM,SAAS,SAAS;CACxB,MAAM,SAAS,QAAQ,IAAI,MAAM,KAAK;CACtC,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,MAAM,SAAS,MAAM,CAAC,CAAC,KAAK,CAAC;CACnD,QAAQ;EACN,SAAS,KAAA;CACX;CACA,MAAM,OAAYA,WAAS,MAAM,IAAI,SAAS,CAAC;CAC/C,MAAM,YAAY,KAAK;CACvB,MAAM,YAAY,MAAM,QAAQ,SAAS,IAAI,YAAY,KAAK;CAC9D,MAAM,MACJ,UAAU,IAAI,MAAM,MAAM,UAAU,MAAM,cAAc;CAC1D,MAAM,WAAW,KAAK;CACtB,OAAO,IAAI,IAAI;EACb;EACA,OAAO,OAAO,KAAK,YAAY,MAAM;EACrC,QAAQ,OAAO,cAAc,WAAW,YAAY,KAAA;EACpD,MAAM,OAAO,KAAK,WAAW,OAAO;EACpC,UAAU,OAAO,aAAa,WAAW,WAAW,KAAA;EACpD,QAAQ,MAAM,QAAQ,SAAS,IAAI,gBAAgB,SAAS,IAAI,CAAC;EACjE,SAAS,SAAS;EAClB;CACF,CAAC;AACH;;;;;;;;ACxPA,MAAa,UAAU;AACvB,MAAa,eAAe;AA+G5B,MAAM,YAAY,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,SAAS,IAAI,OAAe,KAAa,MAAqB;CAC5D,MAAM,IAAI,cAAc,GAAG,MAAM,GAAG,IAAI,IAAI,MAAM;AACpD;AAEA,SAAS,IAAI,KAAiB,KAAa,OAAuB;CAChE,MAAM,QAAQ,IAAI;CAClB,OAAO,OAAO,UAAU,WACpB,QACA,IAAI,OAAO,KAAK,yBAAyB;AAC/C;AAEA,SAAS,KAAK,KAAiB,KAAa,OAAwB;CAClE,MAAM,QAAQ,IAAI;CAClB,OAAO,OAAO,UAAU,YACpB,QACA,IAAI,OAAO,KAAK,0BAA0B;AAChD;AAEA,SAAS,IAAI,KAAiB,KAAa,OAAuB;CAChE,MAAM,QAAQ,IAAI;CAClB,OAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IACrD,QACA,IAAI,OAAO,KAAK,yBAAyB;AAC/C;AAEA,SAAS,IAAI,KAAiB,KAAa,OAAuB;CAChE,MAAM,QAAQ,IAAI,KAAK,KAAK,KAAK;CACjC,OAAO,OAAO,UAAU,KAAK,IAAI,QAAQ,IAAI,OAAO,KAAK,gBAAgB;AAC3E;AAEA,SAAS,IAAI,QAAoB,KAAa,OAA2B;CACvE,MAAM,QAAQ,OAAO;CACrB,OAAO,SAAS,KAAK,IAAI,QAAQ,IAAI,OAAO,KAAK,0BAA0B;AAC7E;AAEA,SAAS,KACP,QACA,KACA,OACoB;CACpB,MAAM,QAAQ,OAAO;CACrB,OAAO,MAAM,QAAQ,KAAK,IACtB,QACA,IAAI,OAAO,KAAK,uBAAuB;AAC7C;AAEA,SAAS,KACP,QACA,KACA,OACmB;CACnB,MAAM,QAAQ,KAAK,QAAQ,KAAK,KAAK;CACrC,OAAO,MAAM,OAAO,SAAS,OAAO,SAAS,QAAQ,IAChD,QACD,IAAI,OAAO,KAAK,4BAA4B;AAClD;;AAGA,SAAS,IACP,QACA,KACA,OACA,MACU;CACV,OAAO,OAAO,SAAS,KAAA,KAAa,OAAO,SAAS,OAChD,OACA,KAAK,QAAQ,KAAK,KAAK;AAC7B;AAEA,SAAS,UACP,QACA,KACA,OACwB;CACxB,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,IAAI,QAAQ,KAAK,KAAK,CAAC,GACzD,IAAI,OAAO,MAAM,UACf,IAAI,KAAK;CAGb,OAAO;AACT;AAEA,SAAS,QAAQ,QAAoB,KAAa,OAA6B;CAC7E,OAAO,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,KAAK,MAAM,MACzC,SAAS,IAAI,IAAI,OAAO,IAAI,GAAG,MAAM,GAAG,OAAO,IAAI,EAAE,IAAI,eAAe,CAC1E;AACF;AAEA,SAAS,WAAW,GAAe,GAAsB;CACvD,OAAO;EACL,MAAM,IAAI,GAAG,QAAQ,CAAC;EACtB,YAAY,IAAI,GAAG,cAAc,CAAC;EAClC,YAAY,KAAK,GAAG,cAAc,CAAC;EACnC,UAAU,KAAK,GAAG,YAAY,CAAC;EAC/B,SAAS,IAAI,GAAG,WAAW,GAAG,IAAI;EAClC,SAAS,KAAK,GAAG,WAAW,CAAC;EAC7B,aAAa,KAAK,GAAG,eAAe,CAAC;EACrC,WAAW,KAAK,GAAG,aAAa,CAAC;EACjC,UAAU,KAAK,GAAG,YAAY,CAAC;CACjC;AACF;AAEA,SAAS,YAAY,GAAe,GAAuB;CACzD,OAAO;EACL,WAAW,IAAI,GAAG,aAAa,CAAC;EAChC,MAAM,IAAI,GAAG,QAAQ,CAAC;EACtB,UAAU,IAAI,GAAG,YAAY,CAAC;EAC9B,cAAc,IAAI,GAAG,gBAAgB,CAAC;EACtC,QAAQ,IAAI,GAAG,UAAU,CAAC;EAC1B,mBAAmB,IAAI,GAAG,qBAAqB,CAAC;EAChD,SAAS,KAAK,GAAG,WAAW,CAAC;CAC/B;AACF;AAEA,SAAS,kBAAkB,GAAe,GAAyB;CACjE,OAAO;EACL,aAAa,KAAK,GAAG,eAAe,CAAC;EACrC,aAAa,KAAK,GAAG,eAAe,CAAC;EACrC,OAAO,KAAK,GAAG,SAAS,CAAC;EACzB,eAAe,KAAK,GAAG,iBAAiB,CAAC;EACzC,iBAAiB,KAAK,GAAG,mBAAmB,CAAC;EAC7C,WAAW,KAAK,GAAG,aAAa,CAAC;EACjC,QAAQ,IAAI,GAAG,UAAU,IAAI,GAAG,GAAG,OACjC,YAAY,IAAI,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CACzC;EACA,OAAO,KAAK,GAAG,SAAS,CAAC;EACzB,SAAS,KAAK,GAAG,WAAW,CAAC;EAC7B,sBAAsB,KAAK,GAAG,wBAAwB,CAAC;EACvD,cAAc,KAAK,GAAG,gBAAgB,CAAC;EACvC,aAAa,KAAK,GAAG,eAAe,CAAC;CACvC;AACF;AAEA,SAAS,cAAc,GAAe,GAAqB;CACzD,MAAM,UAAU,IAAI,GAAG,WAAW,CAAC;CACnC,MAAM,aAAa,IAAI,GAAG,cAAc,CAAC;CACzC,MAAM,OAAO,IAAI,GAAG,QAAQ,CAAC;CAC7B,MAAM,QAAQ,IAAI,GAAG,SAAS,CAAC;CAC/B,MAAM,KAAK,GAAG,EAAE;CAChB,OAAO;EACL,MAAM,IAAI,GAAG,QAAQ,CAAC;EACtB,OAAO,IAAI,GAAG,SAAS,CAAC;EACxB,aAAa,IAAI,GAAG,eAAe,CAAC;EACpC,WAAW,IAAI,GAAG,aAAa,CAAC;EAChC,SAAS,UAAU,GAAG,WAAW,CAAC;EAClC,UAAU,IAAI,GAAG,YAAY,CAAC;EAC9B,SAAS;GACP,MAAM,IAAI,SAAS,QAAQ,EAAE;GAC7B,QAAQ,IAAI,SAAS,UAAU,EAAE;GACjC,QAAQ,IAAI,SAAS,UAAU,EAAE;GACjC,OAAO,IAAI,SAAS,SAAS,IAAI,GAAG;EACtC;EACA,QAAQ,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,MACtC,WAAW,GAAG,GAAG,EAAE,UAAU,EAAE,EAAE,CACnC;EACA,YAAY;GACV,OAAO,IAAI,YAAY,SAAS,CAAC;GACjC,YAAY,IAAI,YAAY,cAAc,CAAC;GAC3C,aAAa,IAAI,YAAY,eAAe,CAAC;GAC7C,YAAY,IAAI,YAAY,cAAc,CAAC;GAC3C,eAAe,IAAI,YAAY,iBAAiB,CAAC;GACjD,WAAW,IAAI,YAAY,aAAa,CAAC;GACzC,OAAO,KAAK,YAAY,SAAS,CAAC;EACpC;EACA,cAAc,kBACZ,IAAI,GAAG,gBAAgB,CAAC,GACxB,GAAG,EAAE,cACP;EACA,OAAO,UAAU,GAAG,SAAS,CAAC;EAC9B,MAAM,EAAE,aAAa,IAAI,IAAI,GAAG,QAAQ,CAAC,GAAG,eAAe,GAAG,EAAE,MAAM,EAAE;EACxE,MAAM;GACJ,QAAQ,IAAI,MAAM,UAAU,CAAC;GAC7B,oBAAoB,IAAI,MAAM,sBAAsB,GAAG,GAAG;GAC1D,aAAa,KAAK,MAAM,eAAe,CAAC;GACxC,YAAY,KAAK,MAAM,cAAc,CAAC;GACtC,aAAa,KAAK,MAAM,eAAe,CAAC;GACxC,cAAc,KAAK,MAAM,gBAAgB,CAAC;EAC5C;EACA,OAAO;GACL,MAAM,KAAK,OAAO,QAAQ,CAAC;GAC3B,SAAS,IAAI,OAAO,WAAW,CAAC;GAChC,WAAW,IAAI,OAAO,aAAa,GAAG,GAAG;GACzC,wBAAwB,IAAI,OAAO,0BAA0B,CAAC;GAC9D,WAAW,IAAI,OAAO,aAAa,GAAG,GAAG;GACzC,aAAa,IAAI,OAAO,eAAe,GAAG,GAAG;GAC7C,iBAAiB,KAAK,OAAO,mBAAmB,CAAC;EACnD;CACF;AACF;;AAGA,SAAgB,cAAc,UAA6B;CACzD,IAAI,CAAC,SAAS,QAAQ,GACpB,MAAM,IAAI,cAAc,mCAAmC;CAE7D,MAAM,UAAU,IAAI,UAAU,oBAAoB,UAAU;CAC5D,IAAI,YAAY,KACd,MAAM,IAAI,cAAc,iCAAiC,QAAQ,EAAE;CAErE,MAAM,UAAU,IAAI,UAAU,WAAW,UAAU;CACnD,OAAO;EACL,kBAAkB;EAClB,SAAS;GACP,MAAM,IAAI,SAAS,QAAQ,kBAAkB;GAC7C,SAAS,IAAI,SAAS,WAAW,kBAAkB;EACrD;EACA,WAAW,QAAQ,UAAU,aAAa,UAAU,CAAC,CAAC,KAAK,GAAG,MAC5D,cAAc,GAAG,aAAa,EAAE,EAAE,CACpC;CACF;AACF;;;;;AAMA,SAAgB,aACd,UACA,MACA,YACsB;CACtB,MAAM,QAAQ,MACZ,OAAO,SAAS,EAAE,YAAY,MAAM,CAAC,GAAG,EAAE,KAAK;CACjD,IAAI;CACJ,KAAK,MAAM,KAAK,SAAS,WACvB,IACE,EAAE,SAAS,SACV,eAAe,KAAA,KAAa,EAAE,gBAAgB,aAE3C;MAAA,SAAS,KAAA,KAAa,KAAK,CAAC,IAAI,KAAK,IAAI,GAC3C,OAAO;CAAA;CAIb,OAAO;AACT;;AAGA,SAAgB,uBACd,SACA,YACQ;CACR,MAAM,UAAU,SAAS,OAAO,IAAI,QAAQ,aAAa,KAAA;CACzD,KAAK,MAAM,SAAS,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,GAAG;EACzD,MAAM,QAAQ,SAAS,KAAK,IAAI,MAAM,iBAAiB,KAAA;EACvD,KAAK,MAAM,QAAQ,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,GACjD,IACE,SAAS,IAAI,KACb,KAAK,eAAA,2DACL,OAAO,KAAK,YAAY,UACxB;GACA,MAAM,MAAM,IAAI,IAAI,KAAK,SAAS,UAAU;GAC5C,IAAI,IAAI,WAAW,IAAI,IAAI,UAAU,CAAC,CAAC,QAErC,MAAM,IAAI,cACR,6CAA6C,IAAI,OAAO,8BAC1D;GAEF,OAAO,IAAI;EACb;CAEJ;CACA,MAAM,IAAI,cACR,wDAAwD,SAC1D;AACF;;;;;AASA,eAAsB,aACpB,SACA,SACA,aACmB;CACnB,IAAI,MAAM;CACV,IAAI,QAAQ,KAAA,GAAW;EACrB,MAAM,aAAa,IAAI,IAAI,cAAc,OAAO,CAAC,CAAC;EAClD,MAAM,uBAAuB,MAAM,QAAQ,YAAY,IAAI,GAAG,UAAU;CAC1E;CACA,OAAO,cAAc,MAAM,QAAQ,KAAK,KAAK,CAAC;AAChD;;;;;;;ACjZA,MAAM,mBAAmB;;AA8BzB,SAAgB,MAAM,MAAsB;CAC1C,OAAO,mBAAmB,IAAI,CAAC,CAAC,QAC9B,aACC,MAAM,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,YAAY,GACtD;AACF;;AAGA,SAAgB,aACd,OACQ;CACR,OAAO,MAAM,KAAK,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG;AAClE;AAEA,SAAS,eAAe,OAAiC;CACvD,IAAI,OAAO,MAAM,MAAM,QAAQ,CAAC,GAC9B;CAEF,MAAM,MAAM,MAAM,YAAY;CAC9B,IAAI,IAAI,WAAW,IACjB;CAEF,MAAM,SAAS,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,OAAO,EAAE;CAClD,OAAO,WAAW,KACd,GAAG,IAAI,MAAM,GAAG,EAAE,EAAE,KACpB,GAAG,IAAI,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO;AACpC;AAEA,SAAS,WAAW,OAAmC;CACrD,IAAI,CAAC,sBAAsB,KAAK,KAAK,GACnC;CAEF,MAAM,yBAAS,IAAI,KAAK,GAAG,MAAM,WAAW;CAC5C,OAAO,OAAO,MAAM,OAAO,QAAQ,CAAC,KAClC,OAAO,YAAY,CAAC,CAAC,MAAM,GAAG,EAAE,MAAM,QACpC,KAAA,IACA;AACN;AAEA,SAAS,WAAW,MAAc,OAAoC;CACpE,QAAQ,MAAR;EACE,KAAK,WACH,OAAO,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,IAC1D,OAAO,KAAK,IACZ,KAAA;EACN,KAAK,UACH,OAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IACrD,OAAO,KAAK,IACZ,KAAA;EACN,KAAK,WACH,OAAO,OAAO,UAAU,YAAY,OAAO,KAAK,IAAI,KAAA;EACtD,KAAK,QACH,OAAO,OAAO,UAAU,WAAW,WAAW,KAAK,IAAI,KAAA;EACzD,KAAK,YACH,OAAO,iBAAiB,OAAO,eAAe,KAAK,IAAI,KAAA;EACzD,SACE,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAA;CAC/C;AACF;;;;;;AAOA,SAAgB,aAAa,OAAmB,OAAwB;CACtE,MAAM,OAAO,WAAW,MAAM,YAAY,KAAK;CAC/C,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,kBACR,UAAU,MAAM,KAAK,KAAK,MAAM,WAAW,gBAAgB,OAAO,KAAK,GACzE;CAEF,IACE,MAAM,eAAe,UACrB,MAAM,YAAY,QAClB,CAAC,MAAM,QAAQ,SAAS,IAAI,GAE5B,MAAM,IAAI,kBACR,UAAU,MAAM,KAAK,iBAAiB,KAAK,UAAU,MAAM,OAAO,EAAE,SAAS,KAAK,EACpF;CAEF,OAAO;AACT;AAEA,SAAS,WACP,OACA,IACA,OACkB;CAClB,MAAM,MAAM,OAAO,OAAO,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI;CACzD,IAAI,OAAO,MAAM;EACf,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAC5C,MAAM,IAAI,kBAAkB,IAAI,IAAI,0BAA0B;EAEhE,MAAM,QAAQ,MAAM,KAAK,SAAkB,aAAa,OAAO,IAAI,CAAC;EACpE,IAAI,MAAM,MAAM,SAAS,KAAK,SAAS,GAAG,CAAC,GACzC,MAAM,IAAI,kBACR,IAAI,IAAI,sDACV;EAEF,OAAO,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC;CACzC;CACA,MAAM,OAAO,aAAa,OAAO,KAAK;CACtC,IAAI,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,SAAS,kBACvC,MAAM,IAAI,kBACR,IAAI,IAAI,2BAA2B,iBAAiB,YACtD;CAEF,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC;AAC1B;AAEA,MAAM,WAAW,GAAW,MAAuB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI;AAE5E,SAAS,YACP,QACA,SACoB;CACpB,MAAM,yBAAS,IAAI,IAGjB;CACF,KAAK,MAAM,CAAC,QAAQ,UAAU,OAAO,QAAQ,OAAO,GAAG;EACrD,MAAM,KAAK,OAAO,YAAY,IAAI;EAClC,MAAM,OAAO,KAAK,IAAI,SAAS,OAAO,MAAM,GAAG,EAAE;EACjD,MAAM,KAAK,KAAK,IAAI,OAAO,OAAO,MAAM,KAAK,CAAC;EAC9C,MAAM,QAAQ,OAAO,IAAI,IAAI;EAC7B,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,kBAAkB,yBAAyB,KAAK,EAAE;EAE9D,IAAI,CAAC,MAAM,WAAW,SAAS,EAAE,GAC/B,MAAM,IAAI,kBACR,UAAU,KAAK,0BAA0B,GAAG,WAC9C;EAEF,IAAI,SAAS,QAAQ,OAAO,MAC1B,MAAM,IAAI,kBACR,oDACF;EAEF,MAAM,KAAK,GAAG,KAAK,QAAQ;EAC3B,IAAI,OAAO,IAAI,EAAE,GACf,MAAM,IAAI,kBAAkB,WAAW,KAAK,KAAK,GAAG,cAAc;EAEpE,OAAO,IAAI,IAAI;GAAE;GAAM;GAAI,MAAM,WAAW,OAAO,IAAI,KAAK;EAAE,CAAC;CACjE;CACA,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC,CACxB,MAAM,GAAG,MAAM,QAAQ,EAAE,MAAM,EAAE,IAAI,KAAK,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAC9D,KAAK,UAAU,MAAM,IAAI;AAC9B;AAEA,SAAS,UACP,QACA,MACQ;CAER,MAAM,OADQ,OAAO,SAAS,WAAW,KAAK,MAAM,GAAG,IAAI,KAAA,CACzC,KAAK,SAAS;EAC9B,MAAM,OAAO,KAAK,WAAW,GAAG,IAAI,KAAK,MAAM,CAAC,IAAI;EACpD,MAAM,QAAQ,OAAO,IAAI,IAAI;EAC7B,IAAI,UAAU,KAAA,KAAa,CAAC,MAAM,UAChC,MAAM,IAAI,kBAAkB,mBAAmB,KAAK,EAAE;EAExD,OAAO,MAAM,IAAI;CACnB,CAAC;CACD,IAAI,IAAI,WAAW,GACjB,MAAM,IAAI,kBAAkB,eAAe;CAE7C,OAAO,IAAI,KAAK,GAAG;AACrB;AAEA,SAAS,OAAO,MAAc,OAAgB,SAAyB;CACrE,IACE,OAAO,UAAU,YACjB,CAAC,OAAO,cAAc,KAAK,KAC3B,QAAQ,SAER,MAAM,IAAI,kBAAkB,GAAG,KAAK,yBAAyB,SAAS;CAExE,OAAO,OAAO,KAAK;AACrB;;;;;;;;;AAUA,SAAgB,WACd,QACA,SAAsB,CAAC,GACf;CACR,MAAM,SAAS,IAAI,IAAI,OAAO,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD,MAAM,QAAkB,CAAC;CACzB,IAAI,OAAO,aAAa,KAAA,GACtB,MAAM,KAAK,MAAM,OAAO,YAAY,OAAO,UAAU,CAAC,GAAG;CAE3D,KAAK,MAAM,CAAC,KAAK,UAAU,YAAY,QAAQ,OAAO,WAAW,CAAC,CAAC,GACjE,MAAM,KAAK,GAAG,MAAM,GAAG,EAAE,GAAG,OAAO;CAErC,IAAI,OAAO,SAAS,KAAA,GAClB,MAAM,KACJ,GAAG,MAAM,OAAO,aAAa,MAAM,EAAE,GAAG,UAAU,QAAQ,OAAO,IAAI,GACvE;CAEF,IAAI,OAAO,SAAS,KAAA,GAClB,MAAM,KACJ,GAAG,MAAM,OAAO,aAAa,MAAM,EAAE,GAAG,OAAO,QAAQ,OAAO,MAAM,CAAC,GACvE;CAEF,IAAI,OAAO,UAAU,KAAA,GAAW;EAC9B,MAAM,OAAO,OAAO,SAAS,OAAO,OAAO,CAAC;EAC5C,IAAI,OAAO,aAAa,KAAA,KAAa,OAAO,QAAQ,OAAO,UACzD,MAAM,IAAI,kBACR,SAAS,OAAO,MAAM,8BAA8B,OAAO,UAC7D;EAEF,MAAM,KAAK,GAAG,MAAM,OAAO,cAAc,OAAO,EAAE,GAAG,MAAM;CAC7D;CACA,IAAI,OAAO,oBAAoB,KAAA,GAC7B,MAAM,KAAK,oBAAoB,OAAO,iBAAiB;CAEzD,IAAI,OAAO,uBAAuB,KAAA,GAChC,MAAM,KAAK,uBAAuB,OAAO,oBAAoB;CAE/D,OAAO,MAAM,KAAK,GAAG;AACvB;;;;ACtLA,MAAM,WAAW,MAAc,SAC7B,IAAI,IAAI,MAAM,IAAI,CAAC,CAAC;;AAGtB,IAAM,OAAN,MAAW;CACT;CACA;CAEA,YAAY,SAAiB,UAAoB;EAC/C,KAAK,WAAW;EAChB,KAAK,WAAW;CAClB;CAEA,MACE,QACA,IACA,MACA,QAAQ,IACR,QAII,CAAC,GACC;EAGN,OAAO;GACL;GACA,KAHA,QAAQ,KAAK,UAAU,IAAI,KAAK,UAAU,KAAK,KAAK,IAAI;GAIxD;GACA,UAAU,KAAK,SAAS;GACxB,UAAU,MAAM;GAChB,YAAY,KAAK,SAAS;GAC1B,GAAI,MAAM,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;GACvD,GAAI,MAAM,YAAY,KAAA,IAClB,CAAC,IACD,EAAE,SAAS,EAAE,YAAY,MAAM,QAAQ,EAAE;EAC/C;CACF;CAEA,OAAO,SAAsB,CAAC,GAAW;EACvC,MAAM,SAAS,KAAK,SAAS;EAC7B,OAAO,WAAW,KAAK,SAAS,QAAQ;GACtC,UAAU,OAAO;GACjB,WAAW,OAAO;GAClB,YAAY,OAAO;GACnB,WAAW,OAAO;GAClB,GAAG;EACL,CAAC;CACH;CAEA,SAAS,KAAa,WAA4B;EAChD,MAAM,OAAO,KAAK,SAAS,MAAM;EACjC,IAAI,CAAC,aAAa,SAAS,KAAA,GACzB,MAAM,IAAI,gBACR,aAAa,KAAK,SAAS,KAAK,qBAAqB,KACvD;EAEF,OAAO;CACT;CAEA,MAAM,WAAoB,MAAoB;EAC5C,IAAI,CAAC,WACH,MAAM,IAAI,gBACR,aAAa,KAAK,SAAS,KAAK,qBAAqB,MACvD;CAEJ;CAEA,aAAa,SAA0B;EACrC,IAAI,OAAO,KAAK,OAAO,CAAC,CAAC,WAAW,GAClC,MAAM,IAAI,kBAAkB,4CAA4C;EAE1E,OAAO,KAAK,OAAO,EAAE,QAAQ,CAAC;CAChC;CAEA,IAAI,QAAgB;EAClB,OAAO,KAAK,SAAS;CACvB;CAEA,YAAoB;EAClB,MAAM,SAAS,KAAK,SAAS,aAAa;EAC1C,IAAI,WAAW,MACb,MAAM,IAAI,gBACR,aAAa,KAAK,SAAS,KAAK,0BAClC;EAEF,OAAO,QAAQ,KAAK,UAAU,OAAO,IAAI;CAC3C;CAEA,KAAK,GAAsB;EACzB,MAAM,QAAQ,KAAK,OAAO;GACxB,SAAS,EAAE;GACX,MAAM,EAAE;GACR,MAAM,EAAE;GACR,OAAO,EAAE;GACT,iBAAiB,EAAE;GACnB,oBAAoB,EAAE;EACxB,CAAC;EACD,OAAO,KAAK,MAAM,OAAO,QAAQ,KAAK,OAAO,KAAK;CACpD;CAEA,IAAI,IAAkB;EACpB,OAAO,KAAK,MACV,OACA,UACA,KAAK,OACL,KAAK,OAAO,EAAE,UAAU,GAAG,CAAC,GAC5B,EACE,UAAU,GACZ,CACF;CACF;CAEA,OAAO,MAAqB;EAC1B,OAAO,KAAK,MAAM,QAAQ,UAAU,KAAK,OAAO,IAAI,EAAE,MAAM,KAAK,CAAC;CACpE;CAEA,OAAO,IAAY,MAAe,SAAmC;EACnE,OAAO,KAAK,MACV,SACA,UACA,KAAK,OACL,KAAK,OAAO,EAAE,UAAU,GAAG,CAAC,GAC5B;GACE,UAAU;GACV,MAAM;GACN;EACF,CACF;CACF;CAEA,WAAW,SAAkB,MAAqB;EAChD,KAAK,MAAM,KAAK,SAAS,aAAa,aAAa,aAAa;EAChE,OAAO,KAAK,MACV,SACA,eACA,KAAK,OACL,KAAK,aAAa,OAAO,GACzB,EACE,MAAM,KACR,CACF;CACF;CAEA,OAAO,IAAY,SAAmC;EACpD,OAAO,KAAK,MACV,UACA,UACA,KAAK,OACL,KAAK,OAAO,EAAE,UAAU,GAAG,CAAC,GAC5B;GACE,UAAU;GACV;EACF,CACF;CACF;CAEA,WAAW,SAAwB;EACjC,KAAK,MAAM,KAAK,SAAS,aAAa,aAAa,aAAa;EAChE,OAAO,KAAK,MACV,UACA,eACA,KAAK,OACL,KAAK,aAAa,OAAO,CAC3B;CACF;CAEA,QAAQ,IAAwB,SAAoC;EAClE,MAAM,OAAO,KAAK,SAChB,WACA,KAAK,SAAS,aAAa,eAC7B;EACA,IAAK,OAAO,KAAA,OAAgB,YAAY,KAAA,IACtC,MAAM,IAAI,kBACR,6CACF;EAEF,MAAM,QACJ,YAAY,KAAA,IACR,KAAK,OAAO,EAAE,UAAU,GAAG,CAAC,IAC5B,KAAK,aAAa,OAAO;EAC/B,OAAO,KAAK,MAAM,QAAQ,WAAW,MAAM,OAAO,EAAE,UAAU,GAAG,CAAC;CACpE;CAEA,MAAM,GAAuB;EAC3B,MAAM,OAAO,KAAK,SAAS,SAAS,KAAK,SAAS,aAAa,KAAK;EACpE,MAAM,QACJ,EAAE,WAAW,KAAA,IAAY,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC;EACrD,IAAI,EAAE,oBAAoB,KAAA,GACxB,MAAM,KAAK,CAAC,oBAAoB,OAAO,EAAE,eAAe,CAAC,CAAC;EAE5D,IAAI,EAAE,uBAAuB,KAAA,GAC3B,MAAM,KAAK,CAAC,uBAAuB,OAAO,EAAE,kBAAkB,CAAC,CAAC;EAElE,OAAO,KAAK,MAAM,OAAO,SAAS,MAAM,aAAa,KAAK,CAAC;CAC7D;CAEA,QAAQ,GAAyB;EAC/B,MAAM,OAAO,KAAK,SAAS,WAAW,KAAK,SAAS,aAAa,OAAO;EACxE,MAAM,QAA4B,CAAC;EACnC,IAAI,EAAE,UAAU,KAAA,GAAW;GACzB,MAAM,OAAO,KAAK,SAAS,OAAO,MAAM,MAAM,EAAE,SAAS,EAAE,KAAK;GAChE,IAAI,SAAS,KAAA,KAAa,CAAC,KAAK,SAC9B,MAAM,IAAI,kBACR,mBAAmB,EAAE,MAAM,uBAC7B;GAEF,MAAM,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC;EAC/B;EACA,IAAI,EAAE,YAAY,KAAA,GAAW;GAC3B,IAAI,CAAC,OAAO,cAAc,EAAE,OAAO,KAAK,EAAE,UAAU,GAClD,MAAM,IAAI,kBAAkB,iCAAiC;GAE/D,MAAM,KAAK,CAAC,WAAW,OAAO,EAAE,OAAO,CAAC,CAAC;EAC3C;EACA,IAAI,EAAE,WAAW,KAAA,GACf,MAAM,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC;EAEjC,OAAO,KAAK,MAAM,OAAO,WAAW,MAAM,aAAa,KAAK,CAAC;CAC/D;CAEA,MAAM,IAAkB;EACtB,MAAM,OAAO,KAAK,SAAS,SAAS,KAAK,SAAS,aAAa,KAAK;EACpE,OAAO,KAAK,MAAM,QAAQ,SAAS,MAAM,KAAK,OAAO,EAAE,UAAU,GAAG,CAAC,GAAG,EACtE,UAAU,GACZ,CAAC;CACH;CAEA,MAAM,MAAqB;EACzB,MAAM,OAAO,KAAK,SAChB,SACA,KAAK,SAAS,aAAa,aAC7B;EACA,OAAO,KAAK,MAAM,QAAQ,SAAS,MAAM,IAAI,EAAE,MAAM,KAAK,CAAC;CAC7D;CAEA,QAAQ,IAAkB;EACxB,MAAM,OAAO,KAAK,SAChB,WACA,KAAK,SAAS,aAAa,aAC7B;EACA,OAAO,KAAK,MAAM,QAAQ,WAAW,MAAM,KAAK,OAAO,EAAE,UAAU,GAAG,CAAC,GAAG,EACxE,UAAU,GACZ,CAAC;CACH;CAEA,UAAgB;EACd,OAAO,KAAK,MAAM,OAAO,WAAW,KAAK,SAAS,WAAW,IAAI,CAAC;CACpE;CAEA,UAAU,IAAkB;EAC1B,MAAM,OAAO,KAAK,SAChB,aACA,KAAK,SAAS,aAAa,SAC7B;EACA,OAAO,KAAK,MAAM,OAAO,aAAa,MAAM,KAAK,OAAO,EAAE,UAAU,GAAG,CAAC,GAAG,EACzE,UAAU,GACZ,CAAC;CACH;AACF;;;;;;AAOA,IAAa,iBAAb,MAIE;;CAEA;CACA;CACA;;CAGA,YAAY,SAAiB,UAAoB,WAAsB;EACrE,KAAK,WAAW;EAChB,KAAK,QAAQ,IAAI,KAAK,SAAS,QAAQ;EACvC,KAAK,aAAa;CACpB;CAEA,MAAM,KAAQ,MAAY,SAAqC;EAC7D,OAAQ,MAAM,KAAK,WAAW,KAAK,MAAM,QAAQ,MAAM;CACzD;;CAGA,MAAM,KAAK,UAAuB,CAAC,GAAoB;EACrD,OAAO,KAAK,KAAK,KAAK,MAAM,KAAK,OAAO,GAAG,OAAO;CACpD;;CAGA,OAAO,QACL,UAAuB,CAAC,GACe;EACvC,MAAM,OAAO,QAAQ,SAAS,KAAK,SAAS,WAAW;EACvD,IAAI,OAAO,QAAQ,QAAQ;EAC3B,SAAS;GACP,MAAM,OAAO,MAAM,KAAK,KAAK;IAAE,GAAG;IAAS;IAAM,OAAO;GAAK,CAAC;GAC9D,OAAO;GACP,IAAI,KAAK,SAAS,MAChB;GAEF,QAAQ;EACV;CACF;;CAGA,MAAM,IAAI,IAAY,UAA0B,CAAC,GAAkB;EACjE,OAAO,KAAK,KAAK,KAAK,MAAM,IAAI,EAAE,GAAG,OAAO;CAC9C;;CAGA,MAAM,OAAO,MAAc,UAA0B,CAAC,GAAkB;EACtE,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,IAAI,GAAG,OAAO;CACnD;;CAGA,MAAM,OACJ,IACA,MACA,UAAwB,CAAC,GACV;EACf,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,IAAI,MAAM,QAAQ,OAAO,GAAG,OAAO;CACxE;;CAGA,MAAM,WACJ,SACA,MACA,UAA0B,CAAC,GACN;EACrB,OAAO,KAAK,KAAK,KAAK,MAAM,WAAW,SAAS,IAAI,GAAG,OAAO;CAChE;;CAGA,MAAM,OAAO,IAAY,UAAwB,CAAC,GAAkB;EAClE,MAAM,KAAK,WAAW,KACpB,KAAK,MAAM,OAAO,IAAI,QAAQ,OAAO,GACrC,QAAQ,MACV;CACF;;CAGA,MAAM,WACJ,SACA,UAA0B,CAAC,GACN;EACrB,OAAO,KAAK,KAAK,KAAK,MAAM,WAAW,OAAO,GAAG,OAAO;CAC1D;;CAGA,MAAM,QAAQ,SAA8C;EAC1D,OAAO,KAAK,KAAK,KAAK,MAAM,QAAQ,QAAQ,IAAI,QAAQ,OAAO,GAAG,OAAO;CAC3E;;CAGA,MAAM,MAAM,UAAwB,CAAC,GAAwB;EAC3D,OAAO,KAAK,KAAK,KAAK,MAAM,MAAM,OAAO,GAAG,OAAO;CACrD;;CAGA,MAAM,QAAQ,UAA0B,CAAC,GAAwB;EAC/D,OAAO,KAAK,KAAK,KAAK,MAAM,QAAQ,OAAO,GAAG,OAAO;CACvD;;CAGA,MAAM,MAAM,IAAY,UAA0B,CAAC,GAAkB;EACnE,OAAO,KAAK,KAAK,KAAK,MAAM,MAAM,EAAE,GAAG,OAAO;CAChD;;CAGA,MAAM,YAAY,MAAc,UAA0B,CAAC,GAAkB;EAC3E,OAAO,KAAK,KAAK,KAAK,MAAM,MAAM,IAAI,GAAG,OAAO;CAClD;;CAGA,MAAM,QAAQ,IAAY,UAA0B,CAAC,GAAkB;EACrE,OAAO,KAAK,KAAK,KAAK,MAAM,QAAQ,EAAE,GAAG,OAAO;CAClD;;CAGA,MAAM,QAAQ,UAA0B,CAAC,GAA0B;EACjE,OAAO,KAAK,KAAK,KAAK,MAAM,QAAQ,GAAG,OAAO;CAChD;;CAGA,MAAM,UACJ,IACA,UAA0B,CAAC,GACJ;EACvB,OAAO,KAAK,KAAK,KAAK,MAAM,UAAU,EAAE,GAAG,OAAO;CACpD;;CAGA,YAAoB;EAClB,OAAO,KAAK,MAAM,UAAU;CAC9B;AACF;;AAuBA,IAAa,aAAb,MAAwB;CACtB;;CAEA;CACA;CACA;CACA;CACA;CACA,6BAAsB,IAAI,IAA+B;CACzD;CAEA,YAAY,SAAwB;EAClC,KAAK,UAAU,QAAQ;EACvB,KAAK,KAAK,QAAQ,MAAM,QAAQ;EAChC,KAAK,SAAS,QAAQ;EACtB,KAAK,iBAAiB,QAAQ;EAC9B,KAAK,cAAc,CAAC,GAAI,QAAQ,cAAc,CAAC,CAAE;EACjD,KAAK,eAAe,QAAQ;EAC5B,KAAK,aAAa;GAChB,MAAM,OAAO,MAAM,WAAW;IAC5B,MAAM,WAAW,MAAM,KAAK,MAAM,MAAM,MAAM;IAC9C,IAAI,SAAS,WAAW,KACtB;IAEF,IAAI;KACF,OAAQ,MAAM,SAAS,KAAK;IAC9B,SAAS,OAAO;KACd,MAAM,IAAI,cACR,GAAG,KAAK,OAAO,GAAG,KAAK,IAAI,QAAQ,SAAS,OAAO,mCACnD,EAAE,OAAO,MAAM,CACjB;IACF;GACF;GACA,MAAM,OAAO,MAAM,WAAW;IAC5B,OAAO,MAAM,KAAK,MAAM,MAAM,MAAM,EAAA,CAAG,MAAM,OAAO;GACtD;EACF;CACF;;CAGA,IAAI,YAA8B;EAChC,KAAK,YAAY,KAAK,UAAU;EAChC,OAAO;CACT;CAEA,MAAM,OAAO,SAA0C;EAErD,OAAQ,MAAM,KAAK,iBAAiB,EAAE,QAAQ,CAAC,KAAM;CACvD;;CAGA,MAAM,UAAU,OAA+B;EAC7C,OAAO,KAAK,OAAO,OAAO;CAC5B;;CAGA,MAAM,QAAyB;EAC7B,OAAO,WAAW,MAAM,KAAK,OAAO,KAAK,CAAC;CAC5C;;CAGA,MAAM,YAGH;EACD,OAAO;GAAE,QAAQ,KAAK;GAAI,OAAO,MAAM,KAAK,MAAM;EAAE;CACtD;CAEA,MAAM,UACJ,MACA,OACA,QACmB;EACnB,MAAM,UAAU,IAAI,QAAQ;GAC1B,QAAQ;GACR,GAAG,KAAK;EACV,CAAC;EACD,IAAI,UAAU,MACZ,QAAQ,IAAI,iBAAiB,UAAU,OAAO;EAEhD,MAAM,OAAoB;GACxB,QAAQ,KAAK;GACb;GACA,QAAQ,UAAU;EACpB;EACA,IAAI,KAAK,SAAS,KAAA,GAAW;GAC3B,QAAQ,IAAI,gBAAgB,kBAAkB;GAC9C,KAAK,OAAO,KAAK,UAAU,KAAK,IAAI;EACtC;EACA,MAAM,UAAU,IAAI,QAAQ,KAAK,KAAK,IAAI;EAC1C,MAAM,WAAW,OAAO,QAEC;GACvB,IAAI;IACF,OAAO,OAAO,KAAK,UAAU,WAAW,MAAA,CAAO,IAAI,OAAO;GAC5D,SAAS,OAAO;IACd,IAAI,IAAI,QAAQ,OAAO,SACrB,MAAM;IAER,MAAM,IAAI,iBACR,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACrD,EACE,OAAO,MACT,CACF;GACF;EACF;EACA,OAAO,kBACL,KAAK,aACL,QACF,CAAC,CAAC;GACA;GACA,UAAU,KAAK;GACf,IAAI,KAAK;GACT,UAAU,KAAK;GACf,OAAO,MAAM,WAAW,KAAK;GAC7B,YAAY,KAAK;GACjB;EACF,CAAC;CACH;;CAGA,MAAM,MAAM,MAAY,QAAoD;EAC1E,MAAM,QAAQ,MAAM,KAAK,OAAO,KAAK;EACrC,IAAI,WAAW,MAAM,KAAK,UAAU,MAAM,OAAO,MAAM;EACvD,IAAI,SAAS,WAAW,OAAO,KAAK,mBAAmB,KAAA,GAAW;GAChE,MAAM,QAAQ,MAAM,KAAK,OAAO,IAAI;GACpC,IAAI,UAAU,QAAQ,UAAU,OAAO;IACrC,MAAM,SAAS,MAAM,OAAO;IAC5B,WAAW,MAAM,KAAK,UAAU,MAAM,OAAO,MAAM;GACrD;EACF;EACA,IAAI,SAAS,UAAU,KACrB,MAAM,MAAM,oBAAoB,QAAQ;EAE1C,OAAO;CACT;CAEA,MAAM,SAAS,KAAa,SAAoC;EAC9D,MAAM,OAAa;GACjB,QAAQ;GACR;GACA,IAAI;GACJ,UAAU,KAAA;GACV,UAAU,KAAA;GACV,YAAY;GAEZ,GAAI,UAAU,EAAE,SAAS,EAAE,iBAAiB,WAAW,EAAE,IAAI,CAAC;EAChE;EACA,MAAM,WAAW,MAAM,KAAK,MAAM,MAAM,KAAA,CAAS;EACjD,IAAI;GACF,OAAQ,MAAM,SAAS,KAAK;EAC9B,SAAS,OAAO;GACd,MAAM,IAAI,cAAc,GAAG,IAAI,eAAe,EAAE,OAAO,MAAM,CAAC;EAChE;CACF;;CAGA,MAAM,SACJ,UAA0C,CAAC,GACxB;EACnB,MAAM,QAAQ,MAAM,KAAK,MAAM;EAC/B,IAAI,UAAU,KAAK,WAAW,IAAI,KAAK;EACvC,IAAI,YAAY,KAAA,KAAa,QAAQ,YAAY,MAAM;GACrD,MAAM,UAAU,cACb,KAAK,YAAY,KAAK,SAAS,KAAK,OAAO,GAC5C,KAAK,SACL,KAAK,YACP;GACA,UAAU;GACV,IAAI,CAAC,KAAK,WAAW,IAAI,KAAK,GAC5B,KAAK,WAAW,MAAM;GAExB,KAAK,WAAW,IAAI,OAAO,OAAO;GAClC,QAAQ,YAAY;IAClB,IAAI,KAAK,WAAW,IAAI,KAAK,MAAM,SACjC,KAAK,WAAW,OAAO,KAAK;GAEhC,CAAC;EACH;EACA,OAAO;CACT;;CAGA,MAAM,SAKJ,MACA,YAC+C;EAC/C,MAAM,WAAW,aAAa,MAAM,KAAK,SAAS,GAAG,MAAM,UAAU;EACrE,IAAI,aAAa,KAAA,GACf,MAAM,IAAI,qBACR,iCAAiC,KAAK,GAAG,eAAe,KAAA,IAAY,KAAK,IAAI,aAAa,iBAC5F;EAEF,OAAO,IAAI,eACT,KAAK,SACL,UACA,KAAK,UACP;CACF;AACF;;AAGA,SAAgB,aAAa,SAAoC;CAC/D,OAAO,IAAI,WAAW,OAAO;AAC/B"}
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { p as parseManifest, r as createClient, v as CrudError } from "../client-D0drumeA.mjs";
2
+ import { p as parseManifest, r as createClient, v as CrudError } from "../client-Bv0yCuwC.mjs";
3
3
  import { readFile, writeFile } from "node:fs/promises";
4
4
  //#region src/codegen/generate.ts
5
5
  /** Loads the optional peer `json-schema-to-typescript`; a clear error when it is missing. */
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
  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";
2
- 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";
2
+ 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-B8fSsx4L.mjs";
3
3
  //#region src/auth.d.ts
4
4
  /** The scope of an anonymous caller. */
5
5
  export declare const ANON = "anon";
package/dist/index.mjs CHANGED
@@ -1,3 +1,3 @@
1
- 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";
1
+ 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-Bv0yCuwC.mjs";
2
2
  import { n as cacheScope, r as staticToken, t as ANON } from "./auth-DwtNEKrw.mjs";
3
3
  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 };
@@ -1,6 +1,6 @@
1
1
  import { r as CrudEvent } from "../interfaces-s73cVfIF.mjs";
2
2
  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";
3
- import { D as JsonObject, O as Manifest, r as CrudClient, s as ResourceClient } from "../client-BLd126Jt.mjs";
3
+ import { D as JsonObject, O as Manifest, r as CrudClient, s as ResourceClient } from "../client-B8fSsx4L.mjs";
4
4
  import { DataTag, QueryClient } from "@tanstack/query-core";
5
5
  //#region src/tanstack/adapter.d.ts
6
6
  type Init = {
@@ -32,25 +32,74 @@ export declare function tanstackApi<Read extends object, Create extends object,
32
32
  /** A query object as the client's query builder takes it. */
33
33
  export type CrudQuery = Readonly<Record<string, unknown>>;
34
34
  type Key = readonly unknown[];
35
+ /**
36
+ * Who a query belongs to: the client's stable identity and the caller scope
37
+ * (`await client.namespace()`). Two clients, or two callers, that share one
38
+ * `QueryClient` never see each other's cached data.
39
+ */
40
+ export interface CrudNamespace {
41
+ readonly client: string;
42
+ readonly scope: string;
43
+ }
44
+ /** The kinds that sit at `key[4]`. */
45
+ export type CrudKind = "list" | "record" | "stats" | "predict" | "revisions";
46
+ /** Which queries a {@link CrudKeys.filter} matches; every member narrows. */
47
+ export interface CrudKeyFilter {
48
+ readonly client: string;
49
+ /** Omit for every resource of the client (including manifests). */
50
+ readonly resource?: string;
51
+ /** Omit for every caller scope. */
52
+ readonly scope?: string;
53
+ /** Skips this caller scope (every other scope matches). */
54
+ readonly exceptScope?: string;
55
+ /** Omit for every kind. */
56
+ readonly kinds?: readonly CrudKind[];
57
+ /** A record id; matches only the `record` and `revisions` keys of that record. */
58
+ readonly id?: number;
59
+ }
60
+ /** Spread into `invalidateQueries`, `removeQueries` or `cancelQueries`. */
61
+ export type CrudKeyMatcher = {
62
+ readonly queryKey: readonly unknown[];
63
+ } | {
64
+ readonly predicate: (query: {
65
+ readonly queryKey: readonly unknown[];
66
+ }) => boolean;
67
+ };
35
68
  /** The key factory type. */
36
69
  export interface CrudKeys {
37
70
  readonly all: readonly ["crud"];
38
- /** Everything of one resource. */
39
- resource(resource: string): readonly ["crud", string];
40
- /** All lists of one resource, plain and infinite. */
41
- lists(resource: string): readonly ["crud", string, "list"];
42
- list(resource: string, query?: CrudQuery): Key;
43
- infiniteList(resource: string, query: CrudQuery, limit: number): Key;
44
- /** All record queries of one resource. */
45
- records(resource: string): readonly ["crud", string, "record"];
46
- record(resource: string, id: number): readonly ["crud", string, "record", number];
47
- stats(resource: string, query?: CrudQuery): Key;
48
- predict(resource: string, query?: CrudQuery): Key;
49
- revisions(resource: string, id: number): readonly ["crud", string, "revisions", number];
50
- /** The manifest, optionally of one caller scope. */
51
- manifest(scope?: string): Key;
52
- }
53
- /** The key factory. Every key starts with `["crud", resource, ...]`, so prefixes invalidate by resource, kind or record. */
71
+ /** Everything of one client. */
72
+ client(client: string): readonly ["crud", string];
73
+ /** Everything of one resource on one client, every scope and kind. */
74
+ resource(client: string, resource: string): readonly ["crud", string, string];
75
+ /** All lists of one resource and scope, plain and infinite. */
76
+ lists(ns: CrudNamespace, resource: string): readonly ["crud", string, string, string, "list"];
77
+ list(ns: CrudNamespace, resource: string, query?: CrudQuery): Key;
78
+ infiniteList(ns: CrudNamespace, resource: string, query: CrudQuery, limit: number): Key;
79
+ /** All record queries of one resource and scope. */
80
+ records(ns: CrudNamespace, resource: string): readonly ["crud", string, string, string, "record"];
81
+ record(ns: CrudNamespace, resource: string, id: number): readonly ["crud", string, string, string, "record", number];
82
+ stats(ns: CrudNamespace, resource: string, query?: CrudQuery): Key;
83
+ predict(ns: CrudNamespace, resource: string, query?: CrudQuery): Key;
84
+ revisions(ns: CrudNamespace, resource: string, id: number): readonly ["crud", string, string, string, "revisions", number];
85
+ /** The manifest of one caller scope. */
86
+ manifest(ns: CrudNamespace): readonly ["crud", string, "_manifest", string];
87
+ /**
88
+ * A matcher for `invalidateQueries({ ...crudKeys.filter(f) })`. A client
89
+ * or resource filter is one key prefix; narrowing by scope, kind or id
90
+ * (which sit after the resource) uses a predicate.
91
+ */
92
+ filter(filter: CrudKeyFilter): CrudKeyMatcher;
93
+ }
94
+ /**
95
+ * The key factory. Keys are
96
+ * `["crud", client, resource, scope, kind, ...]` (the manifest is
97
+ * `["crud", client, "_manifest", scope]`), so a prefix invalidates by client
98
+ * or by resource on one client; `resource` is the manifest name, or
99
+ * `name@apiVersion` for a pinned version (a different string is a different
100
+ * resource: pass the same one to the invalidate helpers). `_manifest` is
101
+ * reserved; a scope-only filter also matches the scope's manifest.
102
+ */
54
103
  export declare const crudKeys: CrudKeys;
55
104
  /** What a query function receives from TanStack Query (a subset). */
56
105
  export interface QueryContext {
@@ -121,12 +170,12 @@ export interface UpdateApi<T, P> {
121
170
  export interface DeleteApi {
122
171
  delete(id: number): Promise<unknown>;
123
172
  }
124
- export declare function listOptions<T>(resource: string, api: ListApi<T>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<T[]>;
125
- export declare function recordOptions<T>(resource: string, api: RecordApi<T>, id: number, init?: QueryOptionsInit): CrudQueryOptions<T>;
126
- export declare function statsOptions<S>(resource: string, api: StatsApi<S>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<S>;
127
- export declare function predictOptions<P>(resource: string, api: PredictApi<P>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<P>;
128
- export declare function revisionsOptions<R>(resource: string, api: RevisionsApi<R>, id: number, init?: QueryOptionsInit): CrudQueryOptions<R[]>;
129
- export declare function manifestOptions<M>(api: ManifestApi<M>, scope?: string, init?: QueryOptionsInit): CrudQueryOptions<M>;
173
+ export declare function listOptions<T>(ns: CrudNamespace, resource: string, api: ListApi<T>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<T[]>;
174
+ export declare function recordOptions<T>(ns: CrudNamespace, resource: string, api: RecordApi<T>, id: number, init?: QueryOptionsInit): CrudQueryOptions<T>;
175
+ export declare function statsOptions<S>(ns: CrudNamespace, resource: string, api: StatsApi<S>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<S>;
176
+ export declare function predictOptions<P>(ns: CrudNamespace, resource: string, api: PredictApi<P>, query?: CrudQuery, init?: QueryOptionsInit): CrudQueryOptions<P>;
177
+ export declare function revisionsOptions<R>(ns: CrudNamespace, resource: string, api: RevisionsApi<R>, id: number, init?: QueryOptionsInit): CrudQueryOptions<R[]>;
178
+ export declare function manifestOptions<M>(ns: CrudNamespace, api: ManifestApi<M>, init?: QueryOptionsInit): CrudQueryOptions<M>;
130
179
  export interface InfiniteListInit extends QueryOptionsInit {
131
180
  /** Page size; default 100 (the server's default). */
132
181
  readonly limit?: number;
@@ -140,25 +189,39 @@ export interface InfiniteListInit extends QueryOptionsInit {
140
189
  readonly limitKey?: string;
141
190
  }
142
191
  /** Offset paging: the next page starts at `skip + limit`, unless the last page was short. */
143
- export declare function infiniteListOptions<T>(resource: string, api: ListApi<T>, query?: CrudQuery, init?: InfiniteListInit): CrudInfiniteQueryOptions<T>;
192
+ export declare function infiniteListOptions<T>(ns: CrudNamespace, resource: string, api: ListApi<T>, query?: CrudQuery, init?: InfiniteListInit): CrudInfiniteQueryOptions<T>;
144
193
  export type Invalidator = Pick<QueryClient, "invalidateQueries" | "removeQueries" | "setQueryData">;
194
+ /** One resource of one client; `resource` is the string used in its keys. */
195
+ export interface CrudTarget {
196
+ readonly client: string;
197
+ readonly resource: string;
198
+ }
199
+ /**
200
+ * Invalidates the list, stats and predict queries of `resource` on `client`,
201
+ * for every caller scope (a write changes what every caller sees).
202
+ */
203
+ export declare function invalidateCollections(queryClient: Pick<QueryClient, "invalidateQueries">, { client, resource }: CrudTarget): Promise<void>;
204
+ /** Invalidates everything cached for `resource` on `client`: one key prefix. */
205
+ export declare function invalidateResource(queryClient: Pick<QueryClient, "invalidateQueries">, { client, resource }: CrudTarget): Promise<void>;
206
+ /** Invalidates one record's `record` and `revisions` queries, for every scope. */
207
+ export declare function invalidateRecord(queryClient: Pick<QueryClient, "invalidateQueries">, { client, resource }: CrudTarget, id: number): Promise<void>;
145
208
  export interface CreateMutationOptions<T, C> {
146
- readonly mutationKey: readonly ["crud", string, "create"];
209
+ readonly mutationKey: readonly ["crud", string, string, string, "create"];
147
210
  readonly mutationFn: (body: C) => Promise<T>;
148
211
  readonly onSuccess: () => Promise<void>;
149
212
  }
150
213
  export interface UpdateMutationOptions<T, P> {
151
- readonly mutationKey: readonly ["crud", string, "update"];
214
+ readonly mutationKey: readonly ["crud", string, string, string, "update"];
152
215
  readonly mutationFn: (variables: UpdateVariables<P>) => Promise<T>;
153
216
  readonly onSuccess: (record: T, variables: UpdateVariables<P>) => Promise<void>;
154
217
  }
155
218
  export interface DeleteMutationOptions {
156
- readonly mutationKey: readonly ["crud", string, "delete"];
219
+ readonly mutationKey: readonly ["crud", string, string, string, "delete"];
157
220
  readonly mutationFn: (id: number) => Promise<unknown>;
158
221
  readonly onSuccess: (result: unknown, id: number) => Promise<void>;
159
222
  }
160
223
  /** Create: invalidate lists, stats and predict. */
161
- export declare function createMutationOptions<T, C>(client: Invalidator, resource: string, api: CreateApi<T, C>): CreateMutationOptions<T, C>;
224
+ export declare function createMutationOptions<T, C>(queryClient: Invalidator, ns: CrudNamespace, resource: string, api: CreateApi<T, C>): CreateMutationOptions<T, C>;
162
225
  export interface UpdateVariables<P> {
163
226
  readonly id: number;
164
227
  readonly patch: P;
@@ -166,9 +229,9 @@ export interface UpdateVariables<P> {
166
229
  readonly ifMatch?: string;
167
230
  }
168
231
  /** Update: `setQueryData` from the PATCH response, invalidate lists, stats, predict and revisions. */
169
- export declare function updateMutationOptions<T, P>(client: Invalidator, resource: string, api: UpdateApi<T, P>): UpdateMutationOptions<T, P>;
232
+ export declare function updateMutationOptions<T, P>(queryClient: Invalidator, ns: CrudNamespace, resource: string, api: UpdateApi<T, P>): UpdateMutationOptions<T, P>;
170
233
  /** Delete: drop the record query, invalidate lists, stats, predict and revisions. */
171
- export declare function deleteMutationOptions(client: Invalidator, resource: string, api: DeleteApi): DeleteMutationOptions;
234
+ export declare function deleteMutationOptions(queryClient: Invalidator, ns: CrudNamespace, resource: string, api: DeleteApi): DeleteMutationOptions;
172
235
  /**
173
236
  * Invalidate TanStack queries from the resource's event stream. Events
174
237
  * invalidate and never apply snapshots: `create` invalidates lists, stats and
@@ -176,7 +239,7 @@ export declare function deleteMutationOptions(client: Invalidator, resource: str
176
239
  * reconnect (or an event with no usable record id) invalidates the resource.
177
240
  * Returns the unsubscribe.
178
241
  */
179
- export declare function bridgeEvents(client: Pick<QueryClient, "invalidateQueries">, hub: EventHub, resource: string): () => void;
242
+ export declare function bridgeEvents(queryClient: Pick<QueryClient, "invalidateQueries">, hub: EventHub, target: CrudTarget): () => void;
180
243
  //#endregion
181
244
  export { type CachePolicy, type CrudEvent, type EventHandlers, type EventHub, type EventHubOptions, type EventsConfig, type ManifestCacheHints, type SubscribeEventsOptions, type TanstackApi, getEventHub, subscribeEvents, tanstackCachePolicy };
182
245
  //# sourceMappingURL=index.d.mts.map
@@ -29,117 +29,145 @@ function tanstackApi(client, resource) {
29
29
  }
30
30
  //#endregion
31
31
  //#region src/tanstack/index.ts
32
- /** The key factory. Every key starts with `["crud", resource, ...]`, so prefixes invalidate by resource, kind or record. */
32
+ /**
33
+ * The key factory. Keys are
34
+ * `["crud", client, resource, scope, kind, ...]` (the manifest is
35
+ * `["crud", client, "_manifest", scope]`), so a prefix invalidates by client
36
+ * or by resource on one client; `resource` is the manifest name, or
37
+ * `name@apiVersion` for a pinned version (a different string is a different
38
+ * resource: pass the same one to the invalidate helpers). `_manifest` is
39
+ * reserved; a scope-only filter also matches the scope's manifest.
40
+ */
33
41
  const crudKeys = {
34
42
  all: ["crud"],
35
- resource: (resource) => ["crud", resource],
36
- lists: (resource) => [
43
+ client: (client) => ["crud", client],
44
+ resource: (client, resource) => [
45
+ "crud",
46
+ client,
47
+ resource
48
+ ],
49
+ lists: (ns, resource) => [
37
50
  "crud",
51
+ ns.client,
38
52
  resource,
53
+ ns.scope,
39
54
  "list"
40
55
  ],
41
- list: (resource, query) => query === void 0 ? crudKeys.lists(resource) : [...crudKeys.lists(resource), query],
42
- infiniteList: (resource, query, limit) => [
43
- ...crudKeys.lists(resource),
56
+ list: (ns, resource, query) => query === void 0 ? crudKeys.lists(ns, resource) : [...crudKeys.lists(ns, resource), query],
57
+ infiniteList: (ns, resource, query, limit) => [
58
+ ...crudKeys.lists(ns, resource),
44
59
  "infinite",
45
60
  query,
46
61
  limit
47
62
  ],
48
- records: (resource) => [
63
+ records: (ns, resource) => [
49
64
  "crud",
65
+ ns.client,
50
66
  resource,
67
+ ns.scope,
51
68
  "record"
52
69
  ],
53
- record: (resource, id) => [
54
- "crud",
55
- resource,
56
- "record",
57
- id
58
- ],
59
- stats: (resource, query) => query === void 0 ? [
70
+ record: (ns, resource, id) => [...crudKeys.records(ns, resource), id],
71
+ stats: (ns, resource, query) => query === void 0 ? [
60
72
  "crud",
73
+ ns.client,
61
74
  resource,
75
+ ns.scope,
62
76
  "stats"
63
77
  ] : [
64
78
  "crud",
79
+ ns.client,
65
80
  resource,
81
+ ns.scope,
66
82
  "stats",
67
83
  query
68
84
  ],
69
- predict: (resource, query) => query === void 0 ? [
85
+ predict: (ns, resource, query) => query === void 0 ? [
70
86
  "crud",
87
+ ns.client,
71
88
  resource,
89
+ ns.scope,
72
90
  "predict"
73
91
  ] : [
74
92
  "crud",
93
+ ns.client,
75
94
  resource,
95
+ ns.scope,
76
96
  "predict",
77
97
  query
78
98
  ],
79
- revisions: (resource, id) => [
99
+ revisions: (ns, resource, id) => [
80
100
  "crud",
101
+ ns.client,
81
102
  resource,
103
+ ns.scope,
82
104
  "revisions",
83
105
  id
84
106
  ],
85
- manifest: (scope) => scope === void 0 ? ["crud", "_manifest"] : [
107
+ manifest: (ns) => [
86
108
  "crud",
109
+ ns.client,
87
110
  "_manifest",
88
- scope
89
- ]
111
+ ns.scope
112
+ ],
113
+ filter: (filter) => {
114
+ const { client, resource, scope, exceptScope, kinds, id } = filter;
115
+ if (scope === void 0 && exceptScope === void 0 && kinds === void 0 && id === void 0) return { queryKey: resource === void 0 ? crudKeys.client(client) : crudKeys.resource(client, resource) };
116
+ return { predicate: ({ queryKey: key }) => key[0] === "crud" && key[1] === client && (resource === void 0 || key[2] === resource) && (scope === void 0 || key[3] === scope) && (exceptScope === void 0 || key[3] !== exceptScope) && (kinds === void 0 || kinds.includes(key[4])) && (id === void 0 || (key[4] === "record" || key[4] === "revisions") && key[5] === id) };
117
+ }
90
118
  };
91
119
  function tag(key) {
92
120
  return key;
93
121
  }
94
- function listOptions(resource, api, query, init = {}) {
122
+ function listOptions(ns, resource, api, query, init = {}) {
95
123
  return {
96
- queryKey: tag(crudKeys.list(resource, query)),
124
+ queryKey: tag(crudKeys.list(ns, resource, query)),
97
125
  queryFn: ({ signal }) => api.list(query, { signal }),
98
126
  staleTime: init.staleTime ?? 0
99
127
  };
100
128
  }
101
- function recordOptions(resource, api, id, init = {}) {
129
+ function recordOptions(ns, resource, api, id, init = {}) {
102
130
  return {
103
- queryKey: tag(crudKeys.record(resource, id)),
131
+ queryKey: tag(crudKeys.record(ns, resource, id)),
104
132
  queryFn: ({ signal }) => api.get(id, { signal }),
105
133
  staleTime: init.staleTime ?? 0
106
134
  };
107
135
  }
108
- function statsOptions(resource, api, query, init = {}) {
136
+ function statsOptions(ns, resource, api, query, init = {}) {
109
137
  return {
110
- queryKey: tag(crudKeys.stats(resource, query)),
138
+ queryKey: tag(crudKeys.stats(ns, resource, query)),
111
139
  queryFn: ({ signal }) => api.stats(query, { signal }),
112
140
  staleTime: init.staleTime ?? 0
113
141
  };
114
142
  }
115
- function predictOptions(resource, api, query, init = {}) {
143
+ function predictOptions(ns, resource, api, query, init = {}) {
116
144
  return {
117
- queryKey: tag(crudKeys.predict(resource, query)),
145
+ queryKey: tag(crudKeys.predict(ns, resource, query)),
118
146
  queryFn: ({ signal }) => api.predict(query, { signal }),
119
147
  staleTime: init.staleTime ?? 0
120
148
  };
121
149
  }
122
- function revisionsOptions(resource, api, id, init = {}) {
150
+ function revisionsOptions(ns, resource, api, id, init = {}) {
123
151
  return {
124
- queryKey: tag(crudKeys.revisions(resource, id)),
152
+ queryKey: tag(crudKeys.revisions(ns, resource, id)),
125
153
  queryFn: ({ signal }) => api.revisions(id, { signal }),
126
154
  staleTime: init.staleTime ?? 0
127
155
  };
128
156
  }
129
- function manifestOptions(api, scope, init = {}) {
157
+ function manifestOptions(ns, api, init = {}) {
130
158
  return {
131
- queryKey: tag(crudKeys.manifest(scope)),
159
+ queryKey: tag(crudKeys.manifest(ns)),
132
160
  queryFn: ({ signal }) => api.manifest({ signal }),
133
161
  staleTime: init.staleTime ?? 0
134
162
  };
135
163
  }
136
164
  /** Offset paging: the next page starts at `skip + limit`, unless the last page was short. */
137
- function infiniteListOptions(resource, api, query = {}, init = {}) {
165
+ function infiniteListOptions(ns, resource, api, query = {}, init = {}) {
138
166
  const limit = init.limit ?? 100;
139
167
  const skipKey = init.skipKey ?? "skip";
140
168
  const limitKey = init.limitKey ?? "limit";
141
169
  return {
142
- queryKey: tag(crudKeys.infiniteList(resource, query, limit)),
170
+ queryKey: tag(crudKeys.infiniteList(ns, resource, query, limit)),
143
171
  queryFn: ({ signal, pageParam }) => api.list({
144
172
  ...query,
145
173
  [skipKey]: pageParam,
@@ -150,52 +178,117 @@ function infiniteListOptions(resource, api, query = {}, init = {}) {
150
178
  staleTime: init.staleTime ?? 0
151
179
  };
152
180
  }
153
- async function invalidateCollections(client, resource) {
154
- await Promise.all([
155
- client.invalidateQueries({ queryKey: crudKeys.lists(resource) }),
156
- client.invalidateQueries({ queryKey: crudKeys.stats(resource) }),
157
- client.invalidateQueries({ queryKey: crudKeys.predict(resource) })
158
- ]);
181
+ const COLLECTION_KINDS = [
182
+ "list",
183
+ "stats",
184
+ "predict"
185
+ ];
186
+ /**
187
+ * Invalidates the list, stats and predict queries of `resource` on `client`,
188
+ * for every caller scope (a write changes what every caller sees).
189
+ */
190
+ function invalidateCollections(queryClient, { client, resource }) {
191
+ return queryClient.invalidateQueries(crudKeys.filter({
192
+ client,
193
+ resource,
194
+ kinds: COLLECTION_KINDS
195
+ }));
196
+ }
197
+ /** Invalidates everything cached for `resource` on `client`: one key prefix. */
198
+ function invalidateResource(queryClient, { client, resource }) {
199
+ return queryClient.invalidateQueries(crudKeys.filter({
200
+ client,
201
+ resource
202
+ }));
203
+ }
204
+ /** Invalidates one record's `record` and `revisions` queries, for every scope. */
205
+ function invalidateRecord(queryClient, { client, resource }, id) {
206
+ return queryClient.invalidateQueries(crudKeys.filter({
207
+ client,
208
+ resource,
209
+ kinds: ["record", "revisions"],
210
+ id
211
+ }));
159
212
  }
160
213
  /** Create: invalidate lists, stats and predict. */
161
- function createMutationOptions(client, resource, api) {
214
+ function createMutationOptions(queryClient, ns, resource, api) {
162
215
  return {
163
216
  mutationKey: [
164
217
  "crud",
218
+ ns.client,
165
219
  resource,
220
+ ns.scope,
166
221
  "create"
167
222
  ],
168
223
  mutationFn: (body) => api.create(body),
169
- onSuccess: () => invalidateCollections(client, resource)
224
+ onSuccess: () => invalidateCollections(queryClient, {
225
+ client: ns.client,
226
+ resource
227
+ })
170
228
  };
171
229
  }
172
230
  /** Update: `setQueryData` from the PATCH response, invalidate lists, stats, predict and revisions. */
173
- function updateMutationOptions(client, resource, api) {
231
+ function updateMutationOptions(queryClient, ns, resource, api) {
174
232
  return {
175
233
  mutationKey: [
176
234
  "crud",
235
+ ns.client,
177
236
  resource,
237
+ ns.scope,
178
238
  "update"
179
239
  ],
180
240
  mutationFn: ({ id, patch, ifMatch }) => api.update(id, patch, ifMatch === void 0 ? {} : { ifMatch }),
181
241
  onSuccess: async (record, { id }) => {
182
- client.setQueryData(crudKeys.record(resource, id), record);
183
- await Promise.all([invalidateCollections(client, resource), client.invalidateQueries({ queryKey: crudKeys.revisions(resource, id) })]);
242
+ queryClient.setQueryData(crudKeys.record(ns, resource, id), record);
243
+ await Promise.all([
244
+ invalidateCollections(queryClient, {
245
+ client: ns.client,
246
+ resource
247
+ }),
248
+ queryClient.invalidateQueries(crudKeys.filter({
249
+ client: ns.client,
250
+ resource,
251
+ exceptScope: ns.scope,
252
+ kinds: ["record"],
253
+ id
254
+ })),
255
+ queryClient.invalidateQueries(crudKeys.filter({
256
+ client: ns.client,
257
+ resource,
258
+ kinds: ["revisions"],
259
+ id
260
+ }))
261
+ ]);
184
262
  }
185
263
  };
186
264
  }
187
265
  /** Delete: drop the record query, invalidate lists, stats, predict and revisions. */
188
- function deleteMutationOptions(client, resource, api) {
266
+ function deleteMutationOptions(queryClient, ns, resource, api) {
189
267
  return {
190
268
  mutationKey: [
191
269
  "crud",
270
+ ns.client,
192
271
  resource,
272
+ ns.scope,
193
273
  "delete"
194
274
  ],
195
275
  mutationFn: (id) => api.delete(id),
196
276
  onSuccess: async (_result, id) => {
197
- client.removeQueries({ queryKey: crudKeys.record(resource, id) });
198
- await Promise.all([invalidateCollections(client, resource), client.invalidateQueries({ queryKey: crudKeys.revisions(resource, id) })]);
277
+ queryClient.removeQueries(crudKeys.filter({
278
+ client: ns.client,
279
+ resource,
280
+ kinds: ["record"],
281
+ id
282
+ }));
283
+ await Promise.all([invalidateCollections(queryClient, {
284
+ client: ns.client,
285
+ resource
286
+ }), queryClient.invalidateQueries(crudKeys.filter({
287
+ client: ns.client,
288
+ resource,
289
+ kinds: ["revisions"],
290
+ id
291
+ }))]);
199
292
  }
200
293
  };
201
294
  }
@@ -206,21 +299,17 @@ function deleteMutationOptions(client, resource, api) {
206
299
  * reconnect (or an event with no usable record id) invalidates the resource.
207
300
  * Returns the unsubscribe.
208
301
  */
209
- function bridgeEvents(client, hub, resource) {
302
+ function bridgeEvents(queryClient, hub, target) {
210
303
  return hub.subscribe({
211
304
  onEvent: async (event) => {
212
- const pending = [
213
- client.invalidateQueries({ queryKey: crudKeys.lists(resource) }),
214
- client.invalidateQueries({ queryKey: crudKeys.stats(resource) }),
215
- client.invalidateQueries({ queryKey: crudKeys.predict(resource) })
216
- ];
217
- if (event.action !== "create") pending.push(client.invalidateQueries({ queryKey: crudKeys.record(resource, event.recordId) }), client.invalidateQueries({ queryKey: crudKeys.revisions(resource, event.recordId) }));
305
+ const pending = [invalidateCollections(queryClient, target)];
306
+ if (event.action !== "create") pending.push(invalidateRecord(queryClient, target, event.recordId));
218
307
  await Promise.all(pending);
219
308
  },
220
- onReset: () => client.invalidateQueries({ queryKey: crudKeys.resource(resource) })
309
+ onReset: () => invalidateResource(queryClient, target)
221
310
  });
222
311
  }
223
312
  //#endregion
224
- export { bridgeEvents, createMutationOptions, crudKeys, deleteMutationOptions, getEventHub, infiniteListOptions, listOptions, manifestOptions, predictOptions, recordOptions, revisionsOptions, statsOptions, subscribeEvents, tanstackApi, tanstackCachePolicy, updateMutationOptions };
313
+ export { bridgeEvents, createMutationOptions, crudKeys, deleteMutationOptions, getEventHub, infiniteListOptions, invalidateCollections, invalidateRecord, invalidateResource, listOptions, manifestOptions, predictOptions, recordOptions, revisionsOptions, statsOptions, subscribeEvents, tanstackApi, tanstackCachePolicy, updateMutationOptions };
225
314
 
226
315
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../../src/tanstack/adapter.ts","../../src/tanstack/index.ts"],"sourcesContent":["// Adapts TS1's `ResourceClient` (options-object methods) to the structural\n// slices the `./tanstack` factories take (`list(query, { signal })`, ...).\nimport type { CrudClient, ResourceClient } from \"../client.ts\";\nimport type { JsonObject, Manifest } from \"../manifest.ts\";\nimport type { CrudQuery } from \"./index.ts\";\n\ntype Init = { signal?: AbortSignal };\n\n/** What `tanstackApi` returns: every slice the factories use, bound to one resource. */\nexport interface TanstackApi<Read, Create, Update> {\n list(query: CrudQuery | undefined, init?: Init): Promise<Read[]>;\n get(id: number, init?: Init): Promise<Read>;\n stats(query: CrudQuery | undefined, init?: Init): Promise<JsonObject>;\n predict(query: CrudQuery | undefined, init?: Init): Promise<JsonObject>;\n revisions(id: number, init?: Init): Promise<JsonObject[]>;\n /** The manifest the client already loaded (the client's loader takes no signal). */\n manifest(init?: Init): Promise<Manifest>;\n create(body: Create): Promise<Read>;\n update(id: number, patch: Update, init?: { ifMatch?: string }): Promise<Read>;\n delete(id: number): Promise<void>;\n}\n\n/**\n * A query is the client's `ListOptions`, `StatsOptions` or `PredictOptions`\n * without `signal` (`{ filters, sort, skip, limit, ... }`); TanStack's signal\n * is added per call.\n */\nexport function tanstackApi<\n Read extends object,\n Create extends object,\n Update extends object,\n>(\n client: CrudClient,\n resource: ResourceClient<Read, Create, Update>,\n): TanstackApi<Read, Create, Update> {\n return {\n list: (query, init) => resource.list({ ...query, ...init }),\n get: (id, init) => resource.get(id, init),\n stats: (query, init) => resource.stats({ ...query, ...init }),\n predict: (query, init) => resource.predict({ ...query, ...init }),\n revisions: (id, init) => resource.revisions(id, init),\n manifest: () => client.manifest(),\n create: (body) => resource.create(body),\n update: (id, patch, init) => resource.update(id, patch, init),\n delete: (id) => resource.delete(id),\n };\n}\n","// Entry point `./tanstack`: `queryOptions` factories, key factory and the\n// invalidation bridge (TS2). Needs the optional peer `@tanstack/query-core`\n// (types only: nothing here imports it at runtime). query-core has no\n// `queryOptions`, so the factories return plain `{ queryKey, queryFn,\n// staleTime }` objects with `queryKey` tagged through `DataTag`; the React\n// wrappers live in lib-crud-views-ts.\nimport type { DataTag, InfiniteData, QueryClient } from \"@tanstack/query-core\";\nimport type { EventHub } from \"../events.ts\";\n\nexport { tanstackApi } from \"./adapter.ts\";\nexport type { TanstackApi } from \"./adapter.ts\";\nexport { tanstackCachePolicy } from \"../cache/policy.ts\";\nexport type { CachePolicy, ManifestCacheHints } from \"../cache/policy.ts\";\nexport { getEventHub, subscribeEvents } from \"../events.ts\";\nexport type {\n EventHandlers,\n EventHub,\n EventHubOptions,\n EventsConfig,\n SubscribeEventsOptions,\n} from \"../events.ts\";\nexport type { CrudEvent } from \"../interfaces.ts\";\n\n/** A query object as the client's query builder takes it. */\nexport type CrudQuery = Readonly<Record<string, unknown>>;\n\ntype Key = readonly unknown[];\n\n/** The key factory type. */\nexport interface CrudKeys {\n readonly all: readonly [\"crud\"];\n /** Everything of one resource. */\n resource(resource: string): readonly [\"crud\", string];\n /** All lists of one resource, plain and infinite. */\n lists(resource: string): readonly [\"crud\", string, \"list\"];\n list(resource: string, query?: CrudQuery): Key;\n infiniteList(resource: string, query: CrudQuery, limit: number): Key;\n /** All record queries of one resource. */\n records(resource: string): readonly [\"crud\", string, \"record\"];\n record(\n resource: string,\n id: number,\n ): readonly [\"crud\", string, \"record\", number];\n stats(resource: string, query?: CrudQuery): Key;\n predict(resource: string, query?: CrudQuery): Key;\n revisions(\n resource: string,\n id: number,\n ): readonly [\"crud\", string, \"revisions\", number];\n /** The manifest, optionally of one caller scope. */\n manifest(scope?: string): Key;\n}\n\n/** The key factory. Every key starts with `[\"crud\", resource, ...]`, so prefixes invalidate by resource, kind or record. */\nexport const crudKeys: CrudKeys = {\n all: [\"crud\"],\n resource: (resource) => [\"crud\", resource],\n lists: (resource) => [\"crud\", resource, \"list\"],\n list: (resource, query) =>\n query === undefined\n ? crudKeys.lists(resource)\n : [...crudKeys.lists(resource), query],\n infiniteList: (resource, query, limit) => [\n ...crudKeys.lists(resource),\n \"infinite\",\n query,\n limit,\n ],\n records: (resource) => [\"crud\", resource, \"record\"],\n record: (resource, id) => [\"crud\", resource, \"record\", id],\n stats: (resource, query) =>\n query === undefined\n ? [\"crud\", resource, \"stats\"]\n : [\"crud\", resource, \"stats\", query],\n predict: (resource, query) =>\n query === undefined\n ? [\"crud\", resource, \"predict\"]\n : [\"crud\", resource, \"predict\", query],\n revisions: (resource, id) => [\"crud\", resource, \"revisions\", id],\n manifest: (scope) =>\n scope === undefined ? [\"crud\", \"_manifest\"] : [\"crud\", \"_manifest\", scope],\n};\n\n/** What a query function receives from TanStack Query (a subset). */\nexport interface QueryContext {\n readonly signal: AbortSignal;\n}\n\nexport interface QueryOptionsInit {\n /** TanStack's `staleTime` in milliseconds. Default 0 (the SDK cache revalidates for free). */\n readonly staleTime?: number;\n}\n\n/** Plain query options with a typed key; spread into `useQuery`/`fetchQuery`. */\nexport interface CrudQueryOptions<T> {\n readonly queryKey: DataTag<Key, T, Error>;\n readonly queryFn: (context: QueryContext) => Promise<T>;\n readonly staleTime: number;\n}\n\nexport interface CrudInfiniteQueryOptions<T> {\n readonly queryKey: DataTag<\n Key,\n { pages: T[][]; pageParams: number[] },\n Error\n >;\n readonly queryFn: (\n context: QueryContext & { pageParam: number },\n ) => Promise<T[]>;\n readonly initialPageParam: number;\n /** `skip + limit` unless the page was short. */\n readonly getNextPageParam: (\n lastPage: T[],\n allPages: T[][],\n lastPageParam: number,\n ) => number | undefined;\n readonly staleTime: number;\n}\n\n/** The slices of a resource API the factories call (structural: TS1's resource client fits). */\nexport interface ListApi<T> {\n list(\n query: CrudQuery | undefined,\n init?: { signal?: AbortSignal },\n ): Promise<T[]>;\n}\nexport interface RecordApi<T> {\n get(id: number, init?: { signal?: AbortSignal }): Promise<T>;\n}\nexport interface StatsApi<S> {\n stats(\n query: CrudQuery | undefined,\n init?: { signal?: AbortSignal },\n ): Promise<S>;\n}\nexport interface PredictApi<P> {\n predict(\n query: CrudQuery | undefined,\n init?: { signal?: AbortSignal },\n ): Promise<P>;\n}\nexport interface RevisionsApi<R> {\n revisions(id: number, init?: { signal?: AbortSignal }): Promise<R[]>;\n}\nexport interface ManifestApi<M> {\n manifest(init?: { signal?: AbortSignal }): Promise<M>;\n}\nexport interface CreateApi<T, C> {\n create(body: C): Promise<T>;\n}\nexport interface UpdateApi<T, P> {\n update(id: number, patch: P, init?: { ifMatch?: string }): Promise<T>;\n}\nexport interface DeleteApi {\n delete(id: number): Promise<unknown>;\n}\n\nfunction tag<T>(key: Key): DataTag<Key, T, Error> {\n return key as DataTag<Key, T, Error>;\n}\n\nexport function listOptions<T>(\n resource: string,\n api: ListApi<T>,\n query?: CrudQuery,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<T[]> {\n return {\n queryKey: tag(crudKeys.list(resource, query)),\n queryFn: ({ signal }) => api.list(query, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function recordOptions<T>(\n resource: string,\n api: RecordApi<T>,\n id: number,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<T> {\n return {\n queryKey: tag(crudKeys.record(resource, id)),\n queryFn: ({ signal }) => api.get(id, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function statsOptions<S>(\n resource: string,\n api: StatsApi<S>,\n query?: CrudQuery,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<S> {\n return {\n queryKey: tag(crudKeys.stats(resource, query)),\n queryFn: ({ signal }) => api.stats(query, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function predictOptions<P>(\n resource: string,\n api: PredictApi<P>,\n query?: CrudQuery,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<P> {\n return {\n queryKey: tag(crudKeys.predict(resource, query)),\n queryFn: ({ signal }) => api.predict(query, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function revisionsOptions<R>(\n resource: string,\n api: RevisionsApi<R>,\n id: number,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<R[]> {\n return {\n queryKey: tag(crudKeys.revisions(resource, id)),\n queryFn: ({ signal }) => api.revisions(id, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function manifestOptions<M>(\n api: ManifestApi<M>,\n scope?: string,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<M> {\n return {\n queryKey: tag(crudKeys.manifest(scope)),\n queryFn: ({ signal }) => api.manifest({ signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport interface InfiniteListInit extends QueryOptionsInit {\n /** Page size; default 100 (the server's default). */\n readonly limit?: number;\n /**\n * Keys of the paging parameters in the query object handed to `api.list`.\n * Default `skip`/`limit`, which is what `tanstackApi` (the client's\n * `ListOptions`) reads; change them only for a hand-written `ListApi`. The\n * client maps them to the manifest's `skip_param`/`limit_param` itself.\n */\n readonly skipKey?: string;\n readonly limitKey?: string;\n}\n\n/** Offset paging: the next page starts at `skip + limit`, unless the last page was short. */\nexport function infiniteListOptions<T>(\n resource: string,\n api: ListApi<T>,\n query: CrudQuery = {},\n init: InfiniteListInit = {},\n): CrudInfiniteQueryOptions<T> {\n const limit = init.limit ?? 100;\n const skipKey = init.skipKey ?? \"skip\";\n const limitKey = init.limitKey ?? \"limit\";\n return {\n queryKey: tag<InfiniteData<T[], number>>(\n crudKeys.infiniteList(resource, query, limit),\n ),\n queryFn: ({ signal, pageParam }) =>\n api.list(\n { ...query, [skipKey]: pageParam, [limitKey]: limit },\n { signal },\n ),\n initialPageParam: 0,\n getNextPageParam: (lastPage, _all, lastPageParam) =>\n lastPage.length < limit ? undefined : lastPageParam + limit,\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport type Invalidator = Pick<\n QueryClient,\n \"invalidateQueries\" | \"removeQueries\" | \"setQueryData\"\n>;\n\nasync function invalidateCollections(\n client: Invalidator,\n resource: string,\n): Promise<void> {\n await Promise.all([\n client.invalidateQueries({ queryKey: crudKeys.lists(resource) }),\n client.invalidateQueries({ queryKey: crudKeys.stats(resource) }),\n client.invalidateQueries({ queryKey: crudKeys.predict(resource) }),\n ]);\n}\n\nexport interface CreateMutationOptions<T, C> {\n readonly mutationKey: readonly [\"crud\", string, \"create\"];\n readonly mutationFn: (body: C) => Promise<T>;\n readonly onSuccess: () => Promise<void>;\n}\n\nexport interface UpdateMutationOptions<T, P> {\n readonly mutationKey: readonly [\"crud\", string, \"update\"];\n readonly mutationFn: (variables: UpdateVariables<P>) => Promise<T>;\n readonly onSuccess: (\n record: T,\n variables: UpdateVariables<P>,\n ) => Promise<void>;\n}\n\nexport interface DeleteMutationOptions {\n readonly mutationKey: readonly [\"crud\", string, \"delete\"];\n readonly mutationFn: (id: number) => Promise<unknown>;\n readonly onSuccess: (result: unknown, id: number) => Promise<void>;\n}\n\n/** Create: invalidate lists, stats and predict. */\nexport function createMutationOptions<T, C>(\n client: Invalidator,\n resource: string,\n api: CreateApi<T, C>,\n): CreateMutationOptions<T, C> {\n return {\n mutationKey: [\"crud\", resource, \"create\"],\n mutationFn: (body: C) => api.create(body),\n onSuccess: () => invalidateCollections(client, resource),\n };\n}\n\nexport interface UpdateVariables<P> {\n readonly id: number;\n readonly patch: P;\n /** Sent as `If-Match`; a stale one fails with 412. */\n readonly ifMatch?: string;\n}\n\n/** Update: `setQueryData` from the PATCH response, invalidate lists, stats, predict and revisions. */\nexport function updateMutationOptions<T, P>(\n client: Invalidator,\n resource: string,\n api: UpdateApi<T, P>,\n): UpdateMutationOptions<T, P> {\n return {\n mutationKey: [\"crud\", resource, \"update\"],\n mutationFn: ({ id, patch, ifMatch }: UpdateVariables<P>) =>\n api.update(id, patch, ifMatch === undefined ? {} : { ifMatch }),\n onSuccess: async (record: T, { id }: UpdateVariables<P>) => {\n client.setQueryData(crudKeys.record(resource, id), record);\n await Promise.all([\n invalidateCollections(client, resource),\n client.invalidateQueries({\n queryKey: crudKeys.revisions(resource, id),\n }),\n ]);\n },\n };\n}\n\n/** Delete: drop the record query, invalidate lists, stats, predict and revisions. */\nexport function deleteMutationOptions(\n client: Invalidator,\n resource: string,\n api: DeleteApi,\n): DeleteMutationOptions {\n return {\n mutationKey: [\"crud\", resource, \"delete\"],\n mutationFn: (id: number) => api.delete(id),\n onSuccess: async (_result: unknown, id: number) => {\n client.removeQueries({ queryKey: crudKeys.record(resource, id) });\n await Promise.all([\n invalidateCollections(client, resource),\n client.invalidateQueries({\n queryKey: crudKeys.revisions(resource, id),\n }),\n ]);\n },\n };\n}\n\n/**\n * Invalidate TanStack queries from the resource's event stream. Events\n * invalidate and never apply snapshots: `create` invalidates lists, stats and\n * predict; `update`/`delete`/`restore` also the record and its revisions; a\n * reconnect (or an event with no usable record id) invalidates the resource.\n * Returns the unsubscribe.\n */\nexport function bridgeEvents(\n client: Pick<QueryClient, \"invalidateQueries\">,\n hub: EventHub,\n resource: string,\n): () => void {\n return hub.subscribe({\n onEvent: async (event) => {\n const pending = [\n client.invalidateQueries({ queryKey: crudKeys.lists(resource) }),\n client.invalidateQueries({ queryKey: crudKeys.stats(resource) }),\n client.invalidateQueries({ queryKey: crudKeys.predict(resource) }),\n ];\n if (event.action !== \"create\") {\n pending.push(\n client.invalidateQueries({\n queryKey: crudKeys.record(resource, event.recordId),\n }),\n client.invalidateQueries({\n queryKey: crudKeys.revisions(resource, event.recordId),\n }),\n );\n }\n await Promise.all(pending);\n },\n onReset: () =>\n client.invalidateQueries({ queryKey: crudKeys.resource(resource) }),\n });\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../../src/tanstack/adapter.ts","../../src/tanstack/index.ts"],"sourcesContent":["// Adapts TS1's `ResourceClient` (options-object methods) to the structural\n// slices the `./tanstack` factories take (`list(query, { signal })`, ...).\nimport type { CrudClient, ResourceClient } from \"../client.ts\";\nimport type { JsonObject, Manifest } from \"../manifest.ts\";\nimport type { CrudQuery } from \"./index.ts\";\n\ntype Init = { signal?: AbortSignal };\n\n/** What `tanstackApi` returns: every slice the factories use, bound to one resource. */\nexport interface TanstackApi<Read, Create, Update> {\n list(query: CrudQuery | undefined, init?: Init): Promise<Read[]>;\n get(id: number, init?: Init): Promise<Read>;\n stats(query: CrudQuery | undefined, init?: Init): Promise<JsonObject>;\n predict(query: CrudQuery | undefined, init?: Init): Promise<JsonObject>;\n revisions(id: number, init?: Init): Promise<JsonObject[]>;\n /** The manifest the client already loaded (the client's loader takes no signal). */\n manifest(init?: Init): Promise<Manifest>;\n create(body: Create): Promise<Read>;\n update(id: number, patch: Update, init?: { ifMatch?: string }): Promise<Read>;\n delete(id: number): Promise<void>;\n}\n\n/**\n * A query is the client's `ListOptions`, `StatsOptions` or `PredictOptions`\n * without `signal` (`{ filters, sort, skip, limit, ... }`); TanStack's signal\n * is added per call.\n */\nexport function tanstackApi<\n Read extends object,\n Create extends object,\n Update extends object,\n>(\n client: CrudClient,\n resource: ResourceClient<Read, Create, Update>,\n): TanstackApi<Read, Create, Update> {\n return {\n list: (query, init) => resource.list({ ...query, ...init }),\n get: (id, init) => resource.get(id, init),\n stats: (query, init) => resource.stats({ ...query, ...init }),\n predict: (query, init) => resource.predict({ ...query, ...init }),\n revisions: (id, init) => resource.revisions(id, init),\n manifest: () => client.manifest(),\n create: (body) => resource.create(body),\n update: (id, patch, init) => resource.update(id, patch, init),\n delete: (id) => resource.delete(id),\n };\n}\n","// Entry point `./tanstack`: `queryOptions` factories, key factory and the\n// invalidation bridge (TS2). Needs the optional peer `@tanstack/query-core`\n// (types only: nothing here imports it at runtime). query-core has no\n// `queryOptions`, so the factories return plain `{ queryKey, queryFn,\n// staleTime }` objects with `queryKey` tagged through `DataTag`; the React\n// wrappers live in lib-crud-views-ts.\nimport type { DataTag, InfiniteData, QueryClient } from \"@tanstack/query-core\";\nimport type { EventHub } from \"../events.ts\";\n\nexport { tanstackApi } from \"./adapter.ts\";\nexport type { TanstackApi } from \"./adapter.ts\";\nexport { tanstackCachePolicy } from \"../cache/policy.ts\";\nexport type { CachePolicy, ManifestCacheHints } from \"../cache/policy.ts\";\nexport { getEventHub, subscribeEvents } from \"../events.ts\";\nexport type {\n EventHandlers,\n EventHub,\n EventHubOptions,\n EventsConfig,\n SubscribeEventsOptions,\n} from \"../events.ts\";\nexport type { CrudEvent } from \"../interfaces.ts\";\n\n/** A query object as the client's query builder takes it. */\nexport type CrudQuery = Readonly<Record<string, unknown>>;\n\ntype Key = readonly unknown[];\n\n/**\n * Who a query belongs to: the client's stable identity and the caller scope\n * (`await client.namespace()`). Two clients, or two callers, that share one\n * `QueryClient` never see each other's cached data.\n */\nexport interface CrudNamespace {\n readonly client: string;\n readonly scope: string;\n}\n\n/** The kinds that sit at `key[4]`. */\nexport type CrudKind = \"list\" | \"record\" | \"stats\" | \"predict\" | \"revisions\";\n\n/** Which queries a {@link CrudKeys.filter} matches; every member narrows. */\nexport interface CrudKeyFilter {\n readonly client: string;\n /** Omit for every resource of the client (including manifests). */\n readonly resource?: string;\n /** Omit for every caller scope. */\n readonly scope?: string;\n /** Skips this caller scope (every other scope matches). */\n readonly exceptScope?: string;\n /** Omit for every kind. */\n readonly kinds?: readonly CrudKind[];\n /** A record id; matches only the `record` and `revisions` keys of that record. */\n readonly id?: number;\n}\n\n/** Spread into `invalidateQueries`, `removeQueries` or `cancelQueries`. */\nexport type CrudKeyMatcher =\n | { readonly queryKey: readonly unknown[] }\n | {\n readonly predicate: (query: {\n readonly queryKey: readonly unknown[];\n }) => boolean;\n };\n\n/** The key factory type. */\nexport interface CrudKeys {\n readonly all: readonly [\"crud\"];\n /** Everything of one client. */\n client(client: string): readonly [\"crud\", string];\n /** Everything of one resource on one client, every scope and kind. */\n resource(client: string, resource: string): readonly [\"crud\", string, string];\n /** All lists of one resource and scope, plain and infinite. */\n lists(\n ns: CrudNamespace,\n resource: string,\n ): readonly [\"crud\", string, string, string, \"list\"];\n list(ns: CrudNamespace, resource: string, query?: CrudQuery): Key;\n infiniteList(\n ns: CrudNamespace,\n resource: string,\n query: CrudQuery,\n limit: number,\n ): Key;\n /** All record queries of one resource and scope. */\n records(\n ns: CrudNamespace,\n resource: string,\n ): readonly [\"crud\", string, string, string, \"record\"];\n record(\n ns: CrudNamespace,\n resource: string,\n id: number,\n ): readonly [\"crud\", string, string, string, \"record\", number];\n stats(ns: CrudNamespace, resource: string, query?: CrudQuery): Key;\n predict(ns: CrudNamespace, resource: string, query?: CrudQuery): Key;\n revisions(\n ns: CrudNamespace,\n resource: string,\n id: number,\n ): readonly [\"crud\", string, string, string, \"revisions\", number];\n /** The manifest of one caller scope. */\n manifest(ns: CrudNamespace): readonly [\"crud\", string, \"_manifest\", string];\n /**\n * A matcher for `invalidateQueries({ ...crudKeys.filter(f) })`. A client\n * or resource filter is one key prefix; narrowing by scope, kind or id\n * (which sit after the resource) uses a predicate.\n */\n filter(filter: CrudKeyFilter): CrudKeyMatcher;\n}\n\n/**\n * The key factory. Keys are\n * `[\"crud\", client, resource, scope, kind, ...]` (the manifest is\n * `[\"crud\", client, \"_manifest\", scope]`), so a prefix invalidates by client\n * or by resource on one client; `resource` is the manifest name, or\n * `name@apiVersion` for a pinned version (a different string is a different\n * resource: pass the same one to the invalidate helpers). `_manifest` is\n * reserved; a scope-only filter also matches the scope's manifest.\n */\nexport const crudKeys: CrudKeys = {\n all: [\"crud\"],\n client: (client) => [\"crud\", client],\n resource: (client, resource) => [\"crud\", client, resource],\n lists: (ns, resource) => [\"crud\", ns.client, resource, ns.scope, \"list\"],\n list: (ns, resource, query) =>\n query === undefined\n ? crudKeys.lists(ns, resource)\n : [...crudKeys.lists(ns, resource), query],\n infiniteList: (ns, resource, query, limit) => [\n ...crudKeys.lists(ns, resource),\n \"infinite\",\n query,\n limit,\n ],\n records: (ns, resource) => [\"crud\", ns.client, resource, ns.scope, \"record\"],\n record: (ns, resource, id) => [...crudKeys.records(ns, resource), id],\n stats: (ns, resource, query) =>\n query === undefined\n ? [\"crud\", ns.client, resource, ns.scope, \"stats\"]\n : [\"crud\", ns.client, resource, ns.scope, \"stats\", query],\n predict: (ns, resource, query) =>\n query === undefined\n ? [\"crud\", ns.client, resource, ns.scope, \"predict\"]\n : [\"crud\", ns.client, resource, ns.scope, \"predict\", query],\n revisions: (ns, resource, id) => [\n \"crud\",\n ns.client,\n resource,\n ns.scope,\n \"revisions\",\n id,\n ],\n manifest: (ns) => [\"crud\", ns.client, \"_manifest\", ns.scope],\n filter: (filter) => {\n const { client, resource, scope, exceptScope, kinds, id } = filter;\n if (\n scope === undefined &&\n exceptScope === undefined &&\n kinds === undefined &&\n id === undefined\n ) {\n return {\n queryKey:\n resource === undefined\n ? crudKeys.client(client)\n : crudKeys.resource(client, resource),\n };\n }\n return {\n predicate: ({ queryKey: key }) =>\n key[0] === \"crud\" &&\n key[1] === client &&\n (resource === undefined || key[2] === resource) &&\n (scope === undefined || key[3] === scope) &&\n (exceptScope === undefined || key[3] !== exceptScope) &&\n (kinds === undefined || kinds.includes(key[4] as CrudKind)) &&\n (id === undefined ||\n ((key[4] === \"record\" || key[4] === \"revisions\") && key[5] === id)),\n };\n },\n};\n\n/** What a query function receives from TanStack Query (a subset). */\nexport interface QueryContext {\n readonly signal: AbortSignal;\n}\n\nexport interface QueryOptionsInit {\n /** TanStack's `staleTime` in milliseconds. Default 0 (the SDK cache revalidates for free). */\n readonly staleTime?: number;\n}\n\n/** Plain query options with a typed key; spread into `useQuery`/`fetchQuery`. */\nexport interface CrudQueryOptions<T> {\n readonly queryKey: DataTag<Key, T, Error>;\n readonly queryFn: (context: QueryContext) => Promise<T>;\n readonly staleTime: number;\n}\n\nexport interface CrudInfiniteQueryOptions<T> {\n readonly queryKey: DataTag<\n Key,\n { pages: T[][]; pageParams: number[] },\n Error\n >;\n readonly queryFn: (\n context: QueryContext & { pageParam: number },\n ) => Promise<T[]>;\n readonly initialPageParam: number;\n /** `skip + limit` unless the page was short. */\n readonly getNextPageParam: (\n lastPage: T[],\n allPages: T[][],\n lastPageParam: number,\n ) => number | undefined;\n readonly staleTime: number;\n}\n\n/** The slices of a resource API the factories call (structural: TS1's resource client fits). */\nexport interface ListApi<T> {\n list(\n query: CrudQuery | undefined,\n init?: { signal?: AbortSignal },\n ): Promise<T[]>;\n}\nexport interface RecordApi<T> {\n get(id: number, init?: { signal?: AbortSignal }): Promise<T>;\n}\nexport interface StatsApi<S> {\n stats(\n query: CrudQuery | undefined,\n init?: { signal?: AbortSignal },\n ): Promise<S>;\n}\nexport interface PredictApi<P> {\n predict(\n query: CrudQuery | undefined,\n init?: { signal?: AbortSignal },\n ): Promise<P>;\n}\nexport interface RevisionsApi<R> {\n revisions(id: number, init?: { signal?: AbortSignal }): Promise<R[]>;\n}\nexport interface ManifestApi<M> {\n manifest(init?: { signal?: AbortSignal }): Promise<M>;\n}\nexport interface CreateApi<T, C> {\n create(body: C): Promise<T>;\n}\nexport interface UpdateApi<T, P> {\n update(id: number, patch: P, init?: { ifMatch?: string }): Promise<T>;\n}\nexport interface DeleteApi {\n delete(id: number): Promise<unknown>;\n}\n\nfunction tag<T>(key: Key): DataTag<Key, T, Error> {\n return key as DataTag<Key, T, Error>;\n}\n\nexport function listOptions<T>(\n ns: CrudNamespace,\n resource: string,\n api: ListApi<T>,\n query?: CrudQuery,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<T[]> {\n return {\n queryKey: tag(crudKeys.list(ns, resource, query)),\n queryFn: ({ signal }) => api.list(query, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function recordOptions<T>(\n ns: CrudNamespace,\n resource: string,\n api: RecordApi<T>,\n id: number,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<T> {\n return {\n queryKey: tag(crudKeys.record(ns, resource, id)),\n queryFn: ({ signal }) => api.get(id, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function statsOptions<S>(\n ns: CrudNamespace,\n resource: string,\n api: StatsApi<S>,\n query?: CrudQuery,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<S> {\n return {\n queryKey: tag(crudKeys.stats(ns, resource, query)),\n queryFn: ({ signal }) => api.stats(query, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function predictOptions<P>(\n ns: CrudNamespace,\n resource: string,\n api: PredictApi<P>,\n query?: CrudQuery,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<P> {\n return {\n queryKey: tag(crudKeys.predict(ns, resource, query)),\n queryFn: ({ signal }) => api.predict(query, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function revisionsOptions<R>(\n ns: CrudNamespace,\n resource: string,\n api: RevisionsApi<R>,\n id: number,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<R[]> {\n return {\n queryKey: tag(crudKeys.revisions(ns, resource, id)),\n queryFn: ({ signal }) => api.revisions(id, { signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport function manifestOptions<M>(\n ns: CrudNamespace,\n api: ManifestApi<M>,\n init: QueryOptionsInit = {},\n): CrudQueryOptions<M> {\n return {\n queryKey: tag(crudKeys.manifest(ns)),\n queryFn: ({ signal }) => api.manifest({ signal }),\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport interface InfiniteListInit extends QueryOptionsInit {\n /** Page size; default 100 (the server's default). */\n readonly limit?: number;\n /**\n * Keys of the paging parameters in the query object handed to `api.list`.\n * Default `skip`/`limit`, which is what `tanstackApi` (the client's\n * `ListOptions`) reads; change them only for a hand-written `ListApi`. The\n * client maps them to the manifest's `skip_param`/`limit_param` itself.\n */\n readonly skipKey?: string;\n readonly limitKey?: string;\n}\n\n/** Offset paging: the next page starts at `skip + limit`, unless the last page was short. */\nexport function infiniteListOptions<T>(\n ns: CrudNamespace,\n resource: string,\n api: ListApi<T>,\n query: CrudQuery = {},\n init: InfiniteListInit = {},\n): CrudInfiniteQueryOptions<T> {\n const limit = init.limit ?? 100;\n const skipKey = init.skipKey ?? \"skip\";\n const limitKey = init.limitKey ?? \"limit\";\n return {\n queryKey: tag<InfiniteData<T[], number>>(\n crudKeys.infiniteList(ns, resource, query, limit),\n ),\n queryFn: ({ signal, pageParam }) =>\n api.list(\n { ...query, [skipKey]: pageParam, [limitKey]: limit },\n { signal },\n ),\n initialPageParam: 0,\n getNextPageParam: (lastPage, _all, lastPageParam) =>\n lastPage.length < limit ? undefined : lastPageParam + limit,\n staleTime: init.staleTime ?? 0,\n };\n}\n\nexport type Invalidator = Pick<\n QueryClient,\n \"invalidateQueries\" | \"removeQueries\" | \"setQueryData\"\n>;\n\nconst COLLECTION_KINDS = [\"list\", \"stats\", \"predict\"] as const;\n\n/** One resource of one client; `resource` is the string used in its keys. */\nexport interface CrudTarget {\n readonly client: string;\n readonly resource: string;\n}\n\n/**\n * Invalidates the list, stats and predict queries of `resource` on `client`,\n * for every caller scope (a write changes what every caller sees).\n */\nexport function invalidateCollections(\n queryClient: Pick<QueryClient, \"invalidateQueries\">,\n { client, resource }: CrudTarget,\n): Promise<void> {\n return queryClient.invalidateQueries(\n crudKeys.filter({ client, resource, kinds: COLLECTION_KINDS }),\n );\n}\n\n/** Invalidates everything cached for `resource` on `client`: one key prefix. */\nexport function invalidateResource(\n queryClient: Pick<QueryClient, \"invalidateQueries\">,\n { client, resource }: CrudTarget,\n): Promise<void> {\n return queryClient.invalidateQueries(crudKeys.filter({ client, resource }));\n}\n\n/** Invalidates one record's `record` and `revisions` queries, for every scope. */\nexport function invalidateRecord(\n queryClient: Pick<QueryClient, \"invalidateQueries\">,\n { client, resource }: CrudTarget,\n id: number,\n): Promise<void> {\n return queryClient.invalidateQueries(\n crudKeys.filter({\n client,\n resource,\n kinds: [\"record\", \"revisions\"],\n id,\n }),\n );\n}\n\nexport interface CreateMutationOptions<T, C> {\n readonly mutationKey: readonly [\"crud\", string, string, string, \"create\"];\n readonly mutationFn: (body: C) => Promise<T>;\n readonly onSuccess: () => Promise<void>;\n}\n\nexport interface UpdateMutationOptions<T, P> {\n readonly mutationKey: readonly [\"crud\", string, string, string, \"update\"];\n readonly mutationFn: (variables: UpdateVariables<P>) => Promise<T>;\n readonly onSuccess: (\n record: T,\n variables: UpdateVariables<P>,\n ) => Promise<void>;\n}\n\nexport interface DeleteMutationOptions {\n readonly mutationKey: readonly [\"crud\", string, string, string, \"delete\"];\n readonly mutationFn: (id: number) => Promise<unknown>;\n readonly onSuccess: (result: unknown, id: number) => Promise<void>;\n}\n\n/** Create: invalidate lists, stats and predict. */\nexport function createMutationOptions<T, C>(\n queryClient: Invalidator,\n ns: CrudNamespace,\n resource: string,\n api: CreateApi<T, C>,\n): CreateMutationOptions<T, C> {\n return {\n mutationKey: [\"crud\", ns.client, resource, ns.scope, \"create\"],\n mutationFn: (body: C) => api.create(body),\n onSuccess: () =>\n invalidateCollections(queryClient, { client: ns.client, resource }),\n };\n}\n\nexport interface UpdateVariables<P> {\n readonly id: number;\n readonly patch: P;\n /** Sent as `If-Match`; a stale one fails with 412. */\n readonly ifMatch?: string;\n}\n\n/** Update: `setQueryData` from the PATCH response, invalidate lists, stats, predict and revisions. */\nexport function updateMutationOptions<T, P>(\n queryClient: Invalidator,\n ns: CrudNamespace,\n resource: string,\n api: UpdateApi<T, P>,\n): UpdateMutationOptions<T, P> {\n return {\n mutationKey: [\"crud\", ns.client, resource, ns.scope, \"update\"],\n mutationFn: ({ id, patch, ifMatch }: UpdateVariables<P>) =>\n api.update(id, patch, ifMatch === undefined ? {} : { ifMatch }),\n onSuccess: async (record: T, { id }: UpdateVariables<P>) => {\n queryClient.setQueryData(crudKeys.record(ns, resource, id), record);\n await Promise.all([\n invalidateCollections(queryClient, { client: ns.client, resource }),\n // The caller's own record was just set; other scopes' are stale.\n queryClient.invalidateQueries(\n crudKeys.filter({\n client: ns.client,\n resource,\n exceptScope: ns.scope,\n kinds: [\"record\"],\n id,\n }),\n ),\n queryClient.invalidateQueries(\n crudKeys.filter({\n client: ns.client,\n resource,\n kinds: [\"revisions\"],\n id,\n }),\n ),\n ]);\n },\n };\n}\n\n/** Delete: drop the record query, invalidate lists, stats, predict and revisions. */\nexport function deleteMutationOptions(\n queryClient: Invalidator,\n ns: CrudNamespace,\n resource: string,\n api: DeleteApi,\n): DeleteMutationOptions {\n return {\n mutationKey: [\"crud\", ns.client, resource, ns.scope, \"delete\"],\n mutationFn: (id: number) => api.delete(id),\n onSuccess: async (_result: unknown, id: number) => {\n queryClient.removeQueries(\n crudKeys.filter({\n client: ns.client,\n resource,\n kinds: [\"record\"],\n id,\n }),\n );\n await Promise.all([\n invalidateCollections(queryClient, { client: ns.client, resource }),\n queryClient.invalidateQueries(\n crudKeys.filter({\n client: ns.client,\n resource,\n kinds: [\"revisions\"],\n id,\n }),\n ),\n ]);\n },\n };\n}\n\n/**\n * Invalidate TanStack queries from the resource's event stream. Events\n * invalidate and never apply snapshots: `create` invalidates lists, stats and\n * predict; `update`/`delete`/`restore` also the record and its revisions; a\n * reconnect (or an event with no usable record id) invalidates the resource.\n * Returns the unsubscribe.\n */\nexport function bridgeEvents(\n queryClient: Pick<QueryClient, \"invalidateQueries\">,\n hub: EventHub,\n target: CrudTarget,\n): () => void {\n return hub.subscribe({\n onEvent: async (event) => {\n const pending = [invalidateCollections(queryClient, target)];\n if (event.action !== \"create\") {\n pending.push(invalidateRecord(queryClient, target, event.recordId));\n }\n await Promise.all(pending);\n },\n onReset: () => invalidateResource(queryClient, target),\n });\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@craftainer/crud-sdk",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "Typed fetch client for craftainer CRUD APIs: manifest-driven resources, query builder, problem-details errors, opt-in cache with SSE invalidation and TanStack Query helpers.",
5
5
  "license": "GPL-3.0-or-later",
6
6
  "repository": {