@lossless.org/client 1.18.1 → 1.18.2

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@lossless.org/client',
-    version: '1.18.1',
+    version: '1.18.2',
     description: 'One typed client for NoSQLDB, MongoDB, SQLDB, MariaDB, ClickHouse and S3 object storage.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxzQkFBc0I7SUFDNUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLDBGQUEwRjtDQUN4RyxDQUFBIn0=

package/dist_ts/nosqldb/classes.bsonassertion.d.ts

@@ -1,2 +1,6 @@
-/** @internal Shared ordinary/exact assertion invariant. */
-export declare const assertBsonWithoutMutation: (documentArg: object, assertionArg: (valueArg: unknown) => void, errorArg: (reasonArg: "assertion" | "bson" | "mutation", causeArg?: unknown) => Error) => void;
+/**
+ * @internal Shared ordinary/exact assertion invariant. `beforeArg` is the
+ * document's BSON encoding before the assertion runs; `encodeArg` encodes it
+ * again afterwards, and any difference is a mutation.
+ */
+export declare const assertBsonWithoutMutation: (documentArg: object, beforeArg: Uint8Array, encodeArg: (documentArg: object) => Uint8Array, assertionArg: (valueArg: unknown) => void, errorArg: (reasonArg: "assertion" | "bson" | "mutation", causeArg?: unknown) => Error) => void;

package/dist_ts/nosqldb/classes.bsonassertion.js

