@chatarmin/os 1.0.2 → 1.2.0

package/README.md

@@ -63,6 +63,7 @@ const os = new ChatarminOS({
 // Onboard a new customer (single call does everything!)
 const result = await os.onboard({
   externalOrgId: "org_abc123", // Your product's org ID
+  label: "My Product", // Display label for the product link (required)
   hints: {
     companyName: "Acme Inc",
     domain: "acme.com",
@@ -109,6 +110,7 @@ const company = await os.companies.create({
   name: "Acme Inc",
   domain: "acme.com",
   externalOrgId: "org_abc123",
+  label: "My Product", // Display label for the product link
   contactEmail: "admin@acme.com",
   contactName: "John Doe",
   createdAt: "2024-01-15T10:30:00.000Z", // Optional: historical date
@@ -136,12 +138,13 @@ Intelligently find and link a company using hints.
 ```typescript
 const result = await os.companies.smartLink({
   externalOrgId: "org_abc123",
+  label: "My Product", // Display label for the product link (required)
   hints: {
     companyName: "Acme Inc",
     domain: "acme.com",
     emails: ["john@acme.com", "jane@acme.com"],
   },
-  minConfidence: 0.7, // Default: 0.6
+  minConfidence: 0.7, // Default: 0.8
 })
 
 switch (result.status) {
@@ -542,6 +545,7 @@ The `onboard()` method handles:
 ```typescript
 const result = await os.onboard({
   externalOrgId: "org_abc123", // Your product's org ID (required)
+  label: "My Product", // Display label for the product link (required)
   hints: {
     companyName: "Acme Inc",
     domain: "acme.com",
@@ -566,6 +570,7 @@ console.log({
 ```typescript
 const result = await os.onboard({
   externalOrgId: "org_abc123",
+  label: "My Product",
   hints: { companyName: "Acme Inc", domain: "acme.com" },
   checkoutSessionId: "cs_test_xxx", // From Stripe checkout callback
 })
@@ -579,6 +584,7 @@ const result = await os.onboard({
 ```typescript
 const result = await os.onboard({
   externalOrgId: "org_abc123",
+  label: "My Product",
   hints: { companyName: "Acme Inc" },
   tierCode: "free",
   contactEmail: "admin@acme.com",
@@ -602,6 +608,7 @@ const stripeSub = await stripe.subscriptions.create({
 // 3. Onboard with the subscription
 const result = await os.onboard({
   externalOrgId: "org_abc123",
+  label: "My Product",
   hints: { companyName: "Acme Inc" },
   stripeSubscriptionId: stripeSub.id,
   stripeCustomerId: stripeCustomerId,
@@ -617,6 +624,7 @@ const result = await os.onboard({
 ```typescript
 const result = await os.onboard({
   externalOrgId: "org_abc123",
+  label: "My Product",
   hints: { companyName: "Acme Inc" },
 })
 
@@ -684,6 +692,7 @@ const session = await stripe.checkout.sessions.create({
 // 3. After checkout completes → Claim subscription
 const result = await os.onboard({
   externalOrgId: "org_abc123",
+  label: "My Product",
   checkoutSessionId: session.id,
 })
 ```
@@ -700,6 +709,7 @@ for (const org of historicalData) {
   // Create company with historical date
   const result = await os.onboard({
     externalOrgId: org.id,
+    label: "Imported", // Display label for historical import
     hints: {
       companyName: org.name,
       domain: org.domain,

package/dist/index.d.ts

@@ -27,6 +27,8 @@ export interface CreateCompanyInput {
     externalOrgId: string;
     /** Optional user ID who created this in your product */
     externalUserId?: string;
+    /** Display label for the product link (e.g., "Chatarmin CX", "Shopify") */
+    label?: string;
     /** Primary contact email */
     contactEmail?: string;
     /** Primary contact name */
@@ -40,6 +42,8 @@ export interface CreateCompanyInput {
 export interface SmartLinkInput {
     /** Your product's unique organization ID for this company */
     externalOrgId: string;
+    /** Display label for the product link (e.g., "Chatarmin CX", "Shopify") */
+    label: string;
     /** Hints to help match existing companies */
     hints: {
         /** Company name to match against */
@@ -51,7 +55,7 @@ export interface SmartLinkInput {
     };
     /**
      * Minimum confidence score (0-1) required for auto-linking.
-     * @default 0.6
+     * @default 0.8
      */
     minConfidence?: number;
 }
@@ -85,6 +89,44 @@ export interface FeatureCheckInput {
     companyId: string;
     /** Feature code (e.g., "ai_credit", "whatsapp_messages") */
     featureCode: string;
+    /**
+     * Verify Stripe subscription is active for this feature.
+     * When true, the response includes subscription validation fields
+     * and `canUse` will be false if no active subscription exists.
+     * @default false
+     */
+    verifySubscription?: boolean;
+}
+/**
+ * Result of a feature access check.
+ */
+export interface FeatureCheckResult {
+    /** Feature code */
+    featureCode: string;
+    /** Whether the feature is enabled for this company */
+    isEnabled: boolean;
+    /** Whether this feature tracks quantity/usage */
+    hasQuantity: boolean;
+    /** Current usage count (for quantity-based features) */
+    currentUsage: number;
+    /** Maximum allowed quantity (null = unlimited) */
+    quantityLimit: number | null;
+    /** Included/free quantity before overage charges */
+    includedQuantity: number;
+    /** Remaining quantity before limit (null = unlimited) */
+    remaining: number | null;
+    /** Whether usage limit has been reached */
+    isAtLimit: boolean;
+    /** Whether the company can use this feature (enabled + not at limit + subscription if verified) */
+    canUse: boolean;
+    /** Whether an active Stripe subscription exists for this feature */
+    hasActiveSubscription?: boolean;
+    /** Stripe subscription status (active, trialing, canceled, etc.) */
+    subscriptionStatus?: string | null;
+    /** Stripe price ID from the subscription item */
+    stripePriceId?: string | null;
+    /** Stripe subscription ID */
+    stripeSubscriptionId?: string | null;
 }
 /**
  * Input for updating feature access with partial config merge.
@@ -113,7 +155,7 @@ export interface FeatureSetAccessInput {
     validUntil?: Date | null;
 }
 /**
- * Input for tracking feature usage.
+ * Input for tracking feature usage (increment operation).
  */
 export interface TrackUsageInput {
     /** Company ID */
@@ -121,7 +163,7 @@ export interface TrackUsageInput {
     /** Feature code to track */
     featureCode: string;
     /**
-     * Quantity to track.
+     * Quantity to track (must be positive).
      * @default 1
      */
     quantity?: number;
@@ -130,8 +172,77 @@ export interface TrackUsageInput {
      * Use a unique ID per operation (e.g., message ID).
      */
     idempotencyKey?: string;
-    /** Additional metadata for the usage event */
+    /**
+     * 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 false
+     */
+    ensureSubscription?: boolean;
+}
+/**
+ * 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.
@@ -216,6 +327,8 @@ export interface BulkContactResult {
 export interface OnboardInput {
     /** Your product's unique organization ID for this customer */
     externalOrgId: string;
+    /** Display label for the product link (e.g., "Chatarmin CX", "Shopify") */
+    label: string;
     /**
      * Hints for smart company matching.
      * Provide as much info as possible for best matching.
@@ -312,6 +425,7 @@ export interface OnboardResult {
  * // When a new user signs up in your product:
  * const result = await os.onboard({
  *   externalOrgId: 'org_abc123',
+ *   label: 'My Product',
  *   hints: {
  *     companyName: 'Acme Inc',
  *     domain: 'acme.com'
@@ -401,11 +515,11 @@ export declare class ChatarminOS {
         getByProductLink: (input: {
             externalOrgId: string;
         }) => Promise<{
+            external_org_id: string;
+            external_user_id: string | null;
             name: string;
             id: string;
             domain: string | null;
-            external_org_id: string;
-            external_user_id: string | null;
         } | null>;
         /**
          * Create a new company and link it to your product.
@@ -676,17 +790,7 @@ export declare class ChatarminOS {
          * })
          * ```
          */
-        check: (input: FeatureCheckInput) => Promise<{
-            featureCode: string;
-            isEnabled: boolean;
-            hasQuantity: boolean;
-            currentUsage: number;
-            quantityLimit: number | null;
-            includedQuantity: number;
-            remaining: number | null;
-            isAtLimit: boolean;
-            canUse: boolean;
-        }>;
+        check: (input: FeatureCheckInput) => Promise<FeatureCheckResult>;
         /**
          * List all features and their access status for a company.
          *
@@ -916,13 +1020,152 @@ export declare class ChatarminOS {
             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}`)
+         *   }
+         * }
+         * ```
+         */
+        getUsageHistory: (companyId: string, featureCode: string, options?: {
+            limit?: number;
+            includeDelivered?: boolean;
+            eventType?: "increment" | "set" | "adjustment";
+        }) => Promise<{
+            id: string;
+            metadata: unknown;
+            source: string;
+            quantity: number;
+            created_at: Date;
+            company_id: string;
+            billing_profile_id: string;
+            meter_code: string;
+            available_product_id: string;
+            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_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;
+            reason: string | null;
+            created_at: Date;
+            company_id: string;
+            meter_code: string;
+            created_by: 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.
          *
@@ -1066,19 +1309,29 @@ export declare class ChatarminOS {
          * a direct link without smart matching.
          *
          * @param input - Link parameters
+         * @param input.companyId - Company UUID or short_id (e.g., "acme-corp")
          * @returns The created link record
          *
-         * @example
+         * @example Using UUID
          * ```typescript
          * const link = await os.links.create({
-         *   companyId: 'comp_xxx',
+         *   companyId: 'a1b2c3d4-e5f6-...',
          *   externalOrgId: 'org_abc123',
-         *   label: 'Store Vienna', // Optional: display label
-         *   externalUserId: 'user_xyz' // Optional: user who created the link
+         *   label: 'Store Vienna'
+         * })
+         * ```
+         *
+         * @example Using short_id
+         * ```typescript
+         * const link = await os.links.create({
+         *   companyId: 'acme-corp', // short_id works too!
+         *   externalOrgId: 'org_abc123',
+         *   label: 'Store Vienna'
          * })
          * ```
          */
         create: (input: {
+            /** Company UUID or short_id */
             companyId: string;
             externalOrgId: string;
             label?: string;
@@ -1086,16 +1339,16 @@ export declare class ChatarminOS {
         }) => Promise<{
             id: string;
             metadata: unknown;
-            label: string | null;
             confidence: number | null;
+            label: string | null;
             created_at: Date;
             updated_at: Date;
             company_id: string;
             product_id: string;
             external_org_id: string;
             external_user_id: string | null;
-            link_type: string;
             sync_status: string;
+            link_type: string;
         } | undefined>;
         /**
          * Delete all product links for this product.
@@ -1223,9 +1476,9 @@ export declare class ChatarminOS {
             description: string | null;
             code: string;
             is_active: boolean;
-            display_order: number;
             created_at: Date;
             updated_at: Date;
+            display_order: number;
             product_id: string;
         }[]>;
         /**
@@ -1341,9 +1594,9 @@ export declare class ChatarminOS {
             description: string | null;
             code: string;
             is_active: boolean;
-            display_order: number;
             created_at: Date;
             updated_at: Date;
+            display_order: number;
             product_id: string;
         }[]>;
         /**
@@ -1481,6 +1734,7 @@ export declare class ChatarminOS {
      * ```typescript
      * const result = await os.onboard({
      *   externalOrgId: 'org_abc123',
+     *   label: 'My Product',
      *   hints: {
      *     companyName: 'Acme Inc',
      *     domain: 'acme.com'
@@ -1495,6 +1749,7 @@ export declare class ChatarminOS {
      * ```typescript
      * const result = await os.onboard({
      *   externalOrgId: 'org_abc123',
+     *   label: 'My Product',
      *   hints: {
      *     companyName: 'Acme Inc',
      *     domain: 'acme.com'
@@ -1521,6 +1776,7 @@ export declare class ChatarminOS {
      * // Then onboard with the subscription
      * const result = await os.onboard({
      *   externalOrgId: 'org_abc123',
+     *   label: 'My Product',
      *   hints: { companyName: 'Acme Inc' },
      *   stripeSubscriptionId: stripeSub.id,
      *   stripeCustomerId: stripeCustomerId,
@@ -1535,6 +1791,7 @@ export declare class ChatarminOS {
      * ```typescript
      * const result = await os.onboard({
      *   externalOrgId: 'org_abc123',
+     *   label: 'My Product',
      *   hints: { companyName: 'Acme Inc' }
      * })
      *

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -23,6 +23,7 @@ import superjson from "superjson";
  * // When a new user signs up in your product:
  * const result = await os.onboard({
  *   externalOrgId: 'org_abc123',
+ *   label: 'My Product',
  *   hints: {
  *     companyName: 'Acme Inc',
  *     domain: 'acme.com'
@@ -555,6 +556,120 @@ export class ChatarminOS {
              * ```
              */
             trackUsage: (input) => client.billing.trackUsage.mutate(input),
+            /**
+             * 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) => client.billing.setUsage.mutate({
+                ...input,
+                source: "api",
+            }),
+            /**
+             * 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) => client.billing.adjustUsage.mutate({
+                ...input,
+                source: "api",
+            }),
+            /**
+             * 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}`)
+             *   }
+             * }
+             * ```
+             */
+            getUsageHistory: (companyId, featureCode, options) => client.billing.getUsageHistory.query({
+                companyId,
+                featureCode,
+                ...options,
+            }),
+            /**
+             * 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, featureCode, limit) => client.billing.getUsageSnapshots.query({
+                companyId,
+                featureCode,
+                limit,
+            }),
             /**
              * Claim a subscription from a completed Stripe Checkout Session.
              *
@@ -665,15 +780,24 @@ export class ChatarminOS {
              * a direct link without smart matching.
              *
              * @param input - Link parameters
+             * @param input.companyId - Company UUID or short_id (e.g., "acme-corp")
              * @returns The created link record
              *
-             * @example
+             * @example Using UUID
              * ```typescript
              * const link = await os.links.create({
-             *   companyId: 'comp_xxx',
+             *   companyId: 'a1b2c3d4-e5f6-...',
              *   externalOrgId: 'org_abc123',
-             *   label: 'Store Vienna', // Optional: display label
-             *   externalUserId: 'user_xyz' // Optional: user who created the link
+             *   label: 'Store Vienna'
+             * })
+             * ```
+             *
+             * @example Using short_id
+             * ```typescript
+             * const link = await os.links.create({
+             *   companyId: 'acme-corp', // short_id works too!
+             *   externalOrgId: 'org_abc123',
+             *   label: 'Store Vienna'
              * })
              * ```
              */
@@ -968,6 +1092,7 @@ export class ChatarminOS {
      * ```typescript
      * const result = await os.onboard({
      *   externalOrgId: 'org_abc123',
+     *   label: 'My Product',
      *   hints: {
      *     companyName: 'Acme Inc',
      *     domain: 'acme.com'
@@ -982,6 +1107,7 @@ export class ChatarminOS {
      * ```typescript
      * const result = await os.onboard({
      *   externalOrgId: 'org_abc123',
+     *   label: 'My Product',
      *   hints: {
      *     companyName: 'Acme Inc',
      *     domain: 'acme.com'
@@ -1008,6 +1134,7 @@ export class ChatarminOS {
      * // Then onboard with the subscription
      * const result = await os.onboard({
      *   externalOrgId: 'org_abc123',
+     *   label: 'My Product',
      *   hints: { companyName: 'Acme Inc' },
      *   stripeSubscriptionId: stripeSub.id,
      *   stripeCustomerId: stripeCustomerId,
@@ -1022,6 +1149,7 @@ export class ChatarminOS {
      * ```typescript
      * const result = await os.onboard({
      *   externalOrgId: 'org_abc123',
+     *   label: 'My Product',
      *   hints: { companyName: 'Acme Inc' }
      * })
      *
@@ -1041,6 +1169,7 @@ export class ChatarminOS {
         let linkStatus;
         const smartLinkResult = await this.companies.smartLink({
             externalOrgId: input.externalOrgId,
+            label: input.label,
             hints: input.hints ?? {},
         });
         if (smartLinkResult.status === "already_linked") {
@@ -1059,6 +1188,7 @@ export class ChatarminOS {
                 name: input.hints?.companyName ?? `Company ${input.externalOrgId}`,
                 domain: input.hints?.domain,
                 externalOrgId: input.externalOrgId,
+                label: input.label,
                 contactEmail: input.contactEmail,
                 contactName: input.contactName,
                 createdAt: input.createdAt,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatarmin/os",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "Type-safe SDK for ChatarminOS - Customer & Subscription Management",
   "type": "module",
   "publishConfig": {
@@ -25,6 +25,7 @@
     "typecheck": "tsc --noEmit --skipLibCheck",
     "test": "tsx test-sdk.ts",
     "sync": "tsx scripts/sync-orgs.ts",
+    "sync:interactive": "tsx scripts/sync-interactive.ts",
     "sync:example": "tsx scripts/sync-orgs.ts ./scripts/data/orgs.example.json --dry-run --verbose",
     "prepublishOnly": "pnpm build",
     "release": "./scripts/publish.sh",