@mulmoclaude/core 3.7.0 → 3.11.0

package/dist/collection/core/itemId.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A generated record id: a v4 UUID with its hyphens stripped — 32 lowercase hex
+ * characters, 122 bits.
+ *
+ * The ONE generator behind both blank-id create paths — the server's
+ * `generateItemId()` (../server/io) delegates here, so the UI's pre-filled id
+ * and the id a blank-id POST mints are the same thing rather than two
+ * implementations that have to agree.
+ *
+ * It replaced an 8-hex-char id, whose 32 bits collided at a 1.2% rate across
+ * 10k records — and a collision surfaced as `item '<id>' already exists`, which
+ * named a duplicate that did not exist (#2851).
+ *
+ * **The hyphens have to go.** A record id in a `googleCalendar` collection is
+ * sent to Google as the caller-chosen event id, and Google takes base32hex only
+ * (`isClientSettableEventId`, ../../google/pushPlan) — a hyphenated UUID is
+ * refused, so every UI-created record would push as "the record id cannot be
+ * used as a Google event id". Hex is a subset of base32hex, so the stripped
+ * form satisfies both that and `SAFE_RECORD_ID_PATTERN` (the id is also the
+ * `<id>.json` filename stem).
+ */
+export declare function newItemId(): string;
+/** @deprecated Use {@link newItemId}. Kept as a compatibility export because
+ *  `@mulmoclaude/core/collection` is public API (same reason as
+ *  `CollectionActionWhen` in ./schema). It is the NEW generator, not the old
+ *  8-hex one: that width is the bug #2851 reported, and leaving a copy of it
+ *  reachable under an old name would keep shipping it. */
+export declare const shortHexId: typeof newItemId;

package/dist/collection/firestore.cjs

@@ -42,7 +42,15 @@ function createFirestoreDocs(database) {
 			if (!(await transaction.get(ref)).exists()) return false;
 			transaction.delete(ref);
 			return true;
-		})
+		}),
+		watch: (collectionPath, onChanged, onError) => {
+			let seen = false;
+			return (0, firebase_firestore.onSnapshot)((0, firebase_firestore.collection)(database, collectionPath), (snapshot) => {
+				const initial = !seen;
+				seen = true;
+				onChanged(snapshot.docChanges().map((change) => change.doc.id), { initial });
+			}, onError);
+		}
 	};
 }
 //#endregion

