zitejs 0.9.28 → 0.9.29

package/dist/cjs/sync/lib.js

@@ -64,10 +64,23 @@ function generateSchema(base) {
 function generateDbTs(base, schema, integrationId = 'databases') {
     const lines = [];
     lines.push('// Auto-generated by zitejs sync. Do not edit manually.');
-    lines.push('// Table methods: .findAll(opts?) → { records: T[], total, hasMore }');
-    lines.push('//   .findOne(id) → T | .create(data) → T | .update(id, data) → T');
-    lines.push('//   .delete(id) → { deleted: true } | .bulkCreate(records) → T[]');
-    lines.push('// Raw SQL: zite.sql({ query: "SELECT..." }) → { rows: Record<string, unknown>[] }');
+    lines.push('//');
+    lines.push('// Usage in endpoint files (src/api/*.ts):');
+    lines.push('//   import { zite } from "zitejs/db";');
+    lines.push('//');
+    lines.push('// Always use "zitejs/db" — never use relative paths like "../../.zite/db".');
+    lines.push('// The tsconfig aliases resolve zitejs/* imports to the correct .zite/ files.');
+    lines.push('//');
+    lines.push('// Table client methods:');
+    lines.push('//   .findAll(opts?) → { records: T[], total: number, hasMore: boolean }');
+    lines.push('//   .findOne(id) → T');
+    lines.push('//   .create(data) → T');
+    lines.push('//   .update(id, data) → T');
+    lines.push('//   .delete(id) → { deleted: true }');
+    lines.push('//   .bulkCreate(records) → T[]');
+    lines.push('//');
+    lines.push('// Raw SQL:');
+    lines.push('//   zite.sql({ query: "SELECT..." }) → { rows: Record<string, unknown>[] }');
     lines.push("import { createTableClient, createSqlClient } from 'zitejs/runtime';");
     lines.push('');
     for (const table of base.tables ?? []) {

package/dist/esm/sync/lib.js

@@ -53,10 +53,23 @@ export function generateSchema(base) {
 export function generateDbTs(base, schema, integrationId = 'databases') {
     const lines = [];
     lines.push('// Auto-generated by zitejs sync. Do not edit manually.');
-    lines.push('// Table methods: .findAll(opts?) → { records: T[], total, hasMore }');
-    lines.push('//   .findOne(id) → T | .create(data) → T | .update(id, data) → T');
-    lines.push('//   .delete(id) → { deleted: true } | .bulkCreate(records) → T[]');
-    lines.push('// Raw SQL: zite.sql({ query: "SELECT..." }) → { rows: Record<string, unknown>[] }');
+    lines.push('//');
+    lines.push('// Usage in endpoint files (src/api/*.ts):');
+    lines.push('//   import { zite } from "zitejs/db";');
+    lines.push('//');
+    lines.push('// Always use "zitejs/db" — never use relative paths like "../../.zite/db".');
+    lines.push('// The tsconfig aliases resolve zitejs/* imports to the correct .zite/ files.');
+    lines.push('//');
+    lines.push('// Table client methods:');
+    lines.push('//   .findAll(opts?) → { records: T[], total: number, hasMore: boolean }');
+    lines.push('//   .findOne(id) → T');
+    lines.push('//   .create(data) → T');
+    lines.push('//   .update(id, data) → T');
+    lines.push('//   .delete(id) → { deleted: true }');
+    lines.push('//   .bulkCreate(records) → T[]');
+    lines.push('//');
+    lines.push('// Raw SQL:');
+    lines.push('//   zite.sql({ query: "SELECT..." }) → { rows: Record<string, unknown>[] }');
     lines.push("import { createTableClient, createSqlClient } from 'zitejs/runtime';");
     lines.push('');
     for (const table of base.tables ?? []) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zitejs",
-  "version": "0.9.28",
+  "version": "0.9.29",
   "description": "The Zite framework — build apps on Zite Database",
   "type": "module",
   "main": "./dist/cjs/runtime/index.js",