anchordb 0.2.0

package/dist/cjs/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,sFAAsF;AACtF,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,EAAE,MAAM,CAAiB;gBAEnC,OAAO,EAAE,MAAM;CAI5B;AAED,wFAAwF;AACxF,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,SAAkB,IAAI,uBAAuB;CAC9C;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,SAAkB,IAAI,oBAAoB;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEjC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;CAOxG;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC,SAAkB,IAAI,eAAe;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAYxE;AAED,uEAAuE;AACvE,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,SAAkB,IAAI,qBAAqB;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAM;gBAErD,SAAS,CAAC,EAAE,MAAM;IAK9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAK/D,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,YAAY;CAKrB;AAED,iFAAiF;AACjF,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,SAAkB,IAAI,2BAA2B;IACjD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,+EAA+E;AAC/E,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,SAAkB,IAAI,qBAAqB;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;CAIzB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,SAAkB,IAAI,sBAAsB;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEvB,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CAOF;AAED,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,gBAAgB,CAanB;AAED,0FAA0F;AAC1F,qBAAa,cAAe,SAAQ,WAAW;IAC7C,SAAkB,IAAI,yBAAyB;IAC/C,QAAQ,CAAC,IAAI,SAAsB;IACnC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IACzF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAElC,IAAI,EAAE;QAChB,WAAW,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,KAAK,CAAA;SAAE,CAAC,CAAC;QAChF,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC;CAMF"}

