mindoodb 0.0.24 → 0.0.32

package/dist/core/query/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/query/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAElG;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,4BAA4B,CAAC;IACtC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,wBAAwB;IAClE;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,WAAW,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE1D;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB;CAKzD"}

package/dist/core/query/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MindooQueryError = void 0;
+/**
+ * Thrown for queries that cannot be answered: referenced fields outside the
+ * summary coverage, `decrypt`/view-tree expressions without
+ * `allowFullScan`, a `text` clause without an enabled full-text index,
+ * or an aborted run.
+ */
+class MindooQueryError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.name = "MindooQueryError";
+        this.code = code;
+    }
+}
+exports.MindooQueryError = MindooQueryError;
+//# sourceMappingURL=types.js.map

package/dist/core/query/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/query/types.ts"],"names":[],"mappings":";;;AAsHA;;;;;GAKG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAIzC,YAAY,OAAe,EAAE,IAA2B;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AATD,4CASC"}

package/dist/core/storeEntryTime.d.ts

@@ -0,0 +1,57 @@
+import type { StoreEntryMetadata } from "./types";
+/**
+ * Shared trusted-time / provisional helpers for store entries.
+ *
+ * These centralize the version-aware trusted-time rule (see
+ * {@link StoreEntryMetadata.entryVersion}) so the changefeed, document
+ * materialization, the access-control judgment site, and the per-document
+ * "awaiting witness" flag all agree on what a store entry's trusted time is
+ * and whether it is still provisional.
+ */
+/**
+ * Whether an entry is "provisional": versioned (written in the witness-aware
+ * era) but not yet witnessed, so its trusted time is the wall-clock `now` and
+ * will move until a trusted witness stamps it with a `receivedAt`.
+ *
+ * Legacy entries (no {@link StoreEntryMetadata.entryVersion}) are NOT
+ * provisional even when un-witnessed: they were written before the witness era,
+ * are already synced within the tenant, and will never be witnessed — their
+ * trusted time is stable at `createdAt`.
+ */
+export declare function isProvisional(meta: StoreEntryMetadata): boolean;
+/**
+ * Whether an entry was written in the witness-aware era (carries an
+ * {@link StoreEntryMetadata.entryVersion}). Legacy entries predate witnessing
+ * and are never `versioned`.
+ */
+export declare function isVersioned(meta: StoreEntryMetadata): boolean;
+/**
+ * Doc-level witness state derived from all of a document's replay entries.
+ *
+ * - `awaitingWitness`: at least one entry is provisional (versioned but not yet
+ *   witnessed) — the document was created/edited locally and is still waiting to
+ *   be pushed to a trusted server.
+ * - `witnessed`: the document is witness-era (has at least one versioned entry)
+ *   AND no entry is still provisional — every versioned entry carries a
+ *   `receivedAt`. Legacy documents (no versioned entries) are neither
+ *   `awaitingWitness` nor `witnessed`.
+ *
+ * The two flags are mutually exclusive and computed from the same predicates as
+ * the trusted-time rule so they cannot drift.
+ */
+export declare function metadataWitnessState(metas: StoreEntryMetadata[]): {
+    awaitingWitness: boolean;
+    witnessed: boolean;
+};
+/**
+ * The trusted time (ms since epoch) used to order an entry on the changefeed
+ * and to pick the directory node it is judged against.
+ *
+ * - **Witnessed** (`receivedAt` present): the provable acceptance time.
+ * - **Versioned + un-witnessed** (provisional): the provided `now` — the entry
+ *   floats to the provisional head and cannot claim a historical slot.
+ * - **Legacy + un-witnessed**: the entry's own `createdAt` — a stable
+ *   historical position (it predates witnessing and will never be witnessed).
+ */
+export declare function entryTrustedTime(meta: StoreEntryMetadata, now: number): number;
+//# sourceMappingURL=storeEntryTime.d.ts.map

