zitejs 0.9.63 → 0.9.65

package/dist/cjs/api/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCaller = void 0;
+var index_js_1 = require("../caller/index.js");
+Object.defineProperty(exports, "createCaller", { enumerable: true, get: function () { return index_js_1.createCaller; } });

package/dist/cjs/db/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTableClient = void 0;
+var index_js_1 = require("../runtime/index.js");
+Object.defineProperty(exports, "createTableClient", { enumerable: true, get: function () { return index_js_1.createTableClient; } });

package/dist/cjs/runtime/index.d.ts

@@ -1,5 +1,13 @@
 import type { NotificationsCreateParams, NotificationsCreateResult } from "../notifications/index.js";
 import type { MetaListUsersResult } from "../meta/index.js";
+export interface BulkCreateResult<T> {
+    success: boolean;
+    records: T[];
+}
+export interface DeleteResult {
+    success: boolean;
+    id: string;
+}
 export interface TableClient<T> {
     findAll(options?: {
         limit?: number;
@@ -9,23 +17,20 @@ export interface TableClient<T> {
         filters?: unknown;
     }): Promise<{
         records: T[];
-        total: number;
         hasMore: boolean;
     }>;
     findOne(recordId: string | {
         filters?: unknown;
         filter?: unknown;
-    }): Promise<T>;
+    }): Promise<T | undefined>;
     create(data: {
         record: Partial<T>;
     }): Promise<T>;
     update(id: string, data: {
         record: Partial<T>;
     }): Promise<T>;
-    delete(id: string): Promise<{
-        deleted: true;
-    }>;
-    bulkCreate(records: Partial<T>[]): Promise<T[]>;
+    delete(id: string): Promise<DeleteResult>;
+    bulkCreate(records: Partial<T>[]): Promise<BulkCreateResult<T>>;
 }
 export declare function createTableClient<T>(className: string): TableClient<T>;
 export interface SqlResult {
@@ -57,14 +62,15 @@ export interface AirtableTableClient<T> {
     }): Promise<T | undefined>;
     create(data: {
         record: Partial<T>;
-    }): Promise<T>;
+    }): Promise<T | undefined>;
     bulkCreate(records: Partial<T>[]): Promise<T[]>;
     update(id: string, data: {
         record: Partial<T>;
-    }): Promise<T>;
-    delete(id: string): Promise<{
-        deleted: true;
-    }>;
+    }): Promise<{
+        id: string;
+        fields: T;
+    } | undefined>;
+    delete(id: string): Promise<DeleteResult>;
 }
 export declare function createAirtableClient<T>(integrationId: string, className: string, implicitParams: Record<string, unknown>): AirtableTableClient<T>;
 export declare function createNotificationsClient(): {

package/dist/cjs/sync/lib.js

@@ -240,6 +240,53 @@ function generateSentinelSdkTypes() {
         "",
     ];
 }
