@styleflow.app/flowpress-deploy 0.1.0-beta.0

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 0.1.0-beta.0
+
+- Initial full/partial deployment contract, path safety and Cloudflare route
+  validation.

package/README.md

@@ -0,0 +1,11 @@
+# FlowPress Deploy
+
+Installable npm/Composer feature pack for safe Cloudflare Pages and Workers
+build orchestration. CMS partial builds require a successful compatible
+baseline; code and manual triggers remain full builds.
+
+The public API validates paths and `_routes.json`, merges partial artifacts
+without traversal or case collisions, regenerates sitemaps, selects Pages for
+static targets and Workers for dev, requires `ASTRO_KEY` for protected batches,
+and acknowledges the CMS queue only after deploy and smoke test. Failed
+batches are released for retry.

package/composer.json

@@ -0,0 +1,11 @@
+{
+  "name": "flowpress/deploy",
+  "description": "WordPress capability registration for FlowPress deploy.",
+  "type": "wordpress-muplugin",
+  "license": "proprietary",
+  "require": {
+    "php": ">=8.1",
+    "flowpress/wordpress-core": "^0.2.10"
+  },
+  "extra": {"installer-name": "flowpress-deploy"}
+}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+export type FlowpressDeployTrigger = "push" | "manual" | "cms";
+export type FlowpressDeployMode = "full" | "partial";
+export type FlowpressCloudflareTarget = "pages" | "workers";
+export interface FlowpressDeployBaseline {
+    environment: string;
+    fingerprint: string;
+    artifactId: string;
+    completedAt: string;
+}
+export interface FlowpressDeployRequest {
+    trigger: FlowpressDeployTrigger;
+    environment: string;
+    fingerprint: string;
+    paths?: string[];
+    deletedPaths?: string[];
+    forceFull?: boolean;
+    baseline?: FlowpressDeployBaseline | null;
+}
+export interface FlowpressDeployDecision {
+    mode: FlowpressDeployMode;
+    paths: string[];
+    deletedPaths: string[];
+    baseline?: FlowpressDeployBaseline;
+}
+export interface FlowpressBuildEntry {
+    path: string;
+    contentHash: string;
+}
+export interface FlowpressQueueBatch {
+    id: string;
+    requiresAstroKey?: boolean;
+}
+export interface FlowpressQueueLifecycle<T> {
+    deploy: () => Promise<T>;
+    smokeTest: (result: T) => Promise<void>;
+    acknowledge: (batchId: string) => Promise<void>;
+    release: (batchId: string, reason: string) => Promise<void>;
+}
+export declare function normalizeDeployPath(value: string): string;
+export declare function resolveDeploy(request: FlowpressDeployRequest): FlowpressDeployDecision;
+export declare function assertNoOutputCollisions(entries: string[]): void;
+export declare function mergeBuildEntries(baseline: FlowpressBuildEntry[], partial: FlowpressBuildEntry[], deletedPaths?: string[]): FlowpressBuildEntry[];
+export declare function buildSitemapXml(paths: string[], siteUrl: string): string;
+export declare function assertAstroKey(requiresAstroKey: boolean, environment: Record<string, string | undefined>): void;
+export declare function cloudflareTargetForEnvironment(environment: string): FlowpressCloudflareTarget;
+export declare function deployQueueBatch<T>(batch: FlowpressQueueBatch, lifecycle: FlowpressQueueLifecycle<T>): Promise<T>;
+export declare function validateCloudflareRoutes(input: unknown): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAC/D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAAC;AACrD,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,sBAAsB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBzD;AAMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,uBAAuB,CAqBtF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAQhE;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,YAAY,GAAE,MAAM,EAAO,GAC1B,mBAAmB,EAAE,CAqBvB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAexE;AAWD,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,OAAO,EACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC9C,IAAI,CAIN;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,GAClB,yBAAyB,CAE3B;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,uBAAuB,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAa7D"}

package/dist/index.js

