@xnetjs/data 1.0.0 → 2.0.0

package/dist/{store-B0fb6WdJ.d.ts → store-BIDKtpjW.d.ts}

@@ -1,4 +1,4 @@
-import { e as StoreAuthAPI, f as NodeStoreOptions, g as NodeStorageAdapter, C as CreateNodeOptions, h as NodeState, i as NodeId, G as GetWithMigrationOptions, M as MigratedNodeState, U as UpdateNodeOptions, L as ListNodesOptions, j as NodeQueryDescriptor, k as NodeQueryResult, T as TransactionOperation, l as TransactionResult, m as DeterministicNodeImportDraft, n as ImportDeterministicNodesOptions, o as ImportDeterministicNodesResult, p as NodeBatchWriteInput, q as NodeBatchWriteResult, S as SchemaIRI, r as NodeChange, s as MergeConflict, t as NodeChangeListener, u as NodeBatchChangeListener } from './types-B5rrBwRI.js';
+import { e as StoreAuthAPI, f as NodeStoreOptions, g as NodeStorageAdapter, C as CreateNodeOptions, h as NodeState, i as NodeId, j as CheckedOutDraftOverlay, G as GetWithMigrationOptions, M as MigratedNodeState, U as UpdateNodeOptions, L as ListNodesOptions, k as NodeQueryDescriptor, l as NodeQueryResult, T as TransactionOperation, m as TransactionResult, n as DeterministicNodeImportDraft, o as ImportDeterministicNodesOptions, p as ImportDeterministicNodesResult, q as NodeBatchWriteInput, r as NodeBatchWriteResult, S as SchemaIRI, s as NodeChange, t as MergeConflict, u as NodeChangeListener, v as NodeBatchChangeListener } from './types-C64g-IXg.js';
 
 /**
  * NodeStore - Event-sourced storage for Nodes
@@ -26,6 +26,13 @@ declare class NodeStore {
     private listeners;
     private nodeListeners;
     private batchListeners;
+    private checkedOutDraft;
+    private cloneToOriginal;
+    private draftMemberSet;
+    private draftDynamicMembers;
+    /** null = conservative "all schemas" (memberSchemaIds omitted). */
+    private draftMemberSchemaSet;
+    private draftOverlayListeners;
     private schemaLookup?;
     private propertyLookup?;
     private lensRegistry?;
