@c9up/atlas 0.1.18 → 0.2.0

package/dist/testing/Factory.d.ts

@@ -13,14 +13,33 @@
  *
  * @implements MISS-18, Story 32.13
  */
+import { type Faker } from "@faker-js/faker";
 import type { BaseEntity } from "../BaseEntity.js";
 import { type DatabaseConnection } from "../BaseRepository.js";
 type EntityConstructor<T extends BaseEntity> = new () => T;
+/** Resolves the factory that builds a related model (Lucid `.relation`). */
+type RelationResolver = () => FactoryBuilder<BaseEntity>;
+/**
+ * Context handed to the `define` callback (Adonis Lucid parity). Currently just
+ * a Faker instance for generating fake data. A callback that takes no argument
+ * keeps working — it simply ignores the context.
+ */
+export interface FactoryContext {
+    faker: Faker;
+}
+/** Attributes callback — receives {@link FactoryContext}, returns the row shape. */
+type DefaultsFn = (ctx: FactoryContext) => Record<string, unknown>;
 /** 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>;
+    /**
+     * Like {@link merge} but deep — nested plain objects are merged key by key
+     * instead of replaced wholesale (Lucid `mergeRecursive`). Arrays and
+     * non-plain values still replace. Reset after consumption like `merge`.
+     */
+    mergeRecursive(overrides: Partial<Record<string, unknown>>): FactoryBuilder<T>;
     /** Declare a named variation of this factory, stored on the factory's state map. */
     state(name: string, fn: StateFn<Record<string, unknown>>): FactoryBuilder<T>;
     /**
@@ -31,19 +50,65 @@ export interface FactoryBuilder<T extends BaseEntity> {
      * (audit 2026-06-13). `merge()` behaves the same way.
      */
     apply(...stateNames: string[]): FactoryBuilder<T>;
-    /** Create and persist a single entity (fires lifecycle hooks via `repo.create`). */
-    create(db: DatabaseConnection): Promise<T>;
+    /**
+     * Bind a connection (e.g. a transaction) used by subsequent
+     * `create`/`createMany` calls that pass no explicit `db` (Adonis Lucid
+     * `.client`). The binding persists until changed. Ideal for test isolation:
+     * `factory.client(trx).create()`.
+     */
+    client(connection: DatabaseConnection): FactoryBuilder<T>;
+    /**
+     * Like {@link client} but resolves a connection registered under `name` via
+     * atlas's connection registry (Adonis Lucid `.connection`). Throws if no
+     * connection is registered under that name.
+     */
+    connection(name: string): FactoryBuilder<T>;
+    /**
+     * Create and persist a single entity (fires lifecycle hooks via
+     * `repo.create`). `db` is optional when a connection was bound with
+     * {@link client} / {@link connection}.
+     */
+    create(db?: DatabaseConnection): Promise<T>;
     /** Create and persist multiple entities (fires hooks per row). */
-    createMany(count: number, db: DatabaseConnection): Promise<T[]>;
+    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.
+     * The instance is marked persisted and, unless the build already supplied a
+     * primary key, given a process-unique stub id — so it looks like a saved row
+     * (relations, serialization, `$isPersisted`) without touching the DB.
      */
     makeStubbed(): T;
+    /** Build many stubbed instances, each with its own stub id ({@link makeStubbed}). */
+    makeStubbedMany(count: number): T[];
+    /**
+     * Declare which factory builds a relation (Adonis Lucid `.relation`), so
+     * `.with(name)` can create related rows. `name` must match a relation
+     * property declared with `@HasMany`/`@HasOne`/`@BelongsTo`/`@ManyToMany`.
+     */
+    relation(name: string, resolver: RelationResolver): FactoryBuilder<T>;
+    /**
+     * Queue related rows to create together with the next `create`/`createMany`
+     * (Adonis Lucid `.with`). `count` defaults to 1 (ignored past 1 for hasOne).
+     * The callback receives the related factory to customize it (`merge`/`apply`).
+     *
+     * One level deep: the related rows are persisted through the parent's
+     * relation proxy (which wires the FK / pivot), so a nested `.with()` on the
+     * callback's factory is not itself applied. `.with()` runs on persistence
+     * only — `make`/`makeStubbed` ignore it.
+     */
+    with(name: string, count?: number, callback?: (factory: FactoryBuilder<BaseEntity>) => void): FactoryBuilder<T>;
+    /**
+     * Register a callback that runs on the built entity INSTANCE before it is
+     * persisted (Adonis Lucid `.tap`). Multiple taps run in order. Applies to the
+     * instance-producing paths — `create`/`createMany`/`makeStubbed`/
+     * `makeStubbedMany` — and is reset after consumption; `make`/`makeMany`
+     * return plain data, so they ignore it.
+     */
+    tap(fn: (entity: T) => void): FactoryBuilder<T>;
 }
 /**
  * Define a model factory.
@@ -53,6 +118,6 @@ export interface FactoryBuilder<T extends BaseEntity> {
  *       name: 'Test User',
  *     }))
  */
