zitejs 0.9.122 → 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

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

package/dist/cjs/bundle/index.js

@@ -34,12 +34,13 @@ 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.
  *
  * 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.
  *
@@ -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()
@@ -334,7 +353,7 @@ function createAliasPlugin(opts) {
         },
     };
 }
-function generateEndpointWrapper(endpointName, usedImports, sdkExportKinds, sdkSource) {
+function generateEndpointWrapper(entryImport, usedImports, sdkExportKinds, sdkSource) {
     // Always import the prebundled runtime to ensure globalThis.__wrapSdkCall
     // is available for createTableClient/createSqlClient from zitejs/runtime.
     const runtimeInit = `import { __wrapSdkCall, initRuntime } from '@zite/endpoints-runtime-sdk';
@@ -345,14 +364,14 @@ initRuntime();`;
 ${runtimeInit}
 import * as sdk from '${sdkSource}';
 Object.assign(globalThis, sdk);
-import endpoint from './api/${endpointName}';
+import endpoint from '${entryImport}';
 globalThis.__endpoint = endpoint;
 `;
     }
     if (usedImports.length === 0) {
         return `
 ${runtimeInit}
-import endpoint from './api/${endpointName}';
+import endpoint from '${entryImport}';
 globalThis.__endpoint = endpoint;
 `;
     }
@@ -380,11 +399,11 @@ globalThis.__endpoint = endpoint;
 ${runtimeInit}
 ${importStatements.join('\n')}
 ${globalAssign}
-import endpoint from './api/${endpointName}';
+import endpoint from '${entryImport}';
 globalThis.__endpoint = endpoint;
 `;
 }
-async function bundleEndpointsImpl(baseDir, endpointNames) {
+async function bundleEndpointsImpl(baseDir, root, endpointNames) {
     const bundledEndpoints = {};
     const endpointErrors = {};
     const aliasPlugin = createAliasPlugin({ baseDir });
@@ -399,14 +418,20 @@ async function bundleEndpointsImpl(baseDir, endpointNames) {
     }
     catch { }
     for (const name of endpointNames) {
+        if (root === 'automations' && name !== sourceRoots_js_1.AUTOMATION_ENDPOINT_NAME) {
+            endpointErrors[name] =
+                `An automation is one workflow, src/workflow.ts, bundled as "${sourceRoots_js_1.AUTOMATION_ENDPOINT_NAME}"; there is no endpoint "${name}"`;
+            continue;
+        }
+        const entryFile = (0, sourceRoots_js_1.endpointEntryFile)(root, name);
         let usedImports = null;
         try {
-            const endpointPath = path.join(baseDir, 'src', 'api', `${name}.ts`);
-            const endpointCode = fs.readFileSync(endpointPath, 'utf-8');
+            const endpointCode = fs.readFileSync(path.join(baseDir, entryFile), 'utf-8');
             usedImports = getUsedSdkImports(endpointCode);
         }
         catch { }
-        const wrapperCode = generateEndpointWrapper(name, usedImports, sdkExportKinds, sdkSource);
+        // The wrapper resolves from `src/`, so the entry is imported relative to it.
+        const wrapperCode = generateEndpointWrapper('./' + path.relative('src', entryFile).replace(/\.ts$/, ''), usedImports, sdkExportKinds, sdkSource);
         try {
             const result = await esbuild.build({
                 ...exports.BASE_BUILD_OPTIONS,
@@ -629,18 +654,13 @@ async function runBundle() {
     // as missing.
     const explicitNames = args.filter((a, i) => !a.startsWith('--') && !(appFlag !== -1 && i === appFlag + 1));
     let endpointNames;
+    const root = (0, sourceRoots_js_1.sourceRootOf)(baseDir) ?? 'apps';
     if (explicitNames.length > 0) {
         endpointNames = explicitNames;
     }
     else {
-        const apiDir = path.join(baseDir, 'src', 'api');
-        endpointNames = fs.existsSync(apiDir)
-            ? fs
-                .readdirSync(apiDir)
-                .filter(f => f.endsWith('.ts'))
-                .map(f => f.replace('.ts', ''))
-            : [];
+        endpointNames = (0, sourceRoots_js_1.listEndpointNames)(root, baseDir);
     }
     // Even with no endpoints, zite.auth.ts may still need bundling.
-    return bundleEndpointsImpl(baseDir, endpointNames);
+    return bundleEndpointsImpl(baseDir, root, endpointNames);
 }

package/dist/cjs/check/index.js

@@ -65,7 +65,7 @@ async function runCheck() {
         process.exit(1);
     }
     let allPassed = true;
-    for (const { dir: app, path: appPath } of appDirs) {
+    for (const { root, dir: app, path: appPath } of appDirs) {
         console.log(`\n── ${appPath} ──`);
         // Only tsconfig.app.json compiles anything. The app's tsconfig.json is a
         // solution-style config — `"files": []` plus a reference — so
@@ -92,7 +92,7 @@ async function runCheck() {
         // Endpoints never reach vite — they are bundled separately for the lambda,
         // against a different resolver. tsc and vite both pass on an endpoint whose
         // `zitejs/*` alias has no generated file behind it; only the bundler knows.
-        if ((0, fs_1.existsSync)((0, path_1.join)(appPath, 'src', 'api'))) {
+        if ((0, sourceRoots_js_1.listEndpointNames)(root, appPath).length > 0) {
             process.stdout.write('  bundle endpoints ... ');
             const bundle = run('npx', ['zitejs', 'bundle', '--app', app], '.');
             const failures = bundle.ok ? bundleFailures(bundle.output) : [bundle.output];

package/dist/cjs/cli.js

@@ -75,7 +75,7 @@ async function main() {
             console.error('  dev       Run sync then watch for changes (like npx convex dev)');
             console.error('  generate  Regenerate every app and automation .zite/ (monorepo)');
             console.error('  check   Run tsc --noEmit (and vite build where there is one) for every app and automation');
-            console.error('  bundle  Bundle src/api/*.ts endpoints for cloudflare-lambda');
+            console.error('  bundle  Bundle endpoints (src/api/*.ts, or an automation\'s src/workflow.ts) for cloudflare-lambda');
             process.exit(1);
     }
 }

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;
@@ -194,7 +240,7 @@ async function runDev() {
         });
     }
     if (!watchingAny) {
-        console.log("No apps or automations with src/api/ found.");
+        console.log("No apps with src/api/ found.");
     }
     // 4. Watch zite.schema.json for schema drift
     if ((0, fs_2.existsSync)("zite.schema.json")) {

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 {};