zitejs 0.9.127 → 0.9.129

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

@@ -22,6 +22,21 @@ export type ZiteTrigger = {
     label?: string;
     paused?: boolean;
     every?: never;
+    events?: never;
+} | {
+    /**
+     * The connection's name in `zite.config.json`, for a provider whose
+     * webhooks come through Zite's own app (Slack, HubSpot, Notion,
+     * Intercom, QuickBooks). Nothing is registered: the platform routes
+     * that account's events of these types to the endpoint.
+     */
+    integration: string;
+    /** Event names as the platform lists them for the provider, e.g. `message.channels`, `contact.creation`. */
+    events: string[];
+    /** The sentence the editor shows for what fires this endpoint, e.g. "When a message is posted in Slack". */
+    label?: string;
+    paused?: boolean;
+    every?: never;
 } | {
     /** `<n>m` (1–59) or `<n>h` (1–23). What makes the trigger a poll. */
     every: string;
@@ -30,6 +45,7 @@ export type ZiteTrigger = {
     /** The sentence the editor shows for this poll, e.g. "Every 10 minutes, new Stripe charges". */
     label?: string;
     paused?: boolean;
+    events?: never;
 };
 /**
  * What a provider trigger's `subscribe` export receives. Write it as
@@ -97,6 +113,8 @@ export type ZiteTriggerDelivery = {
     /** Ids earlier deliveries returned as `handled`, newest last. Skip these. */
     seen: string[];
 };
+/** What an app event trigger's run carries as `input.__webhook`: one event, no cursor. */
+export type ZiteAppEventDelivery = Omit<ZiteTriggerDelivery, "cursor" | "seen">;
 /**
  * What a poll-triggered run, or a provider trigger's delivery, returns for
  * the platform to keep: its new `cursor`, and the id of every item it acted
@@ -203,6 +221,10 @@ export interface EndpointConfig<TInput = unknown, TOutput = unknown, TStream ext
             every: string;
         } ? TInput & {
             __poll?: ZitePollInput;
+        } : TTrigger extends {
+            events: string[];
+        } ? TInput & {
+            __webhook?: ZiteAppEventDelivery;
         } : TTrigger extends {
             integration: string;
         } ? TInput & {

package/dist/cjs/backend/index.test.js

@@ -201,6 +201,32 @@ const requestContext = { user: { id: "u1", email: "a@b.c" } };
             context: { user: null },
         })).resolves.toEqual({ cursor: "sync1+1", handled: ["e2"] });
     });
+    (0, vitest_1.it)("types an app event trigger's run as one event, with no cursor to keep", async () => {
+        const endpoint = (0, index_js_1.createEndpoint)({
+            inputSchema: zod_1.z.object({ event: zod_1.z.object({ text: zod_1.z.string() }) }),
+            trigger: { integration: "team-slack", events: ["message.channels"] },
+            execute: async ({ input }) => {
+                // @ts-expect-error an app event delivery has no cursor
+                void input.__webhook?.cursor;
+                return { id: input.__webhook?.deliveryId ?? null };
+            },
+        });
+        await (0, vitest_1.expect)(endpoint.execute({
+            input: {
+                event: { text: "hi" },
+                __webhook: { headers: {}, deliveryId: "slack:Ev1" },
+            },
+            context: { user: null },
+        })).resolves.toEqual({ id: "slack:Ev1" });
+    });
+    (0, vitest_1.it)("refuses events on a trigger that also polls", () => {
+        (0, index_js_1.createEndpoint)({
+            inputSchema: zod_1.z.object({}),
+            // @ts-expect-error a poll can't also take events
+            trigger: { every: "5m", events: ["message.channels"] },
+            execute: async () => ({}),
+        });
+    });
     (0, vitest_1.it)("does not validate a webhook fire", async () => {
         const endpoint = (0, index_js_1.createEndpoint)({
             inputSchema: zod_1.z.object({ token: zod_1.z.string().min(10) }),

package/dist/cjs/bundle/index.js

@@ -592,10 +592,6 @@ ${bodySection}
             },
             minify: false,
             logLevel: 'silent',
-            // A script that imports an endpoint file's named exports (a trigger's
-            // subscribe/unsubscribe) must not carry the endpoint along with them:
-            // unused, its `createEndpoint(...)` and everything `execute` imports go.
-            pure: ['createEndpoint'],
             plugins: [plugin],
         });
         if (result.errors.length > 0) {

package/dist/cjs/index.d.ts

@@ -1,5 +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 { CREDENTIAL_FIELDS, NON_CREDENTIAL_SERVICE_TYPES, OPTIONAL_CREDENTIAL_FIELDS, gettableIntegrations, isCredentialServiceType, normalizeIntegrationServiceType, } from "./integrations/rules.js";
 export type { ConfigIntegrations, CredentialServiceType, GettableIntegration, } from "./integrations/rules.js";

package/dist/cjs/index.js

@@ -14,13 +14,14 @@ 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.normalizeIntegrationServiceType = exports.isCredentialServiceType = exports.gettableIntegrations = exports.NON_CREDENTIAL_SERVICE_TYPES = exports.CREDENTIAL_FIELDS = exports.Zite = void 0;
+exports.normalizeIntegrationServiceType = exports.isCredentialServiceType = exports.gettableIntegrations = exports.OPTIONAL_CREDENTIAL_FIELDS = 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, "OPTIONAL_CREDENTIAL_FIELDS", { enumerable: true, get: function () { return rules_js_1.OPTIONAL_CREDENTIAL_FIELDS; } });
 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/rules.d.ts

@@ -45,6 +45,11 @@ declare const FIELDS_BY_TYPE: {
 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[]>>;
+/**
+ * Extras the platform omits when the account doesn't have them: a Jira site
+ * connected before its URL was stored, a Trello key the deployment never set.
+ */
+export declare const OPTIONAL_CREDENTIAL_FIELDS: Readonly<Partial<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).

