@fragno-dev/db 0.2.1 → 0.2.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @fragno-dev/db@0.2.1 build /home/runner/work/fragno/fragno/packages/fragno-db
+> @fragno-dev/db@0.2.2 build /home/runner/work/fragno/fragno/packages/fragno-db
 > tsdown
 
 ℹ tsdown v0.15.12 powered by rolldown v1.0.0-beta.45
@@ -7,13 +7,13 @@
 ℹ entry: src/db-fragment-definition-builder.ts, src/id.ts, src/mod.ts, src/adapters/adapters.ts, src/migration-engine/generation-engine.ts, src/query/cursor.ts, src/query/simple-query-interface.ts, src/schema/create.ts, src/sql-driver/sql-driver.ts, src/adapters/drizzle/drizzle-adapter.ts, src/adapters/drizzle/generate.ts, src/adapters/generic-sql/driver-config.ts, src/adapters/generic-sql/generic-sql-adapter.ts, src/adapters/kysely/kysely-adapter.ts, src/query/unit-of-work/unit-of-work.ts, src/sql-driver/dialects/dialects.ts, src/sql-driver/dialects/durable-object-dialect.ts
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/query/unit-of-work/unit-of-work.js                                    32.66 kB │ gzip:  7.28 kB
-ℹ dist/schema/create.js                                                      19.85 kB │ gzip:  5.20 kB
+ℹ dist/query/unit-of-work/unit-of-work.js                                    33.28 kB │ gzip:  7.47 kB
+ℹ dist/schema/create.js                                                      19.91 kB │ gzip:  5.21 kB
 ℹ dist/adapters/drizzle/generate.js                                          14.69 kB │ gzip:  3.69 kB
-ℹ dist/db-fragment-definition-builder.js                                      9.56 kB │ gzip:  2.45 kB
 ℹ dist/migration-engine/generation-engine.js                                  8.05 kB │ gzip:  2.27 kB
+ℹ dist/db-fragment-definition-builder.js                                      7.83 kB │ gzip:  2.27 kB
 ℹ dist/query/cursor.js                                                        4.81 kB │ gzip:  1.70 kB
-ℹ dist/mod.js                                                                 4.22 kB │ gzip:  1.37 kB
+ℹ dist/mod.js                                                                 4.40 kB │ gzip:  1.42 kB
 ℹ dist/sql-driver/dialects/durable-object-dialect.js                          3.51 kB │ gzip:  1.10 kB
 ℹ dist/adapters/generic-sql/generic-sql-adapter.js                            3.33 kB │ gzip:  1.14 kB
 ℹ dist/adapters/generic-sql/driver-config.js                                  3.12 kB │ gzip:  0.68 kB
@@ -24,39 +24,40 @@
 ℹ dist/id.js                                                                  0.07 kB │ gzip:  0.07 kB
 ℹ dist/query/simple-query-interface.js                                        0.01 kB │ gzip:  0.03 kB
 ℹ dist/sql-driver/sql-driver.js                                               0.01 kB │ gzip:  0.03 kB
-ℹ dist/query/unit-of-work/unit-of-work.js.map                                81.66 kB │ gzip: 17.56 kB
-ℹ dist/schema/create.js.map                                                  48.81 kB │ gzip: 11.78 kB
+ℹ dist/query/unit-of-work/unit-of-work.js.map                                82.31 kB │ gzip: 17.71 kB
+ℹ dist/query/unit-of-work/execute-unit-of-work.js.map                        70.12 kB │ gzip: 11.84 kB
+ℹ dist/schema/create.js.map                                                  48.86 kB │ gzip: 11.79 kB
 ℹ dist/adapters/drizzle/generate.js.map                                      34.97 kB │ gzip:  8.55 kB
-ℹ dist/db-fragment-definition-builder.js.map                                 34.65 kB │ gzip:  7.54 kB
-ℹ dist/query/unit-of-work/execute-unit-of-work.js.map                        31.97 kB │ gzip:  6.83 kB
 ℹ dist/packages/fragno/dist/api/fragment-instantiator.js.map                 26.88 kB │ gzip:  6.61 kB
+ℹ dist/db-fragment-definition-builder.js.map                                 25.67 kB │ gzip:  5.98 kB
 ℹ dist/adapters/generic-sql/migration/sql-generator.js.map                   17.35 kB │ gzip:  4.35 kB
