colacloud 1.1.0 → 1.3.0

package/README.md

@@ -165,9 +165,10 @@ for (const cola of result.colas) {
 const usage = await client.usage.get();
 
 console.log(`Tier: ${usage.tier}`);
-console.log(`Used: ${usage.requests_used} / ${usage.monthly_limit}`);
-console.log(`Remaining: ${usage.requests_remaining}`);
-console.log(`Rate limit: ${usage.per_minute_limit} req/min`);
+console.log(`Period: ${usage.current_period}`);
+console.log(`Detail views: ${usage.detail_views.used} / ${usage.detail_views.limit}`);
+console.log(`List records: ${usage.list_records.used} / ${usage.list_records.limit}`);
+console.log(`Burst limit: ${usage.per_minute_limit} req/min`);
 ```
 
 ### Rate Limit Information

package/dist/index.d.mts

@@ -20,10 +20,14 @@ interface Pagination {
     page: number;
     /** Number of items per page */
     per_page: number;
-    /** Total number of items across all pages */
-    total: number;
-    /** Total number of pages */
-    pages: number;
+    /** Total number of items across all pages (null when using offset pagination without count) */
+    total: number | null;
+    /** Total number of pages (null when using offset pagination without count) */
+    pages: number | null;
+    /** Whether there are more results available */
+    has_more?: boolean;
+    /** Pagination mode: "cursor" or "offset" */
+    mode?: string;
 }
 /**
  * Response wrapper for paginated list endpoints
@@ -42,24 +46,26 @@ interface SingleResponse<T> {
     data: T;
 }
 /**
- * Rate limit information from response headers
+ * Quota information parsed from response headers
  */
-interface RateLimitInfo {
-    /** Maximum requests allowed per minute */
+interface QuotaInfo {
+    /** Which meter this quota applies to */
+    meter: 'detail_views' | 'list_records';
+    /** Quota limit for the current billing period */
     limit: number;
-    /** Remaining requests in the current window */
+    /** Remaining quota in the current billing period */
     remaining: number;
-    /** Unix timestamp when the rate limit resets */
+    /** Unix timestamp when quotas reset (first of next month) */
     reset: number;
 }
 /**
- * Extended response that includes rate limit information
+ * Extended response that includes quota information
  */
-interface ResponseWithRateLimit<T> {
+interface ResponseWithQuota<T> {
     /** The response data */
     data: T;
-    /** Rate limit information from headers */
-    rateLimit: RateLimitInfo | null;
+    /** Quota information from headers */
+    quota: QuotaInfo | null;
 }
 /**
  * Summary information about a COLA (Certificate of Label Approval)
@@ -78,34 +84,14 @@ interface ColaSummary {
     class_name: string | null;
     /** Origin/country of the product */
     origin_name: string | null;
-    /** "Domestic" or "Imported" */
-    domestic_or_imported: string | null;
     /** Permit number of the applicant */
     permit_number: string | null;
-    /** Type of application (e.g., "CERTIFICATE OF LABEL APPROVAL") */
-    application_type: string | null;
-    /** Status of the application (e.g., "APPROVED") */
-    application_status: string | null;
-    /** Date the application was submitted (ISO date string) */
-    application_date: string | null;
     /** Date the COLA was approved (ISO date string) */
     approval_date: string | null;
-    /** Date the COLA expires (ISO date string) */
-    expiration_date: string | null;
-    /** Alcohol by volume percentage */
-    abv: number | null;
-    /** Container volume */
-    volume: string | null;
-    /** Volume unit (e.g., "ml", "L") */
-    volume_unit: string | null;
-    /** LLM-assigned category (e.g., "Bourbon") */
-    llm_category: string | null;
-    /** LLM-assigned category path (e.g., "Spirits > Whiskey > Bourbon") */
-    llm_category_path: string | null;
     /** Number of images associated with this COLA */
     image_count: number;
-    /** URL to the main/primary image */
-    main_image_url: string | null;
+    /** Whether any barcode was extracted from label images */
+    has_barcode: boolean;
 }
 /**
  * Image associated with a COLA
@@ -313,21 +299,33 @@ interface BarcodeLookupResult {
     /** Total number of COLAs with this barcode */
     total_colas: number;
 }
+/**
+ * API usage statistics for the current account
+ */
+/**
+ * Usage quota for a single meter (detail views or list records)
+ */
+interface UsageQuota {
+    /** Number used this period */
+    used: number;
+    /** Maximum allowed this period */
+    limit: number;
+    /** Remaining this period */
+    remaining: number;
+}
 /**
  * API usage statistics for the current account
  */
 interface UsageStats {
-    /** Account tier (e.g., "free", "pro", "enterprise") */
+    /** Account tier (e.g., "free", "starter", "pro") */
     tier: string;
-    /** Monthly request limit */
-    monthly_limit: number;
-    /** Current billing period (ISO date string) */
+    /** Current billing period (YYYY-MM) */
     current_period: string;
-    /** Number of requests used this period */
-    requests_used: number;
-    /** Number of requests remaining this period */
-    requests_remaining: number;
-    /** Per-minute rate limit */
+    /** Detail view usage and limits */
+    detail_views: UsageQuota;
+    /** List record usage and limits */
+    list_records: UsageQuota;
+    /** Per-minute burst limit */
     per_minute_limit: number;
 }
 /**
@@ -390,7 +388,7 @@ declare class ColaCloud {
      * Make an authenticated request to the API
      * @internal
      */
-    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, params?: Record<string, unknown>): Promise<ResponseWithRateLimit<T>>;
+    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, params?: Record<string, unknown>): Promise<ResponseWithQuota<T>>;
     /**
      * Handle error responses from the API
      */
@@ -409,11 +407,11 @@ declare class ColasResource {
      */
     list(params?: ColaListParams): Promise<PaginatedResponse<ColaSummary>>;
     /**
-     * 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
      */
-    listWithRateLimit(params?: ColaListParams): Promise<ResponseWithRateLimit<PaginatedResponse<ColaSummary>>>;
+    listWithQuota(params?: ColaListParams): Promise<ResponseWithQuota<PaginatedResponse<ColaSummary>>>;
     /**
      * Get a single COLA by TTB ID
      * @param ttbId The unique TTB identifier
@@ -421,11 +419,11 @@ declare class ColasResource {
      */
     get(ttbId: string): Promise<ColaDetail>;
     /**
-     * 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
      */
-    getWithRateLimit(ttbId: string): Promise<ResponseWithRateLimit<ColaDetail>>;
+    getWithQuota(ttbId: string): Promise<ResponseWithQuota<ColaDetail>>;
     /**
      * Create an async iterator that automatically pages through all results
      * @param params Search and filter parameters (page is ignored)
@@ -453,11 +451,11 @@ declare class PermitteesResource {
      */
     list(params?: PermitteeListParams): Promise<PaginatedResponse<PermitteeSummary>>;
     /**
-     * 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
      */
-    listWithRateLimit(params?: PermitteeListParams): Promise<ResponseWithRateLimit<PaginatedResponse<PermitteeSummary>>>;
+    listWithQuota(params?: PermitteeListParams): Promise<ResponseWithQuota<PaginatedResponse<PermitteeSummary>>>;
     /**
      * Get a single permittee by permit number
      * @param permitNumber The unique permit number
@@ -465,11 +463,11 @@ declare class PermitteesResource {
      */
     get(permitNumber: string): Promise<PermitteeDetail>;
     /**
-     * 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
      */
-    getWithRateLimit(permitNumber: string): Promise<ResponseWithRateLimit<PermitteeDetail>>;
+    getWithQuota(permitNumber: string): Promise<ResponseWithQuota<PermitteeDetail>>;
     /**
      * Create an async iterator that automatically pages through all results
      * @param params Search and filter parameters (page is ignored)
@@ -497,11 +495,11 @@ declare class BarcodesResource {
      */
     lookup(barcodeValue: string): Promise<BarcodeLookupResult>;
     /**
-     * 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
      */
-    lookupWithRateLimit(barcodeValue: string): Promise<ResponseWithRateLimit<BarcodeLookupResult>>;
+    lookupWithQuota(barcodeValue: string): Promise<ResponseWithQuota<BarcodeLookupResult>>;
 }
 /**
  * Usage statistics resource handler
@@ -515,10 +513,10 @@ declare class UsageResource {
      */
     get(): Promise<UsageStats>;
     /**
-     * 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
      */
-    getWithRateLimit(): Promise<ResponseWithRateLimit<UsageStats>>;
+    getWithQuota(): Promise<ResponseWithQuota<UsageStats>>;
 }
 
 /**
@@ -551,11 +549,11 @@ declare class AuthenticationError extends ColaCloudError {
  * Error thrown when rate limit is exceeded (429 Too Many Requests)
  */
 declare class RateLimitError extends ColaCloudError {
-    /** Rate limit information from headers */
-    readonly rateLimit: RateLimitInfo | null;
+    /** Quota information from headers */
+    readonly quota: QuotaInfo | null;
     /** Seconds until the rate limit resets */
     readonly retryAfter: number | null;
-    constructor(message?: string, rateLimit?: RateLimitInfo | null, retryAfter?: number | null);
+    constructor(message?: string, quota?: QuotaInfo | null, retryAfter?: number | null);
 }
 /**
  * Error thrown when a requested resource is not found (404 Not Found)
@@ -613,7 +611,7 @@ interface PaginatedIteratorOptions<TParams> {
         page: number;
     }) => Promise<{
         response: PaginatedResponse<unknown>;
-        rateLimit: RateLimitInfo | null;
+        quota: QuotaInfo | null;
     }>;
     /** Starting page number (defaults to 1) */
     startPage?: number;
@@ -632,8 +630,8 @@ interface PaginatedIteratorResult<T> {
     indexInPage: number;
     /** Total items across all pages */
     total: number;
-    /** Rate limit info from the last request */
-    rateLimit: RateLimitInfo | null;
+    /** Quota info from the last request */
+    quota: QuotaInfo | null;
 }
 /**
  * Creates an async iterator that automatically handles pagination
@@ -663,4 +661,4 @@ declare function collectAll<T>(iterator: AsyncIterable<T>, maxItems?: number): P
  */
 declare function take<T>(iterator: AsyncIterable<T>, count: number): Promise<T[]>;
 
-export { type ApiErrorResponse, AuthenticationError, type BarcodeLookupResult, type ColaBarcode, ColaCloud, type ColaCloudConfig, ColaCloudError, type ColaDetail, type ColaImage, type ColaListParams, type ColaSummary, NetworkError, NotFoundError, type PaginatedIteratorOptions, type PaginatedIteratorResult, type PaginatedResponse, type Pagination, type PermitteeDetail, type PermitteeListParams, type PermitteeSummary, RateLimitError, type RateLimitInfo, type ResponseWithRateLimit, ServerError, type SingleResponse, TimeoutError, type UsageStats, ValidationError, collectAll, createPaginatedIterator, createPaginatedIteratorWithMetadata, take };
+export { type ApiErrorResponse, AuthenticationError, type BarcodeLookupResult, type ColaBarcode, ColaCloud, type ColaCloudConfig, ColaCloudError, type ColaDetail, type ColaImage, type ColaListParams, type ColaSummary, NetworkError, NotFoundError, type PaginatedIteratorOptions, type PaginatedIteratorResult, type PaginatedResponse, type Pagination, type PermitteeDetail, type PermitteeListParams, type PermitteeSummary, type QuotaInfo, RateLimitError, type ResponseWithQuota, ServerError, type SingleResponse, TimeoutError, type UsageStats, ValidationError, collectAll, createPaginatedIterator, createPaginatedIteratorWithMetadata, take };

package/dist/index.d.ts

@@ -20,10 +20,14 @@ interface Pagination {
     page: number;
     /** Number of items per page */
     per_page: number;
-    /** Total number of items across all pages */
-    total: number;
-    /** Total number of pages */
-    pages: number;
+    /** Total number of items across all pages (null when using offset pagination without count) */
+    total: number | null;
+    /** Total number of pages (null when using offset pagination without count) */
+    pages: number | null;
+    /** Whether there are more results available */
+    has_more?: boolean;
+    /** Pagination mode: "cursor" or "offset" */
+    mode?: string;
 }
 /**
  * Response wrapper for paginated list endpoints
@@ -42,24 +46,26 @@ interface SingleResponse<T> {
     data: T;
 }
 /**
- * Rate limit information from response headers
+ * Quota information parsed from response headers
  */
-interface RateLimitInfo {
-    /** Maximum requests allowed per minute */
+interface QuotaInfo {
+    /** Which meter this quota applies to */
+    meter: 'detail_views' | 'list_records';
+    /** Quota limit for the current billing period */
     limit: number;
-    /** Remaining requests in the current window */
+    /** Remaining quota in the current billing period */
     remaining: number;
-    /** Unix timestamp when the rate limit resets */
+    /** Unix timestamp when quotas reset (first of next month) */
     reset: number;
 }
 /**
- * Extended response that includes rate limit information
+ * Extended response that includes quota information
  */
-interface ResponseWithRateLimit<T> {
+interface ResponseWithQuota<T> {
     /** The response data */
     data: T;
-    /** Rate limit information from headers */
-    rateLimit: RateLimitInfo | null;
+    /** Quota information from headers */
+    quota: QuotaInfo | null;
 }
 /**
  * Summary information about a COLA (Certificate of Label Approval)
@@ -78,34 +84,14 @@ interface ColaSummary {
     class_name: string | null;
     /** Origin/country of the product */
     origin_name: string | null;
-    /** "Domestic" or "Imported" */
-    domestic_or_imported: string | null;
     /** Permit number of the applicant */
     permit_number: string | null;
-    /** Type of application (e.g., "CERTIFICATE OF LABEL APPROVAL") */
-    application_type: string | null;
-    /** Status of the application (e.g., "APPROVED") */
-    application_status: string | null;
-    /** Date the application was submitted (ISO date string) */
-    application_date: string | null;
     /** Date the COLA was approved (ISO date string) */
     approval_date: string | null;
-    /** Date the COLA expires (ISO date string) */
-    expiration_date: string | null;
-    /** Alcohol by volume percentage */
-    abv: number | null;
-    /** Container volume */
-    volume: string | null;
-    /** Volume unit (e.g., "ml", "L") */
-    volume_unit: string | null;
-    /** LLM-assigned category (e.g., "Bourbon") */
-    llm_category: string | null;
-    /** LLM-assigned category path (e.g., "Spirits > Whiskey > Bourbon") */
-    llm_category_path: string | null;
     /** Number of images associated with this COLA */
     image_count: number;
-    /** URL to the main/primary image */
-    main_image_url: string | null;
+    /** Whether any barcode was extracted from label images */
+    has_barcode: boolean;
 }
 /**
  * Image associated with a COLA
@@ -313,21 +299,33 @@ interface BarcodeLookupResult {
     /** Total number of COLAs with this barcode */
     total_colas: number;
 }
+/**
+ * API usage statistics for the current account
+ */
+/**
+ * Usage quota for a single meter (detail views or list records)
+ */
+interface UsageQuota {
+    /** Number used this period */
+    used: number;
+    /** Maximum allowed this period */
+    limit: number;
+    /** Remaining this period */
+    remaining: number;
+}
 /**
  * API usage statistics for the current account
  */
 interface UsageStats {
-    /** Account tier (e.g., "free", "pro", "enterprise") */
+    /** Account tier (e.g., "free", "starter", "pro") */
     tier: string;
-    /** Monthly request limit */
-    monthly_limit: number;
-    /** Current billing period (ISO date string) */
+    /** Current billing period (YYYY-MM) */
     current_period: string;
-    /** Number of requests used this period */
-    requests_used: number;
-    /** Number of requests remaining this period */
-    requests_remaining: number;
-    /** Per-minute rate limit */
+    /** Detail view usage and limits */
+    detail_views: UsageQuota;
+    /** List record usage and limits */
+    list_records: UsageQuota;
+    /** Per-minute burst limit */
     per_minute_limit: number;
 }
 /**
@@ -390,7 +388,7 @@ declare class ColaCloud {
      * Make an authenticated request to the API
      * @internal
      */
-    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, params?: Record<string, unknown>): Promise<ResponseWithRateLimit<T>>;
+    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, params?: Record<string, unknown>): Promise<ResponseWithQuota<T>>;
     /**
      * Handle error responses from the API
      */
@@ -409,11 +407,11 @@ declare class ColasResource {
      */
     list(params?: ColaListParams): Promise<PaginatedResponse<ColaSummary>>;
     /**
-     * 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
      */
-    listWithRateLimit(params?: ColaListParams): Promise<ResponseWithRateLimit<PaginatedResponse<ColaSummary>>>;
+    listWithQuota(params?: ColaListParams): Promise<ResponseWithQuota<PaginatedResponse<ColaSummary>>>;
     /**
      * Get a single COLA by TTB ID
      * @param ttbId The unique TTB identifier
@@ -421,11 +419,11 @@ declare class ColasResource {
      */
     get(ttbId: string): Promise<ColaDetail>;
     /**
-     * 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
      */
-    getWithRateLimit(ttbId: string): Promise<ResponseWithRateLimit<ColaDetail>>;
+    getWithQuota(ttbId: string): Promise<ResponseWithQuota<ColaDetail>>;
     /**
      * Create an async iterator that automatically pages through all results
      * @param params Search and filter parameters (page is ignored)
@@ -453,11 +451,11 @@ declare class PermitteesResource {
      */
     list(params?: PermitteeListParams): Promise<PaginatedResponse<PermitteeSummary>>;
     /**
-     * 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
      */
-    listWithRateLimit(params?: PermitteeListParams): Promise<ResponseWithRateLimit<PaginatedResponse<PermitteeSummary>>>;
+    listWithQuota(params?: PermitteeListParams): Promise<ResponseWithQuota<PaginatedResponse<PermitteeSummary>>>;
     /**
      * Get a single permittee by permit number
      * @param permitNumber The unique permit number
@@ -465,11 +463,11 @@ declare class PermitteesResource {
      */
     get(permitNumber: string): Promise<PermitteeDetail>;
     /**
-     * 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
      */
-    getWithRateLimit(permitNumber: string): Promise<ResponseWithRateLimit<PermitteeDetail>>;
+    getWithQuota(permitNumber: string): Promise<ResponseWithQuota<PermitteeDetail>>;
     /**
      * Create an async iterator that automatically pages through all results
      * @param params Search and filter parameters (page is ignored)
@@ -497,11 +495,11 @@ declare class BarcodesResource {
      */
     lookup(barcodeValue: string): Promise<BarcodeLookupResult>;
     /**
-     * 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
      */
-    lookupWithRateLimit(barcodeValue: string): Promise<ResponseWithRateLimit<BarcodeLookupResult>>;
+    lookupWithQuota(barcodeValue: string): Promise<ResponseWithQuota<BarcodeLookupResult>>;
 }
 /**
  * Usage statistics resource handler
@@ -515,10 +513,10 @@ declare class UsageResource {
      */
     get(): Promise<UsageStats>;
     /**
-     * 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
      */
-    getWithRateLimit(): Promise<ResponseWithRateLimit<UsageStats>>;
+    getWithQuota(): Promise<ResponseWithQuota<UsageStats>>;
 }
 
 /**
@@ -551,11 +549,11 @@ declare class AuthenticationError extends ColaCloudError {
  * Error thrown when rate limit is exceeded (429 Too Many Requests)
  */
 declare class RateLimitError extends ColaCloudError {
-    /** Rate limit information from headers */
-    readonly rateLimit: RateLimitInfo | null;
+    /** Quota information from headers */
+    readonly quota: QuotaInfo | null;
     /** Seconds until the rate limit resets */
     readonly retryAfter: number | null;
-    constructor(message?: string, rateLimit?: RateLimitInfo | null, retryAfter?: number | null);
+    constructor(message?: string, quota?: QuotaInfo | null, retryAfter?: number | null);
 }
 /**
  * Error thrown when a requested resource is not found (404 Not Found)
@@ -613,7 +611,7 @@ interface PaginatedIteratorOptions<TParams> {
         page: number;
     }) => Promise<{
         response: PaginatedResponse<unknown>;
-        rateLimit: RateLimitInfo | null;
+        quota: QuotaInfo | null;
     }>;
     /** Starting page number (defaults to 1) */
     startPage?: number;
@@ -632,8 +630,8 @@ interface PaginatedIteratorResult<T> {
     indexInPage: number;
     /** Total items across all pages */
     total: number;
-    /** Rate limit info from the last request */
-    rateLimit: RateLimitInfo | null;
+    /** Quota info from the last request */
+    quota: QuotaInfo | null;
 }
 /**
  * Creates an async iterator that automatically handles pagination
@@ -663,4 +661,4 @@ declare function collectAll<T>(iterator: AsyncIterable<T>, maxItems?: number): P
  */
 declare function take<T>(iterator: AsyncIterable<T>, count: number): Promise<T[]>;
 
-export { type ApiErrorResponse, AuthenticationError, type BarcodeLookupResult, type ColaBarcode, ColaCloud, type ColaCloudConfig, ColaCloudError, type ColaDetail, type ColaImage, type ColaListParams, type ColaSummary, NetworkError, NotFoundError, type PaginatedIteratorOptions, type PaginatedIteratorResult, type PaginatedResponse, type Pagination, type PermitteeDetail, type PermitteeListParams, type PermitteeSummary, RateLimitError, type RateLimitInfo, type ResponseWithRateLimit, ServerError, type SingleResponse, TimeoutError, type UsageStats, ValidationError, collectAll, createPaginatedIterator, createPaginatedIteratorWithMetadata, take };
+export { type ApiErrorResponse, AuthenticationError, type BarcodeLookupResult, type ColaBarcode, ColaCloud, type ColaCloudConfig, ColaCloudError, type ColaDetail, type ColaImage, type ColaListParams, type ColaSummary, NetworkError, NotFoundError, type PaginatedIteratorOptions, type PaginatedIteratorResult, type PaginatedResponse, type Pagination, type PermitteeDetail, type PermitteeListParams, type PermitteeSummary, type QuotaInfo, RateLimitError, type ResponseWithQuota, ServerError, type SingleResponse, TimeoutError, type UsageStats, ValidationError, collectAll, createPaginatedIterator, createPaginatedIteratorWithMetadata, take };

package/dist/index.js

@@ -76,14 +76,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);
@@ -169,9 +169,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,
@@ -209,7 +215,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 {
@@ -219,16 +225,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++;
@@ -249,7 +261,7 @@ function createPaginatedIteratorWithMetadata(options) {
               // We already incremented after fetch
               indexInPage: currentIndex,
               total: pagination?.total ?? 0,
-              rateLimit
+              quota
             };
             currentIndex++;
             return { done: false, value: result };
@@ -286,14 +298,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)
@@ -350,12 +368,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") {
@@ -373,7 +391,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();
@@ -390,7 +408,7 @@ var ColaCloud = class {
         const retryAfter = response.headers.get("Retry-After");
         throw new RateLimitError(
           message,
-          rateLimit,
+          quota,
           retryAfter ? parseInt(retryAfter, 10) : null
         );
       }
@@ -425,11 +443,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",
@@ -456,17 +474,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);
@@ -495,7 +513,7 @@ var ColasResource = class {
           "/colas",
           p
         );
-        return { response: result.data, rateLimit: result.rateLimit };
+        return { response: result.data, quota: result.quota };
       }
     });
   }
@@ -518,11 +536,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",
@@ -549,17 +567,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);
@@ -584,7 +602,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 };
       }
     });
   }
@@ -610,14 +628,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);
@@ -642,15 +660,15 @@ 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 };
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

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)
@@ -312,12 +330,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 +353,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 +370,7 @@ var ColaCloud = class {
         const retryAfter = response.headers.get("Retry-After");
         throw new RateLimitError(
           message,
-          rateLimit,
+          quota,
           retryAfter ? parseInt(retryAfter, 10) : null
         );
       }
@@ -387,11 +405,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 +436,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 +475,7 @@ var ColasResource = class {
           "/colas",
           p
         );
-        return { response: result.data, rateLimit: result.rateLimit };
+        return { response: result.data, quota: result.quota };
       }
     });
   }
@@ -480,11 +498,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 +529,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 +564,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 +590,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 +622,15 @@ 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 };
   }
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "colacloud",
-  "version": "1.1.0",
+  "version": "1.3.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",