@dotdo/do 0.1.0

package/dist/do/business/financial/stripe.js

@@ -0,0 +1,261 @@
+/**
+ * Stripe Connect Integration
+ *
+ * Provides Stripe Connect functionality for multi-party payments:
+ * - Account creation (Standard, Express, Custom)
+ * - Onboarding flow management
+ * - Capability monitoring
+ * - Bank account management
+ *
+ * @module financial/stripe
+ */
+/**
+ * Stripe Connect manager for Digital Objects
+ *
+ * Handles Stripe Connect account lifecycle including creation,
+ * onboarding, and capability management.
+ *
+ * @example
+ * ```typescript
+ * const connect = new StripeConnect({ secretKey: env.STRIPE_SECRET_KEY })
+ *
+ * // Create a new connected account
+ * const account = await connect.createAccount('express', businessRef, {
+ *   businessProfile: { name: 'Acme Corp' }
+ * })
+ *
+ * // Generate onboarding link
+ * const link = await connect.createAccountLink(
+ *   account.stripeAccountId,
+ *   'https://example.com/return',
+ *   'https://example.com/refresh'
+ * )
+ * ```
+ */
+export class StripeConnect {
+    config;
+    /**
+     * Create a new StripeConnect instance
+     *
+     * @param config - Stripe Connect configuration
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Create a new Stripe Connect account
+     *
+     * @param type - Account type (standard, express, or custom)
+     * @param businessRef - Reference to the Business DO
+     * @param options - Additional account options
+     * @returns The created Connect account
+     *
+     * @example
+     * ```typescript
+     * const account = await connect.createAccount('express', businessRef)
+     * console.log(account.stripeAccountId) // 'acct_xxx'
+     * ```
+     */
+    async createAccount(type, businessRef, options) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Retrieve a Connect account by Stripe account ID
+     *
+     * @param stripeAccountId - The Stripe account ID (acct_xxx)
+     * @returns The Connect account or null if not found
+     */
+    async getAccount(stripeAccountId) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Update a Connect account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param updates - Fields to update
+     * @returns The updated account
+     */
+    async updateAccount(stripeAccountId, updates) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Delete a Connect account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     */
+    async deleteAccount(stripeAccountId) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Create an account link for onboarding or updates
+     *
+     * Account links are single-use URLs that redirect the account holder
+     * to Stripe-hosted onboarding or account management.
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param returnUrl - URL to redirect after completion
+     * @param refreshUrl - URL to redirect if link expires
+     * @param options - Additional link options
+     * @returns The account link URL
+     *
+     * @example
+     * ```typescript
+     * const url = await connect.createAccountLink(
+     *   'acct_xxx',
+     *   'https://example.com/onboarding/complete',
+     *   'https://example.com/onboarding/refresh'
+     * )
+     * // Redirect user to url
+     * ```
+     */
+    async createAccountLink(stripeAccountId, returnUrl, refreshUrl, options) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Create a login link for Express or Custom accounts
+     *
+     * Login links allow connected account holders to access their
+     * Stripe Express dashboard.
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns The login link URL
+     */
+    async createLoginLink(stripeAccountId) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get account capabilities
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns Current capabilities and their status
+     */
+    async getCapabilities(stripeAccountId) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Request additional capabilities for an account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param capabilities - Capabilities to request
+     */
+    async requestCapabilities(stripeAccountId, capabilities) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Add a bank account for payouts
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param bankAccountToken - Bank account token from Stripe.js
+     * @returns The created bank account
+     */
+    async addBankAccount(stripeAccountId, bankAccountToken) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * List bank accounts for a Connect account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns List of bank accounts
+     */
+    async listBankAccounts(stripeAccountId) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Set the default bank account for payouts
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param bankAccountId - The bank account ID to set as default
+     */
+    async setDefaultBankAccount(stripeAccountId, bankAccountId) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Delete a bank account
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @param bankAccountId - The bank account ID to delete
+     */
+    async deleteBankAccount(stripeAccountId, bankAccountId) {
+        // TODO: Implement Stripe API call
+        throw new Error('Not implemented');
+    }
+    /**
+     * Handle a Stripe webhook event
+     *
+     * Validates the webhook signature and processes account-related events.
+     *
+     * @param payload - Raw webhook payload
+     * @param signature - Stripe-Signature header value
+     * @returns Processed event data
+     *
+     * @example
+     * ```typescript
+     * app.post('/webhook', async (req, res) => {
+     *   const event = await connect.handleWebhook(
+     *     req.body,
+     *     req.headers['stripe-signature']
+     *   )
+     *   // Process event...
+     * })
+     * ```
+     */
+    async handleWebhook(payload, signature) {
+        // TODO: Implement webhook verification and handling
+        throw new Error('Not implemented');
+    }
+    /**
+     * Check if an account is fully onboarded and ready for charges
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns True if the account can accept charges
+     */
+    async isReadyForCharges(stripeAccountId) {
+        // TODO: Implement capability check
+        throw new Error('Not implemented');
+    }
+    /**
+     * Check if an account is ready for payouts
+     *
+     * @param stripeAccountId - The Stripe account ID
+     * @returns True if the account can receive payouts
+     */
+    async isReadyForPayouts(stripeAccountId) {
+        // TODO: Implement capability check
+        throw new Error('Not implemented');
+    }
+}
+/**
+ * Stripe Connect error codes
+ */
+export const StripeConnectErrorCodes = {
+    ACCOUNT_NOT_FOUND: 'ACCOUNT_NOT_FOUND',
+    ONBOARDING_INCOMPLETE: 'ONBOARDING_INCOMPLETE',
+    CAPABILITY_NOT_AVAILABLE: 'CAPABILITY_NOT_AVAILABLE',
+    BANK_ACCOUNT_INVALID: 'BANK_ACCOUNT_INVALID',
+    WEBHOOK_SIGNATURE_INVALID: 'WEBHOOK_SIGNATURE_INVALID',
+};
+/**
+ * Stripe Connect error
+ */
+export class StripeConnectError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'StripeConnectError';
+    }
+}
+//# sourceMappingURL=stripe.js.map

