zitejs 0.9.122 → 0.9.124

package/dist/cjs/integrations/rules.js

@@ -0,0 +1,104 @@
+"use strict";
+// Which `zite.config.json` entries `integrations.get` can name, and the fields
+// each answers with. No imports, so the platform applies these same rules.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gettableIntegrations = exports.isCredentialServiceType = exports.normalizeIntegrationServiceType = exports.NON_CREDENTIAL_SERVICE_TYPES = exports.CREDENTIAL_FIELDS = void 0;
+const extras = (...labels) => [
+    "accessToken",
+    ...[...labels].sort(),
+];
+const FIELDS_BY_TYPE = {
+    googleCalendar: extras(),
+    googleDrive: extras(),
+    gmail: extras(),
+    googleDocs: extras(),
+    hubspot: extras(),
+    salesforce: extras("instanceUrl"),
+    twilio: extras("authToken"),
+    slack: extras(),
+    linear: extras(),
+    openai: extras(),
+    googlesheets: extras(),
+    microsoftTeams: extras(),
+    onedrive: extras(),
+    outlook: extras(),
+    intercom: extras(),
+    mailchimp: extras("server"),
+    anthropic: extras(),
+    gemini: extras(),
+    stripe: extras(),
+    trello: extras("clientApiKey"),
+    notion: extras(),
+    facebookPages: extras(),
+    monday: extras(),
+    resend: extras(),
+    clickhouse: extras("url", "username"),
+    amplitude: extras("apiKey"),
+    elevenlabs: extras(),
+    brevo: extras(),
+    calendly: extras(),
+    asana: extras(),
+    xero: extras("tenantId"),
+    googleForms: extras(),
+    linkedin: extras("personUrn"),
+    github: extras(),
+    quickbooks: extras("realmId", "apiBaseUrl"),
+    firecrawl: extras(),
+    jira: extras("cloudId", "siteUrl"),
+    typeform: extras(),
+    apollo: extras(),
+    attio: extras(),
+};
+/** Per service type: `accessToken`, then its extra labels sorted (Salesforce `instanceUrl`). */
+exports.CREDENTIAL_FIELDS = FIELDS_BY_TYPE;
+/**
+ * Types the runtime never serves: those with a generated client (Airtable, email,
+ * the project database, Fillout) and those whose key is a frontend value (Maps, Analytics).
+ */
+exports.NON_CREDENTIAL_SERVICE_TYPES = [
+    "airtable",
+    "databases",
+    "email",
+    "fillout",
+    "googleAnalytics",
+    "googlemaps",
+];
+/** Spellings older configs, or an agent writing the entry's slug, put in `type`. */
+const LEGACY_SERVICE_TYPES = {
+    googlecalendar: "googleCalendar",
+    "google-drive": "googleDrive",
+    "google-docs": "googleDocs",
+    "google-calendar": "googleCalendar",
+    "google-sheets": "googlesheets",
+    "google-analytics": "googleAnalytics",
+    "google-maps": "googlemaps",
+    "microsoft-teams": "microsoftTeams",
+    "one-drive": "onedrive",
+};
+// Own keys only: a name like `constructor` must not match Object.prototype.
+const hasOwn = (record, key) => Object.prototype.hasOwnProperty.call(record, key);
+const normalizeIntegrationServiceType = (type) => hasOwn(LEGACY_SERVICE_TYPES, type) ? LEGACY_SERVICE_TYPES[type] : type;
+exports.normalizeIntegrationServiceType = normalizeIntegrationServiceType;
+const isCredentialServiceType = (type) => hasOwn(FIELDS_BY_TYPE, type);
+exports.isCredentialServiceType = isCredentialServiceType;
+/**
+ * The entries a source dir can name, by name: its own, then the workspace's under
+ * keys it has not taken. An entry whose type the runtime would not serve is dropped.
+ */
+const gettableIntegrations = (rootIntegrations, appIntegrations) => {
+    const own = appIntegrations ?? {};
+    const workspace = rootIntegrations ?? {};
+    const visible = [];
+    for (const [name, entry] of [
+        ...Object.entries(own),
+        ...Object.entries(workspace).filter(([name]) => !hasOwn(own, name)),
+    ]) {
+        if (typeof entry?.type !== "string")
+            continue;
+        const serviceType = (0, exports.normalizeIntegrationServiceType)(entry.type);
+        if ((0, exports.isCredentialServiceType)(serviceType))
+            visible.push({ name, serviceType });
+    }
+    return visible.sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+};
+exports.gettableIntegrations = gettableIntegrations;