package/dist/collection/firestore.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"firestore.cjs","names":[],"sources":["../../src/collection/server/firestoreDocs.ts"],"sourcesContent":["// The seam between the firestore store and the Firestore SDK.\n//\n// The modular SDK is function-based (`getDocs(query(collection(db, …)))`), so a\n// store that imported those functions directly could not be tested without a\n// real backend — a fake `db` would still be handed to the real functions.\n// Narrowing to this interface makes the backend swappable: core ships\n// `createFirestoreDocs` over the real SDK, and the tests inject an in-memory\n// fake that satisfies the same shape. That is what lets this repository's tests\n// run with no API key and no network.\n//\n// Deliberately minimal and id-keyed: no query builder, no field ordering, no\n// cursors. Everything the store needs is \"the documents of one collection path,\n// ordered by document id\" — see the store header for why field ordering is\n// avoided entirely.\n//\n// The collection path is an ARGUMENT, not something this module composes. It\n// owns the SDK calls; `firestoreStore` owns where the documents live.\n\nimport {\n  collection as firestoreCollection,\n  doc,\n  getDoc,\n  getDocs,\n  orderBy,\n  query as firestoreQuery,\n  runTransaction,\n  setDoc,\n  type Firestore,\n} from \"firebase/firestore\";\n\n/** One stored record document. `data` is the document's own fields — the\n *  record itself, not a wrapper around it; see `set` below. The store\n *  validates its shape, because a document written by hand could be\n *  anything. */\nexport interface FirestoreDoc {\n  id: string;\n  data: unknown;\n}\n\nexport interface FirestoreDocs {\n  /** Every document under `collectionPath`, ordered by document id. */\n  list: (collectionPath: string) => Promise<FirestoreDoc[]>;\n  /** One document's fields, or null when it doesn't exist. */\n  get: (collectionPath: string, docId: string) => Promise<unknown | null>;\n  /** Create or replace. */\n  set: (collectionPath: string, docId: string, data: Record<string, unknown>) => Promise<void>;\n  /** Create only. Returns false when the id already exists — atomic, so two\n   *  concurrent creates can't both observe \"missing\". */\n  create: (collectionPath: string, docId: string, data: Record<string, unknown>) => Promise<boolean>;\n  /** Delete. Returns false when the id didn't exist, so a caller can tell a\n   *  real delete from a typo'd id. */\n  delete: (collectionPath: string, docId: string) => Promise<boolean>;\n}\n\n/** The real implementation over the modular SDK.\n *\n *  THE RECORD IS THE DOCUMENT. Its fields are written at the top level, not\n *  nested under a `data` key. This is not a matter of taste: the deployed\n *  security rules read `request.resource.data.<field>` and\n *  `resource.data[submit.emailField]` — a wrapper would put every field one\n *  level down, so the required-field checks, the status state machine and the\n *  \"your own row\" predicate would all read absent values and fail closed. A\n *  shared record's shape is part of the authorization contract.\n *\n *  `orderBy(\"__name__\")` orders by DOCUMENT ID. Ordering by a record field\n *  would silently EXCLUDE documents missing that field (the trap\n *  `remote-host/server/hostRunner.ts:158-169` documents), turning a read into a\n *  partial one; the document id is always present and gives the stable order\n *  the store contract requires. */\nexport function createFirestoreDocs(database: Firestore): FirestoreDocs {\n  return {\n    list: async (collectionPath) => {\n      const snapshot = await getDocs(firestoreQuery(firestoreCollection(database, collectionPath), orderBy(\"__name__\")));\n      return snapshot.docs.map((entry) => ({ id: entry.id, data: entry.data() }));\n    },\n    get: async (collectionPath, docId) => {\n      const snapshot = await getDoc(doc(database, collectionPath, docId));\n      return snapshot.exists() ? snapshot.data() : null;\n    },\n    set: async (collectionPath, docId, data) => {\n      await setDoc(doc(database, collectionPath, docId), data);\n    },\n    create: (collectionPath, docId, data) =>\n      runTransaction(database, async (transaction) => {\n        const ref = doc(database, collectionPath, docId);\n        const existing = await transaction.get(ref);\n        if (existing.exists()) return false;\n        transaction.set(ref, data);\n        return true;\n      }),\n    // Firestore's deleteDoc succeeds on a missing document, so an existence\n    // check is what makes \"deleted\" distinguishable from \"there was nothing\".\n    // It runs INSIDE the transaction (like `create`): a plain get-then-delete\n    // would report `true` for a document a concurrent client had already\n    // removed, i.e. claim a delete this call never performed.\n    delete: (collectionPath, docId) =>\n      runTransaction(database, async (transaction) => {\n        const ref = doc(database, collectionPath, docId);\n        const existing = await transaction.get(ref);\n        if (!existing.exists()) return false;\n        transaction.delete(ref);\n        return true;\n      }),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqEA,SAAgB,oBAAoB,UAAoC;CACtE,OAAO;EACL,MAAM,OAAO,mBAAmB;GAE9B,QAAO,OAAA,GADgB,mBAAA,QAAA,EAAA,GAAQ,mBAAA,MAAA,EAAA,GAAe,mBAAA,WAAA,CAAoB,UAAU,cAAc,IAAA,GAAG,mBAAA,QAAA,CAAQ,UAAU,CAAC,CAAC,EAAA,CACjG,KAAK,KAAK,WAAW;IAAE,IAAI,MAAM;IAAI,MAAM,MAAM,KAAK;GAAE,EAAE;EAC5E;EACA,KAAK,OAAO,gBAAgB,UAAU;GACpC,MAAM,WAAW,OAAA,GAAM,mBAAA,OAAA,EAAA,GAAO,mBAAA,IAAA,CAAI,UAAU,gBAAgB,KAAK,CAAC;GAClE,OAAO,SAAS,OAAO,IAAI,SAAS,KAAK,IAAI;EAC/C;EACA,KAAK,OAAO,gBAAgB,OAAO,SAAS;GAC1C,OAAA,GAAM,mBAAA,OAAA,EAAA,GAAO,mBAAA,IAAA,CAAI,UAAU,gBAAgB,KAAK,GAAG,IAAI;EACzD;EACA,SAAS,gBAAgB,OAAO,UAAA,GAC9B,mBAAA,eAAA,CAAe,UAAU,OAAO,gBAAgB;GAC9C,MAAM,OAAA,GAAM,mBAAA,IAAA,CAAI,UAAU,gBAAgB,KAAK;GAE/C,KAAI,MADmB,YAAY,IAAI,GAAG,EAAA,CAC7B,OAAO,GAAG,OAAO;GAC9B,YAAY,IAAI,KAAK,IAAI;GACzB,OAAO;EACT,CAAC;EAMH,SAAS,gBAAgB,WAAA,GACvB,mBAAA,eAAA,CAAe,UAAU,OAAO,gBAAgB;GAC9C,MAAM,OAAA,GAAM,mBAAA,IAAA,CAAI,UAAU,gBAAgB,KAAK;GAE/C,IAAI,EAAC,MADkB,YAAY,IAAI,GAAG,EAAA,CAC5B,OAAO,GAAG,OAAO;GAC/B,YAAY,OAAO,GAAG;GACtB,OAAO;EACT,CAAC;CACL;AACF"}
+{"version":3,"file":"firestore.cjs","names":[],"sources":["../../src/collection/server/firestoreDocs.ts"],"sourcesContent":["// The seam between the firestore store and the Firestore SDK.\n//\n// The modular SDK is function-based (`getDocs(query(collection(db, …)))`), so a\n// store that imported those functions directly could not be tested without a\n// real backend — a fake `db` would still be handed to the real functions.\n// Narrowing to this interface makes the backend swappable: core ships\n// `createFirestoreDocs` over the real SDK, and the tests inject an in-memory\n// fake that satisfies the same shape. That is what lets this repository's tests\n// run with no API key and no network.\n//\n// Deliberately minimal and id-keyed: no query builder, no field ordering, no\n// cursors. Everything the store needs is \"the documents of one collection path,\n// ordered by document id\" — see the store header for why field ordering is\n// avoided entirely.\n//\n// The collection path is an ARGUMENT, not something this module composes. It\n// owns the SDK calls; `firestoreStore` owns where the documents live.\n\nimport {\n  collection as firestoreCollection,\n  doc,\n  getDoc,\n  getDocs,\n  orderBy,\n  query as firestoreQuery,\n  onSnapshot,\n  runTransaction,\n  setDoc,\n  type Firestore,\n} from \"firebase/firestore\";\n\n/** One stored record document. `data` is the document's own fields — the\n *  record itself, not a wrapper around it; see `set` below. The store\n *  validates its shape, because a document written by hand could be\n *  anything. */\nexport interface FirestoreDoc {\n  id: string;\n  data: unknown;\n}\n\nexport interface FirestoreDocs {\n  /** Every document under `collectionPath`, ordered by document id. */\n  list: (collectionPath: string) => Promise<FirestoreDoc[]>;\n  /** One document's fields, or null when it doesn't exist. */\n  get: (collectionPath: string, docId: string) => Promise<unknown | null>;\n  /** Create or replace. */\n  set: (collectionPath: string, docId: string, data: Record<string, unknown>) => Promise<void>;\n  /** Create only. Returns false when the id already exists — atomic, so two\n   *  concurrent creates can't both observe \"missing\". */\n  create: (collectionPath: string, docId: string, data: Record<string, unknown>) => Promise<boolean>;\n  /** Delete. Returns false when the id didn't exist, so a caller can tell a\n   *  real delete from a typo'd id. */\n  delete: (collectionPath: string, docId: string) => Promise<boolean>;\n  /** Listen to `collectionPath`. Every snapshot reports the ids that changed\n   *  in it, and whether it is the FIRST one.\n   *\n   *  `initial` is not a nicety. `onSnapshot` delivers the current contents\n   *  immediately, as one snapshot in which every existing document reads as\n   *  `added` — so a listener that treats snapshots uniformly announces the\n   *  whole collection as changed the moment it arms, on every mount. The flag\n   *  is passed up rather than swallowed here so the decision (and its test)\n   *  lives with the store's policy, next to the rest of it.\n   *\n   *  `onError` fires at most once per subscription: a Firestore listen error\n   *  TERMINATES the listener and never recovers on its own. Re-subscribing is\n   *  the caller's job (`firestore/listen.ts` holds the policy).\n   *\n   *  Returns the detach function synchronously — `onSnapshot` is not async. */\n  watch: (collectionPath: string, onChanged: (ids: string[], meta: { initial: boolean }) => void, onError: (error: unknown) => void) => () => void;\n}\n\n/** The real implementation over the modular SDK.\n *\n *  THE RECORD IS THE DOCUMENT. Its fields are written at the top level, not\n *  nested under a `data` key. This is not a matter of taste: the deployed\n *  security rules read `request.resource.data.<field>` and\n *  `resource.data[submit.emailField]` — a wrapper would put every field one\n *  level down, so the required-field checks, the status state machine and the\n *  \"your own row\" predicate would all read absent values and fail closed. A\n *  shared record's shape is part of the authorization contract.\n *\n *  `orderBy(\"__name__\")` orders by DOCUMENT ID. Ordering by a record field\n *  would silently EXCLUDE documents missing that field (the trap\n *  `remote-host/server/hostRunner.ts:158-169` documents), turning a read into a\n *  partial one; the document id is always present and gives the stable order\n *  the store contract requires. */\nexport function createFirestoreDocs(database: Firestore): FirestoreDocs {\n  return {\n    list: async (collectionPath) => {\n      const snapshot = await getDocs(firestoreQuery(firestoreCollection(database, collectionPath), orderBy(\"__name__\")));\n      return snapshot.docs.map((entry) => ({ id: entry.id, data: entry.data() }));\n    },\n    get: async (collectionPath, docId) => {\n      const snapshot = await getDoc(doc(database, collectionPath, docId));\n      return snapshot.exists() ? snapshot.data() : null;\n    },\n    set: async (collectionPath, docId, data) => {\n      await setDoc(doc(database, collectionPath, docId), data);\n    },\n    create: (collectionPath, docId, data) =>\n      runTransaction(database, async (transaction) => {\n        const ref = doc(database, collectionPath, docId);\n        const existing = await transaction.get(ref);\n        if (existing.exists()) return false;\n        transaction.set(ref, data);\n        return true;\n      }),\n    // Firestore's deleteDoc succeeds on a missing document, so an existence\n    // check is what makes \"deleted\" distinguishable from \"there was nothing\".\n    // It runs INSIDE the transaction (like `create`): a plain get-then-delete\n    // would report `true` for a document a concurrent client had already\n    // removed, i.e. claim a delete this call never performed.\n    delete: (collectionPath, docId) =>\n      runTransaction(database, async (transaction) => {\n        const ref = doc(database, collectionPath, docId);\n        const existing = await transaction.get(ref);\n        if (!existing.exists()) return false;\n        transaction.delete(ref);\n        return true;\n      }),\n    // `docChanges()` rather than the whole snapshot: it names the documents\n    // that moved, which is what lets the store report per-record changes\n    // instead of \"something in this collection changed\". Added, modified and\n    // removed are all reported the same way — the store's listener takes an\n    // id, and re-reads; what KIND of change it was is not something a\n    // reconcile pass needs to be told.\n    //\n    // `includeMetadataChanges` is deliberately left off: local writes and\n    // has-pending-writes flips would otherwise wake every listener for\n    // changes this process just made.\n    watch: (collectionPath, onChanged, onError) => {\n      let seen = false;\n      return onSnapshot(\n        firestoreCollection(database, collectionPath),\n        (snapshot) => {\n          const initial = !seen;\n          seen = true;\n          onChanged(\n            snapshot.docChanges().map((change) => change.doc.id),\n            { initial },\n          );\n        },\n        onError,\n      );\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsFA,SAAgB,oBAAoB,UAAoC;CACtE,OAAO;EACL,MAAM,OAAO,mBAAmB;GAE9B,QAAO,OAAA,GADgB,mBAAA,QAAA,EAAA,GAAQ,mBAAA,MAAA,EAAA,GAAe,mBAAA,WAAA,CAAoB,UAAU,cAAc,IAAA,GAAG,mBAAA,QAAA,CAAQ,UAAU,CAAC,CAAC,EAAA,CACjG,KAAK,KAAK,WAAW;IAAE,IAAI,MAAM;IAAI,MAAM,MAAM,KAAK;GAAE,EAAE;EAC5E;EACA,KAAK,OAAO,gBAAgB,UAAU;GACpC,MAAM,WAAW,OAAA,GAAM,mBAAA,OAAA,EAAA,GAAO,mBAAA,IAAA,CAAI,UAAU,gBAAgB,KAAK,CAAC;GAClE,OAAO,SAAS,OAAO,IAAI,SAAS,KAAK,IAAI;EAC/C;EACA,KAAK,OAAO,gBAAgB,OAAO,SAAS;GAC1C,OAAA,GAAM,mBAAA,OAAA,EAAA,GAAO,mBAAA,IAAA,CAAI,UAAU,gBAAgB,KAAK,GAAG,IAAI;EACzD;EACA,SAAS,gBAAgB,OAAO,UAAA,GAC9B,mBAAA,eAAA,CAAe,UAAU,OAAO,gBAAgB;GAC9C,MAAM,OAAA,GAAM,mBAAA,IAAA,CAAI,UAAU,gBAAgB,KAAK;GAE/C,KAAI,MADmB,YAAY,IAAI,GAAG,EAAA,CAC7B,OAAO,GAAG,OAAO;GAC9B,YAAY,IAAI,KAAK,IAAI;GACzB,OAAO;EACT,CAAC;EAMH,SAAS,gBAAgB,WAAA,GACvB,mBAAA,eAAA,CAAe,UAAU,OAAO,gBAAgB;GAC9C,MAAM,OAAA,GAAM,mBAAA,IAAA,CAAI,UAAU,gBAAgB,KAAK;GAE/C,IAAI,EAAC,MADkB,YAAY,IAAI,GAAG,EAAA,CAC5B,OAAO,GAAG,OAAO;GAC/B,YAAY,OAAO,GAAG;GACtB,OAAO;EACT,CAAC;EAWH,QAAQ,gBAAgB,WAAW,YAAY;GAC7C,IAAI,OAAO;GACX,QAAA,GAAO,mBAAA,WAAA,EAAA,GACL,mBAAA,WAAA,CAAoB,UAAU,cAAc,IAC3C,aAAa;IACZ,MAAM,UAAU,CAAC;IACjB,OAAO;IACP,UACE,SAAS,WAAW,CAAC,CAAC,KAAK,WAAW,OAAO,IAAI,EAAE,GACnD,EAAE,QAAQ,CACZ;GACF,GACA,OACF;EACF;CACF;AACF"}

package/dist/collection/firestore.js

@@ -1,4 +1,4 @@
-import { collection, doc, getDoc, getDocs, orderBy, query, runTransaction, setDoc } from "firebase/firestore";
+import { collection, doc, getDoc, getDocs, onSnapshot, orderBy, query, runTransaction, setDoc } from "firebase/firestore";
 //#region src/collection/server/firestoreDocs.ts
 /** The real implementation over the modular SDK.
 *
@@ -41,7 +41,15 @@ function createFirestoreDocs(database) {
 			if (!(await transaction.get(ref)).exists()) return false;
 			transaction.delete(ref);
 			return true;
-		})
+		}),
+		watch: (collectionPath, onChanged, onError) => {
+			let seen = false;
+			return onSnapshot(collection(database, collectionPath), (snapshot) => {
+				const initial = !seen;
+				seen = true;
+				onChanged(snapshot.docChanges().map((change) => change.doc.id), { initial });
+			}, onError);
+		}
 	};
 }
 //#endregion

package/dist/collection/firestore.js.map

@@ -1 +1 @@
-{"version":3,"file":"firestore.js","names":[],"sources":["../../src/collection/server/firestoreDocs.ts"],"sourcesContent":["// The seam between the firestore store and the Firestore SDK.\n//\n// The modular SDK is function-based (`getDocs(query(collection(db, …)))`), so a\n// store that imported those functions directly could not be tested without a\n// real backend — a fake `db` would still be handed to the real functions.\n// Narrowing to this interface makes the backend swappable: core ships\n// `createFirestoreDocs` over the real SDK, and the tests inject an in-memory\n// fake that satisfies the same shape. That is what lets this repository's tests\n// run with no API key and no network.\n//\n// Deliberately minimal and id-keyed: no query builder, no field ordering, no\n// cursors. Everything the store needs is \"the documents of one collection path,\n// ordered by document id\" — see the store header for why field ordering is\n// avoided entirely.\n//\n// The collection path is an ARGUMENT, not something this module composes. It\n// owns the SDK calls; `firestoreStore` owns where the documents live.\n\nimport {\n  collection as firestoreCollection,\n  doc,\n  getDoc,\n  getDocs,\n  orderBy,\n  query as firestoreQuery,\n  runTransaction,\n  setDoc,\n  type Firestore,\n} from \"firebase/firestore\";\n\n/** One stored record document. `data` is the document's own fields — the\n *  record itself, not a wrapper around it; see `set` below. The store\n *  validates its shape, because a document written by hand could be\n *  anything. */\nexport interface FirestoreDoc {\n  id: string;\n  data: unknown;\n}\n\nexport interface FirestoreDocs {\n  /** Every document under `collectionPath`, ordered by document id. */\n  list: (collectionPath: string) => Promise<FirestoreDoc[]>;\n  /** One document's fields, or null when it doesn't exist. */\n  get: (collectionPath: string, docId: string) => Promise<unknown | null>;\n  /** Create or replace. */\n  set: (collectionPath: string, docId: string, data: Record<string, unknown>) => Promise<void>;\n  /** Create only. Returns false when the id already exists — atomic, so two\n   *  concurrent creates can't both observe \"missing\". */\n  create: (collectionPath: string, docId: string, data: Record<string, unknown>) => Promise<boolean>;\n  /** Delete. Returns false when the id didn't exist, so a caller can tell a\n   *  real delete from a typo'd id. */\n  delete: (collectionPath: string, docId: string) => Promise<boolean>;\n}\n\n/** The real implementation over the modular SDK.\n *\n *  THE RECORD IS THE DOCUMENT. Its fields are written at the top level, not\n *  nested under a `data` key. This is not a matter of taste: the deployed\n *  security rules read `request.resource.data.<field>` and\n *  `resource.data[submit.emailField]` — a wrapper would put every field one\n *  level down, so the required-field checks, the status state machine and the\n *  \"your own row\" predicate would all read absent values and fail closed. A\n *  shared record's shape is part of the authorization contract.\n *\n *  `orderBy(\"__name__\")` orders by DOCUMENT ID. Ordering by a record field\n *  would silently EXCLUDE documents missing that field (the trap\n *  `remote-host/server/hostRunner.ts:158-169` documents), turning a read into a\n *  partial one; the document id is always present and gives the stable order\n *  the store contract requires. */\nexport function createFirestoreDocs(database: Firestore): FirestoreDocs {\n  return {\n    list: async (collectionPath) => {\n      const snapshot = await getDocs(firestoreQuery(firestoreCollection(database, collectionPath), orderBy(\"__name__\")));\n      return snapshot.docs.map((entry) => ({ id: entry.id, data: entry.data() }));\n    },\n    get: async (collectionPath, docId) => {\n      const snapshot = await getDoc(doc(database, collectionPath, docId));\n      return snapshot.exists() ? snapshot.data() : null;\n    },\n    set: async (collectionPath, docId, data) => {\n      await setDoc(doc(database, collectionPath, docId), data);\n    },\n    create: (collectionPath, docId, data) =>\n      runTransaction(database, async (transaction) => {\n        const ref = doc(database, collectionPath, docId);\n        const existing = await transaction.get(ref);\n        if (existing.exists()) return false;\n        transaction.set(ref, data);\n        return true;\n      }),\n    // Firestore's deleteDoc succeeds on a missing document, so an existence\n    // check is what makes \"deleted\" distinguishable from \"there was nothing\".\n    // It runs INSIDE the transaction (like `create`): a plain get-then-delete\n    // would report `true` for a document a concurrent client had already\n    // removed, i.e. claim a delete this call never performed.\n    delete: (collectionPath, docId) =>\n      runTransaction(database, async (transaction) => {\n        const ref = doc(database, collectionPath, docId);\n        const existing = await transaction.get(ref);\n        if (!existing.exists()) return false;\n        transaction.delete(ref);\n        return true;\n      }),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqEA,SAAgB,oBAAoB,UAAoC;CACtE,OAAO;EACL,MAAM,OAAO,mBAAmB;GAE9B,QAAO,MADgB,QAAQ,MAAe,WAAoB,UAAU,cAAc,GAAG,QAAQ,UAAU,CAAC,CAAC,EAAA,CACjG,KAAK,KAAK,WAAW;IAAE,IAAI,MAAM;IAAI,MAAM,MAAM,KAAK;GAAE,EAAE;EAC5E;EACA,KAAK,OAAO,gBAAgB,UAAU;GACpC,MAAM,WAAW,MAAM,OAAO,IAAI,UAAU,gBAAgB,KAAK,CAAC;GAClE,OAAO,SAAS,OAAO,IAAI,SAAS,KAAK,IAAI;EAC/C;EACA,KAAK,OAAO,gBAAgB,OAAO,SAAS;GAC1C,MAAM,OAAO,IAAI,UAAU,gBAAgB,KAAK,GAAG,IAAI;EACzD;EACA,SAAS,gBAAgB,OAAO,SAC9B,eAAe,UAAU,OAAO,gBAAgB;GAC9C,MAAM,MAAM,IAAI,UAAU,gBAAgB,KAAK;GAE/C,KAAI,MADmB,YAAY,IAAI,GAAG,EAAA,CAC7B,OAAO,GAAG,OAAO;GAC9B,YAAY,IAAI,KAAK,IAAI;GACzB,OAAO;EACT,CAAC;EAMH,SAAS,gBAAgB,UACvB,eAAe,UAAU,OAAO,gBAAgB;GAC9C,MAAM,MAAM,IAAI,UAAU,gBAAgB,KAAK;GAE/C,IAAI,EAAC,MADkB,YAAY,IAAI,GAAG,EAAA,CAC5B,OAAO,GAAG,OAAO;GAC/B,YAAY,OAAO,GAAG;GACtB,OAAO;EACT,CAAC;CACL;AACF"}
+{"version":3,"file":"firestore.js","names":[],"sources":["../../src/collection/server/firestoreDocs.ts"],"sourcesContent":["// The seam between the firestore store and the Firestore SDK.\n//\n// The modular SDK is function-based (`getDocs(query(collection(db, …)))`), so a\n// store that imported those functions directly could not be tested without a\n// real backend — a fake `db` would still be handed to the real functions.\n// Narrowing to this interface makes the backend swappable: core ships\n// `createFirestoreDocs` over the real SDK, and the tests inject an in-memory\n// fake that satisfies the same shape. That is what lets this repository's tests\n// run with no API key and no network.\n//\n// Deliberately minimal and id-keyed: no query builder, no field ordering, no\n// cursors. Everything the store needs is \"the documents of one collection path,\n// ordered by document id\" — see the store header for why field ordering is\n// avoided entirely.\n//\n// The collection path is an ARGUMENT, not something this module composes. It\n// owns the SDK calls; `firestoreStore` owns where the documents live.\n\nimport {\n  collection as firestoreCollection,\n  doc,\n  getDoc,\n  getDocs,\n  orderBy,\n  query as firestoreQuery,\n  onSnapshot,\n  runTransaction,\n  setDoc,\n  type Firestore,\n} from \"firebase/firestore\";\n\n/** One stored record document. `data` is the document's own fields — the\n *  record itself, not a wrapper around it; see `set` below. The store\n *  validates its shape, because a document written by hand could be\n *  anything. */\nexport interface FirestoreDoc {\n  id: string;\n  data: unknown;\n}\n\nexport interface FirestoreDocs {\n  /** Every document under `collectionPath`, ordered by document id. */\n  list: (collectionPath: string) => Promise<FirestoreDoc[]>;\n  /** One document's fields, or null when it doesn't exist. */\n  get: (collectionPath: string, docId: string) => Promise<unknown | null>;\n  /** Create or replace. */\n  set: (collectionPath: string, docId: string, data: Record<string, unknown>) => Promise<void>;\n  /** Create only. Returns false when the id already exists — atomic, so two\n   *  concurrent creates can't both observe \"missing\". */\n  create: (collectionPath: string, docId: string, data: Record<string, unknown>) => Promise<boolean>;\n  /** Delete. Returns false when the id didn't exist, so a caller can tell a\n   *  real delete from a typo'd id. */\n  delete: (collectionPath: string, docId: string) => Promise<boolean>;\n  /** Listen to `collectionPath`. Every snapshot reports the ids that changed\n   *  in it, and whether it is the FIRST one.\n   *\n   *  `initial` is not a nicety. `onSnapshot` delivers the current contents\n   *  immediately, as one snapshot in which every existing document reads as\n   *  `added` — so a listener that treats snapshots uniformly announces the\n   *  whole collection as changed the moment it arms, on every mount. The flag\n   *  is passed up rather than swallowed here so the decision (and its test)\n   *  lives with the store's policy, next to the rest of it.\n   *\n   *  `onError` fires at most once per subscription: a Firestore listen error\n   *  TERMINATES the listener and never recovers on its own. Re-subscribing is\n   *  the caller's job (`firestore/listen.ts` holds the policy).\n   *\n   *  Returns the detach function synchronously — `onSnapshot` is not async. */\n  watch: (collectionPath: string, onChanged: (ids: string[], meta: { initial: boolean }) => void, onError: (error: unknown) => void) => () => void;\n}\n\n/** The real implementation over the modular SDK.\n *\n *  THE RECORD IS THE DOCUMENT. Its fields are written at the top level, not\n *  nested under a `data` key. This is not a matter of taste: the deployed\n *  security rules read `request.resource.data.<field>` and\n *  `resource.data[submit.emailField]` — a wrapper would put every field one\n *  level down, so the required-field checks, the status state machine and the\n *  \"your own row\" predicate would all read absent values and fail closed. A\n *  shared record's shape is part of the authorization contract.\n *\n *  `orderBy(\"__name__\")` orders by DOCUMENT ID. Ordering by a record field\n *  would silently EXCLUDE documents missing that field (the trap\n *  `remote-host/server/hostRunner.ts:158-169` documents), turning a read into a\n *  partial one; the document id is always present and gives the stable order\n *  the store contract requires. */\nexport function createFirestoreDocs(database: Firestore): FirestoreDocs {\n  return {\n    list: async (collectionPath) => {\n      const snapshot = await getDocs(firestoreQuery(firestoreCollection(database, collectionPath), orderBy(\"__name__\")));\n      return snapshot.docs.map((entry) => ({ id: entry.id, data: entry.data() }));\n    },\n    get: async (collectionPath, docId) => {\n      const snapshot = await getDoc(doc(database, collectionPath, docId));\n      return snapshot.exists() ? snapshot.data() : null;\n    },\n    set: async (collectionPath, docId, data) => {\n      await setDoc(doc(database, collectionPath, docId), data);\n    },\n    create: (collectionPath, docId, data) =>\n      runTransaction(database, async (transaction) => {\n        const ref = doc(database, collectionPath, docId);\n        const existing = await transaction.get(ref);\n        if (existing.exists()) return false;\n        transaction.set(ref, data);\n        return true;\n      }),\n    // Firestore's deleteDoc succeeds on a missing document, so an existence\n    // check is what makes \"deleted\" distinguishable from \"there was nothing\".\n    // It runs INSIDE the transaction (like `create`): a plain get-then-delete\n    // would report `true` for a document a concurrent client had already\n    // removed, i.e. claim a delete this call never performed.\n    delete: (collectionPath, docId) =>\n      runTransaction(database, async (transaction) => {\n        const ref = doc(database, collectionPath, docId);\n        const existing = await transaction.get(ref);\n        if (!existing.exists()) return false;\n        transaction.delete(ref);\n        return true;\n      }),\n    // `docChanges()` rather than the whole snapshot: it names the documents\n    // that moved, which is what lets the store report per-record changes\n    // instead of \"something in this collection changed\". Added, modified and\n    // removed are all reported the same way — the store's listener takes an\n    // id, and re-reads; what KIND of change it was is not something a\n    // reconcile pass needs to be told.\n    //\n    // `includeMetadataChanges` is deliberately left off: local writes and\n    // has-pending-writes flips would otherwise wake every listener for\n    // changes this process just made.\n    watch: (collectionPath, onChanged, onError) => {\n      let seen = false;\n      return onSnapshot(\n        firestoreCollection(database, collectionPath),\n        (snapshot) => {\n          const initial = !seen;\n          seen = true;\n          onChanged(\n            snapshot.docChanges().map((change) => change.doc.id),\n            { initial },\n          );\n        },\n        onError,\n      );\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAsFA,SAAgB,oBAAoB,UAAoC;CACtE,OAAO;EACL,MAAM,OAAO,mBAAmB;GAE9B,QAAO,MADgB,QAAQ,MAAe,WAAoB,UAAU,cAAc,GAAG,QAAQ,UAAU,CAAC,CAAC,EAAA,CACjG,KAAK,KAAK,WAAW;IAAE,IAAI,MAAM;IAAI,MAAM,MAAM,KAAK;GAAE,EAAE;EAC5E;EACA,KAAK,OAAO,gBAAgB,UAAU;GACpC,MAAM,WAAW,MAAM,OAAO,IAAI,UAAU,gBAAgB,KAAK,CAAC;GAClE,OAAO,SAAS,OAAO,IAAI,SAAS,KAAK,IAAI;EAC/C;EACA,KAAK,OAAO,gBAAgB,OAAO,SAAS;GAC1C,MAAM,OAAO,IAAI,UAAU,gBAAgB,KAAK,GAAG,IAAI;EACzD;EACA,SAAS,gBAAgB,OAAO,SAC9B,eAAe,UAAU,OAAO,gBAAgB;GAC9C,MAAM,MAAM,IAAI,UAAU,gBAAgB,KAAK;GAE/C,KAAI,MADmB,YAAY,IAAI,GAAG,EAAA,CAC7B,OAAO,GAAG,OAAO;GAC9B,YAAY,IAAI,KAAK,IAAI;GACzB,OAAO;EACT,CAAC;EAMH,SAAS,gBAAgB,UACvB,eAAe,UAAU,OAAO,gBAAgB;GAC9C,MAAM,MAAM,IAAI,UAAU,gBAAgB,KAAK;GAE/C,IAAI,EAAC,MADkB,YAAY,IAAI,GAAG,EAAA,CAC5B,OAAO,GAAG,OAAO;GAC/B,YAAY,OAAO,GAAG;GACtB,OAAO;EACT,CAAC;EAWH,QAAQ,gBAAgB,WAAW,YAAY;GAC7C,IAAI,OAAO;GACX,OAAO,WACL,WAAoB,UAAU,cAAc,IAC3C,aAAa;IACZ,MAAM,UAAU,CAAC;IACjB,OAAO;IACP,UACE,SAAS,WAAW,CAAC,CAAC,KAAK,WAAW,OAAO,IAAI,EAAE,GACnD,EAAE,QAAQ,CACZ;GACF,GACA,OACF;EACF;CACF;AACF"}

package/dist/collection/index.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_dist = require("../dist-CsgSfWwR.cjs");
-const require_calendarGrid = require("../calendarGrid-DGILaVxI.cjs");
+const require_itemId = require("../itemId-Dzrr3vs5.cjs");
 const require_project = require("../project-C1ep9pvo.cjs");
-const require_promptSafety = require("../promptSafety-NNGViiCr.cjs");
+const require_promptSafety = require("../promptSafety-CWqYq-NS.cjs");
 //#region src/collection/core/presentCollection.ts
 var TOOL_NAME = "presentCollection";
 /** Stamp a host's opaque project scope onto a card payload. The ONLY way a
@@ -174,7 +174,7 @@ function enumColorClasses(index) {
 /** Index of `value` within an enum field's declared `values`, or -1 when the
 *  value is empty / unknown (→ neutral). */
 function enumValueIndex(values, value) {
-	const text = require_calendarGrid.fieldTextOrNull(value);
+	const text = require_itemId.fieldTextOrNull(value);
 	if (text === null || text === "") return -1;
 	return values?.indexOf(text) ?? -1;
 }
@@ -192,7 +192,7 @@ function notifyValuesFor(schema, fieldKey) {
 function resolveEnumColor(schema, fieldKey, value) {
 	const notifyValues = notifyValuesFor(schema, fieldKey);
 	if (notifyValues) {
-		const str = require_calendarGrid.fieldText(value);
+		const str = require_itemId.fieldText(value);
 		const rank = notifyValues.indexOf(str);
 		if (rank < 0) return ENUM_NEUTRAL;
 		return rank === 0 ? ENUM_ALERT : ENUM_NUDGE;
@@ -218,7 +218,7 @@ function buildTableRowDraft(subFields, readSub) {
 			bool[subKey] = raw === true;
 			boolOriginallyPresent[subKey] = typeof raw === "boolean";
 			boolTouched[subKey] = false;
-		} else text[subKey] = require_calendarGrid.fieldText(raw);
+		} else text[subKey] = require_itemId.fieldText(raw);
 	}
 	return {
 		text,
@@ -273,7 +273,7 @@ function rowDraftToRecord(rowDraft, subFields) {
 function draftToRecord(state, schema) {
 	const record = {};
 	for (const [key, field] of Object.entries(schema.fields)) {
-		if (require_calendarGrid.COMPUTED_TYPES.has(field.type)) continue;
+		if (require_itemId.COMPUTED_TYPES.has(field.type)) continue;
 		if (field.type === "boolean") {
 			if (shouldEmitBoolean(state, key, field)) record[key] = ownFlag(state.bool, key);
 			continue;
@@ -326,7 +326,7 @@ function firstMissingTableSubField(field, rows) {
 *  value, and the computed/projected kinds (COMPUTED_TYPES — the shared
 *  set, so a future computed type can't drift past this check) have no
 *  draft input at all. */
-var NEVER_MISSING_TYPES = /* @__PURE__ */ new Set(["boolean", ...require_calendarGrid.COMPUTED_TYPES]);
+var NEVER_MISSING_TYPES = /* @__PURE__ */ new Set(["boolean", ...require_itemId.COMPUTED_TYPES]);
 function validateOneField(key, field, draft, record) {
 	if (!require_promptSafety.fieldVisible(field, record)) return null;
 	if (field.type === "table" && field.of) {
@@ -387,7 +387,7 @@ function numericSortValue(raw) {
 	} : EMPTY;
 }
 function stringSortValue(raw) {
-	const str = require_calendarGrid.fieldTextOrNull(raw);
+	const str = require_itemId.fieldTextOrNull(raw);
 	if (str === null) return EMPTY;
 	return str.trim() === "" ? EMPTY : {
 		empty: false,
@@ -395,7 +395,7 @@ function stringSortValue(raw) {
 	};
 }
 function dateSortValue(raw) {
-	const text = require_calendarGrid.fieldTextOrNull(raw);
+	const text = require_itemId.fieldTextOrNull(raw);
 	if (text === null || text === "") return EMPTY;
 	const epoch = Date.parse(text);
 	return Number.isNaN(epoch) ? stringSortValue(raw) : {
@@ -406,7 +406,7 @@ function dateSortValue(raw) {
 /** Enum sorts by the value's index in the declared `values` list. A value
 *  outside the list (or unset) is treated as empty → last. */
 function enumSortValue(values, raw) {
-	const text = require_calendarGrid.fieldTextOrNull(raw);
+	const text = require_itemId.fieldTextOrNull(raw);
 	if (text === null || text === "") return EMPTY;
 	const idx = values ? values.indexOf(text) : -1;
 	return idx < 0 ? EMPTY : {
@@ -491,7 +491,7 @@ function sortValueOf(field, key, item, deps) {
 function itemMatchesQuery(item, query) {
 	if (query === "") return true;
 	return Object.values(item).some((value) => {
-		const text = require_calendarGrid.fieldTextOrNull(value);
+		const text = require_itemId.fieldTextOrNull(value);
 		return text !== null && text.toLowerCase().includes(query);
 	});
 }
@@ -508,7 +508,7 @@ function cellKey(rowId, fieldKey) {
 *  empty-enum snapshot always agree. A real primary key is a scalar, so this
 *  matches its plain string form. */
 function rowIdOf(primaryKey, item) {
-	return primaryKey ? require_calendarGrid.fieldText(item[primaryKey]) : "";
+	return primaryKey ? require_itemId.fieldText(item[primaryKey]) : "";
 }
 /** The set of enum cells that were empty in the freshly-fetched records — the
 *  only cells whose inline dropdown offers an empty option. */
@@ -517,7 +517,7 @@ function snapshotEmptyEnums(schema, records) {
 	const enumKeys = Object.entries(schema.fields).filter(([, field]) => field.type === "enum").map(([fieldKey]) => fieldKey);
 	if (enumKeys.length === 0) return empty;
 	for (const record of records) {
-		const recordId = require_calendarGrid.fieldText(record[schema.primaryKey]);
+		const recordId = require_itemId.fieldText(record[schema.primaryKey]);
 		for (const fieldKey of enumKeys) if (record[fieldKey] == null || record[fieldKey] === "") empty.add(cellKey(recordId, fieldKey));
 	}
 	return empty;
@@ -541,7 +541,7 @@ function labelFieldFor(schema) {
 }
 /** A record's primary-key value as a string. */
 function itemIdOf(item, schema) {
-	return require_calendarGrid.fieldText(item[schema.primaryKey]);
+	return require_itemId.fieldText(item[schema.primaryKey]);
 }
 /** A record's display label: the resolved `labelField` value, else the
 *  primary key. Pass the result of `labelFieldFor(schema)` as `labelField`
@@ -557,18 +557,6 @@ function itemLabelOf(item, schema, labelField) {
 	return itemIdOf(item, schema);
 }
 //#endregion
-//#region src/collection/core/shortHexId.ts
-/**
-* 8-char hex id — short, slug-safe, and editable. Produces the same id *shape*
-* as the server's `generateItemId()` (8 hex chars) so a UI-created collection
-* record looks like one the server would have generated for a form submitted
-* with a blank primary key. The source of randomness differs (UUID-derived here
-* vs `randomBytes` on the server); only the shape is intentionally shared.
-*/
-function shortHexId() {
-	return crypto.randomUUID().replace(/-/g, "").slice(0, 8);
-}
-//#endregion
 //#region src/collection/core/ontologyGraph.ts
 var isForwardKind = (kind) => kind === "ref" || kind === "embed";
 /** Fold a reverse relation (`backlinks`/`rollup` declared on `owner`)
@@ -639,25 +627,25 @@ var buildOntologyGraph = (entries) => {
 	};
 };
 //#endregion
-exports.AGENT_INGEST_KIND = require_calendarGrid.AGENT_INGEST_KIND;
-exports.COMPUTED_TYPES = require_calendarGrid.COMPUTED_TYPES;
+exports.AGENT_INGEST_KIND = require_itemId.AGENT_INGEST_KIND;
+exports.COMPUTED_TYPES = require_itemId.COMPUTED_TYPES;
 exports.ENUM_ALERT = ENUM_ALERT;
 exports.ENUM_NEUTRAL = ENUM_NEUTRAL;
 exports.ENUM_NUDGE = ENUM_NUDGE;
-exports.FEED_SCHEDULES = require_calendarGrid.FEED_SCHEDULES;
-exports.INGEST_KINDS = require_calendarGrid.INGEST_KINDS;
-exports.MINUTES_PER_DAY = require_calendarGrid.MINUTES_PER_DAY;
-exports.SAFE_RECORD_ID_PATTERN = require_calendarGrid.SAFE_RECORD_ID_PATTERN;
-exports.SAFE_SLUG_PATTERN = require_calendarGrid.SAFE_SLUG_PATTERN;
+exports.FEED_SCHEDULES = require_itemId.FEED_SCHEDULES;
+exports.INGEST_KINDS = require_itemId.INGEST_KINDS;
+exports.MINUTES_PER_DAY = require_itemId.MINUTES_PER_DAY;
+exports.SAFE_RECORD_ID_PATTERN = require_itemId.SAFE_RECORD_ID_PATTERN;
+exports.SAFE_SLUG_PATTERN = require_itemId.SAFE_SLUG_PATTERN;
 exports.TOOL_DEFINITION = TOOL_DEFINITION;
 exports.TOOL_NAME = TOOL_NAME;
 exports.actionVisible = require_promptSafety.actionVisible;
 exports.agentActionRunKey = require_promptSafety.agentActionRunKey;
-exports.assignLanes = require_calendarGrid.assignLanes;
+exports.assignLanes = require_itemId.assignLanes;
 exports.backlinkRows = require_promptSafety.backlinkRows;
 exports.boolSortValue = boolSortValue;
-exports.bucketRecords = require_calendarGrid.bucketRecords;
-exports.buildMonthGrid = require_calendarGrid.buildMonthGrid;
+exports.bucketRecords = require_itemId.bucketRecords;
+exports.buildMonthGrid = require_itemId.buildMonthGrid;
 exports.buildOntologyGraph = buildOntologyGraph;
 exports.buildUpdatedRecord = buildUpdatedRecord;
 exports.cellKey = cellKey;
@@ -665,19 +653,19 @@ exports.chipMatches = require_promptSafety.chipMatches;
 exports.coerceInlineValue = coerceInlineValue;
 exports.coerceNumeric = require_promptSafety.coerceNumeric;
 exports.collectionCardKey = collectionCardKey;
-exports.collectionKeyId = require_calendarGrid.collectionKeyId;
-exports.collectionKeyName = require_calendarGrid.collectionKeyName;
+exports.collectionKeyId = require_itemId.collectionKeyId;
+exports.collectionKeyName = require_itemId.collectionKeyName;
 exports.compareSortValues = compareSortValues;
-exports.compareYmd = require_calendarGrid.compareYmd;
+exports.compareYmd = require_itemId.compareYmd;
 exports.completionCoveredByFieldChip = require_promptSafety.completionCoveredByFieldChip;
-exports.dateOf = require_calendarGrid.dateOf;
+exports.dateOf = require_itemId.dateOf;
 exports.dateSortValue = dateSortValue;
-exports.daySlice = require_calendarGrid.daySlice;
+exports.daySlice = require_itemId.daySlice;
 exports.defangForPrompt = require_promptSafety.defangForPrompt;
 exports.deriveAll = require_promptSafety.deriveAll;
 exports.derivedSortValue = derivedSortValue;
 exports.draftToRecord = draftToRecord;
-exports.embedTargetId = require_calendarGrid.embedTargetId;
+exports.embedTargetId = require_itemId.embedTargetId;
 exports.emptyRow = emptyRow;
 exports.enumColorClasses = enumColorClasses;
 exports.enumSortValue = enumSortValue;
@@ -685,40 +673,41 @@ exports.enumValueIndex = enumValueIndex;
 exports.errorMessage = require_dist.errorMessage;
 exports.evaluateDerived = require_promptSafety.evaluateDerived;
 exports.executePresentCollection = executePresentCollection;
-exports.fieldText = require_calendarGrid.fieldText;
-exports.fieldTextOrNull = require_calendarGrid.fieldTextOrNull;
+exports.fieldText = require_itemId.fieldText;
+exports.fieldTextOrNull = require_itemId.fieldTextOrNull;
 exports.fieldVisible = require_promptSafety.fieldVisible;
 exports.firstDateField = require_promptSafety.firstDateField;
 exports.firstMissingRequiredField = firstMissingRequiredField;
 exports.flagFieldValue = require_promptSafety.flagFieldValue;
-exports.generateUniqueId = require_calendarGrid.generateUniqueId;
-exports.isFieldDrivenEvery = require_calendarGrid.isFieldDrivenEvery;
-exports.isLocalCollectionKey = require_calendarGrid.isLocalCollectionKey;
-exports.isReadOnlySchema = require_calendarGrid.isReadOnlySchema;
-exports.isSafeRecordId = require_calendarGrid.isSafeRecordId;
-exports.isSafeSlug = require_calendarGrid.isSafeSlug;
-exports.isSharedCollectionKey = require_calendarGrid.isSharedCollectionKey;
+exports.generateUniqueId = require_itemId.generateUniqueId;
+exports.isFieldDrivenEvery = require_itemId.isFieldDrivenEvery;
+exports.isLocalCollectionKey = require_itemId.isLocalCollectionKey;
+exports.isReadOnlySchema = require_itemId.isReadOnlySchema;
+exports.isSafeRecordId = require_itemId.isSafeRecordId;
+exports.isSafeSlug = require_itemId.isSafeSlug;
+exports.isSharedCollectionKey = require_itemId.isSharedCollectionKey;
 exports.isSortableField = isSortableField;
-exports.isValidCollectionName = require_calendarGrid.isValidCollectionName;
+exports.isValidCollectionName = require_itemId.isValidCollectionName;
 exports.itemIdOf = itemIdOf;
 exports.itemIsDone = require_promptSafety.itemIsDone;
 exports.itemLabelOf = itemLabelOf;
 exports.itemMatchesQuery = itemMatchesQuery;
 exports.labelFieldFor = labelFieldFor;
-exports.localCollectionKeyOf = require_calendarGrid.localCollectionKeyOf;
+exports.localCollectionKeyOf = require_itemId.localCollectionKeyOf;
 exports.matchesWhere = require_promptSafety.matchesWhere;
 exports.mergeIntoExisting = require_project.mergeIntoExisting;
-exports.monthAnchorDate = require_calendarGrid.monthAnchorDate;
+exports.monthAnchorDate = require_itemId.monthAnchorDate;
+exports.newItemId = require_itemId.newItemId;
 exports.nextSortDirection = nextSortDirection;
-exports.nextUniqueItemId = require_calendarGrid.nextUniqueItemId;
+exports.nextUniqueItemId = require_itemId.nextUniqueItemId;
 exports.numericSortValue = numericSortValue;
-exports.parseCollectionKeyId = require_calendarGrid.parseCollectionKeyId;
-exports.parseIsoDate = require_calendarGrid.parseIsoDate;
-exports.parseIsoDateTime = require_calendarGrid.parseIsoDateTime;
-exports.parseTimeRange = require_calendarGrid.parseTimeRange;
+exports.parseCollectionKeyId = require_itemId.parseCollectionKeyId;
+exports.parseIsoDate = require_itemId.parseIsoDate;
+exports.parseIsoDateTime = require_itemId.parseIsoDateTime;
+exports.parseTimeRange = require_itemId.parseTimeRange;
 exports.projectBacklinkRow = require_promptSafety.projectBacklinkRow;
 exports.projectRecordFields = require_project.projectRecordFields;
-exports.recordSpan = require_calendarGrid.recordSpan;
+exports.recordSpan = require_itemId.recordSpan;
 exports.resolveEnumColor = resolveEnumColor;
 exports.resolveIcon = require_promptSafety.resolveIcon;
 exports.resolveRowRefs = require_promptSafety.resolveRowRefs;
@@ -726,17 +715,17 @@ exports.rollupValue = require_promptSafety.rollupValue;
 exports.rowFromItem = rowFromItem;
 exports.rowIdOf = rowIdOf;
 exports.sameCollectionCard = sameCollectionCard;
-exports.sameCollectionKey = require_calendarGrid.sameCollectionKey;
+exports.sameCollectionKey = require_itemId.sameCollectionKey;
 exports.scalarSortValue = scalarSortValue;
 exports.selectDynamicRecord = require_promptSafety.selectDynamicRecord;
-exports.sharedCollectionKey = require_calendarGrid.sharedCollectionKey;
-exports.shortHexId = shortHexId;
+exports.sharedCollectionKey = require_itemId.sharedCollectionKey;
+exports.shortHexId = require_itemId.shortHexId;
 exports.skillCommandSeed = skillCommandSeed;
 exports.snapshotEmptyEnums = snapshotEmptyEnums;
 exports.sortItems = sortItems;
 exports.sortValueOf = sortValueOf;
-exports.spanCoversDay = require_calendarGrid.spanCoversDay;
-exports.storageKindFor = require_calendarGrid.storageKindFor;
+exports.spanCoversDay = require_itemId.spanCoversDay;
+exports.storageKindFor = require_itemId.storageKindFor;
 exports.stringSortValue = stringSortValue;
 exports.toPresentCollectionData = toPresentCollectionData;
 exports.toggleChecked = require_promptSafety.toggleChecked;
@@ -746,6 +735,6 @@ exports.uniqueRefTargets = require_promptSafety.uniqueRefTargets;
 exports.viaMatches = require_promptSafety.viaMatches;
 exports.whenMatches = require_promptSafety.whenMatches;
 exports.withCardScope = withCardScope;
-exports.ymdKey = require_calendarGrid.ymdKey;
+exports.ymdKey = require_itemId.ymdKey;
 
 //# sourceMappingURL=index.cjs.map