colacloud 1.1.0 → 1.2.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

@@ -78,34 +78,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 +293,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;
 }
 /**

package/dist/index.d.ts

@@ -78,34 +78,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 +293,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;
 }
 /**

package/package.json

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