@c9up/atlas 0.1.3 → 0.1.4

package/dist/BaseEntity.js

@@ -0,0 +1,420 @@
+/**
+ * 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
+ */
+import { MassAssignmentError } from "./errors.js";
+/** Symbol metadata key for the computed-property registry on an entity class. */
+export const COMPUTED_KEY = Symbol.for("atlas:computed");
+/** Symbol metadata key for the serialize-as / serializer overrides on columns. */
+export const COLUMN_SERIALIZE_KEY = Symbol.for("atlas:columnSerialize");
+/** Symbol property key used by entities to back-reference their hydrating repo. */
+export const REPO_REF = Symbol.for("atlas:repoRef");
+/**
+ * Internal reserved keys on BaseEntity that must never be treated as database
+ * columns or serialized as data. Used by dirty tracking and by `toJSON`.
+ */
+const INTERNAL_KEYS = new Set(["$extras", "$original"]);
+export class BaseEntity {
+    /** Accumulated domain events — dispatched on the event bus after DB commit. */
+    #domainEvents = [];
+    /**
+     * `$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 = {};
+    /**
+     * 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 = {};
+    /** Set a property dynamically (used by hydrate/create). */
+    setProp(key, value) {
+        this[key] = value;
+    }
+    /** Set an `$extras` value (used by `withCount`, pivot extras, aggregate loaders). */
+    setExtra(key, value) {
+        this.$extras[key] = value;
+    }
+    /** Get an `$extras` value with optional default. */
+    getExtra(key, defaultValue) {
+        return this.$extras[key] ?? defaultValue;
+    }
+    /**
+     * 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() {
+        const snapshot = {};
+        for (const key of Object.keys(this)) {
+            if (INTERNAL_KEYS.has(key))
+                continue;
+            snapshot[key] = this[key];
+        }
+        this.$original = snapshot;
+    }
+    /**
+     * 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() {
+        const diff = {};
+        for (const key of Object.keys(this)) {
+            if (INTERNAL_KEYS.has(key))
+                continue;
+            if (!this.#columnEqualsOriginal(key)) {
+                diff[key] = this[key];
+            }
+        }
+        return diff;
+    }
+    /**
+     * Reference-based dirty comparison for a single column — O(1), no allocation.
+     * `Object.is` handles NaN correctly and treats same-reference objects as
+     * equal (the core of the tracking contract — see `markAsPersisted` doc).
+     *
+     * The only structural exception is `Date`: two Date instances representing
+     * the same instant are compared by `getTime()` so hydration through a driver
+     * that rebuilds Date objects from ISO strings doesn't flag spurious dirty.
+     */
+    #columnEqualsOriginal(key) {
+        const current = this[key];
+        const original = this.$original[key];
+        if (current instanceof Date && original instanceof Date) {
+            return current.getTime() === original.getTime();
+        }
+        return Object.is(current, original);
+    }
+    /**
+     * Check whether a specific column is dirty, or whether any column is dirty
+     * when called without arguments.
+     */
+    isDirty(field) {
+        if (field === undefined)
+            return Object.keys(this.$dirty).length > 0;
+        return !this.#columnEqualsOriginal(field);
+    }
+    /**
+     * 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() {
+        for (const key of Object.keys(this.$dirty)) {
+            this[key] = this.$original[key];
+        }
+    }
+    /**
+     * Repository back-pointer set by `BaseRepository.#hydrate` so instances can
+     * self-refresh / lazy-load. Not serialized (symbol key).
+     *
+     * @implements Story 32.6
+     */
+    [REPO_REF];
+    /**
+     * Re-read this entity's row from the database and mutate THIS instance
+     * with the latest values. Throws if the row no longer exists.
+     */
+    async refresh() {
+        const repo = this[REPO_REF];
+        if (!repo)
+            throw new Error("refresh() requires the entity to be hydrated by a BaseRepository");
+        await repo.refresh(this);
+        return 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.
+     */
+    async fresh() {
+        const repo = this[REPO_REF];
+        if (!repo)
+            throw new Error("fresh() requires the entity to be hydrated by a BaseRepository");
+        return repo.fresh(this);
+    }
+    /**
+     * 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
+     */
+    async loadCount(relationName, alias) {
+        const repo = this[REPO_REF];
+        if (!repo)
+            throw new Error("loadCount() requires the entity to be hydrated by a BaseRepository");
+        await repo.loadCount(this, relationName, alias);
+        return 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
+     */
+    async loadAggregate(relationName, build) {
+        const repo = this[REPO_REF];
+        if (!repo)
+            throw new Error("loadAggregate() requires the entity to be hydrated by a BaseRepository");
+        await repo.loadAggregate(this, relationName, build);
+        return this;
+    }
+    /**
+     * Lazy-load a relation onto this entity after it was initially fetched.
+     *
+     * @implements Story 31.10
+     */
+    async load(relationName, callback) {
+        const repo = this[REPO_REF];
+        if (!repo)
+            throw new Error("load() requires the entity to be hydrated by a BaseRepository");
+        await repo.loadRelation(this, relationName, callback);
+        return 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) {
+        const repo = this[REPO_REF];
+        if (!repo)
+            throw new Error("related() requires the entity to be hydrated by a BaseRepository");
+        return repo.relatedProxy(this, relationName);
+    }
+    /**
+     * 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) {
+        const ctor = this.constructor;
+        if (ctor.fillable && ctor.guarded) {
+            throw new Error(`${ctor.name}: cannot declare both 'fillable' and 'guarded'`);
+        }
+        const allowed = (key) => {
+            if (ctor.fillable)
+                return ctor.fillable.includes(key);
+            if (ctor.guarded)
+                return !ctor.guarded.includes(key);
+            return true;
+        };
+        // Reset fillable fields that are absent from the payload. To keep dirty
+        // tracking honest, we restore the persisted `$original` reference (so the
+        // column reads as clean) for hydrated entities, and `delete` the property
+        // entirely for freshly-constructed ones (so `Object.keys(this)` doesn't
+        // list a phantom undefined column).
+        if (ctor.fillable) {
+            const hasOriginal = Object.keys(this.$original).length > 0;
+            for (const f of ctor.fillable) {
+                if (!(f in payload)) {
+                    if (hasOriginal && f in this.$original) {
+                        this[f] = this.$original[f];
+                    }
+                    else {
+                        delete this[f];
+                    }
+                }
+            }
+        }
+        for (const [k, v] of Object.entries(payload)) {
+            if (!allowed(k))
+                throw new MassAssignmentError(ctor.name, k);
+            this[k] = v;
+        }
+        return 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) {
+        const ctor = this.constructor;
+        if (ctor.fillable && ctor.guarded) {
+            throw new Error(`${ctor.name}: cannot declare both 'fillable' and 'guarded'`);
+        }
+        const allowed = (key) => {
+            if (ctor.fillable)
+                return ctor.fillable.includes(key);
+            if (ctor.guarded)
+                return !ctor.guarded.includes(key);
+            return true;
+        };
+        for (const [k, v] of Object.entries(payload)) {
+            if (!allowed(k)) {
+                throw new MassAssignmentError(ctor.name, k);
+            }
+            this[k] = v;
+        }
+        return this;
+    }
+    /** Add a domain event to be dispatched after save. */
+    addDomainEvent(name, data) {
+        this.#domainEvents.push({ name, data });
+    }
+    /** Get accumulated domain events (non-destructive read). */
+    getDomainEvents() {
+        return [...this.#domainEvents];
+    }
+    /** Clear accumulated domain events. */
+    clearDomainEvents() {
+        this.#domainEvents = [];
+    }
+    /** Get and clear accumulated domain events atomically. */
+    flushDomainEvents() {
+        const events = [...this.#domainEvents];
+        this.#domainEvents = [];
+        return events;
+    }
+    /** Check if entity has pending domain events. */
+    hasDomainEvents() {
+        return this.#domainEvents.length > 0;
+    }
+    /**
+     * 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() {
+        const ctor = this.constructor;
+        const hidden = new Set(ctor.hidden ?? []);
+        const visible = ctor.visible && ctor.visible.length > 0 ? new Set(ctor.visible) : null;
+        const serializeConfig = getColumnSerializeConfig(ctor);
+        const result = {};
+        // Regular columns (respecting hidden/visible + serialize overrides)
+        for (const key of Object.keys(this)) {
+            if (INTERNAL_KEYS.has(key))
+                continue;
+            if (visible && !visible.has(key))
+                continue;
+            if (hidden.has(key))
+                continue;
+            const cfg = serializeConfig[key];
+            if (cfg?.serializeAs === null)
+                continue; // explicit hide
+            const outKey = cfg?.serializeAs ?? key;
+            const rawValue = this[key];
+            result[outKey] = cfg?.serialize ? cfg.serialize(rawValue) : rawValue;
+        }
+        // Computed getters (@computed on the prototype)
+        const computed = getComputedProperties(ctor);
+        for (const prop of computed) {
+            if (visible && !visible.has(prop))
+                continue;
+            if (hidden.has(prop))
+                continue;
+            result[prop] = this[prop];
+        }
+        // $extras merged last — aggregates and pivot values show up alongside columns
+        return { ...result, ...this.$extras };
+    }
+    /**
+     * Pick / limit the fields returned by `toJSON()` for a single call.
+     *
+     *     entity.serialize({ fields: ['id', 'title'] })
+     */
+    serialize(options) {
+        const full = this.toJSON();
+        if (!options?.fields)
+            return full;
+        const picked = {};
+        for (const key of options.fields) {
+            if (key in full)
+                picked[key] = full[key];
+        }
+        return picked;
+    }
+}
+// ─── Computed / serialize metadata accessors ────────────────────
+/** Collect the names of all `@computed` getters declared on the prototype chain. */
+function getComputedProperties(ctor) {
+    const names = new Set();
+    let current = typeof ctor === "object" || typeof ctor === "function"
+        ? ctor
+        : null;
+    while (current && current !== Function.prototype) {
+        const list = Reflect.getOwnMetadata?.(COMPUTED_KEY, current);
+        if (list)
+            for (const n of list)
+                names.add(n);
+        current = Object.getPrototypeOf(current);
+    }
+    return [...names];
+}
+/** Collect the serialize config for every column declared on the prototype chain. */
+function getColumnSerializeConfig(ctor) {
+    const config = {};
+    let current = typeof ctor === "object" || typeof ctor === "function"
+        ? ctor
+        : null;
+    while (current && current !== Function.prototype) {
+        const map = Reflect.getOwnMetadata?.(COLUMN_SERIALIZE_KEY, current);
+        if (map)
+            Object.assign(config, map);
+        current = Object.getPrototypeOf(current);
+    }
+    return config;
+}
+// `equalsDeep` was intentionally removed with the move to reference-based
+// dirty tracking (Story 32.2 perf revision). The single comparison path is
+// `Object.is` in `#columnEqualsOriginal`, with `Date` as the only structural
+// exception. If you find yourself wanting a deep-equal here, reach for an
+// immutable update pattern at the call site instead — the framework does not
+// traverse object columns at save time by design.
+//# sourceMappingURL=BaseEntity.js.map

package/dist/BaseEntity.js.map

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

package/dist/BaseRepository.d.ts

@@ -0,0 +1,175 @@
+/**
+ * BaseRepository — Data Mapper ORM with typed CRUD, soft deletes, and domain events.
+ *
+ * @implements FR29, FR31, FR35
+ */
+import type { BaseEntity, DomainEvent, RelationProxy } from "./BaseEntity.js";
+import { ModelQuery } from "./ModelQuery.js";
+import { type AtlasDialect } from "./query/native.js";
+type EntityConstructor<T extends BaseEntity> = new () => T;
+/**
+ * String-keyed bag of values — covers the recurring DB-shaped objects:
+ * row dictionaries, parameter maps, JSON column blobs. Duplicated locally
+ * (mirror of `Dict` in `@c9up/ream`) to keep atlas import-graph agnostic.
+ */
+export type Dict<V = string> = Record<string, V>;
+/** Convenience alias for a DB row (column name → value). */
+export type Row = Dict<unknown>;
+/**
+ * Async database connection — matches the `AsyncDatabaseConnection` shape
+ * exposed by `AtlasProvider` (Rust-backed napi adapter). All BaseRepository
+ * I/O is async (`execute` for writes, `query` for reads). The legacy sync
+ * `prepare()` API was removed in favour of this surface to align with the
+ * actual binding produced by the provider.
+ *
+ * Drivers backed by `AsyncDatabaseConnection` (`createNapiConnection`)
+ * satisfy this interface out-of-the-box.
+ */
+export interface DatabaseConnection {
+    /** Run a write statement; returns rowsAffected. */
+    execute(sql: string, params?: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
+    /** Run a SELECT and return all rows. */
+    query<T = Row>(sql: string, params?: unknown[]): Promise<T[]>;
+}
+export declare class BaseRepository<T extends BaseEntity> {
+    #private;
+    /** Callback to dispatch domain events (set by framework integration). */
+    onDomainEvents?: (events: DomainEvent[]) => Promise<void>;
+    constructor(entityClass: EntityConstructor<T>, db: DatabaseConnection, options?: {
+        dialect?: AtlasDialect;
+    });
+    query(): ModelQuery<T>;
+    useTransaction(trx: DatabaseConnection): BaseRepository<T>;
+    find(id: string | number | bigint): Promise<T | null>;
+    findOrFail(id: string | number): Promise<T>;
+    findBy(column: string, value: unknown): Promise<T | null>;
+    all(): Promise<T[]>;
+    allWithTrashed(): Promise<T[]>;
+    onlyTrashed(): Promise<T[]>;
+    where(column: string, value: unknown): Promise<T[]>;
+    /**
+     * Build an entity from a plain object and persist it. Fires `beforeSave` →
+     * `beforeCreate` → INSERT → `afterCreate` → `afterSave`.
+     */
+    create(data: Partial<Record<string, unknown>>): Promise<T>;
+    /**
+     * Persist an entity. Insert if PK is missing or row doesn't exist, update
+     * otherwise. Fires `beforeSave` → (`beforeCreate` | `beforeUpdate`) → DB →
+     * (`afterCreate` | `afterUpdate`) → `afterSave`, then dispatches
+     * accumulated domain events through `onDomainEvents`.
+     *
+     * Race-safety: the `find(pk)` → branch decision has a TOCTOU window. If a
+     * concurrent save inserts the same PK between our `find` and our `#insert`,
+     * the INSERT hits a unique-key violation; we catch it and fall back to the
+     * UPDATE path. The race-loser still fires `beforeCreate` before the
+     * recovery (its hook ran once before the conflict surfaced) — design
+     * `beforeCreate` hooks to be idempotent or move side-effects into
+     * `afterCreate` / `afterSave` where they only fire on commit.
+     */
+    save(entity: T): Promise<void>;
+    /**
+     * Insert many rows in a single multi-row INSERT. Fires beforeSave/beforeCreate
+     * on each hydrated entity, then hydrates from the RETURNING clause (postgres +
+     * sqlite) before firing afterCreate/afterSave. On mysql, falls back to N single
+     * INSERTs (documented limitation).
+     *
+     * @implements Story 30.1 + 30.5
+     */
+    createMany(rows: Array<Partial<Record<string, unknown>>>): Promise<T[]>;
+    /**
+     * Persist many already-constructed entity instances. Same hooks + batching
+     * as `createMany`, but accepts prebuilt entities so dirty tracking works.
+     *
+     * @implements Story 30.5
+     */
+    saveMany(entities: T[]): Promise<T[]>;
+    /**
+     * Dialect-aware upsert. postgres + sqlite emit `ON CONFLICT DO UPDATE`; mysql
+     * emits `ON DUPLICATE KEY UPDATE`. Empty `updateColumns` = DO NOTHING.
+     *
+     * @implements Story 30.4
+     */
+    upsert(data: Record<string, unknown> | Array<Record<string, unknown>>, conflictColumns: string[], updateColumns?: string[]): Promise<number>;
+    /**
+     * Find a row matching `search` or create one merged with `defaults`.
+     *
+     * @implements Story 30.6
+     */
+    firstOrCreate(search: Record<string, unknown>, defaults?: Record<string, unknown>): Promise<T>;
+    /** Find a row or build an in-memory instance without persisting. */
+    firstOrNew(search: Record<string, unknown>, defaults?: Record<string, unknown>): Promise<T>;
+    /** Atomic find-or-update-or-insert. */
+    updateOrCreate(search: Record<string, unknown>, values: Record<string, unknown>): Promise<T>;
+    /** Delete the entity. Fires `beforeDelete` → DB → `afterDelete`. Soft-delete aware. */
+    delete(entity: T): Promise<void>;
+    /** Permanently delete (bypasses soft delete). Fires `beforeDelete` / `afterDelete` hooks. */
+    forceDelete(entity: T): Promise<void>;
+    restore(entity: T): Promise<void>;
+    updateById(id: string | number, data: Partial<Record<string, unknown>>): Promise<void>;
+    updateWhere(column: string, columnValue: unknown, data: Partial<Record<string, unknown>>): Promise<void>;
+    /**
+     * Atomically increment one or more columns on a single row.
+     * Emits `UPDATE … SET col = col + ? WHERE pk = ?` — no read-modify-write,
+     * safe under concurrent updates.
+     *
+     *     await repo.increment(userId, 'views', 1)
+     *     await repo.increment(userId, { balance: 10, credits: 5 })
+     *
+     * @implements Story 30.3
+     */
+    increment(id: string | number, column: string, amount?: number): Promise<void>;
+    increment(id: string | number, columns: Record<string, number>): Promise<void>;
+    /** Symmetrical to `increment` — emits `SET col = col - ?`. */
+    decrement(id: string | number, column: string, amount?: number): Promise<void>;
+    decrement(id: string | number, columns: Record<string, number>): Promise<void>;
+    raw(sql: string, ...params: unknown[]): Promise<T[]>;
+    getTableName(): string;
+    getPrimaryKeyColumn(): string;
+    /**
+     * Re-read the entity's row from the database and mutate the instance in place.
+     * Used by `entity.refresh()` — not normally called directly.
+     *
+     * @implements Story 32.6
+     */
+    refresh(entity: BaseEntity): Promise<void>;
+    /**
+     * Re-read the entity's row and return a NEW instance (the input is untouched).
+     *
+     * @implements Story 32.6
+     */
+    /**
+     * Lazy-load a relation count into `entity.$extras[alias ?? `${relationName}_count`]`.
+     * Uses `ModelQuery.withCount` with a restrictive `WHERE pk = ?` so it reads
+     * one entity's row back with the aggregate column attached.
+     *
+     * @implements Story 29.2
+     */
+    loadCount(entity: BaseEntity, relationName: string, alias?: string): Promise<void>;
+    /**
+     * Lazy-load a relation aggregate. The builder callback sets the aggregate via
+     * `.sum/.avg/.min/.max/.count` and the alias via `.as('name')`.
+     *
+     * @implements Story 29.2
+     */
+    loadAggregate(entity: BaseEntity, relationName: string, build: (q: unknown) => void): Promise<void>;
+    /**
+     * Lazy-load a relation onto an already-fetched entity. Re-uses the preload
+     * resolver by running a fresh query with `.where(pk = entity.pk).preload(...)`.
+     *
+     * @implements Story 31.10
+     */
+    loadRelation(entity: BaseEntity, relationName: string, callback?: (q: unknown) => void): Promise<void>;
+    /**
+     * Return a thin relation proxy bound to the given parent instance. Only
+     * `hasOne` / `hasMany` (and trivially `manyToMany` insert paths) are wired
+     * here; richer operations (attach/detach/sync) live in Story 31.7's proxy.
+     *
+     * @implements Story 31.5
+     */
+    relatedProxy(entity: BaseEntity, relationName: string): RelationProxy;
+    fresh(entity: T): Promise<T>;
+}
+export {};
+//# sourceMappingURL=BaseRepository.d.ts.map

package/dist/BaseRepository.d.ts.map

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