colacloud 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -78,14 +78,30 @@ 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;
-    /** Date the COLA was approved */
+    /** 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 */
@@ -95,58 +111,122 @@ interface ColaSummary {
  * Image associated with a COLA
  */
 interface ColaImage {
-    /** Unique identifier for this image */
-    image_id: string;
-    /** URL to the image */
-    url: string;
-    /** Type of image (e.g., "front", "back") */
-    image_type: string | null;
+    /** Unique TTB image identifier */
+    ttb_image_id: string;
+    /** Position of image within the COLA's image set (0-indexed) */
+    image_index: number;
+    /** Position on the container (e.g., "FRONT", "BACK", "NECK", "STRIP") */
+    container_position: string | null;
+    /** File extension (e.g., "jpg", "png") */
+    extension_type: string | null;
     /** Image width in pixels */
-    width: number | null;
+    width_pixels: number | null;
     /** Image height in pixels */
-    height: number | null;
+    height_pixels: number | null;
+    /** Physical label width in inches */
+    width_inches: number | null;
+    /** Physical label height in inches */
+    height_inches: number | null;
+    /** File size in megabytes */
+    file_size_mb: number | null;
+    /** Number of barcodes detected in this image */
+    barcode_count: number;
+    /** Number of QR codes detected in this image */
+    qrcode_count: number;
+    /** Signed URL to the image (when available) */
+    image_url?: string;
 }
 /**
  * Barcode found on a COLA label
  */
 interface ColaBarcode {
-    /** The barcode value/number */
-    barcode_value: string;
     /** Type of barcode (e.g., "UPC-A", "EAN-13") */
     barcode_type: string | null;
+    /** The barcode value/number */
+    barcode_value: string;
+    /** TTB image ID where this barcode was found */
+    ttb_image_id: string;
+    /** Barcode width in pixels */
+    width_pixels: number | null;
+    /** Barcode height in pixels */
+    height_pixels: number | null;
+    /** Barcode orientation (e.g., "horizontal", "vertical") */
+    orientation: string | null;
+    /** Position of the barcode relative to the image */
+    relative_image_position: string | null;
 }
 /**
  * Full details for a COLA including images and barcodes
  */
 interface ColaDetail extends ColaSummary {
-    /** Images associated with this COLA */
+    /** Product class ID */
+    class_id: string | null;
+    /** Origin ID */
+    origin_id: string | null;
+    /** Date of the most recent update (ISO date string) */
+    latest_update_date: string | null;
+    /** Whether the container has a distinctive shape */
+    is_distinctive_container: boolean | null;
+    /** Distinctive container capacity */
+    for_distinctive_capacity: string | null;
+    /** Whether this is a resubmission */
+    is_resubmission: boolean | null;
+    /** TTB ID of the original submission if this is a resubmission */
+    for_resubmission_ttb_id: string | null;
+    /** State exemption, if applicable */
+    for_exemption_state: string | null;
+    /** Applicant address recipient */
+    address_recipient: string | null;
+    /** Applicant ZIP code */
+    address_zip_code: string | null;
+    /** Applicant state */
+    address_state: string | null;
+    /** Grape varietals (wine) */
+    grape_varietals: string | null;
+    /** Vintage year (wine) */
+    wine_vintage_year: number | null;
+    /** Appellation (wine) */
+    wine_appellation: string | null;
+    /** LLM-extracted container type */
+    llm_container_type: string | null;
+    /** LLM-extracted product description */
+    llm_product_description: string | null;
+    /** LLM-extracted brand established year */
+    llm_brand_established_year: number | null;
+    /** LLM-extracted tasting note flavors */
+    llm_tasting_note_flavors: string | null;
+    /** LLM-extracted artwork credit */
+    llm_artwork_credit: string | null;
+    /** LLM-extracted wine designation */
+    llm_wine_designation: string | null;
+    /** LLM-extracted International Bitterness Units (beer) */
+    llm_beer_ibu: number | null;
+    /** LLM-extracted hop varieties (beer) */
+    llm_beer_hops_varieties: string | null;
+    /** LLM-extracted aged years (liquor) */
+    llm_liquor_aged_years: number | null;
+    /** LLM-extracted finishing process (liquor) */
+    llm_liquor_finishing_process: string | null;
+    /** LLM-extracted grains used (liquor) */
+    llm_liquor_grains: string | null;
+    /** Primary barcode type on this COLA */
+    barcode_type: string | null;
+    /** Primary barcode value on this COLA */
+    barcode_value: string | null;
+    /** QR code URL if present */
+    qrcode_url: string | null;
+    /** Whether a front label image exists */
+    has_front_image: boolean;
+    /** Whether a back label image exists */
+    has_back_image: boolean;
+    /** Whether a neck label image exists */
+    has_neck_image: boolean;
+    /** Whether a strip label image exists */
+    has_strip_image: boolean;
+    /** All images associated with this COLA */
     images: ColaImage[];
-    /** Barcodes found on the label */
+    /** All barcodes found on this COLA's images */
     barcodes: ColaBarcode[];
-    /** LLM-extracted description */
-    llm_description: string | null;
-    /** LLM-extracted ingredients */
-    llm_ingredients: string | null;
-    /** LLM-extracted tasting notes */
-    llm_tasting_notes: string | null;
-    /** LLM-extracted producer/brand information */
-    llm_producer: string | null;
-    /** Vintage year for wines */
-    vintage: number | null;
-    /** Grape varietal(s) */
-    varietal: string | null;
-    /** Wine appellation */
-    appellation: string | null;
-    /** Beer style */
-    beer_style: string | null;
-    /** International Bitterness Units */
-    ibu: number | null;
-    /** Status of the COLA */
-    status: string | null;
-    /** Date the COLA was submitted */
-    submitted_date: string | null;
-    /** Serial number */
-    serial_number: string | null;
 }
 /**
  * Query parameters for searching/listing COLAs
@@ -183,14 +263,20 @@ interface PermitteeSummary {
     company_name: string | null;
     /** State where the company is located */
     company_state: string | null;
+    /** Company ZIP code */
+    company_zip_code: string | null;
     /** Type of permit */
     permittee_type: string | null;
     /** Whether the permit is currently active */
     is_active: boolean;
+    /** Reason for active/inactive status */
+    active_reason: string | null;
     /** Total number of COLAs */
     colas: number;
     /** Number of approved COLAs */
     colas_approved: number;
+    /** Date of most recent COLA application (ISO date string) */
+    last_cola_application_date: string | null;
 }
 /**
  * Full details for a permittee including recent COLAs

package/dist/index.d.ts

@@ -78,14 +78,30 @@ 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;
-    /** Date the COLA was approved */
+    /** 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 */
@@ -95,58 +111,122 @@ interface ColaSummary {
  * Image associated with a COLA
  */
 interface ColaImage {
-    /** Unique identifier for this image */
-    image_id: string;
-    /** URL to the image */
-    url: string;
-    /** Type of image (e.g., "front", "back") */
-    image_type: string | null;
+    /** Unique TTB image identifier */
+    ttb_image_id: string;
+    /** Position of image within the COLA's image set (0-indexed) */
+    image_index: number;
+    /** Position on the container (e.g., "FRONT", "BACK", "NECK", "STRIP") */
+    container_position: string | null;
+    /** File extension (e.g., "jpg", "png") */
+    extension_type: string | null;
     /** Image width in pixels */
-    width: number | null;
+    width_pixels: number | null;
     /** Image height in pixels */
-    height: number | null;
+    height_pixels: number | null;
+    /** Physical label width in inches */
+    width_inches: number | null;
+    /** Physical label height in inches */
+    height_inches: number | null;
+    /** File size in megabytes */
+    file_size_mb: number | null;
+    /** Number of barcodes detected in this image */
+    barcode_count: number;
+    /** Number of QR codes detected in this image */
+    qrcode_count: number;
+    /** Signed URL to the image (when available) */
+    image_url?: string;
 }
 /**
  * Barcode found on a COLA label
  */
 interface ColaBarcode {
-    /** The barcode value/number */
-    barcode_value: string;
     /** Type of barcode (e.g., "UPC-A", "EAN-13") */
     barcode_type: string | null;
+    /** The barcode value/number */
+    barcode_value: string;
+    /** TTB image ID where this barcode was found */
+    ttb_image_id: string;
+    /** Barcode width in pixels */
+    width_pixels: number | null;
+    /** Barcode height in pixels */
+    height_pixels: number | null;
+    /** Barcode orientation (e.g., "horizontal", "vertical") */
+    orientation: string | null;
+    /** Position of the barcode relative to the image */
+    relative_image_position: string | null;
 }
 /**
  * Full details for a COLA including images and barcodes
  */
 interface ColaDetail extends ColaSummary {
-    /** Images associated with this COLA */
+    /** Product class ID */
+    class_id: string | null;
+    /** Origin ID */
+    origin_id: string | null;
+    /** Date of the most recent update (ISO date string) */
+    latest_update_date: string | null;
+    /** Whether the container has a distinctive shape */
+    is_distinctive_container: boolean | null;
+    /** Distinctive container capacity */
+    for_distinctive_capacity: string | null;
+    /** Whether this is a resubmission */
+    is_resubmission: boolean | null;
+    /** TTB ID of the original submission if this is a resubmission */
+    for_resubmission_ttb_id: string | null;
+    /** State exemption, if applicable */
+    for_exemption_state: string | null;
+    /** Applicant address recipient */
+    address_recipient: string | null;
+    /** Applicant ZIP code */
+    address_zip_code: string | null;
+    /** Applicant state */
+    address_state: string | null;
+    /** Grape varietals (wine) */
+    grape_varietals: string | null;
+    /** Vintage year (wine) */
+    wine_vintage_year: number | null;
+    /** Appellation (wine) */
+    wine_appellation: string | null;
+    /** LLM-extracted container type */
+    llm_container_type: string | null;
+    /** LLM-extracted product description */
+    llm_product_description: string | null;
+    /** LLM-extracted brand established year */
+    llm_brand_established_year: number | null;
+    /** LLM-extracted tasting note flavors */
+    llm_tasting_note_flavors: string | null;
+    /** LLM-extracted artwork credit */
+    llm_artwork_credit: string | null;
+    /** LLM-extracted wine designation */
+    llm_wine_designation: string | null;
+    /** LLM-extracted International Bitterness Units (beer) */
+    llm_beer_ibu: number | null;
+    /** LLM-extracted hop varieties (beer) */
+    llm_beer_hops_varieties: string | null;
+    /** LLM-extracted aged years (liquor) */
+    llm_liquor_aged_years: number | null;
+    /** LLM-extracted finishing process (liquor) */
+    llm_liquor_finishing_process: string | null;
+    /** LLM-extracted grains used (liquor) */
+    llm_liquor_grains: string | null;
+    /** Primary barcode type on this COLA */
+    barcode_type: string | null;
+    /** Primary barcode value on this COLA */
+    barcode_value: string | null;
+    /** QR code URL if present */
+    qrcode_url: string | null;
+    /** Whether a front label image exists */
+    has_front_image: boolean;
+    /** Whether a back label image exists */
+    has_back_image: boolean;
+    /** Whether a neck label image exists */
+    has_neck_image: boolean;
+    /** Whether a strip label image exists */
+    has_strip_image: boolean;
+    /** All images associated with this COLA */
     images: ColaImage[];
-    /** Barcodes found on the label */
+    /** All barcodes found on this COLA's images */
     barcodes: ColaBarcode[];
-    /** LLM-extracted description */
-    llm_description: string | null;
-    /** LLM-extracted ingredients */
-    llm_ingredients: string | null;
-    /** LLM-extracted tasting notes */
-    llm_tasting_notes: string | null;
-    /** LLM-extracted producer/brand information */
-    llm_producer: string | null;
-    /** Vintage year for wines */
-    vintage: number | null;
-    /** Grape varietal(s) */
-    varietal: string | null;
-    /** Wine appellation */
-    appellation: string | null;
-    /** Beer style */
-    beer_style: string | null;
-    /** International Bitterness Units */
-    ibu: number | null;
-    /** Status of the COLA */
-    status: string | null;
-    /** Date the COLA was submitted */
-    submitted_date: string | null;
-    /** Serial number */
-    serial_number: string | null;
 }
 /**
  * Query parameters for searching/listing COLAs
@@ -183,14 +263,20 @@ interface PermitteeSummary {
     company_name: string | null;
     /** State where the company is located */
     company_state: string | null;
+    /** Company ZIP code */
+    company_zip_code: string | null;
     /** Type of permit */
     permittee_type: string | null;
     /** Whether the permit is currently active */
     is_active: boolean;
+    /** Reason for active/inactive status */
+    active_reason: string | null;
     /** Total number of COLAs */
     colas: number;
     /** Number of approved COLAs */
     colas_approved: number;
+    /** Date of most recent COLA application (ISO date string) */
+    last_cola_application_date: string | null;
 }
 /**
  * Full details for a permittee including recent COLAs

package/package.json

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