@zinn-digital/sdk 0.1.1378 → 0.1.1381

package/dist/generated/schema.d.ts

@@ -19752,6 +19752,114 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/ads/report/pdf": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * One client's white-label advertising report as a PDF (za-200).
+         * @description Gated on `ads.view`. The same document a scheduled report e-mails: the client organisation's figures (and its sub-organisations') over the last `days` days, under the brand that organisation renders under (the agency's white label), in `locale` (any of the 58 platform languages; Arabic and Hebrew right to left). Stored rows only. Throttled per caller (`ads_report_render`, 300 per hour) on top of the account limits.
+         */
+        get: operations["getAdsReportPdf"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/ads/report/rows": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Daily campaign rows for Looker Studio (za-200).
+         * @description Gated on `ads.view`. One row per day, ad account and campaign over `start`..`end` (inclusive, at most 400 days) for the organisations the caller may view; `org_id` narrows to that organisation and its clients. Built for the Zinn® Ads Looker Studio community connector, which authenticates with an API key minted on ONE client organisation with only the `ads.view` scope, so the key reads that client and nothing else. Spend and value are integer micros of the account currency (`currency` on every row); conversions are thousandths. Paged: follow `next_offset` until it is `null`. Stored rows only - never a network call in the request.
+         */
+        get: operations["listAdsReportRows"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/ads/report/schedules": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * The scheduled white-label PDF reports (za-200).
+         * @description Gated on `ads.view`. Every schedule in the organisations the caller may view; `org_id` narrows to that organisation and its clients.
+         */
+        get: operations["listAdsReportSchedules"];
+        put?: never;
+        /**
+         * Create or replace a client's weekly or monthly PDF report (za-200).
+         * @description Gated on `ads.manage`; audit action `ads.report_schedule.save`. One schedule per client organisation and cadence: posting the same cadence again replaces it (200), a new one answers 201. Weekly reports are sent on Monday at 06:00 UTC, monthly ones on the 1st at 06:00 UTC, by a Temporal workflow. A bad field answers `422 badLimit` naming it.
+         */
+        post: operations["saveAdsReportSchedule"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/ads/report/schedules/{schedule_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Stop and remove a scheduled report (za-200).
+         * @description Gated on `ads.manage`; audit action `ads.report_schedule.delete`.
+         */
+        delete: operations["deleteAdsReportSchedule"];
+        options?: never;
+        head?: never;
+        /**
+         * Change a scheduled report's recipients, language, window or on/off (za-200).
+         * @description Gated on `ads.manage`; audit action `ads.report_schedule.save`.
+         */
+        patch: operations["updateAdsReportSchedule"];
+        trace?: never;
+    };
+    "/v1/ads/report/schedules/{schedule_id}/send": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * E-mail this period's report now, without moving the schedule (za-200).
+         * @description Gated on `ads.manage`; audit action `ads.report_schedule.send`. Refused with `422 notInGoodStanding` when the paying organisation is not in good standing. Throttled per caller (`ads_report_send`, 300 per hour) on top of the account limits.
+         */
+        post: operations["sendAdsReportScheduleNow"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/ads/shield": {
         parameters: {
             query?: never;
@@ -40261,6 +40369,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/public/aged-domains": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * The aged domains on sale, filtered, sorted and paged, every row masked (public).
+         * @description MKTDOMAINS (owner 2026-11-02) — what zinndigital.com/marketplace/domains renders: the same stock, filters and sort as `listAgedDomains`, for a visitor who is not signed in. ⛔ No domain is NAMED — each row carries `masked_domain` and the `id` the app's detail page (`getAgedDomain`, signed in) opens; that page runs the live check and the checkout (docs/1107 §3, §5). `q` matches the description only and `sort=domain` falls back to `-dr`, so the name cannot be recovered a letter at a time. Filters: `q`, `tld`, `language`, `category`, `min_`/`max_` for `dr`, `da`, `tf`, `cf`, `rd`, `uniques`, `added_year` and `price` (USD), flags `indexed`, `wiki`, `gnews` (`1`); `sort` as `listAgedDomains` except `domain`; `per_page` 24, 48 or 96. Prices are the supplier list price with no markup (owner D55), integer USD minor units. Cached 5 minutes per query, facets 15 minutes; no authentication.
+         */
+        get: operations["listPublicAgedDomains"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/public/aged-domains/summary": {
         parameters: {
             query?: never;
@@ -64174,6 +64302,77 @@ export interface components {
             /** Format: int64 */
             value_micros: number;
         };
+        AdsReportRows: {
+            /** Format: date */
+            end: string;
+            fields: {
+                name: string;
+                /** @description The Looker Studio semantic type. */
+                type: string;
+            }[];
+            next_offset: number | null;
+            rows: {
+                account: string;
+                campaign: string;
+                campaign_id: string;
+                clicks: number;
+                client: string;
+                /** Format: uuid */
+                client_org_id: string;
+                /** Format: uuid */
+                connection_id: string;
+                conversions_milli: number;
+                cost_micros: number;
+                currency: string;
+                /** Format: date */
+                day: string;
+                impressions: number;
+                platform: string;
+                value_micros: number;
+            }[];
+            /** Format: date */
+            start: string;
+        };
+        AdsReportSchedule: {
+            /** @enum {string} */
+            cadence: "weekly" | "monthly";
+            enabled: boolean;
+            /** Format: uuid */
+            id: string;
+            /** @description `notInGoodStanding`, `mailRefused`, `renderFailed` or empty. */
+            last_error: string;
+            /** Format: date-time */
+            last_sent_at: string | null;
+            locale: string;
+            /** Format: date-time */
+            next_run_at: string | null;
+            /** Format: uuid */
+            org_id: string;
+            recipients: string[];
+            window_days: number;
+        };
+        AdsReportScheduleInput: {
+            /** @enum {string} */
+            cadence: "weekly" | "monthly";
+            /** @default true */
+            enabled: boolean;
+            /**
+             * @description One of the 58 platform languages.
+             * @default en
+             */
+            locale: string;
+            /**
+             * Format: uuid
+             * @description The client organisation the report is about.
+             */
+            org_id?: string;
+            recipients: string[];
+            /**
+             * @description Default 7 (weekly) or 30 (monthly).
+             * @enum {integer}
+             */
+            window_days?: 7 | 30 | 90;
+        };
         /** @description A scheduled review (AUTOREVIEW1). `figures` are the measurements the verdict rests on: the judged window (`after`) and the same length before it (`before`) with impressions, clicks, cost in the account's integer micros and conversions in thousandths (plus our own first-party `outcomes` on the house account), per campaign; a funnel's `idle` campaigns; a Quality Score review's `now` and `before` (`qs_x10`, `lp_below`, `keywords`); `stale` when the stored figures could not be read. */
         AdsReview: {
             campaign_ids: string[];
@@ -65582,6 +65781,72 @@ export interface components {
             per_page: number;
             total: number;
         };
+        AgedDomainPublicPage: {
+            applied: {
+                [key: string]: unknown;
+            };
+            /** @enum {string} */
+            currency: "USD";
+            data: {
+                added_year?: number | null;
+                categories: string[];
+                cf?: number | null;
+                currency: string;
+                da?: number | null;
+                dr?: number | null;
+                /** @description Sold by our team personally rather than self-serve. */
+                enquire_only: boolean;
+                has_gnews: boolean;
+                has_wiki: boolean;
+                /**
+                 * Format: uuid
+                 * @description Opens the signed-in detail page (`getAgedDomain`).
+                 */
+                id: string;
+                indexed: boolean;
+                language: string;
+                /** @example e••••••••••••••t.com */
+                masked_domain: string;
+                /** @description USD cents; supplier list price, no markup (D55). */
+                price_minor: number;
+                rd?: number | null;
+                tf?: number | null;
+                tld: string;
+            }[];
+            facets: {
+                /** @description Domains at least `years` old (a `max_added_year` filter); empty when no row carries a year. */
+                age_mins: {
+                    count: number;
+                    max_added_year: number;
+                    years: number;
+                }[];
+                /** @description The sixty most stocked categories, most first; `category_count` says how many exist. */
+                categories: components["schemas"]["AgedDomainFacetCount"][];
+                category_count: number;
+                dr_bands: {
+                    count: number;
+                    high: number | null;
+                    low: number;
+                }[];
+                languages: components["schemas"]["AgedDomainFacetCount"][];
+                rd_mins: {
+                    count: number;
+                    min: number;
+                }[];
+                tf_mins: {
+                    count: number;
+                    min: number;
+                }[];
+                tld_count: number;
+                /** @description The forty most stocked TLDs, most first. */
+                tlds: components["schemas"]["AgedDomainFacetCount"][];
+                /** @description Aged domains on sale now (unfiltered). */
+                total: number;
+            };
+            page: number;
+            per_page: number;
+            total: number;
+        };
         AgedDomainPublicSummary: {
             /**
              * Format: date-time
@@ -141206,6 +141471,233 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    getAdsReportPdf: {
+        parameters: {
+            query?: {
+                days?: 7 | 30 | 90;
+                locale?: string;
+                org_id?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The PDF. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/pdf": string;
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    listAdsReportRows: {
+        parameters: {
+            query: {
+                end: string;
+                offset?: number;
+                org_id?: string;
+                start: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One page of rows. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["AdsReportRows"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    listAdsReportSchedules: {
+        parameters: {
+            query?: {
+                org_id?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The schedules. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["AdsReportSchedule"][];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    saveAdsReportSchedule: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AdsReportScheduleInput"];
+            };
+        };
+        responses: {
+            /** @description The replaced schedule. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["AdsReportSchedule"];
+                    };
+                };
+            };
+            /** @description The new schedule. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["AdsReportSchedule"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    deleteAdsReportSchedule: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                schedule_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Removed. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    updateAdsReportSchedule: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                schedule_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    enabled?: boolean;
+                    locale?: string;
+                    recipients?: string[];
+                    /** @enum {integer} */
+                    window_days?: 7 | 30 | 90;
+                };
+            };
+        };
+        responses: {
+            /** @description The schedule. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["AdsReportSchedule"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
+    sendAdsReportScheduleNow: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                schedule_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description How many recipients the report went to. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            recipients: number;
+                            /** Format: uuid */
+                            schedule_id: string;
+                        };
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["UnprocessableEntity"];
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     getAdsShield: {
         parameters: {
             query?: {
@@ -174955,6 +175447,44 @@ export interface operations {
             429: components["responses"]["TooManyRequests"];
         };
     };
+    listPublicAgedDomains: {
+        parameters: {
+            query?: {
+                category?: string;
+                indexed?: "1";
+                language?: string;
+                max_added_year?: number;
+                max_dr?: number;
+                max_price?: string;
+                min_dr?: number;
+                /** @description USD, e.g. 49.99 */
+                min_price?: string;
+                min_rd?: number;
+                min_tf?: number;
+                page?: number;
+                per_page?: 24 | 48 | 96;
+                q?: string;
+                sort?: string;
+                tld?: string;
+                wiki?: "1";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One masked page of matching domains, the total, and the public facet counts. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AgedDomainPublicPage"];
+                };
+            };
+        };
+    };
     getPublicAgedDomainSummary: {
         parameters: {
             query?: never;

package/package.json

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