@c9up/atlas 0.1.3 → 0.1.4

package/dist/AtlasProvider.d.ts

@@ -0,0 +1,106 @@
+/**
+ * AtlasProvider — Ream provider for the Atlas ORM.
+ *
+ * Connects to one or more databases via the Rust ream-db driver
+ * (SQLite/PostgreSQL/MySQL). Runs migrations on boot for the default
+ * connection.
+ *
+ * Multi-connection support (story 32.9):
+ *
+ *     // config/database.ts
+ *     export default {
+ *       default: 'primary',
+ *       connections: {
+ *         primary: { url: 'postgres://.../primary' },
+ *         tenant1: { url: 'postgres://.../tenant1' },
+ *       },
+ *     }
+ *
+ *     // Code
+ *     const primary = app.container.resolve('db')              // default
+ *     const tenant1 = app.container.resolve('db:tenant1')     // named
+ */
+/**
+ * Structural slice of the host framework's app context — only the surface
+ * AtlasProvider actually uses. Declared locally so atlas does NOT import
+ * `@c9up/ream`; any framework whose context exposes a `config.get(key)`
+ * reader and a `container.singleton(token, factory)` binder satisfies this
+ * contract via TypeScript structural compatibility.
+ *
+ * The `token` type mirrors ream's `ServiceToken` union (`string | symbol |
+ * ctor`) so AtlasProvider can grow into class-as-token / Symbol-keyed
+ * bindings without re-coupling to `@c9up/ream`. AtlasProvider itself only
+ * uses `string` tokens today.
+ */
+export interface AtlasAppContext {
+    container: {
+        singleton(token: string | symbol | (new (...args: never[]) => unknown), factory: () => unknown): void;
+    };
+    config: {
+        get<T = unknown>(key: string): T | undefined;
+    };
+}
+/**
+ * Canonical sqlite production pragma recipe.
+ *
+ *   journal_mode = WAL        // writes go to a side-log, readers don't block
+ *   synchronous  = NORMAL     // one fsync per commit (on the WAL); recovery
+ *                             // still rebuilds a consistent DB after crash
+ *
+ * Drops INSERT latency by ~5–10x vs sqlite's default
+ * (`journal_mode=delete` + `synchronous=FULL`) without sacrificing
+ * durability. Spread the constant into `pragmas` so app-specific overrides
+ * stay literal:
+ *
+ *   pragmas: { ...SQLITE_PROD_PRAGMAS, foreign_keys: "ON" }
+ */
+export declare const SQLITE_PROD_PRAGMAS: Readonly<{
+    readonly journal_mode: "WAL";
+    readonly synchronous: "NORMAL";
+}>;
+/** One connection's settings. */
+export interface ConnectionConfig {
+    /** Connection URL: "sqlite:data/app.db", "postgres://...", "mysql://..." */
+    url: string;
+    /** Minimum pool connections (default: 1) */
+    poolMin?: number;
+    /** Maximum pool connections (default: 10) */
+    poolMax?: number;
+    /**
+     * Connection-level pragmas (sqlite only). Each entry becomes a
+     * `PRAGMA <key> = <value>;` issued before the first query.
+     *
+     * Most apps want `{ journal_mode: "WAL", synchronous: "NORMAL" }` —
+     * disk-backed, durable, and ~5–10x faster than the default
+     * `journal_mode=delete` + `synchronous=FULL` (two fsyncs per
+     * commit). Ignored for postgres / mysql URLs.
+     */
+    pragmas?: Record<string, string | number>;
+}
+/** Full database config — single-connection (legacy) OR multi-connection. */
+export interface AtlasDatabaseConfig extends ConnectionConfig {
+    /** Name of the default connection when `connections` is set. Defaults to `"primary"`. */
+    default?: string;
+    /** Named connections. When present, top-level `url` is treated as `connections[default].url`. */
+    connections?: Record<string, ConnectionConfig>;
+    migrations?: {
+        path?: string;
+        /**
+         * Custom name for the migrations tracking table. Defaults to `"_migrations"`.
+         * Must match `/^[A-Za-z_][A-Za-z0-9_]*$/` — the `MigrationRunner` constructor
+         * throws `AtlasError("MIGRATION_INVALID_TABLE_NAME")` otherwise.
+         */
+        table?: string;
+    };
+}
+export default class AtlasProvider {
+    #private;
+    protected app: AtlasAppContext;
+    constructor(app: AtlasAppContext);
+    register(): void;
+    boot(): Promise<void>;
+    shutdown(): Promise<void>;
+    start(): Promise<void>;
+    ready(): Promise<void>;
+}
+//# sourceMappingURL=AtlasProvider.d.ts.map

