@sylphx/contract 0.2.0

package/dist/schemas/billing-console.js

@@ -0,0 +1,298 @@
+/**
+ * Billing Console — schemas for the developer-facing subscription billing UI
+ * (Stripe checkout, subscriptions, invoices, usage, credits, transactions).
+ * Mirrors `apps/api/src/server/platform/routes/billing/*`.
+ *
+ * Plane: `management`. Distinct from the `organizationsEndpoints.billing`
+ * sub-group (org platform-plan + business settings) and the
+ * `adminBillingEndpoints` namespace (super-admin cross-org ops).
+ *
+ * Shape policy (Wave 3B):
+ *   - Wire-level coercion (`limit`, `offset` arrive as query strings) stays
+ *     `Schema.String` in the contract; route handlers parse via `toNumber`
+ *     helpers at the boundary — matches the SDK's serialised transport.
+ *   - `usageSummary` stays `Schema.Unknown` — the underlying aggregation is
+ *     service-shape driven (AI / Storage / DB / …) and changes independently
+ *     of the invoice envelope.
+ */
+import { Schema } from 'effect';
+// ── Common enums ───────────────────────────────────────────────────────────
+export const BillingIntervalEnum = Schema.Literal('monthly', 'annual', 'lifetime');
+export const SubscriptionStatus = Schema.Literal('active', 'trialing', 'past_due', 'cancelled', 'incomplete', 'incomplete_expired', 'paused');
+export const ProrationBehavior = Schema.Literal('create_prorations', 'none', 'always_invoice');
+export const BillingStatusLevel = Schema.Literal('healthy', 'low', 'critical', 'grace_period', 'suspended');
+export const BillingType = Schema.Literal('prepaid', 'postpaid', 'hybrid');
+export const TrustLevel = Schema.Literal('new', 'verified', 'trusted', 'enterprise');
+// ── Plan schemas (the catalog surface served from /billing/plans) ──────────
+export const BillingPlan = Schema.Struct({
+    id: Schema.String,
+    slug: Schema.String,
+    name: Schema.String,
+    description: Schema.NullOr(Schema.String),
+    features: Schema.NullOr(Schema.Array(Schema.String)),
+    priceMonthly: Schema.NullOr(Schema.Number),
+    priceAnnual: Schema.NullOr(Schema.Number),
+    priceLifetime: Schema.NullOr(Schema.Number),
+});
+export const GetPlansQuery = Schema.Struct({
+    projectId: Schema.String,
+});
+/**
+ * Read-only catalog response for subscription checkout. Distinct from
+ * `plans.ListPlansResult` which includes an `app` envelope and full CRUD
+ * metadata (`sortOrder`, `hasStripePrices`, …) for the plan management UI.
+ */
+export const BillingConsolePlansResult = Schema.Struct({
+    plans: Schema.Array(BillingPlan),
+});
+// ── Subscriptions ──────────────────────────────────────────────────────────
+export const Subscription = Schema.Struct({
+    id: Schema.String,
+    userId: Schema.String,
+    planId: Schema.String,
+    planSlug: Schema.String,
+    status: SubscriptionStatus,
+    interval: Schema.NullOr(BillingIntervalEnum),
+    currentPeriodStart: Schema.NullOr(Schema.String),
+    currentPeriodEnd: Schema.NullOr(Schema.String),
+    cancelAtPeriodEnd: Schema.Boolean,
+    trialEnd: Schema.NullOr(Schema.String),
+});
+export const GetSubscriptionQuery = Schema.Struct({
+    projectId: Schema.String,
+    userId: Schema.String,
+});
+export const GetMySubscriptionQuery = Schema.Struct({
+    projectId: Schema.String,
+});
+/** `null` when the user has no subscription yet. */
+export const GetSubscriptionResult = Schema.NullOr(Subscription);
+export const CancelSubscriptionInput = Schema.Struct({
+    projectId: Schema.String,
+    userId: Schema.String,
+    immediate: Schema.optional(Schema.Boolean),
+});
+export const CancelSubscriptionResult = Schema.Struct({
+    success: Schema.Boolean,
+});
+export const UpdateSubscriptionInput = Schema.Struct({
+    projectId: Schema.String,
+    userId: Schema.String,
+    newPlanSlug: Schema.String,
+    newInterval: Schema.optional(BillingIntervalEnum),
+    prorationBehavior: Schema.optional(ProrationBehavior),
+});
+export const UpdateSubscriptionResult = Schema.Struct({
+    success: Schema.Boolean,
+    subscription: Schema.Struct({
+        id: Schema.String,
+        planSlug: Schema.String,
+        interval: BillingIntervalEnum,
+        currentPeriodEnd: Schema.String,
+    }),
+});
+export const ProrationPreviewInput = Schema.Struct({
+    projectId: Schema.String,
+    userId: Schema.String,
+    newPlanSlug: Schema.String,
+    newInterval: Schema.optional(BillingIntervalEnum),
+});
+export const ProrationPreviewResult = Schema.Struct({
+    currentPlan: Schema.Struct({
+        slug: Schema.String,
+        name: Schema.String,
+        interval: Schema.NullOr(BillingIntervalEnum),
+    }),
+    newPlan: Schema.Struct({
+        slug: Schema.String,
+        name: Schema.String,
+        interval: BillingIntervalEnum,
+        price: Schema.NullOr(Schema.Number),
+    }),
+    proration: Schema.Struct({
+        creditAmountCents: Schema.Number,
+        chargeAmountCents: Schema.Number,
+        netAmountCents: Schema.Number,
+        description: Schema.String,
+    }),
+    currentPeriodEnd: Schema.NullOr(Schema.String),
+});
+// ── Checkout / Portal / Credits ────────────────────────────────────────────
+export const CreateCheckoutInput = Schema.Struct({
+    projectId: Schema.String,
+    userId: Schema.String,
+    planSlug: Schema.String,
+    interval: Schema.optional(BillingIntervalEnum),
+    successUrl: Schema.String,
+    cancelUrl: Schema.String,
+    trialDays: Schema.optional(Schema.Number),
+});
+export const CheckoutResult = Schema.Struct({
+    checkoutUrl: Schema.NullOr(Schema.String),
+    sessionId: Schema.String,
+});
+export const CreatePortalInput = Schema.Struct({
+    projectId: Schema.String,
+    userId: Schema.String,
+    returnUrl: Schema.String,
+});
+export const PortalResult = Schema.Struct({
+    portalUrl: Schema.String,
+});
+/**
+ * Project-scoped credit checkout — distinct from
+ * `organization-billing.CreateCreditCheckoutInput`, which is org-level and
+ * takes `baseUrl` instead of `successUrl`/`cancelUrl` pairs.
+ */
+export const BillingConsoleCreditCheckoutInput = Schema.Struct({
+    projectId: Schema.String,
+    amountDollars: Schema.Number,
+    successUrl: Schema.String,
+    cancelUrl: Schema.String,
+});
+export const CreditPackage = Schema.Struct({
+    amountDollars: Schema.Number,
+    label: Schema.String,
+    popular: Schema.Boolean,
+});
+export const CreditPackagesResult = Schema.Struct({
+    packages: Schema.Array(CreditPackage),
+    customMin: Schema.Number,
+    customMax: Schema.Number,
+});
+// ── Balance ────────────────────────────────────────────────────────────────
+export const GetBalanceQuery = Schema.Struct({
+    projectId: Schema.String,
+});
+export const BalanceResult = Schema.Struct({
+    balance: Schema.Struct({
+        current: Schema.Number,
+        currentFormatted: Schema.String,
+    }),
+    status: Schema.Struct({
+        level: BillingStatusLevel,
+        isHealthy: Schema.Boolean,
+        isLow: Schema.Boolean,
+        alertThreshold: Schema.Number,
+    }),
+    billingType: BillingType,
+    trustLevel: TrustLevel,
+    spendingCap: Schema.NullOr(Schema.Number),
+    currentMonthSpend: Schema.Number,
+    spendingCapPercent: Schema.NullOr(Schema.Number),
+    gracePeriodEndsAt: Schema.NullOr(Schema.String),
+    isAdminOrg: Schema.Boolean,
+});
+// ── Usage ──────────────────────────────────────────────────────────────────
+export const GetUsageQuery = Schema.Struct({
+    projectId: Schema.String,
+    month: Schema.optional(Schema.String),
+});
+export const UsageMetrics = Schema.Struct({
+    aiCostMicrodollars: Schema.Number,
+    storageBytesUsed: Schema.Number,
+    storageEgressBytes: Schema.Number,
+    storageUploads: Schema.Number,
+    dbStorageBytes: Schema.Number,
+    dbComputeSeconds: Schema.Number,
+    emailSentCount: Schema.Number,
+    jobInvocationCount: Schema.Number,
+    cronActiveCount: Schema.Number,
+    notificationsSentCount: Schema.Number,
+    analyticsEventCount: Schema.Number,
+    webhookDeliveryCount: Schema.Number,
+    errorEventCount: Schema.Number,
+    authMau: Schema.Number,
+});
+export const UsageResult = Schema.Struct({
+    period: Schema.Struct({
+        type: Schema.Literal('month'),
+        start: Schema.String,
+        end: Schema.String,
+    }),
+    metrics: Schema.NullOr(UsageMetrics),
+});
+export const UsageSummaryResult = Schema.Struct({
+    month: Schema.String,
+    /** Per-service aggregation. Service-shape driven; stays opaque. */
+    summary: Schema.Unknown,
+});
+// ── Transactions ───────────────────────────────────────────────────────────
+export const GetTransactionsQuery = Schema.Struct({
+    projectId: Schema.String,
+    limit: Schema.optional(Schema.String),
+    offset: Schema.optional(Schema.String),
+});
+export const Transaction = Schema.Struct({
+    id: Schema.String,
+    type: Schema.String,
+    amount: Schema.Number,
+    amountFormatted: Schema.String,
+    description: Schema.NullOr(Schema.String),
+    service: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+});
+export const TransactionsResult = Schema.Struct({
+    transactions: Schema.Array(Transaction),
+    total: Schema.Number,
+    limit: Schema.Number,
+    offset: Schema.Number,
+});
+// ── Invoices ───────────────────────────────────────────────────────────────
+export const GetInvoicesQuery = Schema.Struct({
+    projectId: Schema.String,
+    limit: Schema.optional(Schema.String),
+});
+export const GetInvoiceDetailQuery = Schema.Struct({
+    projectId: Schema.String,
+    invoiceId: Schema.String,
+});
+export const InvoiceSummary = Schema.Struct({
+    id: Schema.String,
+    invoiceNumber: Schema.String,
+    billingMonth: Schema.String,
+    status: Schema.String,
+    totalMicrodollars: Schema.Number,
+    totalFormatted: Schema.String,
+    dueAt: Schema.NullOr(Schema.String),
+    paidAt: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+});
+export const InvoicesResult = Schema.Struct({
+    invoices: Schema.Array(InvoiceSummary),
+});
+const ServiceCost = Schema.Struct({
+    cost: Schema.Number,
+    costFormatted: Schema.String,
+});
+export const InvoiceDetailResult = Schema.Struct({
+    id: Schema.String,
+    invoiceNumber: Schema.String,
+    billingMonth: Schema.String,
+    status: Schema.String,
+    services: Schema.Struct({
+        ai: ServiceCost,
+        storage: ServiceCost,
+        database: ServiceCost,
+        email: ServiceCost,
+        jobs: ServiceCost,
+        notifications: ServiceCost,
+        analytics: ServiceCost,
+        webhooks: ServiceCost,
+        monitoring: ServiceCost,
+        auth: ServiceCost,
+    }),
+    subtotal: Schema.Number,
+    subtotalFormatted: Schema.String,
+    credits: Schema.Number,
+    creditsFormatted: Schema.String,
+    discount: Schema.Number,
+    discountFormatted: Schema.String,
+    total: Schema.Number,
+    totalFormatted: Schema.String,
+    usageSummary: Schema.NullOr(Schema.Unknown),
+    dueAt: Schema.NullOr(Schema.String),
+    finalizedAt: Schema.NullOr(Schema.String),
+    paidAt: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+});

