feat(marketplace): finish Vercel Marketplace integration (billing fix + dashboard + go-live wiring) (#1013)

Synced from sferarc/pgbeam@bb681f4

Author: SferaDev

src/generated/describe-map.gen.ts

@@ -45,6 +45,7 @@ export const describeByOperationId: Record<string, DescribeEndpoint> = {
   "exportAuditLogs": {"operationId":"exportAuditLogs","method":"GET","path":"/v1/projects/{project_id}/audit-logs/export","summary":"Export agent audit logs as CSV","description":"Streams the project's agent audit entries as a CSV file, newest first, honoring the same credential, event, decision, source and date-range filters as the list endpoint. The full filtered set is streamed (no pagination); the result is suitable for spreadsheets, SIEM ingestion, and compliance archives.","parameters":[{"name":"project_id","in":"path","required":true,"type":"string","description":"Unique project identifier (prefixed, e.g. prj_xxx)."},{"name":"credential_id","in":"query","required":false,"type":"string","description":"Filter to a single agent credential."},{"name":"event","in":"query","required":false,"type":"string","description":"Filter to a single event type (e.g. blocked, masked, query)."},{"name":"decision","in":"query","required":false,"type":"\"allow\" | \"block\" | \"mask\" | \"truncate\"","description":"Coarse outcome filter that groups events. `allow` = query; `block` = blocked, budget_exhausted, auth_failed, credential_expired; `mask` = masked; `truncate` = truncated."},{"name":"source","in":"query","required":false,"type":"\"wire\" | \"mcp\" | \"control\"","description":"Filter by statement origin (wire, mcp, or control)."},{"name":"start","in":"query","required":false,"type":"string","description":"Return entries at or after this timestamp (inclusive lower bound)."},{"name":"end","in":"query","required":false,"type":"string","description":"Return entries strictly older than this timestamp (cursor / upper bound)."}],"requestBodyType":"","requestBodyRequired":false,"responseType":"","responseStatus":"200"},
   "listPlans": {"operationId":"listPlans","method":"GET","path":"/v1/plans","summary":"List available plans","description":"Returns all available plan tiers with their limits and pricing.","parameters":[],"requestBodyType":"","requestBodyRequired":false,"responseType":"{ plans: ({ annual_price?: number; description?: string; label: string; limits: { bytes_per_month: number; included_seats: number; max_connections: number; max_databases: number; max_projects: number; max_query_shapes: number; queries_per_day: number; queries_per_second: number }; monthly_price: number; name: string; overage_text?: string; trial_days?: number })[] }","responseStatus":"200"},
   "getOrganizationPlan": {"operationId":"getOrganizationPlan","method":"GET","path":"/v1/organizations/{org_id}/plan","summary":"Get organization plan","description":"Returns the current plan and limits for the organization.","parameters":[{"name":"org_id","in":"path","required":true,"type":"string","description":"Unique organization identifier."}],"requestBodyType":"","requestBodyRequired":false,"responseType":"{ billing_provider?: \"stripe\" | \"vercel\" | \"aws\" | \"manual\"; created_at?: string; current_period_end?: string; custom_pricing?: boolean; enabled?: boolean; limits: { bytes_per_month: number; included_seats: number; max_connections: number; max_databases: number; max_projects: number; max_query_shapes: number; queries_per_day: number; queries_per_second: number }; org_id: string; plan: \"starter\" | \"pro\" | \"scale\" | \"enterprise\"; spend_limit?: number; subscription_status?: \"none\" | \"active\" | \"trialing\" | \"past_due\" | \"canceled\" | \"unpaid\" | \"incomplete\" | \"incomplete_expired\" | \"paused\"; updated_at?: string }","responseStatus":"200"},
+  "getVercelInstallation": {"operationId":"getVercelInstallation","method":"GET","path":"/v1/organizations/{org_id}/vercel-installation","summary":"Get Vercel Marketplace installation status","description":"Returns the Vercel Marketplace installation for the organization,\nincluding its provisioned resources and their current-period usage.\nReturns 404 when the organization was not provisioned through the\nVercel Marketplace. Powers the dashboard's Vercel integration page.\n","parameters":[{"name":"org_id","in":"path","required":true,"type":"string","description":"Unique organization identifier."}],"requestBodyType":"","requestBodyRequired":false,"responseType":"{ created_at?: string; installation_id: string; plan: string; resources: ({ billing_plan_id: string; name: string; period_bytes: number; period_queries: number; project_id: string; resource_id: string; status: \"ready\" | \"suspended\" | \"deleted\" })[]; status: string; vercel_account_id: string }","responseStatus":"200"},
   "updateSpendLimit": {"operationId":"updateSpendLimit","method":"PUT","path":"/v1/organizations/{org_id}/spend-limit","summary":"Update spend limit","description":"Sets the monthly spend limit for an organization. Null removes the limit.","parameters":[{"name":"org_id","in":"path","required":true,"type":"string","description":"Unique organization identifier."}],"requestBodyType":"{ spend_limit?: number }","requestBodyRequired":true,"responseType":"{ billing_provider?: \"stripe\" | \"vercel\" | \"aws\" | \"manual\"; created_at?: string; current_period_end?: string; custom_pricing?: boolean; enabled?: boolean; limits: { bytes_per_month: number; included_seats: number; max_connections: number; max_databases: number; max_projects: number; max_query_shapes: number; queries_per_day: number; queries_per_second: number }; org_id: string; plan: \"starter\" | \"pro\" | \"scale\" | \"enterprise\"; spend_limit?: number; subscription_status?: \"none\" | \"active\" | \"trialing\" | \"past_due\" | \"canceled\" | \"unpaid\" | \"incomplete\" | \"incomplete_expired\" | \"paused\"; updated_at?: string }","responseStatus":"200"},
   "submitCancellationFeedback": {"operationId":"submitCancellationFeedback","method":"POST","path":"/v1/organizations/{org_id}/cancellation-feedback","summary":"Submit cancellation feedback","description":"Records optional feedback when a user cancels their subscription.","parameters":[{"name":"org_id","in":"path","required":true,"type":"string","description":"Unique organization identifier."}],"requestBodyType":"{ feedback?: string; reason?: string }","requestBodyRequired":true,"responseType":"","responseStatus":"204"},
   "listDatabaseBranches": {"operationId":"listDatabaseBranches","method":"GET","path":"/v1/projects/{project_id}/branches","summary":"List sandbox branches","description":"Lists ephemeral sandbox branches for the project's databases.","parameters":[{"name":"project_id","in":"path","required":true,"type":"string","description":"Unique project identifier (prefixed, e.g. prj_xxx)."},{"name":"status","in":"query","required":false,"type":"\"pending\" | \"ready\" | \"error\" | \"discarded\"","description":"Filter to a single status."},{"name":"page_size","in":"query","required":false,"type":"number","description":"Maximum number of items to return (1-100, default 20)."},{"name":"page_token","in":"query","required":false,"type":"string","description":"Opaque token for cursor-based pagination."}],"requestBodyType":"","requestBodyRequired":false,"responseType":"{ branches: ({ branch_name: string; created_at: string; credential_id?: string; database_id: string; discarded_at?: string; error?: string; expires_at?: string; id: string; session_id?: string; status: \"pending\" | \"ready\" | \"error\" | \"discarded\" })[]; next_page_token?: string }","responseStatus":"200"},

src/generated/index.ts

@@ -64,6 +64,7 @@ export type { GetProjectUsagePathProjectId, GetProjectUsageQueryEndDate, GetProj
 export type { GetSchemaCatalogPathDatabaseId, GetSchemaCatalogPathProjectId, GetSchemaCatalogRequestConfig, GetSchemaCatalogResponse, GetSchemaCatalogResponses, GetSchemaCatalogStatus200, GetSchemaCatalogStatus400, GetSchemaCatalogStatus401, GetSchemaCatalogStatus403, GetSchemaCatalogStatus404, GetSchemaCatalogStatus429 } from "./types/GetSchemaCatalog";
 export type { GetSupportCasePathCaseId, GetSupportCasePathOrgId, GetSupportCaseRequestConfig, GetSupportCaseResponses, GetSupportCaseStatus200, GetSupportCaseStatus400, GetSupportCaseStatus401, GetSupportCaseStatus403, GetSupportCaseStatus404 } from "./types/GetSupportCase";
 export type { GetSupportCaseResponse } from "./types/GetSupportCaseResponse";
+export type { GetVercelInstallationPathOrgId, GetVercelInstallationRequestConfig, GetVercelInstallationResponse, GetVercelInstallationResponses, GetVercelInstallationStatus200, GetVercelInstallationStatus400, GetVercelInstallationStatus401, GetVercelInstallationStatus403, GetVercelInstallationStatus404, GetVercelInstallationStatus429 } from "./types/GetVercelInstallation";
 export type { GetWebhookEndpointPathProjectId, GetWebhookEndpointPathWebhookId, GetWebhookEndpointRequestConfig, GetWebhookEndpointResponse, GetWebhookEndpointResponses, GetWebhookEndpointStatus200, GetWebhookEndpointStatus400, GetWebhookEndpointStatus401, GetWebhookEndpointStatus403, GetWebhookEndpointStatus404 } from "./types/GetWebhookEndpoint";
 export type { HandleSlackSupportEventData, HandleSlackSupportEventRequestConfig, HandleSlackSupportEventResponse, HandleSlackSupportEventResponses, HandleSlackSupportEventStatus200, HandleSlackSupportEventStatus400, HandleSlackSupportEventStatus401, HandleSlackSupportEventStatus404 } from "./types/HandleSlackSupportEvent";
 export type { HealthResponse, HealthResponseStatusEnumKey } from "./types/HealthResponse";
@@ -165,6 +166,8 @@ export type { UpdateSupportCaseData, UpdateSupportCasePathCaseId, UpdateSupportC
 export type { UpdateSupportCaseRequest } from "./types/UpdateSupportCaseRequest";
 export type { UpdateWebhookEndpointData, UpdateWebhookEndpointPathProjectId, UpdateWebhookEndpointPathWebhookId, UpdateWebhookEndpointRequestConfig, UpdateWebhookEndpointResponse, UpdateWebhookEndpointResponses, UpdateWebhookEndpointStatus200, UpdateWebhookEndpointStatus400, UpdateWebhookEndpointStatus401, UpdateWebhookEndpointStatus403, UpdateWebhookEndpointStatus404 } from "./types/UpdateWebhookEndpoint";
 export type { UsageResponse } from "./types/UsageResponse";
+export type { VercelInstallationStatus } from "./types/VercelInstallationStatus";
+export type { VercelResourceStatus, VercelResourceStatusStatusEnumKey } from "./types/VercelResourceStatus";
 export type { VerifyCustomDomainPathDomainId, VerifyCustomDomainPathProjectId, VerifyCustomDomainRequestConfig, VerifyCustomDomainResponses, VerifyCustomDomainStatus200, VerifyCustomDomainStatus400, VerifyCustomDomainStatus401, VerifyCustomDomainStatus403, VerifyCustomDomainStatus404, VerifyCustomDomainStatus429 } from "./types/VerifyCustomDomain";
 export type { VerifyCustomDomainResponse } from "./types/VerifyCustomDomainResponse";
 export type { WebhookEndpoint, WebhookEndpointFormatEnumKey } from "./types/WebhookEndpoint";
@@ -202,5 +205,6 @@ export { supportMessageSource } from "./types/SupportMessageSource";
 export { updateAgentCredentialStatusRequestStatusEnum } from "./types/UpdateAgentCredentialStatusRequest";
 export { updateAnomalyAlertRequestStatusEnum } from "./types/UpdateAnomalyAlertRequest";
 export { updateOnboardingRequestStepEnum } from "./types/UpdateOnboardingRequest";
+export { vercelResourceStatusStatusEnum } from "./types/VercelResourceStatus";
 export { webhookEndpointFormatEnum } from "./types/WebhookEndpoint";
 export { webhookEndpointInputFormatEnum } from "./types/WebhookEndpointInput";

src/generated/operations-map.gen.ts

@@ -19,6 +19,7 @@ import type { ListAuditLogsRequestConfig, ListAuditLogsStatus200 } from "./types
 import type { ExportAuditLogsRequestConfig, ExportAuditLogsStatus200 } from "./types/ExportAuditLogs";
 import type { ListPlansStatus200 } from "./types/ListPlans";
 import type { GetOrganizationPlanRequestConfig, GetOrganizationPlanStatus200 } from "./types/GetOrganizationPlan";
+import type { GetVercelInstallationRequestConfig, GetVercelInstallationStatus200 } from "./types/GetVercelInstallation";
 import type { UpdateSpendLimitRequestConfig, UpdateSpendLimitStatus200 } from "./types/UpdateSpendLimit";
 import type { SubmitCancellationFeedbackRequestConfig } from "./types/SubmitCancellationFeedback";
 import type { ListDatabaseBranchesRequestConfig, ListDatabaseBranchesStatus200 } from "./types/ListDatabaseBranches";
@@ -101,6 +102,7 @@ export const operationsByTag = {
   analytics: {
     listPlans: { method: "GET", path: "/v1/plans" },
     getOrganizationPlan: { method: "GET", path: "/v1/organizations/{org_id}/plan" },
+    getVercelInstallation: { method: "GET", path: "/v1/organizations/{org_id}/vercel-installation" },
     updateSpendLimit: { method: "PUT", path: "/v1/organizations/{org_id}/spend-limit" },
     submitCancellationFeedback: { method: "POST", path: "/v1/organizations/{org_id}/cancellation-feedback" },
     getProjectInsights: { method: "GET", path: "/v1/projects/{project_id}/insights" },
@@ -190,6 +192,7 @@ export const operationsByPath = {
   "GET /v1/projects/{project_id}/audit-logs/export": { method: "GET", path: "/v1/projects/{project_id}/audit-logs/export", operationId: "exportAuditLogs" },
   "GET /v1/plans": { method: "GET", path: "/v1/plans", operationId: "listPlans" },
   "GET /v1/organizations/{org_id}/plan": { method: "GET", path: "/v1/organizations/{org_id}/plan", operationId: "getOrganizationPlan" },
+  "GET /v1/organizations/{org_id}/vercel-installation": { method: "GET", path: "/v1/organizations/{org_id}/vercel-installation", operationId: "getVercelInstallation" },
   "PUT /v1/organizations/{org_id}/spend-limit": { method: "PUT", path: "/v1/organizations/{org_id}/spend-limit", operationId: "updateSpendLimit" },
   "POST /v1/organizations/{org_id}/cancellation-feedback": { method: "POST", path: "/v1/organizations/{org_id}/cancellation-feedback", operationId: "submitCancellationFeedback" },
   "GET /v1/projects/{project_id}/branches": { method: "GET", path: "/v1/projects/{project_id}/branches", operationId: "listDatabaseBranches" },
@@ -259,6 +262,7 @@ type RejectApprovalRequestParams = { pathParams: NonNullable<RejectApprovalReque
 type ListAuditLogsParams = { pathParams: NonNullable<ListAuditLogsRequestConfig["pathParams"]>; queryParams?: NonNullable<ListAuditLogsRequestConfig["queryParams"]> };
 type ExportAuditLogsParams = { pathParams: NonNullable<ExportAuditLogsRequestConfig["pathParams"]>; queryParams?: NonNullable<ExportAuditLogsRequestConfig["queryParams"]> };
 type GetOrganizationPlanParams = { pathParams: NonNullable<GetOrganizationPlanRequestConfig["pathParams"]> };
+type GetVercelInstallationParams = { pathParams: NonNullable<GetVercelInstallationRequestConfig["pathParams"]> };
 type UpdateSpendLimitParams = { pathParams: NonNullable<UpdateSpendLimitRequestConfig["pathParams"]>; body: NonNullable<UpdateSpendLimitRequestConfig["data"]> };
 type SubmitCancellationFeedbackParams = { pathParams: NonNullable<SubmitCancellationFeedbackRequestConfig["pathParams"]>; body: NonNullable<SubmitCancellationFeedbackRequestConfig["data"]> };
 type ListDatabaseBranchesParams = { pathParams: NonNullable<ListDatabaseBranchesRequestConfig["pathParams"]>; queryParams?: NonNullable<ListDatabaseBranchesRequestConfig["queryParams"]> };
@@ -339,6 +343,7 @@ export interface ApiOperations {
   analytics: {
     listPlans(): Promise<ListPlansStatus200>;
     getOrganizationPlan(params: GetOrganizationPlanParams): Promise<GetOrganizationPlanStatus200>;
+    getVercelInstallation(params: GetVercelInstallationParams): Promise<GetVercelInstallationStatus200>;
     updateSpendLimit(params: UpdateSpendLimitParams): Promise<UpdateSpendLimitStatus200>;
     submitCancellationFeedback(params: SubmitCancellationFeedbackParams): Promise<void>;
     getProjectInsights(params: GetProjectInsightsParams): Promise<GetProjectInsightsStatus200>;
@@ -428,6 +433,7 @@ export interface RequestMap {
   "GET /v1/projects/{project_id}/audit-logs/export": { params: ExportAuditLogsParams; response: ExportAuditLogsStatus200 };
   "GET /v1/plans": { params?: undefined; response: ListPlansStatus200 };
   "GET /v1/organizations/{org_id}/plan": { params: GetOrganizationPlanParams; response: GetOrganizationPlanStatus200 };
+  "GET /v1/organizations/{org_id}/vercel-installation": { params: GetVercelInstallationParams; response: GetVercelInstallationStatus200 };
   "PUT /v1/organizations/{org_id}/spend-limit": { params: UpdateSpendLimitParams; response: UpdateSpendLimitStatus200 };
   "POST /v1/organizations/{org_id}/cancellation-feedback": { params: SubmitCancellationFeedbackParams; response: void };
   "GET /v1/projects/{project_id}/branches": { params: ListDatabaseBranchesParams; response: ListDatabaseBranchesStatus200 };

src/generated/types/GetVercelInstallation.ts

@@ -0,0 +1,87 @@
+/**
+* Generated by Kubb (https://kubb.dev/).
+* Do not edit manually.
+*/
+
+import type { Error } from "./Error";
+import type { VercelInstallationStatus } from "./VercelInstallationStatus";
+
+/**
+ * @description Unique organization identifier.
+ * @pattern ^[a-zA-Z0-9_.-]+$
+ * @example org_abc123
+ * @type string
+*/
+export type GetVercelInstallationPathOrgId = string;
+
+/**
+ * @description Vercel Marketplace installation status for an organization, including its resources.
+ * @type object
+*/
+export type GetVercelInstallationStatus200 = VercelInstallationStatus;
+
+/**
+ * @description Standard error response envelope for PgBeam API requests.
+ * @type object
+*/
+export type GetVercelInstallationStatus400 = Error;
+
+/**
+ * @description Standard error response envelope for PgBeam API requests.
+ * @type object
+*/
+export type GetVercelInstallationStatus401 = Error;
+
+/**
+ * @description Standard error response envelope for PgBeam API requests.
+ * @type object
+*/
+export type GetVercelInstallationStatus403 = Error;
+
+/**
+ * @description Standard error response envelope for PgBeam API requests.
+ * @type object
+*/
+export type GetVercelInstallationStatus404 = Error;
+
+/**
+ * @description Standard error response envelope for PgBeam API requests.
+ * @type object
+*/
+export type GetVercelInstallationStatus429 = Error;
+
+/**
+ * @type object
+*/
+export type GetVercelInstallationRequestConfig = {
+    data?: never;
+    /**
+     * @type object
+    */
+    pathParams: {
+        org_id: GetVercelInstallationPathOrgId;
+    };
+    queryParams?: never;
+    headerParams?: never;
+    /**
+     * @type string
+    */
+    url: `/v1/organizations/${string}/vercel-installation`;
+};
+
+/**
+ * @type object
+*/
+export type GetVercelInstallationResponses = {
+    "200": GetVercelInstallationStatus200;
+    "400": GetVercelInstallationStatus400;
+    "401": GetVercelInstallationStatus401;
+    "403": GetVercelInstallationStatus403;
+    "404": GetVercelInstallationStatus404;
+    "429": GetVercelInstallationStatus429;
+};
+
+/**
+ * @description Union of all possible responses
+*/
+export type GetVercelInstallationResponse = (GetVercelInstallationStatus200 | GetVercelInstallationStatus400 | GetVercelInstallationStatus401 | GetVercelInstallationStatus403 | GetVercelInstallationStatus404 | GetVercelInstallationStatus429);

src/generated/types/VercelInstallationStatus.ts

@@ -0,0 +1,43 @@
+/**
+* Generated by Kubb (https://kubb.dev/).
+* Do not edit manually.
+*/
+
+import type { VercelResourceStatus } from "./VercelResourceStatus";
+
+/**
+ * @description Vercel Marketplace installation status for an organization, including its resources.
+ * @type object
+*/
+export type VercelInstallationStatus = {
+    /**
+     * @description Vercel installation (integration configuration) identifier.
+     * @type string
+    */
+    installation_id: string;
+    /**
+     * @description Vercel account/team identifier that owns the installation.
+     * @type string
+    */
+    vercel_account_id: string;
+    /**
+     * @description Current plan tier for the organization.
+     * @type string
+    */
+    plan: string;
+    /**
+     * @description Installation status (active).
+     * @type string
+    */
+    status: string;
+    /**
+     * @description When the installation was created.
+     * @type string | undefined
+    */
+    created_at?: string;
+    /**
+     * @description Resources (projects) provisioned under this installation.
+     * @type array
+    */
+    resources: VercelResourceStatus[];
+};