package/dist/cjs/core/errors.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Mongoose-shaped error hierarchy.
+ *
+ * Principle 1 (zero re-learning) applies to failures as much as to successes: code that already
+ * does `if (err.code === 11000)` or reads `err.errors[path].kind` on the backend must work
+ * unchanged here. Every class below mirrors the name, message format and enumerable properties
+ * Mongoose produces.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkWriteError = exports.DUPLICATE_KEY_CODE = exports.MongoServerError = exports.StrictModeError = exports.DocumentNotFoundError = exports.ValidationError = exports.CastError = exports.ValidatorError = exports.AnchorConfigError = exports.AnchorError = void 0;
+exports.duplicateKeyError = duplicateKeyError;
+/** Base class for every error AnchorDB raises. Mirrors Mongoose's `MongooseError`. */
+class AnchorError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AnchorError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.AnchorError = AnchorError;
+/** Configuration rejected at construction time (bad timezone, unknown adapter, ...). */
+class AnchorConfigError extends AnchorError {
+    constructor() {
+        super(...arguments);
+        this.name = "AnchorConfigError";
+    }
+}
+exports.AnchorConfigError = AnchorConfigError;
+/**
+ * A single failed validator on one path. Mongoose calls this `ValidatorError` and nests instances
+ * inside `ValidationError.errors`.
+ */
+class ValidatorError extends AnchorError {
+    constructor(opts) {
+        super(opts.message);
+        this.name = "ValidatorError";
+        this.path = opts.path;
+        this.value = opts.value;
+        this.kind = opts.kind;
+        this.properties = { ...opts };
+    }
+}
+exports.ValidatorError = ValidatorError;
+/**
+ * Failure converting a value to its declared type. Message format matches Mongoose so that
+ * log-scraping and error reporting behave identically.
+ */
+class CastError extends AnchorError {
+    constructor(kind, value, path, reason) {
+        const stringValue = stringifyValue(value);
+        super(`Cast to ${kind} failed for value ${stringValue} (type ${typeOf(value)}) at path "${path}"` +
+            (reason ? `: ${reason}` : ""));
+        this.name = "CastError";
+        this.kind = kind;
+        this.value = value;
+        this.path = path;
+        this.stringValue = stringValue;
+        this.valueType = typeOf(value);
+    }
+}
+exports.CastError = CastError;
+/** Aggregate of every path that failed validation for one document. */
+class ValidationError extends AnchorError {
+    constructor(modelName) {
+        super(modelName ? `${modelName} validation failed` : "Validation failed");
+        this.name = "ValidationError";
+        this.errors = {};
+        this.modelName = modelName;
+    }
+    addError(path, error) {
+        this.errors[path] = error;
+        this.message = this.buildMessage();
+    }
+    get isEmpty() {
+        return Object.keys(this.errors).length === 0;
+    }
+    buildMessage() {
+        const prefix = this.modelName ? `${this.modelName} validation failed` : "Validation failed";
+        const parts = Object.entries(this.errors).map(([path, err]) => `${path}: ${err.message}`);
+        return `${prefix}: ${parts.join(", ")}`;
+    }
+}
+exports.ValidationError = ValidationError;
+/** Raised by `orFail()` and by Lens edits targeting a document that vanished. */
+class DocumentNotFoundError extends AnchorError {
+    constructor(filter, modelName) {
+        super(`No document found for query ${JSON.stringify(filter)}` + (modelName ? ` on model "${modelName}"` : ""));
+        this.name = "DocumentNotFoundError";
+        this.filter = filter;
+    }
+}
+exports.DocumentNotFoundError = DocumentNotFoundError;
+/** Writing a path not present in the schema while `strict: "throw"` is set. */
+class StrictModeError extends AnchorError {
+    constructor(path) {
+        super(`Field \`${path}\` is not in schema and strict mode is set to throw.`);
+        this.name = "StrictModeError";
+        this.path = path;
+    }
+}
+exports.StrictModeError = StrictModeError;
+/**
+ * Server-style write error. A unique index violation surfaces as one of these with `code: 11000`,
+ * exactly like the MongoDB driver, so `err.code === 11000` branches port over untouched.
+ */
+class MongoServerError extends AnchorError {
+    constructor(opts) {
+        super(opts.message);
+        this.name = "MongoServerError";
+        this.code = opts.code;
+        this.keyPattern = opts.keyPattern;
+        this.keyValue = opts.keyValue;
+        this.index = opts.index;
+    }
+}
+exports.MongoServerError = MongoServerError;
+exports.DUPLICATE_KEY_CODE = 11000;
+/**
+ * Build the duplicate-key error MongoDB produces. The message is reproduced literally — including
+ * the `E11000 duplicate key error collection:` prefix — because real code greps for it.
+ */
+function duplicateKeyError(opts) {
+    const keyStr = Object.entries(opts.keyValue)
+        .map(([k, v]) => `${k}: ${stringifyValue(v)}`)
+        .join(", ");
+    return new MongoServerError({
+        message: `E11000 duplicate key error collection: ${opts.dbName}.${opts.collection} ` +
+            `index: ${opts.index} dup key: { ${keyStr} }`,
+        code: exports.DUPLICATE_KEY_CODE,
+        keyPattern: opts.keyPattern,
+        keyValue: opts.keyValue,
+        index: opts.index,
+    });
+}
+/** Reported by `insertMany({ ordered: false })` after every insert has been attempted. */
+class BulkWriteError extends AnchorError {
+    constructor(opts) {
+        super(`Bulk write failed with ${opts.writeErrors.length} error(s)`);
+        this.name = "MongoBulkWriteError";
+        this.code = exports.DUPLICATE_KEY_CODE;
+        this.writeErrors = opts.writeErrors;
+        this.insertedCount = opts.insertedCount;
+        this.insertedIds = opts.insertedIds;
+    }
+}
+exports.BulkWriteError = BulkWriteError;
+function typeOf(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "Array";
+    return typeof value;
+}
+function stringifyValue(value) {
+    if (typeof value === "string")
+        return `"${value}"`;
+    if (value === undefined)
+        return "undefined";
+    if (value === null)
+        return "null";
+    if (value instanceof Date)
+        return `"${value.toISOString()}"`;
+    if (typeof value === "object") {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return String(value);
+        }
+    }
+    return String(value);
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAkJH,8CAmBC;AAnKD,sFAAsF;AACtF,MAAa,WAAY,SAAQ,KAAK;IAGpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAW,aAAa,CAAC;QAI7C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAPD,kCAOC;AAED,wFAAwF;AACxF,MAAa,iBAAkB,SAAQ,WAAW;IAAlD;;QACoB,SAAI,GAAG,mBAAmB,CAAC;IAC/C,CAAC;CAAA;AAFD,8CAEC;AAED;;;GAGG;AACH,MAAa,cAAe,SAAQ,WAAW;IAQ7C,YAAY,IAA2F;QACrG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QARJ,SAAI,GAAG,gBAAgB,CAAC;QASxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAChC,CAAC;CACF;AAfD,wCAeC;AAED;;;GAGG;AACH,MAAa,SAAU,SAAQ,WAAW;IAQxC,YAAY,IAAY,EAAE,KAAc,EAAE,IAAY,EAAE,MAAe;QACrE,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,KAAK,CACH,WAAW,IAAI,qBAAqB,WAAW,UAAU,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,GAAG;YACzF,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAChC,CAAC;QAZc,SAAI,GAAG,WAAW,CAAC;QAanC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACF;AApBD,8BAoBC;AAED,uEAAuE;AACvE,MAAa,eAAgB,SAAQ,WAAW;IAI9C,YAAY,SAAkB;QAC5B,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAJ1D,SAAI,GAAG,iBAAiB,CAAC;QAClC,WAAM,GAA+C,EAAE,CAAC;QAI/D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAID,QAAQ,CAAC,IAAY,EAAE,KAAiC;QACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/C,CAAC;IAEO,YAAY;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,CAAC;QAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1F,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC1C,CAAC;CACF;AAzBD,0CAyBC;AAED,iFAAiF;AACjF,MAAa,qBAAsB,SAAQ,WAAW;IAIpD,YAAY,MAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAJ/F,SAAI,GAAG,uBAAuB,CAAC;QAK/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AARD,sDAQC;AAED,+EAA+E;AAC/E,MAAa,eAAgB,SAAQ,WAAW;IAI9C,YAAY,IAAY;QACtB,KAAK,CAAC,WAAW,IAAI,sDAAsD,CAAC,CAAC;QAJ7D,SAAI,GAAG,iBAAiB,CAAC;QAKzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AARD,0CAQC;AAED;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,WAAW;IAO/C,YAAY,IAMX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAbJ,SAAI,GAAG,kBAAkB,CAAC;QAc1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AApBD,4CAoBC;AAEY,QAAA,kBAAkB,GAAG,KAAK,CAAC;AAExC;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,IAMjC;IACC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,IAAI,gBAAgB,CAAC;QAC1B,OAAO,EACL,0CAA0C,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,GAAG;YAC3E,UAAU,IAAI,CAAC,KAAK,eAAe,MAAM,IAAI;QAC/C,IAAI,EAAE,0BAAkB;QACxB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAa,cAAe,SAAQ,WAAW;IAO7C,YAAY,IAIX;QACC,KAAK,CAAC,0BAA0B,IAAI,CAAC,WAAW,CAAC,MAAM,WAAW,CAAC,CAAC;QAXpD,SAAI,GAAG,qBAAqB,CAAC;QACtC,SAAI,GAAG,0BAAkB,CAAC;QAWjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;CACF;AAjBD,wCAiBC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,GAAG,CAAC;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/cjs/core/hex.d.ts

