@cratestack/refine 0.7.14 → 0.7.17

package/dist/rpc-types.d.ts

@@ -0,0 +1,95 @@
+import type { CratestackPage } from "./types.js";
+/** Mirrors the generated RPC client's own `RpcListPredicate`
+ *  (`crates/cratestack-client-typescript/templates/src/rpc-queries.ts.j2`)
+ *  exactly — a single arbitrary `(key, value)` predicate, where `key`
+ *  already carries the `field[__operator]` suffix (`toRpcQueryFilters` in
+ *  `rpc-filters.ts` builds these). */
+export interface RpcListPredicate {
+    key: string;
+    value: string;
+}
+/** Mirrors the generated RPC client's own `CratestackRpcListQuery`
+ *  structurally — only the subset this package writes to (`filters`,
+ *  `sort`, `limit`, `offset`). Unlike REST's `CratestackFetchQuery`,
+ *  `sort` is a single already-joined string and `filters` is an array of
+ *  {@link RpcListPredicate} rather than a `Record<string,string>` — see
+ *  `rpc-filters.ts`'s doc comments for why each differs from its REST
+ *  counterpart. `where`/`or`/`fields`/`include`/`includeFields` exist on
+ *  the wire but this package never writes to them. */
+export interface CratestackRpcListQuery {
+    limit?: number;
+    offset?: number;
+    fields?: string[];
+    include?: string[];
+    includeFields?: Record<string, string[]>;
+    sort?: string;
+    where?: string;
+    or?: string;
+    filters?: RpcListPredicate[];
+}
+/** Mirrors the generated RPC client's own `CratestackRpcCallOptions`
+ *  (`rpc-runtime.ts.j2`) structurally — REST's `CratestackRequestConfig`
+ *  sibling, plus `idempotencyKey` (RPC-only; propagated as the
+ *  `Idempotency-Key` header). `headers` is where `If-Match` travels for
+ *  `update`/`deleteOne` on a `@version` model — the RPC dispatch arms
+ *  (`crates/cratestack-macros/src/transport/rpc.rs`) pass the real HTTP
+ *  `HeaderMap` straight through to the same `handle_update_*_dispatch`/
+ *  `handle_delete_*_dispatch` fns REST uses
+ *  (`crates/cratestack-macros/src/axum/model/handlers_update.rs`), which
+ *  read it via `parse_if_match_version` — so `If-Match` is enforced
+ *  identically on both transports. */
+export interface CratestackRpcCallOptions {
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+    idempotencyKey?: string;
+}
+/** The structural surface a generated RPC model class (`client.widgets`,
+ *  `client.ledgers`, …) needs for this package to drive it — matched
+ *  against the real shape emitted by `cratestack generate-typescript`
+ *  onto a `transport rpc` schema
+ *  (`crates/cratestack-client-typescript/templates/src/rpc-client.ts.j2`).
+ *  `get`/`create`/`update`/`delete` are positionally identical to REST's
+ *  `CratestackModelApi` — only `list` differs, taking the query
+ *  positionally (`list(query, options)`) instead of nested in an options
+ *  object (REST's `list({ query, headers, signal })`). */
+export interface CratestackRpcModelApi<TModel = unknown, TCreateInput = unknown, TUpdateInput = unknown> {
+    list(query?: CratestackRpcListQuery, options?: CratestackRpcCallOptions): Promise<TModel[] | CratestackPage<TModel>>;
+    get(id: unknown, options?: CratestackRpcCallOptions): Promise<TModel>;
+    /** Absent on the generated class entirely when the model declares no
+     *  `@@allow("create", ...)` policy at all — same caveat as REST's
+     *  `CratestackModelApi.create`, see the package README's
+     *  "Policy-denied operations" note. */
+    create?(input: TCreateInput, options?: CratestackRpcCallOptions): Promise<TModel>;
+    update(id: unknown, patch: TUpdateInput, options?: CratestackRpcCallOptions): Promise<TModel>;
+    delete(id: unknown, options?: CratestackRpcCallOptions): Promise<void>;
+}
+/** One RPC resource's binding to a generated model class — the RPC
+ *  sibling of REST's `ResourceConfig` in `types.ts`, same four facts
+ *  (`api`, `primaryKey`, `paged`, optional `versionField`), same
+ *  reasoning for why they can't be discovered at runtime and have to be
+ *  supplied. Hand-write it (as every example in the README does), or
+ *  generate it: `cratestack generate-typescript --refine` has emitted a
+ *  real `refine.ts` typed to `RpcResourceMap` for `transport rpc` schemas
+ *  since issue #571's RPC follow-up (#586 —
+ *  `TypeScriptGeneratorError::RefineRequiresRest` was widened to
+ *  `RefineRequiresRestOrRpc`). This package's own tests check both paths:
+ *  `tests/typecheck/rpc-manifest.ts` builds one by hand against a real
+ *  generated RPC client, and `tests/typecheck/generated-manifest-rpc.ts`
+ *  checks the generator's own output round-trips into this type. */
+export interface RpcResourceConfig<TModel = unknown, TCreateInput = unknown, TUpdateInput = unknown> {
+    api: CratestackRpcModelApi<TModel, TCreateInput, TUpdateInput>;
+    /** The schema's `@id` field name. refine assumes `id`; cratestack's
+     *  `@id` may be on any field. */
+    primaryKey: string;
+    /** Mirrors whether the model declares `@@paged` — gates whether
+     *  `.list()` returns `Page<TModel>` (with a real `totalCount`) or a
+     *  bare `TModel[]`. */
+    paged: boolean;
+    /** Mirrors whether the model declares `@version`, and which field it's
+     *  on. Omit for a model with no `@version` field — `update`/
+     *  `deleteOne` then send no `If-Match` at all, matching the server's
+     *  own behavior of not requiring one. */
+    versionField?: string;
+}
+export type RpcResourceMap = Record<string, RpcResourceConfig<any, any, any>>;
+//# sourceMappingURL=rpc-types.d.ts.map

