zitejs 0.9.42 → 0.9.43

package/dist/cjs/bundle/index.js

@@ -250,6 +250,15 @@ function createAliasPlugin(opts) {
                 }
                 return { path: 'zitejs/db', external: true };
             });
+            // Resolve zitejs/integrations to .zite/integrations/airtable.ts
+            build.onResolve({ filter: /^zitejs\/integrations$/ }, () => {
+                if (opts.baseDir) {
+                    const intPath = path.resolve(opts.baseDir, '.zite/integrations/airtable.ts');
+                    if (fs.existsSync(intPath))
+                        return { path: intPath };
+                }
+                return { path: 'zitejs/integrations', external: true };
+            });
             // zitejs/runtime is NOT in PREBUNDLED_LIBS — it's a thin fetch()
             // wrapper that gets bundled inline by esbuild (no special handling).
             for (const [pkgName, modulePath] of Object.entries(PREBUNDLED_LIBS)) {

package/dist/cjs/dev/index.js

@@ -53,6 +53,42 @@ function regenerateAppApiTs(appDir) {
         console.log(`Updated apps/${appDir}/.zite/api.ts`);
     }
 }
+function regenerateAppAirtableSdk(appDir) {
+    const lockPath = (0, path_1.join)('apps', appDir, 'zite.lock');
+    if (!(0, fs_2.existsSync)(lockPath))
+        return;
+    try {
+        const lockContent = JSON.parse((0, fs_2.readFileSync)(lockPath, 'utf-8'));
+        const integrations = lockContent.integrations ?? {};
+        for (const [integrationId, integration] of Object.entries(integrations)) {
+            const int = integration;
+            if (!int.idMappings?.tables)
+                continue;
+            const airtableLock = {
+                integrationId,
+                tables: Object.entries(int.idMappings.tables).map(([sdkName, tableId]) => ({
+                    id: tableId,
+                    sdkName,
+                    fields: Object.entries(int.idMappings?.fields?.[sdkName] ?? {}).map(([fieldSdkName, fieldId]) => ({
+                        id: fieldId,
+                        sdkName: fieldSdkName,
+                        type: 'singleLineText',
+                    })),
+                })),
+            };
+            const content = (0, lib_js_1.generateAirtableTs)(airtableLock);
+            if (content) {
+                const outDir = (0, path_1.join)('apps', appDir, '.zite', 'integrations');
+                (0, fs_2.mkdirSync)(outDir, { recursive: true });
+                (0, fs_2.writeFileSync)((0, path_1.join)(outDir, 'airtable.ts'), content);
+                console.log(`Updated apps/${appDir}/.zite/integrations/airtable.ts`);
+            }
+        }
+    }
+    catch {
+        // Lock file invalid or missing — skip
+    }
+}
 async function runGenerate() {
     // 1. Run sync (generates root .zite/db.ts)
     try {
@@ -66,6 +102,7 @@ async function runGenerate() {
     for (const app of appDirs) {
         regenerateAppApiTs(app);
         regenerateAppTypedWrappers(app);
+        regenerateAppAirtableSdk(app);
     }
     console.log('Done!');
 }

package/dist/cjs/runtime/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCaller = void 0;
 exports.createTableClient = createTableClient;
 exports.createSqlClient = createSqlClient;
+exports.createAirtableClient = createAirtableClient;
 function getSdkCall() {
     const fn = globalThis.__wrapSdkCall;
     if (!fn) {
@@ -76,5 +77,34 @@ function createSqlClient() {
         ...params,
     });
 }
+function createAirtableClient(integrationId, className, implicitParams) {
+    return {
+        findAll: (options) => getSdkCall()(integrationId, className, "findAll", {
+            ...implicitParams,
+            ...options,
+        }),
+        findOne: (params) => getSdkCall()(integrationId, className, "findOne", {
+            ...implicitParams,
+            ...params,
+        }),
+        create: (data) => getSdkCall()(integrationId, className, "create", {
+            ...implicitParams,
+            ...data,
+        }),
+        bulkCreate: (records) => getSdkCall()(integrationId, className, "bulkCreate", {
+            ...implicitParams,
+            records,
+        }),
+        update: (id, data) => getSdkCall()(integrationId, className, "update", {
+            ...implicitParams,
+            id,
+            ...data,
+        }),
+        delete: (id) => getSdkCall()(integrationId, className, "delete", {
+            ...implicitParams,
+            id,
+        }),
+    };
+}
 var index_js_1 = require("../caller/index.js");
 Object.defineProperty(exports, "createCaller", { enumerable: true, get: function () { return index_js_1.createCaller; } });

package/dist/cjs/sync/lib.js

@@ -7,6 +7,7 @@ exports.generateDbTs = generateDbTs;
 exports.generateApiTs = generateApiTs;
 exports.generateUserTs = generateUserTs;
 exports.generateAuthWrapperTs = generateAuthWrapperTs;
+exports.generateAirtableTs = generateAirtableTs;
 exports.generateBackendWrapperTs = generateBackendWrapperTs;
 const FIELD_TYPE_MAP = {
     single_line_text: "string",
@@ -357,6 +358,86 @@ function generateAuthWrapperTs() {
         "",
     ].join("\n");
 }
+const AIRTABLE_FIELD_TYPE_MAP = {
+    singleLineText: "string",
+    multilineText: "string",
+    richText: "string",
+    email: "string",
+    url: "string",
+    phoneNumber: "string",
+    number: "number",
+    currency: "number",
+    percent: "number",
+    rating: "number",
+    duration: "number",
+    singleSelect: "string",
+    multipleSelects: "string[]",
+    checkbox: "boolean",
+    date: "string",
+    dateTime: "string",
+    attachment: "Array<{ url: string; filename?: string }>",
+    multipleRecordLinks: "string | string[]",
+    formula: "unknown",
+    rollup: "unknown",
+    lookup: "unknown",
+    count: "number",
+    autoNumber: "number",
+    barcode: "string",
+    button: "unknown",
+    createdTime: "string",
+    lastModifiedTime: "string",
+    createdBy: "unknown",
+    lastModifiedBy: "unknown",
+    externalSyncSource: "unknown",
+    aiText: "string",
+};
+function airtableTsType(field) {
+    if ((field.type === "singleSelect" || field.type === "multipleSelects") &&
+        field.options &&
+        field.options.length > 0) {
+        const literals = field.options
+            .slice(0, MAX_SELECT_OPTIONS)
+            .map((o) => `"${o.replace(/"/g, '\\"')}"`)
+            .join(" | ");
+        const union = `${literals} | string`;
+        if (field.type === "multipleSelects")
+            return `(${union})[]`;
+        return union;
+    }
+    return AIRTABLE_FIELD_TYPE_MAP[field.type] ?? "unknown";
+}
+function generateAirtableTs(lock) {
+    if (lock.tables.length === 0)
+        return null;
+    const lines = [
+        "// Auto-generated by zitejs generate from zite.lock. Do not edit manually.",
+        "// Airtable SDK — uses createAirtableClient from zitejs/runtime.",
+        "// The airtable package is externalized (not bundled per-endpoint).",
+        "",
+        "import { createAirtableClient } from 'zitejs/runtime';",
+        "",
+    ];
+    for (const table of lock.tables) {
+        const recordType = `${table.sdkName}RecordType`;
+        lines.push(`export type ${recordType} = {`);
+        lines.push("  id: string;");
+        for (const field of table.fields) {
+            if (field.sdkName === "id")
+                continue;
+            const tsType = airtableTsType(field);
+            lines.push(`  ${field.sdkName}: ${tsType};`);
+        }
+        lines.push("};");
+        lines.push("");
+        lines.push(`export const ${table.sdkName} = createAirtableClient<${recordType}>(`);
+        lines.push(`  '${lock.integrationId}',`);
+        lines.push(`  '${table.sdkName}',`);
+        lines.push(`  { tableId: '${table.id}' },`);
+        lines.push(`);`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
 function generateBackendWrapperTs() {
     return [
         "// Auto-generated type-narrowing wrapper. Do not edit manually.",

package/dist/esm/bundle/index.js

@@ -214,6 +214,15 @@ function createAliasPlugin(opts) {
                 }
                 return { path: 'zitejs/db', external: true };
             });
+            // Resolve zitejs/integrations to .zite/integrations/airtable.ts
+            build.onResolve({ filter: /^zitejs\/integrations$/ }, () => {
+                if (opts.baseDir) {
+                    const intPath = path.resolve(opts.baseDir, '.zite/integrations/airtable.ts');
+                    if (fs.existsSync(intPath))
+                        return { path: intPath };
+                }
+                return { path: 'zitejs/integrations', external: true };
+            });
             // zitejs/runtime is NOT in PREBUNDLED_LIBS — it's a thin fetch()
             // wrapper that gets bundled inline by esbuild (no special handling).
             for (const [pkgName, modulePath] of Object.entries(PREBUNDLED_LIBS)) {

package/dist/esm/dev/index.js

@@ -2,7 +2,7 @@ import { watch } from 'fs';
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, } from 'fs';
 import { join } from 'path';
 import { runSync } from '../sync/index.js';
-import { generateApiTs, generateUserTs, generateAuthWrapperTs, generateBackendWrapperTs, } from '../sync/lib.js';
+import { generateApiTs, generateUserTs, generateAuthWrapperTs, generateBackendWrapperTs, generateAirtableTs, } from '../sync/lib.js';
 const debounceTimers = new Map();
 function debounce(key, fn, ms) {
     const existing = debounceTimers.get(key);
@@ -49,6 +49,42 @@ function regenerateAppApiTs(appDir) {
         console.log(`Updated apps/${appDir}/.zite/api.ts`);
     }
 }
+function regenerateAppAirtableSdk(appDir) {
+    const lockPath = join('apps', appDir, 'zite.lock');
+    if (!existsSync(lockPath))
+        return;
+    try {
+        const lockContent = JSON.parse(readFileSync(lockPath, 'utf-8'));
+        const integrations = lockContent.integrations ?? {};
+        for (const [integrationId, integration] of Object.entries(integrations)) {
+            const int = integration;
+            if (!int.idMappings?.tables)
+                continue;
+            const airtableLock = {
+                integrationId,
+                tables: Object.entries(int.idMappings.tables).map(([sdkName, tableId]) => ({
+                    id: tableId,
+                    sdkName,
+                    fields: Object.entries(int.idMappings?.fields?.[sdkName] ?? {}).map(([fieldSdkName, fieldId]) => ({
+                        id: fieldId,
+                        sdkName: fieldSdkName,
+                        type: 'singleLineText',
+                    })),
+                })),
+            };
+            const content = generateAirtableTs(airtableLock);
+            if (content) {
+                const outDir = join('apps', appDir, '.zite', 'integrations');
+                mkdirSync(outDir, { recursive: true });
+                writeFileSync(join(outDir, 'airtable.ts'), content);
+                console.log(`Updated apps/${appDir}/.zite/integrations/airtable.ts`);
+            }
+        }
+    }
+    catch {
+        // Lock file invalid or missing — skip
+    }
+}
 export async function runGenerate() {
     // 1. Run sync (generates root .zite/db.ts)
     try {
@@ -62,6 +98,7 @@ export async function runGenerate() {
     for (const app of appDirs) {
         regenerateAppApiTs(app);
         regenerateAppTypedWrappers(app);
+        regenerateAppAirtableSdk(app);
     }
     console.log('Done!');
 }

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

@@ -39,5 +39,31 @@ export declare function createSqlClient(): (params: {
     query: string;
     params?: unknown[];
 }) => Promise<SqlResult>;
+export interface AirtableTableClient<T> {
+    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>;
+    bulkCreate(records: Partial<T>[]): Promise<T[]>;
+    update(id: string, data: {
+        record: Partial<T>;
+    }): Promise<T>;
+    delete(id: string): Promise<{
+        deleted: true;
+    }>;
+}
+export declare function createAirtableClient<T>(integrationId: string, className: string, implicitParams: Record<string, unknown>): AirtableTableClient<T>;
 export { createCaller } from "../caller/index.js";
 export type { EndpointConfig } from "../caller/index.js";

package/dist/esm/runtime/index.js

@@ -71,4 +71,33 @@ export function createSqlClient() {
         ...params,
     });
 }
+export function createAirtableClient(integrationId, className, implicitParams) {
+    return {
+        findAll: (options) => getSdkCall()(integrationId, className, "findAll", {
+            ...implicitParams,
+            ...options,
+        }),
+        findOne: (params) => getSdkCall()(integrationId, className, "findOne", {
+            ...implicitParams,
+            ...params,
+        }),
+        create: (data) => getSdkCall()(integrationId, className, "create", {
+            ...implicitParams,
+            ...data,
+        }),
+        bulkCreate: (records) => getSdkCall()(integrationId, className, "bulkCreate", {
+            ...implicitParams,
+            records,
+        }),
+        update: (id, data) => getSdkCall()(integrationId, className, "update", {
+            ...implicitParams,
+            id,
+            ...data,
+        }),
+        delete: (id) => getSdkCall()(integrationId, className, "delete", {
+            ...implicitParams,
+            id,
+        }),
+    };
+}
 export { createCaller } from "../caller/index.js";

package/dist/esm/sync/lib.d.ts

@@ -36,4 +36,20 @@ export declare function generateUserTs(usersTableFields?: Array<{
     type: string;
 }>): string;
 export declare function generateAuthWrapperTs(): string;
+export type AirtableLockField = {
+    id: string;
+    sdkName: string;
+    type: string;
+    options?: string[];
+};
+export type AirtableLockTable = {
+    id: string;
+    sdkName: string;
+    fields: AirtableLockField[];
+};
+export type AirtableLock = {
+    integrationId: string;
+    tables: AirtableLockTable[];
+};
+export declare function generateAirtableTs(lock: AirtableLock): string | null;
 export declare function generateBackendWrapperTs(): string;

package/dist/esm/sync/lib.js

@@ -347,6 +347,86 @@ export function generateAuthWrapperTs() {
         "",
     ].join("\n");
 }
+const AIRTABLE_FIELD_TYPE_MAP = {
+    singleLineText: "string",
+    multilineText: "string",
+    richText: "string",
+    email: "string",
+    url: "string",
+    phoneNumber: "string",
+    number: "number",
+    currency: "number",
+    percent: "number",
+    rating: "number",
+    duration: "number",
+    singleSelect: "string",
+    multipleSelects: "string[]",
+    checkbox: "boolean",
+    date: "string",
+    dateTime: "string",
+    attachment: "Array<{ url: string; filename?: string }>",
+    multipleRecordLinks: "string | string[]",
+    formula: "unknown",
+    rollup: "unknown",
+    lookup: "unknown",
+    count: "number",
+    autoNumber: "number",
+    barcode: "string",
+    button: "unknown",
+    createdTime: "string",
+    lastModifiedTime: "string",
+    createdBy: "unknown",
+    lastModifiedBy: "unknown",
+    externalSyncSource: "unknown",
+    aiText: "string",
+};
+function airtableTsType(field) {
+    if ((field.type === "singleSelect" || field.type === "multipleSelects") &&
+        field.options &&
+        field.options.length > 0) {
+        const literals = field.options
+            .slice(0, MAX_SELECT_OPTIONS)
+            .map((o) => `"${o.replace(/"/g, '\\"')}"`)
+            .join(" | ");
+        const union = `${literals} | string`;
+        if (field.type === "multipleSelects")
+            return `(${union})[]`;
+        return union;
+    }
+    return AIRTABLE_FIELD_TYPE_MAP[field.type] ?? "unknown";
+}
+export function generateAirtableTs(lock) {
+    if (lock.tables.length === 0)
+        return null;
+    const lines = [
+        "// Auto-generated by zitejs generate from zite.lock. Do not edit manually.",
+        "// Airtable SDK — uses createAirtableClient from zitejs/runtime.",
+        "// The airtable package is externalized (not bundled per-endpoint).",
+        "",
+        "import { createAirtableClient } from 'zitejs/runtime';",
+        "",
+    ];
+    for (const table of lock.tables) {
+        const recordType = `${table.sdkName}RecordType`;
+        lines.push(`export type ${recordType} = {`);
+        lines.push("  id: string;");
+        for (const field of table.fields) {
+            if (field.sdkName === "id")
+                continue;
+            const tsType = airtableTsType(field);
+            lines.push(`  ${field.sdkName}: ${tsType};`);
+        }
+        lines.push("};");
+        lines.push("");
+        lines.push(`export const ${table.sdkName} = createAirtableClient<${recordType}>(`);
+        lines.push(`  '${lock.integrationId}',`);
+        lines.push(`  '${table.sdkName}',`);
+        lines.push(`  { tableId: '${table.id}' },`);
+        lines.push(`);`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
 export function generateBackendWrapperTs() {
     return [
         "// Auto-generated type-narrowing wrapper. Do not edit manually.",

package/package.json

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