@skillsmith/core 2.1.0 → 2.1.2

package/dist/src/billing/types.d.ts

@@ -0,0 +1,266 @@
+/**
+ * SMI-1062: Billing Types and Interfaces
+ *
+ * Type definitions for Stripe billing integration including:
+ * - Subscription management
+ * - Customer management
+ * - Invoice handling
+ * - Webhook events
+ */
+/**
+ * Available license tiers
+ * - community: Free tier (1,000 API calls/month)
+ * - individual: Solo developers ($9.99/mo, 10,000 API calls/month)
+ * - team: Teams ($25/user/mo, 100,000 API calls/month)
+ * - enterprise: Full enterprise ($55/user/mo, unlimited)
+ */
+export type LicenseTier = 'community' | 'individual' | 'team' | 'enterprise';
+/**
+ * Stripe Customer ID (cus_xxx)
+ */
+export type StripeCustomerId = string & {
+    readonly __brand: 'StripeCustomerId';
+};
+/**
+ * Stripe Subscription ID (sub_xxx)
+ */
+export type StripeSubscriptionId = string & {
+    readonly __brand: 'StripeSubscriptionId';
+};
+/**
+ * Stripe Price ID (price_xxx)
+ */
+export type StripePriceId = string & {
+    readonly __brand: 'StripePriceId';
+};
+/**
+ * Stripe Invoice ID (in_xxx)
+ */
+export type StripeInvoiceId = string & {
+    readonly __brand: 'StripeInvoiceId';
+};
+/**
+ * Stripe Checkout Session ID (cs_xxx)
+ */
+export type StripeCheckoutSessionId = string & {
+    readonly __brand: 'StripeCheckoutSessionId';
+};
+/**
+ * Stripe Event ID (evt_xxx)
+ */
+export type StripeEventId = string & {
+    readonly __brand: 'StripeEventId';
+};
+/**
+ * Subscription status values
+ */
+export type SubscriptionStatus = 'active' | 'past_due' | 'canceled' | 'trialing' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
+/**
+ * Customer record in our database
+ */
+export interface Customer {
+    id: string;
+    customerId: string;
+    email: string;
+    stripeCustomerId: StripeCustomerId | null;
+    tier: LicenseTier;
+    status: SubscriptionStatus;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Create customer request
+ */
+export interface CreateCustomerRequest {
+    email: string;
+    name?: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * Create customer response
+ */
+export interface CreateCustomerResponse {
+    customerId: string;
+    stripeCustomerId: StripeCustomerId;
+}
+/**
+ * Subscription record in our database
+ */
+export interface Subscription {
+    id: string;
+    customerId: string;
+    stripeSubscriptionId: StripeSubscriptionId | null;
+    stripePriceId: StripePriceId | null;
+    tier: LicenseTier;
+    status: SubscriptionStatus;
+    seatCount: number;
+    currentPeriodStart: Date | null;
+    currentPeriodEnd: Date | null;
+    canceledAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Billing period (monthly or annual)
+ */
+export type BillingPeriod = 'monthly' | 'annual';
+/**
+ * Create checkout session request
+ */
+export interface CreateCheckoutSessionRequest {
+    tier: LicenseTier;
+    billingPeriod: BillingPeriod;
+    seatCount?: number;
+    successUrl: string;
+    cancelUrl: string;
+    customerId?: string;
+    email?: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * Create checkout session response
+ */
+export interface CreateCheckoutSessionResponse {
+    sessionId: StripeCheckoutSessionId;
+    url: string;
+}
+/**
+ * Update subscription request
+ */
+export interface UpdateSubscriptionRequest {
+    subscriptionId: StripeSubscriptionId;
+    tier?: LicenseTier;
+    seatCount?: number;
+    prorate?: boolean;
+}
+/**
+ * Cancel subscription request
+ */
+export interface CancelSubscriptionRequest {
+    subscriptionId: StripeSubscriptionId;
+    immediately?: boolean;
+    feedback?: string;
+}
+/**
+ * Invoice status values
+ */
+export type InvoiceStatus = 'draft' | 'open' | 'paid' | 'void' | 'uncollectible';
+/**
+ * Invoice record in our database
+ */
+export interface Invoice {
+    id: string;
+    customerId: string;
+    stripeInvoiceId: StripeInvoiceId;
+    subscriptionId: string | null;
+    amountCents: number;
+    currency: string;
+    status: InvoiceStatus;
+    pdfUrl: string | null;
+    hostedInvoiceUrl: string | null;
+    invoiceNumber: string | null;
+    paidAt: Date | null;
+    periodStart: Date | null;
+    periodEnd: Date | null;
+    createdAt: Date;
+}
+/**
+ * Invoice list request
+ */
+export interface ListInvoicesRequest {
+    customerId: string;
+    limit?: number;
+    startingAfter?: string;
+}
+/**
+ * Invoice list response
+ */
+export interface ListInvoicesResponse {
+    invoices: Invoice[];
+    hasMore: boolean;
+}
+/**
+ * Stripe webhook event types we handle
+ */
+export type StripeWebhookEventType = 'customer.subscription.created' | 'customer.subscription.updated' | 'customer.subscription.deleted' | 'invoice.payment_succeeded' | 'invoice.payment_failed' | 'checkout.session.completed' | 'customer.created' | 'customer.updated';
+/**
+ * Webhook event record in our database
+ */
+export interface WebhookEvent {
+    id: string;
+    stripeEventId: StripeEventId;
+    eventType: StripeWebhookEventType;
+    processedAt: Date;
+    payload: string;
+    success: boolean;
+    errorMessage: string | null;
+    createdAt: Date;
+}
+/**
+ * Webhook processing result
+ */
+export interface WebhookProcessResult {
+    success: boolean;
+    message: string;
+    eventId: StripeEventId;
+    processed: boolean;
+    error?: string;
+}
+/**
+ * Create portal session request
+ */
+export interface CreatePortalSessionRequest {
+    customerId: string;
+    returnUrl: string;
+}
+/**
+ * Create portal session response
+ */
+export interface CreatePortalSessionResponse {
+    url: string;
+}
+/**
+ * Seat update request
+ */
+export interface UpdateSeatsRequest {
+    subscriptionId: StripeSubscriptionId;
+    seatCount: number;
+    prorate?: boolean;
+}
+/**
+ * Seat update response
+ */
+export interface UpdateSeatsResponse {
+    success: boolean;
+    seatCount: number;
+    proratedAmount?: number;
+    message: string;
+}
+/**
+ * Price configuration for a tier
+ */
+export interface TierPriceConfig {
+    tier: LicenseTier;
+    monthlyPriceId: StripePriceId;
+    annualPriceId: StripePriceId;
+    monthlyPrice: number;
+    annualPrice: number;
+    perUser: boolean;
+}
+/**
+ * All price configurations
+ */
+export type PriceConfigs = Record<LicenseTier, TierPriceConfig>;
+/**
+ * Billing-specific error codes
+ */
+export type BillingErrorCode = 'CUSTOMER_NOT_FOUND' | 'SUBSCRIPTION_NOT_FOUND' | 'INVALID_TIER' | 'PAYMENT_FAILED' | 'WEBHOOK_SIGNATURE_INVALID' | 'WEBHOOK_DUPLICATE_EVENT' | 'STRIPE_API_ERROR' | 'SEAT_LIMIT_EXCEEDED' | 'DOWNGRADE_NOT_ALLOWED';
+/**
+ * Billing error class
+ */
+export declare class BillingError extends Error {
+    readonly code: BillingErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: BillingErrorCode, details?: Record<string, unknown> | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/billing/types.d.ts.map

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

package/dist/src/billing/types.js

@@ -0,0 +1,23 @@
+/**
+ * SMI-1062: Billing Types and Interfaces
+ *
+ * Type definitions for Stripe billing integration including:
+ * - Subscription management
+ * - Customer management
+ * - Invoice handling
+ * - Webhook events
+ */
+/**
+ * Billing error class
+ */
+export class BillingError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'BillingError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/billing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/billing/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkVH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAGnB;IACA;IAHlB,YACE,OAAe,EACC,IAAsB,EACtB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,SAAI,GAAJ,IAAI,CAAkB;QACtB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF"}