anchordb 0.2.0

package/dist/esm/core/anchor-db.js

@@ -0,0 +1,269 @@
+import { AnchorConfigError } from "./errors.js";
+import { HybridLogicalClock } from "./hlc.js";
+import { generateClientId } from "./uuid.js";
+import { TypedEmitter } from "../events/emitter.js";
+import { TimeService } from "../timestamps/index.js";
+import { assertValidTimeZone } from "../timestamps/timezone.js";
+import { Schema } from "../schema/schema.js";
+import { Model } from "../model/model.js";
+import { createModelConstructor } from "../model/document.js";
+import { MemoryAdapter } from "../storage/adapters/memory.js";
+/**
+ * AnchorDB — MongoDB + Mongoose for mobile apps.
+ *
+ * ## Two modes, one API
+ *
+ * Passing no `sync` block yields a **purely local database**: no mutation queue is created, no
+ * network code is instantiated, deletes are hard deletes rather than tombstones, and documents
+ * carry no sync metadata. That is not a degraded mode — it is the default, and an app with no
+ * backend never pays for machinery it does not use.
+ *
+ * Adding a `sync` block later changes no application code. Existing documents are adopted on first
+ * sync (seeded dirty at version 0) so nothing has to be rewritten or re-imported.
+ */
+export class AnchorDB {
+    constructor(config) {
+        this.emitter = new TypedEmitter();
+        this.models = new Map();
+        this.constructors = new Map();
+        this.openPromise = null;
+        this.closed = false;
+        /** Installed by the sync engine when sync is configured. */
+        this.mutationRecorder = null;
+        // ---- sync facade ---------------------------------------------------------
+        /**
+         * Always present, even with no backend, so UI bound to sync state does not have to branch. In
+         * local-only mode `status()` reports "disabled" and the actions are explicit no-ops rather than
+         * throwing — a dashboard that renders sync state should degrade, not crash.
+         */
+        this.sync = {
+            status: () => this.syncStatusValue,
+            isEnabled: () => this.syncEnabled,
+            now: async () => {
+                if (!this.syncEnabled)
+                    return null;
+                if (!this.syncRunner) {
+                    throw new AnchorConfigError("Sync is configured but the sync engine has not been attached. Import and call attachSync(db).");
+                }
+                return this.syncRunner();
+            },
+            pending: async () => (this.pendingCounter ? this.pendingCounter() : 0),
+        };
+        this.syncRunner = null;
+        this.pendingCounter = null;
+        // ---- internals -----------------------------------------------------------
+        this.runtimeCache = null;
+        if (!config.name || typeof config.name !== "string") {
+            throw new AnchorConfigError("AnchorDB requires a `name`, e.g. new AnchorDB({ name: \"my-app\" }).");
+        }
+        this.config = config;
+        this.name = config.name;
+        // Validated at construction so a typo fails immediately rather than silently rendering wrong
+        // times for the life of the app (§26.10).
+        if (config.timezone?.server)
+            assertValidTimeZone(config.timezone.server, "timezone.server");
+        this.time = new TimeService(config.timezone?.server ? { serverTimeZone: config.timezone.server } : {});
+        this.clientIdValue = config.clientId ?? generateClientId();
+        this.clockInstance = new HybridLogicalClock({ node: this.clientIdValue, now: () => this.time.nowMs() });
+        this.adapterInstance = config.adapter ?? new MemoryAdapter(config.name);
+        this.syncStatusValue = config.sync ? "idle" : "disabled";
+        if (config.inspector?.enabled)
+            this.assertInspectorSafe(config.inspector);
+    }
+    /** True when a `sync` block was supplied. */
+    get syncEnabled() {
+        return this.config.sync !== undefined;
+    }
+    get clientId() {
+        return this.clientIdValue;
+    }
+    get adapter() {
+        return this.adapterInstance;
+    }
+    /** Exposed for the sync engine, which must stamp and advance the same clock the models use. */
+    get clock() {
+        return this.clockInstance;
+    }
+    /** Opened lazily on first use, so construction never does I/O. */
+    async open() {
+        this.openPromise ??= (async () => {
+            await this.adapterInstance.open();
+            const storedClientId = await this.adapterInstance.getState("anchor:clientId");
+            if (storedClientId) {
+                // Adopt the persisted identity, and correct the clock with it: the clock was built in the
+                // constructor with a freshly generated id, before storage could be consulted.
+                this.clientIdValue = storedClientId;
+                this.clockInstance.setNode(storedClientId);
+            }
+            else {
+                await this.adapterInstance.setState("anchor:clientId", this.clientIdValue);
+            }
+            // Restoring the clock keeps ordering monotonic across an app restart.
+            const storedClock = await this.adapterInstance.getState("anchor:hlc");
+            if (storedClock)
+                this.clockInstance.restore(storedClock);
+        })();
+        return this.openPromise;
+    }
+    async close() {
+        if (this.closed)
+            return;
+        if (this.openPromise) {
+            await this.openPromise;
+            await this.adapterInstance.setState("anchor:hlc", encodeClock(this.clockInstance));
+            await this.adapterInstance.close();
+        }
+        this.closed = true;
+    }
+    /** Mirrors `mongoose.model()`. Calling it again with the same name returns the existing model. */
+    model(name, schema, options) {
+        const existing = this.constructors.get(name);
+        if (existing) {
+            if (schema && existing.schema !== schema) {
+                throw new AnchorConfigError(`Model "${name}" is already registered with a different schema. ` +
+                    `Call db.model("${name}") without a schema to retrieve it.`);
+            }
+            return existing;
+        }
+        if (!schema) {
+            throw new AnchorConfigError(`Model "${name}" has not been registered. Pass a schema: db.model("${name}", schema).`);
+        }
+        const model = new Model(name, schema, this.runtime(), options);
+        const ctor = createModelConstructor(model);
+        // Queries return Documents unless .lean(); the factory closes the loop without Model
+        // importing Document (which would be circular).
+        model._setDocumentFactory((doc) => ctor.hydrate(doc));
+        this.models.set(name, model);
+        this.constructors.set(name, ctor);
+        return ctor;
+    }
+    /**
+     * Schema-less access, matching the driver's `db.collection("users")`. Useful for scratch work and
+     * for Lens, which must browse collections whose schema it does not have.
+     */
+    collection(name) {
+        const key = `__collection__${name}`;
+        const existing = this.constructors.get(key);
+        if (existing)
+            return existing;
+        const schema = new Schema({}, { strict: false, timestamps: this.config.timestamps ?? true });
+        const model = new Model(key, schema, this.runtime(), { collection: name });
+        const ctor = createModelConstructor(model);
+        model._setDocumentFactory((doc) => ctor.hydrate(doc));
+        this.models.set(key, model);
+        this.constructors.set(key, ctor);
+        return ctor;
+    }
+    /**
+     * The model registered for a storage collection, if any.
+     *
+     * Interop needs it: storage holds ObjectIds and Dates as strings, so an export has to consult the
+     * schema to restore their real types before encoding. Without this an export would emit bare
+     * strings and mongoimport would store String instead of ObjectId/Date.
+     */
+    modelForCollection(collection) {
+        for (const model of this.models.values()) {
+            if (model.collectionName === collection)
+                return model;
+        }
+        return undefined;
+    }
+    modelNames() {
+        return [...this.models.keys()].filter((n) => !n.startsWith("__collection__"));
+    }
+    async listCollections() {
+        await this.open();
+        return this.adapterInstance.listCollections();
+    }
+    async stats() {
+        await this.open();
+        const stats = await this.adapterInstance.stats();
+        return { ...stats, name: this.name, syncEnabled: this.syncEnabled };
+    }
+    /** Deletes all local data. Lens exposes this as an explicit developer action. */
+    async destroy() {
+        await this.open();
+        await this.adapterInstance.destroy();
+    }
+    // ---- events --------------------------------------------------------------
+    on(event, listener) {
+        return this.emitter.on(event, listener);
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+    }
+    once(event, listener) {
+        return this.emitter.once(event, listener);
+    }
+    get events() {
+        return this.emitter;
+    }
+    /** Used by the sync engine to install itself without AnchorDB importing it. */
+    _attachSync(hooks) {
+        this.mutationRecorder = hooks.recordMutations;
+        this.syncRunner = hooks.run;
+        this.pendingCounter = hooks.pending;
+        hooks.setStatus((status) => {
+            this.syncStatusValue = status;
+        });
+    }
+    runtime() {
+        this.runtimeCache ??= {
+            adapter: this.adapterInstance,
+            time: this.time,
+            clock: this.clockInstance,
+            events: this.emitter,
+            get syncEnabled() {
+                return false;
+            },
+            clientId: this.clientIdValue, // replaced below by a live getter
+            onMissingRef: this.config.onMissingRef ?? "null",
+            ready: () => this.open(),
+            getModelByCollection: (collection) => this.modelForCollection(collection),
+            getModel: (name) => {
+                const model = this.models.get(name);
+                if (!model) {
+                    throw new AnchorConfigError(`Model "${name}" is referenced by a populate() but has not been registered on this database.`);
+                }
+                return model;
+            },
+            recordMutations: async (collection, ops) => {
+                if (this.mutationRecorder)
+                    await this.mutationRecorder(collection, ops);
+            },
+        };
+        // Both must be live getters. `syncEnabled` because the sync engine may attach after models are
+        // created; `clientId` because open() may replace it with the persisted identity.
+        Object.defineProperty(this.runtimeCache, "syncEnabled", {
+            get: () => this.syncEnabled,
+            configurable: true,
+        });
+        Object.defineProperty(this.runtimeCache, "clientId", {
+            get: () => this.clientIdValue,
+            configurable: true,
+        });
+        return this.runtimeCache;
+    }
+    /**
+     * The inspector exposes application data, so enabling it in production requires an explicit,
+     * separate acknowledgement — a config typo must never open a database over the network.
+     */
+    assertInspectorSafe(inspector) {
+        const env = globalThis.process?.env?.NODE_ENV ?? "development";
+        if (env === "production" && !inspector.allowInProduction) {
+            throw new AnchorConfigError("The Anchor Inspector is enabled while NODE_ENV=production. It exposes your local database to " +
+                "Anchor Lens and must not ship in a release build. If this is deliberate (an internal build, " +
+                "say), set inspector.allowInProduction: true to acknowledge it.");
+        }
+        // eslint-disable-next-line no-console
+        console.warn(`[anchor] Inspector ENABLED for database "${this.name}". Your local data is reachable by Anchor Lens. ` +
+            `Disable it before shipping.`);
+    }
+}
+function encodeClock(clock) {
+    const peek = clock.peek();
+    return `${String(peek.wall).padStart(15, "0")}-${String(peek.counter).padStart(5, "0")}-${peek.node}`;
+}
+/** Alias matching the brief's original naming. */
+export const LocalDB = AnchorDB;
+//# sourceMappingURL=anchor-db.js.map

