colacloud 1.3.0 → 1.4.1

package/README.md

@@ -336,6 +336,6 @@ MIT
 
 ## Support
 
-- Documentation: https://colacloud.us/docs/api
+- Documentation: https://docs.colacloud.us/api-reference
 - Issues: https://github.com/cola-cloud-us/colacloud-js/issues
 - Email: support@colacloud.us

package/dist/index.d.mts

@@ -257,12 +257,12 @@ interface PermitteeSummary {
     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;
+    /** Total number of COLAs. Paid plans only (starter/pro). */
+    colas?: number;
+    /** Number of approved COLAs. Paid plans only (starter/pro). */
+    colas_approved?: number;
+    /** Date of most recent COLA application (ISO date string). Paid plans only (starter/pro). */
+    last_cola_application_date?: string | null;
 }
 /**
  * Full details for a permittee including recent COLAs
@@ -328,6 +328,140 @@ interface UsageStats {
     /** Per-minute burst limit */
     per_minute_limit: number;
 }
+/**
+ * Metadata for reference data list responses
+ */
+interface ReferenceListMeta {
+    /** Total number of items */
+    total: number;
+}
+/**
+ * Metadata for paginated reference data responses
+ */
+interface ReferenceListPaginatedMeta {
+    /** Total number of items */
+    total: number;
+    /** Current page number */
+    page: number;
+    /** Items per page */
+    per_page: number;
+    /** Whether there are more results */
+    has_more: boolean;
+}
+/**
+ * Response wrapper for reference data list endpoints
+ */
+interface ReferenceListResponse<T> {
+    /** Array of items */
+    data: T[];
+    /** Response metadata */
+    meta: ReferenceListMeta;
+}
+/**
+ * Response wrapper for paginated reference data list endpoints
+ */
+interface ReferencePaginatedResponse<T> {
+    /** Array of items */
+    data: T[];
+    /** Response metadata with pagination */
+    meta: ReferenceListPaginatedMeta;
+}
+/**
+ * Response wrapper for single reference data endpoints
+ */
+interface ReferenceSingleResponse<T> {
+    /** The requested item */
+    data: T;
+}
+/**
+ * Query parameters for processing times overview
+ */
+interface ProcessingTimesParams {
+    /** Filter by commodity type */
+    commodity?: string;
+}
+/**
+ * Query parameters for formula processing times
+ */
+interface FormulaProcessingTimesParams {
+    /** Filter by formula type */
+    formulaType?: string;
+    /** Filter by commodity type */
+    commodity?: string;
+}
+/**
+ * Query parameters for registration processing times
+ */
+interface RegistrationProcessingTimesParams {
+    /** Filter by category */
+    category?: string;
+    /** Filter by application type */
+    applicationType?: string;
+}
+/**
+ * Query parameters for production reports
+ */
+interface ProductionReportsParams {
+    /** Filter by commodity type */
+    commodity?: string;
+    /** Filter by year */
+    year?: number;
+    /** Filter by month */
+    month?: number;
+    /** Filter by report type */
+    reportType?: string;
+    /** Filter by statistical group */
+    statisticalGroup?: string;
+    /** Page number (1-indexed, default 1) */
+    page?: number;
+    /** Items per page (default 100, max 100) */
+    perPage?: number;
+}
+/**
+ * Query parameters for AVA (American Viticultural Area) list
+ */
+interface AvaListParams {
+    /** Filter by state */
+    state?: string;
+    /** Search by name */
+    q?: string;
+}
+/**
+ * A processing time record
+ */
+interface ProcessingTime {
+    [key: string]: unknown;
+}
+/**
+ * A formula processing time record
+ */
+interface FormulaProcessingTime {
+    [key: string]: unknown;
+}
+/**
+ * A registration processing time record
+ */
+interface RegistrationProcessingTime {
+    [key: string]: unknown;
+}
+/**
+ * A production report record
+ */
+interface ProductionReport {
+    [key: string]: unknown;
+}
+/**
+ * An AVA (American Viticultural Area) summary record
+ */
+interface AvaSummary {
+    [key: string]: unknown;
+}
+/**
+ * Full AVA (American Viticultural Area) detail record
+ */
+interface AvaDetail {
+    [key: string]: unknown;
+}
 /**
  * Error response structure from the API
  */
