@danceroutine/tango-orm 0.1.0 → 1.0.0

package/dist/query/QuerySet.js

@@ -1,108 +0,0 @@
-import { InternalQNodeType } from './domain/internal/InternalQNodeType';
-import { InternalDirection } from './domain/internal/InternalDirection';
-import { QBuilder as Q } from './QBuilder';
-import { QueryCompiler } from './compiler';
-/**
- * Django-inspired query builder for constructing and executing database queries.
- * Provides a fluent API for filtering, ordering, pagination, and eager loading.
- *
- * @template T - The model type being queried
- *
- * @example
- * ```typescript
- * const users = await repository
- *   .query()
- *   .filter({ active: true })
- *   .filter(Q.or({ role: 'admin' }, { role: 'moderator' }))
- *   .orderBy('-createdAt')
- *   .limit(10)
- *   .fetchAll();
- * ```
- */
-export class QuerySet {
-    repo;
-    state;
-    static BRAND = 'tango.orm.query_set';
-    __tangoBrand = QuerySet.BRAND;
-    static isQuerySet(value) {
-        return (typeof value === 'object' &&
-            value !== null &&
-            value.__tangoBrand === QuerySet.BRAND);
-    }
-    constructor(repo, state = {}) {
-        this.repo = repo;
-        this.state = state;
-    }
-    filter(q) {
-        const wrapped = q.kind
-            ? q
-            : { kind: InternalQNodeType.ATOM, where: q };
-        const merged = this.state.q ? Q.and(this.state.q, wrapped) : wrapped;
-        return new QuerySet(this.repo, { ...this.state, q: merged });
-    }
-    exclude(q) {
-        const wrapped = q.kind
-            ? q
-            : { kind: InternalQNodeType.ATOM, where: q };
-        const excludes = [...(this.state.excludes ?? []), wrapped];
-        return new QuerySet(this.repo, { ...this.state, excludes });
-    }
-    orderBy(...tokens) {
-        const order = tokens.map((t) => {
-            const str = String(t);
-            if (str.startsWith('-')) {
-                return { by: str.slice(1), dir: InternalDirection.DESC };
-            }
-            return { by: t, dir: InternalDirection.ASC };
-        });
-        return new QuerySet(this.repo, { ...this.state, order });
-    }
-    limit(n) {
-        return new QuerySet(this.repo, { ...this.state, limit: n });
-    }
-    offset(n) {
-        return new QuerySet(this.repo, { ...this.state, offset: n });
-    }
-    select(cols) {
-        return new QuerySet(this.repo, { ...this.state, select: cols });
-    }
-    selectRelated(...rels) {
-        return new QuerySet(this.repo, { ...this.state, selectRelated: rels });
-    }
-    prefetchRelated(...rels) {
-        return new QuerySet(this.repo, { ...this.state, prefetchRelated: rels });
-    }
-    async fetch(shape) {
-        const compiler = new QueryCompiler(this.repo.meta, this.repo.dialect);
-        const compiled = compiler.compile(this.state);
-        const rows = await this.repo.run(compiled);
-        const results = !shape
-            ? rows
-            : typeof shape === 'function'
-                ? rows.map(shape)
-                : rows.map((r) => shape.parse(r));
-        return {
-            results,
-            nextCursor: null,
-        };
-    }
-    async fetchOne(shape) {
-        const limited = this.limit(1);
-        const result = await limited.fetch(shape);
-        return result.results[0] ?? null;
-    }
-    async count() {
-        const compiler = new QueryCompiler(this.repo.meta, this.repo.dialect);
-        const compiled = compiler.compile({
-            ...this.state,
-            select: ['COUNT(*) as count'],
-        });
-        const countQuery = compiled.sql.replace(/SELECT .+ FROM/, 'SELECT COUNT(*) as count FROM');
-        const rows = await this.repo.client.query(countQuery, compiled.params);
-        return Number(rows.rows[0]?.count ?? 0);
-    }
-    async exists() {
-        const count = await this.count();
-        return count > 0;
-    }
-}

package/dist/query/compiler/QueryCompiler.js

