@danceroutine/tango-orm 0.1.0

package/dist/repository-DaRvsfjs.js.map

@@ -0,0 +1 @@
+{"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/UnitOfWork.d.ts

@@ -0,0 +1,31 @@
+import type { DBClient } from '../connection/clients/DBClient';
+/**
+ * Unit of Work pattern implementation for managing database transactions.
+ * Ensures that a set of operations either all succeed or all fail together.
+ *
+ * @example
+ * ```typescript
+ * const uow = await UnitOfWork.start(dbClient);
+ * try {
+ *   await userRepo.create({ email: 'test@example.com' });
+ *   await postRepo.create({ title: 'Hello' });
+ *   await uow.commit();
+ * } catch (error) {
+ *   await uow.rollback();
+ *   throw error;
+ * }
+ * ```
+ */
+export declare class UnitOfWork {
+    static readonly BRAND: "tango.orm.unit_of_work";
+    readonly __tangoBrand: typeof UnitOfWork.BRAND;
+    protected client: DBClient;
+    protected isActive: boolean;
+    static isUnitOfWork(value: unknown): value is UnitOfWork;
+    constructor(client: DBClient);
+    begin(): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    getClient(): DBClient;
+    static start(client: DBClient): Promise<UnitOfWork>;
+}

package/dist/transaction/index.d.ts

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

package/dist/transaction/index.js

@@ -0,0 +1,3 @@
+import { UnitOfWork } from "../transaction-DIGJnp19.js";
+
+export { UnitOfWork };

package/dist/transaction-DIGJnp19.js

@@ -0,0 +1,50 @@
+import { __export } from "./chunk-DLY2FNSh.js";
+
+//#region src/transaction/UnitOfWork.ts
+var UnitOfWork = class UnitOfWork {
+	static BRAND = "tango.orm.unit_of_work";
+	__tangoBrand = UnitOfWork.BRAND;
+	client;
+	isActive = false;
+	static isUnitOfWork(value) {
+		return typeof value === "object" && value !== null && value.__tangoBrand === UnitOfWork.BRAND;
+	}
+	constructor(client) {
+		this.client = client;
+	}
+	async begin() {
+		if (!this.isActive) {
+			await this.client.begin();
+			this.isActive = true;
+		}
+	}
+	async commit() {
+		if (this.isActive) {
+			await this.client.commit();
+			this.isActive = false;
+		}
+	}
+	async rollback() {
+		if (this.isActive) {
+			await this.client.rollback();
+			this.isActive = false;
+		}
+	}
+	getClient() {
+		return this.client;
+	}
+	static async start(client) {
+		const uow = new UnitOfWork(client);
+		await uow.begin();
+		return uow;
+	}
+};
+
+//#endregion
+//#region src/transaction/index.ts
+var transaction_exports = {};
+__export(transaction_exports, { UnitOfWork: () => UnitOfWork });
+
+//#endregion
+export { UnitOfWork, transaction_exports };
+//# sourceMappingURL=transaction-DIGJnp19.js.map

package/dist/transaction-DIGJnp19.js.map

@@ -0,0 +1 @@
+{"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"}

package/package.json

@@ -0,0 +1,82 @@
+{
+    "name": "@danceroutine/tango-orm",
+    "version": "0.1.0",
+    "description": "QuerySet, Repository, UnitOfWork, and database adapters for Tango",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./query": {
+            "types": "./dist/query/index.d.ts",
+            "import": "./dist/query/index.js"
+        },
+        "./connection": {
+            "types": "./dist/connection/index.d.ts",
+            "import": "./dist/connection/index.js"
+        },
+        "./transaction": {
+            "types": "./dist/transaction/index.d.ts",
+            "import": "./dist/transaction/index.js"
+        },
+        "./repository": {
+            "types": "./dist/repository/index.d.ts",
+            "import": "./dist/repository/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsdown",
+        "test": "vitest run --coverage",
+        "test:integration": "vitest run src/tests/integration",
+        "test:watch": "vitest",
+        "typecheck": "tsc --noEmit"
+    },
+    "keywords": [
+        "tango",
+        "orm",
+        "queryset",
+        "repository",
+        "database"
+    ],
+    "author": "Pedro Del Moral Lopez",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/danceroutine/tango.git",
+        "directory": "packages/orm"
+    },
+    "dependencies": {
+        "@danceroutine/tango-config": "workspace:*",
+        "@danceroutine/tango-core": "workspace:*"
+    },
+    "peerDependencies": {
+        "pg": "^8.13.1",
+        "better-sqlite3": "^11.7.0"
+    },
+    "peerDependenciesMeta": {
+        "pg": {
+            "optional": true
+        },
+        "better-sqlite3": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "@danceroutine/tango-migrations": "workspace:*",
+        "@danceroutine/tango-testing": "workspace:*",
+        "@types/better-sqlite3": "^7.6.12",
+        "@types/node": "^22.9.0",
+        "@types/pg": "^8.11.10",
+        "better-sqlite3": "^11.7.0",
+        "pg": "^8.13.1",
+        "tsdown": "^0.4.0",
+        "typescript": "^5.6.3",
+        "vitest": "^4.0.6"
+    }
+}