package/dist/cjs/integrations/rules.js

@@ -2,7 +2,7 @@
 // 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;
+exports.gettableIntegrations = exports.isCredentialServiceType = exports.normalizeIntegrationServiceType = exports.NON_CREDENTIAL_SERVICE_TYPES = exports.OPTIONAL_CREDENTIAL_FIELDS = exports.CREDENTIAL_FIELDS = void 0;
 const extras = (...labels) => [
     "accessToken",
     ...[...labels].sort(),
@@ -52,6 +52,14 @@ const FIELDS_BY_TYPE = {
 };
 /** Per service type: `accessToken`, then its extra labels sorted (Salesforce `instanceUrl`). */
 exports.CREDENTIAL_FIELDS = FIELDS_BY_TYPE;
+/**
+ * Extras the platform omits when the account doesn't have them: a Jira site
+ * connected before its URL was stored, a Trello key the deployment never set.
+ */
+exports.OPTIONAL_CREDENTIAL_FIELDS = {
+    jira: ["siteUrl"],
+    trello: ["clientApiKey"],
+};
 /**
  * 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).

package/dist/cjs/sync/lib.js

@@ -1232,10 +1232,13 @@ function generateBackendWrapperTs(envVarNames = []) {
         "// Auto-generated type-narrowing wrapper. Do not edit manually.",
         "// Re-exports createEndpoint with context.user typed to the app User.",
         "",
-        "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStreamInterface, ZiteTrigger, ZiteWebhook } from 'zitejs/backend/base';",
+        "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStreamInterface, ZiteTrigger, ZiteTriggerDelivery, ZiteAppEventDelivery, ZitePollInput, ZiteWebhook } from 'zitejs/backend/base';",
         "import type { User } from 'zitejs/auth';",
         "",
         "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStreamInterface, ZiteTrigger, ZiteWebhook };",
+        // A trigger's registration exports are typed against these, and they
+        // only reach app code through this file.
+        "export type { ZiteAppEventDelivery, ZitePollInput, ZitePollResult, ZiteTriggerDelivery, ZiteTriggerSubscribe, ZiteTriggerSubscribeInput, ZiteTriggerSubscribeResult, ZiteTriggerUnsubscribe, ZiteTriggerUnsubscribeInput } from 'zitejs/backend/base';",
         // The pre-monorepo SDK put this in scope for every endpoint, so migrated
         // code can name it. `createEndpoint` infers the same thing without it.
         "export type InferSchemaType<T> = T extends { _output: infer U } ? U : T;",
@@ -1322,11 +1325,13 @@ function generateBackendWrapperTs(envVarNames = []) {
         "  schedule?: TSchedule;",
         "  /** When set, an inbound webhook can also trigger this endpoint. Like `schedule`, it widens `context` — a webhook fire has no session. */",
         "  webhook?: TWebhook;",
-        "  /** When set, a workspace connection's events (registered by `src/triggers/<endpointId>/subscribe.ts`) or a poll also fire this endpoint. Like `webhook`, it widens `context` — a trigger fire has no session. */",
+        "  /** When set, a connection's events (registered by this file's own `subscribe` export) or a poll (`every`) also fire this endpoint. Like `webhook`, it widens `context` — a trigger fire has no session. */",
         "  trigger?: TTrigger;",
         "  execute: (",
         "    params: {",
-        "      input: TInput;",
+        // Mirrors the base module: a poll's run carries `__poll`, a provider
+        // trigger's delivery `__webhook`.
+        "      input: TTrigger extends { every: string } ? TInput & { __poll?: ZitePollInput } : TTrigger extends { events: string[] } ? TInput & { __webhook?: ZiteAppEventDelivery } : TTrigger extends { integration: string } ? TInput & { __webhook?: ZiteTriggerDelivery } : TInput;",
         "      context: TSchedule extends ZiteSchedule ? ZiteRequestContext | ZiteScheduledContext : TWebhook extends ZiteWebhook ? ZiteRequestContext | ZiteScheduledContext : TTrigger extends ZiteTrigger ? ZiteRequestContext | ZiteScheduledContext : ZiteRequestContext;",
         "    } & (TStream extends true ? { stream: ZiteStreamInterface } : {}),",
         "  ) => Promise<TOutput> | TOutput;",
@@ -1401,9 +1406,12 @@ function generateEmailSdk(integrationId) {
 }
 const connectedTypeFor = (serviceType) => {
     const extraLabels = rules_js_1.CREDENTIAL_FIELDS[serviceType].slice(1);
+    const optional = rules_js_1.OPTIONAL_CREDENTIAL_FIELDS[serviceType] ?? [];
     return extraLabels.length === 0
         ? "Connected"
-        : `Connected<{ ${extraLabels.map((label) => `${label}: string`).join("; ")} }>`;
+        : `Connected<{ ${extraLabels
+            .map((label) => `${label}${optional.includes(label) ? "?" : ""}: string`)
+            .join("; ")} }>`;
 };
 /**
  * `.zite/integrations/index.ts`: `zitejs/integrations` for one source dir. The

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

@@ -387,6 +387,14 @@ const duplicateIdentifierErrorsIn = (source) => {
         (0, vitest_1.expect)(output).toContain('TTrigger extends ZiteTrigger | undefined = undefined');
         (0, vitest_1.expect)(output).toContain('ZiteTrigger, ZiteWebhook }');
     });
+    (0, vitest_1.it)('passes the trigger registration types and trigger inputs through to app code', () => {
+        (0, vitest_1.expect)(output).toContain('ZiteTriggerSubscribe, ZiteTriggerSubscribeInput');
+        (0, vitest_1.expect)(output).toContain('ZiteTriggerUnsubscribe, ZiteTriggerUnsubscribeInput');
+        (0, vitest_1.expect)(output).toContain("TTrigger extends { every: string } ? TInput & { __poll?: ZitePollInput }");
+        (0, vitest_1.expect)(output).toContain('TInput & { __webhook?: ZiteTriggerDelivery }');
+        (0, vitest_1.expect)(output).toContain("TTrigger extends { events: string[] } ? TInput & { __webhook?: ZiteAppEventDelivery }");
+        (0, vitest_1.expect)(output).not.toContain('src/triggers/');
+    });
     (0, vitest_1.it)('exports ZiteError', () => {
         (0, vitest_1.expect)(output).toContain('ZiteError');
     });
@@ -490,6 +498,20 @@ const duplicateIdentifierErrorsIn = (source) => {
       "
     `);
     });
+    // The platform leaves these out for some accounts, so the type can't promise them.
+    (0, vitest_1.it)('marks an extra the platform may omit as optional', () => {
+        const generated = (0, lib_js_1.generateIntegrationsIndex)([{ name: 'tickets', serviceType: 'jira' }], { reexportAirtable: false });
+        (0, vitest_1.expect)(generated).toContain("'tickets': Connected<{ cloudId: string; siteUrl?: string }> | NeedsConnect;");
+        (0, vitest_1.expect)(typeErrorsIn(generated, `import { integrations } from 'zitejs/integrations';
+const jira = await integrations.get('tickets');
+if (jira.status === 'connected') {
+  const cloudId: string = jira.cloudId;
+  const siteUrl: string = jira.siteUrl;
+}
+`)).toEqual([
+            vitest_1.expect.stringContaining("Type 'string | undefined' is not assignable"),
+        ]);
+    });
     (0, vitest_1.it)('types get per name in app code', () => {
         const generated = (0, lib_js_1.generateIntegrationsIndex)([
             { name: 'crm', serviceType: 'salesforce' },

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

@@ -22,6 +22,21 @@ export type ZiteTrigger = {
     label?: string;
     paused?: boolean;
     every?: never;
+    events?: never;
+} | {
+    /**
+     * The connection's name in `zite.config.json`, for a provider whose
+     * webhooks come through Zite's own app (Slack, HubSpot, Notion,
+     * Intercom, QuickBooks). Nothing is registered: the platform routes
+     * that account's events of these types to the endpoint.
+     */
+    integration: string;
+    /** Event names as the platform lists them for the provider, e.g. `message.channels`, `contact.creation`. */
+    events: string[];
+    /** The sentence the editor shows for what fires this endpoint, e.g. "When a message is posted in Slack". */
+    label?: string;
+    paused?: boolean;
+    every?: never;
 } | {
     /** `<n>m` (1–59) or `<n>h` (1–23). What makes the trigger a poll. */
     every: string;
@@ -30,6 +45,7 @@ export type ZiteTrigger = {
     /** The sentence the editor shows for this poll, e.g. "Every 10 minutes, new Stripe charges". */
     label?: string;
     paused?: boolean;
+    events?: never;
 };
 /**
  * What a provider trigger's `subscribe` export receives. Write it as
@@ -97,6 +113,8 @@ export type ZiteTriggerDelivery = {
     /** Ids earlier deliveries returned as `handled`, newest last. Skip these. */
     seen: string[];
 };
