@forumone/throughline 0.0.0-stage → 1.0.0-next.0

package/dist/env/index.d.ts

@@ -0,0 +1,54 @@
+import type { EnvRequirement } from '../plugin-contract/index.js';
+/** What is wrong with one value. `undefined` from `checkEnvValue` means nothing. */
+export type EnvValueProblem = {
+    kind: 'missing';
+} | {
+    kind: 'too-short';
+    length: number;
+    minLength: number;
+};
+/**
+ * Checks one value against one requirement, without saying where the value
+ * came from. A plugin calls it on `options.x ?? process.env[requirement.name]`
+ * and words the error its own way; `assertEnvironment` calls it on the
+ * environment alone.
+ *
+ * Empty and whitespace-only count as missing. The length is the value's own,
+ * untrimmed, which is what the code that uses it will see.
+ */
+export declare function checkEnvValue(requirement: EnvRequirement, value: string | undefined): EnvValueProblem | undefined;
+/**
+ * Anything `assertEnvironment` accepts: a requirement, a plugin's list of
+ * them, or a function that throws when something is wrong — for a rule that is
+ * not "this name, this long", such as a database URL that may arrive under any
+ * of several names. The thrown message becomes the problem's line, so it must
+ * not contain the value either.
+ */
+export type EnvironmentCheck = EnvRequirement | readonly EnvRequirement[] | (() => unknown);
+/** The error `assertEnvironment` throws. `problems` holds one line per problem. */
+export declare class EnvironmentError extends Error {
+    readonly problems: readonly string[];
+    constructor(problems: readonly string[]);
+}
+/**
+ * Checks every requirement against `process.env` and throws one
+ * {@link EnvironmentError} listing every missing or too-short value, each with
+ * its `why`. Values are never printed — a too-short one is reported by length.
+ *
+ * Call it first in `payload.config.ts`, at module scope, with every plugin's
+ * list and the site's own variables:
+ *
+ * ```ts
+ * assertEnvironment(
+ *   approvalsEnv,
+ *   emailEnv,
+ *   formsEnv,
+ *   { name: 'PAYLOAD_SECRET', minLength: 32, why: 'Signs Payload sessions.' },
+ *   () => databaseConnectionString(),
+ * )
+ * ```
+ *
+ * A name listed twice is reported once, against the strictest `minLength`.
+ */
+export declare function assertEnvironment(...checks: readonly EnvironmentCheck[]): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAoBjE,oFAAoF;AACpF,MAAM,MAAM,eAAe,GACzB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,cAAc,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,eAAe,GAAG,SAAS,CAO7B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,SAAS,cAAc,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,CAAA;AAE3F,mFAAmF;AACnF,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;gBAExB,QAAQ,EAAE,SAAS,MAAM,EAAE;CAkBxC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CA2C9E"}

package/dist/env/index.js