+ℹ dist/query/unit-of-work/execute-unit-of-work.js                            16.91 kB │ gzip:  3.75 kB
 ℹ dist/migration-engine/generation-engine.js.map                             16.86 kB │ gzip:  4.69 kB
 ℹ dist/packages/fragno/dist/api/fragment-instantiator.js                     16.69 kB │ gzip:  4.17 kB
 ℹ dist/packages/fragno/dist/api/fragment-definition-builder.js.map           15.85 kB │ gzip:  3.10 kB
 ℹ dist/adapters/generic-sql/query/sql-query-compiler.js.map                  15.39 kB │ gzip:  4.43 kB
 ℹ dist/adapters/generic-sql/query/generic-sql-uow-operation-compiler.js.map  15.11 kB │ gzip:  3.75 kB
-ℹ dist/query/unit-of-work/unit-of-work.d.ts.map                              13.96 kB │ gzip:  5.11 kB
+ℹ dist/query/unit-of-work/execute-unit-of-work.d.ts.map                      14.63 kB │ gzip:  5.55 kB
+ℹ dist/query/unit-of-work/unit-of-work.d.ts.map                              14.07 kB │ gzip:  5.16 kB
+ℹ dist/fragments/internal-fragment.js.map                                    13.95 kB │ gzip:  3.59 kB
 ℹ dist/adapters/shared/from-unit-of-work-compiler.js.map                     13.87 kB │ gzip:  3.79 kB
-ℹ dist/query/unit-of-work/execute-unit-of-work.js                            12.41 kB │ gzip:  2.81 kB
 ℹ dist/node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.js.map    12.39 kB │ gzip:  3.32 kB
-ℹ dist/fragments/internal-fragment.js.map                                    12.00 kB │ gzip:  3.49 kB
-ℹ dist/schema/create.d.ts.map                                                11.85 kB │ gzip:  4.65 kB
+ℹ dist/schema/create.d.ts.map                                                11.86 kB │ gzip:  4.68 kB
 ℹ dist/adapters/generic-sql/query/where-builder.js.map                       11.09 kB │ gzip:  2.88 kB
 ℹ dist/packages/fragno/dist/api/fragment-definition-builder.js               11.03 kB │ gzip:  2.24 kB
 ℹ dist/adapters/generic-sql/migration/prepared-migrations.js.map              9.48 kB │ gzip:  2.67 kB
 ℹ dist/query/condition-builder.js.map                                         9.18 kB │ gzip:  2.42 kB
 ℹ dist/query/cursor.js.map                                                    9.12 kB │ gzip:  2.97 kB
 ℹ dist/sql-driver/dialects/durable-object-dialect.js.map                      9.12 kB │ gzip:  2.91 kB
+ℹ dist/mod.js.map                                                             8.71 kB │ gzip:  2.68 kB
 ℹ dist/adapters/shared/uow-operation-compiler.js.map                          8.61 kB │ gzip:  2.63 kB
 ℹ dist/adapters/generic-sql/migration/dialect/sqlite.js.map                   8.46 kB │ gzip:  2.85 kB
-ℹ dist/mod.js.map                                                             8.40 kB │ gzip:  2.59 kB
 ℹ dist/migration-engine/auto-from-schema.js.map                               8.31 kB │ gzip:  2.18 kB
+ℹ dist/hooks/hooks.js.map                                                     7.90 kB │ gzip:  2.62 kB
 ℹ dist/query/value-encoding.js.map                                            7.88 kB │ gzip:  2.57 kB
 ℹ dist/query/simple-query-interface.d.ts.map                                  7.83 kB │ gzip:  2.92 kB
 ℹ dist/adapters/generic-sql/migration/sql-generator.js                        7.79 kB │ gzip:  2.15 kB
 ℹ dist/query/serialize/dialect/sqlite-serializer.js.map                       7.41 kB │ gzip:  2.04 kB
-ℹ dist/hooks/hooks.js.map                                                     7.34 kB │ gzip:  2.47 kB
 ℹ dist/adapters/generic-sql/query/generic-sql-uow-operation-compiler.js       6.96 kB │ gzip:  1.71 kB
 ℹ dist/adapters/generic-sql/uow-decoder.js.map                                6.89 kB │ gzip:  2.43 kB
 ℹ dist/adapters/generic-sql/driver-config.js.map                              6.86 kB │ gzip:  1.40 kB
@@ -65,11 +66,11 @@
 ℹ dist/adapters/generic-sql/generic-sql-adapter.js.map                        6.52 kB │ gzip:  2.21 kB
 ℹ dist/adapters/shared/from-unit-of-work-compiler.js                          6.45 kB │ gzip:  1.82 kB
 ℹ dist/query/serialize/dialect/mysql-serializer.js.map                        6.14 kB │ gzip:  1.56 kB
-ℹ dist/adapters/generic-sql/query/where-builder.js                            5.92 kB │ gzip:  1.65 kB
+ℹ dist/adapters/generic-sql/query/where-builder.js                            5.92 kB │ gzip:  1.66 kB
 ℹ dist/adapters/generic-sql/uow-encoder.js.map                                5.91 kB │ gzip:  2.17 kB
 ℹ dist/packages/fragno/dist/api/request-output-context.js.map                 5.82 kB │ gzip:  1.69 kB
 ℹ dist/adapters/generic-sql/query/sql-query-compiler.js                       5.76 kB │ gzip:  1.89 kB