@@ -379,6 +513,12 @@ declare class ColaCloud {
     readonly barcodes: BarcodesResource;
     /** Usage statistics endpoint */
     readonly usage: UsageResource;
+    /** Processing times reference data endpoints */
+    readonly processingTimes: ProcessingTimesResource;
+    /** Production reports reference data endpoints */
+    readonly productionReports: ProductionReportsResource;
+    /** AVA (American Viticultural Area) reference data endpoints */
+    readonly avas: AvasResource;
     /**
      * Create a new COLA Cloud API client
      * @param config Configuration options
@@ -518,6 +658,63 @@ declare class UsageResource {
      */
     getWithQuota(): Promise<ResponseWithQuota<UsageStats>>;
 }
+/**
+ * Processing times reference data resource handler
+ */
+declare class ProcessingTimesResource {
+    private readonly client;
+    constructor(client: ColaCloud);
+    /**
+     * Get processing times overview
+     * @param params Optional filter parameters
+     * @returns Processing times data with total count
+     */
+    list(params?: ProcessingTimesParams): Promise<ReferenceListResponse<ProcessingTime>>;
+    /**
+     * Get formula processing times
+     * @param params Optional filter parameters
+     * @returns Formula processing times data with total count
+     */
+    formula(params?: FormulaProcessingTimesParams): Promise<ReferenceListResponse<FormulaProcessingTime>>;
+    /**
+     * Get registration processing times
+     * @param params Optional filter parameters
+     * @returns Registration processing times data with total count
+     */
+    registration(params?: RegistrationProcessingTimesParams): Promise<ReferenceListResponse<RegistrationProcessingTime>>;
+}
+/**
+ * Production reports reference data resource handler
+ */
+declare class ProductionReportsResource {
+    private readonly client;
+    constructor(client: ColaCloud);
+    /**
+     * List production reports with pagination
+     * @param params Filter and pagination parameters
+     * @returns Paginated production reports data
+     */
+    list(params?: ProductionReportsParams): Promise<ReferencePaginatedResponse<ProductionReport>>;
+}
+/**
+ * AVA (American Viticultural Area) reference data resource handler
+ */
+declare class AvasResource {
+    private readonly client;
+    constructor(client: ColaCloud);
+    /**
+     * List and search AVAs
+     * @param params Optional filter parameters
+     * @returns AVA data with total count
+     */
+    list(params?: AvaListParams): Promise<ReferenceListResponse<AvaSummary>>;
+    /**
+     * Get a single AVA by ID
+     * @param avaId The unique AVA identifier
+     * @returns Full AVA details
+     */
+    get(avaId: string): Promise<AvaDetail>;
+}
 
 /**
  * COLA Cloud SDK Custom Error Classes
@@ -661,4 +858,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, type QuotaInfo, RateLimitError, type ResponseWithQuota, ServerError, type SingleResponse, TimeoutError, type UsageStats, ValidationError, collectAll, createPaginatedIterator, createPaginatedIteratorWithMetadata, take };
+export { type ApiErrorResponse, AuthenticationError, type AvaDetail, type AvaListParams, type AvaSummary, type BarcodeLookupResult, type ColaBarcode, ColaCloud, type ColaCloudConfig, ColaCloudError, type ColaDetail, type ColaImage, type ColaListParams, type ColaSummary, type FormulaProcessingTime, type FormulaProcessingTimesParams, NetworkError, NotFoundError, type PaginatedIteratorOptions, type PaginatedIteratorResult, type PaginatedResponse, type Pagination, type PermitteeDetail, type PermitteeListParams, type PermitteeSummary, type ProcessingTime, type ProcessingTimesParams, type ProductionReport, type ProductionReportsParams, type QuotaInfo, RateLimitError, type ReferenceListMeta, type ReferenceListPaginatedMeta, type ReferenceListResponse, type ReferencePaginatedResponse, type ReferenceSingleResponse, type RegistrationProcessingTime, type RegistrationProcessingTimesParams, type ResponseWithQuota, ServerError, type SingleResponse, TimeoutError, type UsageStats, ValidationError, collectAll, createPaginatedIterator, createPaginatedIteratorWithMetadata, take };

package/dist/index.d.ts

@@ -257,12 +257,12 @@ interface PermitteeSummary {
     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;
+    /** Total number of COLAs. Paid plans only (starter/pro). */
+    colas?: number;
+    /** Number of approved COLAs. Paid plans only (starter/pro). */
+    colas_approved?: number;
+    /** Date of most recent COLA application (ISO date string). Paid plans only (starter/pro). */
+    last_cola_application_date?: string | null;
 }
 /**
  * Full details for a permittee including recent COLAs
@@ -328,6 +328,140 @@ interface UsageStats {
     /** Per-minute burst limit */
     per_minute_limit: number;
 }
