@zinn-digital/sdk 0.1.1433 → 0.1.1435

package/dist/generated/schema.d.ts

@@ -18306,7 +18306,7 @@ export interface paths {
         };
         /**
          * The connected Google Ads account's whole structure as last read (za-262).
-         * @description Gated on `ads.view`. Read on Temporal when the account is connected, on Refresh and weekly by the daily audit — never Google in the request. `state` is `notRead` until the first read, `ok` with `import`, or `failed` with `error` (a failed read never shows old figures as current). `import` carries the account's campaigns (status, channel, daily budget in micros, shared budget, bid strategy and its target, Google's bidding-strategy status, ad groups, keywords by match type, ads, negatives, location targets), its conversion actions and totals. Read only: nothing is written to the account. A connection on another network is a `422` `refusal.adsconnect.platformNotSupported`. `history` (za-263) is the account's OWN history read back month by month to the retention edge (400 days) after the first read — `null` until it starts; its figures are the ad-group totals now stored.
+         * @description Gated on `ads.view`. Read on Temporal when the account is connected, on Refresh and weekly by the daily audit — never Google in the request. `state` is `notRead` until the first read, `ok` with `import`, or `failed` with `error` (a failed read never shows old figures as current). `import` carries the account's campaigns (status, channel, daily budget in micros, shared budget, bid strategy and its target, Google's bidding-strategy status, ad groups, keywords by match type, ads, negatives, location targets), its conversion actions and totals. Read only: nothing is written to the account. A connection on another network is a `422` `refusal.adsconnect.platformNotSupported`. `history` (za-263) is the account's OWN history read back month by month to the retention edge (400 days) after the first read — `null` until it starts; its figures are the ad-group totals now stored. `plan` (za-265) is the optimisation plan built from that history once it is read (and at most weekly after) — `null` until then: what WORKS (kept and protected from automatic pauses), the measured waste and the structural steps, every write a PENDING change in the approvals queue (`change_id`), never applied by itself.
          */
         get: operations["getAdsImportedAccount"];
         put?: never;