@@ -0,0 +1,133 @@
+export function normalizeDeployPath(value) {
+    if (typeof value !== "string"
+        || !value.startsWith("/")
+        || value.includes("\\")
+        || value.includes("\0")
+        || /(^|\/)\.\.?($|\/)/.test(value)
+        || /^\/\//.test(value)) {
+        throw new Error(`Unsafe FlowPress deploy path: ${value}`);
+    }
+    const url = new URL(value, "https://flowpress.invalid");
+    if (url.origin !== "https://flowpress.invalid" || url.search || url.hash) {
+        throw new Error(`Unsafe FlowPress deploy path: ${value}`);
+    }
+    return url.pathname.replace(/\/{2,}/g, "/");
+}
+function uniquePaths(values = []) {
+    return [...new Set(values.map(normalizeDeployPath))].sort();
+}
+export function resolveDeploy(request) {
+    if (request.trigger !== "cms" || request.forceFull) {
+        return { mode: "full", paths: [], deletedPaths: [] };
+    }
+    const baseline = request.baseline;
+    if (!baseline
+        || baseline.environment !== request.environment
+        || baseline.fingerprint !== request.fingerprint
+        || !baseline.artifactId) {
+        throw new Error(`No compatible successful baseline for ${request.environment}/${request.fingerprint}.`);
+    }
+    return {
+        mode: "partial",
+        paths: uniquePaths(request.paths),
+        deletedPaths: uniquePaths(request.deletedPaths),
+        baseline
+    };
+}
+export function assertNoOutputCollisions(entries) {
+    const normalized = entries.map(normalizeDeployPath);
+    const seen = new Set();
+    for (const entry of normalized) {
+        const key = entry.toLocaleLowerCase("en-US");
+        if (seen.has(key))
+            throw new Error(`Build output collision: ${entry}`);
+        seen.add(key);
+    }
+}
+export function mergeBuildEntries(baseline, partial, deletedPaths = []) {
+    assertNoOutputCollisions(baseline.map(({ path }) => path));
+    assertNoOutputCollisions(partial.map(({ path }) => path));
+    const deleted = new Set(uniquePaths(deletedPaths).map((path) => path.toLowerCase()));
+    const merged = new Map();
+    for (const entry of baseline) {
+        const path = normalizeDeployPath(entry.path);
+        if (!deleted.has(path.toLowerCase())) {
+            merged.set(path.toLowerCase(), { ...entry, path });
+        }
+    }
+    for (const entry of partial) {
+        const path = normalizeDeployPath(entry.path);
+        const key = path.toLowerCase();
+        const existing = merged.get(key);
+        if (existing && existing.path !== path) {
+            throw new Error(`Build output collision: ${existing.path} / ${path}`);
+        }
+        merged.set(key, { ...entry, path });
+    }
+    return [...merged.values()].sort((a, b) => a.path.localeCompare(b.path));
+}
+export function buildSitemapXml(paths, siteUrl) {
+    const origin = new URL(siteUrl);
+    if (!["http:", "https:"].includes(origin.protocol)) {
+        throw new Error("Sitemap site URL must use HTTP or HTTPS.");
+    }
+    const locations = uniquePaths(paths)
+        .filter((path) => !path.startsWith("/404"))
+        .map((path) => new URL(path, origin).toString());
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+        ...locations.map((location) => `  <url><loc>${escapeXml(location)}</loc></url>`),
+        "</urlset>",
+        ""
+    ].join("\n");
+}
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+export function assertAstroKey(requiresAstroKey, environment) {
+    if (requiresAstroKey && !environment.ASTRO_KEY?.trim()) {
+        throw new Error("ASTRO_KEY is required for this content batch.");
+    }
+}
+export function cloudflareTargetForEnvironment(environment) {
+    return environment === "dev" ? "workers" : "pages";
+}
+export async function deployQueueBatch(batch, lifecycle) {
+    try {
+        const result = await lifecycle.deploy();
+        await lifecycle.smokeTest(result);
+        await lifecycle.acknowledge(batch.id);
+        return result;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        try {
+            await lifecycle.release(batch.id, reason);
+        }
+        catch (releaseError) {
+            throw new AggregateError([error, releaseError], `Deploy failed and queue batch ${batch.id} could not be released.`);
+        }
+        throw error;
+    }
+}
+export function validateCloudflareRoutes(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        throw new Error("Cloudflare routes must be an object.");
+    }
+    const routes = input;
+    for (const [key, value] of Object.entries({
+        include: routes.include,
+        exclude: routes.exclude
+    })) {
+        if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+            throw new Error(`Cloudflare routes ${key} must be a string array.`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/flowpress-deploy.php

@@ -0,0 +1,25 @@
+<?php
+/**
+ * Plugin Name: FlowPress Deploy
+ * Description: Installable deployment capability for FlowPress.
+ * Version: 0.1.0-beta.0
+ */
+
+if (! defined('ABSPATH')) {
+    exit;
+}
+
+add_action('muplugins_loaded', static function (): void {
+    if (! function_exists('flowpress_register_feature')) {
+        return;
+    }
+    flowpress_register_feature('deploy', [
+        'version' => '0.1.0-beta.0',
+        'capabilities' => ['full-build', 'partial-build', 'build-callback'],
+        'config' => [
+            'targets' => function_exists('flowpress_static_targets')
+                ? flowpress_static_targets()
+                : [],
+        ],
+    ]);
+}, 120);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@styleflow.app/flowpress-deploy",
+  "version": "0.1.0-beta.0",
+  "description": "Safe full and partial deployment primitives for FlowPress.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/StyleFlow-App/flowpress-deploy.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "flowpress-deploy.php", "composer.json", "README.md", "CHANGELOG.md"],
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --pretty false",
+    "test": "vitest run",
+    "release:check": "npm run typecheck && npm test && npm pack --dry-run",
+    "release:publish:next": "npm publish --access public --tag next",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {"node": ">=22.0.0"},
+  "packageManager": "npm@10.9.3"
+}