zitejs 0.9.68 → 0.9.69

package/dist/cjs/bundle/index.js

@@ -259,6 +259,15 @@ function createAliasPlugin(opts) {
                 }
                 return { path: 'zitejs/integrations', external: true };
             });
+            // Resolve zitejs/email to .zite/integrations/email.ts
+            build.onResolve({ filter: /^zitejs\/email$/ }, () => {
+                if (opts.baseDir) {
+                    const intPath = path.resolve(opts.baseDir, '.zite/integrations/email.ts');
+                    if (fs.existsSync(intPath))
+                        return { path: intPath };
+                }
+                return { path: 'zitejs/email', 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

@@ -33,11 +33,39 @@ function getFlowId(appDir) {
     catch { }
     return undefined;
 }
+/**
+ * Find the connected email integration's key in an app's zite.config.json,
+ * if any. The key is the integrationId used by the runtime SDK bridge.
+ */
+function getEmailIntegrationId(appDir) {
+    try {
+        const configPath = (0, path_1.join)("apps", appDir, "zite.config.json");
+        if (!(0, fs_2.existsSync)(configPath))
+            return undefined;
+        const config = JSON.parse((0, fs_2.readFileSync)(configPath, "utf-8"));
+        const integrations = config.integrations ?? {};
+        for (const [id, int] of Object.entries(integrations)) {
+            if (int?.type === "email")
+                return id;
+        }
+    }
+    catch { }
+    return undefined;
+}
 function regenerateAppTypedWrappers(appDir) {
     const outDir = (0, path_1.join)("apps", appDir, ".zite");
     (0, fs_2.mkdirSync)(outDir, { recursive: true });
     (0, fs_2.writeFileSync)((0, path_1.join)(outDir, "user.ts"), (0, lib_js_1.generateUserTs)());
     (0, fs_2.writeFileSync)((0, path_1.join)(outDir, "auth.ts"), (0, lib_js_1.generateAuthWrapperTs)());
+    // Email integration: generate the Email client at .zite/integrations/email.ts.
+    // Resolved by the `zitejs/email` bundler/tsconfig alias (mirrors airtable's
+    // `zitejs/integrations`), so endpoint code uses `import { Email } from 'zitejs/email'`.
+    const emailIntegrationId = getEmailIntegrationId(appDir);
+    if (emailIntegrationId) {
+        const intDir = (0, path_1.join)(outDir, "integrations");
+        (0, fs_2.mkdirSync)(intDir, { recursive: true });
+        (0, fs_2.writeFileSync)((0, path_1.join)(intDir, "email.ts"), (0, lib_js_1.generateEmailSdk)(emailIntegrationId));
+    }
     (0, fs_2.writeFileSync)((0, path_1.join)(outDir, "backend.ts"), (0, lib_js_1.generateBackendWrapperTs)());
 }
 function regenerateAppApiTs(appDir) {

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

@@ -73,7 +73,7 @@ export interface AirtableTableClient<T> {
     }): Promise<T | undefined>;
     create(params: {
         record: Partial<T>;
-    }): Promise<T>;
+    }): Promise<T | undefined>;
     bulkCreate(params: {
         records: Partial<T>[];
     }): Promise<T[]>;
@@ -82,13 +82,75 @@ export interface AirtableTableClient<T> {
         record: Partial<T>;
     }): Promise<{
         id: string;
-        fields: Partial<T>;
-    }>;
+        fields: T;
+    } | undefined>;
     delete(params: {
         id: string;
     }): Promise<DeleteResult>;
 }
 export declare function createAirtableClient<T>(integrationId: string, className: string, implicitParams: Record<string, unknown>): AirtableTableClient<T>;