package/dist/AtlasProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AtlasProvider.d.ts","sourceRoot":"","sources":["../src/AtlasProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAaH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE;QACV,SAAS,CACR,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,EAC5D,OAAO,EAAE,MAAM,OAAO,GACpB,IAAI,CAAC;KACR,CAAC;IACF,MAAM,EAAE;QAAE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;CACzD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB;;;EAGrB,CAAC;AAEZ,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAChC,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC5D,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC/C,UAAU,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACF;AAED,MAAM,CAAC,OAAO,OAAO,aAAa;;IAKrB,SAAS,CAAC,GAAG,EAAE,eAAe;gBAApB,GAAG,EAAE,eAAe;IAE1C,QAAQ;IAEF,IAAI;IAyFJ,QAAQ;IA6BR,KAAK;IACL,KAAK;CAwDX"}

package/dist/AtlasProvider.js

@@ -0,0 +1,190 @@
+/**
+ * AtlasProvider — Ream provider for the Atlas ORM.
+ *
+ * Connects to one or more databases via the Rust ream-db driver
+ * (SQLite/PostgreSQL/MySQL). Runs migrations on boot for the default
+ * connection.
+ *
+ * Multi-connection support (story 32.9):
+ *
+ *     // config/database.ts
+ *     export default {
+ *       default: 'primary',
+ *       connections: {
+ *         primary: { url: 'postgres://.../primary' },
+ *         tenant1: { url: 'postgres://.../tenant1' },
+ *       },
+ *     }
+ *
+ *     // Code
+ *     const primary = app.container.resolve('db')              // default
+ *     const tenant1 = app.container.resolve('db:tenant1')     // named
+ */
+import { createNapiConnection, } from "./adapters/NapiDbAdapter.js";
+import { setAtlasDialect } from "./query/native.js";
+import { MigrationRunner, } from "./schema/MigrationRunner.js";
+import { dialectFromUrl } from "./utils/dialectFromUrl.js";
+/**
+ * Canonical sqlite production pragma recipe.
+ *
+ *   journal_mode = WAL        // writes go to a side-log, readers don't block
+ *   synchronous  = NORMAL     // one fsync per commit (on the WAL); recovery
+ *                             // still rebuilds a consistent DB after crash
+ *
+ * Drops INSERT latency by ~5–10x vs sqlite's default
+ * (`journal_mode=delete` + `synchronous=FULL`) without sacrificing
+ * durability. Spread the constant into `pragmas` so app-specific overrides
+ * stay literal:
+ *
+ *   pragmas: { ...SQLITE_PROD_PRAGMAS, foreign_keys: "ON" }
+ */
+export const SQLITE_PROD_PRAGMAS = Object.freeze({
+    journal_mode: "WAL",
+    synchronous: "NORMAL",
+});
+export default class AtlasProvider {
+    app;
+    /** Map of connection name → open connection. Populated at boot. */
+    #connections = new Map();
+    #defaultName = "primary";
+    constructor(app) {
+        this.app = app;
+    }
+    register() { }
+    async boot() {
+        const config = this.app.config.get("database");
+        if (!config)
+            return;
+        // Normalize: if `connections` is not set, build a single-entry map from top-level config.
+        const { connections, defaultName } = this.#resolveConnections(config);
+        this.#defaultName = defaultName;
+        // Open every connection in parallel — multi-database apps with slow-to-
+        // handshake drivers (Postgres over TLS, RDS proxies) previously paid the
+        // sum of the round-trip times on boot; now it's the max.
+        //
+        // `Promise.allSettled` lets us distinguish successes from failures without
+        // losing the already-opened connections. If any connection rejected, we
+        // close every successful one before rethrowing so a partial boot never
+        // leaks pools/sockets.
+        const entries = Object.entries(connections);
+        const results = await Promise.allSettled(entries.map(([, settings]) => createNapiConnection(settings.url, settings.poolMin ?? 1, settings.poolMax ?? 10, settings.pragmas)));
+        const failures = [];
+        const successes = [];
+        results.forEach((r, i) => {
+            const [name] = entries[i];
+            if (r.status === "fulfilled")
+                successes.push({ name, conn: r.value });
+            else
+                failures.push({ name, error: r.reason });
+        });
+        if (failures.length > 0) {
+            // Tear down the successes so we don't leak any pool that the runtime
+            // has already opened. Closures run in parallel with allSettled so a
+            // stuck close doesn't block the rollback path.
+            await Promise.allSettled(successes.map((s) => s.conn.close()));
+            const first = failures[0];
+            const others = failures
+                .slice(1)
+                .map((f) => `${f.name}: ${String(f.error)}`)
+                .join("; ");
+            throw new Error(`AtlasProvider: failed to open ${failures.length} connection(s) — ` +
+                `'${first.name}' failed: ${String(first.error)}` +
+                (others ? ` (also: ${others})` : ""));
+        }
+        for (const { name, conn } of successes) {
+            this.#connections.set(name, conn);
+            this.app.container.singleton(`db:${name}`, () => conn);
+        }
+        // Expose the default under the short aliases `db` and `db.connection`.
+        const defaultConn = this.#connections.get(defaultName);
+        if (!defaultConn) {
+            throw new Error(`AtlasProvider: default connection '${defaultName}' is not defined in config.database.connections`);
+        }
+        this.app.container.singleton("db", () => defaultConn);
+        this.app.container.singleton("db.connection", () => defaultConn);
+        // Populate the `@c9up/atlas/services/db` proxy so apps can
+        // `import db from '@c9up/atlas/services/db'` from anywhere.
+        // Done inside the lazy-import to avoid pulling the services
+        // module at construction time when the provider is type-imported
+        // by `@c9up/ream`'s discovery scan.
+        const { setDb } = await import("./services/db.js");
+        setDb(defaultConn);
+        // The dialect set module-wide is the DEFAULT connection's dialect.
+        // Per-connection dialect (when a user hits a non-default) is read from
+        // the connection URL at query time by each call site that cares.
+        setAtlasDialect(dialectFromUrl(connections[defaultName]?.url));
+        if (config.migrations?.path) {
+            await this.#runMigrations(config.migrations.path, connections[defaultName]?.url, defaultConn, config.migrations.table);
+        }
+    }
+    async shutdown() {
+        // Close every connection in parallel — same reasoning as boot. We use
+        // `allSettled` so a single driver failing to close doesn't prevent the
+        // rest from shutting down, BUT we surface the failures afterwards:
+        //
+        //   - the map is cleared unconditionally (the process is shutting down
+        //     and we don't want to hand out closed handles)
+        //   - any rejection is aggregated into a single `AggregateError` thrown
+        //     at the end so supervisors / health-checks see a non-zero exit
+        //     signal instead of a silent "everything is fine" shutdown
+        const named = [...this.#connections.entries()];
+        const results = await Promise.allSettled(named.map(([, c]) => c.close()));
+        this.#connections.clear();
+        const errors = results
+            .map((r, i) => r.status === "rejected" ? { name: named[i][0], error: r.reason } : null)
+            .filter((x) => x !== null);
+        if (errors.length > 0) {
+            const summary = errors
+                .map((e) => `'${e.name}': ${String(e.error)}`)
+                .join("; ");
+            throw new AggregateError(errors.map((e) => e.error), `AtlasProvider: ${errors.length} connection(s) failed to close — ${summary}`);
+        }
+    }
+    async start() { }
+    async ready() { }
+    /** Normalize the config into a `{ name → ConnectionConfig }` map + default name. */
+    #resolveConnections(config) {
+        if (config.connections && Object.keys(config.connections).length > 0) {
+            return {
+                connections: config.connections,
+                defaultName: config.default ?? "primary",
+            };
+        }
+        // Legacy single-connection shape — promote to multi-connection under "primary".
+        return {
+            connections: {
+                primary: {
+                    url: config.url,
+                    poolMin: config.poolMin,
+                    poolMax: config.poolMax,
+                    pragmas: config.pragmas,
+                },
+            },
+            defaultName: "primary",
+        };
+    }
+    async #runMigrations(migrationsPath, url, db, tableName) {
+        const { existsSync } = await import("node:fs");
+        if (!existsSync(migrationsPath))
+            return;
+        const adapter = {
+            execute: async (sql, params) => {
+                await db.execute(sql, params);
+            },
+            query: (sql, params) => db.query(sql, params),
+            close: () => db.close(),
+            // Thread the transactional path through so MigrationRunner takes the
+            // atomic branch (a mid-migration failure rolls back both the SQL and the
+            // `_migrations` bookkeeping row together). Without this, the runner
+            // silently falls back to non-transactional execution.
+            runInTransaction: async (batch) => db.runInTransaction(batch),
+        };
+        const runner = new MigrationRunner(adapter, {
+            migrationsDir: migrationsPath,
+            dialect: dialectFromUrl(url),
+            tableName,
+        });
+        await runner.migrate();
+    }
+}
+//# sourceMappingURL=AtlasProvider.js.map

