zitejs 0.9.121 → 0.9.123

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.
  *

package/dist/cjs/bundle/index.js

@@ -39,7 +39,7 @@ 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.
  *
@@ -334,7 +334,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 +345,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 +380,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 +399,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 +635,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.js

@@ -194,7 +194,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/sourceRoots.d.ts

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

package/dist/cjs/sourceRoots.js

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

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

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

package/dist/cjs/sourceRoots.test.js

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

package/dist/cjs/sync/lib.js

@@ -1230,10 +1230,10 @@ 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, ZiteWebhook } from 'zitejs/backend/base';",
+        "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStreamInterface, ZiteTrigger, ZiteWebhook } from 'zitejs/backend/base';",
         "import type { User } from 'zitejs/auth';",
         "",
-        "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStreamInterface, ZiteWebhook };",
+        "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStreamInterface, ZiteTrigger, ZiteWebhook };",
         // 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;",
@@ -1308,7 +1308,7 @@ function generateBackendWrapperTs(envVarNames = []) {
         // TStream mirrors zitejs/backend/base. Without it `stream: true` endpoints
         // get no `stream` argument here — and this wrapper, not the base module, is
         // what `zitejs/backend` resolves to in every app.
-        "export interface EndpointConfig<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput> {",
+        "export interface EndpointConfig<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput, TTrigger extends ZiteTrigger | undefined = undefined> {",
         "  description?: string;",
         "  inputSchema?: SchemaLike<TInput, TRawInput>;",
         // Apps compile against this copy, not the base module's.
@@ -1320,17 +1320,19 @@ 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. */",
+        "  trigger?: TTrigger;",
         "  execute: (",
         "    params: {",
         "      input: TInput;",
-        "      context: TSchedule extends ZiteSchedule ? ZiteRequestContext | ZiteScheduledContext : TWebhook extends ZiteWebhook ? ZiteRequestContext | ZiteScheduledContext : ZiteRequestContext;",
+        "      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;",
         "}",
         "",
-        "export function createEndpoint<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput>(",
-        "  config: EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput>,",
-        "): EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput> {",
+        "export function createEndpoint<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput, TTrigger extends ZiteTrigger | undefined = undefined>(",
+        "  config: EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput, TTrigger>,",
+        "): EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput, TTrigger> {",
         "  return config;",
         "}",
         "",

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

@@ -381,6 +381,11 @@ const duplicateIdentifierErrorsIn = (source) => {
     (0, vitest_1.it)('exports createEndpoint', () => {
         (0, vitest_1.expect)(output).toContain('createEndpoint');
     });
+    (0, vitest_1.it)('types the trigger field like schedule and webhook', () => {
+        (0, vitest_1.expect)(output).toContain('trigger?: TTrigger;');
+        (0, vitest_1.expect)(output).toContain('TTrigger extends ZiteTrigger | undefined = undefined');
+        (0, vitest_1.expect)(output).toContain('ZiteTrigger, ZiteWebhook }');
+    });
     (0, vitest_1.it)('exports ZiteError', () => {
         (0, vitest_1.expect)(output).toContain('ZiteError');
     });

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

@@ -2,7 +2,7 @@
  * `npx zitejs bundle` — Bundle endpoint files for cloudflare-lambda deployment.
  *
  * Replaces the legacy `scripts/bundle-endpoints.js` from zitejs-starter.
- * Reads endpoints from src/api/*.ts, resolves SDK imports via .zite/backend.ts
+ * Reads an app's src/api/*.ts endpoints (an automation's single src/workflow.ts), resolves SDK imports via .zite/backend.ts
  * (monorepo) or src/__zite__/integrations.ts (legacy), and outputs bundled ESM
  * code suitable for the cloudflare-lambda worker runtime.
  *

package/dist/esm/bundle/index.js

@@ -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.
  *
@@ -24,7 +24,7 @@ import * as path from 'path';
 import * as fs from 'fs';
 import { parse } from '@babel/parser';
 import { builtinModules } from 'node:module';
-import { findSourceDir } from '../sourceRoots.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,
 // esbuild fails the one endpoint with a resolvable error instead. Pinned by
@@ -297,7 +297,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';
@@ -308,14 +308,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;
 `;
     }
@@ -343,11 +343,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 });
@@ -362,14 +362,20 @@ async function bundleEndpointsImpl(baseDir, endpointNames) {
     }
     catch { }
     for (const name of endpointNames) {
+        if (root === 'automations' && name !== AUTOMATION_ENDPOINT_NAME) {
+            endpointErrors[name] =
+                `An automation is one workflow, src/workflow.ts, bundled as "${AUTOMATION_ENDPOINT_NAME}"; there is no endpoint "${name}"`;
+            continue;
+        }
+        const entryFile = 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({
                 ...BASE_BUILD_OPTIONS,
@@ -592,18 +598,13 @@ export async function runBundle() {
     // as missing.
     const explicitNames = args.filter((a, i) => !a.startsWith('--') && !(appFlag !== -1 && i === appFlag + 1));
     let endpointNames;
+    const root = 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 = 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/esm/check/index.js

@@ -1,7 +1,7 @@
 import { execFileSync } from 'child_process';
 import { existsSync } from 'fs';
 import { join } from 'path';
-import { listSourceDirs } from '../sourceRoots.js';
+import { listEndpointNames, listSourceDirs } from '../sourceRoots.js';
 /**
  * An argument array, not a command string, so no shell is involved.
  *
@@ -62,7 +62,7 @@ export 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
@@ -89,7 +89,7 @@ export 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 (existsSync(join(appPath, 'src', 'api'))) {
+        if (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/esm/cli.js

@@ -40,7 +40,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/esm/dev/index.js

@@ -190,7 +190,7 @@ export 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 (existsSync("zite.schema.json")) {

package/dist/esm/sourceRoots.d.ts

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

package/dist/esm/sourceRoots.js

@@ -1,5 +1,5 @@
 import { existsSync, readdirSync } from "fs";
-import { join } from "path";
+import { basename, dirname, join, resolve } from "path";
 /**
  * The repo-root directories a project's own source lives under: `apps/` for
  * apps and `automations/` for automations (endpoints with no frontend). The
@@ -26,3 +26,37 @@ export function listSourceDirs(cwd = ".") {
 export function findSourceDir(name, cwd = ".") {
     return listSourceDirs(cwd).find((d) => d.dir === name);
 }
+/**
+ * An automation is one workflow: its single endpoint is `src/workflow.ts` and
+ * its name is fixed, so nothing about an automation is keyed on a file name
+ * the way an app's `src/api/<name>.ts` endpoints are.
+ */
+export const AUTOMATION_ENDPOINT_NAME = "workflow";
+export const AUTOMATION_WORKFLOW_FILE = "src/workflow.ts";
+/** The root a source dir sits under, read from its parent directory. */
+export function sourceRootOf(sourceDirPath) {
+    const parent = basename(dirname(resolve(sourceDirPath)));
+    return SOURCE_ROOTS.includes(parent)
+        ? parent
+        : undefined;
+}
+/** An endpoint's entry file, relative to the source dir. */
+export function endpointEntryFile(root, name) {
+    return root === "automations"
+        ? AUTOMATION_WORKFLOW_FILE
+        : join("src", "api", `${name}.ts`);
+}
+/** Every endpoint name a source dir has on disk. */
+export function listEndpointNames(root, sourceDirPath) {
+    if (root === "automations") {
+        return existsSync(join(sourceDirPath, AUTOMATION_WORKFLOW_FILE))
+            ? [AUTOMATION_ENDPOINT_NAME]
+            : [];
+    }
+    const apiDir = join(sourceDirPath, "src", "api");
+    return existsSync(apiDir)
+        ? readdirSync(apiDir)
+            .filter((f) => f.endsWith(".ts") && !f.endsWith(".d.ts"))
+            .map((f) => f.replace(/\.ts$/, ""))
+        : [];
+}

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

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

package/dist/esm/sourceRoots.test.js

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

package/dist/esm/sync/lib.js

@@ -1216,10 +1216,10 @@ 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, ZiteWebhook } from 'zitejs/backend/base';",
+        "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStreamInterface, ZiteTrigger, ZiteWebhook } from 'zitejs/backend/base';",
         "import type { User } from 'zitejs/auth';",
         "",
-        "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStreamInterface, ZiteWebhook };",
+        "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStreamInterface, ZiteTrigger, ZiteWebhook };",
         // 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;",
@@ -1294,7 +1294,7 @@ export function generateBackendWrapperTs(envVarNames = []) {
         // TStream mirrors zitejs/backend/base. Without it `stream: true` endpoints
         // get no `stream` argument here — and this wrapper, not the base module, is
         // what `zitejs/backend` resolves to in every app.
-        "export interface EndpointConfig<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput> {",
+        "export interface EndpointConfig<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput, TTrigger extends ZiteTrigger | undefined = undefined> {",
         "  description?: string;",
         "  inputSchema?: SchemaLike<TInput, TRawInput>;",
         // Apps compile against this copy, not the base module's.
@@ -1306,17 +1306,19 @@ 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. */",
+        "  trigger?: TTrigger;",
         "  execute: (",
         "    params: {",
         "      input: TInput;",
-        "      context: TSchedule extends ZiteSchedule ? ZiteRequestContext | ZiteScheduledContext : TWebhook extends ZiteWebhook ? ZiteRequestContext | ZiteScheduledContext : ZiteRequestContext;",
+        "      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;",
         "}",
         "",
-        "export function createEndpoint<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput>(",
-        "  config: EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput>,",
-        "): EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput> {",
+        "export function createEndpoint<TInput = unknown, TOutput = unknown, TStream extends boolean = false, TSchedule extends ZiteSchedule | undefined = undefined, TWebhook extends ZiteWebhook | undefined = undefined, TRawInput = TInput, TTrigger extends ZiteTrigger | undefined = undefined>(",
+        "  config: EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput, TTrigger>,",
+        "): EndpointConfig<TInput, TOutput, TStream, TSchedule, TWebhook, TRawInput, TTrigger> {",
         "  return config;",
         "}",
         "",

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

@@ -376,6 +376,11 @@ describe('generateBackendWrapperTs', () => {
     it('exports createEndpoint', () => {
         expect(output).toContain('createEndpoint');
     });
+    it('types the trigger field like schedule and webhook', () => {
+        expect(output).toContain('trigger?: TTrigger;');
+        expect(output).toContain('TTrigger extends ZiteTrigger | undefined = undefined');
+        expect(output).toContain('ZiteTrigger, ZiteWebhook }');
+    });
     it('exports ZiteError', () => {
         expect(output).toContain('ZiteError');
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zitejs",
-  "version": "0.9.121",
+  "version": "0.9.123",
   "description": "The Zite framework — build apps on Zite Database",
   "type": "module",
   "main": "./dist/cjs/index.js",