+/**
+ * Metadata for reference data list responses
+ */
+interface ReferenceListMeta {
+    /** Total number of items */
+    total: number;
+}
+/**
+ * Metadata for paginated reference data responses
+ */
+interface ReferenceListPaginatedMeta {
+    /** Total number of items */
+    total: number;
+    /** Current page number */
+    page: number;
+    /** Items per page */
+    per_page: number;
+    /** Whether there are more results */
+    has_more: boolean;
+}
+/**
+ * Response wrapper for reference data list endpoints
+ */
+interface ReferenceListResponse<T> {
+    /** Array of items */
+    data: T[];
+    /** Response metadata */
+    meta: ReferenceListMeta;
+}
+/**
+ * Response wrapper for paginated reference data list endpoints
+ */
+interface ReferencePaginatedResponse<T> {
+    /** Array of items */
+    data: T[];
+    /** Response metadata with pagination */
+    meta: ReferenceListPaginatedMeta;
+}
+/**
+ * Response wrapper for single reference data endpoints
+ */
+interface ReferenceSingleResponse<T> {
+    /** The requested item */
+    data: T;
+}
+/**
+ * Query parameters for processing times overview
+ */
+interface ProcessingTimesParams {
+    /** Filter by commodity type */
+    commodity?: string;
+}
+/**
+ * Query parameters for formula processing times
+ */
+interface FormulaProcessingTimesParams {
+    /** Filter by formula type */
+    formulaType?: string;
+    /** Filter by commodity type */
+    commodity?: string;
+}
+/**
+ * Query parameters for registration processing times
+ */
+interface RegistrationProcessingTimesParams {
+    /** Filter by category */
+    category?: string;
+    /** Filter by application type */
+    applicationType?: string;
+}
+/**
+ * Query parameters for production reports
+ */
+interface ProductionReportsParams {
+    /** Filter by commodity type */
+    commodity?: string;
+    /** Filter by year */
+    year?: number;
+    /** Filter by month */
+    month?: number;
+    /** Filter by report type */
+    reportType?: string;
+    /** Filter by statistical group */
+    statisticalGroup?: string;
+    /** Page number (1-indexed, default 1) */
+    page?: number;
+    /** Items per page (default 100, max 100) */
+    perPage?: number;
+}
+/**
+ * Query parameters for AVA (American Viticultural Area) list
+ */
+interface AvaListParams {
+    /** Filter by state */
+    state?: string;
+    /** Search by name */
+    q?: string;
+}
+/**
+ * A processing time record
+ */
+interface ProcessingTime {
+    [key: string]: unknown;
+}
+/**
+ * A formula processing time record
+ */
+interface FormulaProcessingTime {
+    [key: string]: unknown;
+}
+/**
+ * A registration processing time record
+ */
+interface RegistrationProcessingTime {
+    [key: string]: unknown;
+}
+/**
+ * A production report record
+ */
+interface ProductionReport {
+    [key: string]: unknown;
+}
+/**
+ * An AVA (American Viticultural Area) summary record
+ */
+interface AvaSummary {
+    [key: string]: unknown;
+}
+/**
+ * Full AVA (American Viticultural Area) detail record
+ */
+interface AvaDetail {
+    [key: string]: unknown;
+}
 /**
  * Error response structure from the API
  */