package/dist/AtlasProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AtlasProvider.js","sourceRoot":"","sources":["../src/AtlasProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAEN,oBAAoB,GACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEN,eAAe,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAwB3D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,QAAQ;CACZ,CAAC,CAAC;AAuCZ,MAAM,CAAC,OAAO,OAAO,aAAa;IAKX;IAJtB,mEAAmE;IACnE,YAAY,GAAG,IAAI,GAAG,EAAmC,CAAC;IAC1D,YAAY,GAAG,SAAS,CAAC;IAEzB,YAAsB,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAE9C,QAAQ,KAAI,CAAC;IAEb,KAAK,CAAC,IAAI;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAsB,UAAU,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,0FAA0F;QAC1F,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACtE,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAEhC,wEAAwE;QACxE,yEAAyE;QACzE,yDAAyD;QACzD,EAAE;QACF,2EAA2E;QAC3E,wEAAwE;QACxE,uEAAuE;QACvE,uBAAuB;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACvC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAC5B,oBAAoB,CACnB,QAAQ,CAAC,GAAG,EACZ,QAAQ,CAAC,OAAO,IAAI,CAAC,EACrB,QAAQ,CAAC,OAAO,IAAI,EAAE,EACtB,QAAQ,CAAC,OAAO,CAChB,CACD,CACD,CAAC;QACF,MAAM,QAAQ,GAA4C,EAAE,CAAC;QAC7D,MAAM,SAAS,GACd,EAAE,CAAC;QACJ,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxB,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;gBAAE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;;gBACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,qEAAqE;YACrE,oEAAoE;YACpE,+CAA+C;YAC/C,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,QAAQ;iBACrB,KAAK,CAAC,CAAC,CAAC;iBACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;iBAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,IAAI,KAAK,CACd,iCAAiC,QAAQ,CAAC,MAAM,mBAAmB;gBAClE,IAAI,KAAK,CAAC,IAAI,aAAa,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;gBAChD,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACrC,CAAC;QACH,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,uEAAuE;QACvE,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACd,sCAAsC,WAAW,iDAAiD,CAClG,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;QAEjE,2DAA2D;QAC3D,4DAA4D;QAC5D,4DAA4D;QAC5D,iEAAiE;QACjE,oCAAoC;QACpC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACnD,KAAK,CAAC,WAAW,CAAC,CAAC;QAEnB,mEAAmE;QACnE,uEAAuE;QACvE,iEAAiE;QACjE,eAAe,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAE/D,IAAI,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,cAAc,CACxB,MAAM,CAAC,UAAU,CAAC,IAAI,EACtB,WAAW,CAAC,WAAW,CAAC,EAAE,GAAG,EAC7B,WAAW,EACX,MAAM,CAAC,UAAU,CAAC,KAAK,CACvB,CAAC;QACH,CAAC;IACF,CAAC;IAED,KAAK,CAAC,QAAQ;QACb,sEAAsE;QACtE,uEAAuE;QACvE,mEAAmE;QACnE,EAAE;QACF,uEAAuE;QACvE,oDAAoD;QACpD,wEAAwE;QACxE,oEAAoE;QACpE,+DAA+D;QAC/D,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACb,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CACvE;aACA,MAAM,CAAC,CAAC,CAAC,EAAyC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACnE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,MAAM;iBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;iBAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,IAAI,cAAc,CACvB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAC1B,kBAAkB,MAAM,CAAC,MAAM,oCAAoC,OAAO,EAAE,CAC5E,CAAC;QACH,CAAC;IACF,CAAC;IAED,KAAK,CAAC,KAAK,KAAI,CAAC;IAChB,KAAK,CAAC,KAAK,KAAI,CAAC;IAEhB,oFAAoF;IACpF,mBAAmB,CAAC,MAA2B;QAI9C,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtE,OAAO;gBACN,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS;aACxC,CAAC;QACH,CAAC;QACD,gFAAgF;QAChF,OAAO;YACN,WAAW,EAAE;gBACZ,OAAO,EAAE;oBACR,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;iBACvB;aACD;YACD,WAAW,EAAE,SAAS;SACtB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CACnB,cAAsB,EACtB,GAAW,EACX,EAA2B,EAC3B,SAA6B;QAE7B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,OAAO;QAExC,MAAM,OAAO,GAAoB;YAChC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;gBAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC/B,CAAC;YACD,KAAK,EAAE,CAAI,GAAW,EAAE,MAAkB,EAAE,EAAE,CAC7C,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAiB;YACtC,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE;YACvB,qEAAqE;YACrE,yEAAyE;YACzE,oEAAoE;YACpE,sDAAsD;YACtD,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC;SAC7D,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE;YAC3C,aAAa,EAAE,cAAc;YAC7B,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC;YAC5B,SAAS;SACT,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACD"}