@@ -0,0 +1,113 @@
+/**
+ * Checks one value against one requirement, without saying where the value
+ * came from. A plugin calls it on `options.x ?? process.env[requirement.name]`
+ * and words the error its own way; `assertEnvironment` calls it on the
+ * environment alone.
+ *
+ * Empty and whitespace-only count as missing. The length is the value's own,
+ * untrimmed, which is what the code that uses it will see.
+ */
+export function checkEnvValue(requirement, value) {
+    if (value === undefined || value.trim() === '')
+        return { kind: 'missing' };
+    const { minLength } = requirement;
+    if (minLength !== undefined && value.length < minLength) {
+        return { kind: 'too-short', length: value.length, minLength };
+    }
+    return undefined;
+}
+/** The error `assertEnvironment` throws. `problems` holds one line per problem. */
+export class EnvironmentError extends Error {
+    problems;
+    constructor(problems) {
+        const count = problems.length;
+        super([
+            `Configuration problem: ${count} environment variable${count === 1 ? '' : 's'} ` +
+                `${count === 1 ? 'is' : 'are'} missing or invalid. This is not a code or build ` +
+                `failure; nothing will start until ${count === 1 ? 'it is' : 'they are'} set.`,
+            '',
+            ...problems.map((line) => `  - ${line}`),
+            '',
+            "Set each in the environment this process runs in (.env locally, your host's " +
+                'settings when deployed). One that is set and still listed is not reaching the ' +
+                'process: a turbo task passes only the variables its turbo.json `env` declares.',
+        ].join('\n'));
+        this.name = 'EnvironmentError';
+        this.problems = problems;
+    }
+}
+/**
+ * Checks every requirement against `process.env` and throws one
+ * {@link EnvironmentError} listing every missing or too-short value, each with
+ * its `why`. Values are never printed — a too-short one is reported by length.
+ *
+ * Call it first in `payload.config.ts`, at module scope, with every plugin's
+ * list and the site's own variables:
+ *
+ * ```ts
+ * assertEnvironment(
+ *   approvalsEnv,
+ *   emailEnv,
+ *   formsEnv,
+ *   { name: 'PAYLOAD_SECRET', minLength: 32, why: 'Signs Payload sessions.' },
+ *   () => databaseConnectionString(),
+ * )
+ * ```
+ *
+ * A name listed twice is reported once, against the strictest `minLength`.
+ */
+export function assertEnvironment(...checks) {
+    const requirements = new Map();
+    const problems = [];
+    for (const check of checks) {
+        if (typeof check === 'function') {
+            try {
+                check();
+            }
+            catch (error) {
+                problems.push(error instanceof Error ? error.message : String(error));
+            }
+            continue;
+        }
+        for (const requirement of isList(check) ? check : [check]) {
+            const seen = requirements.get(requirement.name);
+            if (!seen) {
+                requirements.set(requirement.name, {
+                    ...(requirement.minLength !== undefined ? { minLength: requirement.minLength } : {}),
+                    whys: [requirement.why],
+                });
+                continue;
+            }
+            if (requirement.minLength !== undefined) {
+                seen.minLength = Math.max(seen.minLength ?? 0, requirement.minLength);
+            }
+            if (!seen.whys.includes(requirement.why))
+                seen.whys.push(requirement.why);
+        }
+    }
+    // Requirements first, in the order given; then the free-form checks.
+    const lines = [];
+    for (const [name, { minLength, whys }] of requirements) {
+        const requirement = {
+            name,
+            why: whys.join(' '),
+            ...(minLength !== undefined ? { minLength } : {}),
+        };
+        const problem = checkEnvValue(requirement, process.env[name]);
+        if (problem)
+            lines.push(describe(requirement, problem));
+    }
+    lines.push(...problems);
+    if (lines.length > 0)
+        throw new EnvironmentError(lines);
+}
+function isList(check) {
+    return Array.isArray(check);
+}
+function describe(requirement, problem) {
+    const what = problem.kind === 'missing'
+        ? `${requirement.name} is not set.`
+        : `${requirement.name} is ${problem.length} characters; the minimum is ${problem.minLength}.`;
+    return `${what} ${requirement.why}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"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"}

package/dist/events/inngest.d.ts

@@ -0,0 +1,24 @@
+import { Inngest } from 'inngest';
+export interface InngestClientOptions {
+    /** App identifier used in Inngest's UI; should be stable across deployments. */
+    id: string;
+    /** Inngest event key. Falls back to `process.env.INNGEST_EVENT_KEY`. */
+    eventKey?: string;
+    /** Base URL for self-hosted Inngest deployments. */
+    baseUrl?: string;
+    /** Override the environment ("development", "preview", "production", or a branch name). */
+    env?: string;
+    /** Force development mode regardless of environment. */
+    isDev?: boolean;
+}
+/**
+ * Creates an Inngest client preconfigured for Throughline. Plugins and the
+ * audit writer accept this client to fire events; client apps construct it
+ * once at module load and pass it everywhere.
+ *
+ * The signing key (used to verify incoming Inngest webhook calls) is read
+ * from `INNGEST_SIGNING_KEY` by the framework's serve handler — it is not
+ * a constructor option in Inngest 4.
+ */
+export declare function createInngestClient(options: InngestClientOptions): Inngest;
+//# sourceMappingURL=inngest.d.ts.map

package/dist/events/inngest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inngest.d.ts","sourceRoot":"","sources":["../../src/events/inngest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAA;IACV,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2FAA2F;IAC3F,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAQ1E"}

package/dist/events/inngest.js

@@ -0,0 +1,24 @@
+import { Inngest } from 'inngest';
+/**
+ * Creates an Inngest client preconfigured for Throughline. Plugins and the
+ * audit writer accept this client to fire events; client apps construct it
+ * once at module load and pass it everywhere.
+ *
+ * The signing key (used to verify incoming Inngest webhook calls) is read
+ * from `INNGEST_SIGNING_KEY` by the framework's serve handler — it is not
+ * a constructor option in Inngest 4.
+ */
+export function createInngestClient(options) {
+    const eventKey = options.eventKey ?? process.env['INNGEST_EVENT_KEY'];
+    const clientOptions = { id: options.id };
+    if (eventKey !== undefined)
+        clientOptions.eventKey = eventKey;
+    if (options.baseUrl !== undefined)
+        clientOptions.baseUrl = options.baseUrl;
+    if (options.env !== undefined)
+        clientOptions.env = options.env;
+    if (options.isDev !== undefined)
+        clientOptions.isDev = options.isDev;
+    return new Inngest(clientOptions);
+}
+//# sourceMappingURL=inngest.js.map

package/dist/events/inngest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inngest.js","sourceRoot":"","sources":["../../src/events/inngest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAejC;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IACrE,MAAM,aAAa,GAA6C,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAA;IAClF,IAAI,QAAQ,KAAK,SAAS;QAAE,aAAa,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC7D,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAC1E,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,aAAa,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;IAC9D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,aAAa,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IACpE,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;AACnC,CAAC"}

package/dist/events/taxonomy.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Canonical event taxonomy for Throughline. Server packages add their own
+ * events via TypeScript module augmentation — see {@link FrameworkEvents}.
+ *
+ * The runtime client (created by `createInngestClient`) does not enforce
+ * this taxonomy at type-check time; the interface is for documentation and
+ * for callers who want to type-check their own `inngest.send(...)` calls.
+ */
+export interface CoreEvents {
+    /** Fired by the audit writer after every audit-log entry is persisted. */
+    'audit/event.recorded': {
+        data: {
+            auditEventId: string;
+            action: string;
+            actorId?: string;
+            targetCollection?: string;
+            targetId?: string;
+            approvalRequestId?: string;
+            integrationId?: string;
+        };
+    };
+    /** Fired by the publishing server when a page is published. */
+    'content/page.published': {
+        data: {
+            collection: string;
+            id: string;
+            slug: string;
+            publishedBy: string;
+            previousPublishedAt: string | null;
+            isFirstPublish: boolean;
+        };
+    };
+    /** Fired when a page is unpublished or reverted to draft. */
+    'content/page.unpublished': {
+        data: {
+            collection: string;
+            id: string;
+            slug: string;
+            unpublishedBy: string;
+        };
+    };
+    /** Fired when a publish is scheduled for a future time. */
+    'content/page.scheduled': {
+        data: {
+            collection: string;
+            id: string;
+            scheduledFor: string;
+        };
+    };
+    /** Fired when a page is rolled back to a previous version. */
+    'content/page.rolled_back': {
+        data: {
+            collection: string;
+            id: string;
+            rolledBackBy: string;
+            toVersionId: string;
+        };
+    };
+    /** Periodic system healthcheck event. */
+    'system/healthcheck': {
+        data: {
+            source: string;
+            timestamp: string;
+        };
+    };
+}
+/**
+ * Framework-wide event taxonomy. Server packages extend this interface via
+ * TypeScript module augmentation:
+ *
+ * ```ts
+ * declare module '@forumone/throughline/jobs' {
+ *   interface FrameworkEvents {
+ *     'approval/decided': { data: { approvalId: string; decision: 'granted' | 'declined' } }
+ *   }
+ * }
+ * ```
+ *
+ * After augmentation, callers in any package can `inngest.send({ name: 'approval/decided', data: ... })`
+ * and TypeScript will type-check the payload against the merged set.
+ */
+export interface FrameworkEvents extends CoreEvents {
+}
+//# sourceMappingURL=taxonomy.d.ts.map

package/dist/events/taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.d.ts","sourceRoot":"","sources":["../../src/events/taxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,sBAAsB,EAAE;QACtB,IAAI,EAAE;YACJ,YAAY,EAAE,MAAM,CAAA;YACpB,MAAM,EAAE,MAAM,CAAA;YACd,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,gBAAgB,CAAC,EAAE,MAAM,CAAA;YACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;YACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;YAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;SACvB,CAAA;KACF,CAAA;IACD,+DAA+D;IAC/D,wBAAwB,EAAE;QACxB,IAAI,EAAE;YACJ,UAAU,EAAE,MAAM,CAAA;YAClB,EAAE,EAAE,MAAM,CAAA;YACV,IAAI,EAAE,MAAM,CAAA;YACZ,WAAW,EAAE,MAAM,CAAA;YACnB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;YAClC,cAAc,EAAE,OAAO,CAAA;SACxB,CAAA;KACF,CAAA;IACD,6DAA6D;IAC7D,0BAA0B,EAAE;QAC1B,IAAI,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAAA;KAC9E,CAAA;IACD,2DAA2D;IAC3D,wBAAwB,EAAE;QACxB,IAAI,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAA;KAC/D,CAAA;IACD,8DAA8D;IAC9D,0BAA0B,EAAE;QAC1B,IAAI,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAA;KACpF,CAAA;IACD,yCAAyC;IACzC,oBAAoB,EAAE;QACpB,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAC5C,CAAA;CACF;AAED;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,eAAgB,SAAQ,UAAU;CAAG"}

package/dist/events/taxonomy.js

@@ -0,0 +1,10 @@
+/**
+ * Canonical event taxonomy for Throughline. Server packages add their own
+ * events via TypeScript module augmentation — see {@link FrameworkEvents}.
+ *
+ * The runtime client (created by `createInngestClient`) does not enforce
+ * this taxonomy at type-check time; the interface is for documentation and
+ * for callers who want to type-check their own `inngest.send(...)` calls.
+ */
+export {};
+//# sourceMappingURL=taxonomy.js.map

package/dist/events/taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy.js","sourceRoot":"","sources":["../../src/events/taxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/events/vercel.d.ts

@@ -0,0 +1,47 @@
+import type { InngestFunction } from 'inngest';
+type Env = Readonly<Record<string, string | undefined>>;
+/**
+ * The Inngest environment for this deployment, for `createInngestClient`'s
+ * `env`: `production` on Vercel production, `preview` for every Vercel preview,
+ * and `undefined` everywhere else.
+ *
+ * - **An explicit `INNGEST_ENV` wins.** This returns `undefined`, and the SDK
+ *   reads the variable itself. An empty one counts as unset, because Vercel
+ *   stores an unset variable as an empty string.
+ * - **`NODE_ENV` gates the whole thing.** `vercel env pull` writes a
+ *   `.env.local` that carries `VERCEL_ENV="preview"`, so a laptop would
+ *   otherwise sync into the environment every preview shares. `next dev` is
+ *   still `NODE_ENV=development`.
+ * - **Anything else**, Vercel's `development` included, returns `undefined`
+ *   and leaves the SDK to its own discovery.
+ *
+ * @example
+ * ```ts
+ * const env = resolveInngestEnv()
+ * export const inngest = createInngestClient({ id: 'my-site', ...(env ? { env } : {}) })
+ * ```
+ */
+export declare function resolveInngestEnv(env?: Env): string | undefined;
+/**
+ * Whether this deployment should register cron-triggered functions: everywhere
+ * except a Vercel preview.
+ *
+ * A preview is a branch somebody is reviewing, and every cron a site has exists
+ * to keep a published site current. What a preview loses is each a thing done
+ * on demand rather than a thing that stops quietly: an integration's manual
+ * sync is an event, and stays.
+ */
+export declare function registersInngestCrons(env?: Env): boolean;
+/**
+ * The functions to hand `serve()`, without the cron-only ones where
+ * `registersInngestCrons` says no.
+ *
+ * Cron-*only*: a function triggered by a cron and an event keeps its event in
+ * a preview, since dropping it would take a manual sync with it, silently. It
+ * filters built functions by their public `opts.triggers`, so it covers jobs
+ * from `inngestJobs` and hand-written `createFunction`s alike, with no second
+ * list of ids to keep in step.
+ */
+export declare function registrableInngestFunctions<T extends InngestFunction.Any>(functions: readonly T[], env?: Env): T[];
+export {};
+//# sourceMappingURL=vercel.d.ts.map

package/dist/events/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../src/events/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAyB9C,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,GAAiB,GAAG,MAAM,GAAG,SAAS,CAY5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,GAAiB,GAAG,OAAO,CAErE;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,eAAe,CAAC,GAAG,EACvE,SAAS,EAAE,SAAS,CAAC,EAAE,EACvB,GAAG,GAAE,GAAiB,GACrB,CAAC,EAAE,CAYL"}

package/dist/events/vercel.js

@@ -0,0 +1,69 @@
+/**
+ * The Inngest environment for this deployment, for `createInngestClient`'s
+ * `env`: `production` on Vercel production, `preview` for every Vercel preview,
+ * and `undefined` everywhere else.
+ *
+ * - **An explicit `INNGEST_ENV` wins.** This returns `undefined`, and the SDK
+ *   reads the variable itself. An empty one counts as unset, because Vercel
+ *   stores an unset variable as an empty string.
+ * - **`NODE_ENV` gates the whole thing.** `vercel env pull` writes a
+ *   `.env.local` that carries `VERCEL_ENV="preview"`, so a laptop would
+ *   otherwise sync into the environment every preview shares. `next dev` is
+ *   still `NODE_ENV=development`.
+ * - **Anything else**, Vercel's `development` included, returns `undefined`
+ *   and leaves the SDK to its own discovery.
+ *
+ * @example
+ * ```ts
+ * const env = resolveInngestEnv()
+ * export const inngest = createInngestClient({ id: 'my-site', ...(env ? { env } : {}) })
+ * ```
+ */
+export function resolveInngestEnv(env = process.env) {
+    if (env['INNGEST_ENV'])
+        return undefined;
+    if (env['NODE_ENV'] !== 'production')
+        return undefined;
+    switch (env['VERCEL_ENV']) {
+        case 'production':
+            return 'production';
+        case 'preview':
+            return 'preview';
+        default:
+            return undefined;
+    }
+}
+/**
+ * Whether this deployment should register cron-triggered functions: everywhere
+ * except a Vercel preview.
+ *
+ * A preview is a branch somebody is reviewing, and every cron a site has exists
+ * to keep a published site current. What a preview loses is each a thing done
+ * on demand rather than a thing that stops quietly: an integration's manual
+ * sync is an event, and stays.
+ */
+export function registersInngestCrons(env = process.env) {
+    return resolveInngestEnv(env) !== 'preview';
+}
+/**
+ * The functions to hand `serve()`, without the cron-only ones where
+ * `registersInngestCrons` says no.
+ *
+ * Cron-*only*: a function triggered by a cron and an event keeps its event in
+ * a preview, since dropping it would take a manual sync with it, silently. It
+ * filters built functions by their public `opts.triggers`, so it covers jobs
+ * from `inngestJobs` and hand-written `createFunction`s alike, with no second
+ * list of ids to keep in step.
+ */
+export function registrableInngestFunctions(functions, env = process.env) {
+    if (registersInngestCrons(env))
+        return [...functions];
+    const isCron = (trigger) => typeof trigger === 'object' && trigger !== null && 'cron' in trigger;
+    return functions.filter((fn) => {
+        // Through `unknown`: `opts` on `InngestFunction.Any` widens to `any`.
+        const { triggers } = fn.opts;
+        // `length > 0`, because `every` on an empty array is true.
+        return !(triggers !== undefined && triggers.length > 0 && triggers.every(isCron));
+    });
+}
+//# sourceMappingURL=vercel.js.map

package/dist/events/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.js","sourceRoot":"","sources":["../../src/events/vercel.ts"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAW,OAAO,CAAC,GAAG;IACtD,IAAI,GAAG,CAAC,aAAa,CAAC;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY;QAAE,OAAO,SAAS,CAAA;IAEtD,QAAQ,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1B,KAAK,YAAY;YACf,OAAO,YAAY,CAAA;QACrB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAA;QAClB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAW,OAAO,CAAC,GAAG;IAC1D,OAAO,iBAAiB,CAAC,GAAG,CAAC,KAAK,SAAS,CAAA;AAC7C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAAuB,EACvB,MAAW,OAAO,CAAC,GAAG;IAEtB,IAAI,qBAAqB,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAA;IAErD,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAW,EAAE,CAC3C,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,CAAA;IAEtE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QAC7B,sEAAsE;QACtE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAoD,CAAA;QAC5E,2DAA2D;QAC3D,OAAO,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACnF,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/exports/client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Client components for the admin, referenced from Payload's import map as
+ * `@forumone/throughline/client#PublishButton` and the like.
+ *
+ * Kept off the package root so a server-only consumer never loads React or
+ * `@payloadcms/ui`.
+ */
+export { CharacterCountText, CharacterCountTextarea } from '../fields/CharacterCountField.js';
+export { PublishButton } from '../publishing/admin/PublishButton.js';
+export type { ThroughlinePublishButtonProps } from '../publishing/admin/PublishButton.js';
+export { UnpublishButton } from '../publishing/admin/UnpublishButton.js';
+export type { ThroughlineUnpublishButtonProps } from '../publishing/admin/UnpublishButton.js';
+export { SchedulePublishField } from '../publishing/admin/SchedulePublishField.js';
+export type { ThroughlineSchedulePublishFieldProps } from '../publishing/admin/SchedulePublishField.js';
+export { callPublishingEndpoint, describeBlock } from '../publishing/admin/publishing-client.js';
+export type { CallPublishingEndpointArgs, PublishingCallResult, PublishingIssue, PublishingResponse, } from '../publishing/admin/publishing-client.js';
+export { CommandPalette } from '../editorial/palette/CommandPalette.js';
+export type { CommandPaletteProps } from '../editorial/palette/CommandPalette.js';
+export { ReportsNav } from '../editorial/palette/ReportsNav.js';
+export { SyncButton } from '../integrations/admin/SyncButton.js';
+export type { ThroughlineSyncButtonProps } from '../integrations/admin/SyncButton.js';
+export { describeSyncOutcome, fetchSyncStatus, formatSyncTime, syncHasFinished, triggerSync, } from '../integrations/admin/sync-client.js';
+export type { FetchSyncStatusArgs, SyncOutcome, SyncStatus, SyncStatusValue, TriggerSyncArgs, TriggerSyncBody, TriggerSyncResult, } from '../integrations/admin/sync-client.js';
+//# sourceMappingURL=client.d.ts.map

package/dist/exports/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/exports/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAG7F,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACpE,YAAY,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAA;AAEzF,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AACxE,YAAY,EAAE,+BAA+B,EAAE,MAAM,wCAAwC,CAAA;AAE7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAA;AAClF,YAAY,EAAE,oCAAoC,EAAE,MAAM,6CAA6C,CAAA;AAEvG,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AAChG,YAAY,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,kBAAkB,GACnB,MAAM,0CAA0C,CAAA;AAGjD,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAA;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAA;AAErF,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,GACZ,MAAM,sCAAsC,CAAA;AAC7C,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,sCAAsC,CAAA"}

package/dist/exports/client.js

@@ -0,0 +1,21 @@
+/**
+ * Client components for the admin, referenced from Payload's import map as
+ * `@forumone/throughline/client#PublishButton` and the like.
+ *
+ * Kept off the package root so a server-only consumer never loads React or
+ * `@payloadcms/ui`.
+ */
+// Fields
+export { CharacterCountText, CharacterCountTextarea } from '../fields/CharacterCountField.js';
+// Publishing
+export { PublishButton } from '../publishing/admin/PublishButton.js';
+export { UnpublishButton } from '../publishing/admin/UnpublishButton.js';
+export { SchedulePublishField } from '../publishing/admin/SchedulePublishField.js';
+export { callPublishingEndpoint, describeBlock } from '../publishing/admin/publishing-client.js';
+// Editorial
+export { CommandPalette } from '../editorial/palette/CommandPalette.js';
+export { ReportsNav } from '../editorial/palette/ReportsNav.js';
+// Integrations
+export { SyncButton } from '../integrations/admin/SyncButton.js';
+export { describeSyncOutcome, fetchSyncStatus, formatSyncTime, syncHasFinished, triggerSync, } from '../integrations/admin/sync-client.js';
+//# sourceMappingURL=client.js.map

package/dist/exports/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/exports/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAE7F,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAGxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAA;AAGlF,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AAQhG,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAE/D,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AAGhE,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,GACZ,MAAM,sCAAsC,CAAA"}

package/dist/exports/rsc.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Server components for the admin, referenced from Payload's import map as
+ * `@forumone/throughline/rsc#UsedOnPanel`, `#ContentHealthView` and the like,
+ * or rendered by a host directly (`HealthSummary`, inside its own dashboard
+ * component).
+ *
+ * Kept off the package root so a server-only consumer never loads React,
+ * `@payloadcms/ui` or `@payloadcms/next`.
+ */
+export { UsedOnPanel } from '../references/UsedOnPanel.js';
+export { ContentHealthView } from '../editorial/health/ContentHealthView.js';
+export { ContentHealthReport } from '../editorial/health/ContentHealthReport.js';
+export { HealthSummary } from '../editorial/health/HealthSummary.js';
+export { ContentCalendarView } from '../editorial/calendar/ContentCalendarView.js';
+export { ContentCalendarReport } from '../editorial/calendar/ContentCalendarReport.js';
+export { YourWorkDashboard, YourWorkReport } from '../editorial/work/YourWork.js';
+//# sourceMappingURL=rsc.d.ts.map

package/dist/exports/rsc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsc.d.ts","sourceRoot":"","sources":["../../src/exports/rsc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/exports/rsc.js

@@ -0,0 +1,19 @@
+/**
+ * Server components for the admin, referenced from Payload's import map as
+ * `@forumone/throughline/rsc#UsedOnPanel`, `#ContentHealthView` and the like,
+ * or rendered by a host directly (`HealthSummary`, inside its own dashboard
+ * component).
+ *
+ * Kept off the package root so a server-only consumer never loads React,
+ * `@payloadcms/ui` or `@payloadcms/next`.
+ */
+// Media
+export { UsedOnPanel } from '../references/UsedOnPanel.js';
+// Editorial
+export { ContentHealthView } from '../editorial/health/ContentHealthView.js';
+export { ContentHealthReport } from '../editorial/health/ContentHealthReport.js';
+export { HealthSummary } from '../editorial/health/HealthSummary.js';
+export { ContentCalendarView } from '../editorial/calendar/ContentCalendarView.js';
+export { ContentCalendarReport } from '../editorial/calendar/ContentCalendarReport.js';
+export { YourWorkDashboard, YourWorkReport } from '../editorial/work/YourWork.js';
+//# sourceMappingURL=rsc.js.map

package/dist/exports/rsc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsc.js","sourceRoot":"","sources":["../../src/exports/rsc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE1D,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/fields/CharacterCountField.d.ts

@@ -0,0 +1,4 @@
+import type { TextareaFieldClientComponent, TextFieldClientComponent } from 'payload';
+export declare const CharacterCountText: TextFieldClientComponent;
+export declare const CharacterCountTextarea: TextareaFieldClientComponent;
+//# sourceMappingURL=CharacterCountField.d.ts.map

package/dist/fields/CharacterCountField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CharacterCountField.d.ts","sourceRoot":"","sources":["../../src/fields/CharacterCountField.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAsHrF,eAAO,MAAM,kBAAkB,EAAE,wBAqBhC,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAE,4BAqBpC,CAAA"}