colacloud 1.2.0 → 1.4.0

package/dist/index.mjs

@@ -38,14 +38,14 @@ var AuthenticationError = class _AuthenticationError extends ColaCloudError {
   }
 };
 var RateLimitError = class _RateLimitError extends ColaCloudError {
-  /** Rate limit information from headers */
-  rateLimit;
+  /** Quota information from headers */
+  quota;
   /** Seconds until the rate limit resets */
   retryAfter;
-  constructor(message = "Rate limit exceeded", rateLimit = null, retryAfter = null) {
+  constructor(message = "Rate limit exceeded", quota = null, retryAfter = null) {
     super(message, 429, "rate_limit_exceeded");
     this.name = "RateLimitError";
-    this.rateLimit = rateLimit;
+    this.quota = quota;
     this.retryAfter = retryAfter;
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, _RateLimitError);
@@ -131,9 +131,15 @@ function createPaginatedIterator(options) {
               done = true;
               break;
             }
-            if (pagination !== null && currentPage > pagination.pages) {
-              done = true;
-              break;
+            if (pagination !== null) {
+              if (pagination.has_more === false) {
+                done = true;
+                break;
+              }
+              if (pagination.pages !== null && currentPage > pagination.pages) {
+                done = true;
+                break;
+              }
             }
             const result = await fetchPage({
               ...params,
@@ -171,7 +177,7 @@ function createPaginatedIteratorWithMetadata(options) {
       let currentItems = [];
       let currentIndex = 0;
       let pagination = null;
-      let rateLimit = null;
+      let quota = null;
       let pagesFetched = 0;
       let done = false;
       return {
@@ -181,16 +187,22 @@ function createPaginatedIteratorWithMetadata(options) {
               done = true;
               break;
             }
-            if (pagination !== null && currentPage > pagination.pages) {
-              done = true;
-              break;
+            if (pagination !== null) {
+              if (pagination.has_more === false) {
+                done = true;
+                break;
+              }
+              if (pagination.pages !== null && currentPage > pagination.pages) {
+                done = true;
+                break;
+              }
             }
             const result = await fetchPage({
               ...params,
               page: currentPage
             });
             pagination = result.response.pagination;
-            rateLimit = result.rateLimit;
+            quota = result.quota;
             currentItems = result.response.data;
             currentIndex = 0;
             currentPage++;
@@ -211,7 +223,7 @@ function createPaginatedIteratorWithMetadata(options) {
               // We already incremented after fetch
               indexInPage: currentIndex,
               total: pagination?.total ?? 0,
-              rateLimit
+              quota
             };
             currentIndex++;
             return { done: false, value: result };
@@ -248,14 +260,20 @@ function toSnakeCase(params) {
   }
   return result;
 }
-function parseRateLimitHeaders(headers) {
-  const limit = headers.get("X-RateLimit-Limit");
-  const remaining = headers.get("X-RateLimit-Remaining");
-  const reset = headers.get("X-RateLimit-Reset");
-  if (limit === null || remaining === null || reset === null) {
-    return null;
-  }
+function parseQuotaHeaders(headers) {
+  const reset = headers.get("X-Quota-Reset");
+  if (reset === null) return null;
+  let limit = headers.get("X-Detail-Views-Limit");
+  let remaining = headers.get("X-Detail-Views-Remaining");
+  let meter = "detail_views";
+  if (limit === null) {
+    limit = headers.get("X-List-Records-Limit");
+    remaining = headers.get("X-List-Records-Remaining");
+    meter = "list_records";
+  }
+  if (limit === null || remaining === null) return null;
   return {
+    meter,
     limit: parseInt(limit, 10),
     remaining: parseInt(remaining, 10),
     reset: parseInt(reset, 10)
@@ -273,6 +291,12 @@ var ColaCloud = class {
   barcodes;
   /** Usage statistics endpoint */
   usage;
+  /** Processing times reference data endpoints */
+  processingTimes;
+  /** Production reports reference data endpoints */
+  productionReports;
+  /** AVA (American Viticultural Area) reference data endpoints */
+  avas;
   /**
    * Create a new COLA Cloud API client
    * @param config Configuration options
@@ -288,6 +312,9 @@ var ColaCloud = class {
     this.permittees = new PermitteesResource(this);
     this.barcodes = new BarcodesResource(this);
     this.usage = new UsageResource(this);
+    this.processingTimes = new ProcessingTimesResource(this);
+    this.productionReports = new ProductionReportsResource(this);
+    this.avas = new AvasResource(this);
   }
   /**
    * Make an authenticated request to the API
@@ -312,12 +339,12 @@ var ColaCloud = class {
         signal: controller.signal
       });
       clearTimeout(timeoutId);
-      const rateLimit = parseRateLimitHeaders(response.headers);
+      const quota = parseQuotaHeaders(response.headers);
       if (!response.ok) {
-        await this.handleErrorResponse(response, rateLimit);
+        await this.handleErrorResponse(response, quota);
       }
       const data = await response.json();
-      return { data, rateLimit };
+      return { data, quota };
     } catch (error) {
       clearTimeout(timeoutId);
       if (error instanceof Error && error.name === "AbortError") {
@@ -335,7 +362,7 @@ var ColaCloud = class {
   /**
    * Handle error responses from the API
    */
-  async handleErrorResponse(response, rateLimit) {
+  async handleErrorResponse(response, quota) {
     let errorData;
     try {
       errorData = await response.json();
@@ -352,7 +379,7 @@ var ColaCloud = class {
         const retryAfter = response.headers.get("Retry-After");
         throw new RateLimitError(
           message,
-          rateLimit,
+          quota,
           retryAfter ? parseInt(retryAfter, 10) : null
         );
       }
@@ -387,11 +414,11 @@ var ColasResource = class {
     return result.data;
   }
   /**
-   * List COLAs with rate limit information
+   * List COLAs with quota information
    * @param params Search and filter parameters
-   * @returns Paginated list with rate limit info
+   * @returns Paginated list with quota info
    */
-  async listWithRateLimit(params = {}) {
+  async listWithQuota(params = {}) {
     return this.client.request(
       "GET",
       "/colas",
@@ -418,17 +445,17 @@ var ColasResource = class {
     }
   }
   /**
-   * Get a single COLA with rate limit information
+   * Get a single COLA with quota information
    * @param ttbId The unique TTB identifier
-   * @returns COLA details with rate limit info
+   * @returns COLA details with quota info
    */
-  async getWithRateLimit(ttbId) {
+  async getWithQuota(ttbId) {
     try {
       const result = await this.client.request(
         "GET",
         `/colas/${encodeURIComponent(ttbId)}`
       );
-      return { data: result.data.data, rateLimit: result.rateLimit };
+      return { data: result.data.data, quota: result.quota };
     } catch (error) {
       if (error instanceof NotFoundError) {
         throw new NotFoundError("COLA", ttbId);
@@ -457,7 +484,7 @@ var ColasResource = class {
           "/colas",
           p
         );
-        return { response: result.data, rateLimit: result.rateLimit };
+        return { response: result.data, quota: result.quota };
       }
     });
   }
@@ -480,11 +507,11 @@ var PermitteesResource = class {
     return result.data;
   }
   /**
-   * List permittees with rate limit information
+   * List permittees with quota information
    * @param params Search and filter parameters
-   * @returns Paginated list with rate limit info
+   * @returns Paginated list with quota info
    */
-  async listWithRateLimit(params = {}) {
+  async listWithQuota(params = {}) {
     return this.client.request(
       "GET",
       "/permittees",
@@ -511,17 +538,17 @@ var PermitteesResource = class {
     }
   }
   /**
-   * Get a single permittee with rate limit information
+   * Get a single permittee with quota information
    * @param permitNumber The unique permit number
-   * @returns Permittee details with rate limit info
+   * @returns Permittee details with quota info
    */
-  async getWithRateLimit(permitNumber) {
+  async getWithQuota(permitNumber) {
     try {
       const result = await this.client.request(
         "GET",
         `/permittees/${encodeURIComponent(permitNumber)}`
       );
-      return { data: result.data.data, rateLimit: result.rateLimit };
+      return { data: result.data.data, quota: result.quota };
     } catch (error) {
       if (error instanceof NotFoundError) {
         throw new NotFoundError("Permittee", permitNumber);
@@ -546,7 +573,7 @@ var PermitteesResource = class {
       params,
       fetchPage: async (p) => {
         const result = await this.client.request("GET", "/permittees", p);
-        return { response: result.data, rateLimit: result.rateLimit };
+        return { response: result.data, quota: result.quota };
       }
     });
   }
@@ -572,14 +599,14 @@ var BarcodesResource = class {
     }
   }
   /**
-   * Look up barcode with rate limit information
+   * Look up barcode with quota information
    * @param barcodeValue The barcode to search for
-   * @returns Barcode lookup result with rate limit info
+   * @returns Barcode lookup result with quota info
    */
-  async lookupWithRateLimit(barcodeValue) {
+  async lookupWithQuota(barcodeValue) {
     try {
       const result = await this.client.request("GET", `/barcode/${encodeURIComponent(barcodeValue)}`);
-      return { data: result.data.data, rateLimit: result.rateLimit };
+      return { data: result.data.data, quota: result.quota };
     } catch (error) {
       if (error instanceof NotFoundError) {
         throw new NotFoundError("Barcode", barcodeValue);
@@ -604,15 +631,95 @@ var UsageResource = class {
     return result.data.data;
   }
   /**
-   * Get usage statistics with rate limit information
-   * @returns Usage statistics with rate limit info
+   * Get usage statistics with quota information
+   * @returns Usage statistics with quota info
    */
-  async getWithRateLimit() {
+  async getWithQuota() {
     const result = await this.client.request(
       "GET",
       "/usage"
     );
-    return { data: result.data.data, rateLimit: result.rateLimit };
+    return { data: result.data.data, quota: result.quota };
+  }
+};
+var ProcessingTimesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get processing times overview
+   * @param params Optional filter parameters
+   * @returns Processing times data with total count
+   */
+  async list(params = {}) {
+    const result = await this.client.request("GET", "/processing-times", params);
+    return result.data;
+  }
+  /**
+   * Get formula processing times
+   * @param params Optional filter parameters
+   * @returns Formula processing times data with total count
+   */
+  async formula(params = {}) {
+    const result = await this.client.request("GET", "/processing-times/formula", params);
+    return result.data;
+  }
+  /**
+   * Get registration processing times
+   * @param params Optional filter parameters
+   * @returns Registration processing times data with total count
+   */
+  async registration(params = {}) {
+    const result = await this.client.request(
+      "GET",
+      "/processing-times/registration",
+      params
+    );
+    return result.data;
+  }
+};
+var ProductionReportsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List production reports with pagination
+   * @param params Filter and pagination parameters
+   * @returns Paginated production reports data
+   */
+  async list(params = {}) {
+    const result = await this.client.request("GET", "/production-reports", params);
+    return result.data;
+  }
+};
+var AvasResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List and search AVAs
+   * @param params Optional filter parameters
+   * @returns AVA data with total count
+   */
+  async list(params = {}) {
+    const result = await this.client.request("GET", "/avas", params);
+    return result.data;
+  }
+  /**
+   * Get a single AVA by ID
+   * @param avaId The unique AVA identifier
+   * @returns Full AVA details
+   */
+  async get(avaId) {
+    try {
+      const result = await this.client.request("GET", `/avas/${encodeURIComponent(avaId)}`);
+      return result.data.data;
+    } catch (error) {
+      if (error instanceof NotFoundError) {
+        throw new NotFoundError("AVA", avaId);
+      }
+      throw error;
+    }
   }
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "colacloud",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Official JavaScript/TypeScript SDK for the COLA Cloud API - access the TTB COLA Registry of alcohol product label approvals",
   "main": "dist/index.js",
   "module": "dist/index.mjs",