@fragno-dev/db 0.2.0 → 0.2.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @fragno-dev/db@0.2.0 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.02 kB │ gzip:  7.11 kB
-ℹ dist/schema/create.js                                                      20.01 kB │ gzip:  5.24 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/migration-engine/generation-engine.js                                  8.05 kB │ gzip:  2.27 kB
-ℹ dist/db-fragment-definition-builder.js                                      7.68 kB │ gzip:  2.24 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                                80.52 kB │ gzip: 17.30 kB
-ℹ dist/schema/create.js.map                                                  49.08 kB │ gzip: 11.85 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/packages/fragno/dist/api/fragment-instantiator.js.map                 26.88 kB │ gzip:  6.61 kB
-ℹ dist/db-fragment-definition-builder.js.map                                 26.82 kB │ gzip:  6.27 kB
-ℹ dist/query/unit-of-work/execute-unit-of-work.js.map                        19.76 kB │ gzip:  5.32 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.88 kB │ gzip:  5.09 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/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.04 kB │ gzip:  3.51 kB
-ℹ dist/schema/create.d.ts.map                                                11.90 kB │ gzip:  4.68 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/query/unit-of-work/execute-unit-of-work.js                             7.14 kB │ gzip:  2.21 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,10 +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/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
@@ -76,19 +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/db-fragment-definition-builder.d.ts.map                                4.91 kB │ gzip:  2.07 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,9 +97,9 @@
 ℹ 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
@@ -108,6 +108,7 @@
 ℹ dist/adapters/generic-sql/query/cursor-utils.js.map                         2.78 kB │ gzip:  1.22 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
@@ -119,7 +120,6 @@
 ℹ dist/schema/type-conversion/dialect/sqlite.js.map                           2.37 kB │ gzip:  0.86 kB
 ℹ dist/adapters/generic-sql/migration/dialect/postgres.js                     2.33 kB │ gzip:  1.02 kB
 ℹ dist/sql-driver/sql.js.map                                                  2.32 kB │ gzip:  1.03 kB
-ℹ dist/query/unit-of-work/execute-unit-of-work.d.ts.map                       2.25 kB │ gzip:  0.92 kB
 ℹ dist/schema/type-conversion/dialect/mysql.js.map                            2.23 kB │ gzip:  0.83 kB
 ℹ dist/packages/fragno/dist/api/request-middleware.js                         2.18 kB │ gzip:  0.79 kB
 ℹ dist/schema/type-conversion/type-mapping.js                                 2.17 kB │ gzip:  0.94 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                                  26.66 kB │ gzip:  6.28 kB
-ℹ dist/schema/create.d.ts                                                    19.53 kB │ gzip:  4.76 kB
-ℹ dist/db-fragment-definition-builder.d.ts                                   10.44 kB │ gzip:  2.62 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                           5.25 kB │ gzip:  1.60 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: 1109.33 kB
-✔ Build complete in 12506ms
+ℹ 242 files, total: 1214.83 kB
+✔ Build complete in 14516ms

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # @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
+
+- aecfa70: feat(db): allow user callbacks in uow options
+- 3faac77: fix(db): child UOWs not reflecting parent's state after execution
+- 01a9c6d: feat(db): add tx() API for simplified transaction handling
+
+  Add new tx() method to both service and handler contexts that provides a simpler API for
+  transaction handling with automatic retry support. Supports two syntaxes: array syntax for
+  multiple service calls and callback syntax for direct UOW access. Also enhances restrict() to
+  accept options for controlling readiness signaling.
+
+- 5028ad3: fix(db): remove dependency on `node:inspect`
+- 20d824a: fix(db): preserve internal IDs in child UOWs when using two-phase pattern with
+  mutationPhase
+
 ## 0.2.0
 
 ### Minor 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 } 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,54 +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)
+   * 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.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();
+   * ```
    */
-  uow<TSchema extends AnySchema>(schema: TSchema): TypedUnitOfWork<TSchema, [], unknown, THooks>;
+  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>>;
+  handlerTx(options?: Omit<ExecuteTxOptions, "createUnitOfWork">): HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, THooks>;
 };
 /**
  * Database fragment context provided to user callbacks.
@@ -153,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 } 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,32 +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 serviceContext = { uow: forSchema };
-				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);
-					};
-					return executeRestrictedUnitOfWork(wrappedCallback, {
+					const userOnBeforeMutate = execOptions?.onBeforeMutate;
+					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: hooksConfig ? (uow$1) => prepareHookMutations(uow$1, hooksConfig) : void 0,
-						onSuccess: hooksConfig ? () => processHooks(hooksConfig) : void 0
+						onBeforeMutate: (uow) => {
+							if (hooksConfig) prepareHookMutations(uow, hooksConfig);
+							if (userOnBeforeMutate) userOnBeforeMutate(uow);
+						},
+						onAfterMutate: async (uow) => {
+							if (hooksConfig) await processHooks(hooksConfig);
+							if (userOnAfterMutate) await userOnAfterMutate(uow);
+						}
 					});
 				}
 				return {
 					serviceContext,
-					handlerContext: { uow }
+					handlerContext: { handlerTx }
 				};
 			}).build(),
 			dependencies