-ℹ dist/db-fragment-definition-builder.d.ts.map                                5.76 kB │ gzip:  2.40 kB
+ℹ dist/fragments/internal-fragment.js                                         5.74 kB │ gzip:  1.58 kB
 ℹ dist/schema/type-conversion/type-mapping.js.map                             5.72 kB │ gzip:  1.90 kB
 ℹ dist/query/serialize/dialect/postgres-serializer.js.map                     5.59 kB │ gzip:  1.49 kB
 ℹ dist/packages/fragno/dist/api/request-input-context.js.map                  5.39 kB │ gzip:  1.72 kB
@@ -77,18 +78,17 @@
 ℹ dist/with-database.js.map                                                   5.30 kB │ gzip:  1.49 kB
 ℹ dist/query/value-decoding.js.map                                            5.15 kB │ gzip:  1.88 kB
 ℹ dist/adapters/generic-sql/result-interpreter.js.map                         4.94 kB │ gzip:  1.62 kB
-ℹ dist/fragments/internal-fragment.js                                         4.94 kB │ gzip:  1.46 kB
 ℹ dist/query/unit-of-work/retry-policy.js.map                                 4.93 kB │ gzip:  1.38 kB
 ℹ dist/node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.js         4.85 kB │ gzip:  1.62 kB
 ℹ dist/adapters/generic-sql/migration/dialect/postgres.js.map                 4.67 kB │ gzip:  1.79 kB
 ℹ dist/sql-driver/sql-driver-adapter.js.map                                   4.67 kB │ gzip:  1.61 kB
 ℹ dist/query/value-encoding.js                                                4.63 kB │ gzip:  1.61 kB
+ℹ dist/db-fragment-definition-builder.d.ts.map                                4.61 kB │ gzip:  1.92 kB
 ℹ dist/migration-engine/auto-from-schema.js                                   4.33 kB │ gzip:  1.21 kB
 ℹ dist/adapters/generic-sql/migration/dialect/mysql.js.map                    4.29 kB │ gzip:  1.70 kB
 ℹ dist/adapters/generic-sql/uow-decoder.js                                    3.94 kB │ gzip:  1.46 kB
 ℹ dist/migration-engine/shared.js.map                                         3.89 kB │ gzip:  1.25 kB
 ℹ dist/adapters/generic-sql/migration/dialect/sqlite.js                       3.77 kB │ gzip:  1.44 kB
-ℹ dist/fragments/internal-fragment.d.ts.map                                   3.67 kB │ gzip:  0.63 kB
 ℹ dist/query/serialize/dialect/sqlite-serializer.js                           3.66 kB │ gzip:  1.08 kB
 ℹ dist/adapters/shared/uow-operation-compiler.js                              3.58 kB │ gzip:  1.27 kB
 ℹ dist/packages/fragno/dist/api/request-middleware.js.map                     3.58 kB │ gzip:  1.25 kB
@@ -97,18 +97,18 @@
 ℹ dist/adapters/generic-sql/uow-encoder.js                                    3.48 kB │ gzip:  1.39 kB
 ℹ dist/packages/fragno/dist/api/request-output-context.js                     3.40 kB │ gzip:  1.03 kB
 ℹ dist/packages/fragno/dist/api/request-input-context.js                      3.36 kB │ gzip:  1.11 kB
+ℹ dist/hooks/hooks.js                                                         3.32 kB │ gzip:  1.20 kB
 ℹ dist/packages/fragno/dist/api/mutable-request-state.js.map                  3.32 kB │ gzip:  1.20 kB
 ℹ dist/adapters/generic-sql/migration/prepared-migrations.js                  3.29 kB │ gzip:  0.99 kB
-ℹ dist/hooks/hooks.js                                                         3.22 kB │ gzip:  1.16 kB
 ℹ dist/packages/fragno/dist/api/internal/response-stream.js.map               3.21 kB │ gzip:  1.25 kB
 ℹ dist/adapters/generic-sql/result-interpreter.js                             3.05 kB │ gzip:  1.02 kB
 ℹ dist/packages/fragno/dist/api/fragno-response.js.map                        3.04 kB │ gzip:  1.16 kB
 ℹ dist/query/serialize/sql-serializer.js                                      3.00 kB │ gzip:  1.09 kB
 ℹ dist/query/serialize/dialect/mysql-serializer.js                            2.94 kB │ gzip:  0.83 kB
 ℹ dist/adapters/generic-sql/query/cursor-utils.js.map                         2.78 kB │ gzip:  1.22 kB