package/dist/schemas/billing-settings.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Billing Settings — schemas for the organization's billing configuration UI
+ * (business info, tax ID, payment methods, spending cap).
+ * Mirrors `apps/api/src/server/platform/routes/billing-settings/*`.
+ *
+ * Plane: `management`. Distinct from the `organizationsEndpoints.billing`
+ * sub-group (which handles org platform-plan + /orgs/billing/business).
+ *
+ * Shape policy (Wave 3B):
+ *   - Tax ID + billing type + trust level are string literals — the server
+ *     enum evolves slowly and the Console must surface friendly labels, so
+ *     the wire keeps canonical values and the UI maps them.
+ *   - `spendingCapDollars` stays `Schema.Number` (UI input in dollars); the
+ *     server converts to microdollars before persisting.
+ */
+import { Schema } from 'effect';
+/**
+ * Tax ID types accepted by Stripe. The server enum is defined in
+ * `@sylphx/core/lib/db/schema/enums` — we keep `Schema.String` here so new
+ * Stripe-added types pass through without a contract bump.
+ */
+export declare const TaxIdType: typeof Schema.String;
+export type TaxIdType = typeof TaxIdType.Type;
+/** Action to take when the monthly spending cap is hit. */
+export declare const SpendingCapAction: Schema.Literal<["alert", "suspend_service", "hard_block"]>;
+export type SpendingCapAction = typeof SpendingCapAction.Type;
+/** Platform-subset billing type (excludes `enterprise`, which is admin-set). */
+export declare const BillingSettingsBillingType: Schema.Literal<["prepaid", "postpaid"]>;
+export type BillingSettingsBillingType = typeof BillingSettingsBillingType.Type;
+/** Trust level surfaced to the Console. */
+export declare const BillingSettingsTrustLevel: Schema.Literal<["new", "verified", "enterprise"]>;
+export type BillingSettingsTrustLevel = typeof BillingSettingsTrustLevel.Type;
+export declare const BillingAddress: Schema.Struct<{
+    line1: Schema.optional<typeof Schema.String>;
+    line2: Schema.optional<typeof Schema.String>;
+    city: Schema.optional<typeof Schema.String>;
+    state: Schema.optional<typeof Schema.String>;
+    postalCode: Schema.optional<typeof Schema.String>;
+    /** ISO 3166-1 alpha-2 */
+    country: Schema.optional<typeof Schema.String>;
+}>;
+export type BillingAddress = typeof BillingAddress.Type;
+export declare const PaymentMethod: Schema.Struct<{
+    id: typeof Schema.String;
+    type: typeof Schema.String;
+    brand: Schema.NullOr<typeof Schema.String>;
+    last4: Schema.NullOr<typeof Schema.String>;
+    expMonth: Schema.NullOr<typeof Schema.Number>;
+    expYear: Schema.NullOr<typeof Schema.Number>;
+    isDefault: typeof Schema.Boolean;
+}>;
+export type PaymentMethod = typeof PaymentMethod.Type;
+export declare const BillingSettingsSuccessResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type BillingSettingsSuccessResult = typeof BillingSettingsSuccessResult.Type;
+/** Alias retained for consumers migrating from api-types. */
+export declare const BillingSuccessResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type BillingSuccessResult = typeof BillingSettingsSuccessResult.Type;
+export declare const PaymentMethodIdParams: Schema.Struct<{
+    paymentMethodId: typeof Schema.String;
+}>;
+export type PaymentMethodIdParams = typeof PaymentMethodIdParams.Type;
+export declare const GetBillingSettingsResult: Schema.Struct<{
+    orgId: typeof Schema.String;
+    orgName: typeof Schema.String;
+    billingType: Schema.Literal<["prepaid", "postpaid"]>;
+    trustLevel: Schema.Literal<["new", "verified", "enterprise"]>;
+    taxId: Schema.NullOr<typeof Schema.String>;
+    taxIdType: Schema.NullOr<typeof Schema.String>;
+    taxIdVerified: typeof Schema.Boolean;
+    businessName: Schema.NullOr<typeof Schema.String>;
+    billingCountry: Schema.NullOr<typeof Schema.String>;
+    billingAddress: Schema.NullOr<Schema.Struct<{
+        line1: Schema.optional<typeof Schema.String>;
+        line2: Schema.optional<typeof Schema.String>;
+        city: Schema.optional<typeof Schema.String>;
+        state: Schema.optional<typeof Schema.String>;
+        postalCode: Schema.optional<typeof Schema.String>;
+        /** ISO 3166-1 alpha-2 */
+        country: Schema.optional<typeof Schema.String>;
+    }>>;
+    taxExempt: typeof Schema.Boolean;
+    taxExemptReason: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    spendingCapMicrodollars: Schema.NullOr<typeof Schema.Number>;
+    spendingCapAction: Schema.Literal<["alert", "suspend_service", "hard_block"]>;
+    hasPaymentMethod: typeof Schema.Boolean;
+    defaultPaymentMethodId: Schema.NullOr<typeof Schema.String>;
+}>;
+export type GetBillingSettingsResult = typeof GetBillingSettingsResult.Type;
+/**
+ * Nested billing address envelope. Distinct from the flat-field
+ * `organization-billing.UpdateBusinessInfoInput` (which exposes
+ * `addressLine1`, `addressLine2`, `city`, `state`, `postalCode` as peers of
+ * `billingCountry`). This Console surface mirrors the `billingAccounts`
+ * table's `billingAddress` JSONB column directly.
+ */
+export declare const BillingSettingsUpdateBusinessInfoInput: Schema.Struct<{
+    businessName: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    billingCountry: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    billingAddress: Schema.optional<Schema.NullOr<Schema.Struct<{
+        line1: Schema.optional<typeof Schema.String>;
+        line2: Schema.optional<typeof Schema.String>;
+        city: Schema.optional<typeof Schema.String>;
+        state: Schema.optional<typeof Schema.String>;
+        postalCode: Schema.optional<typeof Schema.String>;
+        /** ISO 3166-1 alpha-2 */
+        country: Schema.optional<typeof Schema.String>;
+    }>>>;
+}>;
+export type BillingSettingsUpdateBusinessInfoInput = typeof BillingSettingsUpdateBusinessInfoInput.Type;
+/**
+ * Same wire shape as `organization-billing.SetTaxIdInput` — kept separate so
+ * the two namespaces evolve independently (the Console billing-settings flow
+ * may gain additional verification fields before the org-level flow does).
+ */
+export declare const BillingSettingsSetTaxIdInput: Schema.Struct<{
+    taxId: typeof Schema.String;
+    taxIdType: typeof Schema.String;
+}>;
+export type BillingSettingsSetTaxIdInput = typeof BillingSettingsSetTaxIdInput.Type;
+export declare const BillingSettingsSetTaxIdResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+    verified: typeof Schema.Boolean;
+    message: typeof Schema.String;
+}>;
+export type BillingSettingsSetTaxIdResult = typeof BillingSettingsSetTaxIdResult.Type;
+export declare const SetSpendingCapInput: Schema.Struct<{
+    spendingCapDollars: Schema.optional<Schema.NullOr<typeof Schema.Number>>;
+    spendingCapAction: Schema.optional<Schema.Literal<["alert", "suspend_service", "hard_block"]>>;
+}>;
+export type SetSpendingCapInput = typeof SetSpendingCapInput.Type;
+export declare const GetPaymentMethodsResult: Schema.Struct<{
+    paymentMethods: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        type: typeof Schema.String;
+        brand: Schema.NullOr<typeof Schema.String>;
+        last4: Schema.NullOr<typeof Schema.String>;
+        expMonth: Schema.NullOr<typeof Schema.Number>;
+        expYear: Schema.NullOr<typeof Schema.Number>;
+        isDefault: typeof Schema.Boolean;
+    }>>;
+}>;
+export type GetPaymentMethodsResult = typeof GetPaymentMethodsResult.Type;
+export declare const CreateSetupIntentInput: Schema.Struct<{
+    successUrl: typeof Schema.String;
+    cancelUrl: typeof Schema.String;
+}>;
+export type CreateSetupIntentInput = typeof CreateSetupIntentInput.Type;
+export declare const CreateSetupIntentResult: Schema.Struct<{
+    clientSecret: Schema.NullOr<typeof Schema.String>;
+}>;
+export type CreateSetupIntentResult = typeof CreateSetupIntentResult.Type;
+//# sourceMappingURL=billing-settings.d.ts.map