+/** What an app event trigger's run carries as `input.__webhook`: one event, no cursor. */
+export type ZiteAppEventDelivery = Omit<ZiteTriggerDelivery, "cursor" | "seen">;
 /**
  * What a poll-triggered run, or a provider trigger's delivery, returns for
  * the platform to keep: its new `cursor`, and the id of every item it acted
@@ -203,6 +221,10 @@ export interface EndpointConfig<TInput = unknown, TOutput = unknown, TStream ext
             every: string;
         } ? TInput & {
             __poll?: ZitePollInput;
+        } : TTrigger extends {
+            events: string[];
+        } ? TInput & {
+            __webhook?: ZiteAppEventDelivery;
         } : TTrigger extends {
             integration: string;
         } ? TInput & {

package/dist/esm/backend/index.test.js

@@ -199,6 +199,32 @@ describe("platform-triggered runs", () => {
             context: { user: null },
         })).resolves.toEqual({ cursor: "sync1+1", handled: ["e2"] });
     });
+    it("types an app event trigger's run as one event, with no cursor to keep", async () => {
+        const endpoint = createEndpoint({
+            inputSchema: z.object({ event: z.object({ text: z.string() }) }),
+            trigger: { integration: "team-slack", events: ["message.channels"] },
+            execute: async ({ input }) => {
+                // @ts-expect-error an app event delivery has no cursor
+                void input.__webhook?.cursor;
+                return { id: input.__webhook?.deliveryId ?? null };
+            },
+        });
+        await expect(endpoint.execute({
+            input: {
+                event: { text: "hi" },
+                __webhook: { headers: {}, deliveryId: "slack:Ev1" },
+            },
+            context: { user: null },
+        })).resolves.toEqual({ id: "slack:Ev1" });
+    });
+    it("refuses events on a trigger that also polls", () => {
+        createEndpoint({
+            inputSchema: z.object({}),
+            // @ts-expect-error a poll can't also take events
+            trigger: { every: "5m", events: ["message.channels"] },
+            execute: async () => ({}),
+        });
+    });
     it("does not validate a webhook fire", async () => {
         const endpoint = createEndpoint({
             inputSchema: z.object({ token: z.string().min(10) }),

package/dist/esm/bundle/index.js

@@ -554,10 +554,6 @@ ${bodySection}
             },
             minify: false,
             logLevel: 'silent',
-            // A script that imports an endpoint file's named exports (a trigger's
-            // subscribe/unsubscribe) must not carry the endpoint along with them:
-            // unused, its `createEndpoint(...)` and everything `execute` imports go.
-            pure: ['createEndpoint'],
             plugins: [plugin],
         });
         if (result.errors.length > 0) {

package/dist/esm/index.d.ts

@@ -1,5 +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 { CREDENTIAL_FIELDS, NON_CREDENTIAL_SERVICE_TYPES, OPTIONAL_CREDENTIAL_FIELDS, gettableIntegrations, isCredentialServiceType, normalizeIntegrationServiceType, } from "./integrations/rules.js";
 export type { ConfigIntegrations, CredentialServiceType, GettableIntegration, } from "./integrations/rules.js";

package/dist/esm/index.js

@@ -1,3 +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";
+export { CREDENTIAL_FIELDS, NON_CREDENTIAL_SERVICE_TYPES, OPTIONAL_CREDENTIAL_FIELDS, gettableIntegrations, isCredentialServiceType, normalizeIntegrationServiceType, } from "./integrations/rules.js";

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

@@ -45,6 +45,11 @@ declare const FIELDS_BY_TYPE: {
 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[]>>;
+/**
+ * Extras the platform omits when the account doesn't have them: a Jira site
+ * connected before its URL was stored, a Trello key the deployment never set.
+ */
+export declare const OPTIONAL_CREDENTIAL_FIELDS: Readonly<Partial<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).

