@growth-labs/cms 0.8.19 → 0.8.23

package/dist/routes/foundry-publish.d.ts

@@ -1,9 +1,59 @@
+import { type PublicationReconciler } from '../engine/publication.js';
 import { type ContentRouteConfig } from './content.js';
 import { type RouteContext } from './context.js';
+/**
+ * The per-publication opt-in for the publish transition (M3-18). It lives on the
+ * route's config (`ContentRouteConfig.foundryPublish`); the Astro adapter reads it
+ * from `locals.cmsHooks.foundryPublish`. Only `autoPublish === true` turns it on.
+ */
+export interface FoundryPublishOptions {
+    /** `true` enables v2 PUTs (drafts, in-place edits of published items) and POST /publish. */
+    autoPublish?: boolean;
+    /**
+     * The publication's LIVE surfaces (sitemap, feed, .md twin, ...), resolved per
+     * request and handed to `publishOne`. The route never passes
+     * `allowNoSurfaces`: an absent or empty list refuses the publish with 503
+     * before anything is written.
+     */
+    surfaces?: (ctx: RouteContext) => PublicationReconciler[] | Promise<PublicationReconciler[]>;
+    /** Forwarded to `publishOne`; each named surface must be present. */
+    requiredSurfaceNames?: string[];
+    /** Forwarded to `publishOne` for its ledger. */
+    packageVersion?: string | null;
+    /**
+     * Declares that the publication's scheduler publishes scheduled items through
+     * `publishOne` with these live surfaces. Without it, POST /publish refuses a
+     * future publishAt with `409 scheduling_requires_surface_scheduler`, because
+     * the legacy scheduled sweep (engine/cron.ts runScheduledPublish) publishes
+     * with no surfaces.
+     */
+    scheduling?: 'publishOne';
+    /**
+     * The namespace this publication's archive bridge writes into
+     * `content_items.source_id` (`<namespace>:<relpath>`, e.g. `warfronts`; see a
+     * channel repo's scripts/archive-import/compiler.mjs SOURCE_NAMESPACE and
+     * buildSourceId). Only items under exactly this prefix can be adopted; with
+     * none declared, nothing can.
+     */
+    bridgeSourceNamespace?: string;
+    /**
+     * REQUIRED when `autoPublish` is on: this publication's canonical host,
+     * lowercase with no scheme and no port (e.g. `warfronts.pub`). The Foundry
+     * HMAC secret is shared by every site, so a publication that declares a host
+     * (here or as `ContentRouteConfig.foundryCanonicalHost`, with or without
+     * `autoPublish`) verifies the host-bound `foundry-cms-v2` string with THIS
+     * host (never the request's Host header) on every /api/cms/foundry/* verb,
+     * and refuses the legacy dot form and a request signed for another site.
+     * Malformed, or disagreeing with `foundryCanonicalHost`: every verb answers 503.
+     */
+    canonicalHost?: string;
+}
 export interface FoundryPublishRouteHandlers {
     put(ctx: RouteContext): Promise<Response>;
     get(ctx: RouteContext): Promise<Response>;
     unpublish(ctx: RouteContext): Promise<Response>;
+    /** M3-18: publish (or resync) through publishOne; 409 unless the publication opted in. */
+    publish(ctx: RouteContext): Promise<Response>;
 }
 export declare function createFoundryPublishRoutes(config: ContentRouteConfig): FoundryPublishRouteHandlers;
 //# sourceMappingURL=foundry-publish.d.ts.map

package/dist/routes/foundry-publish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foundry-publish.d.ts","sourceRoot":"","sources":["../../src/routes/foundry-publish.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,kBAAkB,EAAuB,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAwBtD,MAAM,WAAW,2BAA2B;IAC3C,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzC,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzC,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC/C;AAyLD,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,kBAAkB,GACxB,2BAA2B,CAwI7B"}
+{"version":3,"file":"foundry-publish.d.ts","sourceRoot":"","sources":["../../src/routes/foundry-publish.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,qBAAqB,EAAc,MAAM,0BAA0B,CAAA;AAKjF,OAAO,EAAE,KAAK,kBAAkB,EAAuB,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAwBtD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACrC,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,qBAAqB,EAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAA;IAC5F,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC/B,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC3C,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzC,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzC,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC/C,0FAA0F;IAC1F,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC7C;AAkxBD,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,kBAAkB,GACxB,2BAA2B,CAsM7B"}