package/dist/core/storeEntryTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeEntryTime.d.ts","sourceRoot":"","sources":["../../src/core/storeEntryTime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;;GAQG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAE7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EAAE,GAC1B;IAAE,eAAe,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAIlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9E"}

package/dist/core/storeEntryTime.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isProvisional = isProvisional;
+exports.isVersioned = isVersioned;
+exports.metadataWitnessState = metadataWitnessState;
+exports.entryTrustedTime = entryTrustedTime;
+/**
+ * Shared trusted-time / provisional helpers for store entries.
+ *
+ * These centralize the version-aware trusted-time rule (see
+ * {@link StoreEntryMetadata.entryVersion}) so the changefeed, document
+ * materialization, the access-control judgment site, and the per-document
+ * "awaiting witness" flag all agree on what a store entry's trusted time is
+ * and whether it is still provisional.
+ */
+/**
+ * Whether an entry is "provisional": versioned (written in the witness-aware
+ * era) but not yet witnessed, so its trusted time is the wall-clock `now` and
+ * will move until a trusted witness stamps it with a `receivedAt`.
+ *
+ * Legacy entries (no {@link StoreEntryMetadata.entryVersion}) are NOT
+ * provisional even when un-witnessed: they were written before the witness era,
+ * are already synced within the tenant, and will never be witnessed — their
+ * trusted time is stable at `createdAt`.
+ */
+function isProvisional(meta) {
+    return meta.receivedAt === undefined && meta.entryVersion !== undefined;
+}
+/**
+ * Whether an entry was written in the witness-aware era (carries an
+ * {@link StoreEntryMetadata.entryVersion}). Legacy entries predate witnessing
+ * and are never `versioned`.
+ */
+function isVersioned(meta) {
+    return meta.entryVersion !== undefined;
+}
+/**
+ * Doc-level witness state derived from all of a document's replay entries.
+ *
+ * - `awaitingWitness`: at least one entry is provisional (versioned but not yet
+ *   witnessed) — the document was created/edited locally and is still waiting to
+ *   be pushed to a trusted server.
+ * - `witnessed`: the document is witness-era (has at least one versioned entry)
+ *   AND no entry is still provisional — every versioned entry carries a
+ *   `receivedAt`. Legacy documents (no versioned entries) are neither
+ *   `awaitingWitness` nor `witnessed`.
+ *
+ * The two flags are mutually exclusive and computed from the same predicates as
+ * the trusted-time rule so they cannot drift.
+ */
+function metadataWitnessState(metas) {
+    const awaitingWitness = metas.some(isProvisional);
+    const witnessed = !awaitingWitness && metas.some(isVersioned);
+    return { awaitingWitness, witnessed };
+}
+/**
+ * The trusted time (ms since epoch) used to order an entry on the changefeed
+ * and to pick the directory node it is judged against.
+ *
+ * - **Witnessed** (`receivedAt` present): the provable acceptance time.
+ * - **Versioned + un-witnessed** (provisional): the provided `now` — the entry
+ *   floats to the provisional head and cannot claim a historical slot.
+ * - **Legacy + un-witnessed**: the entry's own `createdAt` — a stable
+ *   historical position (it predates witnessing and will never be witnessed).
+ */
+function entryTrustedTime(meta, now) {
+    if (meta.receivedAt !== undefined) {
+        return meta.receivedAt;
+    }
+    return meta.entryVersion !== undefined ? now : meta.createdAt;
+}
+//# sourceMappingURL=storeEntryTime.js.map

package/dist/core/storeEntryTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeEntryTime.js","sourceRoot":"","sources":["../../src/core/storeEntryTime.ts"],"names":[],"mappings":";;AAsBA,sCAEC;AAOD,kCAEC;AAgBD,oDAMC;AAYD,4CAKC;AAtED;;;;;;;;GAQG;AAEH;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,IAAwB;IACpD,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAC,IAAwB;IAClD,OAAO,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,oBAAoB,CAClC,KAA2B;IAE3B,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,CAAC,eAAe,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,IAAwB,EAAE,GAAW;IACpE,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;AAChE,CAAC"}