+/** A block of content in an email body. */
+export type EmailBlock = {
+    type: "text";
+    content: string;
+} | {
+    type: "button";
+    label: string;
+    href: string;
+    alignment?: "left" | "center" | "right";
+} | {
+    type: "image";
+    src: string;
+    alt?: string;
+    alignment?: "left" | "center" | "right";
+    width: number;
+    height: number;
+} | {
+    type: "spacer";
+    height: number;
+} | {
+    type: "divider";
+    borderColor?: string;
+};
+export interface SendEmailParams {
+    /** Recipient address(es). Must be valid emails — never placeholders like "me". */
+    to: string | string[];
+    subject: string;
+    /** Email body as an array of content blocks. */
+    body: EmailBlock[];
+    cc?: string[];
+    bcc?: string[];
+    replyTo?: string;
+    /** 'formatted' (default) for styled HTML, 'plain' for text-only. */
+    layout?: "formatted" | "plain";
+    /** Custom logo shown above the email content (header area), for branding. */
+    logo?: {
+        url: string;
+        width?: number;
+        height?: number;
+    };
+    /** File attachments, each fetched from its URL at send time. */
+    attachments?: {
+        filename: string;
+        url: string;
+        contentType?: string;
+    }[];
+}
+export interface SendEmailResult {
+    success: boolean;
+    messageId: string;
+}
+export interface EmailClient {
+    send(params: SendEmailParams): Promise<SendEmailResult>;
+}
+/**
+ * Email client — sends through the Zite email gateway via the runtime SDK
+ * bridge. Email cannot run in-worker (provider auth, image processing, HTML
+ * inlining all live in the gateway), so every call dispatches through
+ * getSdkCall(), which routes to the email handler. The integrationId is the
+ * app's connected email integration key.
+ */
+export declare function createEmailClient(integrationId: string): EmailClient;
 export declare function createNotificationsClient(): {
     create(params: NotificationsCreateParams): Promise<NotificationsCreateResult>;
 };

package/dist/cjs/runtime/index.js

@@ -4,6 +4,7 @@ exports.createCaller = void 0;
 exports.createTableClient = createTableClient;
 exports.createSqlClient = createSqlClient;
 exports.createAirtableClient = createAirtableClient;
+exports.createEmailClient = createEmailClient;
 exports.createNotificationsClient = createNotificationsClient;
 exports.createMetaClient = createMetaClient;
 const sdkCall_js_1 = require("../internal/sdkCall.js");
@@ -100,6 +101,18 @@ function createAirtableClient(integrationId, className, implicitParams) {
         }),
     };
 }
+/**
+ * Email client — sends through the Zite email gateway via the runtime SDK
+ * bridge. Email cannot run in-worker (provider auth, image processing, HTML
+ * inlining all live in the gateway), so every call dispatches through
+ * getSdkCall(), which routes to the email handler. The integrationId is the
+ * app's connected email integration key.
+ */
+function createEmailClient(integrationId) {
+    return {
+        send: (params) => (0, sdkCall_js_1.getSdkCall)()(integrationId, "Email", "send", params),
+    };
+}
 const NOTIFICATIONS_SDK_INTEGRATION_ID = "__notifications__";
 const META_SDK_INTEGRATION_ID = "__meta__";
 function createNotificationsClient() {

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

@@ -59,3 +59,11 @@ export type AirtableLock = {
 };
 export declare function generateAirtableTs(lock: AirtableLock): string | null;
 export declare function generateBackendWrapperTs(): string;
+/**
+ * Generate `.zite/integrations/email.ts` — the `Email` client for an app with
+ * an email integration connected. Mirrors the airtable SDK generation: a thin
+ * wrapper over a `zitejs/runtime` factory that dispatches through the runtime
+ * SDK bridge, resolved via the `zitejs/email` alias. `integrationId` is the
+ * connected integration's key.
+ */
+export declare function generateEmailSdk(integrationId: string): string;

package/dist/cjs/sync/lib.js

@@ -9,6 +9,7 @@ exports.generateUserTs = generateUserTs;
 exports.generateAuthWrapperTs = generateAuthWrapperTs;
 exports.generateAirtableTs = generateAirtableTs;
 exports.generateBackendWrapperTs = generateBackendWrapperTs;
+exports.generateEmailSdk = generateEmailSdk;
 const parser_1 = require("@babel/parser");
 const FIELD_TYPE_MAP = {
     single_line_text: "string",
@@ -725,3 +726,30 @@ function generateBackendWrapperTs() {
         "",
     ].join("\n");
 }
+/**
+ * Generate `.zite/integrations/email.ts` — the `Email` client for an app with
+ * an email integration connected. Mirrors the airtable SDK generation: a thin
+ * wrapper over a `zitejs/runtime` factory that dispatches through the runtime
+ * SDK bridge, resolved via the `zitejs/email` alias. `integrationId` is the
+ * connected integration's key.
+ */
+function generateEmailSdk(integrationId) {
+    return [
+        "// Auto-generated by zitejs generate from zite.config.json. Do not edit manually.",
+        "// Email SDK — sends through the Zite email gateway via the runtime bridge.",
+        "//",
+        "//   await Email.send({ to, subject, body: [{ type: 'text', content: '...' }] })",
+        "//     => { success: boolean; messageId: string }",
+        "",
+        "import { createEmailClient } from 'zitejs/runtime';",
+        "",
+        "export type {",
+        "  EmailBlock,",
+        "  SendEmailParams,",
+        "  SendEmailResult,",
+        "} from 'zitejs/runtime';",
+        "",
+        `export const Email = createEmailClient('${integrationId}');`,
+        "",
+    ].join("\n");
+}

package/dist/esm/bundle/index.js

@@ -223,6 +223,15 @@ function createAliasPlugin(opts) {
                 }
                 return { path: 'zitejs/integrations', external: true };
             });
