@c9up/atlas 0.1.3 → 0.1.4

package/dist/decorators/hooks.js

@@ -0,0 +1,107 @@
+/**
+ * Lifecycle hook decorators — Lucid-compatible hook surface.
+ *
+ * Decorate a static method on an entity with one of the hooks below; Atlas
+ * fires it at the matching point in the BaseRepository CRUD pipeline. Hooks
+ * are inherited from the prototype chain — a hook on a parent entity also
+ * fires for subclasses.
+ *
+ *     class User extends BaseEntity {
+ *       @beforeSave()
+ *       static async hashPassword(user: User) {
+ *         if (user.isDirty('password')) {
+ *           user.password = await hash(user.password)
+ *         }
+ *       }
+ *     }
+ *
+ * @implements Story 32.1
+ */
+import "reflect-metadata";
+const HOOKS_KEY = Symbol.for("atlas:hooks");
+function getOwnRegistry(target) {
+    const existing = Reflect.getOwnMetadata(HOOKS_KEY, target);
+    if (isHookRegistry(existing))
+        return existing;
+    const registry = {};
+    Reflect.defineMetadata(HOOKS_KEY, registry, target);
+    return registry;
+}
+function isHookRegistry(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    for (const v of Object.values(value)) {
+        if (v !== undefined && !Array.isArray(v))
+            return false;
+    }
+    return true;
+}
+function isHookHandler(value) {
+    return typeof value === "function";
+}
+/** Register a static method on the class as a hook handler. */
+function register(kind) {
+    return (target, propertyKey) => {
+        // target is the constructor for static methods, the prototype for instance methods
+        const ctor = typeof target === "function" ? target : target.constructor;
+        const handler = Reflect.get(ctor, propertyKey);
+        if (!isHookHandler(handler)) {
+            throw new Error(`@${kind} must decorate a static method, got ${String(propertyKey)}`);
+        }
+        const registry = getOwnRegistry(ctor);
+        if (!registry[kind])
+            registry[kind] = [];
+        registry[kind]?.push(handler);
+    };
+}
+// ─── Decorators (one per hook kind) ───────────────────────────
+export const beforeSave = () => register("beforeSave");
+export const afterSave = () => register("afterSave");
+export const beforeCreate = () => register("beforeCreate");
+export const afterCreate = () => register("afterCreate");
+export const beforeUpdate = () => register("beforeUpdate");
+export const afterUpdate = () => register("afterUpdate");
+export const beforeDelete = () => register("beforeDelete");
+export const afterDelete = () => register("afterDelete");
+export const beforeFind = () => register("beforeFind");
+export const afterFind = () => register("afterFind");
+export const beforeFetch = () => register("beforeFetch");
+export const afterFetch = () => register("afterFetch");
+export const beforePaginate = () => register("beforePaginate");
+export const afterPaginate = () => register("afterPaginate");
+/**
+ * Walk the prototype chain and collect every handler registered for `kind`.
+ * Parent-class hooks fire BEFORE child-class hooks (so a base entity can set
+ * up scoping that the child then refines).
+ */
+export function collectHooks(entityClass, kind) {
+    const handlers = [];
+    let ctor = entityClass;
+    const chain = [];
+    while (ctor &&
+        ctor !== Function.prototype &&
+        ctor.name) {
+        chain.push(ctor);
+        ctor = Object.getPrototypeOf(ctor);
+    }
+    // Walk parent → child so the most-base hook fires first
+    for (const c of chain.reverse()) {
+        const registry = Reflect.getOwnMetadata(HOOKS_KEY, c);
+        const list = registry?.[kind];
+        if (list)
+            handlers.push(...list);
+    }
+    return handlers;
+}
+/**
+ * Fire every handler for `kind` sequentially. Awaits each one so a hook can
+ * mutate the entity before the next hook (or the persistence step) sees it.
+ * If any hook throws, the whole operation aborts and the error propagates.
+ */
+export async function fireHooks(entityClass, kind, arg) {
+    const handlers = collectHooks(entityClass, kind);
+    for (const handler of handlers) {
+        await handler(arg);
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/decorators/hooks.js.map

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

package/dist/decorators/scope.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `scope()` — typed identity helper for declaring entity query scopes.
+ *
+ * Entity classes expose reusable filter/sort logic via `static scopes = {...}`.
+ * TypeScript can't infer the scope type on the naked object form, so this
+ * helper lets callers pin the argument types explicitly:
+ *
+ *     class User extends BaseEntity {
+ *       static scopes = {
+ *         active:  scope((q: ModelQuery<User>) => q.where('status', 'active')),
+ *         forOrg:  scope((q: ModelQuery<User>, org: Org) => q.where('org_id', org.id)),
+ *       }
+ *     }
+ *
+ * The runtime is an identity pass-through — `scope` returns its argument
+ * unchanged. Its only purpose is to give TS enough information to infer the
+ * scope's parameter types (and, by extension, the return type of
+ * `repo.query().apply(s => s.forOrg(...))` call sites).
+ *
+ * @implements Story 29.8 (scope helper)
+ */
+import type { BaseEntity } from "../BaseEntity.js";
+import type { ModelQuery } from "../ModelQuery.js";
+/**
+ * A query scope function — takes the current query as first argument and
+ * an arbitrary list of extra arguments. Returns the query for chaining
+ * (or `void` — the chain is applied in place).
+ */
+export type ScopeFn<TEntity extends BaseEntity, Args extends unknown[] = []> = (query: ModelQuery<TEntity>, ...args: Args) => ModelQuery<TEntity> | undefined;
+/**
+ * Typed identity helper. Pass any scope function through `scope()` to get
+ * TS inference without changing the runtime behaviour.
+ */
+export declare function scope<TEntity extends BaseEntity, Args extends unknown[] = []>(fn: ScopeFn<TEntity, Args>): ScopeFn<TEntity, Args>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/decorators/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/decorators/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,OAAO,CAAC,OAAO,SAAS,UAAU,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,IAAI,CAC9E,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAC1B,GAAG,IAAI,EAAE,IAAI,KACT,UAAU,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;AAErC;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,SAAS,UAAU,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,EAC5E,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GACxB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAExB"}

package/dist/decorators/scope.js

@@ -0,0 +1,29 @@
+/**
+ * `scope()` — typed identity helper for declaring entity query scopes.
+ *
+ * Entity classes expose reusable filter/sort logic via `static scopes = {...}`.
+ * TypeScript can't infer the scope type on the naked object form, so this
+ * helper lets callers pin the argument types explicitly:
+ *
+ *     class User extends BaseEntity {
+ *       static scopes = {
+ *         active:  scope((q: ModelQuery<User>) => q.where('status', 'active')),
+ *         forOrg:  scope((q: ModelQuery<User>, org: Org) => q.where('org_id', org.id)),
+ *       }
+ *     }
+ *
+ * The runtime is an identity pass-through — `scope` returns its argument
+ * unchanged. Its only purpose is to give TS enough information to infer the
+ * scope's parameter types (and, by extension, the return type of
+ * `repo.query().apply(s => s.forOrg(...))` call sites).
+ *
+ * @implements Story 29.8 (scope helper)
+ */
+/**
+ * Typed identity helper. Pass any scope function through `scope()` to get
+ * TS inference without changing the runtime behaviour.
+ */
+export function scope(fn) {
+    return fn;
+}
+//# sourceMappingURL=scope.js.map

package/dist/decorators/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/decorators/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAeH;;;GAGG;AACH,MAAM,UAAU,KAAK,CACpB,EAA0B;IAE1B,OAAO,EAAE,CAAC;AACX,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Atlas error hierarchy — structured errors for the ORM layer.
+ *
+ * Every error extends {@link AtlasError} with a stable code (prefixed `ATLAS_`),
+ * a human-readable message, and an optional hint. Specialised subclasses allow
+ * callers to catch by type (`catch (e) { if (e instanceof OptimisticLockError) ... }`)
+ * without string-matching on codes.
+ *
+ * @implements Story 32.10
+ */
+export declare class AtlasError extends Error {
+    readonly code: string;
+    readonly hint?: string;
+    constructor(code: string, message: string, options?: {
+        hint?: string;
+    });
+}
+/**
+ * Thrown when an entity cannot be found (find, findOrFail, firstOrFail).
+ */
+export declare class EntityNotFoundError extends AtlasError {
+    readonly entityClass: string;
+    readonly criteria: unknown;
+    constructor(entityClass: string, criteria: unknown, hint?: string);
+}
+/**
+ * Thrown when an optimistic lock check fails on save — the row was modified
+ * by another transaction since we read it. Requires `@Version()` column on the entity.
+ */
+export declare class OptimisticLockError extends AtlasError {
+    readonly entityClass: string;
+    readonly primaryKey: unknown;
+    readonly expectedVersion: number;
+    constructor(entityClass: string, primaryKey: unknown, expectedVersion: number);
+}
+/**
+ * Thrown when accessing a relation that was not eager-loaded AND has no lazy
+ * loader available on the entity. Forces callers to be explicit about loading.
+ */
+export declare class RelationNotLoadedError extends AtlasError {
+    readonly entityClass: string;
+    readonly relationName: string;
+    constructor(entityClass: string, relationName: string);
+}
+/**
+ * Thrown when mass-assignment (`fill` / `merge` / `create`) tries to set a
+ * field that is not in the `fillable` list or is in the `guarded` list.
+ */
+export declare class MassAssignmentError extends AtlasError {
+    readonly entityClass: string;
+    readonly attribute: string;
+    constructor(entityClass: string, attribute: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qBAAa,UAAW,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;CAMtE;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAEf,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM;CAUjE;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAGhC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,OAAO,EACnB,eAAe,EAAE,MAAM;CAYxB;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAYrD;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAYlD"}

package/dist/errors.js

@@ -0,0 +1,82 @@
+/**
+ * Atlas error hierarchy — structured errors for the ORM layer.
+ *
+ * Every error extends {@link AtlasError} with a stable code (prefixed `ATLAS_`),
+ * a human-readable message, and an optional hint. Specialised subclasses allow
+ * callers to catch by type (`catch (e) { if (e instanceof OptimisticLockError) ... }`)
+ * without string-matching on codes.
+ *
+ * @implements Story 32.10
+ */
+export class AtlasError extends Error {
+    code;
+    hint;
+    constructor(code, message, options) {
+        super(message);
+        this.name = "AtlasError";
+        this.code = code.startsWith("ATLAS_") ? code : `ATLAS_${code}`;
+        this.hint = options?.hint;
+    }
+}
+/**
+ * Thrown when an entity cannot be found (find, findOrFail, firstOrFail).
+ */
+export class EntityNotFoundError extends AtlasError {
+    entityClass;
+    criteria;
+    constructor(entityClass, criteria, hint) {
+        super("E_ENTITY_NOT_FOUND", `${entityClass} not found with ${JSON.stringify(criteria)}`, { hint });
+        this.name = "EntityNotFoundError";
+        this.entityClass = entityClass;
+        this.criteria = criteria;
+    }
+}
+/**
+ * Thrown when an optimistic lock check fails on save — the row was modified
+ * by another transaction since we read it. Requires `@Version()` column on the entity.
+ */
+export class OptimisticLockError extends AtlasError {
+    entityClass;
+    primaryKey;
+    expectedVersion;
+    constructor(entityClass, primaryKey, expectedVersion) {
+        super("E_OPTIMISTIC_LOCK", `Optimistic lock failure saving ${entityClass}#${String(primaryKey)}: the row was modified by another transaction (expected version ${expectedVersion}).`, { hint: "Reload the entity, reapply your changes, and try again." });
+        this.name = "OptimisticLockError";
+        this.entityClass = entityClass;
+        this.primaryKey = primaryKey;
+        this.expectedVersion = expectedVersion;
+    }
+}
+/**
+ * Thrown when accessing a relation that was not eager-loaded AND has no lazy
+ * loader available on the entity. Forces callers to be explicit about loading.
+ */
+export class RelationNotLoadedError extends AtlasError {
+    entityClass;
+    relationName;
+    constructor(entityClass, relationName) {
+        super("E_RELATION_NOT_LOADED", `Relation '${relationName}' on ${entityClass} was not loaded.`, {
+            hint: `Call .preload('${relationName}') on the query or .load('${relationName}') on the instance.`,
+        });
+        this.name = "RelationNotLoadedError";
+        this.entityClass = entityClass;
+        this.relationName = relationName;
+    }
+}
+/**
+ * Thrown when mass-assignment (`fill` / `merge` / `create`) tries to set a
+ * field that is not in the `fillable` list or is in the `guarded` list.
+ */
+export class MassAssignmentError extends AtlasError {
+    entityClass;
+    attribute;
+    constructor(entityClass, attribute) {
+        super("E_MASS_ASSIGNMENT", `Attribute '${attribute}' on ${entityClass} is not mass-assignable.`, {
+            hint: `Add '${attribute}' to the static 'fillable' array or remove it from 'guarded'.`,
+        });
+        this.name = "MassAssignmentError";
+        this.entityClass = entityClass;
+        this.attribute = attribute;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC3B,IAAI,CAAS;IACb,IAAI,CAAU;IAEvB,YAAY,IAAY,EAAE,OAAe,EAAE,OAA2B;QACrE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;IAC3B,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACzC,WAAW,CAAS;IACpB,QAAQ,CAAU;IAE3B,YAAY,WAAmB,EAAE,QAAiB,EAAE,IAAa;QAChE,KAAK,CACJ,oBAAoB,EACpB,GAAG,WAAW,mBAAmB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAC3D,EAAE,IAAI,EAAE,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACzC,WAAW,CAAS;IACpB,UAAU,CAAU;IACpB,eAAe,CAAS;IAEjC,YACC,WAAmB,EACnB,UAAmB,EACnB,eAAuB;QAEvB,KAAK,CACJ,mBAAmB,EACnB,kCAAkC,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,mEAAmE,eAAe,IAAI,EACzJ,EAAE,IAAI,EAAE,yDAAyD,EAAE,CACnE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACxC,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IAC5C,WAAW,CAAS;IACpB,YAAY,CAAS;IAE9B,YAAY,WAAmB,EAAE,YAAoB;QACpD,KAAK,CACJ,uBAAuB,EACvB,aAAa,YAAY,QAAQ,WAAW,kBAAkB,EAC9D;YACC,IAAI,EAAE,kBAAkB,YAAY,6BAA6B,YAAY,qBAAqB;SAClG,CACD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IAClC,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACzC,WAAW,CAAS;IACpB,SAAS,CAAS;IAE3B,YAAY,WAAmB,EAAE,SAAiB;QACjD,KAAK,CACJ,mBAAmB,EACnB,cAAc,SAAS,QAAQ,WAAW,0BAA0B,EACpE;YACC,IAAI,EAAE,QAAQ,SAAS,+DAA+D;SACtF,CACD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @module @c9up/atlas
+ * @description Atlas — Data Mapper ORM for the Ream framework
+ * @implements FR29, FR30, FR31, FR34, FR35, FR37
+ */
+import "reflect-metadata";
+export { SQLITE_PROD_PRAGMAS } from "./AtlasProvider.js";
+export type { AsyncDatabaseConnection } from "./adapters/NapiDbAdapter.js";
+export { createNapiConnection } from "./adapters/NapiDbAdapter.js";
+export type { DomainEvent } from "./BaseEntity.js";
+export { BaseEntity } from "./BaseEntity.js";
+export type { DatabaseConnection } from "./BaseRepository.js";
+export { BaseRepository } from "./BaseRepository.js";
+export { defineConfig } from "./config.js";
+export { configure } from "./configure.js";
+export type { ColumnAdapter, ColumnMetadata, ColumnOptions, DateColumnConfig, DateTimeColumnOptions, EntityMetadata, ManyToManyOptions, RelationMetadata, } from "./decorators/entity.js";
+export { BelongsTo, Column, column, computed, Entity, getColumnMetadata, getDateColumnConfig, getEntityMetadata, getPrimaryKey, getRelationMetadata, HasMany, HasManyThrough, HasOne, HasOneThrough, hasSoftDeletes, ManyToMany, PrimaryKey, SoftDeletes, } from "./decorators/entity.js";
+export { afterCreate, afterDelete, afterFetch, afterFind, afterPaginate, afterSave, afterUpdate, beforeCreate, beforeDelete, beforeFetch, beforeFind, beforePaginate, beforeSave, beforeUpdate, } from "./decorators/hooks.js";
+export type { ScopeFn } from "./decorators/scope.js";
+export { scope } from "./decorators/scope.js";
+export { AtlasError, EntityNotFoundError, MassAssignmentError, OptimisticLockError, RelationNotLoadedError, } from "./errors.js";
+export { isAtlasStrictMode, ModelQuery, setAtlasStrictMode, } from "./ModelQuery.js";
+export type { NamingStrategy } from "./naming/NamingStrategy.js";
+export { CamelCaseNamingStrategy, defaultNamingStrategy, getNamingStrategy, } from "./naming/NamingStrategy.js";
+export type { AtlasDialect } from "./query/native.js";
+export { getAtlasDialect, setAtlasDialect } from "./query/native.js";
+export type { CteDefinition, ExistsClause, OrderByClause, QueryResult, WhereClause, WhereOperator, } from "./query/QueryBuilder.js";
+export { QueryBuilder, RawSql } from "./query/QueryBuilder.js";
+export { Migration } from "./schema/Migration.js";
+export type { DatabaseAdapter, MigrationRecord, MigrationState, MigrationStatus, } from "./schema/MigrationRunner.js";
+export { MigrationRunner } from "./schema/MigrationRunner.js";
+export type { ColumnDefinition, ColumnType } from "./schema/SchemaBuilder.js";
+export { Schema, TableBuilder } from "./schema/SchemaBuilder.js";
+export { BaseSeeder, runSeederDirectory, runSeeders, Seeder, } from "./schema/Seeder.js";
+export type { TransactionClient } from "./Transaction.js";
+export { transaction } from "./Transaction.js";
+export { truncateAll, useTransaction } from "./testing/DatabaseCleanup.js";
+export { factory } from "./testing/Factory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @module @c9up/atlas
+ * @description Atlas — Data Mapper ORM for the Ream framework
+ * @implements FR29, FR30, FR31, FR34, FR35, FR37
+ */
+import "reflect-metadata";
+export { SQLITE_PROD_PRAGMAS } from "./AtlasProvider.js";
+export { createNapiConnection } from "./adapters/NapiDbAdapter.js";
+export { BaseEntity } from "./BaseEntity.js";
+export { BaseRepository } from "./BaseRepository.js";
+export { defineConfig } from "./config.js";
+export { configure } from "./configure.js";
+export { BelongsTo, Column, column, computed, Entity, getColumnMetadata, getDateColumnConfig, getEntityMetadata, getPrimaryKey, getRelationMetadata, HasMany, HasManyThrough, HasOne, HasOneThrough, hasSoftDeletes, ManyToMany, PrimaryKey, SoftDeletes, } from "./decorators/entity.js";
+export { afterCreate, afterDelete, afterFetch, afterFind, afterPaginate, afterSave, afterUpdate, beforeCreate, beforeDelete, beforeFetch, beforeFind, beforePaginate, beforeSave, beforeUpdate, } from "./decorators/hooks.js";
+export { scope } from "./decorators/scope.js";
+export { AtlasError, EntityNotFoundError, MassAssignmentError, OptimisticLockError, RelationNotLoadedError, } from "./errors.js";
+export { isAtlasStrictMode, ModelQuery, setAtlasStrictMode, } from "./ModelQuery.js";
+export { CamelCaseNamingStrategy, defaultNamingStrategy, getNamingStrategy, } from "./naming/NamingStrategy.js";
+export { getAtlasDialect, setAtlasDialect } from "./query/native.js";
+export { QueryBuilder, RawSql } from "./query/QueryBuilder.js";
+export { Migration } from "./schema/Migration.js";
+export { MigrationRunner } from "./schema/MigrationRunner.js";
+export { Schema, TableBuilder } from "./schema/SchemaBuilder.js";
+export { BaseSeeder, runSeederDirectory, runSeeders, Seeder, } from "./schema/Seeder.js";
+export { transaction } from "./Transaction.js";
+export { truncateAll, useTransaction } from "./testing/DatabaseCleanup.js";
+export { factory } from "./testing/Factory.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAW3C,OAAO,EACN,SAAS,EACT,MAAM,EACN,MAAM,EACN,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,cAAc,EACd,MAAM,EACN,aAAa,EACb,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,GACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,cAAc,EACd,UAAU,EACV,YAAY,GACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EACN,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,iBAAiB,EACjB,UAAU,EACV,kBAAkB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,GACjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASrE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOlD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACN,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,MAAM,GACN,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/naming/NamingStrategy.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Naming Strategy — override the snake_case ↔ camelCase convention per-entity.
+ *
+ * Each entity class can declare `static namingStrategy = new MyStrategy()` to
+ * replace the default camelCase ↔ snake_case conversion with its own rules.
+ * Used to migrate legacy databases (e.g. PascalCase columns, prefixed tables,
+ * custom pivot table names).
+ *
+ *     class LegacyUser extends BaseEntity {
+ *       static namingStrategy = new SnakeCaseSingularStrategy()
+ *     }
+ *
+ * @implements Story 32.7
+ */
+/** Constructor-level hook for a naming override. Defaults to camelCase ↔ snake_case. */
+export interface NamingStrategy {
+    /** Table name for an entity class, given its constructor name. */
+    tableName(className: string): string;
+    /** Database column name for a TS property (e.g. `userId` → `user_id`). */
+    columnName(propertyName: string): string;
+    /** Reverse mapping — DB column back to the TS property. Used by hydrate. */
+    propertyName(columnName: string): string;
+    /** Serialized field name in `toJSON()`. Defaults to the property name. */
+    serializedName(propertyName: string): string;
+    /** Local key for a belongsTo/hasMany relation (usually the parent PK). */
+    relationLocalKey(kind: "belongsTo" | "hasMany" | "hasOne" | "manyToMany", parentPk: string): string;
+    /** Foreign key column name on the owning side of a relation. */
+    relationForeignKey(kind: "belongsTo" | "hasMany" | "hasOne" | "manyToMany", parentClass: string, parentPk: string): string;
+    /** Default pivot table name for a manyToMany relation. */
+    relationPivotTable(aClass: string, bClass: string): string;
+}
+/**
+ * Default strategy — camelCase TS properties, snake_case DB columns, plural
+ * snake_case table names, `<parent_name>_<parent_pk>` foreign keys.
+ */
+export declare class CamelCaseNamingStrategy implements NamingStrategy {
+    tableName(className: string): string;
+    columnName(propertyName: string): string;
+    propertyName(columnName: string): string;
+    serializedName(propertyName: string): string;
+    relationLocalKey(_kind: "belongsTo" | "hasMany" | "hasOne" | "manyToMany", parentPk: string): string;
+    relationForeignKey(_kind: "belongsTo" | "hasMany" | "hasOne" | "manyToMany", parentClass: string, parentPk: string): string;
+    relationPivotTable(aClass: string, bClass: string): string;
+}
+/** The default singleton — used when an entity doesn't override `static namingStrategy`. */
+export declare const defaultNamingStrategy: NamingStrategy;
+/**
+ * Resolve the naming strategy for an entity class. Walks the prototype chain
+ * so subclasses inherit their parent's strategy unless they override.
+ */
+export declare function getNamingStrategy(entityClass: object): NamingStrategy;
+//# sourceMappingURL=NamingStrategy.d.ts.map

package/dist/naming/NamingStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamingStrategy.d.ts","sourceRoot":"","sources":["../../src/naming/NamingStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC9B,kEAAkE;IAClE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,0EAA0E;IAC1E,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,4EAA4E;IAC5E,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,0EAA0E;IAC1E,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,0EAA0E;IAC1E,gBAAgB,CACf,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,EACvD,QAAQ,EAAE,MAAM,GACd,MAAM,CAAC;IACV,gEAAgE;IAChE,kBAAkB,CACjB,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,EACvD,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACd,MAAM,CAAC;IACV,0DAA0D;IAC1D,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3D;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAC7D,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAOpC,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAIxC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIxC,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAI5C,gBAAgB,CACf,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,EACxD,QAAQ,EAAE,MAAM,GACd,MAAM;IAIT,kBAAkB,CACjB,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,EACxD,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACd,MAAM;IAIT,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CAK1D;AAED,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAE,cACN,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CASrE"}

package/dist/naming/NamingStrategy.js

@@ -0,0 +1,65 @@
+/**
+ * Naming Strategy — override the snake_case ↔ camelCase convention per-entity.
+ *
+ * Each entity class can declare `static namingStrategy = new MyStrategy()` to
+ * replace the default camelCase ↔ snake_case conversion with its own rules.
+ * Used to migrate legacy databases (e.g. PascalCase columns, prefixed tables,
+ * custom pivot table names).
+ *
+ *     class LegacyUser extends BaseEntity {
+ *       static namingStrategy = new SnakeCaseSingularStrategy()
+ *     }
+ *
+ * @implements Story 32.7
+ */
+import { camelToSnake, snakeToCamel } from "../utils/casing.js";
+/**
+ * Default strategy — camelCase TS properties, snake_case DB columns, plural
+ * snake_case table names, `<parent_name>_<parent_pk>` foreign keys.
+ */
+export class CamelCaseNamingStrategy {
+    tableName(className) {
+        // Default: snake_case + plural-s. Entities wanting non-default (e.g. irregular
+        // plurals like "people") should override via static `namingStrategy`.
+        const snake = camelToSnake(className);
+        return snake.endsWith("s") ? snake : `${snake}s`;
+    }
+    columnName(propertyName) {
+        return camelToSnake(propertyName);
+    }
+    propertyName(columnName) {
+        return snakeToCamel(columnName);
+    }
+    serializedName(propertyName) {
+        return propertyName;
+    }
+    relationLocalKey(_kind, parentPk) {
+        return parentPk;
+    }
+    relationForeignKey(_kind, parentClass, parentPk) {
+        return `${camelToSnake(parentClass)}_${parentPk}`;
+    }
+    relationPivotTable(aClass, bClass) {
+        // Sort alphabetically so `UserSkill` and `SkillUser` collapse to the same name.
+        const [x, y] = [camelToSnake(aClass), camelToSnake(bClass)].sort();
+        return `${x}_${y}`;
+    }
+}
+/** The default singleton — used when an entity doesn't override `static namingStrategy`. */
+export const defaultNamingStrategy = new CamelCaseNamingStrategy();
+/**
+ * Resolve the naming strategy for an entity class. Walks the prototype chain
+ * so subclasses inherit their parent's strategy unless they override.
+ */
+export function getNamingStrategy(entityClass) {
+    let current = entityClass;
+    while (current && current !== Function.prototype) {
+        const explicit = current
+            .namingStrategy;
+        if (explicit)
+            return explicit;
+        current = Object.getPrototypeOf(current);
+    }
+    return defaultNamingStrategy;
+}
+//# sourceMappingURL=NamingStrategy.js.map

package/dist/naming/NamingStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamingStrategy.js","sourceRoot":"","sources":["../../src/naming/NamingStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA2BhE;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IACnC,SAAS,CAAC,SAAiB;QAC1B,+EAA+E;QAC/E,sEAAsE;QACtE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,YAAoB;QAC9B,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAED,YAAY,CAAC,UAAkB;QAC9B,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,cAAc,CAAC,YAAoB;QAClC,OAAO,YAAY,CAAC;IACrB,CAAC;IAED,gBAAgB,CACf,KAAwD,EACxD,QAAgB;QAEhB,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,kBAAkB,CACjB,KAAwD,EACxD,WAAmB,EACnB,QAAgB;QAEhB,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,QAAQ,EAAE,CAAC;IACnD,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,MAAc;QAChD,gFAAgF;QAChF,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;IACpB,CAAC;CACD;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GACjC,IAAI,uBAAuB,EAAE,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACpD,IAAI,OAAO,GAAkB,WAAW,CAAC;IACzC,OAAO,OAAO,IAAI,OAAO,KAAK,QAAQ,CAAC,SAAS,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAI,OAA+C;aAC/D,cAAc,CAAC;QACjB,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC9B,CAAC"}

package/dist/query/QueryBuilder.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Fluent Query Builder — with advanced features (CTE, subqueries, unions, window functions).
+ *
+ * @implements FR31, FR32, FR33, FR36, FR37
+ */
+import { type AtlasDialect } from "./native.js";
+export type WhereOperator = "=" | "!=" | ">" | ">=" | "<" | "<=" | "LIKE" | "IN" | "NOT IN" | "IS NULL" | "IS NOT NULL";
+export interface WhereClause {
+    column: string;
+    operator: WhereOperator;
+    value: unknown;
+    type: "and" | "or";
+}
+export interface ExistsClause {
+    kind: "exists";
+    subquery: QueryBuilder;
+    type: "and" | "or";
+}
+export interface OrderByClause {
+    column: string;
+    direction: "asc" | "desc";
+}
+export interface CteDefinition {
+    name: string;
+    query: QueryBuilder | RawSql;
+}
+export interface QueryResult<T> {
+    data: T[];
+    total?: number;
+    page?: number;
+    perPage?: number;
+}
+/** Typed raw SQL with parameterized values. */
+export declare class RawSql {
+    readonly sql: string;
+    readonly params: unknown[];
+    constructor(sql: string, params?: unknown[]);
+    /** Tagged template literal for raw SQL with automatic parameterization. */
+    static sql(strings: TemplateStringsArray, ...values: unknown[]): RawSql;
+}
+/**
+ * Fluent query builder — type-safe, composable, with advanced features.
+ */
+export declare class QueryBuilder<_T = Record<string, unknown>> {
+    #private;
+    constructor(table: string, options?: {
+        dialect?: AtlasDialect;
+    });
+    /** SELECT DISTINCT. */
+    distinct(): this;
+    /** Select specific columns (supports expressions like 'COUNT(*) AS total'). */
+    select(...columns: string[]): this;
+    /** Add a WHERE condition. */
+    where(column: string, operatorOrValue: WhereOperator | unknown, value?: unknown): this;
+    /** Add an OR WHERE condition. */
+    orWhere(column: string, operatorOrValue: WhereOperator | unknown, value?: unknown): this;
+    /** WHERE column IN (values). */
+    whereIn(column: string, values: unknown[]): this;
+    /** WHERE column IS NULL. */
+    whereNull(column: string): this;
+    /** WHERE column IS NOT NULL. */
+    whereNotNull(column: string): this;
+    /** WHERE EXISTS (subquery). Subquery is deferred — toSQL() called at build time. */
+    whereExists(subquery: QueryBuilder): this;
+    /** GROUP BY columns. */
+    groupBy(...columns: string[]): this;
+    /** HAVING condition (used after GROUP BY). Supports aggregate expressions. */
+    having(column: string, operatorOrValue: WhereOperator | unknown, value?: unknown): this;
+    /** ORDER BY column. */
+    orderBy(column: string, direction?: "asc" | "desc"): this;
+    /** LIMIT results. */
+    limit(n: number): this;
+    /** OFFSET results. */
+    offset(n: number): this;
+    /** Paginate results. */
+    paginate(page: number, perPage?: number): this;
+    /** Eager-load a relation. */
+    preload(relation: string): this;
+    /** WITH (Common Table Expression). */
+    with(name: string, query: QueryBuilder | RawSql): this;
+    /** UNION with another query (wrapped in parentheses). */
+    union(query: QueryBuilder): this;
+    /** UNION ALL with another query (wrapped in parentheses). */
+    unionAll(query: QueryBuilder): this;
+    /** Build the SQL query string via the Rust compiler. */
+    toSQL(): {
+        sql: string;
+        params: unknown[];
+    };
+    /** Get the table name. */
+    getTable(): string;
+    /** Get preloaded relations. */
+    getPreloads(): string[];
+}
+//# sourceMappingURL=QueryBuilder.d.ts.map