package/dist/esm/integrations/rules.js

@@ -49,6 +49,14 @@ const FIELDS_BY_TYPE = {
 };
 /** Per service type: `accessToken`, then its extra labels sorted (Salesforce `instanceUrl`). */
 export const CREDENTIAL_FIELDS = FIELDS_BY_TYPE;
+/**
+ * Extras the platform omits when the account doesn't have them: a Jira site
+ * connected before its URL was stored, a Trello key the deployment never set.
+ */
+export const OPTIONAL_CREDENTIAL_FIELDS = {
+    jira: ["siteUrl"],
+    trello: ["clientApiKey"],
+};
 /**
  * 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).

package/dist/esm/sync/lib.js

@@ -1,6 +1,6 @@
 import { parse } from "@babel/parser";
 import { allocateSchemaNames, describeRenames, keepValidSdkName, normalizeSchemaNames, SdkNameAllocator, toCamelCase, toPascalCase, toSdkName, } from "./sdkNames.js";
-import { CREDENTIAL_FIELDS, } from "../integrations/rules.js";
+import { CREDENTIAL_FIELDS, OPTIONAL_CREDENTIAL_FIELDS, } from "../integrations/rules.js";
 const AUTH_USERS_TABLE_ID = "zite_user";
 /**
  * What a field's value looks like when a record is READ back.
@@ -1217,10 +1217,13 @@ export function generateBackendWrapperTs(envVarNames = []) {
         "// Auto-generated type-narrowing wrapper. Do not edit manually.",
         "// Re-exports createEndpoint with context.user typed to the app User.",
         "",
-        "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStreamInterface, ZiteTrigger, ZiteWebhook } from 'zitejs/backend/base';",
+        "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStreamInterface, ZiteTrigger, ZiteTriggerDelivery, ZiteAppEventDelivery, ZitePollInput, ZiteWebhook } from 'zitejs/backend/base';",
         "import type { User } from 'zitejs/auth';",
         "",
         "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStreamInterface, ZiteTrigger, ZiteWebhook };",
+        // A trigger's registration exports are typed against these, and they
+        // only reach app code through this file.
+        "export type { ZiteAppEventDelivery, ZitePollInput, ZitePollResult, ZiteTriggerDelivery, ZiteTriggerSubscribe, ZiteTriggerSubscribeInput, ZiteTriggerSubscribeResult, ZiteTriggerUnsubscribe, ZiteTriggerUnsubscribeInput } from 'zitejs/backend/base';",
         // The pre-monorepo SDK put this in scope for every endpoint, so migrated
         // code can name it. `createEndpoint` infers the same thing without it.
         "export type InferSchemaType<T> = T extends { _output: infer U } ? U : T;",
@@ -1307,11 +1310,13 @@ export function generateBackendWrapperTs(envVarNames = []) {
         "  schedule?: TSchedule;",
         "  /** When set, an inbound webhook can also trigger this endpoint. Like `schedule`, it widens `context` — a webhook fire has no session. */",
         "  webhook?: TWebhook;",
