zitejs 0.9.123 → 0.9.124

package/README.md

@@ -41,4 +41,8 @@ import { ZitePdf } from 'zitejs/pdf';
 
 // Scheduled tasks
 import { ZiteSchedule } from 'zitejs/schedules';
+
+// An integration's credentials, by its zite.config.json entry name
+import { integrations } from 'zitejs/integrations';
+const crm = await integrations.get('crm');
 ```

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

@@ -67,7 +67,7 @@ export declare const signIn: {
     }, FetchOptions["throw"] extends true ? true : false>>;
 } & {
     social: <FetchOptions extends import("@better-auth/core").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/cjs/bundle/index.d.ts

@@ -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>;

package/dist/cjs/bundle/index.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASE_BUILD_OPTIONS = exports.UNSUPPORTED_IN_WORKERD = void 0;
+exports.createAliasPlugin = createAliasPlugin;
 exports.runBundle = runBundle;
 /**
  * `npx zitejs bundle` — Bundle endpoint files for cloudflare-lambda deployment.
@@ -61,6 +62,8 @@ const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const parser_1 = require("@babel/parser");
 const node_module_1 = require("node:module");
+const client_js_1 = require("../integrations/client.js");
+const sdkCall_js_1 = require("../internal/sdkCall.js");
 const sourceRoots_js_1 = require("../sourceRoots.js");
 // workerd's `nodejs_compat` does not provide these. Left external they bundle
 // fine and then kill the worker at load time with `No such module`; excluded,
@@ -229,7 +232,7 @@ function getSdkImportSource(baseDir) {
     return 'zite-integrations-backend-sdk';
 }
 /**
- * `zitejs/db`, `zitejs/api`, `zitejs/integrations` and `zitejs/email` are
+ * `zitejs/db`, `zitejs/api` and `zitejs/email` are
  * tsconfig aliases onto generated files, not real package subpaths — they are
  * absent from the `exports` map. `zitejs/backend` IS a real subpath export, but
  * it lands here too and `zitejs` is not in PREBUNDLED_LIBS, so nothing would
@@ -242,6 +245,18 @@ const unresolvedAlias = (specifier, expectedPath) => {
     throw new Error(`Cannot resolve '${specifier}': expected generated file at ${expectedPath}. ` +
         `Run \`npx zitejs generate\` before bundling.`);
 };
+const AUTH_SERVER_SHIM_PATH = 'zitejs-auth-server-shim';
+const INTEGRATIONS_SHIM_PATH = 'zitejs-integrations-shim';
+const VIRTUAL_MODULES = {
+    [AUTH_SERVER_SHIM_PATH]: 'export const ziteAuth = (config) => config;',
+    [INTEGRATIONS_SHIM_PATH]: `export const integrations = {
+  get(name) {
+    const sdkCall = globalThis.__wrapSdkCall;
+    if (!sdkCall) throw new Error(${JSON.stringify(sdkCall_js_1.SDK_NOT_INITIALIZED_MESSAGE)});
+    return sdkCall(${JSON.stringify(client_js_1.INTEGRATIONS_SDK_INTEGRATION_ID)}, ${JSON.stringify(client_js_1.INTEGRATIONS_CLASS_NAME)}, 'get', { name });
+  },
+};`,
+};
 function createAliasPlugin(opts) {
     return {
         name: 'zite-alias',
@@ -293,14 +308,18 @@ function createAliasPlugin(opts) {
                 }
                 return unresolvedAlias('zitejs/api', `${opts.baseDir}/.zite/api.ts`);
             });
-            // Resolve zitejs/integrations to .zite/integrations/airtable.ts
+            // zitejs/integrations: the generated index (the integrations client plus
+            // any Airtable clients), else Airtable alone from an older generate, else
+            // this bundler's own client, whatever zitejs the project pins.
             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 };
+                    for (const file of ['index.ts', 'airtable.ts']) {
+                        const intPath = path.resolve(opts.baseDir, '.zite/integrations', file);
+                        if (fs.existsSync(intPath))
+                            return { path: intPath };
+                    }
                 }
