@nkzw/fate 1.5.0 → 1.5.2

package/lib/index.mjs

@@ -1,7 +1,7 @@
 import { t as isRecord } from "./record-B07VwXd-.mjs";
 import { a as hashArgs, c as scopeArgsPayload, i as filterConnectionArgs, r as combineArgsPayload, s as resolvedArgsFromPlan, t as applyArgsPayloadToPlan } from "./args-CRLIRl_v.mjs";
 import { _ as isNodesItem, a as createNodeRef, c as ConnectionTag, f as RootKind, g as isNodeItem, i as resolveHydrationLimits, l as DeferTag, m as ViewsTag, o as getNodeRefId, r as encodeHydrationValue, s as isNodeRef, t as decodeClientHydrationState, u as DeferredTag, v as isQueryItem, y as isViewTag } from "./hydration-DPZRJgnu.mjs";
-import { C as isDeferredSelection, S as isDeferred, _ as view, a as mutation, b as getDeferredMetadata, c as getDeferredSelectionPlan, d as createRefWithViewNames, f as getRootViewNames, g as getViewPayloads, h as getViewNames, l as getSelectionPlan, m as toEntityId, n as getListKey, p as parseEntityId, r as mergePreservingExisting, s as wrapMutation, t as Store, u as assignViewTag, v as createDeferred, x as getDeferredSelection, y as defer } from "./store-CeatPJeK.mjs";
+import { C as isDeferredSelection, S as isDeferred, _ as view, a as mutation, b as getDeferredMetadata, c as getDeferredSelectionPlan, d as createRefWithViewNames, f as getRootViewNames, g as getViewPayloads, h as getViewNames, l as getSelectionPlan, m as toEntityId, n as getListKey, p as parseEntityId, r as mergePreservingExisting, s as wrapMutation, t as Store, u as assignViewTag, v as createDeferred, x as getDeferredSelection, y as defer } from "./store-CakBBzWG.mjs";
 import { t as getListEntries } from "./list-_6fXYLtJ.mjs";
 import { n as errorCodeFromStatus, t as FateRequestError } from "./protocol-DS5sf6sd.mjs";
 import { n as graphqlMutation, t as createGraphQLTransport } from "./graphqlTransport-DmheG3AO.mjs";
@@ -478,7 +478,7 @@ var FateClient = class {
 		this.store = new Store((ids) => {
 			for (const id of ids) this.viewDataCache.invalidate(id);
 			this.runPendingGarbageCollection();
-		}, (kind, key, paths, previousList) => this.persistence?.changed(kind, key, paths, previousList));
+		}, (change) => this.persistenceRuntime?.changed(change));
 		this.viewDataCache = new ViewDataCache(() => !this.store.isRebasing);
 		this.liveConnectionInvalidationToken = 0;
 		this.persistenceDisposal = options.persistence ? new AbortController() : void 0;
@@ -508,7 +508,8 @@ var FateClient = class {
 			setNestedValue(this.actions, key, async (_previousState, data) => data === "reset" ? null : await this.mutationMap[key](data));
 		}
 		this.initializeParentLists();