package/dist/schemas/billing-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-settings.d.ts","sourceRoot":"","sources":["../../src/schemas/billing-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAI/B;;;;GAIG;AACH,eAAO,MAAM,SAAS,sBAAgB,CAAA;AACtC,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,4DAA2D,CAAA;AACzF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,yCAAwC,CAAA;AAC/E,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAA;AAE/E,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,mDAAkD,CAAA;AACxF,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAA;AAI7E,eAAO,MAAM,cAAc;;;;;;IAM1B,yBAAyB;;EAExB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,eAAO,MAAM,aAAa;;;;;;;;EAQxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,eAAO,MAAM,4BAA4B;;EAEvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,IAAI,CAAA;AAEnF,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB;;EAA+B,CAAA;AAChE,MAAM,MAAM,oBAAoB,GAAG,OAAO,4BAA4B,CAAC,IAAI,CAAA;AAI3E,eAAO,MAAM,qBAAqB;;EAEhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAA;AAIrE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;QAlCpC,yBAAyB;;;;;;;;;EAmDxB,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAA;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;QA7DlD,yBAAyB;;;EAiExB,CAAA;AACF,MAAM,MAAM,sCAAsC,GACjD,OAAO,sCAAsC,CAAC,IAAI,CAAA;AAInD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;EAGvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,IAAI,CAAA;AAEnF,eAAO,MAAM,6BAA6B;;;;EAIxC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,OAAO,6BAA6B,CAAC,IAAI,CAAA;AAIrF,eAAO,MAAM,mBAAmB;;;EAG9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAIjE,eAAO,MAAM,uBAAuB;;;;;;;;;;EAElC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEzE,eAAO,MAAM,sBAAsB;;;EAGjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,uBAAuB;;EAElC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA"}

