@chatarmin/os 1.5.2 → 1.5.4

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 import type { AppRouter } from "@chatarmin/api";
+export type { BillingDashboardContext, BillingDashboardFeatureBilling, BillingDashboardFeatureRow, GetBillingDashboardContextInput, } from "./types/billing-dashboard-context.js";
+export type { ListProductFeatureCatalogInput, ProductFeatureCatalogItem } from "./types/product-feature-catalog.js";
+export type { ClaimCheckoutInput, EnsureFeatureSubscriptionInput, EnsureFeatureSubscriptionResult, LinkSubscriptionInput, RelinkBillingProfileInput, SetUsageInput, SyncCompanyFromStripeInput, SyncCompanyFromStripeResult, UsageResult, } from "./types/chatarmin-os-billing-inputs.js";
 /**
  * Configuration options for the ChatarminOS SDK client.
  */
@@ -211,76 +214,6 @@ export interface FeatureSetAccessInput {
     /** When the access expires (null for no expiration) */
     validUntil?: Date | null;
 }
-/**
- * Input for tracking feature usage (increment operation).
- */
-export interface TrackUsageInput {
-    /** Company ID */
-    companyId: string;
-    /** Feature code to track */
-    featureCode: string;
-    /**
-     * Quantity to track (must be positive).
-     * @default 1
-     */
-    quantity?: number;
-    /**
-     * Idempotency key to prevent duplicate tracking.
-     * Use a unique ID per operation (e.g., message ID).
-     */
-    idempotencyKey?: string;
-    /**
-     * Additional metadata for the usage event.
-     * Store external references here (e.g., { externalId: "msg_123", type: "message" })
-     */
-    metadata?: Record<string, unknown>;
-    /**
-     * Ensure the feature is linked to an active Stripe subscription.
-     * If no subscription item is linked:
-     * 1. Checks existing subscriptions for a matching price
-     * 2. If found, links the feature_access to that subscription item
-     * 3. If not found, adds the feature's default price to a compatible subscription
-     *
-     * Only works with monthly/flexible subscriptions.
-     * @default true
-     */
-    ensureSubscription?: boolean;
-}
-/**
- * Input for tracking usage by external org ID (product link).
- */
-export interface TrackUsageByExternalOrgIdInput {
-    /** External org ID for the linked product */
-    externalOrgId: string;
-    /** Feature code to track */
-    featureCode: string;
-    /**
-     * Quantity to track (must be positive).
-     * @default 1
-     */
-    quantity?: number;
-    /**
-     * Idempotency key to prevent duplicate tracking.
-     * Use a unique ID per operation (e.g., message ID).
-     */
-    idempotencyKey?: string;
-    /**
-     * Additional metadata for the usage event.
-     * Store external references here (e.g., { externalId: "msg_123", type: "message" })
-     */
-    metadata?: Record<string, unknown>;
-    /**
-     * Ensure the feature is linked to an active Stripe subscription.
-     * If no subscription item is linked:
-     * 1. Checks existing subscriptions for a matching price
-     * 2. If found, links the feature_access to that subscription item
-     * 3. If not found, adds the feature's default price to a compatible subscription
-     *
-     * Only works with monthly/flexible subscriptions.
-     * @default true
-     */
-    ensureSubscription?: boolean;
-}
 export interface LinkedCompany {
     id: string;
     name: string;
@@ -297,115 +230,6 @@ export interface ListLinkedCompaniesResult {
     companies: LinkedCompany[];
     nextCursor?: string;
 }
-export interface SyncCompanyFromStripeInput {
-    companyId: string;
-    stripeCustomerId?: string;
-    forceReassign?: boolean;
-}
-export interface SyncCompanyFromStripeResult {
-    billingProfileId: string;
-    stripeCustomerId: string;
-    subscriptionsSynced: number;
-    subscriptionItemsSynced: number;
-    featuresLinked: number;
-    matchedMeters: number;
-}
-export interface EnsureFeatureSubscriptionInput {
-    companyId: string;
-    featureCode: string;
-    stripeSubscriptionId?: string;
-}
-export interface RelinkBillingProfileInput {
-    companyId: string;
-    stripeCustomerId: string;
-}
-export interface EnsureFeatureSubscriptionResult {
-    success: boolean;
-    subscriptionItemId: string | null;
-    stripePriceId: string | null;
-    stripeSubscriptionId: string | null;
-    action: "already_linked" | "linked_existing" | "created_new" | "failed";
-    error?: string;
-}
-/**
- * Input for setting usage to an absolute value.
- * Use for corrections when you know what the total usage SHOULD be.
- */
-export interface SetUsageInput {
-    /** Company ID */
-    companyId: string;
-    /** Feature code */
-    featureCode: string;
-    /** The absolute value to set usage to (must be >= 0) */
-    absoluteValue: number;
-    /** Reason for the set operation (required for audit trail) */
-    reason: string;
-    /** Admin user who performed the operation */
-    performedBy?: string;
-    /** Additional metadata (e.g., { ticketId: "SUPPORT-123" }) */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Input for adjusting usage by a delta.
- * Use for explicit corrections - supports negative values for refunds.
- */
-export interface AdjustUsageInput {
-    /** Company ID */
-    companyId: string;
-    /** Feature code */
-    featureCode: string;
-    /** The delta to apply (can be negative for refunds) */
-    delta: number;
-    /** Reason for the adjustment (required for audit trail) */
-    reason: string;
-    /** Reference to original event being adjusted (for Stripe cancellations) */
-    adjustsEventId?: string;
-    /** Admin user who performed the operation */
-    performedBy?: string;
-    /** Additional metadata (e.g., { ticketId: "REFUND-456" }) */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Result from usage operations (track, set, adjust).
- */
-export interface UsageResult {
-    success: boolean;
-    featureCode: string;
-    previousUsage: number;
-    currentUsage: number;
-    delta: number;
-    quantityLimit: number | null;
-    remaining: number | null;
-    isAtLimit: boolean;
-    includedQuantity: number;
-    billableQuantity: number;
-    meterId: string;
-    eventId: string | null;
-}
-/**
- * Input for claiming a Stripe checkout subscription.
- */
-export interface ClaimCheckoutInput {
-    /** Company ID to link the subscription to */
-    companyId: string;
-    /** Stripe checkout session ID (cs_xxx) */
-    checkoutSessionId: string;
-}
-/**
- * Input for linking an existing Stripe subscription.
- */
-export interface LinkSubscriptionInput {
-    /** Company ID to link the subscription to */
-    companyId: string;
-    /** Stripe subscription ID (sub_xxx) */
-    stripeSubscriptionId: string;
-    /** Stripe customer ID (cus_xxx) - fetched from subscription if not provided */
-    stripeCustomerId?: string;
-    /** Tier code to apply features from (e.g., "free", "pro") */
-    tierCode?: string;
-    /** Display name for the subscription */
-    displayName?: string;
-}
 /**
  * Input for applying a tier to a company.
  */
@@ -574,12 +398,13 @@ export interface OnboardResult {
  * console.log(result.companyId) // Use this for all future API calls
  * ```
  *
- * @example Track Usage
+ * @example Set Usage
  * ```typescript
- * await os.billing.trackUsage({
+ * await os.billing.setUsage({
  *   companyId: company.id,
  *   featureCode: 'ai_credit',
- *   quantity: 1
+ *   absoluteValue: 1,
+ *   reason: 'Synced current usage'
  * })
  * ```
  *
@@ -660,11 +485,11 @@ export declare class ChatarminOS {
         getByProductLink: (input: {
             externalOrgId: string;
         }) => Promise<{
+            id: string;
+            name: string;
             domain: string | null;
             external_org_id: string;
             external_user_id: string | null;
-            id: string;
-            name: string;
         } | null>;
         /**
          * Create a new company and link it to your product.
@@ -815,15 +640,14 @@ export declare class ChatarminOS {
         } & ContactInput) => Promise<{
             isNew: boolean;
             id: string;
-            name: string | null;
-            metadata: unknown;
+            role: string | null;
             created_at: Date;
             updated_at: Date;
-            role: string | null;
-            email: string;
-            company_id: string | null;
             short_id: string | null;
+            name: string | null;
+            metadata: unknown;
             is_primary: boolean;
+            company_id: string | null;
             avatar_url: string | null;
         }>;
         /**
@@ -871,41 +695,18 @@ export declare class ChatarminOS {
          */
         list: (companyId: string, primaryOnly?: boolean) => Promise<{
             id: string;
-            name: string | null;
-            metadata: unknown;
+            role: string | null;
             created_at: Date;
             updated_at: Date;
-            role: string | null;
-            email: string;
-            company_id: string | null;
             short_id: string | null;
+            name: string | null;
+            metadata: unknown;
             is_primary: boolean;
+            company_id: string | null;
             avatar_url: string | null;
         }[]>;
     };
-    /**
-     * Feature access and entitlement operations.
-     *
-     * Check what features a company has access to and their current usage.
-     * Features are defined in ChatarminOS and assigned via subscription tiers.
-     *
-     * @example
-     * ```typescript
-     * // Check if company can use a feature
-     * const access = await os.features.check({
-     *   companyId: company.id,
-     *   featureCode: 'ai_credit'
-     * })
-     *
-     * if (access.canUse) {
-     *   // Feature is available
-     *   console.log(`Remaining: ${access.remaining}`)
-     * } else {
-     *   // Feature is disabled or limit reached
-     *   console.log('Upgrade required')
-     * }
-     * ```
-     */
+    /** Feature access and entitlements (`check`, `listAccess`, `listForProduct`, …). */
     get features(): {
         /**
          * Check if a company has access to a specific feature.
@@ -977,7 +778,7 @@ export declare class ChatarminOS {
          * }
          * ```
          */
-        listAccess: (input: ListFeatureAccessInput | string) => Promise<({
+        listAccess: (input: ListFeatureAccessInput | string) => Promise<{
             featureCode: string;
             featureName: string;
             description: string | null;
@@ -993,8 +794,7 @@ export declare class ChatarminOS {
             stripeSubscriptionId: string | null;
             meterId: string | null;
             configValues: Record<string, unknown>;
-        } | {
-            billing: {
+            billing?: {
                 stripeSubscriptionItemId: string | null;
                 currentPeriodStart: Date | null;
                 currentPeriodEnd: Date | null;
@@ -1004,22 +804,8 @@ export declare class ChatarminOS {
                 usageType: string | null;
                 subscriptionStatus: string | null;
             };
-            featureCode: string;
-            featureName: string;
-            description: string | null;
-            hasQuantity: boolean;
-            isEnabled: boolean;
-            quantityLimit: number | null;
-            includedQuantity: number;
-            currentUsage: number;
-            source: string;
-            validUntil: Date | null;
-            stripeSubscriptionItemId: string | null;
-            stripePriceId: string | null;
-            stripeSubscriptionId: string | null;
-            meterId: string | null;
-            configValues: Record<string, unknown>;
-        })[]>;
+        }[]>;
+        listForProduct: (input?: import("./index.js").ListProductFeatureCatalogInput) => Promise<import("./index.js").ProductFeatureCatalogItem[]>;
         /**
          * Update feature access for a company with partial config merge.
          *
@@ -1070,7 +856,9 @@ export declare class ChatarminOS {
             isEnabled: boolean;
             quantityLimit: number | null;
             includedQuantity: number | null;
-            configValues: Record<string, unknown>;
+            configValues: {
+                [x: string]: unknown;
+            };
             source: string;
             validUntil: Date | null;
             created: boolean;
@@ -1098,6 +886,7 @@ export declare class ChatarminOS {
          */
         getAccessByExternalOrgId: (externalOrgId: string) => Promise<{
             companyId: string;
+            productLinkId: string;
             externalOrgId: string;
             features: {
                 featureCode: string;
@@ -1144,22 +933,36 @@ export declare class ChatarminOS {
             remaining: number | null;
             isAtLimit: boolean;
             canUse: boolean;
+            configValues: {};
+        } | {
             configValues: Record<string, unknown>;
+            featureCode: string;
+            isEnabled: boolean;
+            hasQuantity: boolean;
+            currentUsage: number;
+            quantityLimit: number | null;
+            includedQuantity: number;
+            remaining: number | null;
+            isAtLimit: boolean;
+            canUse: boolean;
+            companyId: string;
+            productLinkId: string;
+            externalOrgId: string;
         }>;
     };
     /**
      * Billing, usage tracking, and subscription management.
      *
-     * Track feature usage for billing, claim subscriptions from Stripe checkout,
+     * Set feature usage for billing, claim subscriptions from Stripe checkout,
      * or link existing Stripe subscriptions to companies.
      *
-     * @example Track Usage
+     * @example Set Usage
      * ```typescript
-     * await os.billing.trackUsage({
+     * await os.billing.setUsage({
      *   companyId: company.id,
      *   featureCode: 'ai_credit',
-     *   quantity: 1,
-     *   idempotencyKey: `msg_${messageId}` // Prevent double-counting
+     *   absoluteValue: 42,
+     *   reason: 'Synced current usage'
      * })
      * ```
      *
@@ -1183,246 +986,37 @@ export declare class ChatarminOS {
      * ```
      */
     get billing(): {
-        /**
-         * Track usage for a metered feature.
-         *
-         * Increments the usage counter for a feature and returns the
-         * updated usage information. Use idempotency keys to prevent
-         * duplicate tracking.
-         *
-         * @param input - Usage tracking parameters
-         * @returns Updated usage information
-         * @throws {TRPCError} If feature is not enabled or limit exceeded
-         *
-         * @example
-         * ```typescript
-         * const result = await os.billing.trackUsage({
-         *   companyId: 'comp_xxx',
-         *   featureCode: 'ai_credit',
-         *   quantity: 5,
-         *   idempotencyKey: `request_${requestId}`,
-         *   metadata: { model: 'gpt-4' }
-         * })
-         *
-         * console.log({
-         *   currentUsage: result.currentUsage,
-         *   remaining: result.remaining,
-         *   billable: result.billableQuantity,
-         *   isAtLimit: result.isAtLimit
-         * })
-         * ```
-         */
-        trackUsage: (input: TrackUsageInput) => Promise<{
-            success: boolean;
-            featureCode: string;
-            currentUsage: number;
-            previousUsage: number;
-            quantityLimit: number | null;
-            remaining: number | null;
-            isAtLimit: boolean;
-            includedQuantity: number;
-            billableQuantity: number;
-            delta: number;
-            meterId: string;
-            eventId: string | null;
-        }>;
-        /**
-         * Track usage by external org ID (product link).
-         *
-         * Resolves the linked company for the current product and tracks
-         * usage with product-link attribution.
-         *
-         * @param input - Usage tracking parameters
-         * @returns Updated usage information
-         * @throws {TRPCError} If no linked company is found or limit exceeded
-         *
-         * @example
-         * ```typescript
-         * const result = await os.billing.trackUsageByExternalOrgId({
-         *   externalOrgId: "org_acme_123",
-         *   featureCode: "ai_credit",
-         *   quantity: 1,
-         *   idempotencyKey: `msg_${messageId}`,
-         * })
-         * ```
-         */
-        trackUsageByExternalOrgId: (input: TrackUsageByExternalOrgIdInput) => Promise<{
-            success: boolean;
-            featureCode: string;
-            currentUsage: number;
-            previousUsage: number;
-            quantityLimit: number | null;
-            remaining: number | null;
-            isAtLimit: boolean;
-            includedQuantity: number;
-            billableQuantity: number;
-            delta: number;
-            meterId: string;
-            eventId: string | null;
-        }>;
-        /**
-         * Set usage to an absolute value.
-         *
-         * Use this for corrections when you know what the total usage SHOULD be.
-         * Creates a snapshot for audit trail. The delta (difference) is calculated
-         * automatically and synced to Stripe.
-         *
-         * @param input - Set usage parameters
-         * @returns Result with previous and new usage values
-         *
-         * @example Correct usage to 100 (was 150)
-         * ```typescript
-         * const result = await os.billing.setUsage({
-         *   companyId: 'comp_xxx',
-         *   featureCode: 'ai_credit',
-         *   absoluteValue: 100,
-         *   reason: 'Corrected after customer support review',
-         *   performedBy: 'admin@company.com'
-         * })
-         *
-         * console.log({
-         *   previousUsage: result.previousUsage, // 150
-         *   currentUsage: result.currentUsage,   // 100
-         *   delta: result.delta                   // -50
-         * })
-         * ```
-         */
-        setUsage: (input: SetUsageInput) => Promise<UsageResult>;
-        /**
-         * Adjust usage by a delta (positive or negative).
-         *
-         * Use this for explicit corrections. Supports negative values for
-         * refunds or error corrections. Creates an audit trail and syncs
-         * to Stripe (including meter event adjustments when possible).
-         *
-         * @param input - Adjustment parameters
-         * @returns Result with previous and new usage values
-         *
-         * @example Refund 50 units
-         * ```typescript
-         * const result = await os.billing.adjustUsage({
-         *   companyId: 'comp_xxx',
-         *   featureCode: 'ai_credit',
-         *   delta: -50,
-         *   reason: 'Refund for failed API calls',
-         *   performedBy: 'support@company.com'
-         * })
-         * ```
-         *
-         * @example Add bonus units
-         * ```typescript
-         * const result = await os.billing.adjustUsage({
-         *   companyId: 'comp_xxx',
-         *   featureCode: 'ai_credit',
-         *   delta: 100,
-         *   reason: 'Promotional bonus for beta testers'
-         * })
-         * ```
-         */
-        adjustUsage: (input: AdjustUsageInput) => Promise<UsageResult>;
-        /**
-         * Get usage event history for a feature.
-         *
-         * Returns the history of usage events including increments, sets,
-         * and adjustments. Useful for auditing and debugging.
-         *
-         * @param companyId - Company ID
-         * @param featureCode - Feature code to get history for
-         * @param options - Query options
-         * @returns Array of usage events
-         *
-         * @example
-         * ```typescript
-         * const history = await os.billing.getUsageHistory(
-         *   'comp_xxx',
-         *   'ai_credit',
-         *   { limit: 20, eventType: 'adjustment' }
-         * )
-         *
-         * for (const event of history) {
-         *   console.log(`${event.event_type}: ${event.quantity} at ${event.event_time}`)
-         *   if (event.adjustment_reason) {
-         *     console.log(`  Reason: ${event.adjustment_reason}`)
-         *   }
-         * }
-         * ```
-         */
+        getDashboardContext: (input: import("./index.js").GetBillingDashboardContextInput) => Promise<import("./index.js").BillingDashboardContext>;
+        setUsage: (input: import("./index.js").SetUsageInput) => Promise<import("./index.js").UsageResult>;
         getUsageHistory: (companyId: string, featureCode: string, options?: {
             limit?: number;
             includeDelivered?: boolean;
             eventType?: "increment" | "set" | "adjustment";
         }) => Promise<{
             id: string;
-            metadata: unknown;
             created_at: Date;
-            company_id: string;
+            metadata: unknown;
+            event_type: string;
+            source: string;
             billing_profile_id: string | null;
-            stripe_price_id: string | null;
-            meter_code: string;
+            idempotency_key: string;
             subscription_item_id: string | null;
-            source: string;
+            feature_access_id: string | null;
+            meter_code: string;
             quantity: number;
-            product_link_id: string | null;
+            stripe_price_id: string | null;
             event_time: Date;
-            event_type: string;
             previous_value: number | null;
             adjustment_reason: string | null;
             adjusts_event_id: string | null;
-            idempotency_key: string;
             stripe_delivery_status: string;
+            stripe_delivery_attempts: number;
+            stripe_last_delivery_attempt_at: Date | null;
             stripe_event_id: string | null;
             stripe_delivery_error: string | null;
             delivered_at: Date | null;
         }[]>;
-        /**
-         * Get usage snapshots for a feature.
-         *
-         * Returns audit snapshots created by set operations and reconciliations.
-         * Useful for understanding historical usage corrections.
-         *
-         * @param companyId - Company ID
-         * @param featureCode - Feature code
-         * @param limit - Max number of snapshots to return
-         * @returns Array of usage snapshots
-         */
-        getUsageSnapshots: (companyId: string, featureCode: string, limit?: number) => Promise<{
-            id: string;
-            metadata: unknown;
-            created_at: Date;
-            company_id: string;
-            meter_code: string;
-            created_by: string | null;
-            reason: string | null;
-            absolute_value: number;
-            billable_value: number;
-            snapshot_type: string;
-            trigger_event_id: string | null;
-        }[]>;
-        /**
-         * Claim a subscription from a completed Stripe Checkout Session.
-         *
-         * Use this after a user completes Stripe checkout in your product.
-         * This links the subscription and customer to the company in OS.
-         *
-         * @param input - Claim parameters
-         * @returns Result with subscription ID and claim status
-         *
-         * @example
-         * ```typescript
-         * // In your Stripe checkout success handler:
-         * const result = await os.billing.claimCheckout({
-         *   companyId: company.id,
-         *   checkoutSessionId: session.id // From Stripe callback
-         * })
-         *
-         * if (result.alreadyClaimed) {
-         *   console.log('Subscription was already claimed')
-         * } else {
-         *   console.log(`Claimed subscription: ${result.subscriptionId}`)
-         * }
-         * ```
-         */
-        claimCheckout: (input: ClaimCheckoutInput) => Promise<{
+        claimCheckout: (input: import("./index.js").ClaimCheckoutInput) => Promise<{
             success: boolean;
             subscriptionId: string;
             alreadyClaimed: boolean;
@@ -1433,34 +1027,7 @@ export declare class ChatarminOS {
             alreadyClaimed: boolean;
             status: import("stripe").Stripe.Subscription.Status;
         }>;
-        /**
-         * Link an existing Stripe subscription to a company.
-         *
-         * Use this when you create subscriptions on your product's Stripe
-         * account and want OS to track them. Optionally applies tier features.
-         *
-         * @param input - Link parameters
-         * @returns Result with subscription ID, link status, and features applied
-         *
-         * @example
-         * ```typescript
-         * // After creating subscription on your Stripe account:
-         * const result = await os.billing.linkSubscription({
-         *   companyId: company.id,
-         *   stripeSubscriptionId: 'sub_xxx',
-         *   stripeCustomerId: 'cus_xxx', // Optional
-         *   tierCode: 'pro', // Apply tier features
-         *   displayName: 'Pro Plan'
-         * })
-         *
-         * console.log({
-         *   subscriptionId: result.subscriptionId,
-         *   isNew: !result.alreadyLinked,
-         *   featuresApplied: result.featuresApplied
-         * })
-         * ```
-         */
-        linkSubscription: (input: LinkSubscriptionInput) => Promise<{
+        linkSubscription: (input: import("./index.js").LinkSubscriptionInput) => Promise<{
             success: boolean;
             subscriptionId: string;
             alreadyLinked: boolean;
@@ -1475,36 +1042,40 @@ export declare class ChatarminOS {
             tierApplied: boolean;
             featuresApplied: number;
         }>;
-        /**
-         * Get billing status for a company.
-         *
-         * Quick check for subscription status, active features, and
-         * billing profile information.
-         *
-         * @param companyId - Company ID to check
-         * @returns Billing status overview
-         *
-         * @example
-         * ```typescript
-         * const status = await os.billing.getStatus(company.id)
-         *
-         * console.log({
-         *   hasBilling: status.hasBillingProfile,
-         *   subscriptions: status.activeSubscriptions.length,
-         *   features: status.enabledFeaturesCount
-         * })
-         *
-         * // Check active tier
-         * if (status.activeSubscriptions[0]?.tier) {
-         *   console.log(`Current tier: ${status.activeSubscriptions[0].tier.name}`)
-         * }
-         * ```
-         */
         getStatus: (companyId: string) => Promise<{
             hasBillingProfile: boolean;
             stripeCustomerId: string | null;
+            billingProfiles: {
+                id: string;
+                organization_id: string;
+                created_at: Date;
+                updated_at: Date;
+                short_id: string | null;
+                name: string;
+                metadata: unknown;
+                status: string;
+                mrr_cents: number;
+                mrr_committed_cents: number;
+                mrr_usage_cents: number;
+                contract_start_at: Date | null;
+                contract_end_at: Date | null;
+                subscription_status: string;
+                max_days_overdue: number;
+                company_id: string | null;
+                stripe_customer_id: string;
+                link_status: string;
+                default_currency: string;
+                has_payment_method: boolean;
+                open_invoices_count: number;
+                open_amount_cents: number;
+                past_due_invoices_count: number;
+                past_due_amount_cents: number;
+                last_synced_at: Date | null;
+                company_group_id: string | null;
+            }[];
             activeSubscriptions: {
                 id: string;
+                billingProfileId: string;
                 status: string;
                 stripeSubscriptionId: string | null;
                 currentPeriodEnd: Date | null;
@@ -1516,14 +1087,8 @@ export declare class ChatarminOS {
             }[];
             enabledFeaturesCount: number;
         }>;
-        /**
-         * Sync billing profile, subscriptions, and feature access from Stripe.
-         */
-        syncCompanyFromStripe: (input: SyncCompanyFromStripeInput) => Promise<SyncCompanyFromStripeResult>;
-        /**
-         * Relink billing profile to a new Stripe customer (destructive).
-         */
-        relinkBillingProfile: (input: RelinkBillingProfileInput) => Promise<{
+        syncCompanyFromStripe: (input: import("./index.js").SyncCompanyFromStripeInput) => Promise<import("./index.js").SyncCompanyFromStripeResult>;
+        relinkBillingProfile: (input: import("./index.js").RelinkBillingProfileInput) => Promise<{
             billingProfileId: string;
             stripeCustomerId: string;
             subscriptionsSynced: number;
@@ -1531,10 +1096,7 @@ export declare class ChatarminOS {
             featuresLinked: number;
             matchedMeters: number;
         }>;
-        /**
-         * Ensure a feature is linked to an active Stripe subscription item.
-         */
-        ensureFeatureSubscription: (input: EnsureFeatureSubscriptionInput) => Promise<EnsureFeatureSubscriptionResult>;
+        ensureFeatureSubscription: (input: import("./index.js").EnsureFeatureSubscriptionInput) => Promise<import("./index.js").EnsureFeatureSubscriptionResult>;
     };
     /**
      * Manual link operations for associating external IDs with companies.
@@ -1589,18 +1151,20 @@ export declare class ChatarminOS {
             externalUserId?: string;
         }) => Promise<{
             id: string;
-            metadata: unknown;
             created_at: Date;
             updated_at: Date;
-            company_id: string;
+            metadata: unknown;
+            status: string;
             product_id: string;
+            company_id: string | null;
             external_org_id: string;
             external_user_id: string | null;
             confidence: number | null;
             sync_status: string;
             link_type: string;
             label: string | null;
-        } | undefined>;
+            external_display_name: string | null;
+        }>;
         /**
          * Delete all product links for this product.
          *
@@ -1722,15 +1286,15 @@ export declare class ChatarminOS {
                 configValues: unknown;
             }[];
             id: string;
-            code: string;
-            name: string;
-            is_active: boolean;
-            metadata: unknown;
             created_at: Date;
             updated_at: Date;
+            name: string;
+            metadata: unknown;
+            product_id: string;
+            code: string;
+            is_active: boolean;
             description: string | null;
             display_order: number;
-            product_id: string;
         }[]>;
         /**
          * Get detailed information about a specific tier.
@@ -1840,15 +1404,15 @@ export declare class ChatarminOS {
                 configValues: unknown;
             }[];
             id: string;
-            code: string;
-            name: string;
-            is_active: boolean;
-            metadata: unknown;
             created_at: Date;
             updated_at: Date;
+            name: string;
+            metadata: unknown;
+            product_id: string;
+            code: string;
+            is_active: boolean;
             description: string | null;
             display_order: number;
-            product_id: string;
         }[]>;
         /**
          * Get detailed tier information by code.