-ℹ dist/query/unit-of-work/execute-unit-of-work.d.ts.map                       2.75 kB │ gzip:  1.17 kB
 ℹ dist/adapters/adapters.js.map                                               2.71 kB │ gzip:  1.03 kB
 ℹ dist/adapters/generic-sql/generic-sql-uow-executor.js                       2.68 kB │ gzip:  0.85 kB
+ℹ dist/fragments/internal-fragment.d.ts.map                                   2.66 kB │ gzip:  0.63 kB
 ℹ dist/query/serialize/dialect/postgres-serializer.js                         2.65 kB │ gzip:  0.78 kB
 ℹ dist/query/value-decoding.js                                                2.54 kB │ gzip:  1.02 kB
 ℹ dist/sql-driver/sql-driver-adapter.js                                       2.44 kB │ gzip:  0.80 kB
@@ -134,6 +134,7 @@
 ℹ dist/query/condition-builder.js                                             1.89 kB │ gzip:  0.70 kB
 ℹ dist/query/column-defaults.js.map                                           1.84 kB │ gzip:  0.74 kB
 ℹ dist/packages/fragno/dist/api/error.js.map                                  1.81 kB │ gzip:  0.67 kB
+ℹ dist/schema/generate-id.js.map                                              1.79 kB │ gzip:  0.84 kB
 ℹ dist/packages/fragno/dist/api/internal/response-stream.js                   1.77 kB │ gzip:  0.73 kB
 ℹ dist/adapters/drizzle/drizzle-adapter.js.map                                1.75 kB │ gzip:  0.76 kB
 ℹ dist/adapters/generic-sql/query/cursor-utils.js                             1.67 kB │ gzip:  0.77 kB
@@ -156,6 +157,7 @@
 ℹ dist/adapters/generic-sql/query/dialect/sqlite.js.map                       1.20 kB │ gzip:  0.55 kB
 ℹ dist/adapters/generic-sql/query/dialect/postgres.js.map                     1.19 kB │ gzip:  0.55 kB
 ℹ dist/with-database.js                                                       1.15 kB │ gzip:  0.53 kB
+ℹ dist/schema/generate-id.js                                                  1.15 kB │ gzip:  0.57 kB
 ℹ dist/query/serialize/create-sql-serializer.js                               1.13 kB │ gzip:  0.47 kB
 ℹ dist/adapters/generic-sql/generic-sql-adapter.d.ts.map                      1.12 kB │ gzip:  0.51 kB
 ℹ dist/schema/type-conversion/dialect/mysql.js                                1.12 kB │ gzip:  0.57 kB
@@ -206,14 +208,15 @@
 ℹ dist/migration-engine/shared.js                                             0.21 kB │ gzip:  0.17 kB
 ℹ dist/sql-driver/dialect-adapter/dialect-adapter.d.ts.map                    0.20 kB │ gzip:  0.15 kB
 ℹ dist/sql-driver/query-executor/plugin.d.ts.map                              0.20 kB │ gzip:  0.17 kB
+ℹ dist/schema/generate-id.d.ts.map                                            0.19 kB │ gzip:  0.15 kB
 ℹ dist/adapters/generic-sql/migration/executor.d.ts.map                       0.18 kB │ gzip:  0.15 kB
 ℹ dist/adapters/shared/table-name-mapper.d.ts.map                             0.17 kB │ gzip:  0.14 kB
 ℹ dist/shared/providers.d.ts.map                                              0.15 kB │ gzip:  0.13 kB
-ℹ dist/query/unit-of-work/unit-of-work.d.ts                                  27.28 kB │ gzip:  6.41 kB
-ℹ dist/schema/create.d.ts                                                    19.46 kB │ gzip:  4.72 kB
-ℹ dist/db-fragment-definition-builder.d.ts                                   12.80 kB │ gzip:  3.23 kB
+ℹ dist/query/unit-of-work/unit-of-work.d.ts                                  27.64 kB │ gzip:  6.52 kB
+ℹ dist/schema/create.d.ts                                                    19.52 kB │ gzip:  4.75 kB
+ℹ dist/db-fragment-definition-builder.d.ts                                    9.85 kB │ gzip:  2.36 kB
 ℹ dist/query/simple-query-interface.d.ts                                      7.58 kB │ gzip:  1.83 kB
-ℹ dist/mod.d.ts                                                               4.22 kB │ gzip:  1.36 kB
+ℹ dist/mod.d.ts                                                               4.66 kB │ gzip:  1.46 kB
 ℹ dist/query/cursor.d.ts                                                      3.60 kB │ gzip:  1.31 kB
 ℹ dist/adapters/generic-sql/driver-config.d.ts                                3.38 kB │ gzip:  0.83 kB
 ℹ dist/adapters/adapters.d.ts                                                 2.62 kB │ gzip:  0.99 kB