package/dist/do/business/financial/stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../../../../do/business/financial/stripe.ts"],"names":[],"mappings":"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"}

package/dist/do/business/financial/subscriptions.d.ts

@@ -0,0 +1,402 @@
+/**
+ * Subscription Management
+ *
+ * Handles recurring revenue including:
+ * - Subscription creation and lifecycle
+ * - Trials and promotions
+ * - Upgrades and downgrades
+ * - Cancellations and pauses
+ * - Invoice generation
+ *
+ * @module financial/subscriptions
+ */
+import type { Subscription, Invoice, InvoiceLineItem, ListSubscriptionsOptions } from '../../../types/financial';
+import type { DigitalObjectRef } from '../../../types/identity';
+/**
+ * Configuration for subscription management
+ */
+export interface SubscriptionManagerConfig {
+    /** Stripe secret API key */
+    secretKey: string;
+    /** Default trial period in days */
+    defaultTrialDays?: number;
+    /** Proration behavior for changes */
+    prorationBehavior?: 'create_prorations' | 'none' | 'always_invoice';
+    /** Payment behavior for new subscriptions */
+    paymentBehavior?: 'default_incomplete' | 'allow_incomplete' | 'error_if_incomplete';
+}
+/**
+ * Options for creating a subscription
+ */
+export interface CreateSubscriptionOptions {
+    /** Trial period end timestamp */
+    trialEnd?: number | 'now';
+    /** Trial period in days */
+    trialPeriodDays?: number;
+    /** Coupon or promotion code */
+    coupon?: string;
+    /** Promotion code */
+    promotionCode?: string;
+    /** Quantity (for per-seat pricing) */
+    quantity?: number;
+    /** Payment method ID */
+    defaultPaymentMethod?: string;
+    /** Cancel at end of period */
+    cancelAtPeriodEnd?: boolean;
+    /** Billing cycle anchor */
+    billingCycleAnchor?: number | 'now' | 'unchanged';
+    /** Collection method */
+    collectionMethod?: 'charge_automatically' | 'send_invoice';
+    /** Days until due (for invoiced subscriptions) */
+    daysUntilDue?: number;
+    /** Metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Options for updating a subscription
+ */
+export interface UpdateSubscriptionOptions {
+    /** New price ID (for upgrades/downgrades) */
+    priceId?: string;
+    /** New quantity */
+    quantity?: number;
+    /** Proration behavior */
+    prorationBehavior?: 'create_prorations' | 'none' | 'always_invoice';
+    /** Proration date */
+    prorationDate?: number;
+    /** Cancel at period end */
+    cancelAtPeriodEnd?: boolean;
+    /** Trial end */
+    trialEnd?: number | 'now';
+    /** Payment method */
+    defaultPaymentMethod?: string;
+    /** Metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Options for canceling a subscription
+ */
+export interface CancelSubscriptionOptions {
+    /** Cancel at end of billing period */
+    atPeriodEnd?: boolean;
+    /** Cancellation reason */
+    cancellationDetails?: {
+        comment?: string;
+        feedback?: 'customer_service' | 'low_quality' | 'missing_features' | 'switched_service' | 'too_complex' | 'too_expensive' | 'unused' | 'other';
+    };
+    /** Prorate final invoice */
+    prorate?: boolean;
+    /** Invoice immediately */
+    invoiceNow?: boolean;
+}
+/**
+ * Options for listing invoices
+ */
+export interface ListInvoicesOptions {
+    /** Customer reference */
+    customerRef?: DigitalObjectRef;
+    /** Subscription ID */
+    subscriptionId?: string;
+    /** Invoice status */
+    status?: Invoice['status'];
+    /** Created after timestamp */
+    createdAfter?: number;
+    /** Created before timestamp */
+    createdBefore?: number;
+    /** Limit */
+    limit?: number;
+    /** Starting after (pagination cursor) */
+    startingAfter?: string;
+}
+/**
+ * Subscription manager for Digital Objects
+ *
+ * Manages the full subscription lifecycle including creation,
+ * modifications, and cancellation with support for trials and promotions.
+ *
+ * @example
+ * ```typescript
+ * const subscriptions = new SubscriptionManager({
+ *   secretKey: env.STRIPE_SECRET_KEY,
+ *   defaultTrialDays: 14
+ * })
+ *
+ * // Create a subscription with trial
+ * const sub = await subscriptions.create(customerRef, 'price_pro_monthly', {
+ *   trialPeriodDays: 14
+ * })
+ *
+ * // Upgrade to annual plan
+ * await subscriptions.update(sub.id, {
+ *   priceId: 'price_pro_annual',
+ *   prorationBehavior: 'create_prorations'
+ * })
+ *
+ * // Cancel at period end
+ * await subscriptions.cancel(sub.id, { atPeriodEnd: true })
+ * ```
+ */
+export declare class SubscriptionManager {
+    private readonly config;
+    /**
+     * Create a new SubscriptionManager instance
+     *
+     * @param config - Subscription manager configuration
+     */
+    constructor(config: SubscriptionManagerConfig);
+    /**
+     * Create a new subscription
+     *
+     * @param customerRef - Reference to the customer DO
+     * @param priceId - Stripe price ID
+     * @param options - Additional subscription options
+     * @returns The created subscription
+     *
+     * @example
+     * ```typescript
+     * // Basic subscription
+     * const sub = await subscriptions.create(customerRef, 'price_pro_monthly')
+     *
+     * // Subscription with trial and quantity
+     * const sub = await subscriptions.create(customerRef, 'price_team_monthly', {
+     *   trialPeriodDays: 14,
+     *   quantity: 5  // 5 seats
+     * })
+     * ```
+     */
+    create(customerRef: DigitalObjectRef, priceId: string, options?: CreateSubscriptionOptions): Promise<Subscription>;
+    /**
+     * Retrieve a subscription by ID
+     *
+     * @param subscriptionId - The subscription ID
+     * @returns The subscription or null if not found
+     */
+    get(subscriptionId: string): Promise<Subscription | null>;
+    /**
+     * Update a subscription
+     *
+     * Used for upgrades, downgrades, quantity changes, and other modifications.
+     *
+     * @param subscriptionId - The subscription ID
+     * @param options - Update options
+     * @returns The updated subscription
+     *
+     * @example
+     * ```typescript
+     * // Upgrade plan
+     * await subscriptions.update(subId, {
+     *   priceId: 'price_enterprise_monthly',
+     *   prorationBehavior: 'create_prorations'
+     * })
+     *
+     * // Change quantity
+     * await subscriptions.update(subId, { quantity: 10 })
+     * ```
+     */
+    update(subscriptionId: string, options: UpdateSubscriptionOptions): Promise<Subscription>;
+    /**
+     * Cancel a subscription
+     *
+     * @param subscriptionId - The subscription ID
+     * @param options - Cancellation options
+     * @returns The canceled subscription
+     *
+     * @example
+     * ```typescript
+     * // Cancel at end of period (graceful)
+     * await subscriptions.cancel(subId, { atPeriodEnd: true })
+     *
+     * // Cancel immediately with feedback
+     * await subscriptions.cancel(subId, {
+     *   atPeriodEnd: false,
+     *   cancellationDetails: {
+     *     feedback: 'too_expensive',
+     *     comment: 'Budget constraints'
+     *   }
+     * })
+     * ```
+     */
+    cancel(subscriptionId: string, options?: CancelSubscriptionOptions): Promise<Subscription>;
+    /**
+     * Resume a canceled subscription
+     *
+     * Only works if subscription was canceled with atPeriodEnd: true
+     * and the period hasn't ended yet.
+     *
+     * @param subscriptionId - The subscription ID
+     * @returns The resumed subscription
+     */
+    resume(subscriptionId: string): Promise<Subscription>;
+    /**
+     * Pause a subscription
+     *
+     * Pauses collection on the subscription. The subscription
+     * remains active but billing is suspended.
+     *
+     * @param subscriptionId - The subscription ID
+     * @param resumesAt - Timestamp when to resume billing
+     * @returns The paused subscription
+     */
+    pause(subscriptionId: string, resumesAt?: number): Promise<Subscription>;
+    /**
+     * Unpause a subscription
+     *
+     * @param subscriptionId - The subscription ID
+     * @returns The resumed subscription
+     */
+    unpause(subscriptionId: string): Promise<Subscription>;
+    /**
+     * List subscriptions with filtering
+     *
+     * @param options - Filter and pagination options
+     * @returns List of subscriptions
+     *
+     * @example
+     * ```typescript
+     * // Get all active subscriptions
+     * const subs = await subscriptions.list({ status: 'active' })
+     *
+     * // Get subscriptions for a customer
+     * const subs = await subscriptions.list({ customerRef })
+     * ```
+     */
+    list(options?: ListSubscriptionsOptions): Promise<Subscription[]>;
+    /**
+     * Get upcoming invoice for a subscription
+     *
+     * Preview what the next invoice will look like, including
+     * any pending proration items.
+     *
+     * @param subscriptionId - The subscription ID
+     * @param options - Preview options for simulating changes
+     * @returns The upcoming invoice preview
+     */
+    getUpcomingInvoice(subscriptionId: string, options?: {
+        priceId?: string;
+        quantity?: number;
+        prorationDate?: number;
+    }): Promise<Invoice>;
+    /**
+     * Create an invoice for a subscription
+     *
+     * Manually creates an invoice for pending invoice items.
+     *
+     * @param subscriptionId - The subscription ID
+     * @param options - Invoice options
+     * @returns The created invoice
+     */
+    createInvoice(subscriptionId: string, options?: {
+        autoAdvance?: boolean;
+        description?: string;
+        metadata?: Record<string, string>;
+    }): Promise<Invoice>;
+    /**
+     * Retrieve an invoice
+     *
+     * @param invoiceId - The invoice ID
+     * @returns The invoice or null if not found
+     */
+    getInvoice(invoiceId: string): Promise<Invoice | null>;
+    /**
+     * Pay an invoice
+     *
+     * @param invoiceId - The invoice ID
+     * @param paymentMethodId - Payment method to use
+     * @returns The paid invoice
+     */
+    payInvoice(invoiceId: string, paymentMethodId?: string): Promise<Invoice>;
+    /**
+     * Void an invoice
+     *
+     * @param invoiceId - The invoice ID
+     * @returns The voided invoice
+     */
+    voidInvoice(invoiceId: string): Promise<Invoice>;
+    /**
+     * Mark an invoice as uncollectible
+     *
+     * @param invoiceId - The invoice ID
+     * @returns The updated invoice
+     */
+    markUncollectible(invoiceId: string): Promise<Invoice>;
+    /**
+     * List invoices with filtering
+     *
+     * @param options - Filter and pagination options
+     * @returns List of invoices
+     */
+    listInvoices(options?: ListInvoicesOptions): Promise<Invoice[]>;
+    /**
+     * Send an invoice to the customer
+     *
+     * @param invoiceId - The invoice ID
+     * @returns The sent invoice
+     */
+    sendInvoice(invoiceId: string): Promise<Invoice>;
+    /**
+     * Add an invoice item
+     *
+     * @param customerRef - Customer reference
+     * @param options - Invoice item options
+     * @returns The created invoice line item
+     */
+    addInvoiceItem(customerRef: DigitalObjectRef, options: {
+        amount: number;
+        currency: string;
+        description: string;
+        subscriptionId?: string;
+        period?: {
+            start: number;
+            end: number;
+        };
+        metadata?: Record<string, string>;
+    }): Promise<InvoiceLineItem>;
+    /**
+     * Apply a coupon to a subscription
+     *
+     * @param subscriptionId - The subscription ID
+     * @param couponId - The coupon ID
+     * @returns The updated subscription
+     */
+    applyCoupon(subscriptionId: string, couponId: string): Promise<Subscription>;
+    /**
+     * Remove a coupon from a subscription
+     *
+     * @param subscriptionId - The subscription ID
+     * @returns The updated subscription
+     */
+    removeCoupon(subscriptionId: string): Promise<Subscription>;
+    /**
+     * Handle a Stripe webhook event for subscriptions
+     *
+     * @param payload - Raw webhook payload
+     * @param signature - Stripe-Signature header value
+     * @returns Processed event data
+     */
+    handleWebhook(payload: string | ArrayBuffer, signature: string): Promise<{
+        type: string;
+        data: unknown;
+    }>;
+}
+/**
+ * Subscription error codes
+ */
+export declare const SubscriptionErrorCodes: {
+    readonly SUBSCRIPTION_NOT_FOUND: "SUBSCRIPTION_NOT_FOUND";
+    readonly ALREADY_CANCELED: "ALREADY_CANCELED";
+    readonly CANNOT_RESUME: "CANNOT_RESUME";
+    readonly INVALID_PRICE: "INVALID_PRICE";
+    readonly INVOICE_NOT_FOUND: "INVOICE_NOT_FOUND";
+    readonly PAYMENT_FAILED: "PAYMENT_FAILED";
+    readonly CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND";
+};
+export type SubscriptionErrorCode = typeof SubscriptionErrorCodes[keyof typeof SubscriptionErrorCodes];
+/**
+ * Subscription error
+ */
+export declare class SubscriptionError extends Error {
+    readonly code: SubscriptionErrorCode;
+    readonly details?: unknown | undefined;
+    constructor(code: SubscriptionErrorCode, message: string, details?: unknown | undefined);
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/do/business/financial/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../../../do/business/financial/subscriptions.ts"],"names":[],"mappings":"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"}