run402 4.109.0 → 4.109.1

package/sdk/dist/namespaces/site-removal-summary.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Client-side breakdown of the paths a `DESTRUCTIVE_SITE_BULK_REMOVAL`
+ * warning lists in `affected`.
+ *
+ * The gateway counts every removed static path toward its bulk-removal
+ * threshold. A framework rebuild renames every content-hashed bundle
+ * (`_astro/Foo.Ds5BwtTY.js` → `_astro/Foo.<newhash>.js`), so a routine
+ * redeploy can trip the warning without removing a single page. This
+ * summary lets a reviewer tell the two cases apart without diffing
+ * releases by hand. It is a heuristic and never changes whether the
+ * warning blocks; the gateway stays authoritative.
+ */
+import type { WarningEntry } from "./deploy.types.js";
+export declare const SITE_BULK_REMOVAL_WARNING_CODE = "DESTRUCTIVE_SITE_BULK_REMOVAL";
+export interface SiteRemovalSummary {
+    /** Number of removed paths the warning listed. */
+    total: number;
+    /** Removed `.html` / `.htm` files — pages that stop being served. */
+    pages: number;
+    /** Removed files whose name carries a build content hash (bundler output). */
+    content_hashed_build_assets: number;
+    /** Removed files that are neither pages nor content-hashed build assets. */
+    other: number;
+    /** True when every removed path is a content-hashed build asset. */
+    only_content_hashed_build_assets: boolean;
+    /** Removed path count per top-level directory (`"."` for root files). */
+    by_top_level_dir: Record<string, number>;
+    /** Up to 20 removed page paths. */
+    page_paths: string[];
+    /** Up to 20 removed paths that are neither pages nor hashed assets. */
+    other_paths: string[];
+    confidence: "heuristic";
+}
+/**
+ * A content hash is a `.`- or `-`-separated basename segment of at least
+ * eight `[A-Za-z0-9_]` characters that contains a digit or mixes upper
+ * and lower case (`Ds5BwtTY`, `CzEebLVq`, `a3f9c2e1`). Plain words such as
+ * `component` or `profile` do not qualify.
+ */
+export declare function isContentHashedPath(path: string): boolean;
+export declare function summarizeSiteRemoval(paths: readonly string[]): SiteRemovalSummary;
+/**
+ * Adds `details.removed_paths_summary` to each bulk-removal warning that
+ * lists its paths and does not already carry a summary. Other warnings
+ * pass through untouched.
+ */
+export declare function withSiteRemovalSummaries(warnings: WarningEntry[]): WarningEntry[];
+//# sourceMappingURL=site-removal-summary.d.ts.map

package/sdk/dist/namespaces/site-removal-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-removal-summary.d.ts","sourceRoot":"","sources":["../../src/namespaces/site-removal-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,8BAA8B,kCAAkC,CAAC;AAK9E,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,2BAA2B,EAAE,MAAM,CAAC;IACpC,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,gCAAgC,EAAE,OAAO,CAAC;IAC1C,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,mCAAmC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uEAAuE;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,WAAW,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWzD;AAYD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CA+BjF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAgBjF"}

package/sdk/dist/namespaces/site-removal-summary.js