+            // Resolve zitejs/email to .zite/integrations/email.ts
+            build.onResolve({ filter: /^zitejs\/email$/ }, () => {
+                if (opts.baseDir) {
+                    const intPath = path.resolve(opts.baseDir, '.zite/integrations/email.ts');
+                    if (fs.existsSync(intPath))
+                        return { path: intPath };
+                }
+                return { path: 'zitejs/email', 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 { generateDbTs, generateApiTs, generateUserTs, generateAuthWrapperTs, generateBackendWrapperTs, generateAirtableTs, } from "../sync/lib.js";
+import { generateDbTs, generateApiTs, generateUserTs, generateAuthWrapperTs, generateBackendWrapperTs, generateAirtableTs, generateEmailSdk, } from "../sync/lib.js";
 const debounceTimers = new Map();
 function debounce(key, fn, ms) {
     const existing = debounceTimers.get(key);
@@ -29,11 +29,39 @@ function getFlowId(appDir) {
     catch { }
     return undefined;
 }
+/**
+ * Find the connected email integration's key in an app's zite.config.json,
+ * if any. The key is the integrationId used by the runtime SDK bridge.
+ */
+function getEmailIntegrationId(appDir) {
+    try {
+        const configPath = join("apps", appDir, "zite.config.json");
+        if (!existsSync(configPath))
+            return undefined;
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        const integrations = config.integrations ?? {};
+        for (const [id, int] of Object.entries(integrations)) {
+            if (int?.type === "email")
+                return id;
+        }
+    }
+    catch { }
+    return undefined;
+}
 function regenerateAppTypedWrappers(appDir) {
     const outDir = join("apps", appDir, ".zite");
     mkdirSync(outDir, { recursive: true });
     writeFileSync(join(outDir, "user.ts"), generateUserTs());
     writeFileSync(join(outDir, "auth.ts"), generateAuthWrapperTs());
+    // Email integration: generate the Email client at .zite/integrations/email.ts.
+    // Resolved by the `zitejs/email` bundler/tsconfig alias (mirrors airtable's
+    // `zitejs/integrations`), so endpoint code uses `import { Email } from 'zitejs/email'`.
+    const emailIntegrationId = getEmailIntegrationId(appDir);
+    if (emailIntegrationId) {
+        const intDir = join(outDir, "integrations");
+        mkdirSync(intDir, { recursive: true });
+        writeFileSync(join(intDir, "email.ts"), generateEmailSdk(emailIntegrationId));
+    }
     writeFileSync(join(outDir, "backend.ts"), generateBackendWrapperTs());
 }
 function regenerateAppApiTs(appDir) {

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

@@ -73,7 +73,7 @@ export interface AirtableTableClient<T> {
     }): Promise<T | undefined>;
     create(params: {
         record: Partial<T>;
-    }): Promise<T>;
+    }): Promise<T | undefined>;
     bulkCreate(params: {
         records: Partial<T>[];
     }): Promise<T[]>;
@@ -82,13 +82,75 @@ export interface AirtableTableClient<T> {
         record: Partial<T>;
     }): Promise<{
         id: string;
-        fields: Partial<T>;
-    }>;
+        fields: T;
+    } | undefined>;
     delete(params: {
         id: string;
     }): Promise<DeleteResult>;
 }
 export declare function createAirtableClient<T>(integrationId: string, className: string, implicitParams: Record<string, unknown>): AirtableTableClient<T>;