-        "  /** When set, a workspace connection's events (registered by `src/triggers/<endpointId>/subscribe.ts`) or a poll also fire this endpoint. Like `webhook`, it widens `context` — a trigger fire has no session. */",
+        "  /** When set, a connection's events (registered by this file's own `subscribe` export) or a poll (`every`) also fire this endpoint. Like `webhook`, it widens `context` — a trigger fire has no session. */",
         "  trigger?: TTrigger;",
         "  execute: (",
         "    params: {",
-        "      input: TInput;",
+        // Mirrors the base module: a poll's run carries `__poll`, a provider
+        // trigger's delivery `__webhook`.
+        "      input: TTrigger extends { every: string } ? TInput & { __poll?: ZitePollInput } : TTrigger extends { events: string[] } ? TInput & { __webhook?: ZiteAppEventDelivery } : TTrigger extends { integration: string } ? TInput & { __webhook?: ZiteTriggerDelivery } : TInput;",
         "      context: TSchedule extends ZiteSchedule ? ZiteRequestContext | ZiteScheduledContext : TWebhook extends ZiteWebhook ? ZiteRequestContext | ZiteScheduledContext : TTrigger extends ZiteTrigger ? ZiteRequestContext | ZiteScheduledContext : ZiteRequestContext;",
         "    } & (TStream extends true ? { stream: ZiteStreamInterface } : {}),",
         "  ) => Promise<TOutput> | TOutput;",
