@fragno-dev/create 0.1.0 → 0.1.3

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "@fragno-dev/create",
   "description": "A library for creating Fragno fragments",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
@@ -13,26 +12,32 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "scripts": {
-    "test": "vitest run",
-    "build": "tsdown",
-    "build:watch": "tsdown --watch",
-    "types:check": "tsc --noEmit"
-  },
   "type": "module",
   "dependencies": {
     "zod": "^4.1.12"
   },
   "devDependencies": {
-    "@fragno-private/typescript-config": "0.0.1",
-    "@fragno-private/vitest-config": "0.0.0",
-    "@types/node": "^20",
-    "@types/bun": "latest",
+    "@types/node": "^22",
     "@vitest/coverage-istanbul": "^3.2.4",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@fragno-private/typescript-config": "0.0.1",
+    "@fragno-private/vitest-config": "0.0.0"
   },
   "private": false,
   "peerDependencies": {
     "typescript": "^5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rejot-dev/fragno.git",
+    "directory": "packages/create"
+  },
+  "homepage": "https://fragno.dev",
+  "license": "MIT",
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsdown",
+    "build:watch": "tsdown --watch",
+    "types:check": "tsc --noEmit"
   }
-}
+}

package/src/integration.test.ts

@@ -54,8 +54,8 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
         await expect(fs.access(agentFile)).resolves.toBeUndefined();
       });
 
