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

package/dist/observability/writer.js

@@ -0,0 +1,72 @@
+import { defaultLogger } from '../logger/index.js';
+import { DEFAULT_JOB_FAILURES_SLUG } from './collection.js';
+import { summariseReport } from './report.js';
+/**
+ * Returns a writer that turns a failure report into a `job-failures` row.
+ *
+ * It never throws: it runs inside a failure handler, and a throw there is
+ * retried by the job runner — a retry storm about the recorder while the
+ * original failure goes unrecorded. A write that fails is logged at `error`
+ * **with the failure's own summary and message**, so the one thing this
+ * writer exists to keep is never lost silently, only demoted to the log.
+ *
+ * The stack is not stored. Rows are readable through the admin, and a stack
+ * names file paths; the webhook report carries it instead.
+ */
+export function createJobFailureWriter(options) {
+    const { payload, collectionSlug = DEFAULT_JOB_FAILURES_SLUG } = options;
+    const logger = options.logger ?? defaultLogger;
+    return async function recordJobFailure(report) {
+        let data;
+        try {
+            data = toRow(report);
+            await payload.create({ collection: collectionSlug, data });
+        }
+        catch (writeError) {
+            try {
+                logger.error('Job failure write failed', {
+                    error: String(writeError),
+                    collection: collectionSlug,
+                    summary: data?.['summary'] ?? safeSummary(report),
+                    message: data?.['message'],
+                });
+            }
+            catch {
+                // Nothing left to tell.
+            }
+        }
+    };
+}
+function toRow(report) {
+    const base = {
+        createdAt: report.at,
+        kind: report.kind,
+        source: report.functionId,
+        summary: summariseReport(report).slice(0, 500),
+        ...(report.deployment.environment ? { environment: report.deployment.environment } : {}),
+        ...(report.deployment.commit ? { commit: report.deployment.commit } : {}),
+    };
+    if (report.kind === 'healthcheck') {
+        return {
+            ...base,
+            message: `${report.failed.length} check(s) failed: ${report.failed.map((f) => f.name).join(', ')}`,
+            details: report.failed,
+        };
+    }
+    return {
+        ...base,
+        message: report.message,
+        ...(report.name ? { errorName: report.name } : {}),
+        ...(report.runId ? { runId: report.runId } : {}),
+        ...(report.triggerEvent ? { triggerEvent: report.triggerEvent } : {}),
+    };
+}
+function safeSummary(report) {
+    try {
+        return summariseReport(report);
+    }
+    catch {
+        return '(unsummarisable failure report)';
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/observability/writer.js.map

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

package/dist/plugin-contract/admin.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Where a plugin-owned collection sits in the admin sidebar.
+ *
+ * A string (or a map of locale to string, as Payload accepts) names the
+ * group. `false` leaves the collection ungrouped, in Payload's default
+ * "Collections" section — which is not what `false` means on a collection's
+ * own `admin.group`: there Payload reads it as "leave out of the nav
+ * entirely". A plugin translates this value; it never passes `false` through.
+ */
+export type PluginAdminGroup = string | Record<string, string> | false;
+/**
+ * Admin options accepted by every Throughline plugin that declares a
+ * collection. Plugins that declare none do not accept it, for the same reason
+ * a plugin with no endpoints omits `routePrefix`: an option it cannot honour
+ * would be a silent no-op.
+ */
+export interface PluginAdminOptions {
+    /**
+     * Sidebar group for every collection the plugin declares. Defaults to
+     * {@link DEFAULT_ADMIN_GROUP}. `false` leaves them ungrouped.
+     *
+     * Payload renders an ungrouped collection loose at the top of the sidebar,
+     * above every group — which is why the default is a group and not nothing.
+     */
+    group?: PluginAdminGroup;
+}
+/**
+ * The options a collection-declaring plugin adds to its own. Kept apart from
+ * `BaseCorePluginOptions` so that only those plugins carry it.
+ */
+export interface CollectionPluginOptions {
+    /** Admin UI placement for the collections this plugin declares. */
+    admin?: PluginAdminOptions;
+}
+/** The sidebar group plugin-owned collections land in when no group is given. */
+export declare const DEFAULT_ADMIN_GROUP = "Throughline";
+/**
+ * Resolves a plugin's `admin` option to the fragment it spreads into each
+ * collection's `admin` block: `{ group }` for a named group, `{}` for
+ * ungrouped. Never returns `group: false`, which Payload would read as hidden.
+ */
+export declare function resolveAdminGroup(admin?: PluginAdminOptions): {
+    group?: string | Record<string, string>;
+};
+//# sourceMappingURL=admin.d.ts.map

package/dist/plugin-contract/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/plugin-contract/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAA;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAC3B;AAED,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAEhD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC,CAGA"}

package/dist/plugin-contract/admin.js

@@ -0,0 +1,12 @@
+/** The sidebar group plugin-owned collections land in when no group is given. */
+export const DEFAULT_ADMIN_GROUP = 'Throughline';
+/**
+ * Resolves a plugin's `admin` option to the fragment it spreads into each
+ * collection's `admin` block: `{ group }` for a named group, `{}` for
+ * ungrouped. Never returns `group: false`, which Payload would read as hidden.
+ */
+export function resolveAdminGroup(admin) {
+    const group = admin?.group ?? DEFAULT_ADMIN_GROUP;
+    return group === false ? {} : { group };
+}
+//# sourceMappingURL=admin.js.map

package/dist/plugin-contract/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/plugin-contract/admin.ts"],"names":[],"mappings":"AAqCA,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAEhD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA0B;IAG1D,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,mBAAmB,CAAA;IACjD,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAA;AACzC,CAAC"}

package/dist/plugin-contract/env.d.ts

@@ -0,0 +1,29 @@
+/**
+ * One environment variable something needs before it can start, as data.
+ *
+ * A plugin that falls back to `process.env` at init exports a list of these
+ * beside its factory — `approvalsPlugin` / `approvalsEnv`, `emailPlugin` /
+ * `emailEnv` — and its own init check reads the same entries. A site hands
+ * every list, plus its own variables, to `assertEnvironment` from
+ * `@forumone/throughline`, which reports everything wrong in one error
+ * before any plugin gets to throw on the first thing it finds.
+ *
+ * It describes the *environment fallback*. A site that passes the value as an
+ * option instead (say `tokenSecret` from a secrets manager) leaves that
+ * plugin's list out of its `assertEnvironment` call.
+ */
+export interface EnvRequirement {
+    /** The variable's name, e.g. `APPROVAL_TOKEN_SECRET`. */
+    readonly name: string;
+    /**
+     * The shortest value accepted. For secrets that sign or key something,
+     * where a short value is as bad as none.
+     */
+    readonly minLength?: number;
+    /**
+     * Why it is needed and how to get one, in a sentence a person fixing a
+     * deploy can act on. Printed beside the name; never include a value.
+     */
+    readonly why: string;
+}
+//# sourceMappingURL=env.d.ts.map

package/dist/plugin-contract/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/plugin-contract/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB"}

package/dist/plugin-contract/env.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env.js.map

package/dist/plugin-contract/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/plugin-contract/env.ts"],"names":[],"mappings":""}

package/dist/plugin-contract/index.d.ts

@@ -0,0 +1,39 @@
+import type { Plugin } from 'payload';
+/**
+ * Options every Throughline core plugin accepts. Plugin-specific options
+ * extend this interface.
+ */
+export interface BaseCorePluginOptions {
+    /** Enable or disable the plugin without removing it from the config. Defaults to `true`. */
+    enabled?: boolean;
+    /**
+     * Route prefix the plugin mounts its HTTP endpoints under. Defaults to a
+     * plugin-specific value (e.g. `/api/publishing`). Override to avoid
+     * collisions or to expose under a different path.
+     *
+     * MCP is not among those endpoints any more: tools reach a client through
+     * the host's `@payloadcms/plugin-mcp`, on one `/api/mcp`. A plugin serving
+     * no HTTP endpoints of its own omits this option rather than accepting one
+     * it cannot honour — see `auditQueryPlugin`, `componentsPlugin` and
+     * `integrationsPlugin`.
+     */
+    routePrefix?: string;
+    /** Logger used for plugin diagnostics. Falls back to a console logger if omitted. */
+    logger?: Logger;
+}
+export interface Logger {
+    debug: (message: string, context?: Record<string, unknown>) => void;
+    info: (message: string, context?: Record<string, unknown>) => void;
+    warn: (message: string, context?: Record<string, unknown>) => void;
+    error: (message: string, context?: Record<string, unknown>) => void;
+}
+/**
+ * The Throughline core plugin signature. A plugin takes its options and
+ * returns a standard Payload {@link Plugin}.
+ */
+export type CorePlugin<Options extends BaseCorePluginOptions = BaseCorePluginOptions> = (options: Options) => Plugin;
+export * from './admin.js';
+export * from './env.js';
+export * from './mcp.js';
+export * from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugin-contract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin-contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACnE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAClE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAClE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CACpE;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,qBAAqB,GAAG,qBAAqB,IAAI,CACtF,OAAO,EAAE,OAAO,KACb,MAAM,CAAA;AAEX,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA"}

package/dist/plugin-contract/index.js

@@ -0,0 +1,5 @@
+export * from './admin.js';
+export * from './env.js';
+export * from './mcp.js';
+export * from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/plugin-contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin-contract/index.ts"],"names":[],"mappings":"AAwCA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA"}

package/dist/plugin-contract/mcp.d.ts

@@ -0,0 +1,51 @@
+import type { z } from 'zod';
+import type { Logger } from './index.js';
+/**
+ * A single tool exposed by a Throughline MCP server.
+ */
+export interface McpToolDefinition<Input extends z.ZodType = z.ZodType, Output = unknown> {
+    /** The tool's name as exposed to the MCP client. */
+    name: string;
+    /** Human-readable description the MCP client uses to decide when to call this tool. */
+    description: string;
+    /** Zod schema for the input; used for validation and for generating the MCP tool schema. */
+    inputSchema: Input;
+    /**
+     * The API-key scope a caller must hold, e.g. `'publishing.execute'`.
+     *
+     * Declared on the consequential tools — the ones that write, publish or
+     * decide. A tool with no `requiredScope` is callable by any authenticated
+     * key, which is the right default for a read.
+     *
+     * **Nothing reads this.** Enforcement is the per-key checkbox
+     * `@payloadcms/plugin-mcp` generates, one per tool, which a server makes
+     * possible by declaring its tools' names as the config is built — see
+     * `createMcpToolCollector`.
+     *
+     * Kept because it is the tool → scope mapping, and says which tools are
+     * consequential in a way a checkbox list does not: a scope-aware default
+     * (writes off until granted, reads on) would be built from exactly this.
+     * Deleting it would mean re-deriving eleven declarations by hand.
+     */
+    requiredScope?: string;
+    /** Handler invoked with validated input plus per-request context. */
+    handler: (input: z.infer<Input>, context: McpToolContext) => Promise<Output>;
+}
+export interface McpToolContext {
+    /** The user identified by the API key used for this request. */
+    user: AuthenticatedUser | null;
+    /** The API key's name, for audit logging. */
+    apiKeyName: string;
+    /** The session ID from the MCP client, if provided. */
+    sessionId?: string;
+    /** Request-scoped logger. */
+    logger: Logger;
+}
+export interface AuthenticatedUser {
+    id: string;
+    email: string;
+    name: string;
+    roles: string[];
+    groups: string[];
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/plugin-contract/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/plugin-contract/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IACtF,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAA;IACnB,4FAA4F;IAC5F,WAAW,EAAE,KAAK,CAAA;IAClB;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qEAAqE;IACrE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC9B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB"}

package/dist/plugin-contract/mcp.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.js.map

package/dist/plugin-contract/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/plugin-contract/mcp.ts"],"names":[],"mappings":""}

package/dist/plugin-contract/registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A lightweight registry plugins use to announce their presence and discover
+ * sibling plugins. Attached to the Payload instance via a symbol so it does
+ * not pollute the public API surface.
+ */
+export interface PluginRegistryEntry {
+    id: string;
+    version: string;
+    capabilities: string[];
+}
+export interface PluginRegistry {
+    register(entry: PluginRegistryEntry): void;
+    has(id: string): boolean;
+    get(id: string): PluginRegistryEntry | undefined;
+    list(): PluginRegistryEntry[];
+    requireCapability(capability: string, requiredBy: string): void;
+}
+/**
+ * Returns the registry attached to the given target (typically the Payload
+ * instance passed to `onInit`). Creates and attaches one on first access.
+ */
+export declare function getPluginRegistry(target: object): PluginRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugin-contract/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugin-contract/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAA;IAC1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;IAChD,IAAI,IAAI,mBAAmB,EAAE,CAAA;IAC7B,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAChE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAahE"}

package/dist/plugin-contract/registry.js

@@ -0,0 +1,51 @@
+/**
+ * A lightweight registry plugins use to announce their presence and discover
+ * sibling plugins. Attached to the Payload instance via a symbol so it does
+ * not pollute the public API surface.
+ */
+const REGISTRY_SYMBOL = Symbol.for('@forumone/throughline/plugin-registry');
+/**
+ * Returns the registry attached to the given target (typically the Payload
+ * instance passed to `onInit`). Creates and attaches one on first access.
+ */
+export function getPluginRegistry(target) {
+    const host = target;
+    const existing = host[REGISTRY_SYMBOL];
+    if (existing)
+        return existing;
+    const registry = createRegistry();
+    Object.defineProperty(target, REGISTRY_SYMBOL, {
+        value: registry,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+    return registry;
+}
+function createRegistry() {
+    const entries = new Map();
+    return {
+        register(entry) {
+            if (entries.has(entry.id)) {
+                throw new Error(`Plugin ${entry.id} is already registered`);
+            }
+            entries.set(entry.id, entry);
+        },
+        has(id) {
+            return entries.has(id);
+        },
+        get(id) {
+            return entries.get(id);
+        },
+        list() {
+            return Array.from(entries.values());
+        },
+        requireCapability(capability, requiredBy) {
+            const providers = Array.from(entries.values()).filter((entry) => entry.capabilities.includes(capability));
+            if (providers.length === 0) {
+                throw new Error(`Plugin ${requiredBy} requires capability "${capability}", but no registered plugin provides it.`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugin-contract/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugin-contract/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAA;AAgB3E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,IAAI,GAAG,MAAoD,CAAA;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,CAAA;IACtC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE7B,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;IACjC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE;QAC7C,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;KACpB,CAAC,CAAA;IACF,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAA;IAEtD,OAAO;QACL,QAAQ,CAAC,KAAK;YACZ,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAA;YAC7D,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;QACD,GAAG,CAAC,EAAE;YACJ,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACxB,CAAC;QACD,GAAG,CAAC,EAAE;YACJ,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACxB,CAAC;QACD,IAAI;YACF,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QACrC,CAAC;QACD,iBAAiB,CAAC,UAAU,EAAE,UAAU;YACtC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9D,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CACxC,CAAA;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,UAAU,UAAU,yBAAyB,UAAU,0CAA0C,CAClG,CAAA;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/publishing/admin/PublishButton.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+export interface ThroughlinePublishButtonProps {
+    /** Route prefix the plugin is mounted under. Injected via `clientProps`. */
+    routePrefix?: string;
+}
+/**
+ * Replaces Payload's Publish button on collections the publishing plugin
+ * governs.
+ *
+ * The native button submits `_status: 'published'` straight to the update
+ * endpoint, which the plugin's trust boundary rejects by design. This one
+ * saves pending edits as a draft, then asks the publishing server to run the
+ * pipeline — as the logged-in editor, over the session cookie, with no API
+ * key. A block renders the failing step, its issues and its suggestion
+ * instead of a generic error.
+ *
+ * On the create view this renders nothing: the pipeline's first step is
+ * `exist`, so there is nothing to evaluate until the draft is saved.
+ * Payload's own Save Draft button covers that step.
+ */
+export declare function PublishButton(props?: ThroughlinePublishButtonProps): React.ReactNode;
+//# sourceMappingURL=PublishButton.d.ts.map

package/dist/publishing/admin/PublishButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublishButton.d.ts","sourceRoot":"","sources":["../../../src/publishing/admin/PublishButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAgC,MAAM,OAAO,CAAA;AAYpD,MAAM,WAAW,6BAA6B;IAC5C,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,6BAAkC,GAAG,KAAK,CAAC,SAAS,CA2KxF"}

package/dist/publishing/admin/PublishButton.js

@@ -0,0 +1,164 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useState } from 'react';
+import { FormSubmit, toast, useConfig, useDocumentInfo, useForm, useFormModified, useTranslation, } from '@payloadcms/ui';
+import { callPublishingEndpoint, describeBlock, fieldErrorsFromBlock } from './publishing-client.js';
+/**
+ * Replaces Payload's Publish button on collections the publishing plugin
+ * governs.
+ *
+ * The native button submits `_status: 'published'` straight to the update
+ * endpoint, which the plugin's trust boundary rejects by design. This one
+ * saves pending edits as a draft, then asks the publishing server to run the
+ * pipeline — as the logged-in editor, over the session cookie, with no API
+ * key. A block renders the failing step, its issues and its suggestion
+ * instead of a generic error.
+ *
+ * On the create view this renders nothing: the pipeline's first step is
+ * `exist`, so there is nothing to evaluate until the draft is saved.
+ * Payload's own Save Draft button covers that step.
+ */
+export function PublishButton(props = {}) {
+    const routePrefix = props.routePrefix ?? '/publishing';
+    const { collectionSlug, hasPublishedDoc, hasPublishPermission, id, setHasPublishedDoc, setMostRecentVersionIsAutosaved, setUnpublishedVersionCount, unpublishedVersionCount, uploadStatus, } = useDocumentInfo();
+    const { config } = useConfig();
+    const { dispatchFields, getFields, setIsValid, setSubmitted, submit } = useForm();
+    const modified = useFormModified();
+    const { t } = useTranslation();
+    const [publishing, setPublishing] = useState(false);
+    const { api } = config.routes;
+    const serverURL = config.serverURL ?? '';
+    const publish = useCallback(async () => {
+        if (id === undefined || id === null || !collectionSlug || publishing)
+            return;
+        setPublishing(true);
+        try {
+            // Persist pending edits first, as a draft. Payload writes those to the
+            // versions table and leaves the published document alone, so the trust
+            // boundary lets them through; the pipeline then evaluates what was
+            // actually saved rather than what is on screen.
+            //
+            // `?draft=true` is what makes this a draft write. The `_status`
+            // override only pins the intent when form state carries a `_status` of
+            // its own, and mirrors what Payload's native Save Draft sends.
+            if (modified) {
+                const saved = await submit({
+                    action: `${serverURL}${api}/${collectionSlug}/${id}?draft=true&depth=0`,
+                    method: 'PATCH',
+                    overrides: { _status: 'draft' },
+                    skipValidation: true,
+                    // No toast for this write. It is a step inside publishing, not
+                    // something the editor asked for, and its success toast used to
+                    // land on top of the publish one — two overlapping notices for one
+                    // action, the first of which announced the lesser outcome.
+                    // Payload's own Save Draft button is untouched and still toasts.
+                    disableSuccessStatus: true,
+                });
+                // `submit` returns void and toasts its own error on most failures,
+                // but falls through with a non-ok response when the body carries no
+                // message. Check both so a failed save never reaches the pipeline.
+                if (!saved || !saved.res.ok)
+                    return;
+            }
+            const result = await callPublishingEndpoint({
+                serverURL,
+                apiRoute: api,
+                routePrefix,
+                action: 'publish',
+                collection: collectionSlug,
+                id,
+            });
+            if (!result.ok) {
+                toast.error(result.message);
+                return;
+            }
+            if (!result.body.published) {
+                /*
+                The pipeline's issues already name their fields; until now they only
+                reached a toast, which left the editor reading `layout.7.image` and
+                counting blocks. Dispatched into form state they render where the
+                problem is — on the field, and as an error count on the collapsed
+                block row containing it.
+        
+                `setSubmitted` is what makes them visible: a field shows its error
+                only once the form has been submitted, and a publish with no pending
+                edits never submits the form at all. `setIsValid(false)` mirrors what
+                Payload does with the field errors from an ordinary save.
+        
+                The toast still lists everything, because an issue with no field — an
+                embargo, a missing approval — has nowhere else to go.
+                */
+                const fieldErrors = fieldErrorsFromBlock(result.body, Object.keys(getFields()));
+                if (fieldErrors.length > 0) {
+                    dispatchFields({ type: 'ADD_SERVER_ERRORS', errors: fieldErrors });
+                    setIsValid(false);
+                    setSubmitted(true);
+                }
+                const { title, description } = describeBlock(result.body, {
+                    markedFields: fieldErrors.length,
+                });
+                toast.error(title, {
+                    ...(description ? { description } : {}),
+                    duration: 10_000,
+                });
+                return;
+            }
+            // Deliberately not resetting the form here. The draft save above
+            // already merged the server's response into form state, so the fields
+            // on screen are what was just written. Resetting from
+            // `useDocumentInfo().data` — the document as it was when the view
+            // mounted — would replace the editor's saved edits with the pre-edit
+            // values and read as though the publish had silently discarded them.
+            //
+            // The status indicators below are what actually needs updating.
+            setHasPublishedDoc(true);
+            setUnpublishedVersionCount(0);
+            setMostRecentVersionIsAutosaved(false);
+            // The document is live either way. A warning means something
+            // downstream of the publish didn't happen, which is worth saying
+            // without implying the publish failed.
+            const warnings = result.body.warnings ?? [];
+            if (warnings.length > 0) {
+                toast.warning(t('version:published'), {
+                    description: warnings.join('\n'),
+                    duration: 10_000,
+                });
+            }
+            else {
+                toast.success(t('version:published'));
+            }
+        }
+        finally {
+            setPublishing(false);
+        }
+    }, [
+        api,
+        collectionSlug,
+        dispatchFields,
+        getFields,
+        id,
+        modified,
+        publishing,
+        routePrefix,
+        serverURL,
+        setHasPublishedDoc,
+        setIsValid,
+        setMostRecentVersionIsAutosaved,
+        setSubmitted,
+        setUnpublishedVersionCount,
+        submit,
+        t,
+    ]);
+    if (!hasPublishPermission)
+        return null;
+    // Create view — no document for the pipeline to evaluate yet.
+    if (id === undefined || id === null || !collectionSlug)
+        return null;
+    const canPublish = (modified || unpublishedVersionCount > 0 || !hasPublishedDoc) &&
+        uploadStatus !== 'uploading' &&
+        !publishing;
+    return (_jsx(FormSubmit, { buttonId: "action-save", disabled: !canPublish, onClick: () => {
+            void publish();
+        }, size: "medium", type: "button", children: publishing ? t('version:publishing') : t('version:publishChanges') }));
+}
+//# sourceMappingURL=PublishButton.js.map

package/dist/publishing/admin/PublishButton.js.map

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

package/dist/publishing/admin/SchedulePublishField.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+export interface ThroughlineSchedulePublishFieldProps {
+    /** The field's form path. Supplied by Payload. */
+    path: string;
+    /** Route prefix the plugin is mounted under. Injected via `clientProps`. */
+    routePrefix?: string;
+}
+/**
+ * The Schedule control, rendered in place of the scheduled-publish date field.
+ *
+ * The field is not typed into directly. Scheduling goes through the publishing
+ * server so the pipeline's checks run *now* — an editor hears about a missing
+ * alt text while the page is in front of them, rather than from a log line on
+ * the morning it was meant to go out. The same checks run again when the
+ * schedule fires; this is the early warning, not the gate.
+ *
+ * The server writes the time with a draft save, and the control then puts the
+ * same value into form state without marking the form modified. That keeps the
+ * two in step: the next Save Draft sends the value the server already holds,
+ * rather than the empty one the form loaded with, which would silently cancel
+ * the schedule.
+ */
+export declare function SchedulePublishField(props: ThroughlineSchedulePublishFieldProps): React.ReactNode;
+//# sourceMappingURL=SchedulePublishField.d.ts.map

package/dist/publishing/admin/SchedulePublishField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchedulePublishField.d.ts","sourceRoot":"","sources":["../../../src/publishing/admin/SchedulePublishField.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAgC,MAAM,OAAO,CAAA;AAepD,MAAM,WAAW,oCAAoC;IACnD,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oCAAoC,GAAG,KAAK,CAAC,SAAS,CA0IjG"}