@@ -226,16 +229,17 @@
 ℹ dist/adapters/kysely/kysely-adapter.d.ts                                    0.81 kB │ gzip:  0.39 kB
 ℹ dist/sql-driver/dialects/dialects.d.ts                                      0.13 kB │ gzip:  0.08 kB
 ℹ dist/id.d.ts                                                                0.07 kB │ gzip:  0.07 kB
-ℹ dist/query/unit-of-work/execute-unit-of-work.d.ts                           6.97 kB │ gzip:  2.00 kB
-ℹ dist/fragments/internal-fragment.d.ts                                       3.88 kB │ gzip:  1.16 kB
+ℹ dist/query/unit-of-work/execute-unit-of-work.d.ts                          26.79 kB │ gzip:  4.25 kB
+ℹ dist/fragments/internal-fragment.d.ts                                       6.09 kB │ gzip:  1.36 kB
 ℹ dist/adapters/generic-sql/migration/prepared-migrations.d.ts                2.90 kB │ gzip:  0.86 kB
 ℹ dist/query/unit-of-work/retry-policy.d.ts                                   2.73 kB │ gzip:  0.76 kB
 ℹ dist/query/condition-builder.d.ts                                           2.00 kB │ gzip:  0.68 kB
 ℹ dist/with-database.d.ts                                                     1.95 kB │ gzip:  0.70 kB
-ℹ dist/hooks/hooks.d.ts                                                       1.41 kB │ gzip:  0.67 kB
+ℹ dist/hooks/hooks.d.ts                                                       1.53 kB │ gzip:  0.70 kB
 ℹ dist/sql-driver/query-executor/query-executor.d.ts                          1.17 kB │ gzip:  0.49 kB
 ℹ dist/sql-driver/sql-driver-adapter.d.ts                                     1.08 kB │ gzip:  0.49 kB
 ℹ dist/sql-driver/driver/runtime-driver.d.ts                                  0.88 kB │ gzip:  0.39 kB
+ℹ dist/schema/generate-id.d.ts                                                0.74 kB │ gzip:  0.43 kB
 ℹ dist/query/orm/orm.d.ts                                                     0.63 kB │ gzip:  0.35 kB
 ℹ dist/sql-driver/query-executor/plugin.d.ts                                  0.52 kB │ gzip:  0.31 kB
 ℹ dist/sql-driver/connection/connection-provider.d.ts                         0.47 kB │ gzip:  0.27 kB
@@ -245,5 +249,5 @@
 ℹ dist/shared/providers.d.ts                                                  0.26 kB │ gzip:  0.19 kB
 ℹ dist/util/types.d.ts                                                        0.26 kB │ gzip:  0.21 kB
 ℹ dist/sql-driver/dialect-adapter/dialect-adapter.d.ts                        0.21 kB │ gzip:  0.16 kB
-ℹ 238 files, total: 1143.83 kB
-✔ Build complete in 12790ms
+ℹ 242 files, total: 1214.83 kB
+✔ Build complete in 14516ms

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @fragno-dev/db
 
+## 0.2.2
+
+### Patch Changes
+
+- aca5990: breaking: remove executeUnitOfWork helper in favor of executeTx
+- f150db9: feat: add `generateId(schema, tableName)` utility for pre-generating table IDs without
+  creating records. Also available as `TypedUnitOfWork.generateId(tableName)` convenience method.
+- 0b373fc: refactor: Rename `nonce` to `idempotencyKey` in public APIs
+
+  Rename the `nonce` property to `idempotencyKey` in `HookContext` and `UnitOfWork` interfaces for
+  better clarity and consistency. The database column name remains `nonce` for backward
+  compatibility.
+
+  **Breaking change**: Users accessing `this.nonce` in hook functions or `uow.nonce` in unit of work
+  operations must update to `this.idempotencyKey` and `uow.idempotencyKey` respectively.
+
+- fe27e33: feat: add new builder pattern for combining UOWs
+- 9753f15: feat: Add unified transaction API with createServiceTx and executeTx
+
+  Introduce a new unified transaction API that consolidates multiple transaction execution patterns
+  into a single `executeTx` function with `TxResult` pattern. This provides better type safety,
+  clearer composition patterns, and support for nested dependencies.
+
+  New APIs:
+  - `createServiceTx`: Create service-level transactions with dependency support
+  - `executeTx`: Handler-level transaction execution with unified callback pattern
+  - `TxResult` type: Branded type for transaction results with dependency tracking
+  - `handlerTx` method: Added to fragment definitions for convenient access
+
+  The old APIs (`executeTxCallbacks`, `executeTxWithDeps`, `executeTxArray`) are deprecated but
+  remain available for backward compatibility.
+
 ## 0.2.1
 
 ### Patch Changes

