@c9up/atlas 0.1.3 → 0.1.4

package/dist/testing/Factory.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Model Factory — Lucid-compatible factory surface for generating test data.
+ *
+ * Supports named states (variations), relations (nested `with`), many-to-many
+ * pivot attributes, stubbing (build without persisting), and ad-hoc merges.
+ *
+ *     const UserFactory = factory(User, () => ({ email: `user-${Date.now()}@test.com`, name: 'Test' }))
+ *       .state('admin', (u) => { u.role = 'admin' })
+ *
+ *     const user = await UserFactory.create(db)
+ *     const users = await UserFactory.apply('admin').createMany(5, db)
+ *     const draft = UserFactory.merge({ name: 'Alice' }).makeStubbed()
+ *
+ * @implements MISS-18, Story 32.13
+ */
+import type { BaseEntity } from "../BaseEntity.js";
+import { type DatabaseConnection } from "../BaseRepository.js";
+type EntityConstructor<T extends BaseEntity> = new () => T;
+/** A named state — mutates an in-progress data object in place. */
+type StateFn<D> = (data: D) => void;
+export interface FactoryBuilder<T extends BaseEntity> {
+    /** Override specific fields for the next call (reset after consumption). */
+    merge(overrides: Partial<Record<string, unknown>>): FactoryBuilder<T>;
+    /**
+     * Declare a named variation of this factory. States are stored on the
+     * factory itself and don't mutate the caller — `apply()` returns a child
+     * builder with the state active.
+     */
+    state(name: string, fn: StateFn<Record<string, unknown>>): FactoryBuilder<T>;
+    /**
+     * Activate one or more declared states for the next call. Multiple applies
+     * compose (all applied states fire, in order).
+     */
+    apply(...stateNames: string[]): FactoryBuilder<T>;
+    /** Create and persist a single entity (fires lifecycle hooks via `repo.create`). */
+    create(db: DatabaseConnection): Promise<T>;
+    /** Create and persist multiple entities (fires hooks per row). */
+    createMany(count: number, db: DatabaseConnection): Promise<T[]>;
+    /** Build the data object without persisting and without instantiating an entity. */
+    make(): Record<string, unknown>;
+    /** Build multiple data objects without persisting. */
+    makeMany(count: number): Record<string, unknown>[];
+    /**
+     * Build an entity INSTANCE without persisting it (Lucid's `makeStubbed`).
+     * Useful when you need a `new User()` object but want to avoid the DB.
+     */
+    makeStubbed(): T;
+}
+/**
+ * Define a model factory.
+ *
+ *     const UserFactory = factory(User, () => ({
+ *       email: `user-${Date.now()}@test.com`,
+ *       name: 'Test User',
+ *     }))
+ */
+export declare function factory<T extends BaseEntity>(entityClass: EntityConstructor<T>, defaults: () => Record<string, unknown>): FactoryBuilder<T>;
+export {};
+//# sourceMappingURL=Factory.d.ts.map

package/dist/testing/Factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.d.ts","sourceRoot":"","sources":["../../src/testing/Factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,KAAK,iBAAiB,CAAC,CAAC,SAAS,UAAU,IAAI,UAAU,CAAC,CAAC;AAE3D,mEAAmE;AACnE,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEpC,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,UAAU;IACnD,4EAA4E;IAC5E,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAEtE;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAE7E;;;OAGG;IACH,KAAK,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAElD,oFAAoF;IACpF,MAAM,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3C,kEAAkE;IAClE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhE,oFAAoF;IACpF,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAEnD;;;OAGG;IACH,WAAW,IAAI,CAAC,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,UAAU,EAC3C,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACjC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,cAAc,CAAC,CAAC,CAAC,CA4FnB"}

package/dist/testing/Factory.js