package/dist/rpc-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-types.d.ts","sourceRoot":"","sources":["../src/rpc-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;sCAIsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;sDAOsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;sCAUsC;AACtC,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;0DAQ0D;AAC1D,MAAM,WAAW,qBAAqB,CACpC,MAAM,GAAG,OAAO,EAChB,YAAY,GAAG,OAAO,EACtB,YAAY,GAAG,OAAO;IAEtB,IAAI,CACF,KAAK,CAAC,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE;;;2CAGuC;IACvC,MAAM,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClF,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9F,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED;;;;;;;;;;;;oEAYoE;AACpE,MAAM,WAAW,iBAAiB,CAChC,MAAM,GAAG,OAAO,EAChB,YAAY,GAAG,OAAO,EACtB,YAAY,GAAG,OAAO;IAEtB,GAAG,EAAE,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAC/D;qCACiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB;;2BAEuB;IACvB,KAAK,EAAE,OAAO,CAAC;IACf;;;6CAGyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC"}

package/dist/rpc-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rpc-types.js.map

package/dist/rpc-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-types.js","sourceRoot":"","sources":["../src/rpc-types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+/** The structural surface a generated model class (`client.widgets`,
+ *  `client.ledgers`, …) needs for this package to drive it — matched
+ *  against the real shape emitted by `cratestack generate-typescript`
+ *  (`crates/cratestack-client-typescript/templates/src/client.ts.j2`),
+ *  not a hand-invented interface. Each generated model class is its own
+ *  concrete TypeScript class with no shared base type the generator
+ *  exports, so this is duck-typed rather than an `implements` target —
+ *  every real generated class satisfies it structurally. */
+export interface CratestackModelApi<TModel = unknown, TCreateInput = unknown, TUpdateInput = unknown> {
+    list(options?: {
+        query?: CratestackFetchQuery;
+        headers?: HeadersInit;
+        signal?: AbortSignal;
+    }): Promise<TModel[] | CratestackPage<TModel>>;
+    get(id: unknown, options?: {
+        query?: CratestackFetchQuery;
+        headers?: HeadersInit;
+        signal?: AbortSignal;
+    }): Promise<TModel>;
+    /** Absent on the generated class entirely when the model declares no
+     *  `@@allow("create", ...)` policy at all — see the package README's
+     *  "Policy-denied operations" note for why that's a different, weaker
+     *  guarantee than "the current caller can create one". */
+    create?(input: TCreateInput, options?: CratestackRequestConfig): Promise<TModel>;
+    update(id: unknown, input: TUpdateInput, options?: CratestackRequestConfig): Promise<TModel>;
+    delete(id: unknown, options?: CratestackRequestConfig): Promise<void>;
+}
+/** Mirrors the generated client's own `CratestackFetchQuery`
+ *  (`queries.ts.j2`) structurally — only the subset this package writes
+ *  to (`filters`, `sort`, `limit`, `offset`). */
+export interface CratestackFetchQuery {
+    filters?: Record<string, string>;
+    sort?: string[];
+    limit?: number;
+    offset?: number;
+}
+export interface CratestackRequestConfig {
+    signal?: AbortSignal;
+    headers?: HeadersInit;
+}
+/** Mirrors `cratestack_core::page::Page<T>` (`models.ts.j2`) — only the
+ *  `items`/`totalCount` fields this package reads. */
+export interface CratestackPage<T> {
+    items: T[];
+    totalCount: number | null;
+}
+/** Structural match for the generated client's `CratestackHttpError`
+ *  (`rest-runtime.ts.j2`) — checked with {@link isCratestackHttpError}
+ *  rather than `instanceof`, since that class has no shared import path
+ *  this package can reference (it's regenerated per consumer, into
+ *  their own package). */
+export interface CratestackHttpErrorLike {
+    status: number;
+    response?: unknown;
+    payload?: unknown;
+    message?: string;
+}
+/** One resource's binding to a generated model class. Every field here
+ *  is a fact about the `.cstack` model that the generated client's own
+ *  TypeScript types encode at compile time but expose nowhere at
+ *  runtime — there is no `client.widgets.$meta` object to introspect,
+ *  confirmed by reading the generated `client.ts`/`models.ts` output.
+ *
+ *  Hand-write it, or let `cratestack generate-typescript --refine` emit
+ *  it from the schema those facts came from — see the README's "A
+ *  runtime package with a generated manifest". */
+export interface ResourceConfig<TModel = unknown, TCreateInput = unknown, TUpdateInput = unknown> {
+    api: CratestackModelApi<TModel, TCreateInput, TUpdateInput>;
+    /** The schema's `@id` field name. refine assumes `id`; cratestack's
+     *  `@id` may be on any field (`crates/cratestack-client-typescript/src/types.rs::primary_key_field`). */
+    primaryKey: string;
+    /** Mirrors whether the model declares `@@paged` — gates whether
+     *  `.list()` returns `Page<TModel>` (with a real `totalCount`) or a
+     *  bare `TModel[]`. A non-`@@paged` resource cannot report a true
+     *  `total` beyond what one page returned — see the package README's
+     *  "Pagination" section for why, and set `false` here honestly rather
+     *  than treating a non-paged model as paged. */
+    paged: boolean;
+    /** Mirrors whether the model declares `@version`, and which field
+     *  it's on. Omit for a model with no `@version` field — `update`/
+     *  `deleteOne` then send no `If-Match` at all, matching the server's
+     *  own behavior of not requiring one. */
+    versionField?: string;
+}
+export type ResourceMap = Record<string, ResourceConfig<any, any, any>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;4DAO4D;AAC5D,MAAM,WAAW,kBAAkB,CACjC,MAAM,GAAG,OAAO,EAChB,YAAY,GAAG,OAAO,EACtB,YAAY,GAAG,OAAO;IAEtB,IAAI,CAAC,OAAO,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,oBAAoB,CAAC;QAC7B,OAAO,CAAC,EAAE,WAAW,CAAC;QACtB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,GAAG,CACD,EAAE,EAAE,OAAO,EACX,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,oBAAoB,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACtF,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB;;;8DAG0D;IAC1D,MAAM,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjF,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7F,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED;;iDAEiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;sDACsD;AACtD,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;0BAI0B;AAC1B,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;kDAQkD;AAClD,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,YAAY,GAAG,OAAO,EAAE,YAAY,GAAG,OAAO;IAC9F,GAAG,EAAE,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAC5D;6GACyG;IACzG,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;oDAKgD;IAChD,KAAK,EAAE,OAAO,CAAC;IACf;;;6CAGyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,37 @@
+/** The one fact this module needs out of either transport's resource
+ *  config (`ResourceConfig` in `types.ts`, `RpcResourceConfig` in
+ *  `rpc-types.ts`) — deliberately narrower than either so this module
+ *  stays shared between both `createCratestackDataProvider` and
+ *  `createCratestackRpcDataProvider` rather than picking one transport's
+ *  type and asking the other to import it. Both real config types satisfy
+ *  this structurally already; nothing about them changes. */
+export interface VersionedResourceConfig {
+    versionField?: string;
+}
+/** `If-Match` is required on both `PATCH` (update) and `DELETE` for a
+ *  `@version` model (cratestack#493/#519, closed by #538 — the
+ *  delete-side enforcement deliberately mirrors the update path
+ *  token-for-token, `crates/cratestack-macros/src/axum/model/prep/etag.rs`).
+ *  refine's `update`/`deleteOne` hooks fetch the record before editing it
+ *  (`useOne`/`useShow` populate the edit form; a list/detail view is
+ *  usually on screen before a delete button is clicked), so the version
+ *  is available by the time a mutation fires — it just isn't part of
+ *  refine's `UpdateParams`/`DeleteOneParams` by default. This cache,
+ *  populated by every read and write that returns a fresh record, is how
+ *  the provider threads it through. One cache per `createCratestackDataProvider`
+ *  call, not module-global, so two providers (e.g. two tenants in the
+ *  same process) never cross-pollinate versions. */
+export declare function createVersionCache(): Map<string, number>;
+export declare function rememberVersion(cache: Map<string, number>, resource: string, id: unknown, record: Record<string, unknown>, config: VersionedResourceConfig): void;
+export declare function forgetVersion(cache: Map<string, number>, resource: string, id: unknown): void;
+/** Builds the `If-Match` header for a `@version` model's update/delete,
+ *  or `{}` for a model with no `versionField` configured (matching the
+ *  server's own behavior of not requiring one). Throws rather than
+ *  silently omitting `If-Match` when a version is required but unknown
+ *  — sending an update/delete with no `If-Match` against a `@version`
+ *  model doesn't fail loudly on the wire (cratestack#519/#538 gate on
+ *  the header's *presence*, so a caller can accidentally opt out of the
+ *  safety net exactly when it matters most), so this package refuses to
+ *  make that mistake on the caller's behalf. */
+export declare function ifMatchHeaders(cache: Map<string, number>, resource: string, id: unknown, config: VersionedResourceConfig, override?: number): HeadersInit;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;6DAM6D;AAC7D,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;oDAYoD;AACpD,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAExD;AAMD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,OAAO,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAMN;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAE7F;AAED;;;;;;;;gDAQgD;AAChD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,OAAO,EACX,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,WAAW,CAUb"}

