@cratestack/refine 0.7.14 → 0.7.17

package/dist/index.js

@@ -0,0 +1,210 @@
+import { toRefineError } from "./errors.js";
+import { toQueryFilters, toSortQuery } from "./filters.js";
+import { createVersionCache, forgetVersion, ifMatchHeaders, rememberVersion } from "./version.js";
+export { isCratestackHttpError, toRefineError } from "./errors.js";
+export { toQueryFilters, toSortQuery } from "./filters.js";
+// RPC transport (`transport rpc` schemas) — additive sibling of the REST
+// exports above. See rpc-provider.ts's doc comment for how it differs.
+export { toRpcQueryFilters, toRpcSortQuery } from "./rpc-filters.js";
+export { createCratestackRpcDataProvider } from "./rpc-provider.js";
+function withRefineId(record, primaryKey) {
+    // The cast is honest, not a shortcut: cratestack's `@id` is always a
+    // scalar (Int, Cuid, String, …), all of which are `BaseKey` (`string |
+    // number`) at the JSON-decoded value level — `unknown` here is a gap
+    // in what `Row`'s index signature can express, not genuine uncertainty
+    // about the runtime type.
+    return { ...record, id: record[primaryKey] };
+}
+function requireResource(resources, resource) {
+    const config = resources[resource];
+    if (!config) {
+        throw new Error(`no cratestack resource configured for "${resource}" — add it to the "resources" map ` +
+            "passed to createCratestackDataProvider");
+    }
+    return config;
+}
+/** Builds a refine `DataProvider` over one or more cratestack generated
+ *  REST model classes (`client.widgets`, `client.ledgers`, …), given a
+ *  manifest describing each resource's primary-key field, `@@paged`
+ *  status, and `@version` field.
+ *
+ *  Write that manifest by hand, or generate it: `cratestack
+ *  generate-typescript --refine` emits a `src/refine.ts` next to the
+ *  client whose `cratestackRefineResources(client)` returns exactly this
+ *  {@link ResourceMap}. The provider itself is not generated and has no
+ *  CLI subcommand — see the package README's "A runtime package with a
+ *  generated manifest" section for the split.
+ *
+ *  RPC-transport schemas aren't wired here — see the README's "REST
+ *  only" note. */
+export function createCratestackDataProvider(resources, options = {}) {
+    const versionCache = createVersionCache();
+    async function getList(params) {
+        const config = requireResource(resources, params.resource);
+        const usePaging = config.paged && params.pagination?.mode !== "off";
+        const currentPage = params.pagination?.currentPage ?? 1;
+        const pageSize = params.pagination?.pageSize ?? 10;
+        const sort = toSortQuery(params.sorters);
+        const query = {
+            filters: toQueryFilters(params.filters),
+            ...(sort ? { sort } : {}),
+            ...(usePaging ? { limit: pageSize, offset: (currentPage - 1) * pageSize } : {}),
+        };
+        const result = await config.api.list({ query });
+        const items = config.paged ? result.items : result;
+        for (const item of items) {
+            rememberVersion(versionCache, params.resource, item[config.primaryKey], item, config);
+        }
+        return {
+            data: items.map((item) => withRefineId(item, config.primaryKey)),
+            // A non-`@@paged` resource has no server-computed total beyond what
+            // one page returned — `items.length` here is honest about *that*
+            // response, not a claim about the full row count. See the README's
+            // "Pagination" section before wiring page controls to one.
+            total: config.paged
+                ? (result.totalCount ?? items.length)
+                : items.length,
+        };
+    }
+    async function getOne(params) {
+        const config = requireResource(resources, params.resource);
+        try {
+            const record = (await config.api.get(params.id));
+            rememberVersion(versionCache, params.resource, params.id, record, config);
+            return { data: withRefineId(record, config.primaryKey) };
+        }
+        catch (error) {
+            throw toRefineError(error);
+        }
+    }
+    // Optional on `DataProvider` — refine only falls back to it when it's
+    // implemented. Because the `in` operator applies to any required
+    // field, including the primary key, this is one `list()` call rather
+    // than N `getOne` calls.
+    async function getMany(params) {
+        const config = requireResource(resources, params.resource);
+        const query = {
+            filters: { [`${config.primaryKey}__in`]: params.ids.map(String).join(",") },
+        };
+        const result = await config.api.list({ query });
+        const items = config.paged ? result.items : result;
+        for (const item of items) {
+            rememberVersion(versionCache, params.resource, item[config.primaryKey], item, config);
+        }
+        return { data: items.map((item) => withRefineId(item, config.primaryKey)) };
+    }
+    async function create(params) {
+        const config = requireResource(resources, params.resource);
+        if (!config.api.create) {
+            throw new Error(`"${params.resource}" has no generated create route — its model declares no ` +
+                '@@allow("create", ...) policy');
+        }
+        try {
+            const record = (await config.api.create(params.variables));
+            rememberVersion(versionCache, params.resource, record[config.primaryKey], record, config);
+            return { data: withRefineId(record, config.primaryKey) };
+        }
+        catch (error) {
+            throw toRefineError(error);
+        }
+    }
+    async function update(params) {
+        const config = requireResource(resources, params.resource);
+        const headers = ifMatchHeaders(versionCache, params.resource, params.id, config, params.meta?.ifMatch);
+        try {
+            const record = (await config.api.update(params.id, params.variables, { headers }));
+            rememberVersion(versionCache, params.resource, params.id, record, config);
+            return { data: withRefineId(record, config.primaryKey) };
+        }
+        catch (error) {
+            throw toRefineError(error);
+        }
+    }
+    async function deleteOne(params) {
+        const config = requireResource(resources, params.resource);
+        const headers = ifMatchHeaders(versionCache, params.resource, params.id, config, params.meta?.ifMatch);
+        try {
+            await config.api.delete(params.id, { headers });
+            return { data: { id: params.id } };
+        }
+        catch (error) {
+            throw toRefineError(error);
+        }
+        finally {
+            forgetVersion(versionCache, params.resource, params.id);
+        }
+    }
+    // createMany/updateMany/deleteMany: IMPLEMENTED, not declined — but as
+    // N sequential single-record round trips via Promise.all, each going
+    // through the same create/update/deleteOne above (so If-Match/version-
+    // cache/error-mapping behavior stays identical to the single-record
+    // path). This is a real, working implementation, just not an atomic
+    // or batched one: the generated REST client exposes no `updateMany`/
+    // `deleteMany` wrapper over the server's real `update_many`/
+    // `delete_many`, and REST-transport schemas have no `/rpc/batch`
+    // endpoint (that's RPC-transport only) — see the package README.
+    async function createMany(params) {
+        const meta = params.meta;
+        const records = await Promise.all(params.variables.map((variables) => create(meta
+            ? { resource: params.resource, variables, meta }
+            : { resource: params.resource, variables })));
+        return { data: records.map((r) => r.data) };
+    }
+    async function updateMany(params) {
+        const meta = params.meta;
+        const variables = params.variables;
+        const records = await Promise.all(params.ids.map((id) => update(meta
+            ? { resource: params.resource, id, variables, meta }
+            : { resource: params.resource, id, variables })));
+        return { data: records.map((r) => r.data) };
+    }
+    async function deleteMany(params) {
+        const meta = params.meta;
+        const variables = params.variables;
+        const records = await Promise.all(params.ids.map((id) => deleteOne(meta || variables
+            ? {
+                resource: params.resource,
+                id,
+                ...(variables ? { variables } : {}),
+                ...(meta ? { meta } : {}),
+            }
+            : { resource: params.resource, id })));
+        return { data: records.map((r) => r.data) };
+    }
+    async function custom(params) {
+        const procedureName = params.meta?.procedure;
+        const procedureFn = procedureName ? options.procedures?.[procedureName] : undefined;
+        if (typeof procedureFn !== "function") {
+            throw new Error('custom() needs meta: { procedure: "<name>" } naming an entry in the "procedures" map ' +
+                "passed to createCratestackDataProvider");
+        }
+        const data = await procedureFn(params.payload ?? {});
+        return { data: data };
+    }
+    // Cast, not a structural coincidence: `DataProvider`'s methods are
+    // individually generic over a caller-chosen `TData extends BaseRecord`
+    // (so a caller can write `getOne<Widget>(...)`), but this factory
+    // returns the SAME concrete implementation regardless of what a caller
+    // instantiates TData as — every method already returns a real
+    // `BaseRecord`-shaped value built from the real decoded response, and
+    // relies on the caller's own generic parameter for compile-time
+    // narrowing at the call site, exactly like every other hand-written
+    // `DataProvider` implementation (refine's own generic method shape
+    // isn't satisfiable by a concrete non-generic function under
+    // `exactOptionalPropertyTypes`, a known TypeScript variance gap, not a
+    // real type-safety hole here).
+    return {
+        getApiUrl: options.getApiUrl ?? (() => ""),
+        getList,
+        getOne,
+        getMany,
+        create,
+        createMany,
+        update,
+        updateMany,
+        deleteOne,
+        deleteMany,
+        custom,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/rpc-filters.d.ts

@@ -0,0 +1,25 @@
+import type { CrudFilters, CrudSorting } from "@refinedev/core";
+import type { RpcListPredicate } from "./rpc-types.js";
+/** Converts refine's `CrudFilters` into `RpcListPredicate[]` — the RPC
+ *  list route's typed equivalent of REST's `field__operator=value` query
+ *  params (`toQueryFilters` in `filters.ts`). Same operator table, same
+ *  `field[__suffix]` key on each predicate's `key`, same throw-don't-drop
+ *  behavior for an unsupported operator or a refine filter group — see
+ *  `filter-operators.ts` for why the two transports share the mapping
+ *  rather than each defining their own, and
+ *  `crates/cratestack-axum/src/rpc/synthesize.rs` for the server-side
+ *  proof that an `RpcListPredicate.key` is spread onto the same
+ *  `field__op=value` query string REST's `field__operator` convention
+ *  parses. */
+export declare function toRpcQueryFilters(filters?: CrudFilters): RpcListPredicate[];
+/** refine `CrudSorting` -> the RPC list route's `sort` value: the same
+ *  `field`/`-field` comma-joined DSL as REST's `toSortQuery` (confirmed
+ *  against `crates/cratestack-macros/src/axum/model/serializers.rs`'s
+ *  `sort.split(',')` parsing, shared by both transports since RPC
+ *  synthesizes a REST-shaped query string server-side), sent as a single
+ *  already-joined string instead of REST's `string[]` — the one place
+ *  `CratestackRpcListQuery` and `CratestackFetchQuery` genuinely diverge
+ *  in shape (`RpcListInput.sort: Option<String>` vs. an array joined
+ *  client-side by REST's own runtime). */
+export declare function toRpcSortQuery(sorters?: CrudSorting): string | undefined;
+//# sourceMappingURL=rpc-filters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-filters.d.ts","sourceRoot":"","sources":["../src/rpc-filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;;;;;cAUc;AACd,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,WAAgB,GAAG,gBAAgB,EAAE,CAc/E;AAED;;;;;;;;0CAQ0C;AAC1C,wBAAgB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,MAAM,GAAG,SAAS,CAG5E"}

package/dist/rpc-filters.js

@@ -0,0 +1,40 @@
+import { filterValue, requireOperatorSuffix } from "./filter-operators.js";
+/** Converts refine's `CrudFilters` into `RpcListPredicate[]` — the RPC
+ *  list route's typed equivalent of REST's `field__operator=value` query
+ *  params (`toQueryFilters` in `filters.ts`). Same operator table, same
+ *  `field[__suffix]` key on each predicate's `key`, same throw-don't-drop
+ *  behavior for an unsupported operator or a refine filter group — see
+ *  `filter-operators.ts` for why the two transports share the mapping
+ *  rather than each defining their own, and
+ *  `crates/cratestack-axum/src/rpc/synthesize.rs` for the server-side
+ *  proof that an `RpcListPredicate.key` is spread onto the same
+ *  `field__op=value` query string REST's `field__operator` convention
+ *  parses. */
+export function toRpcQueryFilters(filters = []) {
+    const output = [];
+    for (const filter of filters) {
+        if (!("field" in filter)) {
+            throw new Error(`refine "${filter.operator}" filter groups have no cratestack equivalent — ` +
+                "this dataProvider only supports a flat AND of per-field predicates");
+        }
+        const suffix = requireOperatorSuffix(filter.field, filter.operator);
+        const key = suffix ? `${filter.field}__${suffix}` : filter.field;
+        output.push({ key, value: filterValue(filter.operator, filter.value) });
+    }
+    return output;
+}
+/** refine `CrudSorting` -> the RPC list route's `sort` value: the same
+ *  `field`/`-field` comma-joined DSL as REST's `toSortQuery` (confirmed
+ *  against `crates/cratestack-macros/src/axum/model/serializers.rs`'s
+ *  `sort.split(',')` parsing, shared by both transports since RPC
+ *  synthesizes a REST-shaped query string server-side), sent as a single
+ *  already-joined string instead of REST's `string[]` — the one place
+ *  `CratestackRpcListQuery` and `CratestackFetchQuery` genuinely diverge
+ *  in shape (`RpcListInput.sort: Option<String>` vs. an array joined
+ *  client-side by REST's own runtime). */
+export function toRpcSortQuery(sorters = []) {
+    if (sorters.length === 0)
+        return undefined;
+    return sorters.map((s) => (s.order === "desc" ? `-${s.field}` : s.field)).join(",");
+}
+//# sourceMappingURL=rpc-filters.js.map

package/dist/rpc-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-filters.js","sourceRoot":"","sources":["../src/rpc-filters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG3E;;;;;;;;;;cAUc;AACd,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAgB,EAAE;IACzD,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,WAAW,MAAM,CAAC,QAAQ,kDAAkD;gBAC1E,oEAAoE,CACvE,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;0CAQ0C;AAC1C,MAAM,UAAU,cAAc,CAAC,OAAO,GAAgB,EAAE;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtF,CAAC"}

package/dist/rpc-many.d.ts

@@ -0,0 +1,16 @@
+import type { CreateManyParams, CreateManyResponse, CreateParams, CreateResponse, DeleteManyParams, DeleteManyResponse, DeleteOneParams, DeleteOneResponse, UpdateManyParams, UpdateManyResponse, UpdateParams, UpdateResponse } from "@refinedev/core";
+/** `createMany`/`updateMany`/`deleteMany`, factored out of
+ *  `rpc-provider.ts` because the N-sequential-round-trips-via-`Promise.all`
+ *  strategy is entirely refine-shaped, not RPC-shaped — it just replays
+ *  the single-record `create`/`update`/`deleteOne` closure N times, so it
+ *  doesn't need to know which transport those closures talk over. Same
+ *  strategy REST's `createCratestackDataProvider` uses inline (not
+ *  reused from here, to keep this change additive rather than touching
+ *  already-shipped REST code) — see that file's own comment for why this
+ *  is IMPLEMENTED, not declined: real behavior, just not atomic or
+ *  batched (`/rpc/batch` exists on this transport, but batching would
+ *  make per-frame `If-Match` inexpressible — see `rpc-provider.ts`). */
+export declare function runCreateMany(params: CreateManyParams, create: (p: CreateParams) => Promise<CreateResponse>): Promise<CreateManyResponse>;
+export declare function runUpdateMany(params: UpdateManyParams, update: (p: UpdateParams) => Promise<UpdateResponse>): Promise<UpdateManyResponse>;
+export declare function runDeleteMany(params: DeleteManyParams, deleteOne: (p: DeleteOneParams) => Promise<DeleteOneResponse>): Promise<DeleteManyResponse>;
+//# sourceMappingURL=rpc-many.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-many.d.ts","sourceRoot":"","sources":["../src/rpc-many.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;wEAUwE;AACxE,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,GACnD,OAAO,CAAC,kBAAkB,CAAC,CAY7B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,GACnD,OAAO,CAAC,kBAAkB,CAAC,CAa7B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC,GAC5D,OAAO,CAAC,kBAAkB,CAAC,CAkB7B"}

package/dist/rpc-many.js

@@ -0,0 +1,40 @@
+/** `createMany`/`updateMany`/`deleteMany`, factored out of
+ *  `rpc-provider.ts` because the N-sequential-round-trips-via-`Promise.all`
+ *  strategy is entirely refine-shaped, not RPC-shaped — it just replays
+ *  the single-record `create`/`update`/`deleteOne` closure N times, so it
+ *  doesn't need to know which transport those closures talk over. Same
+ *  strategy REST's `createCratestackDataProvider` uses inline (not
+ *  reused from here, to keep this change additive rather than touching
+ *  already-shipped REST code) — see that file's own comment for why this
+ *  is IMPLEMENTED, not declined: real behavior, just not atomic or
+ *  batched (`/rpc/batch` exists on this transport, but batching would
+ *  make per-frame `If-Match` inexpressible — see `rpc-provider.ts`). */
+export async function runCreateMany(params, create) {
+    const meta = params.meta;
+    const records = await Promise.all(params.variables.map((variables) => create(meta
+        ? { resource: params.resource, variables, meta }
+        : { resource: params.resource, variables })));
+    return { data: records.map((r) => r.data) };
+}
+export async function runUpdateMany(params, update) {
+    const meta = params.meta;
+    const variables = params.variables;
+    const records = await Promise.all(params.ids.map((id) => update(meta
+        ? { resource: params.resource, id, variables, meta }
+        : { resource: params.resource, id, variables })));
+    return { data: records.map((r) => r.data) };
+}
+export async function runDeleteMany(params, deleteOne) {
+    const meta = params.meta;
+    const variables = params.variables;
+    const records = await Promise.all(params.ids.map((id) => deleteOne(meta || variables
+        ? {
+            resource: params.resource,
+            id,
+            ...(variables ? { variables } : {}),
+            ...(meta ? { meta } : {}),
+        }
+        : { resource: params.resource, id })));
+    return { data: records.map((r) => r.data) };
+}
+//# sourceMappingURL=rpc-many.js.map

package/dist/rpc-many.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-many.js","sourceRoot":"","sources":["../src/rpc-many.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;wEAUwE;AACxE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAwB,EACxB,MAAoD;IAEpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACjC,MAAM,CACJ,IAAI;QACF,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;QAChD,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,CAC7C,CACF,CACF,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAwB,EACxB,MAAoD;IAEpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACpB,MAAM,CACJ,IAAI;QACF,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;QACpD,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,CACjD,CACF,CACF,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAwB,EACxB,SAA6D;IAE7D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACpB,SAAS,CACP,IAAI,IAAI,SAAS;QACf,CAAC,CAAC;YACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,EAAE;YACF,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1B;QACH,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,CACtC,CACF,CACF,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9C,CAAC"}

package/dist/rpc-provider.d.ts

@@ -0,0 +1,30 @@
+import type { DataProvider } from "@refinedev/core";
+import type { RpcResourceMap } from "./rpc-types.js";
+export interface CreateCratestackRpcDataProviderOptions {
+    /** Backs `getApiUrl()`. Defaults to `() => ""`, same as the REST
+     *  provider — see `CreateCratestackDataProviderOptions.getApiUrl` in
+     *  `index.ts` for why refine rarely calls this in practice. */
+    getApiUrl?: () => string;
+    /** Backs `custom()` — identical contract to the REST provider's
+     *  `procedures` option (`CreateCratestackDataProviderOptions.procedures`
+     *  in `index.ts`): keyed by procedure name, called as
+     *  `client.procedures.<name>` would be. */
+    procedures?: Record<string, (args: unknown) => Promise<unknown>>;
+}
+/** Builds a refine `DataProvider` over one or more `transport rpc`
+ *  cratestack generated model classes (`client.widgets`, `client.ledgers`,
+ *  …) — the RPC sibling of `createCratestackDataProvider` in `index.ts`.
+ *  Same manifest shape (`RpcResourceMap`), same filter/pagination/
+ *  primary-key/optimistic-locking semantics; only the wire calls
+ *  underneath differ, because the generated RPC client's `list` takes its
+ *  query positionally instead of nested in an options object (see
+ *  `rpc-types.ts`'s `CratestackRpcModelApi` doc comment).
+ *
+ *  Deliberately uses only unary `POST /rpc/{op_id}` calls, never
+ *  `POST /rpc/batch` — a batch request is a single HTTP request carrying
+ *  N frames, so a per-frame `If-Match` header (what `@version` optimistic
+ *  locking needs) is not expressible there. `createMany`/`updateMany`/
+ *  `deleteMany` below are N real unary round trips for exactly that
+ *  reason, same as REST's non-atomic N-round-trip strategy. */
+export declare function createCratestackRpcDataProvider(resources: RpcResourceMap, options?: CreateCratestackRpcDataProviderOptions): DataProvider;
+//# sourceMappingURL=rpc-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-provider.d.ts","sourceRoot":"","sources":["../src/rpc-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EASV,YAAY,EAeb,MAAM,iBAAiB,CAAC;AAIzB,OAAO,KAAK,EAA6C,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAuBhG,MAAM,WAAW,sCAAsC;IACrD;;mEAE+D;IAC/D,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB;;;+CAG2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CAClE;AAED;;;;;;;;;;;;;;+DAc+D;AAC/D,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,cAAc,EACzB,OAAO,GAAE,sCAA2C,GACnD,YAAY,CAsJd"}

package/dist/rpc-provider.js

@@ -0,0 +1,159 @@
+import { toRefineError } from "./errors.js";
+import { toRpcQueryFilters, toRpcSortQuery } from "./rpc-filters.js";
+import { runCreateMany, runDeleteMany, runUpdateMany } from "./rpc-many.js";
+import { createVersionCache, forgetVersion, ifMatchHeaders, rememberVersion } from "./version.js";
+function withRefineId(record, primaryKey) {
+    // Same honest cast as REST's `withRefineId` in `index.ts` — see that
+    // function's doc comment.
+    return { ...record, id: record[primaryKey] };
+}
+function requireResource(resources, resource) {
+    const config = resources[resource];
+    if (!config) {
+        throw new Error(`no cratestack resource configured for "${resource}" — add it to the "resources" map ` +
+            "passed to createCratestackRpcDataProvider");
+    }
+    return config;
+}
+/** Builds a refine `DataProvider` over one or more `transport rpc`
+ *  cratestack generated model classes (`client.widgets`, `client.ledgers`,
+ *  …) — the RPC sibling of `createCratestackDataProvider` in `index.ts`.
+ *  Same manifest shape (`RpcResourceMap`), same filter/pagination/
+ *  primary-key/optimistic-locking semantics; only the wire calls
+ *  underneath differ, because the generated RPC client's `list` takes its
+ *  query positionally instead of nested in an options object (see
+ *  `rpc-types.ts`'s `CratestackRpcModelApi` doc comment).
+ *
+ *  Deliberately uses only unary `POST /rpc/{op_id}` calls, never
+ *  `POST /rpc/batch` — a batch request is a single HTTP request carrying
+ *  N frames, so a per-frame `If-Match` header (what `@version` optimistic
+ *  locking needs) is not expressible there. `createMany`/`updateMany`/
+ *  `deleteMany` below are N real unary round trips for exactly that
+ *  reason, same as REST's non-atomic N-round-trip strategy. */
+export function createCratestackRpcDataProvider(resources, options = {}) {
+    const versionCache = createVersionCache();
+    async function getList(params) {
+        const config = requireResource(resources, params.resource);
+        const usePaging = config.paged && params.pagination?.mode !== "off";
+        const currentPage = params.pagination?.currentPage ?? 1;
+        const pageSize = params.pagination?.pageSize ?? 10;
+        const sort = toRpcSortQuery(params.sorters);
+        const query = {
+            filters: toRpcQueryFilters(params.filters),
+            ...(sort ? { sort } : {}),
+            ...(usePaging ? { limit: pageSize, offset: (currentPage - 1) * pageSize } : {}),
+        };
+        const result = await config.api.list(query);
+        const items = config.paged ? result.items : result;
+        for (const item of items) {
+            rememberVersion(versionCache, params.resource, item[config.primaryKey], item, config);
+        }
+        return {
+            data: items.map((item) => withRefineId(item, config.primaryKey)),
+            total: config.paged
+                ? (result.totalCount ?? items.length)
+                : items.length,
+        };
+    }
+    async function getOne(params) {
+        const config = requireResource(resources, params.resource);
+        try {
+            const record = (await config.api.get(params.id));
+            rememberVersion(versionCache, params.resource, params.id, record, config);
+            return { data: withRefineId(record, config.primaryKey) };
+        }
+        catch (error) {
+            throw toRefineError(error);
+        }
+    }
+    // Same one-list-call-instead-of-N-getOne-calls strategy as REST's
+    // `getMany` — see that function's comment in `index.ts`.
+    async function getMany(params) {
+        const config = requireResource(resources, params.resource);
+        const query = {
+            filters: [{ key: `${config.primaryKey}__in`, value: params.ids.map(String).join(",") }],
+        };
+        const result = await config.api.list(query);
+        const items = config.paged ? result.items : result;
+        for (const item of items) {
+            rememberVersion(versionCache, params.resource, item[config.primaryKey], item, config);
+        }
+        return { data: items.map((item) => withRefineId(item, config.primaryKey)) };
+    }
+    async function create(params) {
+        const config = requireResource(resources, params.resource);
+        if (!config.api.create) {
+            throw new Error(`"${params.resource}" has no generated create route — its model declares no ` +
+                '@@allow("create", ...) policy');
+        }
+        try {
+            const record = (await config.api.create(params.variables));
+            rememberVersion(versionCache, params.resource, record[config.primaryKey], record, config);
+            return { data: withRefineId(record, config.primaryKey) };
+        }
+        catch (error) {
+            throw toRefineError(error);
+        }
+    }
+    async function update(params) {
+        const config = requireResource(resources, params.resource);
+        const headers = ifMatchHeaders(versionCache, params.resource, params.id, config, params.meta?.ifMatch);
+        try {
+            const record = (await config.api.update(params.id, params.variables, { headers }));
+            rememberVersion(versionCache, params.resource, params.id, record, config);
+            return { data: withRefineId(record, config.primaryKey) };
+        }
+        catch (error) {
+            throw toRefineError(error);
+        }
+    }
+    async function deleteOne(params) {
+        const config = requireResource(resources, params.resource);
+        const headers = ifMatchHeaders(versionCache, params.resource, params.id, config, params.meta?.ifMatch);
+        try {
+            await config.api.delete(params.id, { headers });
+            return { data: { id: params.id } };
+        }
+        catch (error) {
+            throw toRefineError(error);
+        }
+        finally {
+            forgetVersion(versionCache, params.resource, params.id);
+        }
+    }
+    async function createMany(params) {
+        return runCreateMany(params, create);
+    }
+    async function updateMany(params) {
+        return runUpdateMany(params, update);
+    }
+    async function deleteMany(params) {
+        return runDeleteMany(params, deleteOne);
+    }
+    async function custom(params) {
+        const procedureName = params.meta?.procedure;
+        const procedureFn = procedureName ? options.procedures?.[procedureName] : undefined;
+        if (typeof procedureFn !== "function") {
+            throw new Error('custom() needs meta: { procedure: "<name>" } naming an entry in the "procedures" map ' +
+                "passed to createCratestackRpcDataProvider");
+        }
+        const data = await procedureFn(params.payload ?? {});
+        return { data: data };
+    }
+    // Same cast, same reasoning as REST's `createCratestackDataProvider` —
+    // see that function's closing comment in `index.ts`.
+    return {
+        getApiUrl: options.getApiUrl ?? (() => ""),
+        getList,
+        getOne,
+        getMany,
+        create,
+        createMany,
+        update,
+        updateMany,
+        deleteOne,
+        deleteMany,
+        custom,
+    };
+}
+//# sourceMappingURL=rpc-provider.js.map

package/dist/rpc-provider.js.map

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