@zudojs/database 0.0.1

package/dist/repository/repository.base.js

@@ -0,0 +1,248 @@
+import { DatabaseError } from "@zudojs/errors";
+/**
+ * Generic base repository implementation.
+ *
+ * Concrete repositories should extend this class and provide the
+ * appropriate Prisma delegate plus any domain-specific behavior.
+ */
+export class BaseRepository {
+    delegate;
+    modelName;
+    constructor(delegate, options = {}) {
+        if (!delegate) {
+            throw new TypeError("A repository delegate is required.");
+        }
+        this.delegate = delegate;
+        this.modelName = options.modelName ?? "DatabaseEntity";
+    }
+    /**
+     * Finds an entity by its primary identifier.
+     */
+    async findById(id, options) {
+        this.validateId(id);
+        return this.execute("findById", () => this.delegate.findUnique({
+            where: {
+                id,
+            },
+        }), options);
+    }
+    /**
+     * Finds the first entity matching a filter.
+     */
+    async findOne(filter, options) {
+        this.validateFilter(filter);
+        return this.execute("findOne", () => this.delegate.findFirst({
+            where: filter,
+        }), options);
+    }
+    /**
+     * Finds all entities matching a filter.
+     */
+    async findMany(filter, options) {
+        if (filter !== undefined) {
+            this.validateFilter(filter);
+        }
+        return this.execute("findMany", () => this.delegate.findMany({
+            where: filter,
+        }), options);
+    }
+    /**
+     * Finds entities using pagination and sorting.
+     */
+    async findPaginated(filter, options) {
+        if (filter !== undefined) {
+            this.validateFilter(filter);
+        }
+        const pagination = options?.pagination;
+        const page = normalizePage(pagination);
+        const limit = normalizeLimit(pagination);
+        const skip = (page - 1) * limit;
+        const [data, total] = await Promise.all([
+            this.execute("findMany", () => this.delegate.findMany({
+                where: filter,
+                skip,
+                take: limit,
+                orderBy: this.buildOrderBy(options?.sort),
+            }), options),
+            this.count(filter, options),
+        ]);
+        return {
+            data,
+            meta: createPaginationMeta(page, limit, total),
+        };
+    }
+    /**
+     * Creates a new entity.
+     */
+    async create(input, options) {
+        if (input === undefined || input === null) {
+            throw new DatabaseError(`Cannot create ${this.modelName}: input is required.`);
+        }
+        return this.execute("create", () => this.delegate.create({
+            data: input,
+        }), options);
+    }
+    /**
+     * Updates an entity by its identifier.
+     */
+    async update(id, input, options) {
+        this.validateId(id);
+        if (input === undefined || input === null) {
+            throw new DatabaseError(`Cannot update ${this.modelName}: input is required.`);
+        }
+        return this.execute("update", () => this.delegate.update({
+            where: {
+                id,
+            },
+            data: input,
+        }), options);
+    }
+    /**
+     * Deletes an entity by its identifier.
+     */
+    async delete(id, options) {
+        this.validateId(id);
+        await this.execute("delete", () => this.delegate.delete({
+            where: {
+                id,
+            },
+        }), options);
+    }
+    /**
+     * Checks whether an entity exists.
+     */
+    async exists(filter, options) {
+        this.validateFilter(filter);
+        const entity = await this.execute("exists", () => this.delegate.findFirst({
+            where: filter,
+        }), options);
+        return entity !== null;
+    }
+    /**
+     * Counts entities matching a filter.
+     */
+    async count(filter, options) {
+        if (filter !== undefined) {
+            this.validateFilter(filter);
+        }
+        return this.execute("count", () => this.delegate.count({
+            where: filter,
+        }), options);
+    }
+    /**
+     * Updates an entity if it exists, otherwise creates it.
+     */
+    async upsert(where, create, update, options) {
+        if (typeof this.delegate.upsert !== "function") {
+            throw new DatabaseError(`Upsert is not supported by ${this.modelName}.`);
+        }
+        return this.execute("upsert", () => this.delegate.upsert({
+            where,
+            create,
+            update,
+        }), options);
+    }
+    /**
+     * Executes a repository operation and normalizes database failures.
+     */
+    async execute(operation, callback, options) {
+        if (options?.signal?.aborted) {
+            throw new DatabaseError(`${this.modelName} ${operation} was aborted.`);
+        }
+        const startedAt = Date.now();
+        try {
+            const promise = callback();
+            if (options?.timeoutMs && options.timeoutMs > 0) {
+                return await withTimeout(promise, options.timeoutMs, `${this.modelName} ${operation} timed out.`);
+            }
+            return await promise;
+        }
+        catch (error) {
+            if (error instanceof DatabaseError) {
+                throw error;
+            }
+            throw new DatabaseError(error instanceof Error
+                ? error.message
+                : `${this.modelName} ${operation} failed.`, {
+                cause: error,
+                metadata: {
+                    model: this.modelName,
+                    operation,
+                    durationMs: Date.now() - startedAt,
+                    ...(options?.metadata ?? {}),
+                },
+            });
+        }
+    }
+    /**
+     * Validates an entity identifier.
+     */
+    validateId(id) {
+        if (id === undefined ||
+            id === null ||
+            (typeof id === "string" && id.trim().length === 0)) {
+            throw new DatabaseError(`${this.modelName} identifier is required.`);
+        }
+    }
+    /**
+     * Validates a repository filter.
+     */
+    validateFilter(filter) {
+        if (filter === undefined || filter === null) {
+            throw new DatabaseError(`${this.modelName} filter is required.`);
+        }
+    }
+    /**
+     * Converts generic sort definitions into Prisma-compatible orderBy.
+     */
+    buildOrderBy(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return sort.map((entry) => ({
+            [entry.field]: entry.direction,
+        }));
+    }
+}
+/**
+ * Creates pagination metadata.
+ */
+function createPaginationMeta(page, limit, total) {
+    const totalPages = total === 0 ? 0 : Math.ceil(total / limit);
+    return {
+        page,
+        limit,
+        total,
+        totalPages,
+        hasNextPage: totalPages > 0 && page < totalPages,
+        hasPreviousPage: page > 1 && totalPages > 0,
+    };
+}
+/**
+ * Normalizes a requested page number.
+ */
+function normalizePage(input) {
+    return Math.max(1, Math.floor(input?.page ?? 1));
+}
+/**
+ * Normalizes a requested page size.
+ */
+function normalizeLimit(input) {
+    return Math.min(100, Math.max(1, Math.floor(input?.limit ?? 20)));
+}
+/**
+ * Resolves an operation with a timeout.
+ */
+async function withTimeout(promise, timeoutMs, message) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new DatabaseError(message)), timeoutMs);
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=repository.base.js.map