package/dist/version.js

@@ -0,0 +1,50 @@
+/** `If-Match` is required on both `PATCH` (update) and `DELETE` for a
+ *  `@version` model (cratestack#493/#519, closed by #538 — the
+ *  delete-side enforcement deliberately mirrors the update path
+ *  token-for-token, `crates/cratestack-macros/src/axum/model/prep/etag.rs`).
+ *  refine's `update`/`deleteOne` hooks fetch the record before editing it
+ *  (`useOne`/`useShow` populate the edit form; a list/detail view is
+ *  usually on screen before a delete button is clicked), so the version
+ *  is available by the time a mutation fires — it just isn't part of
+ *  refine's `UpdateParams`/`DeleteOneParams` by default. This cache,
+ *  populated by every read and write that returns a fresh record, is how
+ *  the provider threads it through. One cache per `createCratestackDataProvider`
+ *  call, not module-global, so two providers (e.g. two tenants in the
+ *  same process) never cross-pollinate versions. */
+export function createVersionCache() {
+    return new Map();
+}
+function versionKey(resource, id) {
+    return `${resource}:${String(id)}`;
+}
+export function rememberVersion(cache, resource, id, record, config) {
+    if (!config.versionField)
+        return;
+    const version = record[config.versionField];
+    if (typeof version === "number") {
+        cache.set(versionKey(resource, id), version);
+    }
+}
+export function forgetVersion(cache, resource, id) {
+    cache.delete(versionKey(resource, id));
+}
+/** Builds the `If-Match` header for a `@version` model's update/delete,
+ *  or `{}` for a model with no `versionField` configured (matching the
+ *  server's own behavior of not requiring one). Throws rather than
+ *  silently omitting `If-Match` when a version is required but unknown
+ *  — sending an update/delete with no `If-Match` against a `@version`
+ *  model doesn't fail loudly on the wire (cratestack#519/#538 gate on
+ *  the header's *presence*, so a caller can accidentally opt out of the
+ *  safety net exactly when it matters most), so this package refuses to
+ *  make that mistake on the caller's behalf. */
+export function ifMatchHeaders(cache, resource, id, config, override) {
+    if (!config.versionField)
+        return {};
+    const version = override ?? cache.get(versionKey(resource, id));
+    if (version === undefined) {
+        throw new Error(`no known version for ${resource}/${String(id)} — call getOne (or getList) before ` +
+            "update/delete on a @version model, or pass meta: { ifMatch: <version> } explicitly");
+    }
+    return { "If-Match": `"${version}"` };
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;oDAYoD;AACpD,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,GAAG,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB,EAAE,EAAW;IAC/C,OAAO,GAAG,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAA0B,EAC1B,QAAgB,EAChB,EAAW,EACX,MAA+B,EAC/B,MAA+B;IAE/B,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,OAAO;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAA0B,EAAE,QAAgB,EAAE,EAAW;IACrF,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;gDAQgD;AAChD,MAAM,UAAU,cAAc,CAC5B,KAA0B,EAC1B,QAAgB,EAChB,EAAW,EACX,MAA+B,EAC/B,QAAiB;IAEjB,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAChE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,wBAAwB,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,qCAAqC;YACjF,oFAAoF,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,OAAO,GAAG,EAAE,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cratestack/refine",
-  "version": "0.7.14",
-  "description": "A refine.dev DataProvider over CrateStack's generated TypeScript REST client — the safe end-user admin-UI surface that goes through the generated API (policy, validation, @version concurrency, audit), unlike cratestack-studio's direct-to-database sysadmin access.",
+  "version": "0.7.17",
+  "description": "A refine.dev DataProvider over CrateStack's generated TypeScript client (REST or RPC) — the safe end-user admin-UI surface that goes through the generated API (policy, validation, @version concurrency, audit), unlike cratestack-studio's direct-to-database sysadmin access.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -35,7 +35,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "vitest run",
+    "test": "tsc --noEmit -p tsconfig.typecheck.json && vitest run",
     "lint": "biome check ."
   },
   "peerDependencies": {