@fragno-dev/create 0.1.4 → 0.1.5

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @fragno-dev/create@0.1.4 build /home/runner/work/fragno/fragno/packages/create
+> @fragno-dev/create@0.1.5 build /home/runner/work/fragno/fragno/packages/create
 > tsdown
 
 ℹ tsdown v0.15.12 powered by rolldown v1.0.0-beta.45
@@ -12,4 +12,4 @@
 ℹ dist/index.d.ts.map   0.58 kB │ gzip: 0.31 kB
 ℹ dist/index.d.ts       1.28 kB │ gzip: 0.48 kB
 ℹ 4 files, total: 19.08 kB
-✔ Build complete in 3797ms
+✔ Build complete in 1641ms

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @fragno-dev/create
 
+## 0.1.5
+
+### Patch Changes
+
+- 68135c4: Update database template to use latest fragno-db UOW API and bump dependency versions in
+  generated fragments
+
 ## 0.1.4
 
 ### Patch Changes

package/dist/index.js

@@ -47,10 +47,10 @@ function copy(from, to, rename = identity) {
 
 //#endregion
 //#region src/package-json.ts
-const fragnoCoreVersion = "0.1.10";
-const fragnoDbVersion = "0.1.15";
+const fragnoCoreVersion = "0.1.11";
+const fragnoDbVersion = "0.2.0";
 const unpluginFragnoVersion = "0.0.7";
-const fragnoCliVersion = "0.1.20";
+const fragnoCliVersion = "0.1.21";
 const basePkg = {
 	dependencies: {
 		"@fragno-dev/core": fragnoCoreVersion,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["e: unknown","basePkg: Record<string, unknown>","databasePkg: Record<string, unknown>","buildToolPkg: Record<BuildTools, Record<string, unknown>>","pkgOverride: Record<string, unknown>"],"sources":["../src/utils.ts","../src/package-json.ts","../src/index.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport function mkdirp(dir: string): void {\n  try {\n    fs.mkdirSync(dir, { recursive: true });\n  } catch (e: unknown) {\n    if (e instanceof Error && \"code\" in e && e.code === \"EEXIST\") {\n      return;\n    }\n    throw e;\n  }\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    Object.prototype.toString.call(value) === \"[object Object]\"\n  );\n}\n\n/**\n * Deep merge plain objects. Arrays and primitives are overwritten, not merged.\n * @param target The target object\n * @param source The source object\n * @returns The merged object\n */\nexport function merge<T extends Record<string, unknown>>(\n  target: T,\n  source: Record<string, unknown>,\n): T {\n  const result = { ...target } as Record<string, unknown>;\n\n  for (const key in source) {\n    const sourceValue = source[key];\n    const targetValue = result[key];\n\n    if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {\n      result[key] = merge(targetValue, sourceValue);\n    } else {\n      result[key] = sourceValue;\n    }\n  }\n\n  return result as T;\n}\n\nfunction identity<T>(x: T): T {\n  return x;\n}\n\nexport function copy(\n  from: string,\n  to: string,\n  rename: (basename: string) => string = identity,\n): void {\n  if (!fs.existsSync(from)) {\n    return;\n  }\n\n  const stats = fs.statSync(from);\n\n  if (stats.isDirectory()) {\n    fs.readdirSync(from).forEach((file) => {\n      copy(path.join(from, file), path.join(to, rename(file)));\n    });\n  } else {\n    mkdirp(path.dirname(to));\n    fs.copyFileSync(from, to);\n  }\n}\n","import type { BuildTools } from \"./index\";\n\nconst fragnoCoreVersion = \"0.1.10\";\nconst fragnoDbVersion = \"0.1.15\";\nconst unpluginFragnoVersion = \"0.0.7\";\nconst fragnoCliVersion = \"0.1.20\";\n\nexport const basePkg: Record<string, unknown> = {\n  dependencies: {\n    \"@fragno-dev/core\": fragnoCoreVersion,\n    \"@standard-schema/spec\": \"^1.0.0\",\n    zod: \"^4.0.5\",\n  },\n  devDependencies: {\n    \"@types/node\": \"^24\",\n    \"@fragno-dev/cli\": fragnoCliVersion,\n    \"@fragno-dev/unplugin-fragno\": unpluginFragnoVersion,\n  },\n  peerDependencies: {\n    typescript: \">=5\",\n    react: \">=18.0.0\",\n    svelte: \">=4.0.0\",\n    \"solid-js\": \">=1.0.0\",\n    vue: \">=3.0.0\",\n  },\n};\n\nexport const databasePkg: Record<string, unknown> = {\n  devDependencies: {\n    \"@fragno-dev/db\": fragnoDbVersion,\n  },\n  peerDependencies: {\n    \"@fragno-dev/db\": fragnoDbVersion,\n  },\n};\n\nexport const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {\n  none: {},\n  tsdown: {\n    devDependencies: {\n      tsdown: \"^0.12.0\",\n    },\n    scripts: {\n      build: \"tsdown\",\n    },\n  },\n  esbuild: {\n    devDependencies: {\n      esbuild: \"^0.25.12\",\n    },\n    scripts: {\n      build: \"./esbuild.config.js\",\n    },\n  },\n  vite: {\n    devDependencies: {\n      vite: \"^6.3.5\",\n    },\n    scripts: {\n      build: \"vite build\",\n    },\n  },\n  rollup: {\n    devDependencies: {\n      \"@rollup/plugin-node-resolve\": \"^16.0.2\",\n      \"@rollup/plugin-typescript\": \"^12.1.4\",\n      tslib: \"^2.8.1\",\n      rollup: \"^4.41.0\",\n    },\n    scripts: {\n      build: \"rollup -c\",\n    },\n  },\n  webpack: {\n    devDependencies: {\n      webpack: \"^5.99.9\",\n      \"webpack-cli\": \"^6.0.1\",\n      \"ts-loader\": \"^9.5.1\",\n    },\n    scripts: {\n      build: \"webpack\",\n    },\n  },\n  rspack: {\n    devDependencies: {\n      \"@rspack/core\": \"^1.6.1\",\n      \"@rspack/cli\": \"^1.6.1\",\n    },\n    scripts: {\n      build: \"rspack build\",\n    },\n  },\n};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { copy, merge } from \"./utils.ts\";\nimport { basePkg, buildToolPkg, databasePkg } from \"./package-json.ts\";\nimport { z } from \"zod\";\n\nconst templateTypesSchema = z.literal(\"fragment\");\nexport type TemplateTypes = z.infer<typeof templateTypesSchema>;\n\nconst buildToolsSchema = z.enum([\n  \"esbuild\",\n  \"tsdown\",\n  \"vite\",\n  \"rollup\",\n  \"webpack\",\n  \"rspack\",\n  \"none\",\n]);\nexport type BuildTools = z.infer<typeof buildToolsSchema>;\n\nconst agentDocsSchema = z.enum([\"AGENTS.md\", \"CLAUDE.md\", \"none\"]);\nexport type AgentDocs = z.infer<typeof agentDocsSchema>;\n\nexport const createOptionsSchema = z.object({\n  path: z.string(),\n  buildTool: buildToolsSchema,\n  name: z.string(),\n  template: templateTypesSchema,\n  agentDocs: agentDocsSchema,\n  withDatabase: z.boolean(),\n});\n\ntype CreateOptions = z.infer<typeof createOptionsSchema>;\n\nexport function create(options: CreateOptions) {\n  let pkgOverride: Record<string, unknown> = merge(basePkg, { name: options.name });\n\n  // Build tool pkg overrides\n  pkgOverride = merge(pkgOverride, buildToolPkg[options.buildTool]);\n\n  // Database pkg overrides\n  if (options.withDatabase) {\n    pkgOverride = merge(pkgOverride, databasePkg);\n  }\n\n  if (options.template == \"fragment\") {\n    writeFragmentTemplate(options.path, pkgOverride);\n  } else {\n    throw new Error(`Unsupported template type: ${options.template}`);\n  }\n\n  switch (options.buildTool) {\n    case \"esbuild\":\n      writeOptionalTemplate(options.path, \"builder/esbuild.config.js\");\n      break;\n    case \"tsdown\":\n      writeOptionalTemplate(options.path, \"builder/tsdown.config.ts\");\n      break;\n    case \"vite\":\n      writeOptionalTemplate(options.path, \"builder/vite.config.ts\");\n      break;\n    case \"rollup\":\n      writeOptionalTemplate(options.path, \"builder/rollup.config.js\");\n      break;\n    case \"webpack\":\n      writeOptionalTemplate(options.path, \"builder/webpack.config.js\");\n      break;\n    case \"rspack\":\n      writeOptionalTemplate(options.path, \"builder/rspack.config.js\");\n      break;\n    case \"none\":\n      break;\n  }\n\n  switch (options.agentDocs) {\n    case \"AGENTS.md\":\n      writeOptionalTemplate(options.path, \"agent/AGENTS.md\");\n      break;\n    case \"CLAUDE.md\":\n      writeOptionalTemplate(options.path, \"agent/AGENTS.md\", \"CLAUDE.md\");\n      break;\n    case \"none\":\n      break;\n  }\n\n  if (options.withDatabase) {\n    writeOptionalTemplate(options.path, \"database/index.ts\", \"src/index.ts\");\n    writeOptionalTemplate(options.path, \"database/schema.ts\", \"src/schema.ts\");\n  }\n}\n\nfunction getTemplateDir(): string {\n  const __dirname = path.dirname(fileURLToPath(import.meta.url));\n  return path.join(__dirname, \"..\", \"templates\");\n}\n\nfunction writeOptionalTemplate(targetPath: string, template: string, rename?: string) {\n  const templatePath = path.join(getTemplateDir(), \"optional\", template);\n  const targetFileName = rename ? rename : path.basename(template);\n  const targetFile = path.join(targetPath, targetFileName);\n\n  copy(templatePath, targetFile);\n}\n\nfunction writeFragmentTemplate(targetPath: string, pkgOverrides: Record<string, unknown>) {\n  const templateDir = path.join(getTemplateDir(), \"fragment\");\n\n  // Copy template files\n  copy(templateDir, targetPath, (basename) => {\n    if (basename === \"package.template.json\") {\n      return \"package.json\";\n    }\n    return basename;\n  });\n\n  // Update package.json based on chosen options\n  const packageJsonPath = path.join(targetPath, \"package.json\");\n  const basePkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf-8\"));\n  const newPkg = merge(basePkg, pkgOverrides);\n\n  // Write to disk\n  fs.writeFileSync(packageJsonPath, JSON.stringify(newPkg, null, 2) + \"\\n\");\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["e: unknown","basePkg: Record<string, unknown>","databasePkg: Record<string, unknown>","buildToolPkg: Record<BuildTools, Record<string, unknown>>","pkgOverride: Record<string, unknown>"],"sources":["../src/utils.ts","../src/package-json.ts","../src/index.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport function mkdirp(dir: string): void {\n  try {\n    fs.mkdirSync(dir, { recursive: true });\n  } catch (e: unknown) {\n    if (e instanceof Error && \"code\" in e && e.code === \"EEXIST\") {\n      return;\n    }\n    throw e;\n  }\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    Object.prototype.toString.call(value) === \"[object Object]\"\n  );\n}\n\n/**\n * Deep merge plain objects. Arrays and primitives are overwritten, not merged.\n * @param target The target object\n * @param source The source object\n * @returns The merged object\n */\nexport function merge<T extends Record<string, unknown>>(\n  target: T,\n  source: Record<string, unknown>,\n): T {\n  const result = { ...target } as Record<string, unknown>;\n\n  for (const key in source) {\n    const sourceValue = source[key];\n    const targetValue = result[key];\n\n    if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {\n      result[key] = merge(targetValue, sourceValue);\n    } else {\n      result[key] = sourceValue;\n    }\n  }\n\n  return result as T;\n}\n\nfunction identity<T>(x: T): T {\n  return x;\n}\n\nexport function copy(\n  from: string,\n  to: string,\n  rename: (basename: string) => string = identity,\n): void {\n  if (!fs.existsSync(from)) {\n    return;\n  }\n\n  const stats = fs.statSync(from);\n\n  if (stats.isDirectory()) {\n    fs.readdirSync(from).forEach((file) => {\n      copy(path.join(from, file), path.join(to, rename(file)));\n    });\n  } else {\n    mkdirp(path.dirname(to));\n    fs.copyFileSync(from, to);\n  }\n}\n","import type { BuildTools } from \"./index\";\n\nconst fragnoCoreVersion = \"0.1.11\";\nconst fragnoDbVersion = \"0.2.0\";\nconst unpluginFragnoVersion = \"0.0.7\";\nconst fragnoCliVersion = \"0.1.21\";\n\nexport const basePkg: Record<string, unknown> = {\n  dependencies: {\n    \"@fragno-dev/core\": fragnoCoreVersion,\n    \"@standard-schema/spec\": \"^1.0.0\",\n    zod: \"^4.0.5\",\n  },\n  devDependencies: {\n    \"@types/node\": \"^24\",\n    \"@fragno-dev/cli\": fragnoCliVersion,\n    \"@fragno-dev/unplugin-fragno\": unpluginFragnoVersion,\n  },\n  peerDependencies: {\n    typescript: \">=5\",\n    react: \">=18.0.0\",\n    svelte: \">=4.0.0\",\n    \"solid-js\": \">=1.0.0\",\n    vue: \">=3.0.0\",\n  },\n};\n\nexport const databasePkg: Record<string, unknown> = {\n  devDependencies: {\n    \"@fragno-dev/db\": fragnoDbVersion,\n  },\n  peerDependencies: {\n    \"@fragno-dev/db\": fragnoDbVersion,\n  },\n};\n\nexport const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {\n  none: {},\n  tsdown: {\n    devDependencies: {\n      tsdown: \"^0.12.0\",\n    },\n    scripts: {\n      build: \"tsdown\",\n    },\n  },\n  esbuild: {\n    devDependencies: {\n      esbuild: \"^0.25.12\",\n    },\n    scripts: {\n      build: \"./esbuild.config.js\",\n    },\n  },\n  vite: {\n    devDependencies: {\n      vite: \"^6.3.5\",\n    },\n    scripts: {\n      build: \"vite build\",\n    },\n  },\n  rollup: {\n    devDependencies: {\n      \"@rollup/plugin-node-resolve\": \"^16.0.2\",\n      \"@rollup/plugin-typescript\": \"^12.1.4\",\n      tslib: \"^2.8.1\",\n      rollup: \"^4.41.0\",\n    },\n    scripts: {\n      build: \"rollup -c\",\n    },\n  },\n  webpack: {\n    devDependencies: {\n      webpack: \"^5.99.9\",\n      \"webpack-cli\": \"^6.0.1\",\n      \"ts-loader\": \"^9.5.1\",\n    },\n    scripts: {\n      build: \"webpack\",\n    },\n  },\n  rspack: {\n    devDependencies: {\n      \"@rspack/core\": \"^1.6.1\",\n      \"@rspack/cli\": \"^1.6.1\",\n    },\n    scripts: {\n      build: \"rspack build\",\n    },\n  },\n};\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { copy, merge } from \"./utils.ts\";\nimport { basePkg, buildToolPkg, databasePkg } from \"./package-json.ts\";\nimport { z } from \"zod\";\n\nconst templateTypesSchema = z.literal(\"fragment\");\nexport type TemplateTypes = z.infer<typeof templateTypesSchema>;\n\nconst buildToolsSchema = z.enum([\n  \"esbuild\",\n  \"tsdown\",\n  \"vite\",\n  \"rollup\",\n  \"webpack\",\n  \"rspack\",\n  \"none\",\n]);\nexport type BuildTools = z.infer<typeof buildToolsSchema>;\n\nconst agentDocsSchema = z.enum([\"AGENTS.md\", \"CLAUDE.md\", \"none\"]);\nexport type AgentDocs = z.infer<typeof agentDocsSchema>;\n\nexport const createOptionsSchema = z.object({\n  path: z.string(),\n  buildTool: buildToolsSchema,\n  name: z.string(),\n  template: templateTypesSchema,\n  agentDocs: agentDocsSchema,\n  withDatabase: z.boolean(),\n});\n\ntype CreateOptions = z.infer<typeof createOptionsSchema>;\n\nexport function create(options: CreateOptions) {\n  let pkgOverride: Record<string, unknown> = merge(basePkg, { name: options.name });\n\n  // Build tool pkg overrides\n  pkgOverride = merge(pkgOverride, buildToolPkg[options.buildTool]);\n\n  // Database pkg overrides\n  if (options.withDatabase) {\n    pkgOverride = merge(pkgOverride, databasePkg);\n  }\n\n  if (options.template == \"fragment\") {\n    writeFragmentTemplate(options.path, pkgOverride);\n  } else {\n    throw new Error(`Unsupported template type: ${options.template}`);\n  }\n\n  switch (options.buildTool) {\n    case \"esbuild\":\n      writeOptionalTemplate(options.path, \"builder/esbuild.config.js\");\n      break;\n    case \"tsdown\":\n      writeOptionalTemplate(options.path, \"builder/tsdown.config.ts\");\n      break;\n    case \"vite\":\n      writeOptionalTemplate(options.path, \"builder/vite.config.ts\");\n      break;\n    case \"rollup\":\n      writeOptionalTemplate(options.path, \"builder/rollup.config.js\");\n      break;\n    case \"webpack\":\n      writeOptionalTemplate(options.path, \"builder/webpack.config.js\");\n      break;\n    case \"rspack\":\n      writeOptionalTemplate(options.path, \"builder/rspack.config.js\");\n      break;\n    case \"none\":\n      break;\n  }\n\n  switch (options.agentDocs) {\n    case \"AGENTS.md\":\n      writeOptionalTemplate(options.path, \"agent/AGENTS.md\");\n      break;\n    case \"CLAUDE.md\":\n      writeOptionalTemplate(options.path, \"agent/AGENTS.md\", \"CLAUDE.md\");\n      break;\n    case \"none\":\n      break;\n  }\n\n  if (options.withDatabase) {\n    writeOptionalTemplate(options.path, \"database/index.ts\", \"src/index.ts\");\n    writeOptionalTemplate(options.path, \"database/schema.ts\", \"src/schema.ts\");\n  }\n}\n\nfunction getTemplateDir(): string {\n  const __dirname = path.dirname(fileURLToPath(import.meta.url));\n  return path.join(__dirname, \"..\", \"templates\");\n}\n\nfunction writeOptionalTemplate(targetPath: string, template: string, rename?: string) {\n  const templatePath = path.join(getTemplateDir(), \"optional\", template);\n  const targetFileName = rename ? rename : path.basename(template);\n  const targetFile = path.join(targetPath, targetFileName);\n\n  copy(templatePath, targetFile);\n}\n\nfunction writeFragmentTemplate(targetPath: string, pkgOverrides: Record<string, unknown>) {\n  const templateDir = path.join(getTemplateDir(), \"fragment\");\n\n  // Copy template files\n  copy(templateDir, targetPath, (basename) => {\n    if (basename === \"package.template.json\") {\n      return \"package.json\";\n    }\n    return basename;\n  });\n\n  // Update package.json based on chosen options\n  const packageJsonPath = path.join(targetPath, \"package.json\");\n  const basePkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf-8\"));\n  const newPkg = merge(basePkg, pkgOverrides);\n\n  // Write to disk\n  fs.writeFileSync(packageJsonPath, JSON.stringify(newPkg, null, 2) + \"\\n\");\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fragno-dev/create",
   "description": "A library for creating Fragno fragments",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "exports": {
     ".": {
       "development": "./src/index.ts",

package/src/integration.test.ts

@@ -62,13 +62,25 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
         expect(stdout).toBeDefined();
       });
 
-      test("compiles", { timeout: 30000 }, async () => {
-        const { stdout } = await execAsync("pnpm run types:check", {
-          cwd: tempDir,
-          encoding: "utf8",
-        });
-        console.log(stdout);
-        expect(stdout).toBeDefined();
+      test("type checks (compiles)", { timeout: 30000 }, async () => {
+        try {
+          const { stdout } = await execAsync("pnpm run types:check", {
+            cwd: tempDir,
+            encoding: "utf8",
+          });
+          expect(stdout).toBeDefined();
+        } catch (error: unknown) {
+          // When command fails, stdout and stderr are in the error object
+          const execError = error as { stdout?: string; stderr?: string };
+          console.error("TypeScript type check failed:");
+          if (execError.stdout) {
+            console.error(execError.stdout);
+          }
+          if (execError.stderr) {
+            console.error(execError.stderr);
+          }
+          throw error;
+        }
       });
       /*
       FIXME: Skipping this test for rollup:

package/src/package-json.ts

@@ -1,9 +1,9 @@
 import type { BuildTools } from "./index";
 
-const fragnoCoreVersion = "0.1.10";
-const fragnoDbVersion = "0.1.15";
+const fragnoCoreVersion = "0.1.11";
+const fragnoDbVersion = "0.2.0";
 const unpluginFragnoVersion = "0.0.7";
-const fragnoCliVersion = "0.1.20";
+const fragnoCliVersion = "0.1.21";
 
 export const basePkg: Record<string, unknown> = {
   dependencies: {

package/templates/optional/database/index.ts

@@ -1,6 +1,10 @@
 import { defineFragment, defineRoutes, instantiate } from "@fragno-dev/core";
 import { createClientBuilder, type FragnoPublicClientConfig } from "@fragno-dev/core/client";
-import { withDatabase, type FragnoPublicConfigWithDatabase } from "@fragno-dev/db";
+import {
+  withDatabase,
+  type FragnoPublicConfigWithDatabase,
+  ExponentialBackoffRetryPolicy,
+} from "@fragno-dev/db";
 import type { TableToInsertValues } from "@fragno-dev/db/query";
 import { noteSchema } from "./schema";
 
@@ -11,29 +15,120 @@ import { z } from "zod";
 
 export interface ExampleConfig {
   // Add any server-side configuration here if needed
+  onNoteCreated?: (nonce: string, payload: { noteId: string; userId: string }) => Promise<void>;
 }
 
 const exampleFragmentDefinition = defineFragment<ExampleConfig>("example-fragment")
   .extend(withDatabase(noteSchema))
-  .providesBaseService(({ deps }) => {
-    return {
-      createNote: async (note: TableToInsertValues<typeof noteSchema.tables.note>) => {
-        const id = await deps.db.create("note", note);
+  .provideHooks(({ defineHook, config }) => ({
+    onNoteCreated: defineHook(async function (payload: { noteId: string; userId: string }) {
+      // Hook runs after transaction commits, with retries on failure
+      // Use this.nonce for idempotency (available via this context)
+      await config.onNoteCreated?.(this.nonce, payload);
+    }),
+  }))
+  .providesBaseService(({ defineService }) => {
+    return defineService({
+      createNote: async function (
+        note: Omit<TableToInsertValues<typeof noteSchema.tables.note>, "userId"> & {
+          userId: string;
+        },
+      ) {
+        const uow = this.uow(noteSchema);
+
+        // Find user first to get FragnoId for reference
+        const userUow = uow.findFirst("user", (b) =>
+          b.whereIndex("idx_user_email", (eb) => eb("email", "=", note.userId)),
+        );
+        const [user] = await userUow.retrievalPhase;
+
+        if (!user) {
+          throw new Error("User not found");
+        }
+
+        // Create note with reference to user
+        const noteId = uow.create("note", {
+          content: note.content,
+          userId: user.id,
+        });
+
+        // Trigger durable hook (recorded in transaction, executed after commit)
+        uow.triggerHook("onNoteCreated", {
+          noteId: noteId.valueOf(),
+          userId: user.id.valueOf(),
+        });
+
+        // Wait for handler to execute mutation phase
+        await uow.mutationPhase;
+
         return {
-          ...note,
-          id: id.valueOf(),
-          createdAt: note.createdAt ?? new Date(),
+          id: noteId.valueOf(),
+          content: note.content,
+          userId: user.id.valueOf(),
+          createdAt: new Date(),
         };
       },
-      getNotes: () => {
-        return deps.db.find("note", (b) => b);
+      getNotes: async function () {
+        const uow = this.uow(noteSchema).find("note", (b) =>
+          b.whereIndex("primary").join((j) => j.author()),
+        );
+        const [notes] = await uow.retrievalPhase;
+        return notes;
+      },
+      getNotesByUser: async function (userEmail: string) {
+        const uow = this.uow(noteSchema);
+
+        // First find the user by email
+        const userUow = uow.findFirst("user", (b) =>
+          b.whereIndex("idx_user_email", (eb) => eb("email", "=", userEmail)),
+        );
+        const [user] = await userUow.retrievalPhase;
+
+        if (!user) {
+          return [];
+        }
+
+        // Then find notes by the user's FragnoId
+        // Note: userId is a reference column, FragnoId works directly in whereIndex
+        const notesUow = uow.find("note", (b) =>
+          b.whereIndex("idx_note_user", (eb) => eb("userId", "=", user.id)).join((j) => j.author()),
+        );
+        const [notes] = await notesUow.retrievalPhase;
+        return notes;
       },
-      getNotesByUser: (userId: string) => {
-        return deps.db.find("note", (b) =>
-          b.whereIndex("idx_note_user", (eb) => eb("userId", "=", userId)),
+      updateNote: async function (noteId: string, content: string) {
+        const uow = this.uow(noteSchema);
+
+        // Find note first to get FragnoId for optimistic concurrency control
+        // Join with author to get user information
+        const noteUow = uow.findFirst("note", (b) =>
+          b.whereIndex("primary", (eb) => eb("id", "=", noteId)).join((j) => j.author()),
         );
+        const [note] = await noteUow.retrievalPhase;
+
+        if (!note) {
+          throw new Error("Note not found");
+        }
+
+        // Update with optimistic concurrency control (.check())
+        uow.update("note", note.id, (b) => b.set({ content }).check());
+
+        // Wait for handler to execute mutation phase
+        // On optimistic conflict, handler will retry the whole transaction
+        await uow.mutationPhase;
+
+        if (!note.author) {
+          throw new Error("Note author not found");
+        }
+
+        return {
+          id: note.id.valueOf(),
+          content,
+          userId: note.author.id.valueOf(),
+          createdAt: note.createdAt,
+        };
       },
-    };
+    });
   })
   .build();
 
@@ -49,32 +144,36 @@ const exampleRoutesFactory = defineRoutes(exampleFragmentDefinition).create(
             id: z.string(),
             content: z.string(),
             userId: z.string(),
+            userName: z.string(),
             createdAt: z.date(),
           }),
         ),
-        handler: async ({ query }, { json }) => {
-          const userId = query.get("userId");
+        handler: async function ({ query }, { json }) {
+          const userEmail = query.get("userId"); // Using userId param name for backward compatibility
+
+          const result = await this.uow(async ({ executeRetrieve }) => {
+            const notesPromise = userEmail
+              ? services.getNotesByUser(userEmail)
+              : services.getNotes();
+
+            // Execute all reads scheduled by services
+            await executeRetrieve();
+
+            return notesPromise;
+          });
 
-          if (userId) {
-            const notes = await services.getNotesByUser(userId);
-            return json(
-              notes.map((note) => ({
+          const notes = await result;
+
+          return json(
+            notes
+              .filter((note) => note.author !== null)
+              .map((note) => ({
                 id: note.id.valueOf(),
                 content: note.content,
-                userId: note.userId,
+                userId: note.author!.id.valueOf(),
+                userName: note.author!.name,
                 createdAt: note.createdAt,
               })),
-            );
-          }
-
-          const notes = await services.getNotes();
-          return json(
-            notes.map((note) => ({
-              id: note.id.valueOf(),
-              content: note.content,
-              userId: note.userId,
-              createdAt: note.createdAt,
-            })),
           );
         },
       }),
@@ -82,7 +181,7 @@ const exampleRoutesFactory = defineRoutes(exampleFragmentDefinition).create(
       defineRoute({
         method: "POST",
         path: "/notes",
-        inputSchema: z.object({ content: z.string(), userId: z.string() }),
+        inputSchema: z.object({ content: z.string(), userEmail: z.string() }),
         outputSchema: z.object({
           id: z.string(),
           content: z.string(),
@@ -90,10 +189,71 @@ const exampleRoutesFactory = defineRoutes(exampleFragmentDefinition).create(
           createdAt: z.date(),
         }),
         errorCodes: [],
-        handler: async ({ input }, { json }) => {
-          const { content, userId } = await input.valid();
+        handler: async function ({ input }, { json }) {
+          const { content, userEmail } = await input.valid();
+
+          // Handler controls transaction execution with retry policy
+          const result = await this.uow(
+            async ({ executeMutate }) => {
+              const notePromise = services.createNote({ content, userId: userEmail });
+
+              // Execute retrieval (if needed) and mutation atomically
+              // On optimistic conflict, this whole callback retries
+              await executeMutate();
+
+              return notePromise;
+            },
+            {
+              // Retry policy for optimistic concurrency conflicts
+              retryPolicy: new ExponentialBackoffRetryPolicy({
+                maxRetries: 5,
+                initialDelayMs: 10,
+                maxDelayMs: 250,
+              }),
+            },
+          );
+
+          const note = await result;
+          return json(note);
+        },
+      }),
+
+      defineRoute({
+        method: "PATCH",
+        path: "/notes/:noteId",
+        inputSchema: z.object({ content: z.string() }),
+        outputSchema: z.object({
+          id: z.string(),
+          content: z.string(),
+          userId: z.string(),
+          createdAt: z.date(),
+        }),
+        errorCodes: [],
+        handler: async function ({ input, pathParams }, { json }) {
+          const { content } = await input.valid();
+          const noteId = pathParams.noteId;
+
+          // Handler controls transaction with optimistic concurrency control
+          const result = await this.uow(
+            async ({ executeMutate }) => {
+              const notePromise = services.updateNote(noteId, content);
+
+              // Execute with optimistic concurrency control
+              // If note was modified, whole transaction retries
+              await executeMutate();
+
+              return notePromise;
+            },
+            {
+              retryPolicy: new ExponentialBackoffRetryPolicy({
+                maxRetries: 5,
+                initialDelayMs: 10,
+                maxDelayMs: 250,
+              }),
+            },
+          );
 
-          const note = await services.createNote({ content, userId });
+          const note = await result;
           return json(note);
         },
       }),

package/templates/optional/database/schema.ts

@@ -1,15 +1,28 @@
-import { column, idColumn, schema } from "@fragno-dev/db/schema";
+import { column, idColumn, referenceColumn, schema } from "@fragno-dev/db/schema";
 
 export const noteSchema = schema((s) => {
-  return s.addTable("note", (t) => {
-    return t
-      .addColumn("id", idColumn())
-      .addColumn("content", column("string"))
-      .addColumn("userId", column("string"))
-      .addColumn(
-        "createdAt",
-        column("timestamp").defaultTo((b) => b.now()),
-      )
-      .createIndex("idx_note_user", ["userId"]);
-  });
+  return s
+    .addTable("user", (t) => {
+      return t
+        .addColumn("id", idColumn())
+        .addColumn("name", column("string"))
+        .addColumn("email", column("string"))
+        .createIndex("idx_user_email", ["email"], { unique: true });
+    })
+    .addTable("note", (t) => {
+      return t
+        .addColumn("id", idColumn())
+        .addColumn("content", column("string"))
+        .addColumn("userId", referenceColumn())
+        .addColumn(
+          "createdAt",
+          column("timestamp").defaultTo((b) => b.now()),
+        )
+        .createIndex("idx_note_user", ["userId"]);
+    })
+    .addReference("author", {
+      type: "one",
+      from: { table: "note", column: "userId" },
+      to: { table: "user", column: "id" },
+    });
 });