package/dist/cjs/integrations/rules.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/integrations/rules.test.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../index.js");
+(0, vitest_1.describe)("CREDENTIAL_FIELDS", () => {
+    (0, vitest_1.it)("answers accessToken, then the service's extras sorted", () => {
+        (0, vitest_1.expect)(index_js_1.CREDENTIAL_FIELDS.slack).toEqual(["accessToken"]);
+        (0, vitest_1.expect)(index_js_1.CREDENTIAL_FIELDS.salesforce).toEqual(["accessToken", "instanceUrl"]);
+        (0, vitest_1.expect)(index_js_1.CREDENTIAL_FIELDS.clickhouse).toEqual([
+            "accessToken",
+            "url",
+            "username",
+        ]);
+        (0, vitest_1.expect)(index_js_1.CREDENTIAL_FIELDS.quickbooks).toEqual([
+            "accessToken",
+            "apiBaseUrl",
+            "realmId",
+        ]);
+        (0, vitest_1.expect)(index_js_1.CREDENTIAL_FIELDS.jira).toEqual(["accessToken", "cloudId", "siteUrl"]);
+    });
+    (0, vitest_1.it)("has no type the runtime never serves", () => {
+        for (const type of index_js_1.NON_CREDENTIAL_SERVICE_TYPES) {
+            (0, vitest_1.expect)((0, index_js_1.isCredentialServiceType)(type)).toBe(false);
+        }
+    });
+    (0, vitest_1.it)("does not treat Object.prototype names as service types", () => {
+        (0, vitest_1.expect)((0, index_js_1.isCredentialServiceType)("toString")).toBe(false);
+        (0, vitest_1.expect)((0, index_js_1.normalizeIntegrationServiceType)("constructor")).toBe("constructor");
+    });
+});
+(0, vitest_1.describe)("normalizeIntegrationServiceType", () => {
+    vitest_1.it.each([
+        ["googlecalendar", "googleCalendar"],
+        ["google-drive", "googleDrive"],
+        ["google-sheets", "googlesheets"],
+        ["microsoft-teams", "microsoftTeams"],
+        ["one-drive", "onedrive"],
+    ])("maps %s to %s", (legacy, canonical) => {
+        (0, vitest_1.expect)((0, index_js_1.normalizeIntegrationServiceType)(legacy)).toBe(canonical);
+        (0, vitest_1.expect)((0, index_js_1.isCredentialServiceType)(canonical)).toBe(true);
+    });
+    (0, vitest_1.it)("leaves a canonical type alone", () => {
+        (0, vitest_1.expect)((0, index_js_1.normalizeIntegrationServiceType)("slack")).toBe("slack");
+    });
+});
+(0, vitest_1.describe)("gettableIntegrations", () => {
+    (0, vitest_1.it)("lists the app's entries, then the workspace's under untaken keys, by name", () => {
+        (0, vitest_1.expect)((0, index_js_1.gettableIntegrations)({ crm: { type: "salesforce" }, team: { type: "slack" } }, { billing: { type: "stripe" }, team: { type: "microsoftTeams" } })).toEqual([
+            { name: "billing", serviceType: "stripe" },
+            { name: "crm", serviceType: "salesforce" },
+            { name: "team", serviceType: "microsoftTeams" },
+        ]);
+    });
+    (0, vitest_1.it)("lets an app entry of a generated-client type shadow a workspace credential entry", () => {
+        (0, vitest_1.expect)((0, index_js_1.gettableIntegrations)({ mail: { type: "gmail" } }, { mail: { type: "email" } })).toEqual([]);
+    });
+    (0, vitest_1.it)("drops types the runtime never serves and entries without a type", () => {
+        (0, vitest_1.expect)((0, index_js_1.gettableIntegrations)({
+            base: { type: "airtable" },
+            mail: { type: "email" },
+            db: { type: "databases" },
+            form: { type: "fillout" },
+            map: { type: "google-maps" },
+            ga: { type: "googleAnalytics" },
+            broken: {},
+            numeric: { type: 7 },
+            gone: undefined,
+        })).toEqual([]);
+    });
+    (0, vitest_1.it)("normalizes legacy type spellings", () => {
+        (0, vitest_1.expect)((0, index_js_1.gettableIntegrations)({ cal: { type: "google-calendar" } })).toEqual([
+            { name: "cal", serviceType: "googleCalendar" },
+        ]);
+    });
+    (0, vitest_1.it)("drops a type it does not know, as the runtime does", () => {
+        (0, vitest_1.expect)((0, index_js_1.gettableIntegrations)({ next: { type: "someNewService" } })).toEqual([]);
+    });
+    (0, vitest_1.it)("shadows by own keys only", () => {
+        (0, vitest_1.expect)((0, index_js_1.gettableIntegrations)({ constructor: { type: "slack" } }, {})).toEqual([
+            { name: "constructor", serviceType: "slack" },
+        ]);
+    });
+    (0, vitest_1.it)("works with no configs", () => {
+        (0, vitest_1.expect)((0, index_js_1.gettableIntegrations)(undefined)).toEqual([]);
+    });
+});