@@ -0,0 +1,4 @@
+export declare function bytesToHex(bytes: Uint8Array): string;
+/** Returns null rather than throwing, so callers can produce their own typed error. */
+export declare function hexToBytes(hex: string, expectedLength?: number): Uint8Array | null;
+//# sourceMappingURL=hex.d.ts.map

package/dist/cjs/core/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../../src/core/hex.ts"],"names":[],"mappings":"AASA,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOpD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAYlF"}

package/dist/cjs/core/hex.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bytesToHex = bytesToHex;
+exports.hexToBytes = hexToBytes;
+const HEX_CHARS = "0123456789abcdef";
+const HEX_LOOKUP = (() => {
+    const table = new Array(256).fill(-1);
+    for (let i = 0; i < 10; i++)
+        table[48 + i] = i; // '0'-'9'
+    for (let i = 0; i < 6; i++)
+        table[97 + i] = 10 + i; // 'a'-'f'
+    for (let i = 0; i < 6; i++)
+        table[65 + i] = 10 + i; // 'A'-'F'
+    return table;
+})();
+function bytesToHex(bytes) {
+    let out = "";
+    for (let i = 0; i < bytes.length; i++) {
+        const b = bytes[i];
+        out += HEX_CHARS[b >> 4] + HEX_CHARS[b & 0x0f];
+    }
+    return out;
+}
+/** Returns null rather than throwing, so callers can produce their own typed error. */
+function hexToBytes(hex, expectedLength) {
+    if (hex.length % 2 !== 0)
+        return null;
+    const len = hex.length / 2;
+    if (expectedLength !== undefined && len !== expectedLength)
+        return null;
+    const out = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        const hi = HEX_LOOKUP[hex.charCodeAt(i * 2)] ?? -1;
+        const lo = HEX_LOOKUP[hex.charCodeAt(i * 2 + 1)] ?? -1;
+        if (hi < 0 || lo < 0)
+            return null;
+        out[i] = (hi << 4) | lo;
+    }
+    return out;
+}
+//# sourceMappingURL=hex.js.map