package/dist/schemas/billing-settings.js

@@ -0,0 +1,119 @@
+/**
+ * Billing Settings — schemas for the organization's billing configuration UI
+ * (business info, tax ID, payment methods, spending cap).
+ * Mirrors `apps/api/src/server/platform/routes/billing-settings/*`.
+ *
+ * Plane: `management`. Distinct from the `organizationsEndpoints.billing`
+ * sub-group (which handles org platform-plan + /orgs/billing/business).
+ *
+ * Shape policy (Wave 3B):
+ *   - Tax ID + billing type + trust level are string literals — the server
+ *     enum evolves slowly and the Console must surface friendly labels, so
+ *     the wire keeps canonical values and the UI maps them.
+ *   - `spendingCapDollars` stays `Schema.Number` (UI input in dollars); the
+ *     server converts to microdollars before persisting.
+ */
+import { Schema } from 'effect';
+// ── Enums ──────────────────────────────────────────────────────────────────
+/**
+ * Tax ID types accepted by Stripe. The server enum is defined in
+ * `@sylphx/core/lib/db/schema/enums` — we keep `Schema.String` here so new
+ * Stripe-added types pass through without a contract bump.
+ */
+export const TaxIdType = Schema.String;
+/** Action to take when the monthly spending cap is hit. */
+export const SpendingCapAction = Schema.Literal('alert', 'suspend_service', 'hard_block');
+/** Platform-subset billing type (excludes `enterprise`, which is admin-set). */
+export const BillingSettingsBillingType = Schema.Literal('prepaid', 'postpaid');
+/** Trust level surfaced to the Console. */
+export const BillingSettingsTrustLevel = Schema.Literal('new', 'verified', 'enterprise');
+// ── Common envelope ────────────────────────────────────────────────────────
+export const BillingAddress = Schema.Struct({
+    line1: Schema.optional(Schema.String),
+    line2: Schema.optional(Schema.String),
+    city: Schema.optional(Schema.String),
+    state: Schema.optional(Schema.String),
+    postalCode: Schema.optional(Schema.String),
+    /** ISO 3166-1 alpha-2 */
+    country: Schema.optional(Schema.String),
+});
+export const PaymentMethod = Schema.Struct({
+    id: Schema.String,
+    type: Schema.String,
+    brand: Schema.NullOr(Schema.String),
+    last4: Schema.NullOr(Schema.String),
+    expMonth: Schema.NullOr(Schema.Number),
+    expYear: Schema.NullOr(Schema.Number),
+    isDefault: Schema.Boolean,
+});
+export const BillingSettingsSuccessResult = Schema.Struct({
+    success: Schema.Boolean,
+});
+/** Alias retained for consumers migrating from api-types. */
+export const BillingSuccessResult = BillingSettingsSuccessResult;
+// ── Path params ────────────────────────────────────────────────────────────
+export const PaymentMethodIdParams = Schema.Struct({
+    paymentMethodId: Schema.String,
+});
+// ── Settings (GET / PATCH business info) ───────────────────────────────────
+export const GetBillingSettingsResult = Schema.Struct({
+    orgId: Schema.String,
+    orgName: Schema.String,
+    billingType: BillingSettingsBillingType,
+    trustLevel: BillingSettingsTrustLevel,
+    taxId: Schema.NullOr(Schema.String),
+    taxIdType: Schema.NullOr(TaxIdType),
+    taxIdVerified: Schema.Boolean,
+    businessName: Schema.NullOr(Schema.String),
+    billingCountry: Schema.NullOr(Schema.String),
+    billingAddress: Schema.NullOr(BillingAddress),
+    taxExempt: Schema.Boolean,
+    taxExemptReason: Schema.optional(Schema.NullOr(Schema.String)),
+    spendingCapMicrodollars: Schema.NullOr(Schema.Number),
+    spendingCapAction: SpendingCapAction,
+    hasPaymentMethod: Schema.Boolean,
+    defaultPaymentMethodId: Schema.NullOr(Schema.String),
+});
+/**
+ * Nested billing address envelope. Distinct from the flat-field
+ * `organization-billing.UpdateBusinessInfoInput` (which exposes
+ * `addressLine1`, `addressLine2`, `city`, `state`, `postalCode` as peers of
+ * `billingCountry`). This Console surface mirrors the `billingAccounts`
+ * table's `billingAddress` JSONB column directly.
+ */
+export const BillingSettingsUpdateBusinessInfoInput = Schema.Struct({
+    businessName: Schema.optional(Schema.NullOr(Schema.String)),
+    billingCountry: Schema.optional(Schema.NullOr(Schema.String)),
+    billingAddress: Schema.optional(Schema.NullOr(BillingAddress)),
+});
+// ── Tax ────────────────────────────────────────────────────────────────────
+/**
+ * Same wire shape as `organization-billing.SetTaxIdInput` — kept separate so
+ * the two namespaces evolve independently (the Console billing-settings flow
+ * may gain additional verification fields before the org-level flow does).
+ */
+export const BillingSettingsSetTaxIdInput = Schema.Struct({
+    taxId: Schema.String,
+    taxIdType: TaxIdType,
+});
+export const BillingSettingsSetTaxIdResult = Schema.Struct({
+    success: Schema.Boolean,
+    verified: Schema.Boolean,
+    message: Schema.String,
+});
+// ── Spending cap ───────────────────────────────────────────────────────────
+export const SetSpendingCapInput = Schema.Struct({
+    spendingCapDollars: Schema.optional(Schema.NullOr(Schema.Number)),
+    spendingCapAction: Schema.optional(SpendingCapAction),
+});
+// ── Payment methods ────────────────────────────────────────────────────────
+export const GetPaymentMethodsResult = Schema.Struct({
+    paymentMethods: Schema.Array(PaymentMethod),
+});
+export const CreateSetupIntentInput = Schema.Struct({
+    successUrl: Schema.String,
+    cancelUrl: Schema.String,
+});
+export const CreateSetupIntentResult = Schema.Struct({
+    clientSecret: Schema.NullOr(Schema.String),
+});