package/dist/cjs/internal/sdkCall.d.ts

@@ -1,2 +1,3 @@
 export type SdkCall = (integrationId: string, className: string, methodName: string, params?: unknown) => Promise<unknown>;
+export declare const SDK_NOT_INITIALIZED_MESSAGE = "Zite SDK runtime not initialized. Endpoints must run inside the Zite worker.";
 export declare function getSdkCall(): SdkCall;

package/dist/cjs/internal/sdkCall.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_NOT_INITIALIZED_MESSAGE = void 0;
 exports.getSdkCall = getSdkCall;
+exports.SDK_NOT_INITIALIZED_MESSAGE = 'Zite SDK runtime not initialized. Endpoints must run inside the Zite worker.';
 function getSdkCall() {
     const fn = globalThis.__wrapSdkCall;
     if (!fn) {
-        throw new Error('Zite SDK runtime not initialized. Endpoints must run inside the Zite worker.');
+        throw new Error(exports.SDK_NOT_INITIALIZED_MESSAGE);
     }
     return fn;
 }

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

@@ -332,5 +332,6 @@ export interface EmailClient {
  * app's connected email integration key.
  */
 export declare function createEmailClient(integrationId: string): EmailClient;
+export { createIntegrationsClient, type Connected, type IntegrationsClient, type NeedsConnect, } from "../integrations/client.js";
 export { createCaller } from "../caller/index.js";
 export type { EndpointConfig } from "../caller/index.js";

package/dist/cjs/runtime/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCaller = void 0;
+exports.createCaller = exports.createIntegrationsClient = void 0;
 exports.createTableClient = createTableClient;
 exports.createSqlClient = createSqlClient;
 exports.createAuthClient = createAuthClient;
@@ -211,5 +211,7 @@ function createEmailClient(integrationId) {
         send: (params) => (0, sdkCall_js_1.getSdkCall)()(integrationId, "Email", "send", params),
     };
 }
+var client_js_1 = require("../integrations/client.js");
+Object.defineProperty(exports, "createIntegrationsClient", { enumerable: true, get: function () { return client_js_1.createIntegrationsClient; } });
 var index_js_1 = require("../caller/index.js");
 Object.defineProperty(exports, "createCaller", { enumerable: true, get: function () { return index_js_1.createCaller; } });

package/dist/cjs/sourceRoots.d.ts