-      test("installs", { timeout: 10000 }, async () => {
-        const { stdout } = await execAsync("bun install", {
+      test("installs", { timeout: 30000 }, async () => {
+        const { stdout } = await execAsync("pnpm install", {
           cwd: tempDir,
           encoding: "utf8",
         });
@@ -63,7 +63,7 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
       });
 
       test("compiles", { timeout: 30000 }, async () => {
-        const { stdout } = await execAsync("bun run types:check", {
+        const { stdout } = await execAsync("pnpm run types:check", {
           cwd: tempDir,
           encoding: "utf8",
         });
@@ -72,12 +72,12 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
       });
       /*
       FIXME: Skipping this test for rollup:
-        When running rollup directly through bun run build or npm run build the build succeeds,
+        When running rollup directly through pnpm run build or npm run build the build succeeds,
         but somehow when running through vitest the module resolution mechanism changes causing
         the build to fail.
       */
-      test.skipIf(buildTool === "rollup")("builds", { timeout: 40000 }, async () => {
-        const result = await execAsync("bun run build", {
+      test.skipIf(buildTool === "rollup")("builds", { timeout: 50000 }, async () => {
+        const result = await execAsync("pnpm run build", {
           cwd: tempDir,
           encoding: "utf8",
         });
@@ -95,6 +95,9 @@ function createFragmentTestSuite(buildTool: BuildTool, withDatabase: boolean) {
         // However, the peerDependencies of @fragno-dev/core must not be included
         expect(reactBundleContent).toMatch(/from\s*['"]react['"]/);
 
+        // db should also not be included in the frontend
+        expect(reactBundleContent).not.toMatch(/import\s+.*?\s+from\s+['"]@fragno-dev\/db/);
+
         // Vite builds only the browser bundle
         if (buildTool !== "vite") {
           await expect(fs.access(path.join(tempDir, "dist", "node"))).resolves.toBeUndefined();

package/src/package-json.ts

@@ -1,21 +1,21 @@
 import type { BuildTools } from "./index";
 
-const fragnoCoreVersion = "^0.1.1";
-const fragnoDbVersion = "^0.1.1";
-const unpluginFragnoVersion = "^0.0.2";
-const fragnoCliVersion = "^0.1.2";
+const fragnoCoreVersion = "^0.1.7";
+const fragnoDbVersion = "^0.1.13";
+const unpluginFragnoVersion = "^0.0.3";
+const fragnoCliVersion = "^0.1.16";
 
 export const basePkg: Record<string, unknown> = {
   dependencies: {
     "@fragno-dev/core": fragnoCoreVersion,
-    zod: "^4.0.5",
+    zod: "^4.1.12",
   },
   devDependencies: {
-    "@fragno-dev/cli": fragnoCliVersion,
     "@types/node": "^22",
+    "@fragno-dev/cli": fragnoCliVersion,
   },
   peerDependencies: {
-    typescript: "^5",
+    typescript: ">=5",
     react: ">=18.0.0",
     svelte: ">=4.0.0",
     "solid-js": ">=1.0.0",
@@ -24,7 +24,10 @@ export const basePkg: Record<string, unknown> = {
 };
 
 export const databasePkg: Record<string, unknown> = {
-  dependencies: {
+  devDependencies: {
+    "@fragno-dev/db": fragnoDbVersion,
+  },
+  peerDependencies: {
     "@fragno-dev/db": fragnoDbVersion,
   },
 };
@@ -34,7 +37,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   tsdown: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      tsdown: "^0.11.9",
+      tsdown: "^0.12.0",
     },
     scripts: {
       build: "tsdown",
@@ -43,7 +46,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   esbuild: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      esbuild: "^0.25.10",
+      esbuild: "^0.25.12",
     },
     scripts: {
       build: "./esbuild.config.js",
@@ -52,7 +55,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   vite: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      vite: "^6.0.0",
+      vite: "^6.3.5",
     },
     scripts: {
       build: "vite build",
@@ -64,7 +67,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
       "@rollup/plugin-node-resolve": "^16.0.2",
       "@rollup/plugin-typescript": "^12.1.4",
       tslib: "^2.8.1",
-      rollup: "^4.52.4",
+      rollup: "^4.41.0",
     },
     scripts: {
       build: "rollup -c",
@@ -73,7 +76,7 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   webpack: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      webpack: "^5.102.0",
+      webpack: "^5.99.9",
       "webpack-cli": "^6.0.1",
       "ts-loader": "^9.5.1",
     },
@@ -84,8 +87,8 @@ export const buildToolPkg: Record<BuildTools, Record<string, unknown>> = {
   rspack: {
     devDependencies: {
       "@fragno-dev/unplugin-fragno": unpluginFragnoVersion,
-      "@rspack/core": "^1.5.8",
-      "@rspack/cli": "^1.5.8",
+      "@rspack/core": "^1.6.1",
+      "@rspack/cli": "^1.6.1",
     },
     scripts: {
       build: "rspack build",

package/templates/fragment/src/index.ts

@@ -61,7 +61,7 @@ const exampleFragmentDefinition = defineFragment<ExampleConfig>("example-fragmen
       serverSideData: { value: config.initialData ?? "Hello World! This is a server-side data." },
     };
   })
-  .withServices(({ deps }) => {
+  .providesService(({ deps }) => {
     return {
       getData: () => deps.serverSideData.value,
     };

package/templates/optional/agent/AGENTS.md

@@ -14,7 +14,9 @@ provide:
 - Built-in state management with reactive stores (TanStack Query-style:
   `const {data, loading, error} = useData()`)
 
-**Documentation**: Full documentation is available at https://fragno.dev/docs
+**Documentation**: https://fragno.dev/docs
+
+All docs are also available with a `.md` extension: https://fragno.dev/docs.md
 
 ## Architecture
 
@@ -24,79 +26,6 @@ Fragments follow a core pattern:
 2. **Client-side**: Auto-generated type-safe hooks for each route
 3. **Code splitting**: Server-only code (handlers, dependencies) is stripped from client bundles
 
-## Database Integration (Optional)
-
-Some Fragments require persistent storage. Fragno provides an optional database layer via
-`@fragno-dev/db` that integrates with your users' existing databases.
-
-### When to Use Database Integration
-
-Use `defineFragmentWithDatabase()` when your Fragment needs to:
-
-- Store persistent data (comments, likes, user preferences, etc.)
-- Query structured data efficiently
-- Maintain data integrity with indexes and constraints
-- Provide users with full control over their data
-
-### Schema Definition
-
-Database schemas are defined in a separate `schema.ts` file using the Fragno schema builder:
-
-```typescript
-import { column, idColumn, schema } from "@fragno-dev/db/schema";
-
-export const noteSchema = schema((s) => {
-  return s.addTable("note", (t) => {
-    return t
-      .addColumn("id", idColumn()) // Auto-generated ID
-      .addColumn("content", column("string"))
-      .addColumn("userId", column("string"))
-      .addColumn("createdAt", column("timestamp").defaultTo$("now"))
-      .createIndex("idx_note_user", ["userId"]); // Index for efficient queries
-  });
-});
-```
-
-**Key concepts**:
-
-- **Append-only**: Schemas use an append-only log approach. Never modify existing operations -
-  always add new ones
-- **Versioning**: Each schema operation increments the version number
-- **Indexes**: Create indexes on columns you'll frequently query (e.g., foreign keys, user IDs)
-- **Defaults**: Use `.defaultTo(value)` or `.defaultTo$("now")` for timestamps
-
-### Using the ORM
-
-The ORM is available in both `withDependencies()` and `withServices()` via the `orm` parameter:
-
-```typescript
-const fragmentDef = defineFragmentWithDatabase<Config>("my-fragment")
-  .withDatabase(mySchema)
-  .withServices(({ orm }) => {
-    return {
-      createNote: async (note) => {
-        const id = await orm.create("note", note);
-        return { id: id.toJSON(), ...note };
-      },
-      getNotesByUser: (userId: string) => {
-        // Use whereIndex for efficient indexed queries
-        return orm.find("note", (b) =>
-          b.whereIndex("idx_note_user", (eb) => eb("userId", "=", userId)),
-        );
-      },
-    };
-  });
-```
-
-**ORM methods**:
-
-- `orm.create(table, data)` - Insert a row, returns FragnoId
-- `orm.find(table, builder)` - Query rows with filtering
-- `orm.findOne(table, builder)` - Query a single row
-- `orm.update(table, id, data)` - Update a row by ID
-- `orm.delete(table, id)` - Delete a row by ID
-- `.whereIndex(indexName, condition)` - Use indexes for efficient queries
-
 ### Fragment Configuration
 
 Database-enabled Fragments require `FragnoPublicConfigWithDatabase`:
@@ -111,7 +40,7 @@ export function createMyFragment(
 ```
 
 For complete database documentation, see:
-https://fragno.dev/docs/for-library-authors/database-integration/overview.md
+https://fragno.dev/docs/fragno/for-library-authors/database-integration/overview.md
 
 ## File Structure & Core Concepts
 
@@ -167,9 +96,9 @@ client builder.
 
 Each framework requires a separate client file that wraps the generic client builder with the
 framework-specific `useFragno` hook. Check the `src/client/` directory for existing framework
-implementations. Use the frameworks page on https://fragno.dev/docs/frameworks to see if all clients
-have their stubs defined. Make sure to include new frameworks in the exports section of
-package.json.
+implementations. Use the frameworks page on https://fragno.dev/docs/fragno/reference/frameworks to
+see if all clients have their stubs defined. Make sure to include new frameworks in the exports
+section of package.json.
 
 ### `package.json` - Package Configuration
 
@@ -183,6 +112,122 @@ points:
 - Production uses built files from `dist/`
 - When adding new framework exports, add corresponding client files in `src/client/`
 
+## Database Integration (Optional)
+
+Some Fragments require persistent storage. Fragno provides an optional database layer via
+`@fragno-dev/db` that integrates with your users' existing databases.
+
+### When to Use Database Integration
+
+Use `defineFragmentWithDatabase()` when your Fragment needs to:
+
+- Store persistent data (comments, likes, user preferences, etc.)
+- Query structured data efficiently
+- Maintain data integrity with indexes and constraints
+- Provide users with full control over their data
+
+### Schema Definition
+
+Database schemas are defined in a separate `schema.ts` file using the Fragno schema builder:
+
+```typescript
+import { column, idColumn, referenceColumn, schema } from "@fragno-dev/db/schema";
+
+export const noteSchema = schema((s) => {
+  return s
+    .addTable("users", (t) => {
+      return t.addColumn("id", idColumn()).addColumn("name", column("string"));
+    })
+    .addTable("note", (t) => {
+      return t
+        .addColumn("id", idColumn()) // Auto-generated ID
+        .addColumn("content", column("string"))
+        .addColumn("userId", referenceColumn())
+        .addColumn("createdAt", column("timestamp").defaultTo$("now"))
+        .createIndex("idx_note_user", ["userId"]);
+    })
+    .addReference("author", {
+      from: {
+        table: "note",
+        column: "userId",
+      },
+      to: {
+        table: "user",
+        column: "id",
+      },
+      type: "one",
+    });
+});
+```
+
+**Key concepts**:
+
+- **Append-only**: Schemas use an append-only log approach. Never modify existing operations -
+  always add new ones
+- **Versioning**: Each schema operation increments the version number
+- **Indexes**: Create indexes on columns you'll frequently query (e.g., foreign keys, user IDs)
+- **Defaults**: `.defaultTo(value)` or `.defaultTo((b) => b.now())` for DB defaults;
+  `.defaultTo$((b) => b.cuid())` for runtime defaults
+
+### Using the ORM
+
+The ORM is available in both `withDependencies()` and `withServices()` via the `orm` parameter:
+
+```typescript
+const fragmentDef = defineFragmentWithDatabase<Config>("my-fragment")
+  .withDatabase(mySchema)
+  .withServices(({ orm }) => {
+    return {
+      createNote: async (note) => {
+        const id = await orm.create("note", note);
+        return { id: id.toJSON(), ...note };
+      },
+      getNotesByUser: (userId: string) => {
+        // Use whereIndex for efficient indexed queries
+        return orm.find("note", (b) =>
+          b.whereIndex("idx_note_user", (eb) => eb("userId", "=", userId)),
+        );
+      },
+    };
+  });
+```
+
+**ORM methods**:
+
+- `orm.create(table, data)` - Insert a row, returns FragnoId
+- `orm.find(table, builder)` - Query rows with filtering
+- `orm.findOne(table, builder)` - Query a single row
+- `orm.update(table, id, data)` - Update a row by ID
+- `orm.delete(table, id)` - Delete a row by ID
+- `.whereIndex(indexName, condition)` - Use indexes for efficient queries
+
+### Transactions (Unit of Work)
+
+Two-phase pattern for atomic operations (optimistic concurrency control):
+
+```typescript
+// Phase 1: Retrieve with version tracking
+const uow = orm
+  .createUnitOfWork()
+  .find("users", (b) => b.whereIndex("primary", (eb) => eb("id", "=", userId)))
+  .find("accounts", (b) => b.whereIndex("idx_user", (eb) => eb("userId", "=", userId)));
+const [users, accounts] = await uow.executeRetrieve();
+
+// Phase 2: Mutate atomically
+uow.update("users", users[0].id, (b) => b.set({ lastLogin: new Date() }).check());
+uow.update("accounts", accounts[0].id, (b) =>
+  b.set({ balance: accounts[0].balance + 100 }).check(),
+);
+
+const { success } = await uow.executeMutations();
+if (!success) {
+  /* Version conflict - retry */
+}
+```
+
+**Notes**: `.check()` enables optimistic concurrency control; requires `FragnoId` objects (not
+string IDs); use `uow.getCreatedIds()` for new record IDs
+
 ## Strategies for Building Fragments
 
 ### OpenAPI/Swagger Spec → Fragno Routes
@@ -217,7 +262,7 @@ Fragments require code splitting between client and server bundles using
 ### Type Checking
 
 ```bash
-bun run types:check
+pnpm run types:check
 ```
 
 ## Common Patterns

package/templates/optional/builder/esbuild.config.js

@@ -9,6 +9,7 @@ build({
     "./src/client/svelte.ts",
     "./src/client/vanilla.ts",
     "./src/client/vue.ts",
+    "./src/client/solid.ts",
   ],
   outdir: "./dist/browser",
   bundle: true,
@@ -18,7 +19,7 @@ build({
   splitting: true,
   sourcemap: true,
   plugins: [unpluginFragno({ platform: "browser" })],
-  external: ["react", "svelte", "vue", "zod"],
+  external: ["react", "svelte", "vue", "solid-js", "@fragno-dev/db"],
 });
 
 build({
@@ -27,8 +28,7 @@ build({
   bundle: true,
   format: "esm",
   platform: "node",
-  target: "node18",
+  target: "node22",
   sourcemap: true,
   plugins: [unpluginFragno({ platform: "node" })],
-  external: ["zod"],
 });

package/templates/optional/builder/rollup.config.js

@@ -11,6 +11,7 @@ export default [
       "client/svelte": "./src/client/svelte.ts",
       "client/vanilla": "./src/client/vanilla.ts",
       "client/vue": "./src/client/vue.ts",
+      "client/solid": "./src/client/solid.ts",
     },
     output: {
       dir: "./dist/browser",
@@ -18,7 +19,7 @@ export default [
       sourcemap: true,
     },
     // https://rollupjs.org/tools/#peer-dependencies
-    external: ["zod", "react", "svelte", "vue"],
+    external: ["zod", "react", "svelte", "vue", "solid-js", /^@fragno-dev\/db/],
     plugins: [
       resolve({
         moduleDirectories: ["node_modules"],
@@ -41,7 +42,6 @@ export default [
       format: "es",
       sourcemap: true,
     },
-    external: ["zod"],
     plugins: [
       resolve({
         moduleDirectories: ["node_modules"],

package/templates/optional/builder/rspack.config.js

@@ -16,6 +16,7 @@ export default [
       "client/svelte": "./src/client/svelte.ts",
       "client/vanilla": "./src/client/vanilla.ts",
       "client/vue": "./src/client/vue.ts",
+      "client/solid": "./src/client/solid.ts",
     },
     output: {
       path: path.resolve(__dirname, "dist/browser"),
@@ -48,7 +49,7 @@ export default [
     },
     plugins: [unpluginFragno({ platform: "browser" })],
     devtool: "source-map",
-    externals: ["zod", "react", "vue", "svelte"],
+    externals: ["zod", "react", "vue", "svelte", "solid-js", /^@fragno-dev\/db/],
   },
   // Node build
   {
@@ -88,6 +89,6 @@ export default [
     },
     plugins: [unpluginFragno({ platform: "node" })],
     devtool: "source-map",
-    externals: ["zod"],
+    externals: ["zod", /^@fragno-dev\/core/, /^@fragno-dev\/db/],
   },
 ];

package/templates/optional/builder/vite.config.ts

@@ -12,11 +12,12 @@ export default defineConfig({
         "client/svelte": "./src/client/svelte.ts",
         "client/vanilla": "./src/client/vanilla.ts",
         "client/vue": "./src/client/vue.ts",
+        "client/solid": "./src/client/solid.ts",
       },
       formats: ["es"],
     },
     rollupOptions: {
-      external: ["react", "vue", "svelte", "zod"],
+      external: ["react", "vue", "svelte", "solid-js", "zod", /^@fragno-dev\/db/],
     },
     outDir: "./dist/browser",
     sourcemap: true,

package/templates/optional/builder/webpack.config.js

@@ -16,6 +16,7 @@ export default [
       "client/svelte": "./src/client/svelte.ts",
       "client/vanilla": "./src/client/vanilla.ts",
       "client/vue": "./src/client/vue.ts",
+      "client/solid": "./src/client/solid.ts",
     },
     output: {
       path: path.resolve(__dirname, "dist/browser"),
@@ -41,7 +42,7 @@ export default [
     },
     plugins: [unpluginFragno({ platform: "browser" })],
     devtool: "source-map",
-    externals: ["react", "vue", "svelte", "zod"],
+    externals: ["react", "vue", "svelte", "solid-js", "zod", /^@fragno-dev\/db/],
   },
   // Node build
   {
@@ -74,6 +75,6 @@ export default [
     },
     plugins: [unpluginFragno({ platform: "node" })],
     devtool: "source-map",
-    externals: ["zod"],
+    externals: ["zod", /^@fragno-dev\/core/, /^@fragno-dev\/db/],
   },
 ];

package/templates/optional/database/index.ts

@@ -9,7 +9,7 @@ import {
   defineFragmentWithDatabase,
   type FragnoPublicConfigWithDatabase,
 } from "@fragno-dev/db/fragment";
-import type { AbstractQuery, TableToInsertValues } from "@fragno-dev/db/query";
+import type { TableToInsertValues } from "@fragno-dev/db/query";
 import { noteSchema } from "./schema";
 
 // NOTE: We use zod here for defining schemas, but any StandardSchema library can be used!
@@ -46,11 +46,7 @@ type ExampleServices = {
   >;
 };
 
-type ExampleDeps = {
-  orm: AbstractQuery<typeof noteSchema>;
-};
-
-const exampleRoutesFactory = defineRoutes<ExampleConfig, ExampleDeps, ExampleServices>().create(
+const exampleRoutesFactory = defineRoutes<ExampleConfig, {}, ExampleServices>().create(
   ({ services }) => {
     return [
       defineRoute({
@@ -102,10 +98,10 @@ const exampleRoutesFactory = defineRoutes<ExampleConfig, ExampleDeps, ExampleSer
 
 const exampleFragmentDefinition = defineFragmentWithDatabase<ExampleConfig>("example-fragment")
   .withDatabase(noteSchema)
-  .withServices(({ orm }) => {
+  .providesService(({ db }) => {
     return {
       createNote: async (note: TableToInsertValues<typeof noteSchema.tables.note>) => {
-        const id = await orm.create("note", note);
+        const id = await db.create("note", note);
         return {
           ...note,
           id: id.toJSON(),
@@ -113,10 +109,10 @@ const exampleFragmentDefinition = defineFragmentWithDatabase<ExampleConfig>("exa
         };
       },
       getNotes: () => {
-        return orm.find("note", (b) => b);
+        return db.find("note", (b) => b);
       },
       getNotesByUser: (userId: string) => {
-        return orm.find("note", (b) =>
+        return db.find("note", (b) =>
           b.whereIndex("idx_note_user", (eb) => eb("userId", "=", userId)),
         );
       },

package/templates/optional/database/schema.ts

@@ -6,7 +6,10 @@ export const noteSchema = schema((s) => {
       .addColumn("id", idColumn())
       .addColumn("content", column("string"))
       .addColumn("userId", column("string"))
-      .addColumn("createdAt", column("timestamp").defaultTo$("now"))
+      .addColumn(
+        "createdAt",
+        column("timestamp").defaultTo((b) => b.now()),
+      )
       .createIndex("idx_note_user", ["userId"]);
   });
 });