@commet/node 1.7.1 → 1.9.0

package/dist/index.mjs

@@ -1,61 +1,46 @@
 // src/customer.ts
 var CustomerContext = class {
-  constructor(externalId, resources) {
-    /**
-     * Feature access methods - delegates to FeaturesResource
-     */
+  constructor(customerId, resources) {
     this.features = {
-      get: (code, options) => this.featuresResource.get({ code, externalId: this.externalId }, options),
+      get: (code, options) => this.featuresResource.get({ code, customerId: this.customerId }, options),
       check: (code, options) => this.featuresResource.check(
-        { code, externalId: this.externalId },
+        { code, customerId: this.customerId },
         options
       ),
       canUse: (code, options) => this.featuresResource.canUse(
-        { code, externalId: this.externalId },
+        { code, customerId: this.customerId },
         options
       ),
-      list: (options) => this.featuresResource.list(this.externalId, options)
+      list: (options) => this.featuresResource.list(this.customerId, options)
     };
-    /**
-     * Seat management methods - delegates to SeatsResource
-     */
     this.seats = {
       add: (seatType, count = 1, options) => this.seatsResource.add(
-        { externalId: this.externalId, seatType, count },
+        { customerId: this.customerId, seatType, count },
         options
       ),
       remove: (seatType, count = 1, options) => this.seatsResource.remove(
-        { externalId: this.externalId, seatType, count },
+        { customerId: this.customerId, seatType, count },
         options
       ),
       set: (seatType, count, options) => this.seatsResource.set(
-        { externalId: this.externalId, seatType, count },
+        { customerId: this.customerId, seatType, count },
         options
       ),
-      getBalance: (seatType) => this.seatsResource.getBalance({ externalId: this.externalId, seatType })
+      getBalance: (seatType) => this.seatsResource.getBalance({ customerId: this.customerId, seatType })
     };
-    /**
-     * Usage tracking methods - delegates to UsageResource
-     */
     this.usage = {
       track: (feature, value, properties, options) => this.usageResource.track(
-        { externalId: this.externalId, feature, value, properties },
+        { customerId: this.customerId, feature, value, properties },
         options
       )
     };
-    /**
-     * Subscription methods - delegates to SubscriptionsResource
-     */
     this.subscription = {
-      get: () => this.subscriptionsResource.get(this.externalId)
+      get: () => this.subscriptionsResource.get(this.customerId)
     };
-    /**
-     * Portal methods - delegates to PortalResource
-     */
     this.portal = {
-      getUrl: (options) => this.portalResource.getUrl({ externalId: this.externalId }, options)
+      getUrl: (options) => this.portalResource.getUrl({ customerId: this.customerId }, options)
     };
-    this.externalId = externalId;
+    this.customerId = customerId;
     this.featuresResource = resources.features;
     this.seatsResource = resources.seats;
     this.usageResource = resources.usage;
@@ -89,14 +74,14 @@ var CustomersResource = class {
     this.httpClient = httpClient;
   }
   /**
-   * Create a customer (idempotent with externalId)
+   * Create a customer (idempotent when id is provided)
    */
   async create(params, options) {
     return this.httpClient.post(
       "/customers",
       {
         billingEmail: params.email,
-        externalId: params.externalId,
+        externalId: params.id,
         fullName: params.fullName,
         domain: params.domain,
         website: params.website,
@@ -115,7 +100,7 @@ var CustomersResource = class {
   async createBatch(params, options) {
     const customers = params.customers.map((c) => ({
       billingEmail: c.email,
-      externalId: c.externalId,
+      externalId: c.id,
       fullName: c.fullName,
       domain: c.domain,
       website: c.website,
@@ -141,14 +126,14 @@ var CustomersResource = class {
       `/customers/${params.customerId}`,
       {
         billingEmail: params.email,
-        externalId: params.externalId,
         fullName: params.fullName,
         domain: params.domain,
         website: params.website,
         timezone: params.timezone,
         language: params.language,
         industry: params.industry,
-        metadata: params.metadata
+        metadata: params.metadata,
+        address: params.address
       },
       options
     );
@@ -176,98 +161,41 @@ var FeaturesResource = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
   }
-  /**
-   * Get detailed feature access/usage for a customer
-   *
-   * @example
-   * ```typescript
-   * const seats = await commet.features.get({ code: "team_members", externalId: "user_123" });
-   * console.log(seats.current, seats.included, seats.remaining);
-   * ```
-   */
   async get(params, options) {
-    const { code, externalId } = params;
     return this.httpClient.get(
-      `/features/${code}`,
-      { externalId },
+      `/features/${params.code}`,
+      { customerId: params.customerId },
       options
     );
   }
-  /**
-   * Check if a boolean feature is enabled for a customer
-   *
-   * @example
-   * ```typescript
-   * const { allowed } = await commet.features.check({
-   *   code: "custom_branding",
-   *   externalId: "user_123"
-   * });
-   * if (!allowed) redirect("/upgrade");
-   * ```
-   */
   async check(params, options) {
-    const { code, externalId } = params;
     const result = await this.httpClient.get(
-      `/features/${code}`,
-      { externalId },
+      `/features/${params.code}`,
+      { customerId: params.customerId },
       options
     );
     if (!result.success || !result.data) {
       return {
         success: false,
-        data: { allowed: false },
-        message: result.message
+        code: result.code,
+        message: result.message,
+        details: result.details
       };
     }
     return {
       success: true,
-      data: { allowed: result.data.allowed },
-      message: result.message
+      data: { allowed: result.data.allowed }
     };
   }
-  /**
-   * Check if customer can use one more unit of a feature
-   *
-   * Returns whether the customer can add one more (allowed)
-   * and whether they'll be charged extra (willBeCharged).
-   *
-   * @example
-   * ```typescript
-   * const { allowed, willBeCharged } = await commet.features.canUse({
-   *   code: "team_members",
-   *   externalId: "user_123"
-   * });
-   *
-   * if (!allowed) {
-   *   return { error: "Upgrade to add more members" };
-   * }
-   *
-   * if (willBeCharged) {
-   *   // Show confirmation: "This will cost $10/month extra"
-   * }
-   * ```
-   */
   async canUse(params, options) {
-    const { code, externalId } = params;
     return this.httpClient.get(
-      `/features/${code}`,
-      { externalId, action: "canUse" },
+      `/features/${params.code}`,
+      { customerId: params.customerId, action: "canUse" },
       options
     );
   }
-  /**
-   * List all features for a customer's active subscription
-   *
-   * @example
-   * ```typescript
-   * const features = await commet.features.list({ externalId: "user_123" });
-   * for (const feature of features) {
-   *   console.log(feature.code, feature.allowed);
-   * }
-   * ```
-   */
-  async list(externalId, options) {
-    return this.httpClient.get("/features", { externalId }, options);
+  async list(customerId, options) {
+    return this.httpClient.get("/features", { customerId }, options);
   }
 };
 
@@ -311,14 +239,6 @@ var PortalResource = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
   }
-  /**
-   * Get a portal URL
-   *
-   * @example
-   * ```typescript
-   * const portal = await commet.portal.getUrl({ externalId: 'user_123' });
-   * ```
-   */
   async getUrl(params, options) {
     return this.httpClient.post("/portal/request-access", params, options);
   }
@@ -329,99 +249,27 @@ var SeatsResource = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
   }
-  /**
-   * Add seats
-   *
-   * @example
-   * ```typescript
-   * await commet.seats.add({
-   *   externalId: 'user_123',
-   *   seatType: 'editor',
-   *   count: 5
-   * });
-   * ```
-   */
   async add(params, options) {
     return this.httpClient.post("/seats", params, options);
   }
-  /**
-   * Remove seats
-   *
-   * @example
-   * ```typescript
-   * await commet.seats.remove({
-   *   externalId: 'user_123',
-   *   seatType: 'editor',
-   *   count: 2
-   * });
-   * ```
-   */
   async remove(params, options) {
     return this.httpClient.delete("/seats", params, options);
   }
-  /**
-   * Set seats to a specific count
-   *
-   * @example
-   * ```typescript
-   * await commet.seats.set({
-   *   externalId: 'user_123',
-   *   seatType: 'editor',
-   *   count: 10
-   * });
-   * ```
-   */
   async set(params, options) {
     return this.httpClient.put("/seats", params, options);
   }
-  /**
-   * Set all seat types
-   *
-   * @example
-   * ```typescript
-   * await commet.seats.setAll({
-   *   externalId: 'user_123',
-   *   seats: { editor: 10, viewer: 50 }
-   * });
-   * ```
-   */
   async setAll(params, options) {
     return this.httpClient.put("/seats/bulk", params, options);
   }
-  /**
-   * Get balance for a seat type
-   *
-   * @example
-   * ```typescript
-   * const balance = await commet.seats.getBalance({
-   *   externalId: 'user_123',
-   *   seatType: 'editor'
-   * });
-   * ```
-   */
   async getBalance(params) {
-    const { customerId, externalId, seatType } = params;
     return this.httpClient.get("/seats/balance", {
-      customerId,
-      externalId,
-      seatType
+      customerId: params.customerId,
+      seatType: params.seatType
     });
   }
-  /**
-   * Get all seat balances
-   *
-   * @example
-   * ```typescript
-   * const balances = await commet.seats.getAllBalances({
-   *   externalId: 'user_123'
-   * });
-   * ```
-   */
   async getAllBalances(params) {
-    const { customerId, externalId } = params;
     return this.httpClient.get("/seats/balances", {
-      customerId,
-      externalId
+      customerId: params.customerId
     });
   }
 };
@@ -455,8 +303,8 @@ var SubscriptionsResource = class {
    * const sub = await commet.subscriptions.get('user_123');
    * ```
    */
-  async get(externalId) {
-    return this.httpClient.get("/subscriptions/active", { externalId });
+  async get(customerId) {
+    return this.httpClient.get("/subscriptions/active", { customerId });
   }
   /**
    * Cancel a subscription
@@ -487,7 +335,6 @@ var UsageResource = class {
     const eventData = {
       feature: params.feature,
       customerId: params.customerId,
-      externalId: params.externalId,
       idempotencyKey: params.idempotencyKey,
       timestamp: params.timestamp || (/* @__PURE__ */ new Date()).toISOString(),
       properties: params.properties ? Object.entries(params.properties).map(([property, value]) => ({
@@ -510,36 +357,6 @@ var UsageResource = class {
     }
     return this.httpClient.post("/usage/events", eventData, options);
   }
-  async trackBatch(params, options) {
-    const events = params.events.map((event) => {
-      const eventData = {
-        feature: event.feature,
-        customerId: event.customerId,
-        externalId: event.externalId,
-        idempotencyKey: event.idempotencyKey,
-        timestamp: event.timestamp || (/* @__PURE__ */ new Date()).toISOString(),
-        properties: event.properties ? Object.entries(event.properties).map(([property, value]) => ({
-          property,
-          value
-        })) : void 0
-      };
-      if ("model" in event && event.model) {
-        eventData.model = event.model;
-        eventData.inputTokens = event.inputTokens;
-        eventData.outputTokens = event.outputTokens;
-        if (event.cacheReadTokens) {
-          eventData.cacheReadTokens = event.cacheReadTokens;
-        }
-        if (event.cacheWriteTokens) {
-          eventData.cacheWriteTokens = event.cacheWriteTokens;
-        }
-      } else {
-        eventData.value = event.value;
-      }
-      return eventData;
-    });
-    return this.httpClient.post("/usage/events/batch", { events }, options);
-  }
 };
 
 // src/resources/webhooks.ts
@@ -707,7 +524,7 @@ var CommetHTTPClient = class {
       const headers = {
         "x-api-key": this.config.apiKey,
         "Content-Type": "application/json",
-        "User-Agent": "commet/0.1.0"
+        "User-Agent": "commet-node/1.9.0"
       };
       if (options?.idempotencyKey) {
         headers["Idempotency-Key"] = options.idempotencyKey;
@@ -753,13 +570,6 @@ var CommetHTTPClient = class {
             responseText
           );
         }
-        if (response.status === 404) {
-          return {
-            success: false,
-            code: "not_found",
-            message: "Resource not found"
-          };
-        }
         throw new CommetAPIError(
           `Invalid JSON response: ${response.status} ${response.statusText}`,
           response.status,
@@ -814,7 +624,10 @@ var CommetHTTPClient = class {
       }
       return responseData;
     } catch (error) {
-      if (error instanceof TypeError && error.message.includes("fetch")) {
+      const isNetworkError = error instanceof TypeError && error.message.includes("fetch");
+      const isTimeoutError = error instanceof DOMException && error.name === "AbortError";
+      const isTimeoutErrorModern = typeof globalThis.DOMException !== "undefined" && error instanceof DOMException && error.name === "TimeoutError";
+      if (isNetworkError || isTimeoutError || isTimeoutErrorModern) {
         if (attempt <= this.retryConfig.maxRetries) {
           const delay = Math.min(
             this.retryConfig.baseDelay * 2 ** (attempt - 1),
@@ -918,8 +731,8 @@ var Commet = class {
    * await customer.usage.track("api_call");
    * ```
    */
-  customer(externalId) {
-    return new CustomerContext(externalId, {
+  customer(customerId) {
+    return new CustomerContext(customerId, {
       features: this.features,
       seats: this.seats,
       usage: this.usage,