@muxoai/sdk 1.2.3 → 1.4.2

package/dist/providers/stripe-projects.d.ts

@@ -0,0 +1,508 @@
+import { type MuxoConfig } from "../config.js";
+import type { MuxoTool } from "../types.js";
+export declare const DEFAULT_STRIPE_PROVISIONING_API_VERSION = "2026-09-30.preview";
+export interface StripeV2ListResponse<T> {
+    object: "v2.list";
+    data: T[];
+    next_page_url: string | null;
+    previous_page_url: string | null;
+}
+export interface StripeV2Eligibility {
+    object: "v2.provisioning.eligibility";
+    is_eligible: boolean;
+    livemode: boolean;
+    requirements: string[];
+}
+export interface StripeV2Provider {
+    id: string;
+    object: "v2.provisioning.provider";
+    name: string;
+    description: string | null;
+    categories: string[];
+    capabilities?: {
+        custom_configuration?: boolean;
+        link_existing_resources?: boolean;
+    };
+    configuration_schema?: Record<string, unknown> | null;
+    llm_context?: string | null;
+    tos_url?: string | null;
+    website_url?: string | null;
+    privacy_policy_url?: string | null;
+    created?: string;
+}
+export interface StripeV2ProviderServiceDetail {
+    id: string;
+    object: "v2.provisioning.provider_service_detail";
+    provider: string;
+    provider_name: string;
+    service_id: string;
+    description: string | null;
+    categories: string[];
+    kind: "deployable" | "plan";
+    availability: "available" | "coming_soon" | "unavailable" | string;
+    scope?: "account" | "project" | string;
+    configuration_schema?: Record<string, unknown> | null;
+    pricing?: Record<string, unknown> | null;
+    allowed_updates?: Record<string, unknown> | null;
+    constraints?: Record<string, unknown> | null;
+    llm_context?: string | null;
+}
+export interface StripeV2UsageLimit {
+    max_amount: string | number;
+    currency: string;
+    recurring_interval: "day" | "week" | "month" | "year" | string;
+}
+export interface StripeV2PaymentProfile {
+    object?: "v2.provisioning.payment_profile";
+    card_last4: string | null;
+    usage_limits: StripeV2UsageLimit | null;
+    providers: Array<{
+        provider: string;
+        usage_limits: StripeV2UsageLimit | null;
+    }>;
+    payment_method_owner: "platform" | string | null;
+    livemode: boolean;
+    has_payment_method?: boolean;
+}
+export interface StripeV2PaymentMethodRequest {
+    object?: "v2.provisioning.payment_method_request";
+    checkout_session_url: string;
+    status: "checkout_initiated" | "complete" | string;
+    livemode?: boolean;
+}
+export interface StripeV2Project {
+    id: string;
+    object?: "v2.provisioning.project";
+    name: string;
+    catalog: "dev" | "prod" | "testing" | string;
+    created: string;
+    project_profile?: string | null;
+    livemode?: boolean;
+}
+export interface StripeV2ProviderConnection {
+    id: string;
+    object?: "v2.provisioning.provider_connection";
+    provider: string;
+    provider_account?: string | null;
+    provider_account_details?: Record<string, unknown> | null;
+    status: "active" | "expired" | "unknown" | string;
+    created?: string | null;
+    livemode?: boolean;
+}
+export interface StripeV2ProviderConnectionRequest {
+    id: string;
+    object?: "v2.provisioning.provider_connection_request";
+    provider: string;
+    request_status?: "complete" | "error" | "needs_information" | "pending_auth" | "requested" | string;
+    redirect_url?: string | null;
+    needs_information_schema?: Record<string, unknown> | null;
+    provider_connection?: StripeV2ProviderConnection | null;
+    error?: Record<string, unknown> | null;
+    scopes?: string[];
+    created?: string | null;
+    livemode?: boolean;
+}
+export interface StripeV2Resource {
+    id: string;
+    object?: "v2.provisioning.resource";
+    provider?: string;
+    service_ref?: string;
+    project?: string | null;
+    status: "pending" | "needs_information" | "complete" | "errored" | "removed" | "provisioning" | "active" | "ready" | "pending_user_action" | string;
+    name?: string | null;
+    environment?: "dev" | "prod" | string;
+    catalog?: "dev" | "prod" | "testing" | string;
+    needs_information_schema?: Record<string, unknown> | null;
+    pending_action?: {
+        type?: string;
+        redirect_url?: string | null;
+        required_information_schema?: Record<string, unknown> | null;
+        [key: string]: unknown;
+    } | null;
+    error_message?: string | null;
+    user_message?: Record<string, unknown> | null;
+    created?: string;
+    livemode?: boolean;
+}
+export interface StripeV2AccessConfiguration {
+    object: "v2.provisioning.resource_access_configuration" | "v2.provisioning.resource.access_configuration" | string;
+    resource: string;
+    configuration: Record<string, string>;
+    created: string;
+    expires_at?: string | null;
+    livemode: boolean;
+}
+export interface StripeV2ConnectedAccount {
+    id: string;
+    object?: "v2.core.account" | string;
+    contact_email?: string | null;
+    display_name?: string | null;
+    identity?: {
+        country?: string;
+        entity_type?: "individual" | "company" | string;
+    } | null;
+    configuration?: {
+        developer?: {
+            capabilities?: {
+                projects?: {
+                    requested?: boolean;
+                    status?: "active" | "pending" | "inactive" | "unrequested" | string;
+                };
+            };
+        };
+    } | null;
+    requirements?: Record<string, unknown> | null;
+    livemode?: boolean;
+}
+export interface StripeV2AccountLink {
+    object?: "v2.core.account_link" | string;
+    account: string;
+    url: string;
+    created?: string;
+    expires_at?: string;
+    livemode?: boolean;
+}
+export interface StripeConnectedAccountSession {
+    object: "account_session" | string;
+    account: string;
+    client_secret: string;
+    components: {
+        account_onboarding?: {
+            enabled: boolean;
+            features?: {
+                external_account_collection?: boolean;
+                disable_stripe_user_authentication?: boolean;
+            };
+        };
+        account_management?: {
+            enabled: boolean;
+            features?: {
+                external_account_collection?: boolean;
+                disable_stripe_user_authentication?: boolean;
+            };
+        };
+        [key: string]: unknown;
+    };
+    expires_at: number;
+    livemode: boolean;
+    source?: "stripe_v2_api" | "muxo_managed";
+}
+export interface StripeProvisioningAuditEntry {
+    id: string;
+    method: "GET" | "POST";
+    endpoint: string;
+    stripeContext: string | null;
+    intendedWrite: Record<string, unknown> | null;
+    requestId: string | null;
+    objectId: string | null;
+    objectStatus: string | null;
+    httpStatus: number | null;
+    errorCode: string | null;
+    requestLogUrl: string | null;
+    workflowStatus: "pending" | "completed" | "requires_review" | "errored";
+    startedAt: string;
+    completedAt: string | null;
+}
+export declare function redactProvisioningSecrets(value: unknown): Record<string, unknown> | null;
+export declare function classifyStripeProvisioningError(err: {
+    code?: string;
+    status?: number;
+    message?: string;
+}): {
+    platformAction: string;
+    workflowStatus: "errored" | "requires_review";
+    retryable: boolean;
+};
+export declare function isPaidCloudProvisioning(tool: MuxoTool, input?: Record<string, unknown>): boolean;
+export declare class StripeProjectsAdapter {
+    private readonly config;
+    private readonly tools;
+    private readonly providerByName;
+    private readonly seededProviders;
+    private readonly seededServices;
+    constructor(config: MuxoConfig);
+    private loadCatalogSeed;
+    getTools(): MuxoTool[];
+    searchTools(query?: string, limit?: number): MuxoTool[];
+    inspectTool(slug: string): MuxoTool | null;
+    hasProvider(providerSlug: string): boolean;
+    private runStripeProjectsCli;
+    private get hasLocalProjectsWorkdir();
+    private provisioningAuditLog;
+    private hostedSites;
+    getHostedSiteHtml(slug: string, filePath?: string): string | null;
+    private attachHostingDeployment;
+    getProvisioningAuditLog(limit?: number): StripeProvisioningAuditEntry[];
+    private resolveStripeSecretKey;
+    isLivemodeKey(apiKeyOverride?: string | null): boolean;
+    resolveStripeContext(stripeContextOverride?: string | null): string | null;
+    hasStripeV2ApiKey(apiKeyOverride?: string | null): boolean;
+    get provisioningApiVersion(): string;
+    get stripeApiBaseUrl(): string;
+    requestV2Provisioning<T = Record<string, unknown>>(method: "GET" | "POST", endpointPath: string, options?: {
+        query?: Record<string, string | number | boolean | undefined>;
+        body?: Record<string, unknown>;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+        apiVersionOverride?: string;
+        idempotencyKey?: string;
+        timeoutMs?: number;
+        maxRateLimitRetries?: number;
+    }): Promise<T>;
+    paginateV2List<T>(initialPath: string, options?: {
+        query?: Record<string, string | number | boolean | undefined>;
+        maxPages?: number;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2ListResponse<T>>;
+    createConnectedAccount(params: {
+        contact_email: string;
+        display_name: string;
+        country?: string;
+        entity_type?: "individual" | "company";
+        apiKeyOverride?: string | null;
+    }): Promise<StripeV2ConnectedAccount>;
+    createConnectedAccountLink(params: {
+        account: string;
+        type?: "account_onboarding" | "account_update";
+        fields?: "currently_due" | "eventually_due";
+        future_requirements?: "include" | "omit";
+        refresh_url: string;
+        return_url: string;
+        apiKeyOverride?: string | null;
+    }): Promise<StripeV2AccountLink>;
+    createConnectedAccountSession(params: {
+        account: string;
+        enableAccountManagement?: boolean;
+        enableNotificationBanner?: boolean;
+        disableStripeUserAuthentication?: boolean;
+        externalAccountCollection?: boolean;
+        apiKeyOverride?: string | null;
+    }): Promise<StripeConnectedAccountSession>;
+    retrieveConnectedAccount(accountId: string, apiKeyOverride?: string | null): Promise<StripeV2ConnectedAccount>;
+    checkEligibility(apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2Eligibility & {
+        ready: boolean;
+        platform_action: string;
+        source: "stripe_v2_api" | "muxo_managed";
+    }>;
+    listCatalogProviders(params?: {
+        catalog?: "dev" | "prod" | "testing";
+        development?: boolean;
+        limit?: number;
+        page?: string;
+        page_url?: string;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2ListResponse<StripeV2Provider> & {
+        source: "stripe_v2_api" | "muxo_catalog_seed";
+    }>;
+    listCatalogServices(params?: {
+        catalog?: "dev" | "prod" | "testing";
+        development?: boolean;
+        limit?: number;
+        page?: string;
+        page_url?: string;
+        provider_id?: string;
+        provider_name?: string;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2ListResponse<StripeV2ProviderServiceDetail> & {
+        source: "stripe_v2_api" | "muxo_catalog_seed";
+    }>;
+    getPaymentProfile(params?: {
+        provider?: string;
+        livemode?: boolean;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2PaymentProfile & {
+        source: "stripe_v2_api" | "muxo_managed";
+    }>;
+    updatePaymentProfileLimit(params: {
+        usage_limits: StripeV2UsageLimit;
+        provider?: string;
+        livemode?: boolean;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2PaymentProfile & {
+        source: "stripe_v2_api" | "muxo_managed";
+    }>;
+    createPaymentMethodRequest(params?: {
+        usage_limits?: StripeV2UsageLimit;
+        payment_method_owner?: "platform" | "provider";
+        provider?: string;
+        source_account?: string;
+        source_customer?: string;
+        source_payment_method?: string;
+        livemode?: boolean;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2PaymentMethodRequest & {
+        source: "stripe_v2_api" | "muxo_managed";
+    }>;
+    createProject(params: {
+        name: string;
+        catalog?: "dev" | "prod" | "testing";
+        project_profile?: string;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2Project & {
+        source: "stripe_v2_api" | "muxo_managed";
+    }>;
+    listProviderConnections(params?: {
+        limit?: number;
+        page?: string;
+        page_url?: string;
+        provider?: string;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2ListResponse<StripeV2ProviderConnection>>;
+    unlinkProviderConnection(connectionId: string, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2ProviderConnection>;
+    createProviderConnectionRequest(params: {
+        provider: string;
+        configuration?: Record<string, unknown>;
+        project?: string;
+        code_challenge?: string;
+        code_challenge_method?: "S256";
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2ProviderConnectionRequest>;
+    retrieveProviderConnectionRequest(requestId: string, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2ProviderConnectionRequest>;
+    submitProviderConnectionRequestInformation(requestId: string, paramsOrInfo: {
+        information?: Record<string, unknown>;
+        confirmation_secret?: string;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+        [key: string]: unknown;
+    }, apiKeyOverride?: string | null): Promise<StripeV2ProviderConnectionRequest>;
+    createResource(params: {
+        provider: string;
+        service_ref: string;
+        configuration: Record<string, unknown>;
+        project?: string;
+        scope?: "account" | "project" | string;
+        name?: string;
+        environment?: string;
+        catalog?: "dev" | "prod" | "testing";
+        livemode?: boolean;
+        idempotencyKey?: string;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2Resource>;
+    retrieveResource(resourceId: string, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2Resource>;
+    waitForResourceReady(resourceId: string, options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2Resource>;
+    updateResource(resourceId: string, paramsOrConfig: {
+        configuration?: Record<string, unknown>;
+        service_ref?: string;
+        catalog?: "dev" | "prod" | "testing";
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+        [key: string]: unknown;
+    }, apiKeyOverride?: string | null): Promise<StripeV2Resource>;
+    linkResource(params: {
+        provider: string;
+        service_ref: string;
+        provider_resource_id?: string;
+        project?: string;
+        environment?: string;
+        catalog?: "dev" | "prod" | "testing";
+        livemode?: boolean;
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<StripeV2Resource>;
+    removeResource(resourceId: string, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2Resource>;
+    unlinkResource(resourceId: string, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2Resource>;
+    rotateResourceCredentials(resourceId: string, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2Resource>;
+    submitResourceInformation(resourceId: string, submittedInformation: Record<string, unknown>, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2Resource>;
+    revealAccessConfiguration(resourceId: string, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<StripeV2AccessConfiguration>;
+    createV2EventDestination(params: {
+        name?: string;
+        url: string;
+        events?: string[];
+        apiKeyOverride?: string | null;
+    }): Promise<{
+        id: string;
+        object: "v2.core.event_destination";
+        name: string;
+        status: "enabled" | "disabled";
+        enabled_events: string[];
+        webhook_endpoint: {
+            url: string;
+        };
+        livemode: boolean;
+        source: "stripe_v2_api" | "muxo_managed";
+    }>;
+    handleV2ProvisioningEvent(params: {
+        event: {
+            id?: string;
+            type: string;
+            context?: string;
+            related_object?: {
+                id: string;
+                type: string;
+                url?: string;
+            };
+            data?: Record<string, unknown>;
+        };
+        apiKeyOverride?: string | null;
+        stripeContext?: string | null;
+    }): Promise<{
+        eventId: string;
+        eventType: string;
+        relatedObjectId: string | null;
+        actionTaken: string;
+        revealedConfiguration?: Record<string, string>;
+        resource?: Partial<StripeV2Resource>;
+    }>;
+    getLiveStatus(apiKeyOverride?: string | null): Promise<{
+        authenticated: boolean;
+        projectInitialized: boolean;
+        projectId: string | null;
+        projectName: string | null;
+        apiVersion?: string;
+        eligibility?: StripeV2Eligibility;
+        providers: Array<{
+            id: string;
+            name: string;
+            slug: string;
+            status: "active" | "pending" | "expired";
+            redirectUrl: string | null;
+        }>;
+        services: Array<Record<string, unknown>>;
+        plans: Array<Record<string, unknown>>;
+    }>;
+    linkProvider(providerSlug: string, apiKeyOverride?: string | null, stripeContext?: string | null): Promise<{
+        providerSlug: string;
+        status: "active" | "pending" | "requires_review";
+        redirectUrl: string | null;
+        connectionId?: string | null;
+        connectionRequestId?: string | null;
+        needsInformationSchema?: Record<string, unknown> | null;
+        workflowStatus?: string;
+        message: string;
+    }>;
+    pullEnvVarsFromWorkdir(syncFromCli?: boolean): Promise<Record<string, string>>;
+    executeTool(params: {
+        workspaceId: string;
+        tool: MuxoTool;
+        input: Record<string, unknown>;
+        stripeApiKey?: string | null;
+        masterWalletDepleted?: boolean;
+    }): Promise<{
+        output: Record<string, unknown>;
+        provisionedResource?: {
+            resourceName: string;
+            providerSlug: string;
+            providerName: string;
+            serviceSlug: string;
+            planSlug?: string | null;
+            status: "active" | "removed";
+            secrets?: Record<string, string>;
+            externalResourceId?: string | null;
+        };
+    }>;
+}