@@ -379,6 +513,12 @@ declare class ColaCloud {
     readonly barcodes: BarcodesResource;
     /** Usage statistics endpoint */
     readonly usage: UsageResource;
+    /** Processing times reference data endpoints */
+    readonly processingTimes: ProcessingTimesResource;
+    /** Production reports reference data endpoints */
+    readonly productionReports: ProductionReportsResource;
+    /** AVA (American Viticultural Area) reference data endpoints */
+    readonly avas: AvasResource;
     /**
      * Create a new COLA Cloud API client
      * @param config Configuration options
@@ -518,6 +658,63 @@ declare class UsageResource {
      */
     getWithQuota(): Promise<ResponseWithQuota<UsageStats>>;
 }
+/**
+ * Processing times reference data resource handler
+ */
+declare class ProcessingTimesResource {
+    private readonly client;
+    constructor(client: ColaCloud);
+    /**
+     * Get processing times overview
+     * @param params Optional filter parameters
+     * @returns Processing times data with total count
+     */
+    list(params?: ProcessingTimesParams): Promise<ReferenceListResponse<ProcessingTime>>;
+    /**
+     * Get formula processing times
+     * @param params Optional filter parameters
+     * @returns Formula processing times data with total count
+     */
+    formula(params?: FormulaProcessingTimesParams): Promise<ReferenceListResponse<FormulaProcessingTime>>;
+    /**
+     * Get registration processing times
+     * @param params Optional filter parameters
+     * @returns Registration processing times data with total count
+     */
+    registration(params?: RegistrationProcessingTimesParams): Promise<ReferenceListResponse<RegistrationProcessingTime>>;
+}
+/**
+ * Production reports reference data resource handler
+ */
+declare class ProductionReportsResource {
+    private readonly client;
+    constructor(client: ColaCloud);
+    /**
+     * List production reports with pagination
+     * @param params Filter and pagination parameters
+     * @returns Paginated production reports data
+     */
+    list(params?: ProductionReportsParams): Promise<ReferencePaginatedResponse<ProductionReport>>;
+}
+/**
+ * AVA (American Viticultural Area) reference data resource handler
+ */
+declare class AvasResource {
+    private readonly client;
+    constructor(client: ColaCloud);
+    /**
+     * List and search AVAs
+     * @param params Optional filter parameters
+     * @returns AVA data with total count
+     */
+    list(params?: AvaListParams): Promise<ReferenceListResponse<AvaSummary>>;
+    /**
+     * Get a single AVA by ID
+     * @param avaId The unique AVA identifier
+     * @returns Full AVA details
+     */
+    get(avaId: string): Promise<AvaDetail>;
+}
 
 /**
  * COLA Cloud SDK Custom Error Classes
@@ -661,4 +858,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, type QuotaInfo, RateLimitError, type ResponseWithQuota, ServerError, type SingleResponse, TimeoutError, type UsageStats, ValidationError, collectAll, createPaginatedIterator, createPaginatedIteratorWithMetadata, take };
+export { type ApiErrorResponse, AuthenticationError, type AvaDetail, type AvaListParams, type AvaSummary, type BarcodeLookupResult, type ColaBarcode, ColaCloud, type ColaCloudConfig, ColaCloudError, type ColaDetail, type ColaImage, type ColaListParams, type ColaSummary, type FormulaProcessingTime, type FormulaProcessingTimesParams, NetworkError, NotFoundError, type PaginatedIteratorOptions, type PaginatedIteratorResult, type PaginatedResponse, type Pagination, type PermitteeDetail, type PermitteeListParams, type PermitteeSummary, type ProcessingTime, type ProcessingTimesParams, type ProductionReport, type ProductionReportsParams, type QuotaInfo, RateLimitError, type ReferenceListMeta, type ReferenceListPaginatedMeta, type ReferenceListResponse, type ReferencePaginatedResponse, type ReferenceSingleResponse, type RegistrationProcessingTime, type RegistrationProcessingTimesParams, type ResponseWithQuota, ServerError, type SingleResponse, TimeoutError, type UsageStats, ValidationError, collectAll, createPaginatedIterator, createPaginatedIteratorWithMetadata, take };

package/dist/index.js

@@ -329,6 +329,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
@@ -344,6 +350,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
@@ -671,6 +680,86 @@ var UsageResource = class {
     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;
+    }
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,

package/dist/index.mjs

@@ -291,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
@@ -306,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
@@ -633,6 +642,86 @@ var UsageResource = class {
     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 {
   AuthenticationError,
   ColaCloud,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "colacloud",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "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",