@@ -17,3 +17,16 @@ export interface SourceDir {
 export declare function listSourceDirs(cwd?: string): SourceDir[];
 /** The source dir with this bare name, under whichever root holds it. */
 export declare function findSourceDir(name: string, cwd?: string): SourceDir | undefined;
+/**
+ * An automation is one workflow: its single endpoint is `src/workflow.ts` and
+ * its name is fixed, so nothing about an automation is keyed on a file name
+ * the way an app's `src/api/<name>.ts` endpoints are.
+ */
+export declare const AUTOMATION_ENDPOINT_NAME = "workflow";
+export declare const AUTOMATION_WORKFLOW_FILE = "src/workflow.ts";
+/** The root a source dir sits under, read from its parent directory. */
+export declare function sourceRootOf(sourceDirPath: string): SourceRoot | undefined;
+/** An endpoint's entry file, relative to the source dir. */
+export declare function endpointEntryFile(root: SourceRoot, name: string): string;
+/** Every endpoint name a source dir has on disk. */
+export declare function listEndpointNames(root: SourceRoot, sourceDirPath: string): string[];

package/dist/cjs/sourceRoots.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SOURCE_ROOTS = void 0;
+exports.AUTOMATION_WORKFLOW_FILE = exports.AUTOMATION_ENDPOINT_NAME = exports.SOURCE_ROOTS = void 0;
 exports.listSourceDirs = listSourceDirs;
 exports.findSourceDir = findSourceDir;
+exports.sourceRootOf = sourceRootOf;
+exports.endpointEntryFile = endpointEntryFile;
+exports.listEndpointNames = listEndpointNames;
 const fs_1 = require("fs");
 const path_1 = require("path");
 /**
@@ -31,3 +34,37 @@ function listSourceDirs(cwd = ".") {
 function findSourceDir(name, cwd = ".") {
     return listSourceDirs(cwd).find((d) => d.dir === name);
 }
+/**
+ * An automation is one workflow: its single endpoint is `src/workflow.ts` and
+ * its name is fixed, so nothing about an automation is keyed on a file name
+ * the way an app's `src/api/<name>.ts` endpoints are.
+ */
+exports.AUTOMATION_ENDPOINT_NAME = "workflow";
+exports.AUTOMATION_WORKFLOW_FILE = "src/workflow.ts";
+/** The root a source dir sits under, read from its parent directory. */
+function sourceRootOf(sourceDirPath) {
+    const parent = (0, path_1.basename)((0, path_1.dirname)((0, path_1.resolve)(sourceDirPath)));
+    return exports.SOURCE_ROOTS.includes(parent)
+        ? parent
+        : undefined;
+}
+/** An endpoint's entry file, relative to the source dir. */
+function endpointEntryFile(root, name) {
+    return root === "automations"
+        ? exports.AUTOMATION_WORKFLOW_FILE
+        : (0, path_1.join)("src", "api", `${name}.ts`);
+}
+/** Every endpoint name a source dir has on disk. */
+function listEndpointNames(root, sourceDirPath) {
+    if (root === "automations") {
+        return (0, fs_1.existsSync)((0, path_1.join)(sourceDirPath, exports.AUTOMATION_WORKFLOW_FILE))
+            ? [exports.AUTOMATION_ENDPOINT_NAME]
+            : [];
+    }
+    const apiDir = (0, path_1.join)(sourceDirPath, "src", "api");
+    return (0, fs_1.existsSync)(apiDir)
+        ? (0, fs_1.readdirSync)(apiDir)
+            .filter((f) => f.endsWith(".ts") && !f.endsWith(".d.ts"))
+            .map((f) => f.replace(/\.ts$/, ""))
+        : [];
+}

package/dist/cjs/sourceRoots.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/sourceRoots.test.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const vitest_1 = require("vitest");
+const sourceRoots_js_1 = require("./sourceRoots.js");
+(0, vitest_1.describe)("source roots", () => {
+    (0, vitest_1.it)("reads the root from the source dir's parent", () => {
+        (0, vitest_1.expect)((0, sourceRoots_js_1.sourceRootOf)("/repo/apps/crm")).toBe("apps");
+        (0, vitest_1.expect)((0, sourceRoots_js_1.sourceRootOf)("/repo/automations/digest")).toBe("automations");
+        (0, vitest_1.expect)((0, sourceRoots_js_1.sourceRootOf)("/repo/packages/ui")).toBeUndefined();
+    });
+    (0, vitest_1.it)("an app's endpoints are src/api/<name>.ts; an automation's one endpoint is src/workflow.ts", () => {
+        (0, vitest_1.expect)((0, sourceRoots_js_1.endpointEntryFile)("apps", "listItems")).toBe("src/api/listItems.ts");
+        (0, vitest_1.expect)((0, sourceRoots_js_1.endpointEntryFile)("automations", "workflow")).toBe("src/workflow.ts");
+    });
+    (0, vitest_1.it)("lists what is on disk under each layout", () => {
+        const repo = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), "zitejs-roots-"));
+        (0, fs_1.mkdirSync)((0, path_1.join)(repo, "apps/crm/src/api"), { recursive: true });
+        (0, fs_1.writeFileSync)((0, path_1.join)(repo, "apps/crm/src/api/listItems.ts"), "");
+        (0, fs_1.writeFileSync)((0, path_1.join)(repo, "apps/crm/src/api/apiTypes.d.ts"), "");
+        (0, fs_1.mkdirSync)((0, path_1.join)(repo, "automations/digest/src"), { recursive: true });
+        (0, fs_1.mkdirSync)((0, path_1.join)(repo, "automations/empty/src"), { recursive: true });
+        (0, fs_1.writeFileSync)((0, path_1.join)(repo, "automations/digest/src/workflow.ts"), "");
+        (0, vitest_1.expect)((0, sourceRoots_js_1.listEndpointNames)("apps", (0, path_1.join)(repo, "apps/crm"))).toEqual(["listItems"]);
+        (0, vitest_1.expect)((0, sourceRoots_js_1.listEndpointNames)("automations", (0, path_1.join)(repo, "automations/digest"))).toEqual(["workflow"]);
+        (0, vitest_1.expect)((0, sourceRoots_js_1.listEndpointNames)("automations", (0, path_1.join)(repo, "automations/empty"))).toEqual([]);
+    });
+});

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

