@nestjs-transactional/typeorm 1.0.0-alpha.0

package/dist/patching/symbols.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Hidden property keys used by the transparent transactional patching
+ * machinery (Phase 14.20).
+ *
+ * `Symbol.for(...)` is used (not module-local `Symbol(...)`) so the same
+ * key resolves identically across realms and across multiple copies of
+ * this package that may end up in a single Node process — e.g. via pnpm
+ * hoisting glitches or in monorepos with mixed dependency trees. Cross-
+ * realm safety is the documented justification (matches the convention
+ * used by `Symbol.for('@nestjs-transactional/wrapped')` in the core
+ * package — see `docs/status/conventions.md` #8).
+ *
+ * Namespaced strings prevent collision with arbitrary user code that
+ * might assign symbols on TypeORM internals.
+ */
+/**
+ * Hidden property on each managed `DataSource` instance carrying the
+ * dataSource name under which it was registered (`'default'`,
+ * `'billing'`, etc.). Stamped at registration time by
+ * {@link markAsManaged}; read by the patched
+ * `Repository.prototype.manager` getter and the patched instance-
+ * level `DataSource.manager` getter to look up the active transaction
+ * in `TransactionContext`.
+ *
+ * Mirrors typeorm-transactional's `'@transactional/data-source'`
+ * string key, but kept as a `Symbol.for(...)` to avoid colliding with
+ * arbitrary properties user code might set on a `DataSource`.
+ */
+export declare const TYPEORM_DATA_SOURCE_NAME: unique symbol;
+/**
+ * Hidden property on each `Repository` instance carrying the original
+ * (non-active) `EntityManager` reference. Populated when a repository
+ * is constructed (TypeORM's `Repository` constructor runs
+ * `this.manager = manager` — that assignment routes through the
+ * patched `Repository.prototype.manager` setter and ends up here
+ * instead of as an own-property).
+ *
+ * Used by the patched `Repository.prototype.manager` getter as the
+ * fallback when no active transaction is registered for this
+ * repository's dataSource. Also used to find the dataSource name —
+ * the original manager carries `connection`, which carries the
+ * stamped {@link TYPEORM_DATA_SOURCE_NAME}.
+ */
+export declare const TYPEORM_ENTITY_MANAGER_NAME: unique symbol;
+/**
+ * Hidden marker on each `DataSource` instance whose per-instance
+ * patches ({@link patchDataSourceInstance} in `data-source-patches.ts`)
+ * have been applied. Used to make the patch operation idempotent —
+ * a DataSource registered through `forRoot` more than once (e.g. on
+ * test resets) does not accumulate getter/setter pairs.
+ */
+export declare const TYPEORM_DATA_SOURCE_PATCHED: unique symbol;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/patching/symbols.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Hidden property keys used by the transparent transactional patching
+ * machinery (Phase 14.20).
+ *
+ * `Symbol.for(...)` is used (not module-local `Symbol(...)`) so the same
+ * key resolves identically across realms and across multiple copies of
+ * this package that may end up in a single Node process — e.g. via pnpm
+ * hoisting glitches or in monorepos with mixed dependency trees. Cross-
+ * realm safety is the documented justification (matches the convention
+ * used by `Symbol.for('@nestjs-transactional/wrapped')` in the core
+ * package — see `docs/status/conventions.md` #8).
+ *
+ * Namespaced strings prevent collision with arbitrary user code that
+ * might assign symbols on TypeORM internals.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TYPEORM_DATA_SOURCE_PATCHED = exports.TYPEORM_ENTITY_MANAGER_NAME = exports.TYPEORM_DATA_SOURCE_NAME = void 0;
+/**
+ * Hidden property on each managed `DataSource` instance carrying the
+ * dataSource name under which it was registered (`'default'`,
+ * `'billing'`, etc.). Stamped at registration time by
+ * {@link markAsManaged}; read by the patched
+ * `Repository.prototype.manager` getter and the patched instance-
+ * level `DataSource.manager` getter to look up the active transaction
+ * in `TransactionContext`.
+ *
+ * Mirrors typeorm-transactional's `'@transactional/data-source'`
+ * string key, but kept as a `Symbol.for(...)` to avoid colliding with
+ * arbitrary properties user code might set on a `DataSource`.
+ */
+exports.TYPEORM_DATA_SOURCE_NAME = Symbol.for('@nestjs-transactional/typeorm/data-source-name');
+/**
+ * Hidden property on each `Repository` instance carrying the original
+ * (non-active) `EntityManager` reference. Populated when a repository
+ * is constructed (TypeORM's `Repository` constructor runs
+ * `this.manager = manager` — that assignment routes through the
+ * patched `Repository.prototype.manager` setter and ends up here
+ * instead of as an own-property).
+ *
+ * Used by the patched `Repository.prototype.manager` getter as the
+ * fallback when no active transaction is registered for this
+ * repository's dataSource. Also used to find the dataSource name —
+ * the original manager carries `connection`, which carries the
+ * stamped {@link TYPEORM_DATA_SOURCE_NAME}.
+ */
+exports.TYPEORM_ENTITY_MANAGER_NAME = Symbol.for('@nestjs-transactional/typeorm/entity-manager');
+/**
+ * Hidden marker on each `DataSource` instance whose per-instance
+ * patches ({@link patchDataSourceInstance} in `data-source-patches.ts`)
+ * have been applied. Used to make the patch operation idempotent —
+ * a DataSource registered through `forRoot` more than once (e.g. on
+ * test resets) does not accumulate getter/setter pairs.
+ */
+exports.TYPEORM_DATA_SOURCE_PATCHED = Symbol.for('@nestjs-transactional/typeorm/data-source-patched');
+//# sourceMappingURL=symbols.js.map

package/dist/patching/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/patching/symbols.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH;;;;;;;;;;;;GAYG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,GAAG,CAChD,gDAAgD,CACjD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACU,QAAA,2BAA2B,GAAG,MAAM,CAAC,GAAG,CACnD,8CAA8C,CAC/C,CAAC;AAEF;;;;;;GAMG;AACU,QAAA,2BAA2B,GAAG,MAAM,CAAC,GAAG,CACnD,mDAAmD,CACpD,CAAC"}

package/dist/types/typeorm-transaction-handle.d.ts

@@ -0,0 +1,17 @@
+import type { TransactionHandle } from '@nestjs-transactional/core';
+import type { EntityManager } from 'typeorm';
+/**
+ * Adapter-specific handle produced by {@link TypeOrmTransactionAdapter}.
+ * Extends the core {@link TransactionHandle} with the TypeORM
+ * {@link EntityManager} bound to the active transaction.
+ *
+ * The `EntityManager` carries its own `QueryRunner` internally, so
+ * adapters and helpers can issue `SAVEPOINT` / `ROLLBACK TO SAVEPOINT` /
+ * `RELEASE SAVEPOINT` SQL via `handle.entityManager.query(...)` without
+ * needing a separate query-runner reference on the handle itself.
+ */
+export interface TypeOrmTransactionHandle extends TransactionHandle {
+    /** The TypeORM EntityManager scoped to this transaction. */
+    readonly entityManager: EntityManager;
+}
+//# sourceMappingURL=typeorm-transaction-handle.d.ts.map

package/dist/types/typeorm-transaction-handle.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=typeorm-transaction-handle.js.map

package/dist/types/typeorm-transaction-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeorm-transaction-handle.js","sourceRoot":"","sources":["../../src/types/typeorm-transaction-handle.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@nestjs-transactional/typeorm",
+  "version": "1.0.0-alpha.0",
+  "description": "TypeORM adapter for @nestjs-transactional/core — EntityManager propagation, savepoints, multi-datasource",
+  "license": "MIT",
+  "author": "Igor Golovanov",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/igorgolovanov/nestjs-transactional.git",
+    "directory": "packages/typeorm"
+  },
+  "bugs": {
+    "url": "https://github.com/igorgolovanov/nestjs-transactional/issues"
+  },
+  "homepage": "https://github.com/igorgolovanov/nestjs-transactional/tree/main/packages/typeorm#readme",
+  "keywords": [
+    "nestjs",
+    "typeorm",
+    "transaction",
+    "transactional",
+    "spring",
+    "entity-manager",
+    "savepoint"
+  ],
+  "engines": {
+    "node": ">=22.11.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.js.map",
+    "!dist/**/*.spec.*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0",
+    "@nestjs/typeorm": "^10.0.0 || ^11.0.0",
+    "reflect-metadata": "^0.1.13 || ^0.2.0",
+    "rxjs": "^7.0.0",
+    "typeorm": "^0.3.25",
+    "@nestjs-transactional/core": "^1.0.0-alpha.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "@nestjs/typeorm": "^11.0.0",
+    "@testcontainers/postgresql": "^10.13.0",
+    "@types/sql.js": "^1.4.9",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "sql.js": "^1.11.0",
+    "testcontainers": "^10.13.0",
+    "typeorm": "^0.3.25",
+    "@nestjs-transactional/core": "1.0.0-alpha.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rimraf dist *.tsbuildinfo coverage",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:integration": "jest --config jest.integration.config.js",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.ts\""
+  }
+}