@widgetic/api-sdk 1.0.24 → 1.0.25

package/dist/esm/apis/ABTestingApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ABTestVariant, AssignVariantRequest, CheckWorkspaceABTestAutoStop200Response, CreateABTestAssignment201Response, CreateABTestAssignmentRequest, CreateABTestRequest, CreateWorkspaceABTest201Response, DeleteWorkspaceABTest200Response, GetABTestConfig200Response, GetAvailableMetrics200Response, GetAvailableSuccessMetrics200Response, GetVariantConfig200Response, ListWorkspaceABTests200Response, SetWorkspaceABTestDuration200Response, SetWorkspaceABTestDurationRequest, StopWorkspaceABTest200Response, StopWorkspaceABTestRequest, TrackABTestEvent201Response, TrackABTestEventRequest, TrackBulkABTestEvents200Response, TrackBulkABTestEventsRequest, UpdateABTestRequest, ValidateWorkspaceCompositionDeletion200Response, ValidateWorkspaceCompositionDeletionRequest, ValidateWorkspaceGoalTracking200Response, ValidateWorkspaceGoalTrackingRequest, ValidateWorkspaceWidgetDeletion200Response, ValidateWorkspaceWidgetDeletionRequest } from '../models/index';
+import type { ABTestVariant, AssignVariantRequest, CheckWorkspaceABTestAutoStop200Response, CreateABTestAssignment201Response, CreateABTestAssignmentRequest, CreateABTestRequest, CreateWorkspaceABTest201Response, DeleteWorkspaceABTest200Response, GetABTestConfig200Response, GetAvailableMetrics200Response, GetAvailableSuccessMetrics200Response, GetVariantConfig200Response, GetWorkspaceABTestDiagnosis200Response, GetWorkspaceABTestStatistics200Response, ListWorkspaceABTests200Response, SetWorkspaceABTestDuration200Response, SetWorkspaceABTestDurationRequest, StopWorkspaceABTest200Response, StopWorkspaceABTestRequest, TrackABTestEvent201Response, TrackABTestEventRequest, TrackBulkABTestEvents200Response, TrackBulkABTestEventsRequest, UpdateABTestRequest, ValidateWorkspaceCompositionDeletion200Response, ValidateWorkspaceCompositionDeletionRequest, ValidateWorkspaceGoalTracking200Response, ValidateWorkspaceGoalTrackingRequest, ValidateWorkspaceWidgetDeletion200Response, ValidateWorkspaceWidgetDeletionRequest } from '../models/index';
 export interface AssignVariantOperationRequest {
     id: string;
     assignVariantRequest: AssignVariantRequest;
@@ -40,6 +40,14 @@ export interface GetWorkspaceABTestRequest {
     workspaceId: string;
     testId: string;
 }
+export interface GetWorkspaceABTestDiagnosisRequest {
+    workspaceId: string;
+    testId: string;
+}
+export interface GetWorkspaceABTestStatisticsRequest {
+    workspaceId: string;
+    testId: string;
+}
 export interface ListWorkspaceABTestsRequest {
     workspaceId: string;
     status?: ListWorkspaceABTestsStatusEnum;
@@ -189,6 +197,26 @@ export declare class ABTestingApi extends runtime.BaseAPI {
      * Get AB Test from Workspace
      */
     getWorkspaceABTest(requestParameters: GetWorkspaceABTestRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateWorkspaceABTest201Response>;
+    /**
+     * Returns an AI review of the test: what its versions change, which of the usual levers that is (urgency, social proof, clarity, pricing, friction, or only looks), and whether the challenger is safe to promote. It calls another service, so it is slower than the other reads: ask for it only when it is wanted. A test with fewer than two versions gets a fixed answer that says so. For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId. The answer is sent once inside the usual `{ success, data }` envelope.
+     * Get AB Test AI Review from Workspace
+     */
+    getWorkspaceABTestDiagnosisRaw(requestParameters: GetWorkspaceABTestDiagnosisRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWorkspaceABTestDiagnosis200Response>>;
+    /**
+     * Returns an AI review of the test: what its versions change, which of the usual levers that is (urgency, social proof, clarity, pricing, friction, or only looks), and whether the challenger is safe to promote. It calls another service, so it is slower than the other reads: ask for it only when it is wanted. A test with fewer than two versions gets a fixed answer that says so. For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId. The answer is sent once inside the usual `{ success, data }` envelope.
+     * Get AB Test AI Review from Workspace
+     */
+    getWorkspaceABTestDiagnosis(requestParameters: GetWorkspaceABTestDiagnosisRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWorkspaceABTestDiagnosis200Response>;
+    /**
+     * Returns what an AB test has gathered so far: impressions and conversions overall and for each version, the statistics that compare each version with the control, and the API\'s advice on what to do next. For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId. The answer is sent once inside the usual `{ success, data }` envelope (unlike most AB test routes, which wrap their data a second time).
+     * Get AB Test Statistics from Workspace
+     */
+    getWorkspaceABTestStatisticsRaw(requestParameters: GetWorkspaceABTestStatisticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWorkspaceABTestStatistics200Response>>;
+    /**
+     * Returns what an AB test has gathered so far: impressions and conversions overall and for each version, the statistics that compare each version with the control, and the API\'s advice on what to do next. For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId. The answer is sent once inside the usual `{ success, data }` envelope (unlike most AB test routes, which wrap their data a second time).
+     * Get AB Test Statistics from Workspace
+     */
+    getWorkspaceABTestStatistics(requestParameters: GetWorkspaceABTestStatisticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWorkspaceABTestStatistics200Response>;
     /**
      * Retrieves all AB tests in the specified workspace (personal or organization). For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId.
      * List AB Tests in Workspace

package/dist/esm/apis/ABTestingApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime.js';
-import { ABTestVariantFromJSON, AssignVariantRequestToJSON, CheckWorkspaceABTestAutoStop200ResponseFromJSON, CreateABTestAssignment201ResponseFromJSON, CreateABTestAssignmentRequestToJSON, CreateABTestRequestToJSON, CreateWorkspaceABTest201ResponseFromJSON, DeleteWorkspaceABTest200ResponseFromJSON, GetABTestConfig200ResponseFromJSON, GetAvailableMetrics200ResponseFromJSON, GetAvailableSuccessMetrics200ResponseFromJSON, GetVariantConfig200ResponseFromJSON, ListWorkspaceABTests200ResponseFromJSON, SetWorkspaceABTestDuration200ResponseFromJSON, SetWorkspaceABTestDurationRequestToJSON, StopWorkspaceABTest200ResponseFromJSON, StopWorkspaceABTestRequestToJSON, TrackABTestEvent201ResponseFromJSON, TrackABTestEventRequestToJSON, TrackBulkABTestEvents200ResponseFromJSON, TrackBulkABTestEventsRequestToJSON, UpdateABTestRequestToJSON, ValidateWorkspaceCompositionDeletion200ResponseFromJSON, ValidateWorkspaceCompositionDeletionRequestToJSON, ValidateWorkspaceGoalTracking200ResponseFromJSON, ValidateWorkspaceGoalTrackingRequestToJSON, ValidateWorkspaceWidgetDeletion200ResponseFromJSON, ValidateWorkspaceWidgetDeletionRequestToJSON, } from '../models/index.js';
+import { ABTestVariantFromJSON, AssignVariantRequestToJSON, CheckWorkspaceABTestAutoStop200ResponseFromJSON, CreateABTestAssignment201ResponseFromJSON, CreateABTestAssignmentRequestToJSON, CreateABTestRequestToJSON, CreateWorkspaceABTest201ResponseFromJSON, DeleteWorkspaceABTest200ResponseFromJSON, GetABTestConfig200ResponseFromJSON, GetAvailableMetrics200ResponseFromJSON, GetAvailableSuccessMetrics200ResponseFromJSON, GetVariantConfig200ResponseFromJSON, GetWorkspaceABTestDiagnosis200ResponseFromJSON, GetWorkspaceABTestStatistics200ResponseFromJSON, ListWorkspaceABTests200ResponseFromJSON, SetWorkspaceABTestDuration200ResponseFromJSON, SetWorkspaceABTestDurationRequestToJSON, StopWorkspaceABTest200ResponseFromJSON, StopWorkspaceABTestRequestToJSON, TrackABTestEvent201ResponseFromJSON, TrackABTestEventRequestToJSON, TrackBulkABTestEvents200ResponseFromJSON, TrackBulkABTestEventsRequestToJSON, UpdateABTestRequestToJSON, ValidateWorkspaceCompositionDeletion200ResponseFromJSON, ValidateWorkspaceCompositionDeletionRequestToJSON, ValidateWorkspaceGoalTracking200ResponseFromJSON, ValidateWorkspaceGoalTrackingRequestToJSON, ValidateWorkspaceWidgetDeletion200ResponseFromJSON, ValidateWorkspaceWidgetDeletionRequestToJSON, } from '../models/index.js';
 /**
  *
  */
@@ -383,6 +383,86 @@ export class ABTestingApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Returns an AI review of the test: what its versions change, which of the usual levers that is (urgency, social proof, clarity, pricing, friction, or only looks), and whether the challenger is safe to promote. It calls another service, so it is slower than the other reads: ask for it only when it is wanted. A test with fewer than two versions gets a fixed answer that says so. For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId. The answer is sent once inside the usual `{ success, data }` envelope.
+     * Get AB Test AI Review from Workspace
+     */
+    getWorkspaceABTestDiagnosisRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['workspaceId'] == null) {
+                throw new runtime.RequiredError('workspaceId', 'Required parameter "workspaceId" was null or undefined when calling getWorkspaceABTestDiagnosis().');
+            }
+            if (requestParameters['testId'] == null) {
+                throw new runtime.RequiredError('testId', 'Required parameter "testId" was null or undefined when calling getWorkspaceABTestDiagnosis().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/workspaces/{workspaceId}/ab-tests/{testId}/diagnosis`.replace(`{${"workspaceId"}}`, encodeURIComponent(String(requestParameters['workspaceId']))).replace(`{${"testId"}}`, encodeURIComponent(String(requestParameters['testId']))),
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => GetWorkspaceABTestDiagnosis200ResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Returns an AI review of the test: what its versions change, which of the usual levers that is (urgency, social proof, clarity, pricing, friction, or only looks), and whether the challenger is safe to promote. It calls another service, so it is slower than the other reads: ask for it only when it is wanted. A test with fewer than two versions gets a fixed answer that says so. For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId. The answer is sent once inside the usual `{ success, data }` envelope.
+     * Get AB Test AI Review from Workspace
+     */
+    getWorkspaceABTestDiagnosis(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getWorkspaceABTestDiagnosisRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Returns what an AB test has gathered so far: impressions and conversions overall and for each version, the statistics that compare each version with the control, and the API\'s advice on what to do next. For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId. The answer is sent once inside the usual `{ success, data }` envelope (unlike most AB test routes, which wrap their data a second time).
+     * Get AB Test Statistics from Workspace
+     */
+    getWorkspaceABTestStatisticsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['workspaceId'] == null) {
+                throw new runtime.RequiredError('workspaceId', 'Required parameter "workspaceId" was null or undefined when calling getWorkspaceABTestStatistics().');
+            }
+            if (requestParameters['testId'] == null) {
+                throw new runtime.RequiredError('testId', 'Required parameter "testId" was null or undefined when calling getWorkspaceABTestStatistics().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/workspaces/{workspaceId}/ab-tests/{testId}/statistics`.replace(`{${"workspaceId"}}`, encodeURIComponent(String(requestParameters['workspaceId']))).replace(`{${"testId"}}`, encodeURIComponent(String(requestParameters['testId']))),
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => GetWorkspaceABTestStatistics200ResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Returns what an AB test has gathered so far: impressions and conversions overall and for each version, the statistics that compare each version with the control, and the API\'s advice on what to do next. For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId. The answer is sent once inside the usual `{ success, data }` envelope (unlike most AB test routes, which wrap their data a second time).
+     * Get AB Test Statistics from Workspace
+     */
+    getWorkspaceABTestStatistics(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getWorkspaceABTestStatisticsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Retrieves all AB tests in the specified workspace (personal or organization). For personal workspace, use \'personal\' as workspaceId. For organization workspace, use the organization UUID as workspaceId.
      * List AB Tests in Workspace

package/dist/esm/apis/AdminApi.d.ts

@@ -10,7 +10,16 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AdminHealthStatus, CleanupOrphanedInvitations200Response, CleanupOrphanedInvitationsRequest } from '../models/index';
+import type { AdjustPartnerCredits200Response, AdjustPartnerCreditsRequest, AdjustUserCredits200Response, AdjustUserCreditsRequest, AdminHealthStatus, CleanupOrphanedInvitations200Response, CleanupOrphanedInvitationsRequest, CreatePartnerRequest, PartnerBillingReport, PartnerDetails, PartnerList, PartnerUpdateResult, PartnerWithWarnings, RefundPartnerCreditsRequest, UpdatePartnerRequest, UpdatePartnerStatusRequest } from '../models/index';
+export interface AdjustPartnerCreditsOperationRequest {
+    partnerId: string;
+    idempotencyKey: string;
+    adjustPartnerCreditsRequest: AdjustPartnerCreditsRequest;
+}
+export interface AdjustUserCreditsOperationRequest {
+    idempotencyKey: string;
+    adjustUserCreditsRequest: AdjustUserCreditsRequest;
+}
 export interface CheckAdminHealth0Request {
     includeMetrics?: boolean;
     services?: Array<string>;
@@ -19,10 +28,69 @@ export interface CheckAdminHealth0Request {
 export interface CleanupOrphanedInvitations0Request {
     cleanupOrphanedInvitationsRequest?: CleanupOrphanedInvitationsRequest;
 }
+export interface CreatePartnerOperationRequest {
+    createPartnerRequest: CreatePartnerRequest;
+}
+export interface GetPartnerBillingReportRequest {
+    partnerId: string;
+    startDate?: Date;
+    endDate?: Date;
+    includeTransactions?: GetPartnerBillingReportIncludeTransactionsEnum;
+}
+export interface GetPartnerDetailsRequest {
+    partnerId: string;
+}
+export interface ListAdminWidgetsRequest {
+    scope?: ListAdminWidgetsScopeEnum;
+    preset?: ListAdminWidgetsPresetEnum;
+    search?: string;
+    page?: number;
+    size?: number;
+}
+export interface ListPartnersRequest {
+    page?: number;
+    size?: number;
+    status?: ListPartnersStatusEnum;
+    searchTerm?: string;
+    sort?: string;
+}
+export interface RefundPartnerCreditsOperationRequest {
+    idempotencyKey: string;
+    refundPartnerCreditsRequest: RefundPartnerCreditsRequest;
+}
+export interface UpdatePartnerOperationRequest {
+    partnerId: string;
+    updatePartnerRequest: UpdatePartnerRequest;
+    idempotencyKey?: string;
+}
+export interface UpdatePartnerStatusOperationRequest {
+    partnerId: string;
+    updatePartnerStatusRequest: UpdatePartnerStatusRequest;
+}
 /**
  *
  */
 export declare class AdminApi extends runtime.BaseAPI {
+    /**
+     * Admin only. A positive `amount` adds credits to the partner wallet; a negative `amount` removes them (the wallet must hold them). An `amount` of 0, or one that is not a finite number, is refused with 400. **One top-up may not exceed $100,000** (`BILLING_CONFIG.PARTNER_WALLET`), which is 1,000,000 credits at the list price of $0.10 per credit. A larger amount is refused with 400 and nothing is credited. The same ceiling applies to `POST /admin/billing/refund` and to the `creditBalance` field of `PUT /admin/partners/{partnerId}`. Removing credits is not limited by it. The `Idempotency-Key` header is required and names the adjustment: a retry with the same key replays the first result (`replayed: true`) instead of moving the balance twice, and a request without one is refused with 400. This moves a PARTNER\'s wallet. A user\'s balance is moved by `POST /admin/billing/credits/adjust`.
+     * Add credits to, or remove credits from, a partner\'s wallet
+     */
+    adjustPartnerCreditsRaw(requestParameters: AdjustPartnerCreditsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdjustPartnerCredits200Response>>;
+    /**
+     * Admin only. A positive `amount` adds credits to the partner wallet; a negative `amount` removes them (the wallet must hold them). An `amount` of 0, or one that is not a finite number, is refused with 400. **One top-up may not exceed $100,000** (`BILLING_CONFIG.PARTNER_WALLET`), which is 1,000,000 credits at the list price of $0.10 per credit. A larger amount is refused with 400 and nothing is credited. The same ceiling applies to `POST /admin/billing/refund` and to the `creditBalance` field of `PUT /admin/partners/{partnerId}`. Removing credits is not limited by it. The `Idempotency-Key` header is required and names the adjustment: a retry with the same key replays the first result (`replayed: true`) instead of moving the balance twice, and a request without one is refused with 400. This moves a PARTNER\'s wallet. A user\'s balance is moved by `POST /admin/billing/credits/adjust`.
+     * Add credits to, or remove credits from, a partner\'s wallet
+     */
+    adjustPartnerCredits(requestParameters: AdjustPartnerCreditsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdjustPartnerCredits200Response>;
+    /**
+     * Admin only. A positive `amount` grants free credits; a negative `amount` takes credits away (the balance must hold them). An `amount` of 0, or one that is not a finite number, is refused with 400. The `Idempotency-Key` header is required and names the adjustment: a retry with the same key replays the first result (`replayed: true`) instead of moving the balance twice, and a request without one is refused with 400. Free credits are limited per admin: one request may grant at most `ADMIN_GRANT_MAX_PER_REQUEST` credits (default 5000) and one admin may grant at most `ADMIN_GRANT_DAILY_LIMIT` credits alone per UTC day (default 10000), counted across this route, `POST /credits/add` and the grants route (`POST /admin-billing/grants`). Removing credits is not counted. A request over the per-request limit is refused with 400; one that would pass the daily limit is refused with 429 and `ADMIN_GRANT_LIMIT_REACHED` (`error.details` has the limit, what was used, what is left and when the day resets). This moves a USER\'s balance. A partner\'s wallet is moved by `POST /admin/partners/{partnerId}/credits`.
+     * Add credits to, or remove credits from, a user\'s balance
+     */
+    adjustUserCreditsRaw(requestParameters: AdjustUserCreditsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdjustUserCredits200Response>>;
+    /**
+     * Admin only. A positive `amount` grants free credits; a negative `amount` takes credits away (the balance must hold them). An `amount` of 0, or one that is not a finite number, is refused with 400. The `Idempotency-Key` header is required and names the adjustment: a retry with the same key replays the first result (`replayed: true`) instead of moving the balance twice, and a request without one is refused with 400. Free credits are limited per admin: one request may grant at most `ADMIN_GRANT_MAX_PER_REQUEST` credits (default 5000) and one admin may grant at most `ADMIN_GRANT_DAILY_LIMIT` credits alone per UTC day (default 10000), counted across this route, `POST /credits/add` and the grants route (`POST /admin-billing/grants`). Removing credits is not counted. A request over the per-request limit is refused with 400; one that would pass the daily limit is refused with 429 and `ADMIN_GRANT_LIMIT_REACHED` (`error.details` has the limit, what was used, what is left and when the day resets). This moves a USER\'s balance. A partner\'s wallet is moved by `POST /admin/partners/{partnerId}/credits`.
+     * Add credits to, or remove credits from, a user\'s balance
+     */
+    adjustUserCredits(requestParameters: AdjustUserCreditsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdjustUserCredits200Response>;
     /**
      * Detailed health check for admin users, including database health records.
      * Admin Health Check
@@ -43,4 +111,127 @@ export declare class AdminApi extends runtime.BaseAPI {
      * Cleanup Orphaned Invitations
      */
     cleanupOrphanedInvitations(requestParameters?: CleanupOrphanedInvitations0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CleanupOrphanedInvitations200Response>;
+    /**
+     * Admin only. This is how a partner comes to exist; there is no self-serve sign-up for one. **Before calling it**, the user who will administer the partner must exist and have the `partner` role (`PUT /admin/users/{userId}/role`). Every partner route belongs to that role, so a partner administered by an ordinary user would be created and then be unusable; such a request is refused with 400 and says so. A user with the `admin` role is accepted too. **A partner has no API key of its own, and none is issued.** The administrator calls the API with the `wgt_prt_` key of their own account: they make it themselves (`POST /users/{id}/keys`, or the dashboard\'s key screen), or Widgetic staff make it for them (the same route, called by an admin). The new partner starts with an empty wallet and no contract. Fund the wallet with `POST /admin/partners/{partnerId}/credits` and record the contract terms with `POST /partner-customizations/{partnerId}`. Neither is a field of this request, and a field this request does not name is refused with 400 rather than ignored. Creating the partner also records the partner plan on its administrator\'s own account (`plan.partner`). A partner is not bought, so without it the administrator\'s account looks like a free one and the pages it published stop being served after the free plan\'s seven days. If that record could not be written the partner is still created (a refusal would hide that it exists, and a retry would be a 409) and `warnings` says so; sending the status `active` for the partner again (`PUT /admin/partners/{partnerId}/status`) records it. Suspending or deactivating the partner stops those pages from being served. A partner `name` is unique: one already in use is refused with 409 and nothing is created. This route takes no `Idempotency-Key`: the unique name makes a retry safe on its own. A retry after a dropped response gets 409 for the partner the first attempt created; find it with `GET /admin/partners` (`searchTerm`).
+     * Create a partner
+     */
+    createPartnerRaw(requestParameters: CreatePartnerOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerWithWarnings>>;
+    /**
+     * Admin only. This is how a partner comes to exist; there is no self-serve sign-up for one. **Before calling it**, the user who will administer the partner must exist and have the `partner` role (`PUT /admin/users/{userId}/role`). Every partner route belongs to that role, so a partner administered by an ordinary user would be created and then be unusable; such a request is refused with 400 and says so. A user with the `admin` role is accepted too. **A partner has no API key of its own, and none is issued.** The administrator calls the API with the `wgt_prt_` key of their own account: they make it themselves (`POST /users/{id}/keys`, or the dashboard\'s key screen), or Widgetic staff make it for them (the same route, called by an admin). The new partner starts with an empty wallet and no contract. Fund the wallet with `POST /admin/partners/{partnerId}/credits` and record the contract terms with `POST /partner-customizations/{partnerId}`. Neither is a field of this request, and a field this request does not name is refused with 400 rather than ignored. Creating the partner also records the partner plan on its administrator\'s own account (`plan.partner`). A partner is not bought, so without it the administrator\'s account looks like a free one and the pages it published stop being served after the free plan\'s seven days. If that record could not be written the partner is still created (a refusal would hide that it exists, and a retry would be a 409) and `warnings` says so; sending the status `active` for the partner again (`PUT /admin/partners/{partnerId}/status`) records it. Suspending or deactivating the partner stops those pages from being served. A partner `name` is unique: one already in use is refused with 409 and nothing is created. This route takes no `Idempotency-Key`: the unique name makes a retry safe on its own. A retry after a dropped response gets 409 for the partner the first attempt created; find it with `GET /admin/partners` (`searchTerm`).
+     * Create a partner
+     */
+    createPartner(requestParameters: CreatePartnerOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerWithWarnings>;
+    /**
+     * The retained-window rollup for every JEV decision point: decision counts, `trustedRate` (jev vs legacy), the fallback reasons behind `degradedRate`, token before/after and the measured savings, routing and outcome counts (including the build-error auto-fix trio), the per-prompt recurrence ranking, and each decision point\'s effective rollout mode. The build-error anchor telemetry additionally breaks its `anchor_*` outcomes down by the anchor source that carried (`anchorsBySource`), so the malformed-SEARCH rate is watchable per excerpt resolution without log diving. The recurrence ranking is served at both horizons: `prompts` covers the in-process window, `promptsPersisted` the 28-day rolling counts kept in the shared store (null there means the store could not be asked — an outage is not a measured zero). The repair steering counts ride the same two horizons: `preferredToolsByRoute` is the per-class window cross-tab, `repairLeadsPersisted` the persisted error/finding/none tally over the same events, so the steer rate reads across restarts. Read-only, and computed from the same snapshot the logs are built from — no thresholds are applied here; the gates live in `__docs/10-jev/going-live.md`. Everything but `promptsPersisted` covers the current process, so restarts reset it.
+     * JEV decision rollup (admin)
+     */
+    getJevMetricsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
+    /**
+     * The retained-window rollup for every JEV decision point: decision counts, `trustedRate` (jev vs legacy), the fallback reasons behind `degradedRate`, token before/after and the measured savings, routing and outcome counts (including the build-error auto-fix trio), the per-prompt recurrence ranking, and each decision point\'s effective rollout mode. The build-error anchor telemetry additionally breaks its `anchor_*` outcomes down by the anchor source that carried (`anchorsBySource`), so the malformed-SEARCH rate is watchable per excerpt resolution without log diving. The recurrence ranking is served at both horizons: `prompts` covers the in-process window, `promptsPersisted` the 28-day rolling counts kept in the shared store (null there means the store could not be asked — an outage is not a measured zero). The repair steering counts ride the same two horizons: `preferredToolsByRoute` is the per-class window cross-tab, `repairLeadsPersisted` the persisted error/finding/none tally over the same events, so the steer rate reads across restarts. Read-only, and computed from the same snapshot the logs are built from — no thresholds are applied here; the gates live in `__docs/10-jev/going-live.md`. Everything but `promptsPersisted` covers the current process, so restarts reset it.
+     * JEV decision rollup (admin)
+     */
+    getJevMetrics(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
+    /**
+     * Admin only. What the partner\'s wallet did over the period, from the ledger: the totals (credits consumed and credits issued, over every row of the period however many there are), the same totals per calendar month, and, when `includeTransactions` is true, the newest ledger rows themselves. The period is the last 30 days when `startDate` and `endDate` are not given. A date that is not a date, or a start after the end, is refused with 400. The list of rows is bounded (the newest 1,000 of the period, complete); `transactionsTruncated` says when the period holds more than the list shows. The totals are never cut.
+     * Get a partner\'s wallet activity for a period
+     */
+    getPartnerBillingReportRaw(requestParameters: GetPartnerBillingReportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerBillingReport>>;
+    /**
+     * Admin only. What the partner\'s wallet did over the period, from the ledger: the totals (credits consumed and credits issued, over every row of the period however many there are), the same totals per calendar month, and, when `includeTransactions` is true, the newest ledger rows themselves. The period is the last 30 days when `startDate` and `endDate` are not given. A date that is not a date, or a start after the end, is refused with 400. The list of rows is bounded (the newest 1,000 of the period, complete); `transactionsTruncated` says when the period holds more than the list shows. The totals are never cut.
+     * Get a partner\'s wallet activity for a period
+     */
+    getPartnerBillingReport(requestParameters: GetPartnerBillingReportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerBillingReport>;
+    /**
+     * Admin only. The partner, with three things an administrator needs beside it: the billing overview (wallet, auto-reload settings, the ten newest ledger rows, the contract if one is recorded), the statistics of the last month\'s wallet activity, and a little metadata. The overview and the statistics are read at request time and are `null` when they could not be assembled: the partner itself is still returned. `monthlyStats.userCount` is `null` while the partner\'s member list cannot be read.
+     * Get a partner with its billing overview and last month\'s statistics
+     */
+    getPartnerDetailsRaw(requestParameters: GetPartnerDetailsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerDetails>>;
+    /**
+     * Admin only. The partner, with three things an administrator needs beside it: the billing overview (wallet, auto-reload settings, the ten newest ledger rows, the contract if one is recorded), the statistics of the last month\'s wallet activity, and a little metadata. The overview and the statistics are read at request time and are `null` when they could not be assembled: the partner itself is still returned. `monthlyStats.userCount` is `null` while the partner\'s member list cannot be read.
+     * Get a partner with its billing overview and last month\'s statistics
+     */
+    getPartnerDetails(requestParameters: GetPartnerDetailsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerDetails>;
+    /**
+     * Admin only. `scope=mine` is the signed-in admin\'s widgets. `scope=all` is every account. `preset=true` keeps widgets marked for signup copy. A normal account cannot call this route.
+     * List widgets for the admin console
+     */
+    listAdminWidgetsRaw(requestParameters: ListAdminWidgetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Admin only. `scope=mine` is the signed-in admin\'s widgets. `scope=all` is every account. `preset=true` keeps widgets marked for signup copy. A normal account cannot call this route.
+     * List widgets for the admin console
+     */
+    listAdminWidgets(requestParameters?: ListAdminWidgetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Admin only. One page of partners, newest first unless `sort` says otherwise. `status`, `searchTerm` and `sort` are applied before the page is cut, so `total` is the number of partners that match across all pages and every page is a page of matches. `searchTerm` matches the partner\'s name or billing email, whatever the case. It is plain text: characters such as `%`, `*` and `,` are searched for as themselves, not read as a pattern. `status` is the partner\'s standing: `active` (served), `inactive` (switched off), or `suspended` (switched off with a recorded reason; see `PUT /admin/partners/{partnerId}/status`).
+     * List partners
+     */
+    listPartnersRaw(requestParameters: ListPartnersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerList>>;
+    /**
+     * Admin only. One page of partners, newest first unless `sort` says otherwise. `status`, `searchTerm` and `sort` are applied before the page is cut, so `total` is the number of partners that match across all pages and every page is a page of matches. `searchTerm` matches the partner\'s name or billing email, whatever the case. It is plain text: characters such as `%`, `*` and `,` are searched for as themselves, not read as a pattern. `status` is the partner\'s standing: `active` (served), `inactive` (switched off), or `suspended` (switched off with a recorded reason; see `PUT /admin/partners/{partnerId}/status`).
+     * List partners
+     */
+    listPartners(requestParameters?: ListPartnersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerList>;
+    /**
+     * Admin only. Adds `amount` credits to the partner wallet as a refund. The `Idempotency-Key` header is required: a retry with the same key replays the first refund instead of issuing a second one. A refund is held to the same ceiling as a top-up: **at most $100,000 per operation** (1,000,000 credits at $0.10 per credit). A larger amount is refused with 400 and nothing is credited.
+     * Credit a partner\'s wallet back with a refund
+     */
+    refundPartnerCreditsRaw(requestParameters: RefundPartnerCreditsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Admin only. Adds `amount` credits to the partner wallet as a refund. The `Idempotency-Key` header is required: a retry with the same key replays the first refund instead of issuing a second one. A refund is held to the same ceiling as a top-up: **at most $100,000 per operation** (1,000,000 credits at $0.10 per credit). A larger amount is refused with 400 and nothing is credited.
+     * Credit a partner\'s wallet back with a refund
+     */
+    refundPartnerCredits(requestParameters: RefundPartnerCreditsOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Admin only. Every field is optional; send the ones to change. The profile fields (`name`, `email`, `webhookUrl`, `allowedDomains`, `billingSettings`) are stored on the partner. `autoReloadAmount` and `autoReloadThreshold` are stored with the partner\'s auto-reload settings, which are a different record: an edit to one of them keeps the other and the rest of the configuration. `creditBalance` is a **target balance**, not a stored value. The wallet is moved by the difference between it and the balance the ledger holds now, as a ledger row, by the same keyed path `POST /admin/partners/{partnerId}/credits` uses. So a request that sets it **must** carry an `Idempotency-Key` (a request without one is refused with 400 and changes nothing, not even the fields beside it), a top-up is held to the same ceiling of $100,000 per operation, and a retry with the same key replays the first result instead of moving the wallet twice. `notes` becomes the reason on that ledger row. A request that sets no balance needs no key. `isActive` only flips the switch. To suspend a partner with a recorded reason, or to reinstate one so that everything a suspension turned off is restored, use `PUT /admin/partners/{partnerId}/status`. The response is the partner as it is after the edit; `creditAdjustment` and `autoReload` report what was done to the wallet and the settings, when the request touched them.
+     * Edit a partner\'s profile, wallet balance or auto-reload settings
+     */
+    updatePartnerRaw(requestParameters: UpdatePartnerOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerUpdateResult>>;
+    /**
+     * Admin only. Every field is optional; send the ones to change. The profile fields (`name`, `email`, `webhookUrl`, `allowedDomains`, `billingSettings`) are stored on the partner. `autoReloadAmount` and `autoReloadThreshold` are stored with the partner\'s auto-reload settings, which are a different record: an edit to one of them keeps the other and the rest of the configuration. `creditBalance` is a **target balance**, not a stored value. The wallet is moved by the difference between it and the balance the ledger holds now, as a ledger row, by the same keyed path `POST /admin/partners/{partnerId}/credits` uses. So a request that sets it **must** carry an `Idempotency-Key` (a request without one is refused with 400 and changes nothing, not even the fields beside it), a top-up is held to the same ceiling of $100,000 per operation, and a retry with the same key replays the first result instead of moving the wallet twice. `notes` becomes the reason on that ledger row. A request that sets no balance needs no key. `isActive` only flips the switch. To suspend a partner with a recorded reason, or to reinstate one so that everything a suspension turned off is restored, use `PUT /admin/partners/{partnerId}/status`. The response is the partner as it is after the edit; `creditAdjustment` and `autoReload` report what was done to the wallet and the settings, when the request touched them.
+     * Edit a partner\'s profile, wallet balance or auto-reload settings
+     */
+    updatePartner(requestParameters: UpdatePartnerOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerUpdateResult>;
+    /**
+     * Admin only. Sets the partner\'s standing (the `status` field every partner response carries). - `active` reinstates the partner: it is switched on, and a suspension\'s reason and time are cleared.   It also records the partner plan on the partner\'s administrator again if that was missing (a partner   created before the plan was recorded, or whose write failed); if that could not be done the partner is   still reinstated and `warnings` says so. - `inactive` switches the partner off without a reason; a suspension\'s reason and time are cleared, so   a partner moved from suspended to inactive is no longer reported as suspended. - `suspended` switches the partner off and records `reason` (default `Suspended by admin`) and the time. While a partner is not `active` what it published is not served: the pages and embeds published under its administrator\'s account (the account whose own API key calls the API for the partner) stop being rendered, which is what \"embeds stop if unpaid\" means. Reinstating the partner restores them. A person who administers two partners is served while either is active, and an administrator account that also holds a subscription of its own is served on that. Sending the standing the partner already has is accepted; for `suspended` it replaces the recorded reason and time.
+     * Activate, deactivate or suspend a partner
+     */
+    updatePartnerStatusRaw(requestParameters: UpdatePartnerStatusOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerWithWarnings>>;
+    /**
+     * Admin only. Sets the partner\'s standing (the `status` field every partner response carries). - `active` reinstates the partner: it is switched on, and a suspension\'s reason and time are cleared.   It also records the partner plan on the partner\'s administrator again if that was missing (a partner   created before the plan was recorded, or whose write failed); if that could not be done the partner is   still reinstated and `warnings` says so. - `inactive` switches the partner off without a reason; a suspension\'s reason and time are cleared, so   a partner moved from suspended to inactive is no longer reported as suspended. - `suspended` switches the partner off and records `reason` (default `Suspended by admin`) and the time. While a partner is not `active` what it published is not served: the pages and embeds published under its administrator\'s account (the account whose own API key calls the API for the partner) stop being rendered, which is what \"embeds stop if unpaid\" means. Reinstating the partner restores them. A person who administers two partners is served while either is active, and an administrator account that also holds a subscription of its own is served on that. Sending the standing the partner already has is accepted; for `suspended` it replaces the recorded reason and time.
+     * Activate, deactivate or suspend a partner
+     */
+    updatePartnerStatus(requestParameters: UpdatePartnerStatusOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerWithWarnings>;
 }
+/**
+ * @export
+ */
+export declare const GetPartnerBillingReportIncludeTransactionsEnum: {
+    readonly True: "true";
+    readonly False: "false";
+};
+export type GetPartnerBillingReportIncludeTransactionsEnum = typeof GetPartnerBillingReportIncludeTransactionsEnum[keyof typeof GetPartnerBillingReportIncludeTransactionsEnum];
+/**
+ * @export
+ */
+export declare const ListAdminWidgetsScopeEnum: {
+    readonly Mine: "mine";
+    readonly All: "all";
+};
+export type ListAdminWidgetsScopeEnum = typeof ListAdminWidgetsScopeEnum[keyof typeof ListAdminWidgetsScopeEnum];
+/**
+ * @export
+ */
+export declare const ListAdminWidgetsPresetEnum: {
+    readonly True: "true";
+    readonly False: "false";
+};
+export type ListAdminWidgetsPresetEnum = typeof ListAdminWidgetsPresetEnum[keyof typeof ListAdminWidgetsPresetEnum];
+/**
+ * @export
+ */
+export declare const ListPartnersStatusEnum: {
+    readonly Active: "active";
+    readonly Inactive: "inactive";
+    readonly Suspended: "suspended";
+};
+export type ListPartnersStatusEnum = typeof ListPartnersStatusEnum[keyof typeof ListPartnersStatusEnum];