@@ -0,0 +1,107 @@
+/**
+ * Client-side breakdown of the paths a `DESTRUCTIVE_SITE_BULK_REMOVAL`
+ * warning lists in `affected`.
+ *
+ * The gateway counts every removed static path toward its bulk-removal
+ * threshold. A framework rebuild renames every content-hashed bundle
+ * (`_astro/Foo.Ds5BwtTY.js` → `_astro/Foo.<newhash>.js`), so a routine
+ * redeploy can trip the warning without removing a single page. This
+ * summary lets a reviewer tell the two cases apart without diffing
+ * releases by hand. It is a heuristic and never changes whether the
+ * warning blocks; the gateway stays authoritative.
+ */
+export const SITE_BULK_REMOVAL_WARNING_CODE = "DESTRUCTIVE_SITE_BULK_REMOVAL";
+const PAGE_PATH_SAMPLE_LIMIT = 20;
+const OTHER_PATH_SAMPLE_LIMIT = 20;
+/**
+ * A content hash is a `.`- or `-`-separated basename segment of at least
+ * eight `[A-Za-z0-9_]` characters that contains a digit or mixes upper
+ * and lower case (`Ds5BwtTY`, `CzEebLVq`, `a3f9c2e1`). Plain words such as
+ * `component` or `profile` do not qualify.
+ */
+export function isContentHashedPath(path) {
+    const base = path.slice(path.lastIndexOf("/") + 1);
+    const dot = base.lastIndexOf(".");
+    if (dot <= 0)
+        return false;
+    const stem = base.slice(0, dot);
+    if (/\.html?$/i.test(base))
+        return false;
+    for (const segment of stem.split(/[.-]/).slice(1)) {
+        if (!/^[A-Za-z0-9_]{8,}$/.test(segment))
+            continue;
+        if (/\d/.test(segment) || (/[a-z]/.test(segment) && /[A-Z]/.test(segment)))
+            return true;
+    }
+    return false;
+}
+function isPagePath(path) {
+    return /\.html?$/i.test(path);
+}
+function topLevelDir(path) {
+    const trimmed = path.replace(/^\/+/, "");
+    const slash = trimmed.indexOf("/");
+    return slash === -1 ? "." : trimmed.slice(0, slash);
+}
+export function summarizeSiteRemoval(paths) {
+    const byDir = {};
+    const pagePaths = [];
+    const otherPaths = [];
+    let pages = 0;
+    let hashed = 0;
+    let other = 0;
+    for (const path of paths) {
+        const dir = topLevelDir(path);
+        byDir[dir] = (byDir[dir] ?? 0) + 1;
+        if (isPagePath(path)) {
+            pages += 1;
+            if (pagePaths.length < PAGE_PATH_SAMPLE_LIMIT)
+                pagePaths.push(path);
+        }
+        else if (isContentHashedPath(path)) {
+            hashed += 1;
+        }
+        else {
+            other += 1;
+            if (otherPaths.length < OTHER_PATH_SAMPLE_LIMIT)
+                otherPaths.push(path);
+        }
+    }
+    return {
+        total: paths.length,
+        pages,
+        content_hashed_build_assets: hashed,
+        other,
+        only_content_hashed_build_assets: paths.length > 0 && hashed === paths.length,
+        by_top_level_dir: byDir,
+        page_paths: pagePaths,
+        other_paths: otherPaths,
+        confidence: "heuristic",
+    };
+}
+/**
+ * Adds `details.removed_paths_summary` to each bulk-removal warning that
+ * lists its paths and does not already carry a summary. Other warnings
+ * pass through untouched.
+ */
+export function withSiteRemovalSummaries(warnings) {
+    let changed = false;
+    const next = warnings.map((warning) => {
+        if (warning?.code !== SITE_BULK_REMOVAL_WARNING_CODE)
+            return warning;
+        if (!Array.isArray(warning.affected) || warning.affected.length === 0)
+            return warning;
+        if (warning.details && "removed_paths_summary" in warning.details)
+            return warning;
+        changed = true;
+        return {
+            ...warning,
+            details: {
+                ...(warning.details ?? {}),
+                removed_paths_summary: summarizeSiteRemoval(warning.affected.filter((p) => typeof p === "string")),
+            },
+        };
+    });
+    return changed ? next : warnings;
+}
+//# sourceMappingURL=site-removal-summary.js.map

package/sdk/dist/namespaces/site-removal-summary.js.map

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

package/vault-surface.json

@@ -1,5 +1,5 @@
 {
-  "surface_version": "4.109.0",
+  "surface_version": "4.109.1",
   "verbs": [
     "repos create",
     "repos list",