@@ -1386,9 +1391,12 @@ export function generateEmailSdk(integrationId) {
 }
 const connectedTypeFor = (serviceType) => {
     const extraLabels = CREDENTIAL_FIELDS[serviceType].slice(1);
+    const optional = OPTIONAL_CREDENTIAL_FIELDS[serviceType] ?? [];
     return extraLabels.length === 0
         ? "Connected"
-        : `Connected<{ ${extraLabels.map((label) => `${label}: string`).join("; ")} }>`;
+        : `Connected<{ ${extraLabels
+            .map((label) => `${label}${optional.includes(label) ? "?" : ""}: string`)
+            .join("; ")} }>`;
 };
 /**
  * `.zite/integrations/index.ts`: `zitejs/integrations` for one source dir. The

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

@@ -382,6 +382,14 @@ describe('generateBackendWrapperTs', () => {
         expect(output).toContain('TTrigger extends ZiteTrigger | undefined = undefined');
         expect(output).toContain('ZiteTrigger, ZiteWebhook }');
     });
+    it('passes the trigger registration types and trigger inputs through to app code', () => {
+        expect(output).toContain('ZiteTriggerSubscribe, ZiteTriggerSubscribeInput');
+        expect(output).toContain('ZiteTriggerUnsubscribe, ZiteTriggerUnsubscribeInput');
+        expect(output).toContain("TTrigger extends { every: string } ? TInput & { __poll?: ZitePollInput }");
+        expect(output).toContain('TInput & { __webhook?: ZiteTriggerDelivery }');
+        expect(output).toContain("TTrigger extends { events: string[] } ? TInput & { __webhook?: ZiteAppEventDelivery }");
+        expect(output).not.toContain('src/triggers/');
+    });
     it('exports ZiteError', () => {
         expect(output).toContain('ZiteError');
     });
@@ -485,6 +493,20 @@ describe('generateIntegrationsIndex', () => {
       "
     `);
     });
+    // The platform leaves these out for some accounts, so the type can't promise them.
+    it('marks an extra the platform may omit as optional', () => {
+        const generated = generateIntegrationsIndex([{ name: 'tickets', serviceType: 'jira' }], { reexportAirtable: false });
+        expect(generated).toContain("'tickets': Connected<{ cloudId: string; siteUrl?: string }> | NeedsConnect;");
+        expect(typeErrorsIn(generated, `import { integrations } from 'zitejs/integrations';
+const jira = await integrations.get('tickets');
+if (jira.status === 'connected') {
+  const cloudId: string = jira.cloudId;
+  const siteUrl: string = jira.siteUrl;
+}
+`)).toEqual([
+            expect.stringContaining("Type 'string | undefined' is not assignable"),
+        ]);
+    });
     it('types get per name in app code', () => {
         const generated = generateIntegrationsIndex([
             { name: 'crm', serviceType: 'salesforce' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zitejs",
-  "version": "0.9.127",
+  "version": "0.9.129",
   "description": "The Zite framework — build apps on Zite Database",
   "type": "module",
   "sideEffects": false,

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

@@ -1,14 +0,0 @@
-export type ZiteProjectUser = {
-    uuid: string;
-    firstName: string | null;
-    lastName: string | null;
-    email: string;
-    profilePictureUrl: string | null;
-};
-export type MetaListUsersResult = {
-    users: ZiteProjectUser[];
-};
-export declare class ZiteMeta {
-    static listUsers(): Promise<MetaListUsersResult>;
-}
-export declare const Meta: typeof ZiteMeta;

package/dist/cjs/meta/index.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Meta = exports.ZiteMeta = void 0;
-const sdkCall_js_1 = require("../internal/sdkCall.js");
-const META_SDK_INTEGRATION_ID = '__meta__';
-class ZiteMeta {
-    static listUsers() {
-        return (0, sdkCall_js_1.getSdkCall)()(META_SDK_INTEGRATION_ID, 'ZiteMeta', 'listUsers', {});
-    }
-}
-exports.ZiteMeta = ZiteMeta;
-exports.Meta = ZiteMeta;

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

@@ -1,25 +0,0 @@
-export interface NotificationLink {
-    path?: string;
-    params?: Record<string, string>;
-}
-export type NotificationsCreateParams = {
-    recipients: string[];
-    title: string;
-    body?: string;
-    link?: NotificationLink;
-    path?: string;
-    params?: Record<string, string>;
-    payload?: Record<string, unknown>;
-    idempotencyKey?: string;
-};
-export type NotificationsCreateResult = {
-    created: number;
-} | {
-    created: 0;
-    preview: true;
-    wouldCreate: number;
-};
-export declare class ZiteNotifications {
-    static create(params: NotificationsCreateParams): Promise<NotificationsCreateResult>;
-}
-export declare const Notifications: typeof ZiteNotifications;

package/dist/cjs/notifications/index.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Notifications = exports.ZiteNotifications = void 0;
-const sdkCall_js_1 = require("../internal/sdkCall.js");
-const NOTIFICATIONS_SDK_INTEGRATION_ID = '__notifications__';
-class ZiteNotifications {
-    static create(params) {
-        return (0, sdkCall_js_1.getSdkCall)()(NOTIFICATIONS_SDK_INTEGRATION_ID, 'ZiteNotifications', 'create', params);
-    }
-}
-exports.ZiteNotifications = ZiteNotifications;
-exports.Notifications = ZiteNotifications;

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

@@ -1,14 +0,0 @@
-export type ZiteProjectUser = {
-    uuid: string;
-    firstName: string | null;
-    lastName: string | null;
-    email: string;
-    profilePictureUrl: string | null;
-};
-export type MetaListUsersResult = {
-    users: ZiteProjectUser[];
-};
-export declare class ZiteMeta {
-    static listUsers(): Promise<MetaListUsersResult>;
-}
-export declare const Meta: typeof ZiteMeta;

package/dist/esm/meta/index.js

@@ -1,8 +0,0 @@
-import { getSdkCall } from '../internal/sdkCall.js';
-const META_SDK_INTEGRATION_ID = '__meta__';
-export class ZiteMeta {
-    static listUsers() {
-        return getSdkCall()(META_SDK_INTEGRATION_ID, 'ZiteMeta', 'listUsers', {});
-    }
-}
-export const Meta = ZiteMeta;

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

@@ -1,25 +0,0 @@
-export interface NotificationLink {
-    path?: string;
-    params?: Record<string, string>;
-}
-export type NotificationsCreateParams = {
-    recipients: string[];
-    title: string;
-    body?: string;
-    link?: NotificationLink;
-    path?: string;
-    params?: Record<string, string>;
-    payload?: Record<string, unknown>;
-    idempotencyKey?: string;
-};
-export type NotificationsCreateResult = {
-    created: number;
-} | {
-    created: 0;
-    preview: true;
-    wouldCreate: number;
-};
-export declare class ZiteNotifications {
-    static create(params: NotificationsCreateParams): Promise<NotificationsCreateResult>;
-}
-export declare const Notifications: typeof ZiteNotifications;

package/dist/esm/notifications/index.js

@@ -1,8 +0,0 @@
-import { getSdkCall } from '../internal/sdkCall.js';
-const NOTIFICATIONS_SDK_INTEGRATION_ID = '__notifications__';
-export class ZiteNotifications {
-    static create(params) {
-        return getSdkCall()(NOTIFICATIONS_SDK_INTEGRATION_ID, 'ZiteNotifications', 'create', params);
-    }
-}
-export const Notifications = ZiteNotifications;