-                return unresolvedAlias('zitejs/integrations', `${opts.baseDir}/.zite/integrations/airtable.ts`);
+                return { path: INTEGRATIONS_SHIM_PATH, namespace: 'zite-virtual' };
             });
             // Resolve zitejs/email to .zite/integrations/email.ts
             build.onResolve({ filter: /^zitejs\/email$/ }, () => {
@@ -314,11 +333,11 @@ function createAliasPlugin(opts) {
             // zitejs/auth/server is types + an identity wrapper — inline a shim so
             // zite.auth.ts bundles without resolving the installed package.
             build.onResolve({ filter: /^zitejs\/auth\/server$/ }, () => ({
-                path: 'zitejs-auth-server-shim',
+                path: AUTH_SERVER_SHIM_PATH,
                 namespace: 'zite-virtual',
             }));
-            build.onLoad({ filter: /.*/, namespace: 'zite-virtual' }, () => ({
-                contents: 'export const ziteAuth = (config) => config;',
+            build.onLoad({ filter: /.*/, namespace: 'zite-virtual' }, (args) => ({
+                contents: VIRTUAL_MODULES[args.path],
                 loader: 'js',
             }));
             // zitejs/runtime is NOT in PREBUNDLED_LIBS — it's a thin fetch()

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

@@ -1,2 +1,7 @@
+/**
+ * Whether the zitejs that `fromDir` resolves, nearest first up to the project root,
+ * has the integrations client: the CLI running generate can be newer than that pin.
+ */
+export declare function projectRuntimeHasIntegrationsClient(fromDir: string, projectRoot?: string): boolean;
 export declare function runGenerate(): Promise<void>;
 export declare function runDev(): Promise<void>;

package/dist/cjs/dev/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectRuntimeHasIntegrationsClient = projectRuntimeHasIntegrationsClient;
 exports.runGenerate = runGenerate;
 exports.runDev = runDev;
 const fs_1 = require("fs");
@@ -8,6 +9,7 @@ const path_1 = require("path");
 const sourceRoots_js_1 = require("../sourceRoots.js");
 const index_js_1 = require("../sync/index.js");
 const lib_js_1 = require("../sync/lib.js");
+const rules_js_1 = require("../integrations/rules.js");
 const debounceTimers = new Map();
 function debounce(key, fn, ms) {
     const existing = debounceTimers.get(key);
@@ -39,6 +41,48 @@ const readJsonFile = (path) => {
 function getEmailIntegrationId(appDir) {
     return (0, lib_js_1.findEmailIntegrationId)(readJsonFile((0, path_1.join)(appDir.path, "zite.config.json")), readJsonFile("zite.config.json"));
 }
+// `{}` with no file; undefined when unreadable, so a failed read keeps the old file.
+const readConfigIntegrations = (path) => {
+    if (!(0, fs_2.existsSync)(path))
+        return {};
+    const config = readJsonFile(path);
+    if (typeof config !== "object" || config === null)
+        return undefined;
+    const { integrations } = config;
+    if (integrations == null)
+        return {};
+    return typeof integrations === "object" && !Array.isArray(integrations)
+        ? integrations
+        : undefined;
+};
+/**
+ * Whether the zitejs that `fromDir` resolves, nearest first up to the project root,
+ * has the integrations client: the CLI running generate can be newer than that pin.
+ */
+function projectRuntimeHasIntegrationsClient(fromDir, projectRoot = process.cwd()) {
+    const root = (0, path_1.resolve)(projectRoot);
+    for (let dir = (0, path_1.resolve)(fromDir);; dir = (0, path_1.dirname)(dir)) {
+        const pkg = readJsonFile((0, path_1.join)(dir, "node_modules", "zitejs", "package.json"));
+        if (pkg)
+            return pkg.exports?.["./integrations"] !== undefined;
+        if (dir === root || (0, path_1.dirname)(dir) === dir)
+            return false;
+    }
+}
+// Runs after the Airtable step, so the index re-exports its clients when they exist.
+function regenerateAppIntegrationsIndex(appDir) {
+    if (!projectRuntimeHasIntegrationsClient(appDir.path))
+        return;
+    const root = readConfigIntegrations("zite.config.json");
+    const own = readConfigIntegrations((0, path_1.join)(appDir.path, "zite.config.json"));
+    if (!root || !own)
+        return;
+    const intDir = (0, path_1.join)(appDir.path, ".zite", "integrations");
+    (0, fs_2.mkdirSync)(intDir, { recursive: true });
+    (0, fs_2.writeFileSync)((0, path_1.join)(intDir, "index.ts"), (0, lib_js_1.generateIntegrationsIndex)((0, rules_js_1.gettableIntegrations)(root, own), {
+        reexportAirtable: (0, fs_2.existsSync)((0, path_1.join)(intDir, "airtable.ts")),
+    }));
+}
 function getDeclaredEnvVarNames(appDir) {
     try {
         const configPath = (0, path_1.join)(appDir.path, "zite.config.json");
@@ -153,6 +197,7 @@ async function runGenerate() {
         regenerateAppApiTs(app);
         regenerateAppTypedWrappers(app);
         regenerateAppAirtableSdk(app);
+        regenerateAppIntegrationsIndex(app);
     }
     console.log("Done!");
 }
@@ -173,6 +218,7 @@ async function runDev() {
     for (const app of appDirs) {
         regenerateAppApiTs(app);
         regenerateAppTypedWrappers(app);
+        regenerateAppIntegrationsIndex(app);
     }
     // 3. Watch each dir's src/api/ for endpoint changes
     let watchingAny = false;

package/dist/cjs/index.d.ts

@@ -1,3 +1,5 @@
 export { Zite } from "./client/index.js";
 export type { Record, RecordListOutput, RecordListOptions, FieldCreateInput, FieldUpdateInput, TableCreateInput, TableUpdateInput, DatabaseCreateInput, DatabaseListOutput, } from "./client/index.js";
 export * from "./types/index.js";
+export { CREDENTIAL_FIELDS, NON_CREDENTIAL_SERVICE_TYPES, gettableIntegrations, isCredentialServiceType, normalizeIntegrationServiceType, } from "./integrations/rules.js";
+export type { ConfigIntegrations, CredentialServiceType, GettableIntegration, } from "./integrations/rules.js";

package/dist/cjs/index.js

@@ -14,7 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Zite = void 0;
+exports.normalizeIntegrationServiceType = exports.isCredentialServiceType = exports.gettableIntegrations = exports.NON_CREDENTIAL_SERVICE_TYPES = exports.CREDENTIAL_FIELDS = exports.Zite = void 0;
 var index_js_1 = require("./client/index.js");
 Object.defineProperty(exports, "Zite", { enumerable: true, get: function () { return index_js_1.Zite; } });
 __exportStar(require("./types/index.js"), exports);
+var rules_js_1 = require("./integrations/rules.js");
+Object.defineProperty(exports, "CREDENTIAL_FIELDS", { enumerable: true, get: function () { return rules_js_1.CREDENTIAL_FIELDS; } });
+Object.defineProperty(exports, "NON_CREDENTIAL_SERVICE_TYPES", { enumerable: true, get: function () { return rules_js_1.NON_CREDENTIAL_SERVICE_TYPES; } });
+Object.defineProperty(exports, "gettableIntegrations", { enumerable: true, get: function () { return rules_js_1.gettableIntegrations; } });
+Object.defineProperty(exports, "isCredentialServiceType", { enumerable: true, get: function () { return rules_js_1.isCredentialServiceType; } });
+Object.defineProperty(exports, "normalizeIntegrationServiceType", { enumerable: true, get: function () { return rules_js_1.normalizeIntegrationServiceType; } });

package/dist/cjs/integrations/client.d.ts

@@ -0,0 +1,25 @@
+export declare const INTEGRATIONS_SDK_INTEGRATION_ID = "__connections__";
+export declare const INTEGRATIONS_CLASS_NAME = "Connections";
+/**
+ * `accessToken` is the service's primary credential (for Twilio the account SID).
+ * Call `get` where the value is used: a token refreshed mid-run is what the next call returns.
+ */
+export type Connected<Extra = {}> = {
+    status: "connected";
+    accessToken: string;
+} & Extra;
+/** No account behind the entry, or its token could not be refreshed. `connectUrl` is where a person fixes that. */
+export type NeedsConnect = {
+    status: "missing" | "expired";
+    connectUrl: string;
+};
+export interface IntegrationsClient<ByName extends Record<string, unknown>> {
+    /** The credentials of the `zite.config.json` integration entry named `name`. */
+    get<Name extends keyof ByName & string>(name: Name): Promise<ByName[Name]>;
+}
+/**
+ * `ByName` maps each entry name to its answer, e.g.
+ * `{ crm: Connected<{ instanceUrl: string }> | NeedsConnect }`; `zitejs generate`
+ * writes it per app into `.zite/integrations/index.ts`.
+ */
+export declare function createIntegrationsClient<ByName extends Record<string, unknown>>(): IntegrationsClient<ByName>;

package/dist/cjs/integrations/client.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INTEGRATIONS_CLASS_NAME = exports.INTEGRATIONS_SDK_INTEGRATION_ID = void 0;
+exports.createIntegrationsClient = createIntegrationsClient;
+const sdkCall_js_1 = require("../internal/sdkCall.js");
+// The worker and runner answer this call under its original name; renaming the
+// wire protocol would break every deployed bundle for no user-visible gain.
+exports.INTEGRATIONS_SDK_INTEGRATION_ID = "__connections__";
+exports.INTEGRATIONS_CLASS_NAME = "Connections";
+/**
+ * `ByName` maps each entry name to its answer, e.g.
+ * `{ crm: Connected<{ instanceUrl: string }> | NeedsConnect }`; `zitejs generate`
+ * writes it per app into `.zite/integrations/index.ts`.
+ */
+function createIntegrationsClient() {
+    return {
+        get(name) {
+            return (0, sdkCall_js_1.getSdkCall)()(exports.INTEGRATIONS_SDK_INTEGRATION_ID, exports.INTEGRATIONS_CLASS_NAME, "get", { name });
+        },
+    };
+}

package/dist/cjs/integrations/client.test-d.d.ts

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

package/dist/cjs/integrations/client.test-d.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const client_js_1 = require("./client.js");
+const index_js_1 = require("./index.js");
+const index_js_2 = require("../index.js");
+(0, vitest_1.describe)("createIntegrationsClient", () => {
+    const client = (0, client_js_1.createIntegrationsClient)();
+    (0, vitest_1.it)("types each name's answer", () => {
+        (0, vitest_1.expectTypeOf)(client.get("crm")).resolves.toEqualTypeOf();
+    });
+    (0, vitest_1.it)("rejects a name the app cannot see", () => {
+        // @ts-expect-error not a visible entry
+        void client.get("nope");
+    });
+    // What `.zite/integrations/index.ts` emits when nothing is visible.
+    (0, vitest_1.it)("accepts an empty map, naming nothing", () => {
+        const none = (0, client_js_1.createIntegrationsClient)();
+        (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+    });
+    (0, vitest_1.it)("narrows to the connected fields on status", async () => {
+        const crm = await client.get("crm");
+        if (crm.status === "connected") {
+            (0, vitest_1.expectTypeOf)(crm.instanceUrl).toEqualTypeOf();
+        }
+        else {
+            (0, vitest_1.expectTypeOf)(crm.connectUrl).toEqualTypeOf();
+        }
+    });
+});
+(0, vitest_1.describe)("the untyped zitejs/integrations client", () => {
+    (0, vitest_1.it)("takes any name; only accessToken is certain", async () => {
+        const entry = await index_js_1.integrations.get("anything");
+        if (entry.status === "connected") {
+            (0, vitest_1.expectTypeOf)(entry.accessToken).toEqualTypeOf();
+            (0, vitest_1.expectTypeOf)(entry.instanceUrl).toEqualTypeOf();
+        }
+    });
+});
+(0, vitest_1.describe)("CREDENTIAL_FIELDS", () => {
+    (0, vitest_1.it)("is keyed by service type, and a string narrows to one", () => {
+        (0, vitest_1.expectTypeOf)(index_js_2.CREDENTIAL_FIELDS.salesforce).toEqualTypeOf();
+        const type = "salesforce";
+        // @ts-expect-error a plain string is not a service type
+        void index_js_2.CREDENTIAL_FIELDS[type];
+        if ((0, index_js_2.isCredentialServiceType)(type)) {
+            (0, vitest_1.expectTypeOf)(index_js_2.CREDENTIAL_FIELDS[type]).toEqualTypeOf();
+        }
+    });
+});

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

@@ -0,0 +1,3 @@
+import { type Connected, type NeedsConnect } from "./client.js";
+export type { Connected, NeedsConnect } from "./client.js";
+export declare const integrations: import("./client.js").IntegrationsClient<Record<string, NeedsConnect | Connected<Partial<Record<string, string>>>>>;

package/dist/cjs/integrations/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.integrations = void 0;
+const client_js_1 = require("./client.js");
+// What code with no generated `.zite/integrations/index.ts` gets, e.g. a repo-root script.
+exports.integrations = (0, client_js_1.createIntegrationsClient)();

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

@@ -0,0 +1,67 @@
+declare const FIELDS_BY_TYPE: {
+    googleCalendar: readonly string[];
+    googleDrive: readonly string[];
+    gmail: readonly string[];
+    googleDocs: readonly string[];
+    hubspot: readonly string[];
+    salesforce: readonly string[];
+    twilio: readonly string[];
+    slack: readonly string[];
+    linear: readonly string[];
+    openai: readonly string[];
+    googlesheets: readonly string[];
+    microsoftTeams: readonly string[];
+    onedrive: readonly string[];
+    outlook: readonly string[];
+    intercom: readonly string[];
+    mailchimp: readonly string[];
+    anthropic: readonly string[];
+    gemini: readonly string[];
+    stripe: readonly string[];
+    trello: readonly string[];
+    notion: readonly string[];
+    facebookPages: readonly string[];
+    monday: readonly string[];
+    resend: readonly string[];
+    clickhouse: readonly string[];
+    amplitude: readonly string[];
+    elevenlabs: readonly string[];
+    brevo: readonly string[];
+    calendly: readonly string[];
+    asana: readonly string[];
+    xero: readonly string[];
+    googleForms: readonly string[];
+    linkedin: readonly string[];
+    github: readonly string[];
+    quickbooks: readonly string[];
+    firecrawl: readonly string[];
+    jira: readonly string[];
+    typeform: readonly string[];
+    apollo: readonly string[];
+    attio: readonly string[];
+};
+/** A service type `integrations.get` serves: one used through its npm package with a token. */
+export type CredentialServiceType = keyof typeof FIELDS_BY_TYPE;
+/** Per service type: `accessToken`, then its extra labels sorted (Salesforce `instanceUrl`). */
+export declare const CREDENTIAL_FIELDS: Readonly<Record<CredentialServiceType, readonly string[]>>;
+/**
+ * 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).
+ */
+export declare const NON_CREDENTIAL_SERVICE_TYPES: readonly string[];
+export declare const normalizeIntegrationServiceType: (type: string) => string;
+export declare const isCredentialServiceType: (type: string) => type is CredentialServiceType;
+/** One entry `integrations.get` can name from a source dir. */
+export type GettableIntegration = {
+    name: string;
+    serviceType: CredentialServiceType;
+};
+export type ConfigIntegrations = Readonly<Record<string, {
+    type?: unknown;
+} | undefined>>;
+/**
+ * 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.
+ */
+export declare const gettableIntegrations: (rootIntegrations: ConfigIntegrations | undefined, appIntegrations?: ConfigIntegrations) => GettableIntegration[];
+export {};

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";