@@ -25625,6 +25625,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/bulk-site-imports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Add many sites — one per valid row of a file.
+         * @description Re-checks the file exactly as the preview does and enrols every VALID row as an item of a `site_create` bulk job; invalid rows are left out (the preview named them). Each row is then created through the same path as `POST /v1/sites`, so the site-slot quota, plan allowances and hostname rules apply per row. Refused with a `422` before anything is written when no row is valid or the file cannot be read; rows past the plan's room are flagged by the check and not enrolled. One durable job with bounded concurrency and no row cap: the bound is the quota. Follow progress with `GET /v1/bulk-jobs/{bulkJobId}`. Requires `sites.create`.
+         */
+        post: operations["createBulkSiteImport"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/bulk-site-imports/preview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Check every row of a site file before anything is created.
+         * @description Parses the rows (CSV; comma, semicolon or tab; a header row naming the columns, or no header and the columns in the template's order, so a pasted list of domains works) over the batch `defaults`, and answers per row what is wrong with it, by column: field validation by the one-site create path's own rules, an unknown site type, an unknown CDN, an own CDN account that is not connected (or not acknowledged on a platform-managed line), duplicates inside the file, a domain that is already one of the account's sites, and rows past the plan's remaining site slots. Nothing is written. A file that cannot be read at all comes back as `file_error` with a `200`, so the screen can say why. ⛔ `POST` for a read: a file does not fit in a query string. Requires `sites.create`.
+         */
+        post: operations["previewBulkSiteImport"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/bulk-site-imports/template": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * The columns, allowed values and example file for Add many sites.
+         * @description s1014 BULKUPLOAD. The single source of the upload format: the deploy form's "Many sites" mode renders its "Download example CSV" button and its instructions table from this, so the example file is by construction one the importer accepts. Requires `sites.create`.
+         */
+        get: operations["getBulkSiteImportTemplate"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/campaigns": {
         parameters: {
             query?: never;
@@ -64655,6 +64715,76 @@ export interface components {
             /** Format: date */
             window_start: string | null;
         };
+        /** @description za-265: the imported account's plan from its own history. `state` is `ok`, `notEnoughHistory` or `noConversions` (no waste is judged on a thin or conversion-less history — `decided_by` carries the counts and the bars that decided it) or `paused` (the org is not in good standing). Money in integer micros; conversions in thousandths. */
+        AdsImportedPlan: {
+            /** Format: date-time */
+            built_at: string;
+            decided_by?: {
+                /** Format: int64 */
+                account_cpa_micros?: number;
+                /** Format: int64 */
+                clicks?: number;
+                /** Format: int64 */
+                conversions_milli?: number;
+                /** Format: int64 */
+                cost_micros?: number;
+                days_with_data?: number;
+                min_clicks?: number;
+                min_days?: number;
+            };
+            keep?: {
+                campaigns?: ({
+                    campaign_id?: string;
+                    name?: string;
+                } & components["schemas"]["AdsImportedPlanFigures"])[];
+                countries?: ({
+                    country?: string;
+                } & components["schemas"]["AdsImportedPlanFigures"])[];
+                keywords?: ({
+                    campaign?: string;
+                    keyword?: string;
+                    resource?: string;
+                } & components["schemas"]["AdsImportedPlanFigures"])[];
+            };
+            /** @enum {string} */
+            state: "ok" | "notEnoughHistory" | "noConversions" | "paused";
+            structural?: components["schemas"]["AdsImportedPlanItem"][];
+            waste?: components["schemas"]["AdsImportedPlanItem"][];
+        };
+        AdsImportedPlanFigures: {
+            /** Format: int64 */
+            clicks?: number;
+            /** Format: int64 */
+            conversions_milli?: number;
+            /** Format: int64 */
+            cost_micros?: number;
+        };
+        /** @description One plan item. `kind`: `searchNegative` (an EXACT negative for `term` on `campaigns`), `keywordPause` (`keyword`, `resource`), `countryExclude` (`country`, ISO 3166-1 alpha-2, with `expected_conversions` at the account's own rate), `bidForConversions` (`campaign_id`, `campaign`, `from`, `conversions_30d`, `need` — the bid-ladder rung), `sharedBudget` (`budget`, `campaigns` — a person's step) or `noConversionAction`. A write carries the pending change it queued (`change_id`, `change_status`). */
+        AdsImportedPlanItem: {
+            budget?: string;
+            campaign?: string;
+            campaign_id?: string;
+            campaigns?: string[];
+            /** Format: uuid */
+            change_id?: string;
+            change_status?: string;
+            /** Format: int64 */
+            clicks?: number;
+            conversions_30d?: number;
+            /** Format: int64 */
+            conversions_milli?: number;
+            /** Format: int64 */
+            cost_micros?: number;
+            country?: string;
+            expected_conversions?: number;
+            from?: string;
+            keyword?: string;
+            /** @enum {string} */
+            kind: "searchNegative" | "keywordPause" | "countryExclude" | "bidForConversions" | "sharedBudget" | "noConversionAction";
+            need?: number;
+            resource?: string;
+            term?: string;
+        };
         /** @description One reading of an account, or null before its first audit. `figures` depends on `kind` (docs/1006 §30): money is integer minor units (`*_minor`) or micros (`*_micros`) of the account's currency, never a float; missed clicks and conversions are estimates. */
         AdsInsightReading: {
             /** Format: date */
@@ -72104,7 +72234,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" | "file_missing" | "file_not_regular" | "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" | "domain_taken" | "domain_probe_budget" | "create_refused" | "invalid_row" | "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. */
@@ -72223,8 +72353,12 @@ export interface components {
             error_code: components["schemas"]["BulkErrorCode"] | null;
             /** @description For a `find_file` or `delete_file` item that succeeded: the file's size and last modified time. `null` for every other item, and for a file item written before these facts were recorded. */
             file: components["schemas"]["BulkJobItemFile"] | null;
+            /** @description `site_create` only: the one-site create path's own keyed refusal for a refused row (domain taken, no site slot, product line not allowed), rendered by the client in the reader's language. `null` otherwise. The row's create payload is never echoed. */
+            refusal?: components["schemas"]["Refusal"] | null;
             /** @description Whether `retry-failed` would reopen this item: every `failed` item, and every `skipped` item whose code is not a final answer. A search that found no such file (`file_missing`, `file_not_regular`) has answered and is not retried. Count these to label a retry control; do not re-derive the rule from `status`. */
             retryable: boolean;
+            /** @description `site_create` (Add many sites) only: the row's line in the uploaded file, the header being line 1, so the report says "line 14" in the customer's own terms. `null` for every other operation. Until the row's site exists, `site_id` is a placeholder. */
+            row?: number | null;
             /** Format: date-time */
             settled_at: string | null;
             /** @description Carried on the row rather than joined, so the report survives the site being deleted mid-job — which, on a long run, is not hypothetical. */
@@ -72446,7 +72580,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" | "find_file" | "delete_file";
+        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" | "site_create";
         /** @description The outcome of restoring every restorable site for one org. */
         BulkRestoreResult: {
             /** @description Each site that could not be restored, with the reason code. */
@@ -72469,6 +72603,93 @@ export interface components {
          * @enum {string}
          */
         BulkSelector: "sites" | "product_line" | "org" | "group" | "filter";
+        /** @description "Settings for all sites": any of these `SiteCreate` fields, applied to every row that leaves the matching column blank. A row naming its own `site_type` drops the batch's stack-specific choices (blueprint, application, PHP, theme, plugins). `footprint_acknowledged` is the shared-footprint warning accepted for own-CDN rows on a platform-managed line. Any other key is ignored. */
+        BulkSiteImportDefaults: {
+            application?: string;
+            /** @enum {string} */
+            canonical_host?: "apex" | "www";
+            cdn_account_id?: string;
+            cdn_tier?: string;
+            cdn_vendor?: string;
+            create_mailbox?: boolean;
+            deploy_target?: string;
+            dns_vendor?: string;
+            footprint_acknowledged?: boolean;
+            force_https?: boolean;
+            php_version?: string;
+            plugins?: string[];
+            random_theme?: boolean;
+            region?: string;
+            site_blueprint_id?: components["schemas"]["Uuid"];
+            source?: string;
+            stack_type?: string;
+            subscription_id?: components["schemas"]["Uuid"];
+            theme?: string;
+            use_own_dns?: boolean;
+        } & {
+            [key: string]: unknown;
+        };
+        BulkSiteImportPreview: {
+            /** @enum {string|null} */
+            file_error: "file_empty" | "file_too_large" | "no_rows" | null;
+            invalid: number;
+            quota: {
+                enough: boolean;
+                product_line: string;
+                /** @description `null` = unlimited. */
+                remaining: number | null;
+                rows: number;
+            }[];
+            rows: {
+                /** @description The row's CDN vendor, `own` for the customer's own account, or empty for the line default. */
+                cdn: string;
+                domain: string;
+                errors: components["schemas"]["BulkSiteImportRowError"][];
+                name: string;
+                product_line: string;
+                row: number;
+                site_type: string;
+                title?: string;
+            }[];
+            total: number;
+            valid: number;
+        };
+        BulkSiteImportRequest: {
+            /** @description The rows' text. Comma, semicolon or tab separated; the first line is the header when it names a `domain` column, otherwise every line is a row in the template's order. */
+            csv: string;
+            defaults?: components["schemas"]["BulkSiteImportDefaults"];
+            note?: string;
+            /** @description The account the sites belong to. Optional when you reach exactly one. */
+            org_id?: components["schemas"]["Uuid"] | null;
+            /** @description The product line every row is created on (the deploy form's line). */
+            product_line?: string;
+        };
+        BulkSiteImportRowError: {
+            /** @enum {string} */
+            code: "domain_missing" | "domain_invalid" | "domain_duplicate" | "domain_exists" | "site_type_missing" | "unknown_site_type" | "unknown_cdn" | "cdn_account_missing" | "cdn_account_not_connected" | "cdn_needs_acknowledgement" | "title_needs_wordpress" | "invalid_value" | "over_plan_limit";
+            column: string;
+        };
+        BulkSiteImportTemplate: {
+            /** @description The `cdn` value meaning "my own connected CDN account" (named in `cdn_account`). */
+            cdn_own_value?: string;
+            columns: {
+                allowed: string[];
+                example: string;
+                name: string;
+                required: boolean;
+            }[];
+            example_csv: string;
+            max_file_bytes: number;
+        };
+        BulkSiteImportUpload: {
+            /** @description `BulkSiteImportDefaults` as a JSON string. */
+            defaults?: string;
+            /** Format: binary */
+            file: string;
+            note?: string;
+            org_id?: components["schemas"]["Uuid"];
+            product_line?: string;
+        };
         BulkVendorOperationRequest: {
             /**
              * @description Which platform operation to run. ⛔ A closed set, not a passthrough — a client cannot name an upstream path. `block_country` and `delete` are deliberately absent and answer `422` with the reason if asked for.
@@ -99560,6 +99781,8 @@ export interface components {
              * @example bunny_dns
              */
             dns_vendor?: string;
+            /** @description Omitted means `false`. The customer accepted the shared-footprint warning for their own CDN account on a platform-managed line (Footprint-Free). With it, `cdn_tier: byo` plus a named `cdn_account_id` is accepted at create on that line; without it, refused (`422`). */
+            footprint_acknowledged?: boolean;
             /** @description Redirect http to https at the edge. **Omitted means `true`** — the insecure choice has to be asked for and is never reached by leaving the field out. */
             force_https?: boolean;
             /** @example Acme Marketing Site */
@@ -141112,6 +141335,7 @@ export interface operations {
                             error: string | null;
                             history: components["schemas"]["AdsImportedHistory"] | null;
                             import: components["schemas"]["AdsImportedAccount"] | null;
+                            plan: components["schemas"]["AdsImportedPlan"] | null;
                             /** Format: date-time */
                             read_at: string | null;
                             /** @enum {string} */
@@ -154168,6 +154392,86 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    createBulkSiteImport: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkSiteImportRequest"];
+                "multipart/form-data": components["schemas"]["BulkSiteImportUpload"];
+            };
+        };
+        responses: {
+            /** @description The job was created and is running. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BulkJob"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            409: components["responses"]["Conflict"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    previewBulkSiteImport: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkSiteImportRequest"];
+                "multipart/form-data": components["schemas"]["BulkSiteImportUpload"];
+            };
+        };
+        responses: {
+            /** @description Every row and what is wrong with it. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BulkSiteImportPreview"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            422: components["responses"]["UnprocessableEntity"];
+        };
+    };
+    getBulkSiteImportTemplate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The upload format. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BulkSiteImportTemplate"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
     listCampaigns: {
         parameters: {
             query?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinn-digital/sdk",
-  "version": "0.1.1433",
+  "version": "0.1.1435",
   "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>",