package/dist/cjs/core/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../../src/core/hex.ts"],"names":[],"mappings":";;AASA,gCAOC;AAGD,gCAYC;AA/BD,MAAM,SAAS,GAAG,kBAAkB,CAAC;AACrC,MAAM,UAAU,GAAa,CAAC,GAAG,EAAE;IACjC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU;IAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU;IAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,EAAE,CAAC;AAEL,SAAgB,UAAU,CAAC,KAAiB;IAC1C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,GAAG,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,CAAE,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,CAAE,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uFAAuF;AACvF,SAAgB,UAAU,CAAC,GAAW,EAAE,cAAuB;IAC7D,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,IAAI,cAAc,KAAK,SAAS,IAAI,GAAG,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cjs/core/hlc.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Hybrid Logical Clock.
+ *
+ * Wall clocks on phones are wrong often enough that ordering cannot be built on them: users change
+ * the date, timezones shift, DST jumps, and devices sit offline for days. An HLC keeps the *useful*
+ * property of a wall clock (roughly tracks real time, so it stays human-interpretable) while adding
+ * the property a wall clock lacks (it never goes backwards, and it advances whenever it observes a
+ * newer clock elsewhere).
+ *
+ * Encoded form is fixed-width and lexicographically sortable, so it can be compared as TEXT in SQL
+ * and used directly as a sort key:
+ *
+ *   000001756616340000-00000-cli_7f3a
+ *   \______wall_____/ \cnt/ \_node_/
+ */
+export interface Hlc {
+    /** Physical time in epoch milliseconds (skew-corrected where an offset is known). */
+    readonly wall: number;
+    /** Logical counter, breaks ties inside a single millisecond. */
+    readonly counter: number;
+    /** Node identity — the client id. Guarantees a total order with no ties. */
+    readonly node: string;
+}
+export declare function encodeHlc(hlc: Hlc): string;
+export declare function decodeHlc(encoded: string): Hlc;
+/**
+ * Total order over HLC stamps: wall, then counter, then node.
+ *
+ * The node tiebreak is what makes this a *total* order rather than a partial one. Without it two
+ * devices could produce genuinely equal stamps and "last write wins" would have no answer — the
+ * outcome would depend on map iteration order, which is how a sync engine ends up non-deterministic
+ * and different devices converge to different documents.
+ */
+export declare function compareHlc(a: Hlc, b: Hlc): number;
+export declare function compareHlcStamps(a: string, b: string): number;
+export interface HlcOptions {
+    node: string;
+    /** Injected so the sync engine can supply server-skew-corrected time. Defaults to Date.now. */
+    now?: () => number;
+    /**
+     * How far ahead of local time an *untrusted* peer stamp may be before it is ignored (default
+     * 1 hour). Guards against one device with a broken clock dragging the whole fleet forward.
+     *
+     * Deliberately does NOT apply to trusted stamps — see `update()`.
+     */
+    maxDriftMs?: number;
+}
+export declare class HybridLogicalClock {
+    /**
+     * Not `readonly`: the client id is only known for certain after storage has been opened and the
+     * persisted one restored. See setNode().
+     */
+    node: string;
+    private wall;
+    private counter;
+    private readonly nowFn;
+    private readonly maxDriftMs;
+    constructor(opts: HlcOptions);
+    /** Stamp a local event. Never returns a value <= the previous one. */
+    tick(): Hlc;
+    /** Stamp a local event and return the encoded form. */
+    tickStamp(): string;
+    /**
+     * Merge an observed remote stamp, then stamp a local event. This is what lets a device with a
+     * wrong clock self-correct: after one sync it is ordered relative to everyone else.
+     *
+     * `trusted` matters more than it looks. The drift guard compares the remote stamp against the
+     * *local* clock — but the whole reason we need an HLC is that the local clock may be the wrong
+     * one. A device sitting an hour behind would see every legitimate stamp as an "absurd future" and
+     * reject all of them, permanently isolating itself in the ordering: the guard would defeat the
+     * mechanism it is protecting.
+     *
+     * So the server, which is the time authority, is always adopted (`trusted: true`). The guard
+     * applies only to peer stamps, where we genuinely cannot tell whose clock is broken.
+     */
+    update(remote: Hlc | string, opts?: {
+        trusted?: boolean;
+    }): Hlc;
+    updateStamp(remote: Hlc | string, opts?: {
+        trusted?: boolean;
+    }): string;
+    /** Current value without advancing. */
+    peek(): Hlc;
+    /**
+     * Correct the node identity before any stamp is issued.
+     *
+     * AnchorDB generates a client id synchronously in its constructor, but the *persisted* id is only
+     * available after the adapter opens. Without this, a restarted app would stamp with a fresh node
+     * id while presenting the restored one as its clientId — the HLC tiebreak and the device identity
+     * would disagree, and two runs of the same device would order as if they were different devices.
+     */
+    setNode(node: string): void;
+    /** Restore across an app restart, so ordering survives process death. */
+    restore(stamp: Hlc | string): void;
+}
+//# sourceMappingURL=hlc.d.ts.map