@@ -62,6 +69,54 @@ declare class NodeStore {
      * Get a Node by ID.
      */
     get(id: NodeId): Promise<NodeState | null>;
+    /**
+     * Read a node WITHOUT the draft overlay (exploration 0329) — merge review
+     * and diff surfaces use this to see main's true state while checked out.
+     */
+    getRaw(id: NodeId): Promise<NodeState | null>;
+    /**
+     * Check a draft out (or pass null to return to main). While checked out,
+     * member reads swap to clone content under original ids, member writes
+     * redirect to clones (lazily forking via `onMissingMember`), and clone
+     * change events mirror to original-id subscribers.
+     */
+    setCheckedOutDraft(overlay: CheckedOutDraftOverlay | null): void;
+    /** Report a locally-created node to the checkout's draft-born hook (0329 P4). */
+    private notifyDraftNodeCreated;
+    private notifyDraftOverlayListeners;
+    getCheckedOutDraft(): CheckedOutDraftOverlay | null;
+    /**
+     * Device-local draft privacy (exploration 0329): ids marked here (draft
+     * bookkeeping nodes, clones, draft-born nodes) are excluded from outbound
+     * sync publication by the personal node-sync room's `shouldPublish`
+     * predicate. In-memory only — the draft module rehydrates it from open
+     * Draft nodes at boot, BEFORE sync starts.
+     */
+    private draftPrivateNodeIds;
+    markDraftPrivate(ids: readonly NodeId[]): void;
+    unmarkDraftPrivate(ids: readonly NodeId[]): void;
+    isDraftPrivate(id: NodeId): boolean;
+    /** Notified on every checkout change (including clone-map refreshes). */
+    subscribeToDraftOverlay(listener: () => void): () => void;
+    /**
+     * Swap checked-out members' content to their clones (original ids kept, so
+     * MV id lists and grid ordering are untouched). No-op without a checkout.
+     */
+    private overlayStates;
+    /**
+     * Draft-aware query path (0329 P5): candidates from storage WITHOUT
+     * pagination, unioned with checked-out members the predicate may have
+     * missed (their clone values can change membership), content-swapped,
+     * clone rows hidden, then the full descriptor re-applied in JS so
+     * filter/sort/pagination reflect draft values.
+     */
+    private draftAwareQuery;
+    /**
+     * Resolve where a write to `id` lands under the checkout: an existing
+     * clone, a lazily-forked one (`onMissingMember`), or — for non-members,
+     * clone ids, and declined forks — the id itself.
+     */
+    private resolveDraftWriteTarget;
     /**
      * Return the subset of IDs that already exist in materialized storage.
      *

package/dist/{types-B5rrBwRI.d.ts → types-C64g-IXg.d.ts}

@@ -231,7 +231,7 @@ interface NodeQueryDescriptor {
     authFingerprint?: string;
 }
 interface NodeQueryPlanMetadata {
-    strategy: 'storage-query' | 'list-fallback' | 'auth-pushdown-candidates';
+    strategy: 'storage-query' | 'list-fallback' | 'auth-pushdown-candidates' | 'draft-overlay';
     candidateNodeCount: number;
     hydratedNodeCount: number;
     returnedNodeCount: number;
@@ -959,6 +959,74 @@ interface NodeStorageAdapter {
     setAppState?(key: string, value: string): Promise<void>;
     getDocumentContent(nodeId: NodeId): Promise<Uint8Array | null>;
     setDocumentContent(nodeId: NodeId, content: Uint8Array): Promise<void>;
+    /**
+     * Pin registry (exploration 0329): keys pinned here are exempt from history
+     * pruning and Yjs snapshot eviction. A key is either a change hash or a
+     * `yjs:<nodeId>@<timestamp>` snapshot ref; owners (checkpoints, drafts)
+     * release all their pins in one call when they are deleted. Blobs are NOT
+     * pinned — referenced blobs past retention are an explicit blob horizon.
+     * Optional: without it, pruning behaves as before (nothing is protected).
+     */
+    pins?: PinRegistry;
+}
+/**
+ * Checked-out draft overlay (exploration 0329): while set on a NodeStore,
+ * reads of an original member id return its clone's content (under the
+ * original id — MV id lists and grid ordering never see clone ids), writes
+ * to members redirect to their clones, and the first write to a not-yet-
+ * forked member triggers `onMissingMember` (lazy copy-on-write, wired to
+ * `forkNodeIntoDraft`). Only ids in `members` are overlay-managed — all
+ * other reads/writes pass through untouched, so bookkeeping writes (the
+ * draft node itself, profiles, unrelated content) never fork.
+ */
+interface CheckedOutDraftOverlay {
+    /** The Draft node that owns this checkout. */
+    draftId: NodeId;
+    /**
+     * The draft's declared scope: ids eligible for overlay + lazy COW.
+     * `'dynamic'` (agent-PR sessions, 0329 P4) makes EVERY written id a
+     * candidate — `onMissingMember` decides per id (never-fork schemas and
+     * bookkeeping decline by returning null).
+     */
+    members: readonly NodeId[] | 'dynamic';
+    /** originalId -> cloneId for members already forked. */
+    clones: Record<NodeId, NodeId>;
+    /**
+     * Schema IRIs the members span. Queries against OTHER schemas keep their
+     * indexed fast path (nothing to overlay); queries against these take the
+     * draft-aware path (clone values drive filter/sort — a JS re-apply over
+     * unpaginated candidates, the accepted transient-session cost). Omitted =
+     * conservative: every query takes the draft-aware path.
+     */
+    memberSchemaIds?: readonly string[];
+    /**
+     * Lazy copy-on-write: fork `originalId` into the draft and return the
+     * clone id (or null to decline — the write then targets the original).
+     */
+    onMissingMember?: (originalId: NodeId) => Promise<NodeId | null>;
+    /**
+     * Fired when a NEW node is created while this draft is checked out
+     * (draft-born; promoted to a fresh main node on merge). Agent-PR sessions
+     * wire this to `markCreatedInDraft`.
+     */
+    onNodeCreated?: (nodeId: NodeId, schemaId: string) => void;
+}
+/** One pinned key: a change hash or a `yjs:`-prefixed snapshot ref. */
+interface PinEntry {
+    key: string;
+    ownerId: string;
+    reason: string;
+}
+/** Pin registry capability on a storage adapter (exploration 0329). */
+interface PinRegistry {
+    /** Add pins (idempotent per (key, ownerId)). */
+    addPins(pins: readonly PinEntry[]): Promise<void>;
+    /** Release every pin held by an owner (checkpoint/draft deletion). */
+    removePinsByOwner(ownerId: string): Promise<void>;
+    /** Of the given keys, return the subset pinned by any owner. */
+    getPinnedKeysAmong(keys: readonly string[]): Promise<Set<string>>;
+    /** Total number of pins (diagnostics). */
+    countPins(): Promise<number>;
 }
 interface SetNodeOptions {
     /**
@@ -1605,4 +1673,4 @@ type InferNode<P extends Record<string, PropertyBuilder>> = {
     createdBy: DID;
 } & InferProperties<P>;
 
-export { type PropertyKey as $, createNodeId as A, type PropertyType as B, type CreateNodeOptions$1 as C, type DefinedSchema as D, type PropertyDefinition as E, type ValidationError as F, type GetWithMigrationOptions as G, type CreateNodeOptions as H, type InferCreateProps as I, type InferPropertyType as J, type InferProperties as K, type ListNodesOptions as L, type MigratedNodeState as M, type NodeQueryPageCountMode as N, type OfflineAuthPolicy as O, type PropertyBuilder as P, type InferNode as Q, type SchemaLens as R, type SchemaIRI as S, type TransactionOperation as T, type UpdateNodeOptions as U, type ValidationResult as V, type LensOperation as W, type MigrationResult as X, MigrationError as Y, LensRegistry as Z, lensRegistry as _, type Schema as a, type StoreAuthKeyManager as a$, type NodePayload as a0, type PropertyTimestamp as a1, type SetNodeOptions as a2, type ImportNodesOptions as a3, type RebuildNodeIndexesOptions as a4, type ApplyNodeBatchInput as a5, type ApplyNodeBatchResult as a6, type NodeBatchIndexMode as a7, type NodeBatchNotificationMode as a8, type NodeBatchSyncMode as a9, createNodeQueryDescriptor as aA, encodeNodeQueryCursor as aB, decodeNodeQueryCursor as aC, nodeQueryDescriptorToOptions as aD, serializeNodeQueryDescriptor as aE, matchesNodeQueryDescriptor as aF, filterNodeQueryResults as aG, sortNodeQueryResults as aH, applyNodeQueryDescriptor as aI, getNodeQuerySearchTokens as aJ, nodeQueryDescriptorNeedsBoundedReload as aK, withoutNodeQueryPagination as aL, withoutNodeQueryMaterializedView as aM, isTempId as aN, TEMP_ID_PREFIX as aO, resolveTempIds as aP, createSchemaLookup as aQ, type SchemaLookup as aR, type TempIdResolution as aS, StoreAuth as aT, GrantRateLimiter as aU, GRANT_SCHEMA_IRI as aV, isGrantActive as aW, DEFAULT_OFFLINE_POLICY as aX, mergeOfflinePolicy as aY, type StoreAuthOptions as aZ, type StoreAuthStore as a_, type NodeBatchPreflightResult as aa, type DeterministicNodeBatchWriteInput as ab, type NodeBatchWritePolicy as ac, type NodeBatchWriteTimings as ad, type CountNodesOptions as ae, type NodeQuerySpatialPoint as af, type NodeQuerySpatialRect as ag, type NodeQuerySpatialPointFields as ah, type NodeQuerySpatialRectFields as ai, type NodeQuerySpatialWindow as aj, type NodeQuerySpatialRadius as ak, type NodeQuerySpatialFilter as al, type NodeQuerySearchField as am, type NodeQuerySearchFilter as an, type NodeQueryMaterializedViewOptions as ao, type NodeQueryPageOptions as ap, type NodeQueryCursorOrderEntry as aq, type NodeQueryCursor as ar, type NodeQueryOptions as as, type NodeQueryPlanMetadata as at, type NodeQueryParityCheckMetadata as au, type ConflictResult as av, type NodeBatchChangeEvent as aw, type NodeContentCipher as ax, type ContentKeyCache as ay, type MigrationInfo as az, type ParsedSchemaIRI as b, type GrantInput as b0, type Grant as b1, StoreAuthError as b2, type StoreAuthErrorCode as b3, type GrantNode as b4, type GrantIndexStore as b5, type GrantIndexOptions as b6, type RevocationConsistency as b7, type RevocationConfig as b8, type GrantRateLimiterOptions as b9, type DocumentType as ba, DEFAULT_SCHEMA_VERSION as bb, parseSchemaIRI as bc, buildSchemaIRI as bd, normalizeSchemaIRI as be, getBaseSchemaIRI as bf, isSameSchema as bg, getSchemaVersion as bh, type NodeReadAuthorizer as bi, type AuthorizationStateVersion as bj, type OperationNodeBatchWriteInput as bk, type PropertyLookup as bl, createPropertyLookup as bm, type SortDirection as c, type SystemOrderField as d, type StoreAuthAPI as e, type NodeStoreOptions as f, type NodeStorageAdapter as g, type NodeState as h, type NodeId as i, type NodeQueryDescriptor as j, type NodeQueryResult as k, type TransactionResult as l, type DeterministicNodeImportDraft as m, type ImportDeterministicNodesOptions as n, type ImportDeterministicNodesResult as o, type NodeBatchWriteInput as p, type NodeBatchWriteResult as q, type NodeChange as r, type MergeConflict as s, type NodeChangeListener as t, type NodeBatchChangeListener as u, type NodeChangeEvent as v, GrantIndex as w, type Node as x, type DID as y, isNode as z };
+export { lensRegistry as $, isNode as A, createNodeId as B, type CreateNodeOptions$1 as C, type DefinedSchema as D, type PropertyType as E, type PropertyDefinition as F, type GetWithMigrationOptions as G, type ValidationError as H, type InferCreateProps as I, type CreateNodeOptions as J, type InferPropertyType as K, type ListNodesOptions as L, type MigratedNodeState as M, type NodeQueryPageCountMode as N, type OfflineAuthPolicy as O, type PropertyBuilder as P, type InferProperties as Q, type InferNode as R, type SchemaIRI as S, type TransactionOperation as T, type UpdateNodeOptions as U, type ValidationResult as V, type SchemaLens as W, type LensOperation as X, type MigrationResult as Y, MigrationError as Z, LensRegistry as _, type Schema as a, mergeOfflinePolicy as a$, type PropertyKey as a0, type NodePayload as a1, type PropertyTimestamp as a2, type PinEntry as a3, type PinRegistry as a4, type SetNodeOptions as a5, type ImportNodesOptions as a6, type RebuildNodeIndexesOptions as a7, type ApplyNodeBatchInput as a8, type ApplyNodeBatchResult as a9, type NodeContentCipher as aA, type ContentKeyCache as aB, type MigrationInfo as aC, createNodeQueryDescriptor as aD, encodeNodeQueryCursor as aE, decodeNodeQueryCursor as aF, nodeQueryDescriptorToOptions as aG, serializeNodeQueryDescriptor as aH, matchesNodeQueryDescriptor as aI, filterNodeQueryResults as aJ, sortNodeQueryResults as aK, applyNodeQueryDescriptor as aL, getNodeQuerySearchTokens as aM, nodeQueryDescriptorNeedsBoundedReload as aN, withoutNodeQueryPagination as aO, withoutNodeQueryMaterializedView as aP, isTempId as aQ, TEMP_ID_PREFIX as aR, resolveTempIds as aS, createSchemaLookup as aT, type SchemaLookup as aU, type TempIdResolution as aV, StoreAuth as aW, GrantRateLimiter as aX, GRANT_SCHEMA_IRI as aY, isGrantActive as aZ, DEFAULT_OFFLINE_POLICY as a_, type NodeBatchIndexMode as aa, type NodeBatchNotificationMode as ab, type NodeBatchSyncMode as ac, type NodeBatchPreflightResult as ad, type DeterministicNodeBatchWriteInput as ae, type NodeBatchWritePolicy as af, type NodeBatchWriteTimings as ag, type CountNodesOptions as ah, type NodeQuerySpatialPoint as ai, type NodeQuerySpatialRect as aj, type NodeQuerySpatialPointFields as ak, type NodeQuerySpatialRectFields as al, type NodeQuerySpatialWindow as am, type NodeQuerySpatialRadius as an, type NodeQuerySpatialFilter as ao, type NodeQuerySearchField as ap, type NodeQuerySearchFilter as aq, type NodeQueryMaterializedViewOptions as ar, type NodeQueryPageOptions as as, type NodeQueryCursorOrderEntry as at, type NodeQueryCursor as au, type NodeQueryOptions as av, type NodeQueryPlanMetadata as aw, type NodeQueryParityCheckMetadata as ax, type ConflictResult as ay, type NodeBatchChangeEvent as az, type ParsedSchemaIRI as b, type StoreAuthOptions as b0, type StoreAuthStore as b1, type StoreAuthKeyManager as b2, type GrantInput as b3, type Grant as b4, StoreAuthError as b5, type StoreAuthErrorCode as b6, type GrantNode as b7, type GrantIndexStore as b8, type GrantIndexOptions as b9, type RevocationConsistency as ba, type RevocationConfig as bb, type GrantRateLimiterOptions as bc, type NodeReadAuthorizer as bd, type AuthorizationStateVersion as be, type OperationNodeBatchWriteInput as bf, type PropertyLookup as bg, createPropertyLookup as bh, type DocumentType as bi, DEFAULT_SCHEMA_VERSION as bj, parseSchemaIRI as bk, buildSchemaIRI as bl, normalizeSchemaIRI as bm, getBaseSchemaIRI as bn, isSameSchema as bo, getSchemaVersion as bp, type SortDirection as c, type SystemOrderField as d, type StoreAuthAPI as e, type NodeStoreOptions as f, type NodeStorageAdapter as g, type NodeState as h, type NodeId as i, type CheckedOutDraftOverlay as j, type NodeQueryDescriptor as k, type NodeQueryResult as l, type TransactionResult as m, type DeterministicNodeImportDraft as n, type ImportDeterministicNodesOptions as o, type ImportDeterministicNodesResult as p, type NodeBatchWriteInput as q, type NodeBatchWriteResult as r, type NodeChange as s, type MergeConflict as t, type NodeChangeListener as u, type NodeBatchChangeListener as v, type NodeChangeEvent as w, GrantIndex as x, type Node as y, type DID as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/data",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -57,12 +57,12 @@
     "nanoid": "^5.1.6",
     "y-protocols": "^1.0.6",
     "yjs": "^13.6.24",
-    "@xnetjs/core": "1.0.0",
-    "@xnetjs/crypto": "1.0.0",
-    "@xnetjs/identity": "1.0.0",
-    "@xnetjs/sqlite": "1.0.0",
-    "@xnetjs/storage": "1.0.0",
-    "@xnetjs/sync": "1.0.0"
+    "@xnetjs/core": "2.0.0",
+    "@xnetjs/crypto": "2.0.0",
+    "@xnetjs/identity": "2.0.0",
+    "@xnetjs/sqlite": "2.0.0",
+    "@xnetjs/storage": "2.0.0",
+    "@xnetjs/sync": "2.0.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",