zitejs 0.9.142 → 0.9.143

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

@@ -43,9 +43,17 @@ declare const FIELDS_BY_TYPE: {
     granola: readonly string[];
     clickup: readonly string[];
     dropbox: readonly string[];
+    zendesk: readonly string[];
     amazonS3: readonly string[];
     snowflake: readonly string[];
     databricks: readonly string[];
+    confluence: readonly string[];
+    pipedrive: readonly string[];
+    shopify: readonly string[];
+    sharepoint: readonly string[];
+    excel: readonly string[];
+    x: readonly string[];
+    zoomMeetings: readonly string[];
     smartsuite: readonly string[];
 };
 /** A service type `integrations.get` serves: one used through its npm package with a token. */

package/dist/cjs/integrations/rules.js

@@ -52,6 +52,10 @@ const FIELDS_BY_TYPE = {
     granola: extras(),
     clickup: extras(),
     dropbox: extras(),
+    // Every path is https://{subdomain}.zendesk.com/api/v2/..., and a token is
+    // only valid on the account it was issued for, so the subdomain travels with
+    // it rather than being configured per app.
+    zendesk: extras("subdomain"),
     // The IAM key alone reaches nothing: every call needs the region and the
     // bucket, and S3-compatible providers need the endpoint too.
     amazonS3: extras("keyId", "region", "bucket", "endpoint", "pathPrefix"),
@@ -61,6 +65,20 @@ const FIELDS_BY_TYPE = {
     // A statement is addressed by workspace host and SQL warehouse, and the token
     // derives neither.
     databricks: extras("host", "warehouseId"),
+    // Cloud Confluence is addressed through api.atlassian.com by cloud id, the
+    // same as Jira; the site URL is only for links a human will click.
+    confluence: extras("cloudId", "siteUrl"),
+    // OAuth returns a per-company api_domain alongside the token, so there is no
+    // one host to call.
+    pipedrive: extras("apiBaseUrl"),
+    // Shopify has no global API host: every call goes to the store's own domain
+    // under a pinned API version. The storefront pair is the shopper-facing API,
+    // which installs predating those scopes do not have.
+    shopify: extras("shopDomain", "apiBaseUrl", "storefrontApiUrl", "storefrontAccessToken"),
+    sharepoint: extras(),
+    excel: extras(),
+    x: extras(),
+    zoomMeetings: extras(),
     // Every request names the workspace in an Account-Id header beside the key.
     smartsuite: extras("workspaceId"),
 };
@@ -75,6 +93,7 @@ exports.OPTIONAL_CREDENTIAL_FIELDS = {
     // Only S3-compatible providers set an endpoint, and a prefix is opt-in.
     amazonS3: ["endpoint", "pathPrefix"],
     snowflake: ["warehouse"],
+    shopify: ["storefrontApiUrl", "storefrontAccessToken"],
 };
 /**
  * Types the runtime never serves: those with a generated client (Airtable, email,

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

@@ -0,0 +1,14 @@
+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

@@ -0,0 +1,12 @@
+"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

@@ -0,0 +1,25 @@
+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

@@ -0,0 +1,12 @@
+"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/integrations/rules.d.ts

@@ -43,9 +43,17 @@ declare const FIELDS_BY_TYPE: {
     granola: readonly string[];
     clickup: readonly string[];
     dropbox: readonly string[];
+    zendesk: readonly string[];
     amazonS3: readonly string[];
     snowflake: readonly string[];
     databricks: readonly string[];
+    confluence: readonly string[];
+    pipedrive: readonly string[];
+    shopify: readonly string[];
+    sharepoint: readonly string[];
+    excel: readonly string[];
+    x: readonly string[];
+    zoomMeetings: readonly string[];
     smartsuite: readonly string[];
 };
 /** A service type `integrations.get` serves: one used through its npm package with a token. */

package/dist/esm/integrations/rules.js

@@ -49,6 +49,10 @@ const FIELDS_BY_TYPE = {
     granola: extras(),
     clickup: extras(),
     dropbox: extras(),
+    // Every path is https://{subdomain}.zendesk.com/api/v2/..., and a token is
+    // only valid on the account it was issued for, so the subdomain travels with
+    // it rather than being configured per app.
+    zendesk: extras("subdomain"),
     // The IAM key alone reaches nothing: every call needs the region and the
     // bucket, and S3-compatible providers need the endpoint too.
     amazonS3: extras("keyId", "region", "bucket", "endpoint", "pathPrefix"),
@@ -58,6 +62,20 @@ const FIELDS_BY_TYPE = {
     // A statement is addressed by workspace host and SQL warehouse, and the token
     // derives neither.
     databricks: extras("host", "warehouseId"),
+    // Cloud Confluence is addressed through api.atlassian.com by cloud id, the
+    // same as Jira; the site URL is only for links a human will click.
+    confluence: extras("cloudId", "siteUrl"),
+    // OAuth returns a per-company api_domain alongside the token, so there is no
+    // one host to call.
+    pipedrive: extras("apiBaseUrl"),
+    // Shopify has no global API host: every call goes to the store's own domain
+    // under a pinned API version. The storefront pair is the shopper-facing API,
+    // which installs predating those scopes do not have.
+    shopify: extras("shopDomain", "apiBaseUrl", "storefrontApiUrl", "storefrontAccessToken"),
+    sharepoint: extras(),
+    excel: extras(),
+    x: extras(),
+    zoomMeetings: extras(),
     // Every request names the workspace in an Account-Id header beside the key.
     smartsuite: extras("workspaceId"),
 };
@@ -72,6 +90,7 @@ export const OPTIONAL_CREDENTIAL_FIELDS = {
     // Only S3-compatible providers set an endpoint, and a prefix is opt-in.
     amazonS3: ["endpoint", "pathPrefix"],
     snowflake: ["warehouse"],
+    shopify: ["storefrontApiUrl", "storefrontAccessToken"],
 };
 /**
  * Types the runtime never serves: those with a generated client (Airtable, email,

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

@@ -0,0 +1,14 @@
+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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,25 @@
+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

@@ -0,0 +1,8 @@
+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;

package/package.json

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

package/dist/cjs/start/describeBuilt.d.ts

@@ -1,3 +0,0 @@
-/** Describes a built Start app from its `dist/server`: a Workers build in workerd, a Node build in-process. */
-export declare function describeBuiltApp(appDir: string): Promise<unknown>;
-export declare function runDescribe(): Promise<void>;

package/dist/cjs/start/describeBuilt.js

@@ -1,106 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.describeBuiltApp = describeBuiltApp;
-exports.runDescribe = runDescribe;
-const node_child_process_1 = require("node:child_process");
-const node_fs_1 = require("node:fs");
-const node_net_1 = require("node:net");
-const node_path_1 = __importDefault(require("node:path"));
-const node_url_1 = require("node:url");
-// Only the host can set x-zite-* in production: the front strips them from public traffic.
-const DESCRIBE_HEADERS = { "x-zite-invoke": "describe" };
-// Not "localhost": it can resolve to ::1 for vite's listen and to 127.0.0.1 for fetch.
-const HOST = "127.0.0.1";
-const freePort = () => new Promise((resolve, reject) => {
-    const server = (0, node_net_1.createServer)();
-    server.once("error", reject);
-    server.listen(0, HOST, () => {
-        const { port } = server.address();
-        server.close(() => resolve(port));
-    });
-});
-// A Workers build runs where it will run: workerd, through the app's own
-// `vite preview`, so it uses the same Cloudflare plugin and config as the build.
-async function describeInWorkerd(appDir) {
-    const port = await freePort();
-    // Its own process group, so stopping it also stops vite and workerd under npx.
-    const preview = (0, node_child_process_1.spawn)("npx", ["--no-install", "vite", "preview", "--host", HOST, "--port", String(port), "--strictPort"], {
-        cwd: appDir,
-        stdio: ["ignore", "ignore", "pipe"],
-        detached: true,
-    });
-    let stderr = "";
-    preview.stderr.on("data", (chunk) => (stderr += chunk));
-    try {
-        const deadline = Date.now() + 60_000;
-        while (true) {
-            try {
-                const response = await fetch(`http://${HOST}:${port}/`, { headers: DESCRIBE_HEADERS });
-                // Right after start, preview can answer before the Worker does; only the
-                // app's own describe answer is JSON.
-                if (response.ok && response.headers.get("content-type")?.includes("application/json")) {
-                    return await response.json();
-                }
-            }
-            catch { }
-            if (preview.exitCode !== null || Date.now() > deadline) {
-                throw new Error(`vite preview didn't serve the app: ${stderr.trim().slice(-500)}`);
-            }
-            await new Promise((resolve) => setTimeout(resolve, 250));
-        }
-    }
-    finally {
-        try {
-            process.kill(-preview.pid, "SIGTERM");
-        }
-        catch { }
-    }
-}
-/** Describes a built Start app from its `dist/server`: a Workers build in workerd, a Node build in-process. */
-async function describeBuiltApp(appDir) {
-    const serverDir = node_path_1.default.join(appDir, "dist/server");
-    if ((0, node_fs_1.existsSync)(node_path_1.default.join(serverDir, "wrangler.json")))
-        return describeInWorkerd(appDir);
-    const { default: server } = await Promise.resolve(`${(0, node_url_1.pathToFileURL)(node_path_1.default.join(serverDir, "server.js")).href}`).then(s => __importStar(require(s)));
-    return (await server.fetch(new Request("http://describe.local/", { headers: DESCRIBE_HEADERS }))).json();
-}
-async function runDescribe() {
-    const appDir = node_path_1.default.resolve(process.argv[3] ?? ".");
-    process.stdout.write(`${JSON.stringify(await describeBuiltApp(appDir), null, 2)}\n`);
-}

package/dist/cjs/start/entries.d.ts

@@ -1,20 +0,0 @@
-import type { SourceDir } from "../sourceRoots.js";
-export declare const START_SERVER_ENTRY = ".zite/server.ts";
-export declare const START_INSTANCE_ENTRY = ".zite/start.ts";
-export type StartTarget = "cloudflare" | "node";
-/**
- * The server entry every Start app builds with. Platform-owned: regenerated,
- * never edited. On Workers it's an entrypoint the host can also call over RPC.
- */
-export declare const renderStartServerEntry: (target?: StartTarget) => string;
-/** The start instance: the platform's middleware, then the app's own `src/start.ts` when it has one. */
-export declare const renderStartInstance: (hasAppStart: boolean) => string;
-export declare const hasAppStart: (appDir: string) => boolean;
-/** Writes `file` under `appDir` when its content differs. Returns whether it wrote. */
-export declare const writeIfChanged: (appDir: string, file: string, content: string) => boolean;
-export declare const isStartAppDir: (appPath: string) => boolean;
-export declare function regenerateStartEntries(app: SourceDir): void;
-/** App modules that mention createWorkflow: what the workflow registry imports. Describe decides what each one really exports. */
-export declare function workflowFiles(appDir: string): string[];
-/** The registry zite() builds in place of zitejs's empty one. */
-export declare const renderWorkflowModules: (appDir: string, files: string[]) => string;

package/dist/cjs/start/entries.js

@@ -1,104 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderWorkflowModules = exports.isStartAppDir = exports.writeIfChanged = exports.hasAppStart = exports.renderStartInstance = exports.renderStartServerEntry = exports.START_INSTANCE_ENTRY = exports.START_SERVER_ENTRY = void 0;
-exports.regenerateStartEntries = regenerateStartEntries;
-exports.workflowFiles = workflowFiles;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-exports.START_SERVER_ENTRY = ".zite/server.ts";
-exports.START_INSTANCE_ENTRY = ".zite/start.ts";
-const APP_START_FILES = ["src/start.ts", "src/start.tsx"];
-/**
- * The server entry every Start app builds with. Platform-owned: regenerated,
- * never edited. On Workers it's an entrypoint the host can also call over RPC.
- */
-const renderStartServerEntry = (target = "cloudflare") => target === "cloudflare"
-    ? `// Generated by zitejs for TanStack Start apps. The platform owns this file.
-import handler from '@tanstack/react-start/server-entry';
-import { createZiteWorker } from 'zitejs/start/worker';
-import { getRouter } from '../src/router';
-
-export default createZiteWorker({ handler, getRouter });
-`
-    : `// Generated by zitejs for TanStack Start apps. The platform owns this file.
-import handler, { createServerEntry } from '@tanstack/react-start/server-entry';
-import { createZiteFetch } from 'zitejs/start/server';
-import { getRouter } from '../src/router';
-
-export default createServerEntry({ fetch: createZiteFetch({ handler, getRouter }) });
-`;
-exports.renderStartServerEntry = renderStartServerEntry;
-/** The start instance: the platform's middleware, then the app's own `src/start.ts` when it has one. */
-const renderStartInstance = (hasAppStart) => hasAppStart
-    ? `// Generated by zitejs for TanStack Start apps. The platform owns this file.
-import { createZiteStart } from 'zitejs/start/instance';
-import { startInstance as app } from '../src/start';
-
-export const startInstance = createZiteStart(app);
-`
-    : `// Generated by zitejs for TanStack Start apps. The platform owns this file.
-import { createZiteStart } from 'zitejs/start/instance';
-
-export const startInstance = createZiteStart();
-`;
-exports.renderStartInstance = renderStartInstance;
-const hasAppStart = (appDir) => APP_START_FILES.some((file) => (0, node_fs_1.existsSync)((0, node_path_1.join)(appDir, file)));
-exports.hasAppStart = hasAppStart;
-/** Writes `file` under `appDir` when its content differs. Returns whether it wrote. */
-const writeIfChanged = (appDir, file, content) => {
-    const target = (0, node_path_1.join)(appDir, file);
-    if ((0, node_fs_1.existsSync)(target) && (0, node_fs_1.readFileSync)(target, "utf-8") === content)
-        return false;
-    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(target), { recursive: true });
-    (0, node_fs_1.writeFileSync)(target, content);
-    return true;
-};
-exports.writeIfChanged = writeIfChanged;
-const isStartAppDir = (appPath) => {
-    try {
-        return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(appPath, "zite.config.json"), "utf-8"))?.runtime === "start";
-    }
-    catch {
-        return false;
-    }
-};
-exports.isStartAppDir = isStartAppDir;
-const isStartApp = (app) => (0, exports.isStartAppDir)(app.path);
-function regenerateStartEntries(app) {
-    if (!isStartApp(app))
-        return;
-    const entries = [
-        [exports.START_SERVER_ENTRY, (0, exports.renderStartServerEntry)()],
-        [exports.START_INSTANCE_ENTRY, (0, exports.renderStartInstance)((0, exports.hasAppStart)(app.path))],
-    ];
-    for (const [file, content] of entries) {
-        if ((0, exports.writeIfChanged)(app.path, file, content))
-            console.log(`Wrote ${(0, node_path_1.join)(app.path, file)}`);
-    }
-}
-const SOURCE_FILE = /\.[mc]?[jt]sx?$/;
-const NOT_APP_CODE = /(\.(test|spec)\.[^.]+|\.d\.ts|routeTree\.gen\.ts)$/;
-/** App modules that mention createWorkflow: what the workflow registry imports. Describe decides what each one really exports. */
-function workflowFiles(appDir) {
-    const found = [];
-    const walk = (dir) => {
-        for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
-            const full = (0, node_path_1.join)(dir, entry.name);
-            if (entry.isDirectory()) {
-                if (entry.name !== "node_modules")
-                    walk(full);
-            }
-            else if (SOURCE_FILE.test(entry.name) && !NOT_APP_CODE.test(entry.name) && (0, node_fs_1.readFileSync)(full, "utf-8").includes("createWorkflow")) {
-                found.push((0, node_path_1.relative)(appDir, full).split("\\").join("/"));
-            }
-        }
-    };
-    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(appDir, "src")))
-        walk((0, node_path_1.join)(appDir, "src"));
-    return found.sort();
-}
-/** The registry zite() builds in place of zitejs's empty one. */
-const renderWorkflowModules = (appDir, files) => `export const workflowModules = {\n${files
-    .map((file) => `  ${JSON.stringify(file)}: () => import(${JSON.stringify((0, node_path_1.join)(appDir, file))}),`)
-    .join("\n")}\n};\n`;
-exports.renderWorkflowModules = renderWorkflowModules;