package/dist/BaseEntity.d.ts

@@ -0,0 +1,255 @@
+/**
+ * BaseEntity — base class for all Atlas entities.
+ *
+ * Provides:
+ * - Domain event accumulation (flushed post-commit through the event bus)
+ * - `$extras` bag for ad-hoc / computed columns (32.5)
+ * - `$original` snapshot + `$dirty` diff tracking (32.2)
+ * - Serialization layer hooks (`hidden` / `visible` / `@column` serializeAs) (32.4)
+ * - Computed-property collection (32.3)
+ *
+ * @implements FR29, FR35, stories 32.1 through 32.5
+ */
+export interface DomainEvent {
+    name: string;
+    data: Record<string, unknown>;
+}
+/** Symbol metadata key for the computed-property registry on an entity class. */
+export declare const COMPUTED_KEY: unique symbol;
+/** Symbol metadata key for the serialize-as / serializer overrides on columns. */
+export declare const COLUMN_SERIALIZE_KEY: unique symbol;
+/** Symbol property key used by entities to back-reference their hydrating repo. */
+export declare const REPO_REF: unique symbol;
+/** Minimal repo-back-reference interface used by `entity.refresh()` / `entity.fresh()` / `entity.loadCount()`. */
+export interface EntityRepoRef {
+    refresh(entity: BaseEntity): Promise<void>;
+    fresh(entity: BaseEntity): Promise<BaseEntity>;
+    loadCount(entity: BaseEntity, relationName: string, alias?: string): Promise<void>;
+    loadAggregate(entity: BaseEntity, relationName: string, build: (q: unknown) => void): Promise<void>;
+    /** Lazy-load a relation onto `entity` — Story 31.10. */
+    loadRelation(entity: BaseEntity, relationName: string, callback?: (q: unknown) => void): Promise<void>;
+    /** Build a related-entity proxy for fluent create/save + pivot ops — Stories 31.5–31.9. */
+    relatedProxy(entity: BaseEntity, relationName: string): RelationProxy;
+}
+interface BaseRelationProxy {
+    create(data: Record<string, unknown>): Promise<BaseEntity>;
+    save(related: BaseEntity): Promise<void>;
+    /** Scoped query builder over the related table (Story 31.9). */
+    query(): unknown;
+}
+interface BulkRelationProxy extends BaseRelationProxy {
+    createMany(rows: Array<Record<string, unknown>>): Promise<BaseEntity[]>;
+    saveMany(related: BaseEntity[]): Promise<BaseEntity[]>;
+}
+/** `@HasOne` — single related row. `createMany`/`saveMany` are intentionally absent. */
+export interface HasOneRelationProxy extends BaseRelationProxy {
+    readonly type: "hasOne";
+    /** Throws with a clear "not supported on @HasOne" — exposed as a typed no-op for symmetry. */
+    createMany(rows: Array<Record<string, unknown>>): Promise<never>;
+    saveMany(related: BaseEntity[]): Promise<never>;
+}
+/** `@HasMany` — zero or more related rows with bulk write support. */
+export interface HasManyRelationProxy extends BulkRelationProxy {
+    readonly type: "hasMany";
+}
+/** `@BelongsTo` — set/clear the FK via `associate`/`dissociate`. */
+export interface BelongsToRelationProxy extends BulkRelationProxy {
+    readonly type: "belongsTo";
+    /** Set `parent.<fk> = model.<ownerKey>` and save the parent. Rejects null/undefined. */
+    associate(model: BaseEntity): Promise<void>;
+    /** Clear the FK and save the parent. */
+    dissociate(): Promise<void>;
+}
+/** `@ManyToMany` — full Lucid pivot API. */
+export interface ManyToManyRelationProxy extends BulkRelationProxy {
+    readonly type: "manyToMany";
+    /** Insert pivot rows. Accepts `id[]` or `{ id: extras }`. */
+    attach(ids: Array<string | number> | Record<string, Record<string, unknown>>): Promise<void>;
+    /** Delete pivot rows. No args = delete all for this parent. */
+    detach(ids?: Array<string | number>): Promise<void>;
+    /**
+     * Diff-compute the target set. `additive=false` (default) removes orphans;
+     * `additive=true` only inserts, never deletes.
+     */
+    sync(target: Array<string | number> | Record<string, Record<string, unknown>>, additive?: boolean): Promise<void>;
+}
+export type RelationProxy = HasOneRelationProxy | HasManyRelationProxy | BelongsToRelationProxy | ManyToManyRelationProxy;
+/** Per-column serialization config (populated by @Column options). */
+export interface ColumnSerializeConfig {
+    /** Rename this column at toJSON time (e.g. `password` → `passwordHash`). Null = hidden. */
+    serializeAs?: string | null;
+    /** Transform function applied to the value at toJSON time. */
+    serialize?: (value: unknown) => unknown;
+}
+export declare class BaseEntity {
+    #private;
+    /** Index signature — entities have dynamic column properties set by hydrate/create. */
+    [key: string]: unknown;
+    /**
+     * `$extras` — bag for ad-hoc/computed values that are NOT declared as `@Column`.
+     * Used by `withCount`, pivot extras, and aggregate loaders. Kept separate from
+     * real columns so persistence (`#entityToRow`) never tries to write them back.
+     *
+     * @implements Story 32.5
+     */
+    $extras: Record<string, unknown>;
+    /**
+     * Snapshot of the column values at the moment this entity was hydrated from
+     * the database. Used by dirty tracking (`isDirty`, `$dirty`). Populated by
+     * `BaseRepository.#hydrate` via `markAsPersisted` below; empty for entities
+     * built in memory with `new MyEntity()`.
+     *
+     * @implements Story 32.2
+     */
+    $original: Record<string, unknown>;
+    /** Set a property dynamically (used by hydrate/create). */
+    setProp(key: string, value: unknown): void;
+    /** Set an `$extras` value (used by `withCount`, pivot extras, aggregate loaders). */
+    setExtra(key: string, value: unknown): void;
+    /** Get an `$extras` value with optional default. */
+    getExtra<T = unknown>(key: string, defaultValue?: T): T | undefined;
+    /**
+     * Freeze the current column values as the "persisted" snapshot. Called by
+     * `BaseRepository.#hydrate` after a SELECT and by `save()` after INSERT/UPDATE
+     * succeeds. From now on, `isDirty()` compares against this snapshot.
+     */
+    /**
+     * Freeze the current column values as the persisted snapshot. Atlas uses
+     * **reference-based dirty tracking**: `$original` holds the SAME reference
+     * the hydrator produced, not a deep clone. A column is dirty iff
+     * `Object.is(current, original) === false`.
+     *
+     * **Contract (important)**: to mark an object/array column dirty, the user
+     * MUST reassign it — in-place mutation is undetectable by design:
+     *
+     *     entity.settings = { ...entity.settings, theme: 'dark' }  // ✅ dirty
+     *     entity.settings.theme = 'dark'                           // ❌ NOT detected
+     *
+     * This matches Lucid's contract and gives us O(1) dirty checks + zero
+     * allocations on hydrate. The alternative (deep-equal with cloned snapshot)
+     * was correct but allocated a full copy of every column on every load and
+     * traversed nested JSON on every `save()` — unacceptable for hot paths.
+     *
+     * Rollback can only restore reassigned columns; in-place mutations are
+     * unrecoverable because the snapshot is the same reference as the current
+     * value. Use immutable update patterns if you rely on rollback.
+     *
+     * @implements Story 32.2
+     */
+    markAsPersisted(): void;
+    /**
+     * Compute the set of columns whose current value differs from `$original`.
+     * Called on demand by `save()` (to emit UPDATEs that only touch dirty cols)
+     * and by lifecycle hooks (e.g. `beforeSave` only rehashes password if dirty).
+     *
+     * @implements Story 32.2
+     */
+    get $dirty(): Record<string, unknown>;
+    /**
+     * Check whether a specific column is dirty, or whether any column is dirty
+     * when called without arguments.
+     */
+    isDirty(field?: string): boolean;
+    /**
+     * Revert all dirty columns back to their `$original` values.
+     *
+     * Because dirty tracking is reference-based, `rollback` only restores
+     * reassigned columns to their persisted reference. In-place mutations on
+     * object/array columns are NOT recoverable — the snapshot holds the same
+     * reference the user mutated. If you rely on rollback, use immutable
+     * update patterns (`entity.field = { ...entity.field, x: y }`).
+     */
+    rollback(): void;
+    /**
+     * Repository back-pointer set by `BaseRepository.#hydrate` so instances can
+     * self-refresh / lazy-load. Not serialized (symbol key).
+     *
+     * @implements Story 32.6
+     */
+    [REPO_REF]?: EntityRepoRef;
+    /**
+     * Re-read this entity's row from the database and mutate THIS instance
+     * with the latest values. Throws if the row no longer exists.
+     */
+    refresh(): Promise<this>;
+    /**
+     * Re-read this entity's row from the database and return a NEW instance.
+     * `this` is NOT mutated. The returned object has the same runtime class
+     * because the repository that produced it is the same one we back-reference.
+     */
+    fresh(): Promise<BaseEntity>;
+    /**
+     * Lazy-load a relation count into `this.$extras[alias ?? `${relationName}_count`]`.
+     * Issues a single `SELECT COUNT(*) FROM related WHERE <fk> = ?` for this entity.
+     *
+     * @implements Story 29.2
+     */
+    loadCount(relationName: string, alias?: string): Promise<this>;
+    /**
+     * Lazy-load a relation aggregate. The builder callback must set the aggregate
+     * via `.sum('col')` / `.avg(...)` / `.min(...)` / `.max(...)` / `.count()` and
+     * an alias via `.as('name')`. The result lands on `this.$extras[alias]`.
+     *
+     *     await user.loadAggregate('posts', q => q.sum('views').as('total_views'))
+     *
+     * @implements Story 29.2
+     */
+    loadAggregate(relationName: string, build: (q: unknown) => void): Promise<this>;
+    /**
+     * Lazy-load a relation onto this entity after it was initially fetched.
+     *
+     * @implements Story 31.10
+     */
+    load(relationName: string, callback?: (q: unknown) => void): Promise<this>;
+    /**
+     * Return a relation proxy bound to this instance. The proxy exposes
+     * `create` / `createMany` / `save` / `saveMany` that auto-set the FK.
+     *
+     * @implements Story 31.5
+     */
+    related(relationName: string): ReturnType<EntityRepoRef["relatedProxy"]>;
+    /**
+     * Mass-assign columns from a plain payload. Only columns that are in the
+     * class's `static fillable` allowlist (or absent from `static guarded` when
+     * no fillable is declared) are assigned. Columns not in the payload are
+     * reset to undefined so the entity reflects exactly what was filled.
+     *
+     * @implements Story 30.7
+     */
+    fill(payload: Record<string, unknown>): this;
+    /**
+     * Patch the entity with a payload, only touching the provided keys. Same
+     * allowlist/blocklist rules as `fill` but preserves fields not present in
+     * the payload.
+     */
+    merge(payload: Record<string, unknown>): this;
+    /** Add a domain event to be dispatched after save. */
+    addDomainEvent(name: string, data: Record<string, unknown>): void;
+    /** Get accumulated domain events (non-destructive read). */
+    getDomainEvents(): readonly DomainEvent[];
+    /** Clear accumulated domain events. */
+    clearDomainEvents(): void;
+    /** Get and clear accumulated domain events atomically. */
+    flushDomainEvents(): DomainEvent[];
+    /** Check if entity has pending domain events. */
+    hasDomainEvents(): boolean;
+    /**
+     * Serialize to JSON — honors class-level `hidden`/`visible` allowlists,
+     * per-column `serializeAs` / `serialize` overrides, and `@computed` getters.
+     * `$extras` is merged on top so callers see `withCount` / pivot extras next
+     * to regular columns. `#private` fields are excluded automatically by ES.
+     *
+     * @implements Story 32.4
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Pick / limit the fields returned by `toJSON()` for a single call.
+     *
+     *     entity.serialize({ fields: ['id', 'title'] })
+     */
+    serialize(options?: {
+        fields?: readonly string[];
+    }): Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=BaseEntity.d.ts.map

package/dist/BaseEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseEntity.d.ts","sourceRoot":"","sources":["../src/BaseEntity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,iFAAiF;AACjF,eAAO,MAAM,YAAY,eAA+B,CAAC;AAEzD,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,eAAsC,CAAC;AAExE,mFAAmF;AACnF,eAAO,MAAM,QAAQ,eAA8B,CAAC;AAEpD,kHAAkH;AAClH,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,SAAS,CACR,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,CACZ,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,wDAAwD;IACxD,YAAY,CACX,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,2FAA2F;IAC3F,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,CAAC;CACtE;AAOD,UAAU,iBAAiB;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,gEAAgE;IAChE,KAAK,IAAI,OAAO,CAAC;CACjB;AAED,UAAU,iBAAkB,SAAQ,iBAAiB;IACpD,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxE,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACvD;AAED,wFAAwF;AACxF,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,8FAA8F;IAC9F,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CAChD;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC9D,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CACzB;AAED,oEAAoE;AACpE,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAChE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,wFAAwF;IACxF,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,wCAAwC;IACxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IACjE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,6DAA6D;IAC7D,MAAM,CACL,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACnE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,+DAA+D;IAC/D,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD;;;OAGG;IACH,IAAI,CACH,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxE,QAAQ,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GACtB,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,uBAAuB,CAAC;AAE3B,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACrC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACxC;AAQD,qBAAa,UAAU;;IACtB,uFAAuF;IACvF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAKvB;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAEtC;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAExC,2DAA2D;IAC3D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI1C,qFAAqF;IACrF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI3C,oDAAoD;IACpD,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAInE;;;;OAIG;IACH;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,eAAe,IAAI,IAAI;IASvB;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASpC;IAoBD;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAKhC;;;;;;;;OAQG;IACH,QAAQ,IAAI,IAAI;IAMhB;;;;;OAKG;IACH,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC;IAE3B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IASlC;;;;;OAKG;IACG,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpE;;;;;;;;OAQG;IACG,aAAa,CAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,GACzB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;OAIG;IACG,IAAI,CACT,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,GAC7B,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;OAKG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IASxE;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuC5C;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAwB7C,sDAAsD;IACtD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjE,4DAA4D;IAC5D,eAAe,IAAI,SAAS,WAAW,EAAE;IAIzC,uCAAuC;IACvC,iBAAiB,IAAI,IAAI;IAIzB,0DAA0D;IAC1D,iBAAiB,IAAI,WAAW,EAAE;IAMlC,iDAAiD;IACjD,eAAe,IAAI,OAAO;IAI1B;;;;;;;OAOG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAsCjC;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAS5E"}