@@ -1,183 +0,0 @@
-import { InternalDialect } from '../domain/internal/InternalDialect';
-import { InternalQNodeType } from '../domain/internal/InternalQNodeType';
-import { InternalLookupType } from '../domain/internal/InternalLookupType';
-export class QueryCompiler {
-    meta;
-    dialect;
-    static BRAND = 'tango.orm.query_compiler';
-    __tangoBrand = QueryCompiler.BRAND;
-    static isQueryCompiler(value) {
-        return (typeof value === 'object' &&
-            value !== null &&
-            value.__tangoBrand === QueryCompiler.BRAND);
-    }
-    constructor(meta, dialect = InternalDialect.POSTGRES) {
-        this.meta = meta;
-        this.dialect = dialect;
-    }
-    compile(state) {
-        const whereParts = [];
-        const params = [];
-        if (state.q) {
-            const result = this.compileQNode(state.q, params.length + 1);
-            if (result.sql) {
-                whereParts.push(result.sql);
-                params.push(...result.params);
-            }
-        }
-        state.excludes?.forEach((exclude) => {
-            const result = this.compileQNode({ kind: InternalQNodeType.NOT, node: exclude }, params.length + 1);
-            if (result.sql) {
-                whereParts.push(result.sql);
-                params.push(...result.params);
-            }
-        });
-        const select = state.select?.map(String).join(', ') || `${this.meta.table}.*`;
-        const joins = (state.selectRelated ?? [])
-            .map((rel) => {
-            const r = this.meta.relations?.[rel];
-            if (!r || r.kind !== 'belongsTo') {
-                return '';
-            }
-            return `LEFT JOIN ${r.table} ${r.alias} ON ${r.alias}.${r.targetPk} = ${this.meta.table}.${r.localKey}`;
-        })
-            .filter(Boolean)
-            .join(' ');
-        const whereSQL = whereParts.length ? ` WHERE ${whereParts.join(' AND ')}` : '';
-        const orderSQL = ` ORDER BY ${state.order?.length
-            ? state.order.map((o) => `${this.meta.table}.${String(o.by)} ${o.dir.toUpperCase()}`).join(', ')
-            : `${this.meta.table}.${this.meta.pk} ASC`}`;
-        const limitSQL = state.limit ? ` LIMIT ${state.limit}` : '';
-        const offsetSQL = state.offset ? ` OFFSET ${state.offset}` : '';
-        const sql = `SELECT ${select} FROM ${this.meta.table}${joins ? ' ' + joins : ''}${whereSQL}${orderSQL}${limitSQL}${offsetSQL}`;
-        return { sql, params };
-    }
-    compileQNode(node, paramIndex) {
-        switch (node.kind) {
-            case InternalQNodeType.ATOM:
-                return this.compileAtom(node.where || {}, paramIndex);
-            case InternalQNodeType.AND:
-                return this.compileAnd(node.nodes || [], paramIndex);
-            case InternalQNodeType.OR:
-                return this.compileOr(node.nodes || [], paramIndex);
-            case InternalQNodeType.NOT:
-                return this.compileNot(node.node, paramIndex);
-            default:
-                return { sql: '', params: [] };
-        }
-    }
-    compileAtom(where, paramIndex) {
-        const entries = Object.entries(where).filter(([, value]) => value !== undefined);
-        const { parts, params } = entries.reduce((accumulator, [key, value]) => {
-            const [field, lookup = InternalLookupType.EXACT] = String(key).split('__');
-            const col = `${this.meta.table}.${field}`;
-            const idx = paramIndex + accumulator.params.length;
-            const clause = this.lookupToSQL(col, lookup, value, idx);
-            accumulator.parts.push(clause.sql);
-            accumulator.params.push(...clause.params);
-            return accumulator;
-        }, { parts: [], params: [] });
-        return {
-            sql: parts.length ? `(${parts.join(' AND ')})` : '',
-            params,
-        };
-    }
-    compileAnd(nodes, paramIndex) {
-        const { parts, params } = nodes.reduce((accumulator, node) => {
-            const result = this.compileQNode(node, paramIndex + accumulator.params.length);
-            if (result.sql) {
-                accumulator.parts.push(result.sql);
-                accumulator.params.push(...result.params);
-            }
-            return accumulator;
-        }, { parts: [], params: [] });
-        return {
-            sql: parts.length ? `(${parts.join(' AND ')})` : '',
-            params,
-        };
-    }
-    compileOr(nodes, paramIndex) {
-        const { parts, params } = nodes.reduce((accumulator, node) => {
-            const result = this.compileQNode(node, paramIndex + accumulator.params.length);
-            if (result.sql) {
-                accumulator.parts.push(result.sql);
-                accumulator.params.push(...result.params);
-            }
-            return accumulator;
-        }, { parts: [], params: [] });
-        return {
-            sql: parts.length ? `(${parts.join(' OR ')})` : '',
-            params,
-        };
-    }
-    compileNot(node, paramIndex) {
-        const result = this.compileQNode(node, paramIndex);
-        if (!result.sql) {
-            return { sql: '', params: [] };
-        }
-        return {
-            sql: `(NOT ${result.sql})`,
-            params: result.params,
-        };
-    }
-    lookupToSQL(col, lookup, value, paramIndex) {
-        const placeholder = this.dialect === InternalDialect.POSTGRES ? `$${paramIndex}` : '?';
-        const normalized = this.normalizeParam(value);
-        switch (lookup) {
-            case InternalLookupType.EXACT:
-                if (value === null) {
-                    return { sql: `${col} IS NULL`, params: [] };
-                }
-                return { sql: `${col} = ${placeholder}`, params: [normalized] };
-            case InternalLookupType.LT:
-                return { sql: `${col} < ${placeholder}`, params: [normalized] };
-            case InternalLookupType.LTE:
-                return { sql: `${col} <= ${placeholder}`, params: [normalized] };
-            case InternalLookupType.GT:
-                return { sql: `${col} > ${placeholder}`, params: [normalized] };
-            case InternalLookupType.GTE:
-                return { sql: `${col} >= ${placeholder}`, params: [normalized] };
-            case InternalLookupType.IN: {
-                const arr = (Array.isArray(value) ? value : [value]).map((entry) => this.normalizeParam(entry));
-                if (arr.length === 0) {
-                    return { sql: '1=0', params: [] };
-                }
-                const placeholders = this.dialect === InternalDialect.POSTGRES
-                    ? arr.map((_, i) => `$${paramIndex + i}`).join(', ')
-                    : arr.map(() => '?').join(', ');
-                return { sql: `${col} IN (${placeholders})`, params: arr };
-            }
-            case InternalLookupType.ISNULL:
-                return { sql: value ? `${col} IS NULL` : `${col} IS NOT NULL`, params: [] };
-            case InternalLookupType.CONTAINS:
-                return { sql: `${col} LIKE ${placeholder}`, params: [`%${value}%`] };
-            case InternalLookupType.ICONTAINS: {
-                const lowerCol = this.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`;
-                const lowerValue = String(value).toLowerCase();
-                return { sql: `${lowerCol} LIKE ${placeholder}`, params: [`%${lowerValue}%`] };
-            }
-            case InternalLookupType.STARTSWITH:
-                return { sql: `${col} LIKE ${placeholder}`, params: [`${value}%`] };
-            case InternalLookupType.ISTARTSWITH: {
-                const lowerCol = this.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`;
-                const lowerValue = String(value).toLowerCase();
-                return { sql: `${lowerCol} LIKE ${placeholder}`, params: [`${lowerValue}%`] };
-            }
-            case InternalLookupType.ENDSWITH:
-                return { sql: `${col} LIKE ${placeholder}`, params: [`%${value}`] };
-            case InternalLookupType.IENDSWITH: {
-                const lowerCol = this.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`;
-                const lowerValue = String(value).toLowerCase();
-                return { sql: `${lowerCol} LIKE ${placeholder}`, params: [`%${lowerValue}`] };
-            }
-            default:
-                throw new Error(`Unknown lookup: ${lookup}`);
-        }
-    }
-    normalizeParam(value) {
-        if (this.dialect === InternalDialect.SQLITE && typeof value === 'boolean') {
-            return value ? 1 : 0;
-        }
-        return value;
-    }
-}

package/dist/query/domain/CompiledQuery.js

@@ -1 +0,0 @@
-export {};

package/dist/query/domain/WhereClause.js

@@ -1 +0,0 @@
-export {};

package/dist/query-CQbvLeuh.js

@@ -1,21 +0,0 @@
-import { __export } from "./chunk-DLY2FNSh.js";
-import { QBuilder, QueryCompiler, QuerySet, compiler_exports } from "./QuerySet-BzR5QzGi.js";
-
-//#region src/query/domain/index.ts
-var domain_exports = {};
-
-//#endregion
-//#region src/query/index.ts
-var query_exports = {};
-__export(query_exports, {
-	Q: () => QBuilder,
-	QBuilder: () => QBuilder,
-	QueryCompiler: () => QueryCompiler,
-	QuerySet: () => QuerySet,
-	compiler: () => compiler_exports,
-	domain: () => domain_exports
-});
-
-//#endregion
-export { domain_exports, query_exports };
-//# sourceMappingURL=query-CQbvLeuh.js.map

package/dist/query-CQbvLeuh.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"query-CQbvLeuh.js","names":[],"sources":["../src/query/domain/index.ts","../src/query/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { CompiledQuery } from './CompiledQuery';\nexport type { Dialect } from './Dialect';\nexport type { Direction } from './Direction';\nexport type { FilterInput } from './FilterInput';\nexport type { FilterKey } from './FilterKey';\nexport type { FilterValue } from './FilterValue';\nexport type { LookupType } from './LookupType';\nexport type { OrderSpec } from './OrderSpec';\nexport type { OrderToken } from './OrderToken';\nexport type { QNode } from './QNode';\nexport type { QueryResult } from './QueryResult';\nexport type { QuerySetState } from './QuerySetState';\nexport type { RelationMeta } from './RelationMeta';\nexport type { RepositoryMeta as RepoMeta } from './RepositoryMeta';\nexport type { WhereClause } from './WhereClause';\n","/**\n * Domain boundary barrel: exposes namespaced exports for Django-style drill-down\n * imports and curated flat exports for TS-native ergonomics.\n */\n\nexport * as compiler from './compiler/index';\nexport * as domain from './domain/index';\n\nexport type * from './domain/index';\nexport type { RepoMeta } from './domain/index';\nexport { QuerySet } from './QuerySet';\nexport type { RepositoryLike } from './QuerySet';\nexport { QBuilder, QBuilder as Q } from './QBuilder';\nexport { QueryCompiler } from './compiler/index';\n"],"mappings":""}

package/dist/repository/Repository.d.ts

@@ -1,40 +0,0 @@
-import type { DBClient } from '../connection/clients/DBClient';
-import { QuerySet } from '../query/QuerySet';
-import type { RepositoryMeta } from '../query/domain/RepositoryMeta';
-/**
- * Base repository class providing CRUD operations and query building capabilities.
- * Extend this class to create model-specific repositories with custom business logic.
- *
- * @template T - The model type this repository manages
- *
- * @example
- * ```typescript
- * class UserRepository extends Repository<User> {
- *   meta = {
- *     table: 'users',
- *     pk: 'id',
- *     columns: { id: 'int', email: 'text', name: 'text' },
- *   };
- *
- *   async findByEmail(email: string): Promise<User | null> {
- *     return this.query().filter({ email }).fetchOne();
- *   }
- * }
- * ```
- */
-export declare abstract class Repository<T extends Record<string, unknown>> {
-    static readonly BRAND: "tango.orm.repository";
-    readonly __tangoBrand: typeof Repository.BRAND;
-    abstract meta: RepositoryMeta;
-    protected client: DBClient;
-    protected dialect: 'postgres' | 'sqlite';
-    static isRepository<T extends Record<string, unknown>>(value: unknown): value is Repository<T>;
-    constructor(client: DBClient, dialect?: 'postgres' | 'sqlite');
-    query(): QuerySet<T>;
-    findById(id: T[keyof T]): Promise<T | null>;
-    getOrThrow(id: T[keyof T]): Promise<T>;
-    create(input: Partial<T>): Promise<T>;
-    update(id: T[keyof T], patch: Partial<T>): Promise<T>;
-    delete(id: T[keyof T]): Promise<void>;
-    bulkCreate(inputs: Partial<T>[]): Promise<T[]>;
-}

package/dist/repository/Repository.js

@@ -1,100 +0,0 @@
-import { NotFoundError } from '@danceroutine/tango-core';
-import { QuerySet } from '../query/QuerySet';
-/**
- * Base repository class providing CRUD operations and query building capabilities.
- * Extend this class to create model-specific repositories with custom business logic.
- *
- * @template T - The model type this repository manages
- *
- * @example
- * ```typescript
- * class UserRepository extends Repository<User> {
- *   meta = {
- *     table: 'users',
- *     pk: 'id',
- *     columns: { id: 'int', email: 'text', name: 'text' },
- *   };
- *
- *   async findByEmail(email: string): Promise<User | null> {
- *     return this.query().filter({ email }).fetchOne();
- *   }
- * }
- * ```
- */
-export class Repository {
-    static BRAND = 'tango.orm.repository';
-    __tangoBrand = Repository.BRAND;
-    client;
-    dialect;
-    static isRepository(value) {
-        return (typeof value === 'object' &&
-            value !== null &&
-            value.__tangoBrand === Repository.BRAND);
-    }
-    constructor(client, dialect = 'postgres') {
-        this.client = client;
-        this.dialect = dialect;
-    }
-    query() {
-        return new QuerySet({
-            meta: this.meta,
-            client: this.client,
-            dialect: this.dialect,
-            run: async (compiled) => {
-                const result = await this.client.query(compiled.sql, compiled.params);
-                return result.rows;
-            },
-        }, {});
-    }
-    async findById(id) {
-        const filter = { [this.meta.pk]: id };
-        const result = await this.query().filter(filter).fetchOne();
-        return result;
-    }
-    async getOrThrow(id) {
-        const result = await this.findById(id);
-        if (!result) {
-            throw new NotFoundError(`${this.meta.table} with ${this.meta.pk}=${String(id)} not found`);
-        }
-        return result;
-    }
-    async create(input) {
-        const keys = Object.keys(input);
-        const values = Object.values(input);
-        const placeholder = this.dialect === 'postgres' ? keys.map((_, i) => `$${i + 1}`).join(', ') : keys.map(() => '?').join(', ');
-        const sql = `INSERT INTO ${this.meta.table} (${keys.join(', ')}) VALUES (${placeholder}) RETURNING *`;
-        const result = await this.client.query(sql, values);
-        return result.rows[0];
-    }
-    async update(id, patch) {
-        const keys = Object.keys(patch);
-        const values = Object.values(patch);
-        const sets = this.dialect === 'postgres'
-            ? keys.map((k, i) => `${k} = $${i + 1}`).join(', ')
-            : keys.map((k) => `${k} = ?`).join(', ');
-        const whereParam = this.dialect === 'postgres' ? `$${keys.length + 1}` : '?';
-        const sql = `UPDATE ${this.meta.table} SET ${sets} WHERE ${this.meta.pk} = ${whereParam} RETURNING *`;
-        const result = await this.client.query(sql, [...values, id]);
-        return result.rows[0];
-    }
-    async delete(id) {
-        const placeholder = this.dialect === 'postgres' ? '$1' : '?';
-        const sql = `DELETE FROM ${this.meta.table} WHERE ${this.meta.pk} = ${placeholder}`;
-        await this.client.query(sql, [id]);
-    }
-    async bulkCreate(inputs) {
-        if (inputs.length === 0)
-            return [];
-        const keys = Object.keys(inputs[0]);
-        const valueRows = inputs.map((input) => Object.values(input));
-        const placeholders = this.dialect === 'postgres'
-            ? valueRows
-                .map((_, rowIdx) => `(${keys.map((_, colIdx) => `$${rowIdx * keys.length + colIdx + 1}`).join(', ')})`)
-                .join(', ')
-            : valueRows.map(() => `(${keys.map(() => '?').join(', ')})`).join(', ');
-        const sql = `INSERT INTO ${this.meta.table} (${keys.join(', ')}) VALUES ${placeholders} RETURNING *`;
-        const allValues = valueRows.flat();
-        const result = await this.client.query(sql, allValues);
-        return result.rows;
-    }
-}

package/dist/repository/index.d.ts

@@ -1,4 +0,0 @@
-/**
- * Domain boundary barrel: centralizes this subdomain's public contract.
- */
-export { Repository } from './Repository';

package/dist/repository/index.js

@@ -1,4 +0,0 @@
-import "../QuerySet-BzR5QzGi.js";
-import { Repository } from "../repository-DaRvsfjs.js";
-
-export { Repository };

package/dist/repository-DaRvsfjs.js

@@ -1,78 +0,0 @@
-import { __export } from "./chunk-DLY2FNSh.js";
-import { QuerySet } from "./QuerySet-BzR5QzGi.js";
-
-//#region src/repository/Repository.ts
-var Repository = class Repository {
-	static BRAND = "tango.orm.repository";
-	__tangoBrand = Repository.BRAND;
-	client;
-	dialect;
-	static isRepository(value) {
-		return typeof value === "object" && value !== null && value.__tangoBrand === Repository.BRAND;
-	}
-	constructor(client, dialect = "postgres") {
-		this.client = client;
-		this.dialect = dialect;
-	}
-	query() {
-		return new QuerySet({
-			meta: this.meta,
-			client: this.client,
-			dialect: this.dialect,
-			run: async (compiled) => {
-				const result = await this.client.query(compiled.sql, compiled.params);
-				return result.rows;
-			}
-		}, {});
-	}
-	async findById(id) {
-		const result = await this.query().filter({ [this.meta.pk]: id }).fetchOne();
-		return result;
-	}
-	async getOrThrow(id) {
-		const result = await this.findById(id);
-		if (!result) throw new Error(`${this.meta.table} with ${this.meta.pk}=${String(id)} not found`);
-		return result;
-	}
-	async create(input) {
-		const keys = Object.keys(input);
-		const values = Object.values(input);
-		const placeholder = this.dialect === "postgres" ? keys.map((_, i) => `$${i + 1}`).join(", ") : keys.map(() => "?").join(", ");
-		const sql = `INSERT INTO ${this.meta.table} (${keys.join(", ")}) VALUES (${placeholder}) RETURNING *`;
-		const result = await this.client.query(sql, values);
-		return result.rows[0];
-	}
-	async update(id, patch) {
-		const keys = Object.keys(patch);
-		const values = Object.values(patch);
-		const sets = this.dialect === "postgres" ? keys.map((k, i) => `${k} = $${i + 1}`).join(", ") : keys.map((k) => `${k} = ?`).join(", ");
-		const whereParam = this.dialect === "postgres" ? `$${keys.length + 1}` : "?";
-		const sql = `UPDATE ${this.meta.table} SET ${sets} WHERE ${this.meta.pk} = ${whereParam} RETURNING *`;
-		const result = await this.client.query(sql, [...values, id]);
-		return result.rows[0];
-	}
-	async delete(id) {
-		const placeholder = this.dialect === "postgres" ? "$1" : "?";
-		const sql = `DELETE FROM ${this.meta.table} WHERE ${this.meta.pk} = ${placeholder}`;
-		await this.client.query(sql, [id]);
-	}
-	async bulkCreate(inputs) {
-		if (inputs.length === 0) return [];
-		const keys = Object.keys(inputs[0]);
-		const valueRows = inputs.map((input) => Object.values(input));
-		const placeholders = this.dialect === "postgres" ? valueRows.map((_, rowIdx) => `(${keys.map((_$1, colIdx) => `$${rowIdx * keys.length + colIdx + 1}`).join(", ")})`).join(", ") : valueRows.map(() => `(${keys.map(() => "?").join(", ")})`).join(", ");
-		const sql = `INSERT INTO ${this.meta.table} (${keys.join(", ")}) VALUES ${placeholders} RETURNING *`;
-		const allValues = valueRows.flat();
-		const result = await this.client.query(sql, allValues);
-		return result.rows;
-	}
-};
-
-//#endregion
-//#region src/repository/index.ts
-var repository_exports = {};
-__export(repository_exports, { Repository: () => Repository });
-
-//#endregion
-export { Repository, repository_exports };
-//# sourceMappingURL=repository-DaRvsfjs.js.map

package/dist/repository-DaRvsfjs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"repository-DaRvsfjs.js","names":["value: unknown","client: DBClient","dialect: 'postgres' | 'sqlite'","id: T[keyof T]","input: Partial<T>","patch: Partial<T>","inputs: Partial<T>[]"],"sources":["../src/repository/Repository.ts","../src/repository/index.ts"],"sourcesContent":["import type { DBClient } from '../connection/clients/DBClient';\nimport { QuerySet } from '../query/QuerySet';\nimport type { RepositoryMeta } from '../query/domain/RepositoryMeta';\n\n/**\n * Base repository class providing CRUD operations and query building capabilities.\n * Extend this class to create model-specific repositories with custom business logic.\n *\n * @template T - The model type this repository manages\n *\n * @example\n * ```typescript\n * class UserRepository extends Repository<User> {\n *   meta = {\n *     table: 'users',\n *     pk: 'id',\n *     columns: { id: 'int', email: 'text', name: 'text' },\n *   };\n *\n *   async findByEmail(email: string): Promise<User | null> {\n *     return this.query().filter({ email }).fetchOne();\n *   }\n * }\n * ```\n */\nexport abstract class Repository<T extends Record<string, any>> {\n    static readonly BRAND = 'tango.orm.repository' as const;\n    readonly __tangoBrand: typeof Repository.BRAND = Repository.BRAND;\n    abstract meta: RepositoryMeta;\n    protected client: DBClient;\n    protected dialect: 'postgres' | 'sqlite';\n\n    static isRepository<T extends Record<string, any>>(value: unknown): value is Repository<T> {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === Repository.BRAND\n        );\n    }\n\n    constructor(client: DBClient, dialect: 'postgres' | 'sqlite' = 'postgres') {\n        this.client = client;\n        this.dialect = dialect;\n    }\n\n    query(): QuerySet<T> {\n        return new QuerySet<T>(\n            {\n                meta: this.meta,\n                client: this.client,\n                dialect: this.dialect,\n                run: async (compiled) => {\n                    const result = await this.client.query<T>(compiled.sql, compiled.params);\n                    return result.rows;\n                },\n            },\n            {}\n        );\n    }\n\n    async findById(id: T[keyof T]): Promise<T | null> {\n        const result = await this.query()\n            .filter({ [this.meta.pk]: id } as any)\n            .fetchOne();\n        return result;\n    }\n\n    async getOrThrow(id: T[keyof T]): Promise<T> {\n        const result = await this.findById(id);\n        if (!result) {\n            throw new Error(`${this.meta.table} with ${this.meta.pk}=${String(id)} not found`);\n        }\n        return result;\n    }\n\n    async create(input: Partial<T>): Promise<T> {\n        const keys = Object.keys(input);\n        const values = Object.values(input);\n\n        const placeholder =\n            this.dialect === 'postgres' ? keys.map((_, i) => `$${i + 1}`).join(', ') : keys.map(() => '?').join(', ');\n\n        const sql = `INSERT INTO ${this.meta.table} (${keys.join(', ')}) VALUES (${placeholder}) RETURNING *`;\n\n        const result = await this.client.query<T>(sql, values);\n        return result.rows[0]!;\n    }\n\n    async update(id: T[keyof T], patch: Partial<T>): Promise<T> {\n        const keys = Object.keys(patch);\n        const values = Object.values(patch);\n\n        const sets =\n            this.dialect === 'postgres'\n                ? keys.map((k, i) => `${k} = $${i + 1}`).join(', ')\n                : keys.map((k) => `${k} = ?`).join(', ');\n\n        const whereParam = this.dialect === 'postgres' ? `$${keys.length + 1}` : '?';\n\n        const sql = `UPDATE ${this.meta.table} SET ${sets} WHERE ${this.meta.pk} = ${whereParam} RETURNING *`;\n\n        const result = await this.client.query<T>(sql, [...values, id]);\n        return result.rows[0]!;\n    }\n\n    async delete(id: T[keyof T]): Promise<void> {\n        const placeholder = this.dialect === 'postgres' ? '$1' : '?';\n        const sql = `DELETE FROM ${this.meta.table} WHERE ${this.meta.pk} = ${placeholder}`;\n        await this.client.query(sql, [id]);\n    }\n\n    async bulkCreate(inputs: Partial<T>[]): Promise<T[]> {\n        if (inputs.length === 0) return [];\n\n        const keys = Object.keys(inputs[0]!);\n        const valueRows = inputs.map((input) => Object.values(input));\n\n        const placeholders =\n            this.dialect === 'postgres'\n                ? valueRows\n                      .map(\n                          (_, rowIdx) =>\n                              `(${keys.map((_, colIdx) => `$${rowIdx * keys.length + colIdx + 1}`).join(', ')})`\n                      )\n                      .join(', ')\n                : valueRows.map(() => `(${keys.map(() => '?').join(', ')})`).join(', ');\n\n        const sql = `INSERT INTO ${this.meta.table} (${keys.join(', ')}) VALUES ${placeholders} RETURNING *`;\n\n        const allValues = valueRows.flat();\n        const result = await this.client.query<T>(sql, allValues);\n        return result.rows;\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { Repository } from './Repository';\n"],"mappings":"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"}

package/dist/transaction-DIGJnp19.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transaction-DIGJnp19.js","names":["value: unknown","client: DBClient"],"sources":["../src/transaction/UnitOfWork.ts","../src/transaction/index.ts"],"sourcesContent":["import type { DBClient } from '../connection/clients/DBClient';\n\n/**\n * Unit of Work pattern implementation for managing database transactions.\n * Ensures that a set of operations either all succeed or all fail together.\n *\n * @example\n * ```typescript\n * const uow = await UnitOfWork.start(dbClient);\n * try {\n *   await userRepo.create({ email: 'test@example.com' });\n *   await postRepo.create({ title: 'Hello' });\n *   await uow.commit();\n * } catch (error) {\n *   await uow.rollback();\n *   throw error;\n * }\n * ```\n */\nexport class UnitOfWork {\n    static readonly BRAND = 'tango.orm.unit_of_work' as const;\n    readonly __tangoBrand: typeof UnitOfWork.BRAND = UnitOfWork.BRAND;\n    protected client: DBClient;\n    protected isActive = false;\n\n    static isUnitOfWork(value: unknown): value is UnitOfWork {\n        return (\n            typeof value === 'object' &&\n            value !== null &&\n            (value as { __tangoBrand?: unknown }).__tangoBrand === UnitOfWork.BRAND\n        );\n    }\n\n    constructor(client: DBClient) {\n        this.client = client;\n    }\n\n    async begin(): Promise<void> {\n        if (!this.isActive) {\n            await this.client.begin();\n            this.isActive = true;\n        }\n    }\n\n    async commit(): Promise<void> {\n        if (this.isActive) {\n            await this.client.commit();\n            this.isActive = false;\n        }\n    }\n\n    async rollback(): Promise<void> {\n        if (this.isActive) {\n            await this.client.rollback();\n            this.isActive = false;\n        }\n    }\n\n    getClient(): DBClient {\n        return this.client;\n    }\n\n    static async start(client: DBClient): Promise<UnitOfWork> {\n        const uow = new UnitOfWork(client);\n        await uow.begin();\n        return uow;\n    }\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { UnitOfWork } from './UnitOfWork';\n"],"mappings":";;;IAmBa,aAAN,MAAM,WAAW;CACpB,OAAgB,QAAQ;CACxB,eAAiD,WAAW;CAC5D;CACA,WAAqB;CAErB,OAAO,aAAaA,OAAqC;AACrD,gBACW,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB,WAAW;CAEzE;CAED,YAAYC,QAAkB;AAC1B,OAAK,SAAS;CACjB;CAED,MAAM,QAAuB;AACzB,OAAK,KAAK,UAAU;AAChB,SAAM,KAAK,OAAO,OAAO;AACzB,QAAK,WAAW;EACnB;CACJ;CAED,MAAM,SAAwB;AAC1B,MAAI,KAAK,UAAU;AACf,SAAM,KAAK,OAAO,QAAQ;AAC1B,QAAK,WAAW;EACnB;CACJ;CAED,MAAM,WAA0B;AAC5B,MAAI,KAAK,UAAU;AACf,SAAM,KAAK,OAAO,UAAU;AAC5B,QAAK,WAAW;EACnB;CACJ;CAED,YAAsB;AAClB,SAAO,KAAK;CACf;CAED,aAAa,MAAMA,QAAuC;EACtD,MAAM,MAAM,IAAI,WAAW;AAC3B,QAAM,IAAI,OAAO;AACjB,SAAO;CACV;AACJ"}