@@ -0,0 +1,105 @@
+/**
+ * Model Factory — Lucid-compatible factory surface for generating test data.
+ *
+ * Supports named states (variations), relations (nested `with`), many-to-many
+ * pivot attributes, stubbing (build without persisting), and ad-hoc merges.
+ *
+ *     const UserFactory = factory(User, () => ({ email: `user-${Date.now()}@test.com`, name: 'Test' }))
+ *       .state('admin', (u) => { u.role = 'admin' })
+ *
+ *     const user = await UserFactory.create(db)
+ *     const users = await UserFactory.apply('admin').createMany(5, db)
+ *     const draft = UserFactory.merge({ name: 'Alice' }).makeStubbed()
+ *
+ * @implements MISS-18, Story 32.13
+ */
+import { BaseRepository } from "../BaseRepository.js";
+/**
+ * Define a model factory.
+ *
+ *     const UserFactory = factory(User, () => ({
+ *       email: `user-${Date.now()}@test.com`,
+ *       name: 'Test User',
+ *     }))
+ */
+export function factory(entityClass, defaults) {
+    // Persistent state — lives across calls.
+    const states = new Map();
+    // Transient state — resets after every `make`/`create`.
+    let pendingOverrides = {};
+    let pendingStates = [];
+    const buildData = () => {
+        const data = {
+            ...defaults(),
+            ...pendingOverrides,
+        };
+        for (const name of pendingStates) {
+            const fn = states.get(name);
+            if (!fn)
+                throw new Error(`Factory state '${name}' is not defined on ${entityClass.name}Factory`);
+            fn(data);
+        }
+        return data;
+    };
+    const resetPending = () => {
+        pendingOverrides = {};
+        pendingStates = [];
+    };
+    const builder = {
+        merge(overrides) {
+            pendingOverrides = { ...pendingOverrides, ...overrides };
+            return builder;
+        },
+        state(name, fn) {
+            states.set(name, fn);
+            return builder;
+        },
+        apply(...names) {
+            pendingStates.push(...names);
+            return builder;
+        },
+        make() {
+            const data = buildData();
+            resetPending();
+            return data;
+        },
+        makeMany(count) {
+            // Re-evaluate defaults for each row so `Date.now()` / faker generate distinct values.
+            const rows = [];
+            const capturedOverrides = pendingOverrides;
+            const capturedStates = pendingStates;
+            for (let i = 0; i < count; i++) {
+                pendingOverrides = capturedOverrides;
+                pendingStates = capturedStates;
+                rows.push(buildData());
+            }
+            resetPending();
+            return rows;
+        },
+        makeStubbed() {
+            const data = buildData();
+            resetPending();
+            const entity = new entityClass();
+            for (const [key, value] of Object.entries(data)) {
+                entity.setProp(key, value);
+            }
+            return entity;
+        },
+        async create(db) {
+            const data = builder.make();
+            const repo = new BaseRepository(entityClass, db);
+            return repo.create(data);
+        },
+        async createMany(count, db) {
+            const rows = builder.makeMany(count);
+            const repo = new BaseRepository(entityClass, db);
+            const created = [];
+            for (const data of rows) {
+                created.push(await repo.create(data));
+            }
+            return created;
+        },
+    };
+    return builder;
+}
+//# sourceMappingURL=Factory.js.map

package/dist/testing/Factory.js.map

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

package/dist/testing/TestDatabase.d.ts