package/dist/adapters/generic-sql/query/where-builder.js

@@ -1,5 +1,5 @@
-import { Column, FragnoId, FragnoReference } from "../../../schema/create.js";
 import { createSQLSerializer } from "../../../query/serialize/create-sql-serializer.js";
+import { Column, FragnoId, FragnoReference } from "../../../schema/create.js";
 import { ReferenceSubquery, resolveFragnoIdValue } from "../../../query/value-encoding.js";
 import { sql } from "kysely";
 

package/dist/db-fragment-definition-builder.d.ts

@@ -1,7 +1,7 @@
 import { AnySchema } from "./schema/create.js";
-import { AwaitedPromisesInObject, ExecuteRestrictedUnitOfWorkOptions, HandlerTxCallbacks, ServiceTxCallbacks } from "./query/unit-of-work/execute-unit-of-work.js";
+import { ExecuteTxOptions, HandlerTxBuilder, ServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.js";
 import { HookContext, HookFn, HooksMap } from "./hooks/hooks.js";
-import { IUnitOfWork, TypedUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
+import { IUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
 import { SimpleQueryInterface } from "./query/simple-query-interface.js";
 import { DatabaseAdapter } from "./adapters/adapters.js";
 import { AnyFragnoInstantiatedFragment, FragmentDefinition, FragmentDefinitionBuilder, FragnoPublicConfig, RequestThisContext, ServiceConstructorFn } from "@fragno-dev/core";
@@ -42,108 +42,46 @@ type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {
  */
 type DatabaseServiceContext<THooks extends HooksMap> = RequestThisContext & {
   /**
-   * Get a typed, restricted Unit of Work for the given schema.
-   * @param schema - Schema to get a typed view for
-   * @returns TypedUnitOfWork (restricted version without execute methods)
-   */
-  uow<TSchema extends AnySchema>(schema: TSchema): TypedUnitOfWork<TSchema, [], unknown, THooks>;
-  /**
-   * Execute a transaction with two-phase callbacks (retrieve + mutate).
-   *
-   * @param schema - Schema to use for the transaction
-   * @param callbacks - Object containing retrieve and mutate callbacks
-   * @returns Promise resolving to the mutation result with promises awaited 1 level deep
+   * Create a service-level transaction builder using the fluent API.
+   * Returns a builder that can be chained with withServiceCalls, retrieve,
+   * transformRetrieve, mutate, transform, and build.
    *
    * @example
    * ```ts
-   * return this.tx(schema, {
-   *   retrieve: (uow) => uow.findFirst("users", ...),
-   *   mutate: async (uow, [user]) => {
-   *     await validateUser(user);
-   *     uow.update("users", user.id, ...).check();
-   *     return { ok: true };
-   *   }
-   * });
+   * return this.serviceTx(schema)
+   *   .withServiceCalls(() => [otherService.getData()])
+   *   .retrieve((uow) => uow.find("users", ...))
+   *   .transformRetrieve(([users]) => users[0])
+   *   .mutate(({ uow, retrieveResult, serviceIntermediateResult }) =>
+   *     uow.create("records", { ... })
+   *   )
+   *   .transform(({ mutateResult, serviceResult }) => ({ id: mutateResult }))
+   *   .build();
    * ```
    */
-  tx<TSchema extends AnySchema, TRetrievalResults extends unknown[], TMutationResult = void>(schema: TSchema, callbacks: ServiceTxCallbacks<TSchema, TRetrievalResults, TMutationResult, THooks>): Promise<AwaitedPromisesInObject<TMutationResult>>;
+  serviceTx<TSchema extends AnySchema>(schema: TSchema): ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, THooks>;
 };
 /**
  * Handler context for database fragments - provides UOW execution with automatic retry support.
  */
 type DatabaseHandlerContext<THooks extends HooksMap = {}> = RequestThisContext & {
   /**
-   * Execute a Unit of Work with explicit phase control and automatic retry support.
-   * This method provides an API where users call forSchema to create a schema-specific
-   * UOW, then call executeRetrieve() and executeMutate() to execute the phases. The entire
-   * callback is re-executed on optimistic concurrency conflicts, ensuring retries work properly.
-   * Automatically provides the UOW factory from context.
-   * Promises in the returned object are awaited 1 level deep.
-   *
-   * @param callback - Async function that receives a context with forSchema, executeRetrieve, executeMutate, nonce, and currentAttempt
-   * @param options - Optional configuration for retry policy and abort signal
-   * @returns Promise resolving to the callback's return value with promises awaited 1 level deep
-   * @throws Error if retries are exhausted or callback throws an error
+   * Create a handler-level transaction builder using the fluent API.
+   * Returns a builder that can be chained with withServiceCalls, retrieve,
+   * transformRetrieve, mutate, transform, and execute.
    *
    * @example
    * ```ts
-   * const result = await this.uow(async ({ forSchema, executeRetrieve, executeMutate, nonce, currentAttempt }) => {
-   *   const uow = forSchema(schema);
-   *   const userId = uow.create("users", { name: "John" });
-   *
-   *   // Execute retrieval phase
-   *   await executeRetrieve();
-   *
-   *   const profileId = uow.create("profiles", { userId });
-   *
-   *   // Execute mutation phase
-   *   await executeMutate();
-   *
-   *   return { userId, profileId };
-   * });
+   * const result = await this.handlerTx()
+   *   .withServiceCalls(() => [userService.getUser(id)])
+   *   .mutate(({ forSchema, idempotencyKey, currentAttempt, serviceIntermediateResult }) => {
+   *     return forSchema(ordersSchema).create("orders", { ... });
+   *   })
+   *   .transform(({ mutateResult, serviceResult }) => ({ ... }))
+   *   .execute();
    * ```
    */
-  uow<TResult>(callback: (context: {
-    forSchema: <TSchema extends AnySchema, H extends HooksMap = THooks>(schema: TSchema, hooks?: H) => TypedUnitOfWork<TSchema, [], unknown, H>;
-    executeRetrieve: () => Promise<void>;
-    executeMutate: () => Promise<void>;
-    nonce: string;
-    currentAttempt: number;
-  }) => Promise<TResult> | TResult, options?: Omit<ExecuteRestrictedUnitOfWorkOptions, "createUnitOfWork">): Promise<AwaitedPromisesInObject<TResult>>;
-  /**
-   * Execute a transaction with automatic retry support.
-   * Provides two overloads: array syntax (common case) and callback syntax (advanced).
-   *
-   * Array syntax - pass a factory function that returns service calls:
-   * ```ts
-   * const [transfer, notify] = await this.tx(
-   *   () => [
-   *     services.transfer({ from, to, amount }),
-   *     services.notify({ userId, message })
-   *   ]
-   * );
-   * ```
-   *
-   * Callback syntax - for handlers that need direct UOW access:
-   * ```ts
-   * const result = await this.tx({
-   *   retrieve: ({ forSchema }) => {
-   *     const uow = forSchema(schema);
-   *     uow.find("users", ...);
-   *     return services.transfer({ ... });
-   *   },
-   *   mutate: ({ forSchema }, transferPromise) => {
-   *     const uow = forSchema(schema);
-   *     uow.create("auditLog", { ... });
-   *     return transferPromise;
-   *   }
-   * });
-   * ```
-   *
-   * Note: Handler callbacks are synchronous only to prevent accidentally awaiting services in wrong place.
-   */
-  tx<T extends readonly unknown[]>(servicesFactory: () => readonly [...{ [K in keyof T]: Promise<T[K]> }], options?: Omit<ExecuteRestrictedUnitOfWorkOptions, "createUnitOfWork">): Promise<{ [K in keyof T]: T[K] }>;
-  tx<TRetrieveResult, TMutationResult>(callbacks: HandlerTxCallbacks<TRetrieveResult, TMutationResult, THooks>, options?: Omit<ExecuteRestrictedUnitOfWorkOptions, "createUnitOfWork">): Promise<AwaitedPromisesInObject<TMutationResult>>;
+  handlerTx(options?: Omit<ExecuteTxOptions, "createUnitOfWork">): HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, THooks>;
 };
 /**
  * Database fragment context provided to user callbacks.
@@ -207,7 +145,7 @@ declare class DatabaseFragmentDefinitionBuilder<TSchema extends AnySchema, TConf
    * ```ts
    * .provideHooks(({ defineHook, config }) => ({
    *   onSubscribe: defineHook(async function (payload: { email: string }) {
-   *     // 'this' context available (HookServiceContext with nonce)
+   *     // 'this' context available (HookServiceContext with idempotencyKey)
    *     await config.onSubscribe?.(payload.email);
    *   }),
    * }))

package/dist/db-fragment-definition-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-fragment-definition-builder.d.ts","names":[],"sources":["../src/db-fragment-definition-builder.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"db-fragment-definition-builder.d.ts","names":[],"sources":["../src/db-fragment-definition-builder.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/db-fragment-definition-builder.js

@@ -1,5 +1,4 @@
-import "./query/unit-of-work/unit-of-work.js";
-import { executeRestrictedUnitOfWork, executeServiceTx, executeTxArray, executeTxCallbacks } from "./query/unit-of-work/execute-unit-of-work.js";
+import { createHandlerTxBuilder, createServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.js";
 import { prepareHookMutations, processHooks } from "./hooks/hooks.js";
 
 //#region src/db-fragment-definition-builder.ts
@@ -86,7 +85,7 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 	* ```ts
 	* .provideHooks(({ defineHook, config }) => ({
 	*   onSubscribe: defineHook(async function (payload: { email: string }) {
-	*     // 'this' context available (HookServiceContext with nonce)
+	*     // 'this' context available (HookServiceContext with idempotencyKey)
 	*     await config.onSubscribe?.(payload.email);
 	*   }),
 	* }))
@@ -169,76 +168,37 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 						options
 					})
 				} : void 0;
-				function forSchema(schema) {
-					const uow$1 = storage.getStore()?.uow;
-					if (!uow$1) throw new Error("No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.");
-					return uow$1.restrict().forSchema(schema);
+				function serviceTx(schema) {
+					const uow = storage.getStore()?.uow;
+					if (!uow) throw new Error("No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.");
+					return createServiceTxBuilder(schema, uow, hooksConfig?.hooks);
 				}
-				const serviceTx = async (schema, callbacks) => {
-					const uow$1 = storage.getStore()?.uow;
-					if (!uow$1) throw new Error("No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.");
-					return executeServiceTx(schema, callbacks, uow$1);
-				};
-				const serviceContext = {
-					uow: forSchema,
-					tx: serviceTx
-				};
-				async function uow(callback, execOptions) {
+				const serviceContext = { serviceTx };
+				function handlerTx(execOptions) {
 					const currentStorage = storage.getStore();
 					if (!currentStorage) throw new Error("No storage in context. Handler must be called within a request context.");
-					const wrappedCallback = async (context) => {
-						return callback(context);
-					};
 					const userOnBeforeMutate = execOptions?.onBeforeMutate;
-					const userOnSuccess = execOptions?.onSuccess;
-					return executeRestrictedUnitOfWork(wrappedCallback, {
+					const userOnAfterMutate = execOptions?.onAfterMutate;
+					return createHandlerTxBuilder({
 						...execOptions,
 						createUnitOfWork: () => {
 							currentStorage.uow.reset();
 							if (hooksConfig) currentStorage.uow.registerSchema(hooksConfig.internalFragment.$internal.deps.schema, hooksConfig.internalFragment.$internal.deps.namespace);
 							return currentStorage.uow;
 						},
-						onBeforeMutate: (uow$1) => {
-							if (hooksConfig) prepareHookMutations(uow$1, hooksConfig);
-							if (userOnBeforeMutate) userOnBeforeMutate(uow$1);
+						onBeforeMutate: (uow) => {
+							if (hooksConfig) prepareHookMutations(uow, hooksConfig);
+							if (userOnBeforeMutate) userOnBeforeMutate(uow);
 						},
-						onSuccess: async (uow$1) => {
+						onAfterMutate: async (uow) => {
 							if (hooksConfig) await processHooks(hooksConfig);
-							if (userOnSuccess) await userOnSuccess(uow$1);
+							if (userOnAfterMutate) await userOnAfterMutate(uow);
 						}
 					});
 				}
-				async function handlerTx(factoryOrCallbacks, execOptions) {
-					const currentStorage = storage.getStore();
-					if (!currentStorage) throw new Error("No storage in context. Handler must be called within a request context.");
-					const userOnBeforeMutate = execOptions?.onBeforeMutate;
-					const userOnSuccess = execOptions?.onSuccess;
-					const createUow = () => {
-						currentStorage.uow.reset();
-						if (hooksConfig) currentStorage.uow.registerSchema(hooksConfig.internalFragment.$internal.deps.schema, hooksConfig.internalFragment.$internal.deps.namespace);
-						return currentStorage.uow;
-					};
-					const options$1 = {
-						...execOptions,
-						createUnitOfWork: createUow,
-						onBeforeMutate: (uow$1) => {
-							if (hooksConfig) prepareHookMutations(uow$1, hooksConfig);
-							if (userOnBeforeMutate) userOnBeforeMutate(uow$1);
-						},
-						onSuccess: async (uow$1) => {
-							if (hooksConfig) await processHooks(hooksConfig);
-							if (userOnSuccess) await userOnSuccess(uow$1);
-						}
-					};
-					if (typeof factoryOrCallbacks === "function") return executeTxArray(factoryOrCallbacks, options$1);
-					else return executeTxCallbacks(factoryOrCallbacks, options$1);
-				}
 				return {
 					serviceContext,
-					handlerContext: {
-						uow,
-						tx: handlerTx
-					}
+					handlerContext: { handlerTx }
 				};
 			}).build(),
 			dependencies