package/dist/esm/core/anchor-db.js.map

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

package/dist/esm/core/errors.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 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.
+ */
+/** Base class for every error AnchorDB raises. Mirrors Mongoose's `MongooseError`. */
+export declare class AnchorError extends Error {
+    readonly name: string;
+    constructor(message: string);
+}
+/** Configuration rejected at construction time (bad timezone, unknown adapter, ...). */
+export declare class AnchorConfigError extends AnchorError {
+    readonly name = "AnchorConfigError";
+}
+/**
+ * A single failed validator on one path. Mongoose calls this `ValidatorError` and nests instances
+ * inside `ValidationError.errors`.
+ */
+export declare class ValidatorError extends AnchorError {
+    readonly name = "ValidatorError";
+    readonly path: string;
+    readonly value: unknown;
+    /** Which validator failed: `required`, `min`, `enum`, `user defined`, ... */
+    readonly kind: string;
+    readonly properties: Record<string, unknown>;
+    constructor(opts: {
+        path: string;
+        value: unknown;
+        kind: string;
+        message: string;
+        [k: string]: unknown;
+    });
+}
+/**
+ * Failure converting a value to its declared type. Message format matches Mongoose so that
+ * log-scraping and error reporting behave identically.
+ */
+export declare class CastError extends AnchorError {
+    readonly name = "CastError";
+    readonly stringValue: string;
+    readonly kind: string;
+    readonly value: unknown;
+    readonly path: string;
+    readonly valueType: string;
+    constructor(kind: string, value: unknown, path: string, reason?: string);
+}
+/** Aggregate of every path that failed validation for one document. */
+export declare class ValidationError extends AnchorError {
+    readonly name = "ValidationError";
+    readonly errors: Record<string, ValidatorError | CastError>;
+    constructor(modelName?: string);
+    readonly modelName: string | undefined;
+    addError(path: string, error: ValidatorError | CastError): void;
+    get isEmpty(): boolean;
+    private buildMessage;
+}
+/** Raised by `orFail()` and by Lens edits targeting a document that vanished. */
+export declare class DocumentNotFoundError extends AnchorError {
+    readonly name = "DocumentNotFoundError";
+    readonly filter: unknown;
+    constructor(filter: unknown, modelName?: string);
+}
+/** Writing a path not present in the schema while `strict: "throw"` is set. */
+export declare class StrictModeError extends AnchorError {
+    readonly name = "StrictModeError";
+    readonly path: string;
+    constructor(path: string);
+}
+/**
+ * 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.
+ */
+export declare class MongoServerError extends AnchorError {
+    readonly name = "MongoServerError";
+    readonly code: number;
+    readonly keyPattern: Record<string, 1 | -1> | undefined;
+    readonly keyValue: Record<string, unknown> | undefined;
+    readonly index: string | undefined;
+    constructor(opts: {
+        message: string;
+        code: number;
+        keyPattern?: Record<string, 1 | -1>;
+        keyValue?: Record<string, unknown>;
+        index?: string;
+    });
+}
+export declare const 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.
+ */
+export declare function duplicateKeyError(opts: {
+    dbName: string;
+    collection: string;
+    index: string;
+    keyPattern: Record<string, 1 | -1>;
+    keyValue: Record<string, unknown>;
+}): MongoServerError;
+/** Reported by `insertMany({ ordered: false })` after every insert has been attempted. */
+export declare class BulkWriteError extends AnchorError {
+    readonly name = "MongoBulkWriteError";
+    readonly code = 11000;
+    readonly writeErrors: Array<{
+        index: number;
+        code: number;
+        errmsg: string;
+        err: Error;
+    }>;
+    readonly insertedCount: number;
+    readonly insertedIds: Record<number, unknown>;
+    constructor(opts: {
+        writeErrors: Array<{
+            index: number;
+            code: number;
+            errmsg: string;
+            err: Error;
+        }>;
+        insertedCount: number;
+        insertedIds: Record<number, unknown>;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

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

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

package/dist/esm/core/errors.js

@@ -0,0 +1,161 @@
+/**
+ * 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.
+ */
+/** Base class for every error AnchorDB raises. Mirrors Mongoose's `MongooseError`. */
+export class AnchorError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AnchorError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Configuration rejected at construction time (bad timezone, unknown adapter, ...). */
+export class AnchorConfigError extends AnchorError {
+    constructor() {
+        super(...arguments);
+        this.name = "AnchorConfigError";
+    }
+}
+/**
+ * A single failed validator on one path. Mongoose calls this `ValidatorError` and nests instances
+ * inside `ValidationError.errors`.
+ */
+export 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 };
+    }
+}
+/**
+ * Failure converting a value to its declared type. Message format matches Mongoose so that
+ * log-scraping and error reporting behave identically.
+ */
+export 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);
+    }
+}
+/** Aggregate of every path that failed validation for one document. */
+export 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(", ")}`;
+    }
+}
+/** Raised by `orFail()` and by Lens edits targeting a document that vanished. */
+export 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;
+    }
+}
+/** Writing a path not present in the schema while `strict: "throw"` is set. */
+export 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;
+    }
+}
+/**
+ * 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.
+ */
+export 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;
+    }
+}
+export const 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.
+ */
+export 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: DUPLICATE_KEY_CODE,
+        keyPattern: opts.keyPattern,
+        keyValue: opts.keyValue,
+        index: opts.index,
+    });
+}
+/** Reported by `insertMany({ ordered: false })` after every insert has been attempted. */
+export class BulkWriteError extends AnchorError {
+    constructor(opts) {
+        super(`Bulk write failed with ${opts.writeErrors.length} error(s)`);
+        this.name = "MongoBulkWriteError";
+        this.code = DUPLICATE_KEY_CODE;
+        this.writeErrors = opts.writeErrors;
+        this.insertedCount = opts.insertedCount;
+        this.insertedIds = opts.insertedIds;
+    }
+}
+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/esm/core/errors.js.map

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

package/dist/esm/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/esm/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/esm/core/hex.js

@@ -0,0 +1,37 @@
+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;
+})();
+export 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. */
+export 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/esm/core/hex.js.map

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