package/dist/cjs/start/problems.d.ts

@@ -1,19 +0,0 @@
-type WithProblems = {
-    problems: string[];
-};
-type Described = {
-    functions: Array<WithProblems & {
-        id: string;
-        file?: string;
-    }>;
-    routes: Array<WithProblems & {
-        path: string;
-    }>;
-    workflows?: Array<WithProblems & {
-        id: string;
-        file: string;
-    }>;
-};
-/** Every problem in a description, one line each, named by its rule. Any of them fails the build. */
-export declare function descriptionProblems(description: Described): string[];
-export {};

package/dist/cjs/start/problems.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.descriptionProblems = descriptionProblems;
-/** Every problem in a description, one line each, named by its rule. Any of them fails the build. */
-function descriptionProblems(description) {
-    return [
-        ...description.functions.flatMap((f) => f.problems.map((p) => `function ${f.id}${f.file ? ` (${f.file})` : ""}: ${p}`)),
-        ...description.routes.flatMap((r) => r.problems.map((p) => `route ${r.path}: ${p}`)),
-        ...(description.workflows ?? []).flatMap((w) => w.problems.map((p) => `workflow ${w.id} (${w.file}): ${p}`)),
-    ];
-}

package/dist/esm/start/describe.d.ts

@@ -1,64 +0,0 @@
-import type { ZiteTrigger } from "../backend/index.js";
-import type { LoadedWorkflow } from "./workflowRun.js";
-import type { WorkflowConfig } from "./workflow.js";
-export type Access = {
-    kind: "signedIn" | "anyone" | "webhook" | "none";
-    roles: string[];
-    paused?: true;
-};
-export type DescribedFunction = {
-    id: string;
-    name?: string;
-    file?: string;
-    method?: string;
-    /** From the factory's `description` option; display-only. */
-    description?: string;
-    access: Access;
-    input?: unknown;
-    problems: string[];
-};
-export type DescribedRoute = {
-    path: string;
-    methods: Record<string, Access>;
-    problems: string[];
-};
-export type DescribedWorkflow = {
-    id: string;
-    file: string;
-    description?: string;
-    schedule?: WorkflowConfig["schedule"];
-    /** As declared, without a provider trigger's `subscribe` and `unsubscribe`. */
-    trigger?: ZiteTrigger;
-    /** A provider trigger's: whether it can be taken down, and a hash of both functions' code, so publish registers it again when they change. */
-    registration?: {
-        unsubscribe: boolean;
-        hash: string;
-    };
-    problems: string[];
-};
-export type Description = {
-    functions: DescribedFunction[];
-    routes: DescribedRoute[];
-    workflows: DescribedWorkflow[];
-};
-export declare function describeFunction(id: string, request: Request): Promise<DescribedFunction>;
-type RouteLike = {
-    fullPath: string;
-    parentRoute?: RouteLike;
-    options?: {
-        server?: {
-            middleware?: unknown[];
-            handlers?: unknown;
-        };
-    };
-};
-export declare function describeRoutes(routesById: Record<string, RouteLike>): DescribedRoute[];
-export declare function describeWorkflows(workflows: LoadedWorkflow[]): DescribedWorkflow[];
-export declare function describeApp(opts: {
-    fnIds: string[];
-    descriptions?: Record<string, string>;
-    getRouter: () => unknown;
-    request: Request;
-    workflows?: LoadedWorkflow[];
-}): Promise<Description>;
-export {};