-export declare function factory<T extends BaseEntity>(entityClass: EntityConstructor<T>, defaults: () => Record<string, unknown>): FactoryBuilder<T>;
+export declare function factory<T extends BaseEntity>(entityClass: EntityConstructor<T>, defaults: DefaultsFn): FactoryBuilder<T>;
 export {};
 //# sourceMappingURL=Factory.d.ts.map

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

@@ -1 +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,oFAAoF;IACpF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAE7E;;;;;;OAMG;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,CA0FnB"}
+{"version":3,"file":"Factory.d.ts","sourceRoot":"","sources":["../../src/testing/Factory.ts"],"names":[],"mappings":"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"}

package/dist/testing/Factory.js

@@ -13,7 +13,43 @@
  *
  * @implements MISS-18, Story 32.13
  */
+import { faker } from "@faker-js/faker";
 import { BaseRepository } from "../BaseRepository.js";
+import { getPrimaryKey, getRelationMetadata } from "../decorators/entity.js";
+import { getConnection } from "../services/db.js";
+/**
+ * Process-wide counter for stubbed primary keys (Lucid's stub id). Every
+ * `makeStubbed*` build with no explicit PK gets the next value, so stubbed
+ * instances have stable, distinct, DB-free identifiers — enough to look
+ * persisted and to key relations/serialization without a round trip.
+ */
+let stubIdCounter = 0;
+/** Keys that must never be written through a recursive merge — prototype-pollution guard. */
+const FORBIDDEN_MERGE_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+function isPlainObject(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * Deep-merge `source` into `target` (Lucid `mergeRecursive`). Plain objects are
+ * merged key by key; arrays and every non-plain value replace wholesale. Returns
+ * a fresh object — neither argument is mutated. Skips prototype-pollution keys.
+ */
+function deepMerge(target, source) {
+    const out = { ...target };
+    for (const [key, value] of Object.entries(source)) {
+        if (FORBIDDEN_MERGE_KEYS.has(key))
+            continue;
+        const existing = out[key];
+        out[key] =
+            isPlainObject(existing) && isPlainObject(value)
+                ? deepMerge(existing, value)
+                : value;
+    }
+    return out;
+}
 /**
  * Define a model factory.
  *
@@ -27,12 +63,61 @@ export function factory(entityClass, defaults) {
     const states = new Map();
     // Transient state — resets after every `make`/`create`.
     let pendingOverrides = {};
+    // Recursive overrides are kept apart from the shallow `pendingOverrides`
+    // because they must deep-merge into `defaults()`, which only exists at build
+    // time — a shallow spread here would clobber a whole nested object.
+    let pendingRecursive = {};
     let pendingStates = [];
+    // Relations: persistent factory resolvers keyed by relation name, plus the
+    // transient `.with()` queue consumed by create()/createMany().
+    const relations = new Map();
+    let pendingWith = [];
+    // Transient `.tap()` callbacks run on the built instance before persistence.
+    let pendingTap = [];
+    // Persistent connection bound via `.client()`/`.connection()`, used when
+    // create()/createMany() are called without an explicit `db`.
+    let boundClient;
+    /** The connection to persist through: the explicit arg wins over the bound one. */
+    const resolveConnection = (db) => {
+        const conn = db ?? boundClient;
+        if (!conn) {
+            throw new Error(`Factory ${entityClass.name}: no connection — pass one to create()/createMany() or bind one with .client()/.connection().`);
+        }
+        return conn;
+    };
+    // Primary-key property, resolved once, for stub-id assignment. Same fallback
+    // as BaseRepository so a model without an explicit `@PrimaryKey` uses `id`.
+    const primaryKey = getPrimaryKey(entityClass) ?? "id";
+    /** Hydrate a fresh (not-yet-persisted) instance from a data object. */
+    const newInstance = (data) => {
+        const entity = new entityClass();
+        for (const [key, value] of Object.entries(data)) {
+            entity.setProp(key, value);
+        }
+        return entity;
+    };
+    /** Build a stubbed instance: hydrate, run taps, give it a stub id if none was
+     * supplied, then mark persisted so it mirrors a fetched row. Taps run before
+     * `markAsPersisted` so tapped fields land in the clean snapshot. */
+    const stub = (data, taps) => {
+        const entity = newInstance(data);
+        for (const tap of taps)
+            tap(entity);
+        if (data[primaryKey] === undefined) {
+            entity.setProp(primaryKey, ++stubIdCounter);
+        }
+        entity.markAsPersisted();
+        return entity;
+    };
     const buildData = () => {
-        const data = {
-            ...defaults(),
+        let data = {
+            ...defaults({ faker }),
             ...pendingOverrides,
         };
+        // Deep overrides layer on top of the shallow one so nested defaults survive.
+        if (Object.keys(pendingRecursive).length > 0) {
+            data = deepMerge(data, pendingRecursive);
+        }
         for (const name of pendingStates) {
             const fn = states.get(name);
             if (!fn)
@@ -43,13 +128,77 @@ export function factory(entityClass, defaults) {
     };
     const resetPending = () => {
         pendingOverrides = {};
+        pendingRecursive = {};
         pendingStates = [];
+        pendingTap = [];
+    };
+    /**
+     * Persist one row. With no taps this is the plain `repo.create(data)` path,
+     * untouched. With taps, the instance is built, tapped, then saved — so a tap
+     * can mutate the model before the INSERT (Adonis Lucid `.tap`). `save` on a
+     * fresh instance runs the same create hooks as `create`.
+     */
+    const persist = async (repo, data, taps) => {
+        if (taps.length === 0)
+            return repo.create(data);
+        const entity = newInstance(data);
+        for (const tap of taps)
+            tap(entity);
+        await repo.save(entity);
+        return entity;
+    };
+    /**
+     * Persist the queued `.with()` relations for one just-created parent, routing
+     * through the parent's relation proxy so the FK / pivot is wired by the
+     * already-tested relation-write code (not re-derived here).
+     */
+    const applyRelations = async (parent, reqs, db) => {
+        const meta = getRelationMetadata(entityClass);
+        for (const req of reqs) {
+            const relMeta = meta.find((r) => r.propertyKey === req.name);
+            if (!relMeta) {
+                throw new Error(`Factory .with('${req.name}'): '${req.name}' is not a declared relation on ${entityClass.name}`);
+            }
+            const resolver = relations.get(req.name);
+            if (!resolver) {
+                throw new Error(`Factory .with('${req.name}'): no related factory — declare it with .relation('${req.name}', () => XFactory)`);
+            }
+            const childFactory = resolver();
+            if (req.callback)
+                req.callback(childFactory);
+            const proxy = parent.related(req.name);
+            if (proxy.type === "hasMany") {
+                await proxy.createMany(childFactory.makeMany(req.count));
+            }
+            else if (proxy.type === "hasOne") {
+                await proxy.create(childFactory.make());
+            }
+            else if (proxy.type === "manyToMany") {
+                // The m2m proxy's create() inserts the related row AND the pivot link.
+                for (const row of childFactory.makeMany(req.count)) {
+                    await proxy.create(row);
+                }
+            }
+            else if (proxy.type === "belongsTo") {
+                // FK lives on the parent: create the owner, then associate re-saves
+                // the parent with the FK set.
+                const owner = await childFactory.create(db);
+                await proxy.associate(owner);
+            }
+            else {
+                throw new Error(`Factory .with('${req.name}'): '${relMeta.type}' relations are not supported`);
+            }
+        }
     };
     const builder = {
         merge(overrides) {
             pendingOverrides = { ...pendingOverrides, ...overrides };
             return builder;
         },
+        mergeRecursive(overrides) {
+            pendingRecursive = deepMerge(pendingRecursive, overrides);
+            return builder;
+        },
         state(name, fn) {
             states.set(name, fn);
             return builder;
@@ -58,6 +207,30 @@ export function factory(entityClass, defaults) {
             pendingStates.push(...names);
             return builder;
         },
+        relation(name, resolver) {
+            relations.set(name, resolver);
+            return builder;
+        },
+        with(name, count = 1, callback) {
+            pendingWith.push({ name, count, callback });
+            return builder;
+        },
+        tap(fn) {
+            pendingTap.push(fn);
+            return builder;
+        },
+        client(connection) {
+            boundClient = connection;
+            return builder;
+        },
+        connection(name) {
+            const conn = getConnection(name);
+            if (!conn) {
+                throw new Error(`Factory ${entityClass.name}: no connection registered under '${name}'.`);
+            }
+            boundClient = conn;
+            return builder;
+        },
         make() {
             const data = buildData();
             resetPending();
@@ -75,25 +248,51 @@ export function factory(entityClass, defaults) {
             return rows;
         },
         makeStubbed() {
+            const taps = pendingTap;
             const data = buildData();
+            const entity = stub(data, taps);
             resetPending();
-            const entity = new entityClass();
-            for (const [key, value] of Object.entries(data)) {
-                entity.setProp(key, value);
-            }
             return entity;
         },
+        makeStubbedMany(count) {
+            // Re-evaluate defaults per row (distinct Date.now()/faker values), same
+            // as makeMany; each row then gets its own stub id + taps via `stub`.
+            const taps = pendingTap;
+            const rows = [];
+            for (let i = 0; i < count; i++) {
+                rows.push(stub(buildData(), taps));
+            }
+            resetPending();
+            return rows;
+        },
         async create(db) {
+            const conn = resolveConnection(db);
+            // Capture + clear the relation/tap queues before make() (which resets
+            // pending state) so they aren't lost and a later create() starts clean.
+            const withReqs = pendingWith;
+            pendingWith = [];
+            const taps = pendingTap;
             const data = builder.make();
-            const repo = new BaseRepository(entityClass, db);
-            return repo.create(data);
+            const repo = new BaseRepository(entityClass, conn);
+            const entity = await persist(repo, data, taps);
+            if (withReqs.length > 0)
+                await applyRelations(entity, withReqs, conn);
+            return entity;
         },
         async createMany(count, db) {
+            const conn = resolveConnection(db);
+            const withReqs = pendingWith;
+            pendingWith = [];
+            const taps = pendingTap;
             const rows = builder.makeMany(count);
-            const repo = new BaseRepository(entityClass, db);
+            const repo = new BaseRepository(entityClass, conn);
             const created = [];
             for (const data of rows) {
-                created.push(await repo.create(data));
+                const entity = await persist(repo, data, taps);
+                // Each created parent gets its own related rows (Lucid semantics).
+                if (withReqs.length > 0)
+                    await applyRelations(entity, withReqs, conn);
+                created.push(entity);
             }
             return created;
         },

package/dist/testing/Factory.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/atlas",
-  "version": "0.1.18",
+  "version": "0.2.0",
   "description": "Atlas — Data Mapper ORM for the Ream framework",
   "license": "MIT",
   "type": "module",
@@ -39,9 +39,12 @@
     }
   },
   "dependencies": {
+    "@c9up/chronos": "^0.1.6",
+    "@faker-js/faker": "^9",
     "reflect-metadata": "^0.2"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
     "@types/node": "^22"

package/scripts/guard-publish.mjs

@@ -0,0 +1,15 @@
+// Refuse a LOCAL `npm/pnpm publish`. Atlas ships prebuilt multi-platform NAPI
+// binaries (index.<suffix>.node / db.<suffix>.node) that only the CI matrix
+// assembles + downloads before publishing. A local publish would package
+// whatever single-platform / stale `.node` files happen to be on disk, so the
+// published tarball would be broken on every other platform. Publishing MUST go
+// through the workflow_dispatch CI job (which sets CI=true).
+if (!process.env.CI) {
+	console.error(
+		"@c9up/atlas: refusing a local publish.\n" +
+			"Publish only via the CI workflow — it builds and bundles the NAPI\n" +
+			"binaries for every platform. A local `npm publish` would ship\n" +
+			"incomplete/stale `.node` files. Run the publish workflow instead.",
+	);
+	process.exit(1);
+}

package/src/AtlasProvider.ts

@@ -81,6 +81,12 @@ export interface ConnectionConfig {
 	poolMin?: number;
 	/** Maximum pool connections (default: 10) */
 	poolMax?: number;
+	/**
+	 * Emit a `db:query` event for every statement on this connection (Lucid's
+	 * `debug` connection option). Off by default — subscribe with `onDbQuery`
+	 * to receive them; with no subscriber nothing is emitted either way.
+	 */
+	debug?: boolean;
 	/**
 	 * Connection-level pragmas (sqlite only). Each entry becomes a
 	 * `PRAGMA <key> = <value>;` issued before the first query.
@@ -163,7 +169,7 @@ export default class AtlasProvider {
 		// leaks pools/sockets.
 		const entries = Object.entries(connections);
 		const results = await Promise.allSettled(
-			entries.map(([, settings]) =>
+			entries.map(([name, settings]) =>
 				createNapiConnection(
 					settings.url,
 					settings.poolMin ?? 1,
@@ -174,6 +180,7 @@ export default class AtlasProvider {
 						backoffMs: settings.connectBackoffMs,
 						timeoutMs: settings.connectTimeoutMs,
 					},
+					{ debug: settings.debug ?? false, connectionName: name },
 				),
 			),
 		);