package/dist/cjs/core/hlc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hlc.d.ts","sourceRoot":"","sources":["../../../src/core/hlc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,GAAG;IAClB,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAQ1C;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAW9C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAKjD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,kBAAkB;IAC7B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,IAAI,EAAE,UAAU;IAQ5B,sEAAsE;IACtE,IAAI,IAAI,GAAG;IAgBX,uDAAuD;IACvD,SAAS,IAAI,MAAM;IAInB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,GAAG;IA0BnE,WAAW,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,MAAM;IAI3E,uCAAuC;IACvC,IAAI,IAAI,GAAG;IAIX;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;CAOnC"}

package/dist/cjs/core/hlc.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Hybrid Logical Clock.
+ *
+ * Wall clocks on phones are wrong often enough that ordering cannot be built on them: users change
+ * the date, timezones shift, DST jumps, and devices sit offline for days. An HLC keeps the *useful*
+ * property of a wall clock (roughly tracks real time, so it stays human-interpretable) while adding
+ * the property a wall clock lacks (it never goes backwards, and it advances whenever it observes a
+ * newer clock elsewhere).
+ *
+ * Encoded form is fixed-width and lexicographically sortable, so it can be compared as TEXT in SQL
+ * and used directly as a sort key:
+ *
+ *   000001756616340000-00000-cli_7f3a
+ *   \______wall_____/ \cnt/ \_node_/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridLogicalClock = void 0;
+exports.encodeHlc = encodeHlc;
+exports.decodeHlc = decodeHlc;
+exports.compareHlc = compareHlc;
+exports.compareHlcStamps = compareHlcStamps;
+const WALL_DIGITS = 15;
+const COUNTER_DIGITS = 5;
+const MAX_COUNTER = 99_999;
+function encodeHlc(hlc) {
+    return (String(hlc.wall).padStart(WALL_DIGITS, "0") +
+        "-" +
+        String(hlc.counter).padStart(COUNTER_DIGITS, "0") +
+        "-" +
+        hlc.node);
+}
+function decodeHlc(encoded) {
+    const first = encoded.indexOf("-");
+    const second = encoded.indexOf("-", first + 1);
+    if (first < 0 || second < 0) {
+        throw new TypeError(`Malformed HLC stamp: "${encoded}"`);
+    }
+    return {
+        wall: Number(encoded.slice(0, first)),
+        counter: Number(encoded.slice(first + 1, second)),
+        node: encoded.slice(second + 1),
+    };
+}
+/**
+ * Total order over HLC stamps: wall, then counter, then node.
+ *
+ * The node tiebreak is what makes this a *total* order rather than a partial one. Without it two
+ * devices could produce genuinely equal stamps and "last write wins" would have no answer — the
+ * outcome would depend on map iteration order, which is how a sync engine ends up non-deterministic
+ * and different devices converge to different documents.
+ */
+function compareHlc(a, b) {
+    if (a.wall !== b.wall)
+        return a.wall < b.wall ? -1 : 1;
+    if (a.counter !== b.counter)
+        return a.counter < b.counter ? -1 : 1;
+    if (a.node === b.node)
+        return 0;
+    return a.node < b.node ? -1 : 1;
+}
+function compareHlcStamps(a, b) {
+    // Fixed-width encoding means plain string comparison is already the correct order.
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+class HybridLogicalClock {
+    constructor(opts) {
+        this.node = opts.node;
+        this.nowFn = opts.now ?? (() => Date.now());
+        this.maxDriftMs = opts.maxDriftMs ?? 3_600_000;
+        this.wall = 0;
+        this.counter = 0;
+    }
+    /** Stamp a local event. Never returns a value <= the previous one. */
+    tick() {
+        const physical = this.nowFn();
+        if (physical > this.wall) {
+            this.wall = physical;
+            this.counter = 0;
+        }
+        else {
+            // Physical clock stalled or went backwards; keep moving via the logical counter.
+            this.counter += 1;
+            if (this.counter > MAX_COUNTER) {
+                this.wall += 1;
+                this.counter = 0;
+            }
+        }
+        return { wall: this.wall, counter: this.counter, node: this.node };
+    }
+    /** Stamp a local event and return the encoded form. */
+    tickStamp() {
+        return encodeHlc(this.tick());
+    }
+    /**
+     * Merge an observed remote stamp, then stamp a local event. This is what lets a device with a
+     * wrong clock self-correct: after one sync it is ordered relative to everyone else.
+     *
+     * `trusted` matters more than it looks. The drift guard compares the remote stamp against the
+     * *local* clock — but the whole reason we need an HLC is that the local clock may be the wrong
+     * one. A device sitting an hour behind would see every legitimate stamp as an "absurd future" and
+     * reject all of them, permanently isolating itself in the ordering: the guard would defeat the
+     * mechanism it is protecting.
+     *
+     * So the server, which is the time authority, is always adopted (`trusted: true`). The guard
+     * applies only to peer stamps, where we genuinely cannot tell whose clock is broken.
+     */
+    update(remote, opts = {}) {
+        const r = typeof remote === "string" ? decodeHlc(remote) : remote;
+        const physical = this.nowFn();
+        const tooFarAhead = !opts.trusted && r.wall > physical + this.maxDriftMs;
+        const remoteWall = tooFarAhead ? this.wall : r.wall;
+        if (physical > this.wall && physical > remoteWall) {
+            this.wall = physical;
+            this.counter = 0;
+        }
+        else if (remoteWall > this.wall) {
+            this.wall = remoteWall;
+            this.counter = r.counter + 1;
+        }
+        else if (this.wall === remoteWall) {
+            this.counter = Math.max(this.counter, r.counter) + 1;
+        }
+        else {
+            this.counter += 1;
+        }
+        if (this.counter > MAX_COUNTER) {
+            this.wall += 1;
+            this.counter = 0;
+        }
+        return { wall: this.wall, counter: this.counter, node: this.node };
+    }
+    updateStamp(remote, opts = {}) {
+        return encodeHlc(this.update(remote, opts));
+    }
+    /** Current value without advancing. */
+    peek() {
+        return { wall: this.wall, counter: this.counter, node: this.node };
+    }
+    /**
+     * Correct the node identity before any stamp is issued.
+     *
+     * AnchorDB generates a client id synchronously in its constructor, but the *persisted* id is only
+     * available after the adapter opens. Without this, a restarted app would stamp with a fresh node
+     * id while presenting the restored one as its clientId — the HLC tiebreak and the device identity
+     * would disagree, and two runs of the same device would order as if they were different devices.
+     */
+    setNode(node) {
+        this.node = node;
+    }
+    /** Restore across an app restart, so ordering survives process death. */
+    restore(stamp) {
+        const h = typeof stamp === "string" ? decodeHlc(stamp) : stamp;
+        if (h.wall > this.wall || (h.wall === this.wall && h.counter > this.counter)) {
+            this.wall = h.wall;
+            this.counter = h.counter;
+        }
+    }
+}
+exports.HybridLogicalClock = HybridLogicalClock;
+//# sourceMappingURL=hlc.js.map

package/dist/cjs/core/hlc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hlc.js","sourceRoot":"","sources":["../../../src/core/hlc.ts"],"names":[],"mappings":"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"}

package/dist/cjs/core/object-id.d.ts

@@ -0,0 +1,38 @@
+export type ObjectIdLike = ObjectId | string | Uint8Array | {
+    toHexString(): string;
+};
+/**
+ * A note on numbers: bson (and therefore Mongoose) rejects `new ObjectId(1234)` outright with
+ * "Argument passed in does not match the accepted types". AnchorDB rejects it too, rather than
+ * offering a friendlier overload, because a convenience that exists only here is exactly the kind
+ * of drift that stops code porting cleanly. Build from a time with `createFromTime()`.
+ */
+export declare class ObjectId {
+    /** Marks the value for BSON/Mongoose consumers that brand-check instead of instanceof. */
+    readonly _bsontype = "ObjectId";
+    private readonly bytes;
+    private cachedHex;
+    constructor(value?: ObjectIdLike | null);
+    /** Raw 12 bytes. Copied, so callers cannot mutate an id in place. */
+    get id(): Uint8Array;
+    toHexString(): string;
+    toString(): string;
+    /** Serialises to the plain hex string, matching Mongoose — not to `{ $oid }`. */
+    toJSON(): string;
+    /** Second-precision creation time. Useful, but never the canonical `createdAt`. */
+    getTimestamp(): Date;
+    equals(other: ObjectIdLike | null | undefined): boolean;
+    inspect(): string;
+    /** Raw 12-byte generator. `time` is seconds since the epoch; defaults to now. */
+    static generate(time?: number): Uint8Array;
+    static createFromHexString(hex: string): ObjectId;
+    static createFromTime(seconds: number): ObjectId;
+    /**
+     * Mirrors the driver's `isValid`: accepts a 24-char hex string, 12 raw bytes, an ObjectId, or
+     * anything exposing `toHexString()`. Notably it does *not* accept arbitrary 12-char strings.
+     */
+    static isValid(value: unknown): boolean;
+    /** Test seam so counter-rollover behaviour can be exercised deterministically. */
+    static __setCounter(value: number): void;
+}
+//# sourceMappingURL=object-id.d.ts.map

package/dist/cjs/core/object-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-id.d.ts","sourceRoot":"","sources":["../../../src/core/object-id.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG;IAAE,WAAW,IAAI,MAAM,CAAA;CAAE,CAAC;AAEtF;;;;;GAKG;AAEH,qBAAa,QAAQ;IACnB,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,cAAc;IAEhC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,SAAS,CAAuB;gBAE5B,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI;IAqCvC,qEAAqE;IACrE,IAAI,EAAE,IAAI,UAAU,CAEnB;IAED,WAAW,IAAI,MAAM;IAKrB,QAAQ,IAAI,MAAM;IAIlB,iFAAiF;IACjF,MAAM,IAAI,MAAM;IAIhB,mFAAmF;IACnF,YAAY,IAAI,IAAI;IAKpB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAgBvD,OAAO,IAAI,MAAM;IAIjB,iFAAiF;IACjF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU;IAmB1C,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAIjD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAShD;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAWvC,kFAAkF;IAClF,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGzC"}