package/dist/repository/repository.base.js.map

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

package/dist/seed/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Seeds
+ *
+ * Database seed runner with execution tracking.
+ */
+export { SeedRunner, createSeedRunner, normalizeSeeds, validateSeed, DEFAULT_SEED_TABLE, DEFAULT_SEED_LOCK, type Seed, type SeedRecord, type SeedResult, type SeedRunnerOptions, } from "./seed.runner.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seed/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/seed/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Seeds
+ *
+ * Database seed runner with execution tracking.
+ */
+export { SeedRunner, createSeedRunner, normalizeSeeds, validateSeed, DEFAULT_SEED_TABLE, DEFAULT_SEED_LOCK, } from "./seed.runner.js";
+//# sourceMappingURL=index.js.map

package/dist/seed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seed/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAKlB,MAAM,kBAAkB,CAAC"}

package/dist/seed/seed.runner.d.ts.map

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

package/dist/seed/seed.runner.js

@@ -0,0 +1,402 @@
+import { DatabaseError } from "@zudojs/errors";
+import { Prisma } from "@prisma/client";
+/**
+ * Default seed tracking table.
+ */
+export const DEFAULT_SEED_TABLE = "_seeds";
+/**
+ * Default seed advisory lock.
+ */
+export const DEFAULT_SEED_LOCK = "database:seeds";
+/**
+ * Runs and tracks database seeds.
+ */
+export class SeedRunner {
+    client;
+    seeds;
+    tableName;
+    lockKey;
+    constructor(client, seeds, options = {}) {
+        if (!client) {
+            throw new TypeError("A database client is required.");
+        }
+        this.client = client;
+        this.seeds = normalizeSeeds(seeds);
+        this.tableName = options.tableName ?? DEFAULT_SEED_TABLE;
+        this.lockKey = options.lockKey ?? DEFAULT_SEED_LOCK;
+        validateIdentifier(this.tableName, "seed table name");
+        validateLockKey(this.lockKey);
+    }
+    /**
+     * Returns the seed runner status.
+     */
+    async status() {
+        await this.ensureSeedTable();
+        const applied = await this.getAppliedSeeds();
+        const appliedNames = new Set(applied.map((seed) => seed.name));
+        const pending = this.seeds.filter((seed) => !appliedNames.has(seed.name));
+        return {
+            pending,
+            applied,
+        };
+    }
+    /**
+     * Executes every pending seed.
+     */
+    async run() {
+        await this.ensureSeedTable();
+        const applied = await this.getAppliedSeeds();
+        const appliedNames = new Set(applied.map((seed) => seed.name));
+        const pending = this.seeds.filter((seed) => !appliedNames.has(seed.name));
+        if (pending.length === 0) {
+            return {
+                applied: [],
+                skipped: applied,
+            };
+        }
+        const newlyApplied = [];
+        await this.client.transaction(async (transaction) => {
+            await this.acquireSeedLock(transaction);
+            for (const seed of pending) {
+                await this.executeSeed(transaction, seed);
+                const record = await this.recordSeed(transaction, seed);
+                newlyApplied.push(record);
+            }
+        });
+        return {
+            applied: newlyApplied,
+            skipped: applied,
+        };
+    }
+    /**
+     * Executes one named seed.
+     */
+    async runOne(name) {
+        validateSeedName(name);
+        await this.ensureSeedTable();
+        const seed = this.seeds.find((candidate) => candidate.name === name);
+        if (!seed) {
+            throw new DatabaseError(`Seed "${name}" is not registered.`);
+        }
+        const applied = await this.getAppliedSeeds();
+        const existing = applied.find((record) => record.name === name);
+        if (existing) {
+            return existing;
+        }
+        let result;
+        await this.client.transaction(async (transaction) => {
+            await this.acquireSeedLock(transaction);
+            const current = await this.getAppliedSeeds(transaction);
+            const alreadyApplied = current.find((record) => record.name === name);
+            if (alreadyApplied) {
+                result = alreadyApplied;
+                return;
+            }
+            await this.executeSeed(transaction, seed);
+            result = await this.recordSeed(transaction, seed);
+        });
+        if (!result) {
+            throw new DatabaseError(`Seed "${name}" did not produce an execution record.`);
+        }
+        return result;
+    }
+    /**
+     * Rolls back the most recently applied seed.
+     */
+    async rollback() {
+        await this.ensureSeedTable();
+        const applied = await this.getAppliedSeeds();
+        if (applied.length === 0) {
+            return null;
+        }
+        const latest = applied[applied.length - 1];
+        if (!latest) {
+            return null;
+        }
+        const seed = this.seeds.find((candidate) => candidate.name === latest.name);
+        if (!seed) {
+            throw new DatabaseError(`Seed "${latest.name}" is recorded as applied but is not registered.`);
+        }
+        if (!seed.rollback) {
+            throw new DatabaseError(`Seed "${seed.name}" does not define a rollback operation.`);
+        }
+        await this.client.transaction(async (transaction) => {
+            await this.acquireSeedLock(transaction);
+            await seed.rollback(transaction);
+            await this.deleteSeedRecord(transaction, seed.name);
+        });
+        return latest;
+    }
+    /**
+     * Rolls back every applied seed in reverse execution order.
+     */
+    async rollbackAll() {
+        await this.ensureSeedTable();
+        const applied = await this.getAppliedSeeds();
+        if (applied.length === 0) {
+            return [];
+        }
+        const rolledBack = [];
+        await this.client.transaction(async (transaction) => {
+            await this.acquireSeedLock(transaction);
+            for (let index = applied.length - 1; index >= 0; index -= 1) {
+                const record = applied[index];
+                if (!record) {
+                    continue;
+                }
+                const seed = this.seeds.find((candidate) => candidate.name === record.name);
+                if (!seed) {
+                    throw new DatabaseError(`Seed "${record.name}" is not registered.`);
+                }
+                if (!seed.rollback) {
+                    throw new DatabaseError(`Seed "${seed.name}" does not define a rollback operation.`);
+                }
+                await seed.rollback(transaction);
+                await this.deleteSeedRecord(transaction, seed.name);
+                rolledBack.push(record);
+            }
+        });
+        return rolledBack;
+    }
+    /**
+     * Creates the seed tracking table if it does not exist.
+     */
+    async ensureSeedTable() {
+        const table = quoteIdentifier(this.tableName);
+        try {
+            await this.client.executeRaw(Prisma.sql `
+          CREATE TABLE IF NOT EXISTS ${table} (
+            "name" VARCHAR(255) PRIMARY KEY,
+            "applied_at" TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+          )
+        `);
+        }
+        catch (error) {
+            throw new DatabaseError("Failed to initialize the seed tracking table.", {
+                cause: error,
+                metadata: {
+                    tableName: this.tableName,
+                },
+            });
+        }
+    }
+    /**
+     * Returns all applied seeds.
+     */
+    async getAppliedSeeds(transaction) {
+        const table = quoteIdentifier(this.tableName);
+        try {
+            let rows;
+            if (transaction) {
+                rows = await transaction.$queryRawUnsafe(`
+          SELECT
+            "name",
+            "applied_at"
+          FROM ${table}
+          ORDER BY "applied_at" ASC, "name" ASC
+        `);
+            }
+            else {
+                rows = await this.client.queryRaw(Prisma.sql `
+            SELECT
+              "name",
+              "applied_at"
+            FROM ${table}
+            ORDER BY "applied_at" ASC, "name" ASC
+          `);
+            }
+            return rows.map((row) => ({
+                name: row.name,
+                appliedAt: new Date(row.applied_at),
+            }));
+        }
+        catch (error) {
+            throw new DatabaseError("Failed to read seed execution history.", {
+                cause: error,
+                metadata: {
+                    tableName: this.tableName,
+                },
+            });
+        }
+    }
+    /**
+     * Executes a seed.
+     */
+    async executeSeed(transaction, seed) {
+        try {
+            await seed.run(transaction);
+        }
+        catch (error) {
+            throw new DatabaseError(`Seed "${seed.name}" failed.`, {
+                cause: error,
+                metadata: {
+                    name: seed.name,
+                    order: seed.order ?? 0,
+                },
+            });
+        }
+    }
+    /**
+     * Records a successfully executed seed.
+     */
+    async recordSeed(transaction, seed) {
+        const table = quoteIdentifier(this.tableName);
+        try {
+            await transaction.$executeRawUnsafe(`
+          INSERT INTO ${table}
+            ("name")
+          VALUES
+            ($1)
+        `, seed.name);
+            return {
+                name: seed.name,
+                appliedAt: new Date(),
+            };
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to record seed "${seed.name}".`, {
+                cause: error,
+                metadata: {
+                    name: seed.name,
+                },
+            });
+        }
+    }
+    /**
+     * Removes a seed execution record.
+     */
+    async deleteSeedRecord(transaction, name) {
+        const table = quoteIdentifier(this.tableName);
+        try {
+            await transaction.$executeRawUnsafe(`
+          DELETE FROM ${table}
+          WHERE "name" = $1
+        `, name);
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to remove seed record "${name}".`, {
+                cause: error,
+                metadata: {
+                    name,
+                },
+            });
+        }
+    }
+    /**
+     * Acquires the advisory lock used for seed execution.
+     */
+    async acquireSeedLock(transaction) {
+        try {
+            const lock = hashLockKey(this.lockKey);
+            await transaction.$executeRaw `
+        SELECT pg_advisory_xact_lock(
+          ${lock}
+        )
+      `;
+        }
+        catch (error) {
+            throw new DatabaseError("Failed to acquire the database seed lock.", {
+                cause: error,
+                metadata: {
+                    lockKey: this.lockKey,
+                },
+            });
+        }
+    }
+}
+/**
+ * Creates a seed runner.
+ */
+export function createSeedRunner(client, seeds, options) {
+    return new SeedRunner(client, seeds, options);
+}
+/**
+ * Validates and sorts seed definitions.
+ */
+export function normalizeSeeds(seeds) {
+    if (!Array.isArray(seeds)) {
+        throw new TypeError("Seeds must be an array.");
+    }
+    const normalized = seeds
+        .map((seed) => {
+        validateSeed(seed);
+        return Object.freeze({
+            ...seed,
+        });
+    })
+        .sort((first, second) => (first.order ?? 0) - (second.order ?? 0));
+    const names = new Set();
+    for (const seed of normalized) {
+        if (names.has(seed.name)) {
+            throw new TypeError(`Duplicate seed name: "${seed.name}".`);
+        }
+        names.add(seed.name);
+    }
+    return Object.freeze(normalized);
+}
+/**
+ * Validates one seed definition.
+ */
+export function validateSeed(seed) {
+    if (!seed || typeof seed !== "object") {
+        throw new TypeError("A seed definition is required.");
+    }
+    validateSeedName(seed.name);
+    if (seed.order !== undefined && !Number.isInteger(seed.order)) {
+        throw new TypeError(`Seed "${seed.name}" has an invalid order.`);
+    }
+    if (typeof seed.run !== "function") {
+        throw new TypeError(`Seed "${seed.name}" requires a run function.`);
+    }
+    if (seed.rollback !== undefined && typeof seed.rollback !== "function") {
+        throw new TypeError(`Seed "${seed.name}" has an invalid rollback function.`);
+    }
+}
+/**
+ * Validates a seed name.
+ */
+function validateSeedName(name) {
+    if (typeof name !== "string" || name.trim().length === 0) {
+        throw new TypeError("Seed name is required.");
+    }
+    if (name.length > 255) {
+        throw new TypeError("Seed name cannot exceed 255 characters.");
+    }
+}
+/**
+ * Validates an SQL identifier.
+ */
+function validateIdentifier(identifier, name) {
+    if (typeof identifier !== "string" ||
+        !/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) {
+        throw new TypeError(`Invalid ${name}: "${identifier}".`);
+    }
+}
+/**
+ * Validates an advisory lock key.
+ */
+function validateLockKey(lockKey) {
+    if (typeof lockKey !== "string" || lockKey.trim().length === 0) {
+        throw new TypeError("A database seed lock key is required.");
+    }
+}
+/**
+ * Quotes a validated SQL identifier.
+ */
+function quoteIdentifier(identifier) {
+    validateIdentifier(identifier, "identifier");
+    return `"${identifier}"`;
+}
+/**
+ * Generates a deterministic signed 64-bit advisory lock key.
+ */
+function hashLockKey(value) {
+    let hash = 1469598103934665603n;
+    const bytes = new TextEncoder().encode(value);
+    for (const byte of bytes) {
+        hash ^= BigInt(byte);
+        hash = BigInt.asIntN(64, hash * 1099511628211n);
+    }
+    return BigInt.asIntN(64, hash);
+}
+//# sourceMappingURL=seed.runner.js.map