@@ -1,6 +1,7 @@
 import type { PublicFieldDefinition } from "../types/fields.js";
 import type { Database } from "../types/tables.js";
 import { type SdkNameRename } from "./sdkNames.js";
+import { type GettableIntegration } from "../integrations/rules.js";
 export type ZiteSchemaField = {
     id: string;
     sdkName: string;
@@ -96,3 +97,11 @@ export declare function findEmailIntegrationId(appConfig: unknown, workspaceConf
  * connected integration's key.
  */
 export declare function generateEmailSdk(integrationId: string): string;
+/**
+ * `.zite/integrations/index.ts`: `zitejs/integrations` for one source dir. The
+ * `integrations` client typed by what the dir can see, plus the generated
+ * Airtable clients when it has them.
+ */
+export declare function generateIntegrationsIndex(entries: GettableIntegration[], opts: {
+    reexportAirtable: boolean;
+}): string;

package/dist/cjs/sync/lib.js

@@ -9,8 +9,10 @@ exports.generateAirtableTs = generateAirtableTs;
 exports.generateBackendWrapperTs = generateBackendWrapperTs;
 exports.findEmailIntegrationId = findEmailIntegrationId;
 exports.generateEmailSdk = generateEmailSdk;
+exports.generateIntegrationsIndex = generateIntegrationsIndex;
 const parser_1 = require("@babel/parser");
 const sdkNames_js_1 = require("./sdkNames.js");
+const rules_js_1 = require("../integrations/rules.js");
 const AUTH_USERS_TABLE_ID = "zite_user";
 /**
  * What a field's value looks like when a record is READ back.
@@ -1397,3 +1399,54 @@ function generateEmailSdk(integrationId) {
         "",
     ].join("\n");
 }
+const connectedTypeFor = (serviceType) => {
+    const extraLabels = rules_js_1.CREDENTIAL_FIELDS[serviceType].slice(1);
+    return extraLabels.length === 0
+        ? "Connected"
+        : `Connected<{ ${extraLabels.map((label) => `${label}: string`).join("; ")} }>`;
+};
+/**
+ * `.zite/integrations/index.ts`: `zitejs/integrations` for one source dir. The
+ * `integrations` client typed by what the dir can see, plus the generated
+ * Airtable clients when it has them.
+ */
+function generateIntegrationsIndex(entries, opts) {
+    const sorted = [...entries].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+    const nameUnion = sorted.length === 0
+        ? "never"
+        : sorted.map(({ name }) => tsSingleQuoted(name)).join(" | ");
+    const byName = sorted.length === 0
+        ? ["export type IntegrationByName = {};"]
+        : [
+            "export type IntegrationByName = {",
+            ...sorted.map(({ name, serviceType }) => `  ${tsSingleQuoted(name)}: ${connectedTypeFor(serviceType)} | NeedsConnect;`),
+            "};",
+        ];
+    return [
+        "// Auto-generated by zitejs generate from zite.config.json. Do not edit manually.",
+        "// zitejs/integrations — an integration's credentials by its zite.config.json entry name.",
+        "//",
+        "// Usage in endpoints (src/api/*.ts) and automations (src/workflow.ts):",
+        "//   import { integrations } from 'zitejs/integrations';",
+        "//",
+        "//   const crm = await integrations.get('<entry name>');",
+        "//   if (crm.status !== 'connected') { /* crm.connectUrl is where a person reconnects */ }",
+        "//",
+        "// Call get where the value is used, not once at module scope: a token refreshed",
+        "// mid-run is what the next call returns.",
+        "",
+        // Not 'zitejs/integrations': apps alias that specifier to this very file.
+        "import { createIntegrationsClient } from 'zitejs/runtime';",
+        "import type { Connected, NeedsConnect } from 'zitejs/runtime';",
+        "",
+        ...(opts.reexportAirtable ? ["export * from './airtable';", ""] : []),
+        "export type { Connected, NeedsConnect };",
+        "",
+        `export type IntegrationName = ${nameUnion};`,
+        "",
+        ...byName,
+        "",
+        "export const integrations = createIntegrationsClient<IntegrationByName>();",
+        "",
+    ].join("\n");
+}

package/dist/cjs/sync/lib.test.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const vitest_1 = require("vitest");
 const typescript_1 = __importDefault(require("typescript"));
+const path_1 = require("path");
 const lib_js_1 = require("./lib.js");
 /**
  * Syntax errors in the emitted source. `.zite/db.ts` sits at the repo root and
@@ -418,3 +419,121 @@ const duplicateIdentifierErrorsIn = (source) => {
         (0, vitest_1.expect)((0, lib_js_1.findEmailIntegrationId)(undefined, undefined)).toBeUndefined();
     });
 });
+(0, vitest_1.describe)('generateIntegrationsIndex', () => {
+    // Not import.meta: this file also compiles to CommonJS. Vitest runs from the repo root.
+    const runtimePath = (0, path_1.resolve)('src/runtime/index.ts');
+    /** Type errors in `usage` compiled beside the generated file, `zitejs/runtime` mapped to this source. */
+    const typeErrorsIn = (generated, usage, airtable) => {
+        const files = {
+            '/app/.zite/integrations/index.ts': generated,
+            ...(airtable ? { '/app/.zite/integrations/airtable.ts': airtable } : {}),
+            '/app/src/usage.ts': usage,
+        };
+        const options = {
+            strict: true,
+            noEmit: true,
+            target: typescript_1.default.ScriptTarget.ES2022,
+            module: typescript_1.default.ModuleKind.ESNext,
+            moduleResolution: typescript_1.default.ModuleResolutionKind.Bundler,
+            skipLibCheck: true,
+            baseUrl: '/app',
+            paths: {
+                'zitejs/runtime': [runtimePath],
+                'zitejs/integrations': ['/app/.zite/integrations/index.ts'],
+            },
+        };
+        const host = typescript_1.default.createCompilerHost(options);
+        const { getSourceFile, fileExists, readFile, directoryExists } = host;
+        host.fileExists = f => f in files || fileExists(f);
+        host.directoryExists = d => Object.keys(files).some(f => f.startsWith(`${d}/`)) ||
+            (directoryExists?.(d) ?? false);
+        host.readFile = f => files[f] ?? readFile(f);
+        host.getSourceFile = (f, lang, ...rest) => f in files
+            ? typescript_1.default.createSourceFile(f, files[f], lang)
+            : getSourceFile(f, lang, ...rest);
+        const program = typescript_1.default.createProgram(Object.keys(files), options, host);
+        return typescript_1.default
+            .getPreEmitDiagnostics(program)
+            .filter(d => d.file?.fileName.startsWith('/app/'))
+            .map(d => typescript_1.default.flattenDiagnosticMessageText(d.messageText, ' '));
+    };
+    (0, vitest_1.it)('emits the client typed by name', () => {
+        (0, vitest_1.expect)((0, lib_js_1.generateIntegrationsIndex)([
+            { name: 'team', serviceType: 'slack' },
+            { name: 'crm', serviceType: 'salesforce' },
+        ], { reexportAirtable: false })).toMatchInlineSnapshot(`
+      "// Auto-generated by zitejs generate from zite.config.json. Do not edit manually.
+      // zitejs/integrations — an integration's credentials by its zite.config.json entry name.
+      //
+      // Usage in endpoints (src/api/*.ts) and automations (src/workflow.ts):
+      //   import { integrations } from 'zitejs/integrations';
+      //
+      //   const crm = await integrations.get('<entry name>');
+      //   if (crm.status !== 'connected') { /* crm.connectUrl is where a person reconnects */ }
+      //
+      // Call get where the value is used, not once at module scope: a token refreshed
+      // mid-run is what the next call returns.
+
+      import { createIntegrationsClient } from 'zitejs/runtime';
+      import type { Connected, NeedsConnect } from 'zitejs/runtime';
+
+      export type { Connected, NeedsConnect };
+
+      export type IntegrationName = 'crm' | 'team';
+
+      export type IntegrationByName = {
+        'crm': Connected<{ instanceUrl: string }> | NeedsConnect;
+        'team': Connected | NeedsConnect;
+      };
+
+      export const integrations = createIntegrationsClient<IntegrationByName>();
+      "
+    `);
+    });
+    (0, vitest_1.it)('types get per name in app code', () => {
+        const generated = (0, lib_js_1.generateIntegrationsIndex)([
+            { name: 'crm', serviceType: 'salesforce' },
+            { name: 'warehouse', serviceType: 'clickhouse' },
+        ], { reexportAirtable: false });
+        (0, vitest_1.expect)(typeErrorsIn(generated, [
+            "import { integrations } from 'zitejs/integrations';",
+            'export const run = async () => {',
+            "  const crm = await integrations.get('crm');",
+            "  if (crm.status === 'connected') return crm.instanceUrl + crm.accessToken;",
+            "  const warehouse = await integrations.get('warehouse');",
+            "  if (warehouse.status === 'connected') return warehouse.url + warehouse.username;",
+            '  return crm.connectUrl;',
+            '};',
+        ].join('\n'))).toEqual([]);
+        (0, vitest_1.expect)(typeErrorsIn(generated, "import { integrations } from 'zitejs/integrations';\nvoid integrations.get('nope');")).toHaveLength(1);
+    });
+    (0, vitest_1.it)('compiles with nothing visible, naming nothing', () => {
+        const generated = (0, lib_js_1.generateIntegrationsIndex)([], {
+            reexportAirtable: false,
+        });
+        (0, vitest_1.expect)(generated).toContain('export type IntegrationName = never;');
+        (0, vitest_1.expect)(typeErrorsIn(generated, "import { integrations, type IntegrationName } from 'zitejs/integrations';\nexport const f = (n: IntegrationName) => n;\nexport const g = integrations;")).toEqual([]);
+    });
+    vitest_1.it.each([
+        ['a double quote', 'crm"prod'],
+        ['a single quote', "crm'prod"],
+        ['a newline', 'crm\nprod'],
+        ['a trailing backslash', 'crm\\'],
+    ])('emits parseable TypeScript for a name with %s', (_what, name) => {
+        (0, vitest_1.expect)(syntaxErrorsIn((0, lib_js_1.generateIntegrationsIndex)([{ name, serviceType: 'slack' }], {
+            reexportAirtable: false,
+        }))).toEqual([]);
+    });
+    // One module for everything integration: the Airtable clients keep resolving.
+    (0, vitest_1.it)('re-exports the generated Airtable clients beside the integrations client', () => {
+        const generated = (0, lib_js_1.generateIntegrationsIndex)([{ name: 'team', serviceType: 'slack' }], { reexportAirtable: true });
+        (0, vitest_1.expect)(generated).toContain("export * from './airtable';");
+        (0, vitest_1.expect)(typeErrorsIn(generated, [
+            "import { Customers, integrations } from 'zitejs/integrations';",
+            'export const run = async () => {',
+            '  await Customers.findMany();',
+            "  return integrations.get('team');",
+            '};',
+        ].join('\n'), 'export const Customers = { findMany: async () => [] };')).toEqual([]);
+    });
+});

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

