@productcraft/waitlist 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,1804 @@
+import { makeClient, PCClientConfig } from '@productcraft/core';
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+interface paths {
+    "/v1/waitlists/{workspace_slug}/{waitlist_slug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Public waitlist info (display name, description, custom-field schema, branding hints, active variant) */
+        get: operations["PublicWaitlistController_getPublic"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/waitlists/{workspace_slug}/{waitlist_slug}/entries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Submit a new entry to a public waitlist */
+        post: operations["PublicWaitlistController_submit"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/waitlists/{workspace_slug}/{waitlist_slug}/leaderboard": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Public top-50 referral leaderboard. Emails are masked. Anonymous read; same access policy as the public waitlist info endpoint. */
+        get: operations["PublicWaitlistController_leaderboard"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlist/settings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read workspace-level Waitlist defaults */
+        get: operations["SettingsController_get"];
+        /** Update workspace-level Waitlist defaults */
+        put: operations["SettingsController_update"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List waitlists in this workspace */
+        get: operations["WaitlistController_list"];
+        put?: never;
+        /** Create a waitlist (workspace-scoped) */
+        post: operations["WaitlistController_create"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get waitlist details */
+        get: operations["WaitlistController_get"];
+        put?: never;
+        post?: never;
+        /** Delete a waitlist (cascades to entries) */
+        delete: operations["WaitlistController_remove"];
+        options?: never;
+        head?: never;
+        /** Update waitlist metadata and settings */
+        patch: operations["WaitlistController_update"];
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{id}/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Change waitlist status */
+        patch: operations["WaitlistController_updateStatus"];
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/analytics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Aggregate counts, viral coefficient, top referrers + referrals */
+        get: operations["AnalyticsController_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/analytics/timeline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Daily-bucketed signup timeline (UTC, dense — zero-count days included) */
+        get: operations["AnalyticsController_timeline"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List entries on a waitlist (paginated) */
+        get: operations["EntryController_list"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/bulk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Bulk-apply approve / reject / invite-to-app to multiple entries at once. Capped at 100 ids per call. Processed serially server-side; per-row results are returned so the UI can render partial successes. */
+        post: operations["EntryController_bulk"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/count": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Total entry count for a waitlist */
+        get: operations["EntryController_count"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/export.csv": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Stream every entry as CSV (admin export) */
+        get: operations["EntryController_exportCsv"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/{entry_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a single entry */
+        get: operations["EntryController_get"];
+        put?: never;
+        post?: never;
+        /** Delete an entry (positions are not renumbered) */
+        delete: operations["EntryController_remove"];
+        options?: never;
+        head?: never;
+        /** Approve or reject an entry */
+        patch: operations["EntryController_updateStatus"];
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entries/{entry_id}/invite-to-app": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Invite an approved entry into a linked Auth consumer app (one-click cross-product handoff) */
+        post: operations["EntryController_inviteToApp"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/variants": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List all variants on a waitlist */
+        get: operations["VariantController_list"];
+        put?: never;
+        /** Create a variant */
+        post: operations["VariantController_create"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/variants/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Delete a variant */
+        delete: operations["VariantController_remove"];
+        options?: never;
+        head?: never;
+        /** Update a variant (locale, copy, weight, active) */
+        patch: operations["VariantController_update"];
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/webhooks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List webhooks for the workspace (secrets masked) */
+        get: operations["WebhookController_list"];
+        put?: never;
+        /** Create a workspace webhook. The response includes the per-row signing secret in clear EXACTLY ONCE — copy it now. */
+        post: operations["WebhookController_create"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/webhooks/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a webhook (secret masked) */
+        get: operations["WebhookController_get"];
+        put?: never;
+        post?: never;
+        /** Delete a webhook */
+        delete: operations["WebhookController_remove"];
+        options?: never;
+        head?: never;
+        /** Update url / events / active flag */
+        patch: operations["WebhookController_update"];
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/webhooks/{id}/deliveries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Recent delivery attempts for a webhook (default 50, max 200, newest first) */
+        get: operations["WebhookController_recentDeliveries"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/webhooks/{id}/rotate-secret": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Rotate the signing secret. Returns the new secret in clear EXACTLY ONCE. */
+        post: operations["WebhookController_rotateSecret"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspace_id}/webhooks/{id}/test": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Fire a synthetic test event to this webhook (asynchronous; check the destination logs) */
+        post: operations["WebhookController_fireTest"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        BulkEntryActionDto: {
+            /**
+             * @description Action to apply to every id.
+             * @example approve
+             * @enum {string}
+             */
+            action: "approve" | "reject" | "invite-to-app";
+            /**
+             * @description Auth app slug override for `action: invite-to-app`. When omitted, falls back to the workspace Waitlist settings default (`default_heimdall_app_slug`). Ignored for approve/reject.
+             * @example acme-product
+             */
+            app_slug?: string;
+            /**
+             * @description Entry UUIDs to act on in this batch. Capped at 100 per call; the request is processed serially and per-row results are returned. De-duped server-side.
+             * @example [
+             *       "11111111-1111-1111-1111-111111111111",
+             *       "22222222-2222-2222-2222-222222222222"
+             *     ]
+             */
+            ids: string[];
+            /**
+             * @description Whether to send the approval email with the invite link baked in. Defaults to `true`. Ignored for approve/reject.
+             * @default true
+             */
+            send_email: boolean;
+        };
+        CreateEntryDto: {
+            /**
+             * @description Email address
+             * @example ada@example.com
+             */
+            email: string;
+            /** @description Free-text product interest */
+            interest?: string;
+            /** @description Custom field values */
+            metadata?: Record<string, never>;
+            /**
+             * @description Full name
+             * @example Ada Lovelace
+             */
+            name: string;
+            /** @description reCAPTCHA v3 token; verified server-side when the waitlist has settings.recaptcha_site_key */
+            recaptcha_token?: string;
+            /** @description Referral code from a prior signup; bumps that signup’s position when honoured */
+            referral_code?: string;
+            /** @description How they heard about it */
+            referrer?: string;
+            /**
+             * Format: uuid
+             * @description Variant id this submission was attributed to. Customer frontends fetch the active variant from `GET /v1/waitlists/:workspaceSlug/:waitlistSlug` and round-trip it here on POST so per-variant conversion can be computed without a separate impressions table.
+             */
+            variant_id?: string;
+        };
+        CreateVariantDto: {
+            /** @default true */
+            active: boolean;
+            /** @description Copy overrides. Recognised keys: display_name, description, confirmation_message. Unknown keys are dropped on the public render. */
+            copy: components["schemas"]["VariantCopyDto"];
+            /** @enum {string} */
+            kind: "ab" | "locale";
+            /**
+             * @description BCP-47 locale tag. For ab variants this is the locale they target; for locale variants this is the locale they serve. Case is normalised on the public side.
+             * @example en
+             */
+            locale: string;
+            /**
+             * @description Relative weight inside the ab pool. Ignored when kind=locale. Default 1.
+             * @default 1
+             */
+            weight: number;
+        };
+        CreateWaitlistDto: {
+            /** @description Description returned in the public waitlist payload — customer frontends typically render it under the display name on their signup form. */
+            description?: string;
+            /**
+             * @description Display name
+             * @example Early Access Program
+             */
+            display_name: string;
+            /** @description Waitlist settings (max_entries, approval_required, custom_fields, confirmation_message, referral_boost) */
+            settings?: Record<string, never>;
+            /**
+             * @description URL-safe slug
+             * @example early-access
+             */
+            slug: string;
+        };
+        CreateWebhookDto: {
+            /** @description Disabled webhooks store events but never deliver */
+            active?: boolean;
+            /**
+             * @description Events to subscribe to
+             * @example [
+             *       "entry.created",
+             *       "entry.approved"
+             *     ]
+             */
+            events: ("entry.created" | "entry.approved" | "entry.rejected")[];
+            /** @description Destination URL (must be https in prod) */
+            url: string;
+        };
+        EntryListPaginationDto: {
+            has_more: boolean;
+            next_cursor: string | null;
+        };
+        EntryListResponseDto: {
+            data: components["schemas"]["EntryResponseDto"][];
+            pagination: components["schemas"]["EntryListPaginationDto"];
+        };
+        EntryResponseDto: {
+            created_at: string;
+            email: string;
+            id: string;
+            interest: string | null;
+            invited_at: string | null;
+            invited_to_app_slug: string | null;
+            metadata: Record<string, never>;
+            name: string;
+            position: number;
+            referral_code: string;
+            referral_count: number;
+            referred_by_entry_id: string | null;
+            referrer: string | null;
+            /** @enum {string} */
+            status: "pending" | "approved" | "rejected";
+            updated_at: string;
+            waitlist_id: string;
+            workspace_id: string;
+        };
+        InviteToAppDto: {
+            /** @description Auth app slug to invite into; defaults to the workspace Waitlist settings default (`default_heimdall_app_slug`) */
+            app_slug?: string;
+            /**
+             * @description Send the approval email with the Auth invite link baked in
+             * @default true
+             */
+            send_email: boolean;
+        };
+        TestWebhookDto: {
+            /**
+             * @description Event type to fire as a synthetic test
+             * @enum {string}
+             */
+            event: "entry.created" | "entry.approved" | "entry.rejected";
+            /** @description Waitlist UUID to reference in the synthetic payload. Defaults to a placeholder UUID when omitted. */
+            waitlist_id?: string;
+        };
+        UpdateEntryStatusDto: {
+            /**
+             * @description Target status
+             * @enum {string}
+             */
+            status: "approved" | "rejected";
+        };
+        UpdateSettingsDto: {
+            /** @description Mail template name used for entry.approved notifications. Must already exist in the workspace template store. */
+            approved_template_name?: string | null;
+            /** @description Logo URL returned in the public waitlist payload. Customer frontends render it on their own signup form. */
+            brand_logo_url?: string;
+            /** @description Brand name returned in the public waitlist payload. Customer frontends render it on their own signup form. */
+            brand_name?: string;
+            /** @description Auth consumer-app slug to invite approved entries into. null clears the link. */
+            default_heimdall_app_slug?: string | null;
+            /** @description Verified sender address used as the From envelope on Waitlist notifications. Must belong to default_sender_domain_id. null clears the override. */
+            default_sender_address?: string | null;
+            /** @description Mail domain UUID to use as default sender for Waitlist notifications. null clears the override. */
+            default_sender_domain_id?: string | null;
+            /** @description Route Waitlist notifications through the Mail service (workspace sender domain + per-event template selection) instead of staying silent. Requires default_sender_domain_id, default_sender_address, and a template name for every supported event. Default false; when off, Waitlist sends no notification emails and the customer is expected to handle email via the webhook lane. */
+            notifications_via_envoi?: boolean;
+            /** @description Primary brand colour as #RRGGBB */
+            primary_color?: string;
+            /** @description Mail template name used for entry.rejected notifications. Must already exist in the workspace template store. */
+            rejected_template_name?: string | null;
+            /** @description Mail template name used for entry.created notifications. Must already exist in the workspace template store. */
+            welcome_template_name?: string | null;
+        };
+        UpdateVariantDto: {
+            active?: boolean;
+            copy?: components["schemas"]["VariantCopyDto"];
+            locale?: string;
+            weight?: number;
+        };
+        UpdateWaitlistDto: {
+            /** @description New description */
+            description?: string;
+            /** @description New display name */
+            display_name?: string;
+            /** @description Updated settings (merged shallow) */
+            settings?: Record<string, never>;
+        };
+        UpdateWaitlistStatusDto: {
+            /**
+             * @description New status
+             * @enum {string}
+             */
+            status: "draft" | "active" | "paused" | "closed";
+        };
+        UpdateWebhookDto: {
+            /** @description Pause/resume the webhook */
+            active?: boolean;
+            /** @description New event subscription */
+            events?: ("entry.created" | "entry.approved" | "entry.rejected")[];
+            /** @description New URL */
+            url?: string;
+        };
+        VariantCopyDto: {
+            confirmation_message?: string;
+            description?: string;
+            display_name?: string;
+        };
+        VariantListResponseDto: {
+            data: components["schemas"]["VariantResponseDto"][];
+        };
+        VariantResponseDto: {
+            active: boolean;
+            copy: Record<string, never>;
+            created_at: string;
+            id: string;
+            /** @enum {string} */
+            kind: "ab" | "locale";
+            locale: string;
+            waitlist_id: string;
+            weight: number;
+        };
+        WaitlistListPaginationDto: {
+            has_more: boolean;
+            next_cursor: string | null;
+        };
+        WaitlistListResponseDto: {
+            data: components["schemas"]["WaitlistResponseDto"][];
+            pagination: components["schemas"]["WaitlistListPaginationDto"];
+        };
+        WaitlistResponseDto: {
+            created_at: string;
+            created_by: string;
+            description: string | null;
+            /** @example Early Access Program */
+            display_name: string;
+            /** @example b1a4... */
+            id: string;
+            previous_workspace_slug: string | null;
+            /** @description Waitlist settings (max_entries, approval_required, custom_fields, confirmation_message, referral_boost). */
+            settings: Record<string, never>;
+            /** @example early-access */
+            slug: string;
+            /** @enum {string} */
+            status: "draft" | "active" | "paused" | "closed";
+            updated_at: string;
+            /** @example b1a4... */
+            workspace_id: string;
+            /** @example acme */
+            workspace_slug: string;
+        };
+        WebhookCreateResponseDto: {
+            active: boolean;
+            auto_disabled_at: string | null;
+            created_at: string;
+            events: ("entry.created" | "entry.approved" | "entry.rejected")[];
+            failure_count: number;
+            first_failure_at: string | null;
+            id: string;
+            last_attempt_at: string | null;
+            last_status_code: number | null;
+            /** @description Plaintext signing secret returned EXACTLY ONCE on create + rotate. Persist immediately — it does not appear on subsequent GETs. */
+            signing_secret: string;
+            url: string;
+            workspace_id: string;
+        };
+        WebhookListResponseDto: {
+            data: components["schemas"]["WebhookResponseDto"][];
+        };
+        WebhookResponseDto: {
+            active: boolean;
+            auto_disabled_at: string | null;
+            created_at: string;
+            events: ("entry.created" | "entry.approved" | "entry.rejected")[];
+            failure_count: number;
+            first_failure_at: string | null;
+            id: string;
+            last_attempt_at: string | null;
+            last_status_code: number | null;
+            url: string;
+            workspace_id: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+interface operations {
+    PublicWaitlistController_getPublic: {
+        parameters: {
+            query?: {
+                /** @description BCP-47 locale tag (e.g. `en`, `pt-BR`). Wins over Accept-Language when picking the variant. */
+                lang?: string;
+            };
+            header?: never;
+            path: {
+                workspace_slug: string;
+                waitlist_slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Public waitlist info */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found or not active */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PublicWaitlistController_submit: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_slug: string;
+                waitlist_slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateEntryDto"];
+            };
+        };
+        responses: {
+            /** @description Entry created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation or spam check failed */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Email already on this waitlist */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist is not active or is full */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Too many requests from this IP */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PublicWaitlistController_leaderboard: {
+        parameters: {
+            query?: {
+                /** @description Number of rows (1-50, default 50) */
+                limit?: string;
+            };
+            header?: never;
+            path: {
+                workspace_slug: string;
+                waitlist_slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Array of `{ position, referral_count, masked_email }` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found or not active */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    SettingsController_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Workspace Waitlist settings. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `waitlist.settings.read` on the workspace. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Workspace does not exist or is not Waitlist-enabled. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    SettingsController_update: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateSettingsDto"];
+            };
+        };
+        responses: {
+            /** @description Updated workspace Waitlist settings. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation failure on the patch body (per `UpdateSettingsDto`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `waitlist.settings.update` on the workspace. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Workspace does not exist or is not Waitlist-enabled. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WaitlistController_list: {
+        parameters: {
+            query?: {
+                limit?: number;
+                /** @description Opaque cursor for pagination */
+                cursor?: string;
+                /** @description Filter by status */
+                status?: string;
+            };
+            header?: never;
+            path: {
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of waitlists. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WaitlistListResponseDto"];
+                };
+            };
+        };
+    };
+    WaitlistController_create: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Stripe-style idempotency key. Waitlist creation provisions a non-trivial sub-tree (variant, default referral settings, etc.); a retry without this header creates a second waitlist sharing the same name slug. 24h TTL. */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateWaitlistDto"];
+            };
+        };
+        responses: {
+            /** @description Waitlist created. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WaitlistResponseDto"];
+                };
+            };
+            /** @description Validation failure. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `waitlist.create`, or workspace has not enabled the `waitlist` service. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Slug already taken in this workspace. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WaitlistController_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Waitlist row. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WaitlistResponseDto"];
+                };
+            };
+            /** @description Waitlist not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WaitlistController_remove: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Waitlist deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `waitlist.delete`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WaitlistController_update: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateWaitlistDto"];
+            };
+        };
+        responses: {
+            /** @description Waitlist updated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WaitlistResponseDto"];
+                };
+            };
+            /** @description Validation failure. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WaitlistController_updateStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateWaitlistStatusDto"];
+            };
+        };
+        responses: {
+            /** @description Status updated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WaitlistResponseDto"];
+                };
+            };
+            /** @description Invalid status transition. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    AnalyticsController_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Aggregated analytics payload for the waitlist. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `waitlist.read` on the workspace. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist does not exist or is not in the path workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    AnalyticsController_timeline: {
+        parameters: {
+            query: {
+                /** @description ISO-8601 inclusive start */
+                since: string;
+                /** @description ISO-8601 exclusive end */
+                until: string;
+            };
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Daily timeline array, oldest first, zero-count days included. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description `since` / `until` missing, malformed, or `until <= since`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `waitlist.read` on the workspace. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist does not exist or is not in the path workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EntryController_list: {
+        parameters: {
+            query?: {
+                limit?: number;
+                /** @description Opaque cursor for pagination */
+                cursor?: string;
+                /** @description Filter by status */
+                status?: string;
+            };
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of entries with pagination cursor. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EntryListResponseDto"];
+                };
+            };
+            /** @description Caller lacks `entry.read`, or workspace has not enabled the `waitlist` service. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found in this workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EntryController_bulk: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkEntryActionDto"];
+            };
+        };
+        responses: {
+            /** @description `{ requested, succeeded, failed, results }`. Each row in `results` carries `{ id, status: "ok" | "error", error?: { code, message } }` so a partial failure (one bad id) doesn't fail the whole batch. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Empty `ids`, more than 100 ids, or unknown action. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `entry.update`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EntryController_count: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EntryController_exportCsv: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description CSV stream */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EntryController_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+                entry_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Entry row. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EntryResponseDto"];
+                };
+            };
+            /** @description Entry not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EntryController_remove: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+                entry_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Entry deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `entry.update`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Entry not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EntryController_updateStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+                entry_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateEntryStatusDto"];
+            };
+        };
+        responses: {
+            /** @description Entry status updated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EntryResponseDto"];
+                };
+            };
+            /** @description Invalid status transition. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `entry.update`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Entry not found in this waitlist. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EntryController_inviteToApp: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+                entry_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["InviteToAppDto"];
+            };
+        };
+        responses: {
+            /** @description Invite created in Auth */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No linked Auth app for this workspace */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    VariantController_list: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Bare array of variants */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VariantListResponseDto"];
+                };
+            };
+        };
+    };
+    VariantController_create: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateVariantDto"];
+            };
+        };
+        responses: {
+            /** @description Variant created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VariantResponseDto"];
+                };
+            };
+            /** @description Validation failure */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Waitlist not found in this workspace */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    VariantController_remove: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Variant deleted */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Variant not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    VariantController_update: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                waitlist_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateVariantDto"];
+            };
+        };
+        responses: {
+            /** @description Variant updated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["VariantResponseDto"];
+                };
+            };
+            /** @description Variant not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WebhookController_list: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Webhooks for the workspace. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookListResponseDto"];
+                };
+            };
+        };
+    };
+    WebhookController_create: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Stripe-style idempotency key. The signing secret is returned exactly once; a retry without this header creates a second webhook + secret you never see the plaintext for. 24h TTL. */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateWebhookDto"];
+            };
+        };
+        responses: {
+            /** @description Webhook created. Includes plaintext `signing_secret` exactly once. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookCreateResponseDto"];
+                };
+            };
+        };
+    };
+    WebhookController_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Webhook row. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookResponseDto"];
+                };
+            };
+            /** @description Webhook not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WebhookController_remove: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WebhookController_update: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateWebhookDto"];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WebhookController_recentDeliveries: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description `{ data: Array<{ id, event_id, event_type, attempt_number, status_code, response_body, error_message, latency_ms, created_at }> }` */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WebhookController_rotateSecret: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    WebhookController_fireTest: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TestWebhookDto"];
+            };
+        };
+        responses: {
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+}
+
+/**
+ * Waitlist — typed `openapi-fetch` client for every endpoint in
+ * `Specs/waitlist.json`. Reach for `client.GET("/v1/...")` or
+ * `client.POST(...)`; request / response types come from the
+ * generated `paths` interface.
+ */
+declare class Waitlist {
+    /** The underlying typed client. v0 surface — every endpoint reachable. */
+    readonly client: ReturnType<typeof makeClient<paths>>;
+    constructor(config?: PCClientConfig);
+}
+
+export { Waitlist, type paths };