+/** A block of content in an email body. */
+export type EmailBlock = {
+    type: "text";
+    content: string;
+} | {
+    type: "button";
+    label: string;
+    href: string;
+    alignment?: "left" | "center" | "right";
+} | {
+    type: "image";
+    src: string;
+    alt?: string;
+    alignment?: "left" | "center" | "right";
+    width: number;
+    height: number;
+} | {
+    type: "spacer";
+    height: number;
+} | {
+    type: "divider";
+    borderColor?: string;
+};
+export interface SendEmailParams {
+    /** Recipient address(es). Must be valid emails — never placeholders like "me". */
+    to: string | string[];
+    subject: string;
+    /** Email body as an array of content blocks. */
+    body: EmailBlock[];
+    cc?: string[];
+    bcc?: string[];
+    replyTo?: string;
+    /** 'formatted' (default) for styled HTML, 'plain' for text-only. */
+    layout?: "formatted" | "plain";
+    /** Custom logo shown above the email content (header area), for branding. */
+    logo?: {
+        url: string;
+        width?: number;
+        height?: number;
+    };
+    /** File attachments, each fetched from its URL at send time. */
+    attachments?: {
+        filename: string;
+        url: string;
+        contentType?: string;
+    }[];
+}
+export interface SendEmailResult {
+    success: boolean;
+    messageId: string;
+}
+export interface EmailClient {
+    send(params: SendEmailParams): Promise<SendEmailResult>;
+}
+/**
+ * Email client — sends through the Zite email gateway via the runtime SDK
+ * bridge. Email cannot run in-worker (provider auth, image processing, HTML
+ * inlining all live in the gateway), so every call dispatches through
+ * getSdkCall(), which routes to the email handler. The integrationId is the
+ * app's connected email integration key.
+ */
+export declare function createEmailClient(integrationId: string): EmailClient;
 export declare function createNotificationsClient(): {
     create(params: NotificationsCreateParams): Promise<NotificationsCreateResult>;
 };

package/dist/esm/runtime/index.js

@@ -92,6 +92,18 @@ export function createAirtableClient(integrationId, className, implicitParams) {
         }),
     };
 }
+/**
+ * Email client — sends through the Zite email gateway via the runtime SDK
+ * bridge. Email cannot run in-worker (provider auth, image processing, HTML
+ * inlining all live in the gateway), so every call dispatches through
+ * getSdkCall(), which routes to the email handler. The integrationId is the
+ * app's connected email integration key.
+ */
+export function createEmailClient(integrationId) {
+    return {
+        send: (params) => getSdkCall()(integrationId, "Email", "send", params),
+    };
+}
 const NOTIFICATIONS_SDK_INTEGRATION_ID = "__notifications__";
 const META_SDK_INTEGRATION_ID = "__meta__";
 export function createNotificationsClient() {

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

@@ -59,3 +59,11 @@ export type AirtableLock = {
 };
 export declare function generateAirtableTs(lock: AirtableLock): string | null;
 export declare function generateBackendWrapperTs(): string;
+/**
+ * Generate `.zite/integrations/email.ts` — the `Email` client for an app with
+ * an email integration connected. Mirrors the airtable SDK generation: a thin
+ * wrapper over a `zitejs/runtime` factory that dispatches through the runtime
+ * SDK bridge, resolved via the `zitejs/email` alias. `integrationId` is the
+ * connected integration's key.
+ */
+export declare function generateEmailSdk(integrationId: string): string;

package/dist/esm/sync/lib.js

@@ -714,3 +714,30 @@ export function generateBackendWrapperTs() {
         "",
     ].join("\n");
 }
+/**
+ * Generate `.zite/integrations/email.ts` — the `Email` client for an app with
+ * an email integration connected. Mirrors the airtable SDK generation: a thin
+ * wrapper over a `zitejs/runtime` factory that dispatches through the runtime
+ * SDK bridge, resolved via the `zitejs/email` alias. `integrationId` is the
+ * connected integration's key.
+ */
+export function generateEmailSdk(integrationId) {
+    return [
+        "// Auto-generated by zitejs generate from zite.config.json. Do not edit manually.",
+        "// Email SDK — sends through the Zite email gateway via the runtime bridge.",
+        "//",
+        "//   await Email.send({ to, subject, body: [{ type: 'text', content: '...' }] })",
+        "//     => { success: boolean; messageId: string }",
+        "",
+        "import { createEmailClient } from 'zitejs/runtime';",
+        "",
+        "export type {",
+        "  EmailBlock,",
+        "  SendEmailParams,",
+        "  SendEmailResult,",
+        "} from 'zitejs/runtime';",
+        "",
+        `export const Email = createEmailClient('${integrationId}');`,
+        "",
+    ].join("\n");
+}

package/package.json

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

package/dist/cjs/api/index.js

@@ -1,5 +0,0 @@
-"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

@@ -1,5 +0,0 @@
-"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/esm/api/index.d.ts

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

package/dist/esm/api/index.js

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

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

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

package/dist/esm/db/index.js

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