+function buildLinkTableComments(schema) {
+    const tablesById = new Map();
+    for (const t of schema.tables)
+        tablesById.set(t.id, t);
+    const seen = new Set();
+    const entries = [];
+    for (const table of schema.tables) {
+        for (const field of table.fields) {
+            if (field.definition.type !== "linked_record")
+                continue;
+            const tpl = field.definition.template;
+            if (tpl.isInverse)
+                continue;
+            const targetId = tpl.tableId;
+            if (!targetId)
+                continue;
+            const target = tablesById.get(targetId);
+            if (!target)
+                continue;
+            const sourceSdk = toPascalCase(table.sdkName);
+            const targetSdk = toPascalCase(target.sdkName);
+            const [first, second] = [sourceSdk, targetSdk].sort();
+            const linkName = `${first}${second}`;
+            if (seen.has(linkName))
+                continue;
+            seen.add(linkName);
+            const isSelf = table.id === targetId;
+            const col1 = isSelf
+                ? `source${first}Id`
+                : `${first.charAt(0).toLowerCase()}${first.slice(1)}Id`;
+            const col2 = isSelf
+                ? `target${second}Id`
+                : `${second.charAt(0).toLowerCase()}${second.slice(1)}Id`;
+            entries.push({ name: linkName, cols: [col1, col2] });
+        }
+    }
+    if (entries.length === 0)
+        return [];
+    const lines = [
+        "//",
+        "// Link tables for zite.sql() JOINs (use these exact names):",
+    ];
+    for (const e of entries) {
+        lines.push(`//   "${e.name}" — columns: "${e.cols[0]}", "${e.cols[1]}"`);
+    }
+    return lines;
+}
 /**
  * Generate .zite/db.ts purely from ZiteSchema.
  * Pure function — no external data needed beyond what's in the schema file.
@@ -255,13 +302,13 @@ function generateDbTs(schema) {
     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("//   .findAll(opts?) → { records: T[], hasMore: boolean }");
     lines.push("//     opts: { limit?, offset?, sort?, filter?, filters? }");
-    lines.push("//   .findOne(id | { filters }) → T");
+    lines.push("//   .findOne(id | { filters }) → T | undefined");
     lines.push("//   .create({ record }) → T");
     lines.push("//   .update(id, { record }) → T");
-    lines.push("//   .delete(id) → { deleted: true }");
-    lines.push("//   .bulkCreate(records) → T[]");
+    lines.push("//   .delete(id) → { success: boolean, id: string }");
+    lines.push("//   .bulkCreate(records) → { success: boolean, records: T[] }");
     lines.push("//");
     lines.push("// Raw SQL (read-only SELECTs for aggregates, joins, multi-table queries):");
     lines.push('//   zite.sql({ query: "SELECT ...", params?: [...] })');
@@ -271,11 +318,10 @@ function generateDbTs(schema) {
     lines.push("//   - Use SDK names for tables (PascalCase) and fields (camelCase)");
     lines.push('//   - ALWAYS double-quote every identifier: FROM "Orders", WHERE "status" = $1');
     lines.push("//   - Use params array for user input ($1, $2, ...): never interpolate into SQL");
-    lines.push('//   - Link tables: alphabetical PascalCase concat (Items+Orders → "ItemsOrders")');
-    lines.push('//     with id columns: "itemsId", "ordersId"');
     lines.push("//   - Soft-deleted rows are excluded automatically — no WHERE deleted_at IS NULL");
     lines.push("//   - SELECT only — use .create/.update/.delete for writes");
     lines.push('//   - Load the "zite:sql" skill for full SQL reference (formulas, lookups, etc.)');
+    lines.push(...buildLinkTableComments(schema));
     lines.push("import { createTableClient, createSqlClient, createNotificationsClient, createMetaClient } from 'zitejs/runtime';");
     lines.push("");
     for (const table of schema.tables) {
@@ -597,10 +643,10 @@ function generateAirtableTs(lock) {
         "//   findAll(options?: { offset?: string; limit?: number; filters?: unknown })",
         "//     => Promise<{ records: T[]; offset: string | undefined; hasMore: boolean }>",
         "//   findOne(params: { id?: string; filters?: unknown }) => Promise<T | undefined>",
-        "//   create(data: { record: Partial<T> }) => Promise<T>",
+        "//   create(data: { record: Partial<T> }) => Promise<T | undefined>",
         "//   bulkCreate(records: Partial<T>[]) => Promise<T[]>",
-        "//   update(id: string, data: { record: Partial<T> }) => Promise<T>",
-        "//   delete(id: string) => Promise<{ deleted: true }>",
+        "//   update(id: string, data: { record: Partial<T> }) => Promise<{ id: string, fields: T } | undefined>",
+        "//   delete(id: string) => Promise<{ success: boolean, id: string }>",
         "//",
         "// Usage tips:",
         "//   - Airtable has a strict rate limit of 5 requests/second per base",

package/dist/esm/api/index.d.ts

@@ -0,0 +1,2 @@
+export { createCaller } from '../caller/index.js';
+export type { EndpointConfig } from '../caller/index.js';

package/dist/esm/api/index.js

@@ -0,0 +1 @@
+export { createCaller } from '../caller/index.js';

package/dist/esm/db/index.d.ts

@@ -0,0 +1,2 @@
+export { createTableClient } from '../runtime/index.js';
+export type { TableClient } from '../runtime/index.js';

package/dist/esm/db/index.js

@@ -0,0 +1 @@
+export { createTableClient } from '../runtime/index.js';

package/dist/esm/runtime/index.d.ts

@@ -1,5 +1,13 @@
 import type { NotificationsCreateParams, NotificationsCreateResult } from "../notifications/index.js";
 import type { MetaListUsersResult } from "../meta/index.js";
+export interface BulkCreateResult<T> {
+    success: boolean;
+    records: T[];
+}
+export interface DeleteResult {
+    success: boolean;
+    id: string;
+}
 export interface TableClient<T> {
     findAll(options?: {
         limit?: number;
@@ -9,23 +17,20 @@ export interface TableClient<T> {
         filters?: unknown;
     }): Promise<{
         records: T[];
-        total: number;
         hasMore: boolean;
     }>;
     findOne(recordId: string | {
         filters?: unknown;
         filter?: unknown;
-    }): Promise<T>;
+    }): Promise<T | undefined>;
     create(data: {
         record: Partial<T>;
     }): Promise<T>;
     update(id: string, data: {
         record: Partial<T>;
     }): Promise<T>;
-    delete(id: string): Promise<{
-        deleted: true;
-    }>;
-    bulkCreate(records: Partial<T>[]): Promise<T[]>;
+    delete(id: string): Promise<DeleteResult>;
+    bulkCreate(records: Partial<T>[]): Promise<BulkCreateResult<T>>;
 }
 export declare function createTableClient<T>(className: string): TableClient<T>;
 export interface SqlResult {
@@ -57,14 +62,15 @@ export interface AirtableTableClient<T> {
     }): Promise<T | undefined>;
     create(data: {
         record: Partial<T>;
-    }): Promise<T>;
+    }): Promise<T | undefined>;
     bulkCreate(records: Partial<T>[]): Promise<T[]>;
     update(id: string, data: {
         record: Partial<T>;
-    }): Promise<T>;
-    delete(id: string): Promise<{
-        deleted: true;
-    }>;
+    }): Promise<{
+        id: string;
+        fields: T;
+    } | undefined>;
+    delete(id: string): Promise<DeleteResult>;
 }
 export declare function createAirtableClient<T>(integrationId: string, className: string, implicitParams: Record<string, unknown>): AirtableTableClient<T>;
 export declare function createNotificationsClient(): {

package/dist/esm/sync/lib.js

@@ -229,6 +229,53 @@ function generateSentinelSdkTypes() {
         "",
     ];
 }
+function buildLinkTableComments(schema) {
+    const tablesById = new Map();
+    for (const t of schema.tables)
+        tablesById.set(t.id, t);
+    const seen = new Set();
+    const entries = [];
+    for (const table of schema.tables) {
+        for (const field of table.fields) {
+            if (field.definition.type !== "linked_record")
+                continue;
+            const tpl = field.definition.template;
+            if (tpl.isInverse)
+                continue;
+            const targetId = tpl.tableId;
+            if (!targetId)
+                continue;
+            const target = tablesById.get(targetId);
+            if (!target)
+                continue;
+            const sourceSdk = toPascalCase(table.sdkName);
+            const targetSdk = toPascalCase(target.sdkName);
+            const [first, second] = [sourceSdk, targetSdk].sort();
+            const linkName = `${first}${second}`;
+            if (seen.has(linkName))
+                continue;
+            seen.add(linkName);
+            const isSelf = table.id === targetId;
+            const col1 = isSelf
+                ? `source${first}Id`
+                : `${first.charAt(0).toLowerCase()}${first.slice(1)}Id`;
+            const col2 = isSelf
+                ? `target${second}Id`
+                : `${second.charAt(0).toLowerCase()}${second.slice(1)}Id`;
+            entries.push({ name: linkName, cols: [col1, col2] });
+        }
+    }
+    if (entries.length === 0)
+        return [];
+    const lines = [
+        "//",
+        "// Link tables for zite.sql() JOINs (use these exact names):",
+    ];
+    for (const e of entries) {
+        lines.push(`//   "${e.name}" — columns: "${e.cols[0]}", "${e.cols[1]}"`);
+    }
+    return lines;
+}
 /**
  * Generate .zite/db.ts purely from ZiteSchema.
  * Pure function — no external data needed beyond what's in the schema file.
@@ -244,13 +291,13 @@ export function generateDbTs(schema) {
     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("//   .findAll(opts?) → { records: T[], hasMore: boolean }");
     lines.push("//     opts: { limit?, offset?, sort?, filter?, filters? }");
-    lines.push("//   .findOne(id | { filters }) → T");
+    lines.push("//   .findOne(id | { filters }) → T | undefined");
     lines.push("//   .create({ record }) → T");
     lines.push("//   .update(id, { record }) → T");
-    lines.push("//   .delete(id) → { deleted: true }");
-    lines.push("//   .bulkCreate(records) → T[]");
+    lines.push("//   .delete(id) → { success: boolean, id: string }");
+    lines.push("//   .bulkCreate(records) → { success: boolean, records: T[] }");
     lines.push("//");
     lines.push("// Raw SQL (read-only SELECTs for aggregates, joins, multi-table queries):");
     lines.push('//   zite.sql({ query: "SELECT ...", params?: [...] })');
@@ -260,11 +307,10 @@ export function generateDbTs(schema) {
     lines.push("//   - Use SDK names for tables (PascalCase) and fields (camelCase)");
     lines.push('//   - ALWAYS double-quote every identifier: FROM "Orders", WHERE "status" = $1');
     lines.push("//   - Use params array for user input ($1, $2, ...): never interpolate into SQL");
-    lines.push('//   - Link tables: alphabetical PascalCase concat (Items+Orders → "ItemsOrders")');
-    lines.push('//     with id columns: "itemsId", "ordersId"');
     lines.push("//   - Soft-deleted rows are excluded automatically — no WHERE deleted_at IS NULL");
     lines.push("//   - SELECT only — use .create/.update/.delete for writes");
     lines.push('//   - Load the "zite:sql" skill for full SQL reference (formulas, lookups, etc.)');
+    lines.push(...buildLinkTableComments(schema));
     lines.push("import { createTableClient, createSqlClient, createNotificationsClient, createMetaClient } from 'zitejs/runtime';");
     lines.push("");
     for (const table of schema.tables) {
@@ -586,10 +632,10 @@ export function generateAirtableTs(lock) {
         "//   findAll(options?: { offset?: string; limit?: number; filters?: unknown })",
         "//     => Promise<{ records: T[]; offset: string | undefined; hasMore: boolean }>",
         "//   findOne(params: { id?: string; filters?: unknown }) => Promise<T | undefined>",
-        "//   create(data: { record: Partial<T> }) => Promise<T>",
+        "//   create(data: { record: Partial<T> }) => Promise<T | undefined>",
         "//   bulkCreate(records: Partial<T>[]) => Promise<T[]>",
-        "//   update(id: string, data: { record: Partial<T> }) => Promise<T>",
-        "//   delete(id: string) => Promise<{ deleted: true }>",
+        "//   update(id: string, data: { record: Partial<T> }) => Promise<{ id: string, fields: T } | undefined>",
+        "//   delete(id: string) => Promise<{ success: boolean, id: string }>",
         "//",
         "// Usage tips:",
         "//   - Airtable has a strict rate limit of 5 requests/second per base",

package/package.json

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