-		this.persistence = options.persistence?.attach(this);
+		this.persistenceRuntime = options.persistence?.attach(this);
+		this.persistence = this.persistenceRuntime;
 	}
 	initializeParentLists() {
 		for (const config of this.types.values()) {
@@ -704,6 +705,11 @@ var FateClient = class {
 		if (this.mutationEntities?.size) this.requireDurableMutationTransport();
 	}
 	/** @internal */
+	persistMutation(command) {
+		if (!this.persistenceRuntime) throw new Error("fate: Persistence is not configured.");
+		return this.persistenceRuntime.mutate(command);
+	}
+	/** @internal */
 	assertPersistenceActive() {
 		if (this.persistenceDisposal?.signal.aborted || this.persistence?.getSnapshot().status === "disposed") throw new Error("fate: Persistence was disposed.");
 	}
@@ -828,7 +834,8 @@ var FateClient = class {
 			const pendingPromise = this.pending.get(key) || null;
 			if (pendingPromise) return pendingPromise;
 			const promise = this.trackPendingRequest(async () => {
-				if (this.persistence) {
+				const persistence = this.persistenceRuntime;
+				if (persistence) {
 					const persistedRequest = {
 						items: [{
 							ids: [id],
@@ -841,11 +848,11 @@ var FateClient = class {
 						}],
 						key: `view:${key}`
 					};
-					await this.persistence.restoreRequest(persistedRequest);
+					await persistence.restoreRequest(persistedRequest);
 					const remaining = this.store.missingForSelection(entityId, selectedPaths);
 					if (remaining.size) {
 						await this.fetchByIdAndNormalize(type, [id], remaining, plan);
-						this.persistence.fetched({
+						persistence.fetched({
 							...persistedRequest,
 							items: persistedRequest.items.map((item) => ({
 								...item,
@@ -1433,15 +1440,16 @@ var FateClient = class {
 	}
 	requestWithDescriptor(descriptor, mode, { revalidateExisting }, options) {
 		this.assertPersistenceActive();
-		if (this.persistence && options?.persist && (!Number.isSafeInteger(options.persist.maxAge) || options.persist.maxAge < 0 || options.persist.maxAge > Number.MAX_SAFE_INTEGER - Date.now())) throw new Error("fate: Persistence maxAge must be a non-negative finite duration.");
+		const persistence = this.persistenceRuntime;
+		if (persistence && options?.persist && (!Number.isSafeInteger(options.persist.maxAge) || options.persist.maxAge < 0 || options.persist.maxAge > Number.MAX_SAFE_INTEGER - Date.now())) throw new Error("fate: Persistence maxAge must be a non-negative finite duration.");
 		const requestKey = descriptor.key;
 		const existingRequest = this.requests.get(requestKey)?.get(mode);
 		if (existingRequest) {
-			if (this.persistence && options?.persist) {
+			if (persistence && options?.persist) {
 				const executionOptions = this.requestExecutionOptions.get(existingRequest.descriptor);
 				if (executionOptions) executionOptions.persist = { ...options.persist };
 			}
-			if (this.persistence && options?.persist && existingRequest.status === "fulfilled") this.persistence.used(existingRequest.descriptor, options.persist);
+			if (persistence && options?.persist && existingRequest.status === "fulfilled") persistence.used(existingRequest.descriptor, options.persist);
 			const isFulfilledCacheFirstWithMissingData = mode === "cache-first" && existingRequest.status === "fulfilled" && !this.hasRequestData(existingRequest.descriptor);
 			if (existingRequest.status !== "pending" && (isFulfilledCacheFirstWithMissingData || revalidateExisting && (mode === "network-only" || mode === "stale-while-revalidate" || mode === "cache-first" && existingRequest.status === "rejected"))) this.executeRequestHandle(existingRequest, mode, options);
 			return existingRequest;
@@ -1562,17 +1570,18 @@ var FateClient = class {
 		}
 	}
 	executeRequestHandle(handle, mode, options) {
+		const persistence = this.persistenceRuntime;
 		const executionOptions = {
 			fetchAll: mode !== "cache-first",
 			persist: options?.persist ? { ...options.persist } : void 0
 		};
-		if (this.persistence) this.requestExecutionOptions.set(handle.descriptor, executionOptions);
+		if (persistence) this.requestExecutionOptions.set(handle.descriptor, executionOptions);
 		const execute = () => {
 			this.assertPersistenceActive();
 			if (mode === "stale-while-revalidate") return this.handleStoreAndNetworkRequest(handle.descriptor, executionOptions);
 			return this.executeRequest(handle.descriptor, executionOptions).then(() => this.getRequestResultFromDescriptor(handle.descriptor));
 		};
-		handle.start(this.persistence ? this.withPersistenceLifecycle(() => this.persistence.ready.then(() => mode === "network-only" ? void 0 : this.persistence.restoreRequest(handle.descriptor)).then(execute)) : execute());
+		handle.start(persistence ? this.withPersistenceLifecycle(() => persistence.ready.then(() => mode === "network-only" ? void 0 : persistence.restoreRequest(handle.descriptor)).then(execute)) : execute());
 	}
 	markRecordReferences(record, markRecord) {
 		const seen = /* @__PURE__ */ new Set();
@@ -1625,7 +1634,7 @@ var FateClient = class {
 				return await this.withPersistenceLifecycle(request);
 			} finally {
 				this.pendingNetworkRequests -= 1;
-				this.persistence?.changed();
+				this.persistenceRuntime?.changed();
 			}
 		});
 	}
@@ -1714,12 +1723,13 @@ var FateClient = class {
 			fetchedItems.push(item);
 		}
 		await Promise.all([...promises, ...Array.from(groups.values()).map((group) => group.ids.length ? this.fetchByIdAndNormalize(group.type, group.ids, group.fields, group.plan) : Promise.resolve())]);
-		if (this.persistence) {
-			if (fetchedItems.length) this.persistence.fetched(fetchedAll ? request : {
+		const persistence = this.persistenceRuntime;
+		if (persistence) {
+			if (fetchedItems.length) persistence.fetched(fetchedAll ? request : {
 				items: fetchedItems,
 				key: `partial:${JSON.stringify([request.key, fetchedItems.map((item) => [item.name, "ids" in item ? item.ids : null])])}`
 			}, options.persist);
-			if (!fetchedItems.length || !fetchedAll) this.persistence.used(request, options.persist);
+			if (!fetchedItems.length || !fetchedAll) persistence.used(request, options.persist);
 		}
 	}
 	hasRequestData(request) {

package/lib/{list-BRT1VtiT.d.mts → list-5hrTVoiB.d.mts}

@@ -1,4 +1,4 @@
-import { O as EntityId, g as List } from "./transport-DqjhjLfC.mjs";
+import { A as EntityId, v as List } from "./transport-DR0fwleU.mjs";
 //#region src/list.d.ts
 type ListEntry = Readonly<{
   cursor?: string;

package/lib/list.d.mts

@@ -1,2 +1,2 @@
-import { n as getListEntries, t as ListEntry } from "./list-BRT1VtiT.mjs";
+import { n as getListEntries, t as ListEntry } from "./list-5hrTVoiB.mjs";
 export { ListEntry, getListEntries };

package/lib/persistence.d.mts

@@ -1,29 +1,25 @@
-import { a as PersistenceSession, i as Persistence, o as PersistenceSnapshot } from "./transport-DqjhjLfC.mjs";
+import { a as Persistence, c as RequestPersistenceOptions, i as PersistedMutationStatus, o as PersistenceSession, s as PersistenceSnapshot } from "./transport-DR0fwleU.mjs";
 //#region src/persistence.d.ts
 /**
- * Backend-neutral durable storage. Writes replace one value atomically and resolve
- * only after commit. Exclusive sections must coordinate ALL instances using this
- * key (including other tabs/processes). Use distinct lock names independently.
+ * Backend-neutral durable storage. Batches apply atomically and resolve only after
+ * commit. Exclusive sections must coordinate ALL instances using this key
+ * (including other tabs/processes). Use distinct lock names independently.
  */
-interface PersistenceStorage {
+export type PersistenceStorageEntry = Readonly<{
+  key: string;
+  value: unknown;
+}>;
+export type PersistenceStorageWrite = readonly [key: string, value: unknown];
+export interface PersistenceStorage {
   exclusive<T>(key: string, run: () => Promise<T>): Promise<T>;
   read(key: string): Promise<unknown>;
   /** Ordered, bounded scan. Return keys strictly after `after`, under `prefix`. */
-  scan(prefix: string, after?: string, limit?: number): Promise<Array<{
-    key: string;
-    value: unknown;
-  }>>;
+  scan(prefix: string, after?: string, limit?: number): Promise<Array<PersistenceStorageEntry>>;
   subscribe?(key: string, listener: () => void): () => void;
-  write(key: string, value: unknown): Promise<void>;
   /** Atomically apply a batch. Undefined deletes the key. */
-  writeBatch(entries: ReadonlyArray<readonly [string, unknown]>): Promise<void>;
+  writeBatch(entries: ReadonlyArray<PersistenceStorageWrite>): Promise<void>;
 }
-/**
- * Enables cache persistence and durable delivery through the existing mutation API.
- * Import this entry point only in applications using persistence. Storage keys must
- * isolate authenticated accounts/workspaces and match the server's identity scope.
- */
-declare function createPersistence({ key, maxAge, maxBytes, online, retryDelay, storage }: {
+export type PersistenceOptions = Readonly<{
   key: string;
   /** Maximum disk retention since a successful fetch, in milliseconds. Defaults to one day. */
   maxAge?: number;
@@ -33,6 +29,12 @@ declare function createPersistence({ key, maxAge, maxBytes, online, retryDelay,
   online?: () => boolean;
   retryDelay?: number;
   storage: PersistenceStorage;
-}): Persistence;
+}>;
+/**
+ * Enables cache persistence and durable delivery through the existing mutation API.
+ * Import this entry point only in applications using persistence. Storage keys must
+ * isolate authenticated accounts/workspaces and match the server's identity scope.
+ */
+export declare function createPersistence({ key, maxAge, maxBytes, online, retryDelay, storage }: PersistenceOptions): Persistence;
 //#endregion
-export { type Persistence, type PersistenceSession, type PersistenceSnapshot, PersistenceStorage, createPersistence };
+export type { PersistedMutationStatus, Persistence, PersistenceSession, PersistenceSnapshot, RequestPersistenceOptions };