@zinn-digital/sdk 0.1.1355 → 0.1.1357

package/dist/generated/schema.d.ts

@@ -48448,6 +48448,29 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/sites/{siteId}/install-progress": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Site ID (UUIDv7). */
+                siteId: components["parameters"]["SiteId"];
+            };
+            cookie?: never;
+        };
+        /**
+         * The installing screen's live stage, measured timing and Retry validity.
+         * @description Row 45 (s1014, owner 2026-10-29). `install` is the same answer `retrySiteProvisioning` enforces; `step` is the running workflow's own progress answer, asked only while the site is installing and `null` when it cannot be asked (a Temporal fault degrades the field, never the response). Requires `sites.view`.
+         */
+        get: operations["getSiteInstallProgress"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/sites/{siteId}/mail-smtp": {
         parameters: {
             query?: never;
@@ -50060,6 +50083,8 @@ export interface paths {
          *     ⛔ Nothing here calls Temporal (§2.9). The status change and a `site.created` event commit in one transaction and the existing consumer starts the workflow, so a Temporal outage cannot leave the row half-moved.
          *
          *     A site that is `active`, `deleting` or `deleted` is a `422` — a retry re-runs the build, and those are past it. Requires `sites.view` and `hosting.deploy.manage`.
+         *
+         *     **Row 45 (s1014).** A `provisioning` site past its measured p90 is STALLED: Retry terminates the old run and starts afresh (row-locked, so a double press starts one workflow; the second answers `refusal: in_flight`). A `failed` site is refused with `422` (`refusal.sites.retryCoolingDown`) for 3 minutes after the failure, and (`refusal.sites.retryNotInGoodStanding`) when the account is not in good standing - exactly when `Site.install.retry.enabled` is `false`.
          */
         post: operations["retrySiteProvisioning"];
         delete?: never;
@@ -69482,7 +69507,7 @@ export interface components {
          * @example unsupported_platform
          * @enum {string}
          */
-        BulkErrorCode: "not_wordpress" | "not_serving" | "unsupported_platform" | "capability_denied" | "not_installed" | "unknown_blueprint" | "site_missing" | "driver_unresolved" | "vendor_refused" | "install_failed" | "not_in_good_standing" | "already_deleted" | "not_php" | "no_cdn" | "needs_addon" | "refused" | "unknown";
+        BulkErrorCode: "not_wordpress" | "not_serving" | "unsupported_platform" | "capability_denied" | "not_installed" | "unknown_blueprint" | "site_missing" | "driver_unresolved" | "vendor_refused" | "install_failed" | "not_in_good_standing" | "already_deleted" | "not_php" | "no_cdn" | "needs_addon" | "refused" | "file_missing" | "file_not_regular" | "unknown";
         /** @description One plugin, and how far it reaches across the sites that were read. */
         BulkInstalledPlugin: {
             /** @description How many have it switched on. Carried separately rather than derived: *"active on 3 of the 9 that have it"* is the sentence somebody about to press **Deactivate** needs, and it cannot be recovered from one number. */
@@ -69643,6 +69668,11 @@ export interface components {
              * @enum {string}
              */
             mode?: "off" | "allow" | "block";
+            /**
+             * @description `find_file` and `delete_file` only. One exact path inside each site's document root (`wp-content/uploads/old.php`); a leading `/` means the same. Refused, never sanitised: wildcards, `..`, a part starting with `-`, control characters. Only a regular file is touched — never a folder or a link — and only inside the root. `delete_file` also refuses WordPress core and config files; a deleted file is kept in an archive on the server for 30 days.
+             * @example wp-content/uploads/old.php
+             */
+            path?: string;
             /** @description `wp_auto_updates` only. Plugin automatic updates on or off. */
             plugins?: boolean;
             /**
@@ -69801,7 +69831,7 @@ export interface components {
          * @example plugin_install
          * @enum {string}
          */
-        BulkOperation: "stack_apply" | "blueprint_apply" | "application_install" | "plugin_install" | "plugin_activate" | "plugin_deactivate" | "plugin_remove" | "plugin_update" | "theme_install" | "core_update" | "wp_search_replace" | "featured_image_backfill" | "wp_auto_updates" | "site_delete" | "php_version" | "force_https" | "canonical_www" | "country_lock" | "cdn_purge" | "malware_scan" | "malware_clean";
+        BulkOperation: "stack_apply" | "blueprint_apply" | "application_install" | "plugin_install" | "plugin_activate" | "plugin_deactivate" | "plugin_remove" | "plugin_update" | "theme_install" | "core_update" | "wp_search_replace" | "featured_image_backfill" | "wp_auto_updates" | "site_delete" | "php_version" | "force_https" | "canonical_www" | "country_lock" | "cdn_purge" | "malware_scan" | "malware_clean" | "find_file" | "delete_file";
         /** @description The outcome of restoring every restorable site for one org. */
         BulkRestoreResult: {
             /** @description Each site that could not be restored, with the reason code. */
@@ -95148,6 +95178,8 @@ export interface components {
              */
             failed_step?: string;
             id: components["schemas"]["Uuid"];
+            /** @description Row 45 (s1014, owner 2026-10-29): what the installing screen may honestly say, and whether Retry is valid - the same answer `retrySiteProvisioning` enforces. `null` unless the site is `pending`, `provisioning` or `failed`. */
+            install?: components["schemas"]["SiteInstallState"] | null;
             /**
              * @description Human label for the site; defaults to the primary domain.
              * @example Acme Marketing Site
@@ -97834,6 +97866,40 @@ export interface components {
          * @enum {string}
          */
         SiteImportStatus: "pending" | "indexing" | "fetching" | "building" | "deploying" | "verifying" | "completed" | "failed" | "cancelled";
+        /** @description The installing screen's one read (row 45). */
+        SiteInstallProgress: {
+            install: components["schemas"]["SiteInstallState"];
+            /** Format: uuid */
+            site_id: string;
+            status: string;
+            /** @description The running workflow's own stage key (`begin`, `placement`, `account`, `blueprint`, `cdn`, `dns`, `verify`, `activate`, `rollback`), or `null` when it could not be asked - unknown, never zero (ADR 0023). */
+            step: string | null;
+            steps_done: number | null;
+            steps_total: number | null;
+        };
+        /** @description Row 45 (s1014): the installing screen's honest state. `stalled` means past the measured p90 for this application (never under 5 minutes) with no end; Retry then restarts it. Retry is HIDDEN while running normally and after success; SHOWN but disabled (`enabled: false` with a `reason`) during the 3-minute cool-down after a failure and when the account is not in good standing. */
+        SiteInstallState: {
+            elapsed_seconds: number;
+            /** @description Median of the last 200 finished installs of this application on this location, measured ESTATE-WIDE (durations only, no tenant data), so every org reads the same figure; falls back to the application on any location, then every install. */
+            p50_seconds: number;
+            p90_seconds: number;
+            retry: {
+                enabled: boolean;
+                /** @enum {string|null} */
+                reason: "running" | "done" | "cooldown" | "not_in_good_standing" | "not_retryable" | null;
+                /** Format: date-time */
+                retry_after: string | null;
+                visible: boolean;
+            };
+            /** @description `true` only while the run is still going AND staff were really paged about it (the hung-install page fires once at the later of p90 and 12 minutes). The screen says "our team has been alerted" only when this is `true`; past p90 alone is not a page. */
+            staff_alerted: boolean;
+            /** Format: date-time */
+            started_at: string | null;
+            /** @enum {string} */
+            state: "running" | "stalled" | "failed" | "done" | "other";
+            /** @description How many runs the percentiles were read from; `0` means the fallback. */
+            timing_samples: number;
+        };
         SiteIntegrityFinding: {
             /** @description Staff only. */
             actor?: string;
@@ -99673,6 +99739,11 @@ export interface components {
         };
         /** @description The outcome of asking for a failed site to be built again. */
         SiteProvisioningRetry: {
+            /**
+             * @description Why nothing was restarted, as a machine key: `in_flight` when a build is already running (a second press while one is in flight is never a second workflow). `null` when `restarted` is `true`.
+             * @enum {string|null}
+             */
+            refusal?: "in_flight" | null;
             /**
              * @description `true` when this call moved the row and queued a build; `false` when the site was **already** provisioning, which is a success and not a conflict.
              *
@@ -187551,6 +187622,33 @@ export interface operations {
             404: components["responses"]["NotFound"];
         };
     };
+    getSiteInstallProgress: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Site ID (UUIDv7). */
+                siteId: components["parameters"]["SiteId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The site's install progress. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SiteInstallProgress"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     getSiteMailSmtp: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinn-digital/sdk",
-  "version": "0.1.1355",
+  "version": "0.1.1357",
   "description": "Typed TypeScript client for the Zinn Digital Platform API, generated from its OpenAPI spec.",
   "license": "MIT",
   "author": "Neil Lock \u2014 CEO, Zinn Digital\u00ae Ltd <office@zinndigital.com>",