create-syncular-app 0.15.47 → 0.16.1

package/README.md

@@ -13,7 +13,7 @@ bunx create-syncular-app my-app --template web
 |---|---|
 | `minimal` | Server + a terminal two-client convergence demo (no browser) — migrations + manifest + `generate` wiring. Copy-evolved from `examples/quickstart`. The smallest honest starting point. |
 | `web` | Hono server + WebSocket realtime + a single-pane browser todo app whose whole client core runs in a Web Worker on OPFS. Derived from `apps/demo`, slimmed to one pane (no conflict simulator, no blob attachments) — the minimal browser app a real user starts from. |
-| `tauri` | One React codebase, web + desktop: the `web` template's server plus a shared React tree behind the `__TAURI_INTERNALS__` engine seam (`src/frontend/engine.ts`) — worker core on OPFS in the browser, native Rust core in a `src-tauri/` host (`tauri-plugin-syncular` from crates.io, `native-transport`). Derived from `bindings/tauri/example` + the [web+desktop guide](../../apps/docs/src/content/guide-web-desktop.md). |
+| `tauri` | One React codebase, web + desktop: the `web` template's server plus a shared React tree behind the `__TAURI_INTERNALS__` engine seam (`src/frontend/engine.ts`) — worker core on OPFS in the browser, native Rust core in a `src-tauri/` host (`tauri-plugin-syncular` from crates.io, `native-transport`). Derived from `bindings/tauri/example` + the [Tauri guide](../../apps/docs/src/content/platform-tauri.md). |
 
 Each template ships its own `README.md` (run steps, what to edit first),
 `.gitignore` (as `gitignore` — see below), a working `tsconfig.json`, and a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-syncular-app",