@@ -67,7 +67,7 @@ export declare const signIn: {
     }, FetchOptions["throw"] extends true ? true : false>>;
 } & {
     social: <FetchOptions extends import("better-auth").ClientFetchOption<Partial<{
-        provider: (string & {}) | "linear" | "huggingface" | "github" | "apple" | "atlassian" | "cognito" | "discord" | "facebook" | "figma" | "microsoft" | "google" | "slack" | "spotify" | "twitch" | "twitter" | "dropbox" | "kick" | "linkedin" | "gitlab" | "tiktok" | "reddit" | "roblox" | "salesforce" | "vk" | "zoom" | "notion" | "kakao" | "naver" | "line" | "paybin" | "paypal" | "polar" | "railway" | "vercel" | "wechat";
+        provider: "salesforce" | "slack" | "linear" | "notion" | "linkedin" | "github" | (string & {}) | "huggingface" | "apple" | "atlassian" | "cognito" | "discord" | "facebook" | "figma" | "microsoft" | "google" | "spotify" | "twitch" | "twitter" | "dropbox" | "kick" | "gitlab" | "tiktok" | "reddit" | "roblox" | "vk" | "zoom" | "kakao" | "naver" | "line" | "paybin" | "paypal" | "polar" | "railway" | "vercel" | "wechat";
         callbackURL?: string | undefined;
         newUserCallbackURL?: string | undefined;
         errorCallbackURL?: string | undefined;
@@ -91,7 +91,7 @@ export declare const signIn: {
         loginHint?: string | undefined;
         additionalData?: Record<string, any> | undefined;
     }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: import("better-auth/react").Prettify<{
-        provider: (string & {}) | "linear" | "huggingface" | "github" | "apple" | "atlassian" | "cognito" | "discord" | "facebook" | "figma" | "microsoft" | "google" | "slack" | "spotify" | "twitch" | "twitter" | "dropbox" | "kick" | "linkedin" | "gitlab" | "tiktok" | "reddit" | "roblox" | "salesforce" | "vk" | "zoom" | "notion" | "kakao" | "naver" | "line" | "paybin" | "paypal" | "polar" | "railway" | "vercel" | "wechat";
+        provider: "salesforce" | "slack" | "linear" | "notion" | "linkedin" | "github" | (string & {}) | "huggingface" | "apple" | "atlassian" | "cognito" | "discord" | "facebook" | "figma" | "microsoft" | "google" | "spotify" | "twitch" | "twitter" | "dropbox" | "kick" | "gitlab" | "tiktok" | "reddit" | "roblox" | "vk" | "zoom" | "kakao" | "naver" | "line" | "paybin" | "paypal" | "polar" | "railway" | "vercel" | "wechat";
         callbackURL?: string | undefined;
         newUserCallbackURL?: string | undefined;
         errorCallbackURL?: string | undefined;

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

@@ -2,7 +2,7 @@
  * `npx zitejs bundle` — Bundle endpoint files for cloudflare-lambda deployment.
  *
  * Replaces the legacy `scripts/bundle-endpoints.js` from zitejs-starter.
- * Reads endpoints from src/api/*.ts, resolves SDK imports via .zite/backend.ts
+ * Reads an app's src/api/*.ts endpoints (an automation's single src/workflow.ts), resolves SDK imports via .zite/backend.ts
  * (monorepo) or src/__zite__/integrations.ts (legacy), and outputs bundled ESM
  * code suitable for the cloudflare-lambda worker runtime.
  *
@@ -22,4 +22,8 @@
 import * as esbuild from 'esbuild';
 export declare const UNSUPPORTED_IN_WORKERD: Set<string>;
 export declare const BASE_BUILD_OPTIONS: esbuild.BuildOptions;
+export declare function createAliasPlugin(opts: {
+    baseDir?: string;
+    sdkPath?: string;
+}): esbuild.Plugin;
 export declare function runBundle(): Promise<void>;