@@ -1,7 +1,9 @@
-import * as plugins from './plugins.js';
-/** @internal Shared ordinary/exact assertion invariant. */
-export const assertBsonWithoutMutation = (documentArg, assertionArg, errorArg) => {
-    const before = plugins.mongodb.BSON.serialize(documentArg);
+/**
+ * @internal Shared ordinary/exact assertion invariant. `beforeArg` is the
+ * document's BSON encoding before the assertion runs; `encodeArg` encodes it
+ * again afterwards, and any difference is a mutation.
+ */
+export const assertBsonWithoutMutation = (documentArg, beforeArg, encodeArg, assertionArg, errorArg) => {
     try {
         const result = assertionArg(documentArg);
         if (result !== undefined) {
@@ -17,13 +19,13 @@ export const assertBsonWithoutMutation = (documentArg, assertionArg, errorArg) =
     }
     let after;
     try {
-        after = plugins.mongodb.BSON.serialize(documentArg);
+        after = encodeArg(documentArg);
     }
     catch (causeArg) {
         throw errorArg('bson', causeArg);
     }
-    if (before.length !== after.length || before.some((valueArg, indexArg) => valueArg !== after[indexArg])) {
+    if (Buffer.compare(beforeArg, after) !== 0) {
         throw errorArg('mutation');
     }
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5ic29uYXNzZXJ0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvbm9zcWxkYi9jbGFzc2VzLmJzb25hc3NlcnRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFFeEMsMkRBQTJEO0FBQzNELE1BQU0sQ0FBQyxNQUFNLHlCQUF5QixHQUFHLENBQ3ZDLFdBQW1CLEVBQ25CLFlBQXlDLEVBQ3pDLFFBQXFGLEVBQy9FLEVBQUU7SUFDUixNQUFNLE1BQU0sR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsV0FBVyxDQUFDLENBQUM7SUFDM0QsSUFBSSxDQUFDO1FBQ0gsTUFBTSxNQUFNLEdBQUcsWUFBWSxDQUFDLFdBQVcsQ0FBWSxDQUFDO1FBQ3BELElBQUksTUFBTSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3pCLHNFQUFzRTtZQUN0RSxxREFBcUQ7WUFDckQsSUFBSSxNQUFNLFlBQVksT0FBTztnQkFBRSxLQUFLLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxFQUFFLENBQUMsU0FBUyxDQUFDLENBQUM7WUFDbEUsTUFBTSxJQUFJLEtBQUssQ0FBQywrREFBK0QsQ0FBQyxDQUFDO1FBQ25GLENBQUM7SUFDSCxDQUFDO0lBQUMsT0FBTyxRQUFRLEVBQUUsQ0FBQztRQUFDLE1BQU0sUUFBUSxDQUFDLFdBQVcsRUFBRSxRQUFRLENBQUMsQ0FBQztJQUFDLENBQUM7SUFDN0QsSUFBSSxLQUFpQixDQUFDO0lBQ3RCLElBQUksQ0FBQztRQUFDLEtBQUssR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsV0FBVyxDQUFDLENBQUM7SUFBQyxDQUFDO0lBQzVELE9BQU8sUUFBUSxFQUFFLENBQUM7UUFBQyxNQUFNLFFBQVEsQ0FBQyxNQUFNLEVBQUUsUUFBUSxDQUFDLENBQUM7SUFBQyxDQUFDO0lBQ3RELElBQUksTUFBTSxDQUFDLE1BQU0sS0FBSyxLQUFLLENBQUMsTUFBTSxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxRQUFRLEVBQUUsUUFBUSxFQUFFLEVBQUUsQ0FBQyxRQUFRLEtBQUssS0FBSyxDQUFDLFFBQVEsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUN4RyxNQUFNLFFBQVEsQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUM3QixDQUFDO0FBQ0gsQ0FBQyxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5ic29uYXNzZXJ0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvbm9zcWxkYi9jbGFzc2VzLmJzb25hc3NlcnRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLHlCQUF5QixHQUFHLENBQ3ZDLFdBQW1CLEVBQ25CLFNBQXFCLEVBQ3JCLFNBQThDLEVBQzlDLFlBQXlDLEVBQ3pDLFFBQXFGLEVBQy9FLEVBQUU7SUFDUixJQUFJLENBQUM7UUFDSCxNQUFNLE1BQU0sR0FBRyxZQUFZLENBQUMsV0FBVyxDQUFZLENBQUM7UUFDcEQsSUFBSSxNQUFNLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDekIsc0VBQXNFO1lBQ3RFLHFEQUFxRDtZQUNyRCxJQUFJLE1BQU0sWUFBWSxPQUFPO2dCQUFFLEtBQUssTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFHLEVBQUUsQ0FBQyxTQUFTLENBQUMsQ0FBQztZQUNsRSxNQUFNLElBQUksS0FBSyxDQUFDLCtEQUErRCxDQUFDLENBQUM7UUFDbkYsQ0FBQztJQUNILENBQUM7SUFBQyxPQUFPLFFBQVEsRUFBRSxDQUFDO1FBQUMsTUFBTSxRQUFRLENBQUMsV0FBVyxFQUFFLFFBQVEsQ0FBQyxDQUFDO0lBQUMsQ0FBQztJQUM3RCxJQUFJLEtBQWlCLENBQUM7SUFDdEIsSUFBSSxDQUFDO1FBQUMsS0FBSyxHQUFHLFNBQVMsQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUFDLENBQUM7SUFDdkMsT0FBTyxRQUFRLEVBQUUsQ0FBQztRQUFDLE1BQU0sUUFBUSxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsQ0FBQztJQUFDLENBQUM7SUFDdEQsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUMzQyxNQUFNLFFBQVEsQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUM3QixDQUFDO0FBQ0gsQ0FBQyxDQUFDIn0=

package/dist_ts/nosqldb/classes.exactpersistence.d.ts

@@ -132,16 +132,52 @@ export declare class SmartdataExactCollection<TModel extends SmartDataDbDoc<any,
      * reconciliation read runs on the interrupted call's budget.
      */
     private interruptedWriteError;
+    /** The collection's one BSON encoder: every encoding of a row passes here. */
+    private encodeBson;
+    /** The collection's one BSON decoder: every decoding of a row passes here. */
+    private decodeBson;
+    /** Decodes proven canonical bytes into a fresh canonical document. */
+    private decodeCanonical;
+    /**
+     * The exactness proof: the document's sorted encoding must decode and
+     * encode again to the same bytes. Returns those canonical bytes and the
+     * decoding the proof produced, which no caller has seen yet.
+     */
     private canonicalizeDocument;
+    /**
+     * Whether a document encodes canonically to bytes an earlier proof
+     * produced. Equal bytes carry that proof and its assertion over, so the
+     * caller needs neither again; on a mismatch the caller runs the full proof
+     * to report what is wrong.
+     */
+    private encodesAs;
     private assertAllowedTopLevelKeys;
-    private canonicalizePersistedDocument;
-    private canonicalizeStoredDocument;
+    /**
+     * Proves an application body canonical and runs the assertion once, on the
+     * proof's own decoding, which is never handed out. Returns the canonical
+     * bytes of the body.
+     */
+    private provePersistedDocument;
+    /**
+     * Proves a stored envelope canonical, checks its storage metadata and runs
+     * the assertion once on its body. The body is the proof's own decoding with
+     * the metadata removed, so the assertion never sees a document a caller
+     * receives. Returns the canonical bytes of the envelope and of its body.
+     */
+    private proveStoredDocument;
+    /** Proves a stored envelope and returns a fresh canonical decoding of it. */
+    private readStoredDocument;
+    /**
+     * The canonical envelope of a proven body. BSON encodes every element on
+     * its own, so a proven body with inert metadata is canonical as a whole;
+     * only the canonical key order has to be restored.
+     */
+    private composeStoredDocument;
     private assertWithoutMutation;
-    private getPersistedBody;
-    private persistedDocumentsEqual;
-    private storedDocumentsEqual;
     private validateReconcileIdentity;
+    /** The persisted body a model serializes to, before any proof. */
     private serializeModel;
+    /** Proves an insert input and returns the canonical bytes of its body. */
     private createPersistedDocument;
     private hydrateStoredDocument;
     private findByReconcileIdentity;