-  "version": "0.15.47",
+  "version": "0.16.1",
   "author": "Benjamin Kniffler",
   "repository": {
     "type": "git",

package/template/minimal/migrations/0001_initial/up.sql

@@ -1,9 +1,11 @@
 -- Your schema, one table to start. typegen reads this to derive the schema
 -- SHAPE (column types, primary key); the server manages its own sync_* tables
 -- and never runs this migration.
-CREATE TABLE notes (
+CREATE TABLE todos (
   id TEXT PRIMARY KEY,
   list_id TEXT NOT NULL,
-  body TEXT NOT NULL,
+  title TEXT NOT NULL,
+  done BOOLEAN NOT NULL,
+  position INTEGER NOT NULL,
   updated_at_ms INTEGER NOT NULL
 );

package/template/minimal/src/clients.ts

@@ -1,8 +1,8 @@
 /**
  * Two clients, one server, terminal-visible convergence.
  *
- * A writes a note; B — a completely independent client core with its own local
- * database — bootstraps, syncs, and reads the same row back. This is the proof
+ * A writes a todo; B (a completely independent client core with its own local
+ * database) bootstraps, syncs, and reads the same row back. This is the proof
  * that sync works end to end, no browser required.
  *
  * Run the server first (`bun run server`), then this script (`bun run
@@ -11,7 +11,7 @@
 import { makeClient } from './make-client';
 
 const BASE_URL = process.env.SERVER_URL ?? 'http://localhost:8787';
-const LIST_ID = 'welcome';
+const LIST_ID = 'groceries';
 
 const a = makeClient(BASE_URL, 'client-a');
 const b = makeClient(BASE_URL, 'client-b');
@@ -19,34 +19,35 @@ await a.start();
 await b.start();
 
 // Both clients subscribe to the same list (the requested scope).
-const sub = { id: 'notes', table: 'notes', scopes: { list_id: [LIST_ID] } };
+const sub = { id: 'todos', table: 'todos', scopes: { list_id: [LIST_ID] } };
 a.subscribe(sub);
 b.subscribe(sub);
 
-// A writes a note. mutate() records it locally + queues it for the next push.
-const now = Date.now();
+// A writes a todo. mutate() records it locally + queues it for the next push.
 a.mutate([
   {
-    table: 'notes',
+    table: 'todos',
     op: 'upsert',
     values: {
-      id: 'note-1',
+      id: 'todo-1',
       list_id: LIST_ID,
-      body: 'Hello from client A',
-      updated_at_ms: now,
+      title: 'Buy milk',
+      done: false,
+      position: 1,
+      updated_at_ms: Date.now(),
     },
   },
 ]);
-console.log('A: wrote note-1, pushing…');
+console.log('A: wrote todo-1, pushing…');
 await a.syncUntilIdle(); // push A's outbox to the server
 
 console.log('B: syncing…');
-await b.syncUntilIdle(); // B bootstraps the list and applies A's note
+await b.syncUntilIdle(); // B bootstraps the list and applies A's todo
 
-const rows = b.query('SELECT id, body FROM notes ORDER BY id');
+const rows = b.query('SELECT id, title FROM todos ORDER BY id');
 console.log('B sees:', rows);
 
-const converged = rows.length === 1 && rows[0]?.body === 'Hello from client A';
+const converged = rows.length === 1 && rows[0]?.title === 'Buy milk';
 console.log(converged ? '\n✓ converged' : '\n✗ did NOT converge');
 
 await a.close();

package/template/minimal/src/smoke.test.ts

@@ -43,18 +43,24 @@ test('two clients converge through the server', async () => {
   await a.start();
   await b.start();
 
-  const sub = { id: 'notes', table: 'notes', scopes: { list_id: ['welcome'] } };
+  const sub = {
+    id: 'todos',
+    table: 'todos',
+    scopes: { list_id: ['groceries'] },
+  };
   a.subscribe(sub);
   b.subscribe(sub);
 
   a.mutate([
     {
-      table: 'notes',
+      table: 'todos',
       op: 'upsert',
       values: {
-        id: 'note-1',
-        list_id: 'welcome',
-        body: 'Hello from client A',
+        id: 'todo-1',
+        list_id: 'groceries',
+        title: 'Buy milk',
+        done: false,
+        position: 1,
         updated_at_ms: Date.now(),
       },
     },
@@ -62,8 +68,8 @@ test('two clients converge through the server', async () => {
   await a.syncUntilIdle();
   await b.syncUntilIdle();
 
-  const rows = b.query('SELECT id, body FROM notes ORDER BY id');
-  expect(rows).toEqual([{ id: 'note-1', body: 'Hello from client A' }]);
+  const rows = b.query('SELECT id, title FROM todos ORDER BY id');
+  expect(rows).toEqual([{ id: 'todo-1', title: 'Buy milk' }]);
 
   await a.close();
   await b.close();

package/template/minimal/src/syncular.generated.ts

@@ -1,6 +1,6 @@
 // Generated by @syncular/typegen — DO NOT EDIT.
 // irVersion: 1
-// irHash: sha256:e2e39c94ce6c13720e1f1579e2523d460fd6bb3fea2f8eaaa114305b7aa332ba
+// irHash: sha256:87f3b0e11fc0434b220472a00110771ac69dc0d56068d8ce69d0c1eb2930894e
 
 /** Structural descriptor consumed by renderer bindings; phantom type
  * fields make row/insert/update/id inference available without imports. */
@@ -21,11 +21,13 @@ export const schema = {
   version: 1,
   tables: [
     {
-      name: 'notes',
+      name: 'todos',
       columns: [
         { name: 'id', type: 'string', nullable: false },
         { name: 'list_id', type: 'string', nullable: false },
-        { name: 'body', type: 'string', nullable: false },
+        { name: 'title', type: 'string', nullable: false },
+        { name: 'done', type: 'boolean', nullable: false },
+        { name: 'position', type: 'integer', nullable: false },
         { name: 'updated_at_ms', type: 'integer', nullable: false },
       ],
       primaryKey: 'id',
@@ -36,46 +38,52 @@ export const schema = {
   ],
 } as const;
 
-/** One notes row (§2.4 column order). */
-export interface NotesRow {
+/** One todos row (§2.4 column order). */
+export interface TodosRow {
   id: string;
   listId: string;
-  body: string;
+  title: string;
+  done: boolean;
+  position: number;
   updatedAtMs: number;
 }
 
 /** Insert shape: nullable columns may be omitted. */
-export interface NotesInsert {
+export interface TodosInsert {
   id: string;
   listId: string;
-  body: string;
+  title: string;
+  done: boolean;
+  position: number;
   updatedAtMs: number;
 }
 
 /** Update shape: primary key required, all other columns optional. */
-export interface NotesUpdate {
+export interface TodosUpdate {
   id: string;
   listId?: string;
-  body?: string;
+  title?: string;
+  done?: boolean;
+  position?: number;
   updatedAtMs?: number;
 }
 
-/** Typed mutation/resource descriptor for 'notes'. */
-export const notesTable: SyncTable<NotesRow, NotesInsert, NotesUpdate, string> = {
-  name: 'notes',
+/** Typed mutation/resource descriptor for 'todos'. */
+export const todosTable: SyncTable<TodosRow, TodosInsert, TodosUpdate, string> = {
+  name: 'todos',
   primaryKey: 'id',
   physicalPrimaryKey: 'id',
 };
 
-export interface NotesInListParams {
+export interface TodosInListParams {
   listId: string;
 }
 
-/** Requested-scope template for the 'notesInList' subscription. */
-export const notesInListSubscription = {
-  name: 'notesInList',
-  table: 'notes',
-  scopes: (params: NotesInListParams): Record<string, string[]> => ({
+/** Requested-scope template for the 'todosInList' subscription. */
+export const todosInListSubscription = {
+  name: 'todosInList',
+  table: 'todos',
+  scopes: (params: TodosInListParams): Record<string, string[]> => ({
     list_id: [params.listId],
   }),
 } as const;

package/template/minimal/syncular.ir.json

@@ -11,7 +11,7 @@
   ],
   "tables": [
     {
-      "name": "notes",
+      "name": "todos",
       "primaryKey": "id",
       "columns": [
         {
@@ -25,10 +25,20 @@
           "nullable": false
         },
         {
-          "name": "body",
+          "name": "title",
           "type": "string",
           "nullable": false
         },
+        {
+          "name": "done",
+          "type": "boolean",
+          "nullable": false
+        },
+        {
+          "name": "position",
+          "type": "integer",
+          "nullable": false
+        },
         {
           "name": "updated_at_ms",
           "type": "integer",
@@ -47,8 +57,8 @@
   ],
   "subscriptions": [
     {
-      "name": "notesInList",
-      "table": "notes",
+      "name": "todosInList",
+      "table": "todos",
       "scopes": [
         {
           "variable": "list_id",

package/template/minimal/syncular.json

@@ -6,11 +6,11 @@
     "module": "./src/syncular.generated.ts"
   },
   "schemaVersions": [{ "version": 1, "through": "0001_initial" }],
-  "tables": [{ "name": "notes", "scopes": ["list:{list_id}"] }],
+  "tables": [{ "name": "todos", "scopes": ["list:{list_id}"] }],
   "subscriptions": [
     {
-      "name": "notesInList",
-      "table": "notes",
+      "name": "todosInList",
+      "table": "todos",
       "scopes": { "list_id": ["{listId}"] }
     }
   ]

package/template/minimal/syncular.migrations.lock.json

@@ -1,37 +1,49 @@
 {
-  "formatVersion": 1,
+  "formatVersion": 2,
   "migrations": [
     {
       "name": "0001_initial",
-      "sha256": "355c1e3c68757f31a3fdd9b640982317df7f44566741e7686e51029e4c4fe4cc",
-      "tables": [
-        {
-          "name": "notes",
-          "primaryKey": "id",
-          "columns": [
-            {
-              "name": "id",
-              "type": "string",
-              "nullable": false
-            },
-            {
-              "name": "list_id",
-              "type": "string",
-              "nullable": false
-            },
-            {
-              "name": "body",
-              "type": "string",
-              "nullable": false
-            },
-            {
-              "name": "updated_at_ms",
-              "type": "integer",
-              "nullable": false
-            }
-          ]
-        }
-      ]
+      "sha256": "87b23cd0f8e3677ca6fa7ca67eb7c8373a285607b6de10854cc43df1290bb0fa"
     }
-  ]
+  ],
+  "head": {
+    "tables": [
+      {
+        "name": "todos",
+        "primaryKey": "id",
+        "columns": [
+          {
+            "name": "id",
+            "type": "string",
+            "nullable": false
+          },
+          {
+            "name": "list_id",
+            "type": "string",
+            "nullable": false
+          },
+          {
+            "name": "title",
+            "type": "string",
+            "nullable": false
+          },
+          {
+            "name": "done",
+            "type": "boolean",
+            "nullable": false
+          },
+          {
+            "name": "position",
+            "type": "integer",
+            "nullable": false
+          },
+          {
+            "name": "updated_at_ms",
+            "type": "integer",
+            "nullable": false
+          }
+        ]
+      }
+    ]
+  }
 }

package/template/tauri/src/syncular.queries.ts

@@ -1,6 +1,6 @@
 // Generated by @syncular/typegen — DO NOT EDIT.
 // irVersion: 1
-// irHash: sha256:7c07edc88f5e6f4b6da196da47e08abe4c7cb304d257a429da6950024f02fa85
+// irHash: sha256:bc1a58e1aae968ebc7be7981d2bcc5f01f176719afab10e6b5b02f4bf1d2ec86
 
 export type SyqlRuntimeErrorCode =
   | 'SYQL_RUNTIME_MISSING_REQUIRED_INPUT'
@@ -65,6 +65,11 @@ export interface QueryClient {
  *  `@syncular/react`'s `useQuery`. `Row` is the projection row
  *  type; `Params` is `undefined` for a param-less query. `sqlFor`
  *  selects a checked revision-1 SYQL physical statement when needed. */
+export interface QueryRelationPlan {
+  readonly sql: string;
+  readonly relations: readonly { readonly table: string; readonly start: number; readonly end: number; readonly alias?: string }[];
+}
+
 export interface NamedQuery<Row, Params = undefined> {
   readonly id: string;
   readonly hasParams: boolean;
@@ -72,6 +77,7 @@ export interface NamedQuery<Row, Params = undefined> {
   readonly mapRow: (row: Readonly<Record<string, unknown>>) => Row;
   readonly tables: readonly string[];
   readonly resultColumns: readonly QueryResultColumn[];
+  readonly relationPlans: readonly QueryRelationPlan[];
   readonly bind: (params: Params) => readonly QueryValue[];
   readonly sqlFor?: (params: Params) => string;
   readonly dependencies: (params: Params) => readonly QueryDependency[];
@@ -139,8 +145,8 @@ function listTodosValidate(raw?: ListTodosParams): ListTodosParams {
 /** Tables 'listTodos' reads (compatibility/export surface). */
 export const listTodosTables = ['todos'] as const;
 
-const listTodosStatements: { sql: string; bind: (params: ListTodosParams) => QueryValue[] }[] = [
-  { sql: 'select id, list_id AS listId, title, done, position, updated_at_ms AS updatedAtMs from todos where todos.list_id = ? order by position, id', bind: (params) => [params.listId] },
+const listTodosStatements: (QueryRelationPlan & { bind: (params: ListTodosParams) => QueryValue[] })[] = [
+  { sql: 'select id, list_id AS listId, title, done, position, updated_at_ms AS updatedAtMs from todos where todos.list_id = ? order by position, id', relations: [{"table":"todos","start":87,"end":92}], bind: (params) => [params.listId] },
 ];
 function listTodosSelect(raw: ListTodosParams): { sql: string; bind: QueryValue[] } {
   const params = listTodosValidate(raw);
@@ -159,12 +165,13 @@ export async function listTodos(client: QueryClient, params: ListTodosParams): P
 
 /** Revisioned reactive descriptor for `useQuery(listTodosQuery, params)`. */
 export const listTodosQuery: NamedQuery<ListTodosRow, ListTodosParams> = {
-  id: 'sha256:7c07edc88f5e6f4b6da196da47e08abe4c7cb304d257a429da6950024f02fa85/listTodos',
+  id: 'sha256:bc1a58e1aae968ebc7be7981d2bcc5f01f176719afab10e6b5b02f4bf1d2ec86/listTodos',
   hasParams: true,
   sql: 'select id, list_id AS listId, title, done, position, updated_at_ms AS updatedAtMs from todos where todos.list_id = ? order by position, id',
   mapRow: listTodosMapRow,
   sqlFor: (params: ListTodosParams) => listTodosSelect(params).sql,
   tables: listTodosTables,
+  relationPlans: listTodosStatements,
   resultColumns: [{ name: 'id', type: 'string', nullable: false }, { name: 'listId', type: 'string', nullable: false }, { name: 'title', type: 'string', nullable: false }, { name: 'done', type: 'boolean', nullable: false }, { name: 'position', type: 'integer', nullable: false }, { name: 'updatedAtMs', type: 'integer', nullable: false }],
   dependencies: (params) => [
     { table: 'todos', scopeKeys: ['list:' + String(params.listId) + ''] },

package/template/tauri/src-tauri/Cargo.toml

@@ -21,7 +21,7 @@ tauri = { version = "2", features = [] }
 # The syncular plugin from crates.io. `native-transport` gives the core its
 # real HTTP + WebSocket transport (ureq + tungstenite) inside the host
 # process — the webview never talks to the sync server directly.
-tauri-plugin-syncular = { version = "0.15.47", features = ["native-transport"] }
+tauri-plugin-syncular = { version = "0.16.1", features = ["native-transport"] }
 
 [features]
 default = []

package/template/tauri/syncular.queries.ir.json

@@ -1,5 +1,5 @@
 {
-  "queryIrVersion": 3,
+  "queryIrVersion": 4,
   "queries": [
     {
       "name": "listTodos",
@@ -7,6 +7,13 @@
       "sourceSql": "select id, list_id AS listId, title, done, position, updated_at_ms AS updatedAtMs from todos\n  where todos.list_id = :listId\n  order by position, id",
       "sql": "select id, list_id AS listId, title, done, position, updated_at_ms AS updatedAtMs from todos\n  where todos.list_id = :listId\n  order by position, id",
       "positionalSql": "select id, list_id AS listId, title, done, position, updated_at_ms AS updatedAtMs from todos where todos.list_id = ? order by position, id",
+      "relations": [
+        {
+          "table": "todos",
+          "start": 87,
+          "end": 92
+        }
+      ],
       "params": [
         {
           "name": "listId",
@@ -126,6 +133,13 @@
               "activationMask": 0,
               "sql": "select id, list_id AS listId, title, done, position, updated_at_ms AS updatedAtMs from todos\n  where todos.list_id = :listId\n  order by position, id",
               "positionalSql": "select id, list_id AS listId, title, done, position, updated_at_ms AS updatedAtMs from todos where todos.list_id = ? order by position, id",
+              "relations": [
+                {
+                  "table": "todos",
+                  "start": 87,
+                  "end": 92
+                }
+              ],
               "binds": [
                 {
                   "kind": "value",