zitejs 0.9.123 → 0.9.124

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/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

@@ -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/esm/bundle/index.js

@@ -24,6 +24,8 @@ import * as path from 'path';
 import * as fs from 'fs';
 import { parse } from '@babel/parser';
 import { builtinModules } from 'node:module';
+import { INTEGRATIONS_CLASS_NAME, INTEGRATIONS_SDK_INTEGRATION_ID, } from '../integrations/client.js';
+import { SDK_NOT_INITIALIZED_MESSAGE } from '../internal/sdkCall.js';
 import { AUTOMATION_ENDPOINT_NAME, endpointEntryFile, findSourceDir, listEndpointNames, sourceRootOf, } from '../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,
@@ -192,7 +194,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
@@ -205,7 +207,19 @@ const unresolvedAlias = (specifier, expectedPath) => {
     throw new Error(`Cannot resolve '${specifier}': expected generated file at ${expectedPath}. ` +
         `Run \`npx zitejs generate\` before bundling.`);
 };
-function createAliasPlugin(opts) {
+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(SDK_NOT_INITIALIZED_MESSAGE)});
+    return sdkCall(${JSON.stringify(INTEGRATIONS_SDK_INTEGRATION_ID)}, ${JSON.stringify(INTEGRATIONS_CLASS_NAME)}, 'get', { name });
+  },
+};`,
+};
+export function createAliasPlugin(opts) {
     return {
         name: 'zite-alias',
         setup(build) {
@@ -256,14 +270,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$/ }, () => {
@@ -277,11 +295,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/esm/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/esm/dev/index.js

@@ -1,9 +1,10 @@
 import { watch } from "fs";
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, } from "fs";
-import { join } from "path";
+import { dirname, join, resolve } from "path";
 import { listSourceDirs } from "../sourceRoots.js";
 import { runSync } from "../sync/index.js";
-import { generateDbTs, generateApiTs, generateBackendWrapperTs, generateAirtableTs, findEmailIntegrationId, generateEmailSdk, } from "../sync/lib.js";
+import { generateDbTs, generateApiTs, generateBackendWrapperTs, generateAirtableTs, findEmailIntegrationId, generateEmailSdk, generateIntegrationsIndex, } from "../sync/lib.js";
+import { gettableIntegrations, } from "../integrations/rules.js";
 const debounceTimers = new Map();
 function debounce(key, fn, ms) {
     const existing = debounceTimers.get(key);
@@ -35,6 +36,48 @@ const readJsonFile = (path) => {
 function getEmailIntegrationId(appDir) {
     return findEmailIntegrationId(readJsonFile(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 (!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.
+ */
+export function projectRuntimeHasIntegrationsClient(fromDir, projectRoot = process.cwd()) {
+    const root = resolve(projectRoot);
+    for (let dir = resolve(fromDir);; dir = dirname(dir)) {
+        const pkg = readJsonFile(join(dir, "node_modules", "zitejs", "package.json"));
+        if (pkg)
+            return pkg.exports?.["./integrations"] !== undefined;
+        if (dir === root || 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(join(appDir.path, "zite.config.json"));
+    if (!root || !own)
+        return;
+    const intDir = join(appDir.path, ".zite", "integrations");
+    mkdirSync(intDir, { recursive: true });
+    writeFileSync(join(intDir, "index.ts"), generateIntegrationsIndex(gettableIntegrations(root, own), {
+        reexportAirtable: existsSync(join(intDir, "airtable.ts")),
+    }));
+}
 function getDeclaredEnvVarNames(appDir) {
     try {
         const configPath = join(appDir.path, "zite.config.json");
@@ -149,6 +192,7 @@ export async function runGenerate() {
         regenerateAppApiTs(app);
         regenerateAppTypedWrappers(app);
         regenerateAppAirtableSdk(app);
+        regenerateAppIntegrationsIndex(app);
     }
     console.log("Done!");
 }
@@ -169,6 +213,7 @@ export 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/esm/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/esm/index.js

@@ -1,2 +1,3 @@
 export { Zite } from "./client/index.js";
 export * from "./types/index.js";
+export { CREDENTIAL_FIELDS, NON_CREDENTIAL_SERVICE_TYPES, gettableIntegrations, isCredentialServiceType, normalizeIntegrationServiceType, } from "./integrations/rules.js";

package/dist/esm/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/esm/integrations/client.js

@@ -0,0 +1,17 @@
+import { getSdkCall } from "../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.
+export const INTEGRATIONS_SDK_INTEGRATION_ID = "__connections__";
+export const 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`.
+ */
+export function createIntegrationsClient() {
+    return {
+        get(name) {
+            return getSdkCall()(INTEGRATIONS_SDK_INTEGRATION_ID, INTEGRATIONS_CLASS_NAME, "get", { name });
+        },
+    };
+}

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

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

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

@@ -0,0 +1,48 @@
+import { describe, it, expectTypeOf } from "vitest";
+import { createIntegrationsClient, } from "./client.js";
+import { integrations as untyped } from "./index.js";
+import { CREDENTIAL_FIELDS, isCredentialServiceType } from "../index.js";
+describe("createIntegrationsClient", () => {
+    const client = createIntegrationsClient();
+    it("types each name's answer", () => {
+        expectTypeOf(client.get("crm")).resolves.toEqualTypeOf();
+    });
+    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.
+    it("accepts an empty map, naming nothing", () => {
+        const none = createIntegrationsClient();
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("narrows to the connected fields on status", async () => {
+        const crm = await client.get("crm");
+        if (crm.status === "connected") {
+            expectTypeOf(crm.instanceUrl).toEqualTypeOf();
+        }
+        else {
+            expectTypeOf(crm.connectUrl).toEqualTypeOf();
+        }
+    });
+});
+describe("the untyped zitejs/integrations client", () => {
+    it("takes any name; only accessToken is certain", async () => {
+        const entry = await untyped.get("anything");
+        if (entry.status === "connected") {
+            expectTypeOf(entry.accessToken).toEqualTypeOf();
+            expectTypeOf(entry.instanceUrl).toEqualTypeOf();
+        }
+    });
+});
+describe("CREDENTIAL_FIELDS", () => {
+    it("is keyed by service type, and a string narrows to one", () => {
+        expectTypeOf(CREDENTIAL_FIELDS.salesforce).toEqualTypeOf();
+        const type = "salesforce";
+        // @ts-expect-error a plain string is not a service type
+        void CREDENTIAL_FIELDS[type];
+        if (isCredentialServiceType(type)) {
+            expectTypeOf(CREDENTIAL_FIELDS[type]).toEqualTypeOf();
+        }
+    });
+});

package/dist/esm/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/esm/integrations/index.js

@@ -0,0 +1,3 @@
+import { createIntegrationsClient, } from "./client.js";
+// What code with no generated `.zite/integrations/index.ts` gets, e.g. a repo-root script.
+export const integrations = createIntegrationsClient();

package/dist/esm/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 {};