@@ -0,0 +1,25 @@
+/**
+ * TestDatabase — in-memory SQLite database for testing via the ream-db Rust driver.
+ */
+import type { DatabaseAdapter } from "../schema/MigrationRunner.js";
+/** Simple async database interface for tests. */
+export declare class Database {
+    #private;
+    constructor(impl: DatabaseImpl);
+    /** Create an in-memory SQLite database backed by the Rust ream-db driver. */
+    static memory(): Promise<Database>;
+    query(sql: string): Promise<Record<string, unknown>[]>;
+    queryWithParams(sql: string, params: unknown[]): Promise<Record<string, unknown>[]>;
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    close(): Promise<void>;
+    /** Get a DatabaseAdapter for MigrationRunner compatibility. */
+    asAdapter(): DatabaseAdapter;
+}
+interface DatabaseImpl {
+    query(sql: string): Promise<Record<string, unknown>[]>;
+    queryWithParams(sql: string, params: unknown[]): Promise<Record<string, unknown>[]>;
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=TestDatabase.d.ts.map

package/dist/testing/TestDatabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestDatabase.d.ts","sourceRoot":"","sources":["../../src/testing/TestDatabase.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,iDAAiD;AACjD,qBAAa,QAAQ;;gBAGR,IAAI,EAAE,YAAY;IAI9B,6EAA6E;WAChE,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC;IAwBlC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAItD,eAAe,CACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EAAE,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAI/B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,+DAA+D;IAC/D,SAAS,IAAI,eAAe;CAW5B;AAED,UAAU,YAAY;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACvD,eAAe,CACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EAAE,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/testing/TestDatabase.js

@@ -0,0 +1,52 @@
+/**
+ * TestDatabase — in-memory SQLite database for testing via the ream-db Rust driver.
+ */
+/** Simple async database interface for tests. */
+export class Database {
+    #impl;
+    constructor(impl) {
+        this.#impl = impl;
+    }
+    /** Create an in-memory SQLite database backed by the Rust ream-db driver. */
+    static async memory() {
+        const { createNapiConnection } = await import("../adapters/NapiDbAdapter.js");
+        const conn = await createNapiConnection("sqlite::memory:", 1, 1);
+        return new Database({
+            async query(sql) {
+                return conn.query(sql);
+            },
+            async queryWithParams(sql, params) {
+                return conn.query(sql, params);
+            },
+            async execute(sql, params) {
+                await conn.execute(sql, params);
+            },
+            async close() {
+                await conn.close();
+            },
+        });
+    }
+    async query(sql) {
+        return this.#impl.query(sql);
+    }
+    async queryWithParams(sql, params) {
+        return this.#impl.queryWithParams(sql, params);
+    }
+    async execute(sql, params) {
+        return this.#impl.execute(sql, params);
+    }
+    async close() {
+        return this.#impl.close();
+    }
+    /** Get a DatabaseAdapter for MigrationRunner compatibility. */
+    asAdapter() {
+        return {
+            execute: (sql, params) => this.#impl.execute(sql, params),
+            query: (sql, params) => params
+                ? this.#impl.queryWithParams(sql, params)
+                : this.#impl.query(sql),
+            close: () => this.#impl.close(),
+        };
+    }
+}
+//# sourceMappingURL=TestDatabase.js.map

package/dist/testing/TestDatabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestDatabase.js","sourceRoot":"","sources":["../../src/testing/TestDatabase.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,iDAAiD;AACjD,MAAM,OAAO,QAAQ;IACpB,KAAK,CAAe;IAEpB,YAAY,IAAkB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,KAAK,CAAC,MAAM;QAClB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC5C,8BAA8B,CAC9B,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,OAAO,IAAI,QAAQ,CAAC;YACnB,KAAK,CAAC,KAAK,CAAC,GAAW;gBACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YACD,KAAK,CAAC,eAAe,CACpB,GAAW,EACX,MAAiB;gBAEjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAChC,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAkB;gBAC5C,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjC,CAAC;YACD,KAAK,CAAC,KAAK;gBACV,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,eAAe,CACpB,GAAW,EACX,MAAiB;QAEjB,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAkB;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAK;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,+DAA+D;IAC/D,SAAS;QACR,OAAO;YACN,OAAO,EAAE,CAAC,GAAW,EAAE,MAAkB,EAAE,EAAE,CAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC;YAChC,KAAK,EAAE,CAAI,GAAW,EAAE,MAAkB,EAAE,EAAE,CAC7C,MAAM;gBACL,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAkB;gBAC3D,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAkB;YAC3C,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;SAC/B,CAAC;IACH,CAAC;CACD"}

package/dist/testing/index.d.ts

@@ -0,0 +1,4 @@
+export { truncateAll, useTransaction } from "./DatabaseCleanup.js";
+export { type FactoryBuilder, factory } from "./Factory.js";
+export { Database } from "./TestDatabase.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,KAAK,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,4 @@
+export { truncateAll, useTransaction } from "./DatabaseCleanup.js";
+export { factory } from "./Factory.js";
+export { Database } from "./TestDatabase.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAuB,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/utils/casing.d.ts

@@ -0,0 +1,5 @@
+/** Convert snake_case to camelCase. */
+export declare function snakeToCamel(s: string): string;
+/** Convert camelCase or PascalCase to snake_case (no leading underscore). */
+export declare function camelToSnake(s: string): string;
+//# sourceMappingURL=casing.d.ts.map

package/dist/utils/casing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"casing.d.ts","sourceRoot":"","sources":["../../src/utils/casing.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9C"}

package/dist/utils/casing.js

@@ -0,0 +1,9 @@
+/** Convert snake_case to camelCase. */
+export function snakeToCamel(s) {
+    return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+/** Convert camelCase or PascalCase to snake_case (no leading underscore). */
+export function camelToSnake(s) {
+    return s.replace(/[A-Z]/g, (c, i) => i === 0 ? c.toLowerCase() : `_${c.toLowerCase()}`);
+}
+//# sourceMappingURL=casing.js.map

package/dist/utils/casing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"casing.js","sourceRoot":"","sources":["../../src/utils/casing.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,UAAU,YAAY,CAAC,CAAS;IACrC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,CAAS;IACrC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACnC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CACjD,CAAC;AACH,CAAC"}

package/dist/utils/dialectFromUrl.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Single source of truth for dialect detection. Both `AtlasProvider` and
+ * `NapiDbAdapter` used to ship their own copy — if a new driver scheme was
+ * added (e.g. `cockroachdb://`), only one side would be updated and the two
+ * would silently drift. Extracted here so every call site resolves the same
+ * way.
+ */
+import type { AtlasDialect } from "../query/native.js";
+export declare function dialectFromUrl(url: string): AtlasDialect;
+//# sourceMappingURL=dialectFromUrl.d.ts.map

package/dist/utils/dialectFromUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialectFromUrl.d.ts","sourceRoot":"","sources":["../../src/utils/dialectFromUrl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAMxD"}

package/dist/utils/dialectFromUrl.js

@@ -0,0 +1,8 @@
+export function dialectFromUrl(url) {
+    if (url.startsWith("postgres://") || url.startsWith("postgresql://"))
+        return "postgres";
+    if (url.startsWith("mysql://") || url.startsWith("mariadb://"))
+        return "mysql";
+    return "sqlite";
+}
+//# sourceMappingURL=dialectFromUrl.js.map

package/dist/utils/dialectFromUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialectFromUrl.js","sourceRoot":"","sources":["../../src/utils/dialectFromUrl.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,cAAc,CAAC,GAAW;IACzC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QACnE,OAAO,UAAU,CAAC;IACnB,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC;QAC7D,OAAO,OAAO,CAAC;IAChB,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/utils/identifier.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SQL identifier validation helpers — used by the TS-side fluent builders
+ * before a name is sent to the Rust compiler. Catches obvious garbage
+ * (empty / wrong chars / leading digit) early with a clear error site.
+ *
+ * The Rust compiler ALSO validates and quotes identifiers — these helpers
+ * are a defence-in-depth check, not the source of truth.
+ */
+/** Returns true if `name` is a syntactically valid SQL identifier (table, column, alias, CTE name, …). */
+export declare function isValidIdentifier(name: unknown): name is string;
+/**
+ * Asserts that `name` is a valid identifier; throws a structured error otherwise.
+ *
+ * @param name  the value to validate
+ * @param kind  human-readable label used in the error message (e.g. "CTE name", "column name")
+ * @param errorFactory  builds the error to throw — keeps this helper independent of any specific error class
+ */
+export declare function assertValidIdentifier(name: unknown, kind: string, errorFactory: (message: string) => Error): asserts name is string;
+//# sourceMappingURL=identifier.d.ts.map

package/dist/utils/identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../src/utils/identifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAI/D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,GACtC,OAAO,CAAC,IAAI,IAAI,MAAM,CAIxB"}

package/dist/utils/identifier.js

@@ -0,0 +1,27 @@
+/**
+ * SQL identifier validation helpers — used by the TS-side fluent builders
+ * before a name is sent to the Rust compiler. Catches obvious garbage
+ * (empty / wrong chars / leading digit) early with a clear error site.
+ *
+ * The Rust compiler ALSO validates and quotes identifiers — these helpers
+ * are a defence-in-depth check, not the source of truth.
+ */
+/** Pattern: starts with letter or underscore, then letters/digits/underscore/dot. */
+const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_.]*$/;
+/** Returns true if `name` is a syntactically valid SQL identifier (table, column, alias, CTE name, …). */
+export function isValidIdentifier(name) {
+    return (typeof name === "string" && name.length > 0 && IDENTIFIER_RE.test(name));
+}
+/**
+ * Asserts that `name` is a valid identifier; throws a structured error otherwise.
+ *
+ * @param name  the value to validate
+ * @param kind  human-readable label used in the error message (e.g. "CTE name", "column name")
+ * @param errorFactory  builds the error to throw — keeps this helper independent of any specific error class
+ */
+export function assertValidIdentifier(name, kind, errorFactory) {
+    if (!isValidIdentifier(name)) {
+        throw errorFactory(`${kind} must be a valid identifier: '${String(name)}'`);
+    }
+}
+//# sourceMappingURL=identifier.js.map

package/dist/utils/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../src/utils/identifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qFAAqF;AACrF,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAElD,0GAA0G;AAC1G,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC9C,OAAO,CACN,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CACvE,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACpC,IAAa,EACb,IAAY,EACZ,YAAwC;IAExC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,YAAY,CAAC,GAAG,IAAI,iCAAiC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,CAAC;AACF,CAAC"}

package/dist/utils/safePath.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Path/filename validation helpers shared by MigrationRunner and Seeder.
+ *
+ * Centralised here so the "forbidden chars + no `..`" rules + "path must stay
+ * inside its base directory" check live in one place. Previously duplicated
+ * — the audit flagged this as a maintenance hazard.
+ */
+/** Non-throwing async `fs.existsSync` equivalent. Returns false on ENOENT, propagates other errors. */
+export declare function pathExists(p: string): Promise<boolean>;
+/**
+ * Throw if `name` contains characters that could escape a filename context
+ * (path separators, quotes, backticks) or include a directory-walk sequence
+ * (`..`). Does NOT check extension or existence — that's the caller's job.
+ */
+export declare function assertSafeName(name: string, errorCode: string, kind: string): void;
+/**
+ * Resolve `fileName` inside `baseDir` and throw if the resulting path escapes
+ * the base — guards against symlink / `../` traversal attacks when loading
+ * migration or seeder files dynamically.
+ */
+export declare function assertPathInsideBase(baseDir: string, fileName: string, errorCode: string, kind: string): string;
+//# sourceMappingURL=safePath.d.ts.map

package/dist/utils/safePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safePath.d.ts","sourceRoot":"","sources":["../../src/utils/safePath.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,uGAAuG;AACvG,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACV,IAAI,CAIN;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACV,MAAM,CAUR"}

package/dist/utils/safePath.js

@@ -0,0 +1,46 @@
+/**
+ * Path/filename validation helpers shared by MigrationRunner and Seeder.
+ *
+ * Centralised here so the "forbidden chars + no `..`" rules + "path must stay
+ * inside its base directory" check live in one place. Previously duplicated
+ * — the audit flagged this as a maintenance hazard.
+ */
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { AtlasError } from "../errors.js";
+/** Non-throwing async `fs.existsSync` equivalent. Returns false on ENOENT, propagates other errors. */
+export async function pathExists(p) {
+    try {
+        await fsp.access(p);
+        return true;
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return false;
+        throw err;
+    }
+}
+/**
+ * Throw if `name` contains characters that could escape a filename context
+ * (path separators, quotes, backticks) or include a directory-walk sequence
+ * (`..`). Does NOT check extension or existence — that's the caller's job.
+ */
+export function assertSafeName(name, errorCode, kind) {
+    if (/[/\\'";`]/.test(name) || name.includes("..")) {
+        throw new AtlasError(errorCode, `Invalid ${kind} name: ${name}`);
+    }
+}
+/**
+ * Resolve `fileName` inside `baseDir` and throw if the resulting path escapes
+ * the base — guards against symlink / `../` traversal attacks when loading
+ * migration or seeder files dynamically.
+ */
+export function assertPathInsideBase(baseDir, fileName, errorCode, kind) {
+    const resolved = path.resolve(baseDir, fileName);
+    const base = path.resolve(baseDir);
+    if (!resolved.startsWith(base + path.sep) && resolved !== base) {
+        throw new AtlasError(errorCode, `${kind} path escapes directory: ${fileName}`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=safePath.js.map

package/dist/utils/safePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safePath.js","sourceRoot":"","sources":["../../src/utils/safePath.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,CAAS;IACzC,IAAI,CAAC;QACJ,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACnE,MAAM,GAAG,CAAC;IACX,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC7B,IAAY,EACZ,SAAiB,EACjB,IAAY;IAEZ,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,WAAW,IAAI,UAAU,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CACnC,OAAe,EACf,QAAgB,EAChB,SAAiB,EACjB,IAAY;IAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAChE,MAAM,IAAI,UAAU,CACnB,SAAS,EACT,GAAG,IAAI,4BAA4B,QAAQ,EAAE,CAC7C,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/utils/transactionBrand.d.ts

@@ -0,0 +1,5 @@
+import type { DatabaseConnection } from "../BaseRepository.js";
+import type { TransactionClient } from "../Transaction.js";
+export declare const TRANSACTION_BRAND: unique symbol;
+export declare function isTransactionClient(db: DatabaseConnection): db is TransactionClient;
+//# sourceMappingURL=transactionBrand.d.ts.map

package/dist/utils/transactionBrand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionBrand.d.ts","sourceRoot":"","sources":["../../src/utils/transactionBrand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,eAAO,MAAM,iBAAiB,eAAkC,CAAC;AAEjE,wBAAgB,mBAAmB,CAClC,EAAE,EAAE,kBAAkB,GACpB,EAAE,IAAI,iBAAiB,CAEzB"}

package/dist/utils/transactionBrand.js

@@ -0,0 +1,5 @@
+export const TRANSACTION_BRAND = Symbol.for("atlas:transaction");
+export function isTransactionClient(db) {
+    return TRANSACTION_BRAND in db;
+}
+//# sourceMappingURL=transactionBrand.js.map

package/dist/utils/transactionBrand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionBrand.js","sourceRoot":"","sources":["../../src/utils/transactionBrand.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAEjE,MAAM,UAAU,mBAAmB,CAClC,EAAsB;IAEtB,OAAO,iBAAiB,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/atlas",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Atlas — Data Mapper ORM for the Ream framework",
   "license": "MIT",
   "type": "module",