zudello-chat-sdk 0.1.1

package/dist/types/constants.d.ts

@@ -0,0 +1,505 @@
+/**
+ * Zudello SDK Constants
+ *
+ * Type-safe constants for models, modules, submodules, and status keys.
+ * Includes Zod schemas for runtime validation.
+ *
+ * @example
+ * import { MODELS, MODULES, SUBMODULES, zudelloModelSchema } from 'zudello-chat-sdk';
+ *
+ * // Type-safe constants
+ * const invoices = await client.search.query({
+ *     model: MODELS.Transaction,
+ *     module: MODULES.PURCHASING,
+ *     submodule: SUBMODULES.INVOICE,
+ *     filter: { status: 'REVIEW' }
+ * });
+ *
+ * // Runtime validation with Zod
+ * const validModel = zudelloModelSchema.parse('Transaction');
+ */
+import { z } from 'zod';
+/**
+ * Valid Zudello models as array.
+ */
+export declare const ZUDELLO_MODELS: readonly ["Budget", "Contract", "Account", "AccountCategory", "AccountGroup", "AccountingPeriod", "AmortizationSchedule", "Batch", "Bin", "ContractCategory", "ContractGroup", "CostCentre", "CostType", "Currency", "CustomerCategory", "CustomerGroup", "Department", "ExpenseCategory", "FixedAsset", "ItemCategory", "ItemGroup", "Location", "MileageRate", "PaymentMethod", "PaymentTerm", "Project", "ProjectGroup", "ProjectTask", "ProjectType", "Subsidiary", "SupplierCategory", "SupplierGroup", "TaxRate", "TaxSolution", "TeamAddress", "UnitOfMeasure", "Warehouse", "Zone", "Transaction", "Item", "Customer", "Employee", "Supplier"];
+/**
+ * Valid Zudello modules as array.
+ */
+export declare const ZUDELLO_MODULES: readonly ["BUDGETS", "CONTRACTS", "DIMENSIONS", "EXPENSES", "INVENTORY", "PURCHASING", "RELATIONSHIPS", "SALES"];
+/**
+ * Valid Zudello submodules as array.
+ */
+export declare const ZUDELLO_SUBMODULES: readonly ["BUDGET", "CONTRACT", "ACCOUNT", "ACCOUNT_CATEGORY", "ACCOUNT_GROUP", "ACCOUNTING_PERIOD", "AMORTIZATION_SCHEDULE", "BATCH", "BIN", "CONTRACT_CATEGORY", "CONTRACT_GROUP", "COST_CENTRE", "COST_TYPE", "CURRENCY", "CUSTOMER_CATEGORY", "CUSTOMER_GROUP", "DEPARTMENT", "EXPENSE_CATEGORY", "FIXED_ASSET", "ITEM_CATEGORY", "ITEM_GROUP", "LOCATION", "MILEAGE_RATE", "PAYMENT_METHOD", "PAYMENT_TERM", "PROJECT", "PROJECT_GROUP", "PROJECT_TASK", "PROJECT_TYPE", "SUBSIDIARY", "SUPPLIER_CATEGORY", "SUPPLIER_GROUP", "TAX_RATE", "TAX_SOLUTION", "TEAM_ADDRESS", "UNIT_OF_MEASURE", "WAREHOUSE", "ZONE", "CLAIM", "EXPENSE", "MILEAGE", "PAYMENT", "REFUND", "CATALOGUE", "RECEIPT", "CREDIT", "INVOICE", "ORDER", "QUOTE", "REQUISITION", "RETURN", "STATEMENT", "CUSTOMER", "EMPLOYEE", "SUPPLIER", "REMITTANCE"];
+/**
+ * All unique status keys used across Zudello modules.
+ * IMPORTANT: Statuses are user-configurable per organization.
+ */
+export declare const ZUDELLO_STATUS_KEYS: readonly ["DRAFT", "ACTIVE", "INACTIVE", "DELETED", "ARCHIVED", "PROCESSING", "APPROVAL", "REJECT", "REJECTED", "UNABLE", "SCANNING", "REVIEW", "READY", "COMPLETE", "CLOSED", "DUPLICATE", "NEW_VENDOR", "PO_MISSING", "PO_VARIANCE", "GR_PENDING", "PENDING", "PLACED", "PARTIALLY_RECEIVED", "RECEIVED", "PARTIALLY_INVOICED", "INVOICED_NOT_RECEIVED", "READY_TO_RECONCILE", "RECONCILE", "REQUESTED", "CUSTOMER_CHECK", "ITEM_CHECK", "PRICE_CHECK", "STOCK_CHECK", "UNSUPPORTED"];
+export type ZudelloModel = typeof ZUDELLO_MODELS[number];
+export type ZudelloModule = typeof ZUDELLO_MODULES[number];
+export type ZudelloSubmodule = typeof ZUDELLO_SUBMODULES[number];
+export type ZudelloStatusKey = typeof ZUDELLO_STATUS_KEYS[number];
+/**
+ * Valid Zudello models as object.
+ * @deprecated Use ZUDELLO_MODELS array for Zod compatibility
+ */
+export declare const MODELS: {
+    readonly Budget: "Budget";
+    readonly Contract: "Contract";
+    readonly Account: "Account";
+    readonly AccountCategory: "AccountCategory";
+    readonly AccountGroup: "AccountGroup";
+    readonly AccountingPeriod: "AccountingPeriod";
+    readonly AmortizationSchedule: "AmortizationSchedule";
+    readonly Batch: "Batch";
+    readonly Bin: "Bin";
+    readonly ContractCategory: "ContractCategory";
+    readonly ContractGroup: "ContractGroup";
+    readonly CostCentre: "CostCentre";
+    readonly CostType: "CostType";
+    readonly Currency: "Currency";
+    readonly CustomerCategory: "CustomerCategory";
+    readonly CustomerGroup: "CustomerGroup";
+    readonly Department: "Department";
+    readonly ExpenseCategory: "ExpenseCategory";
+    readonly FixedAsset: "FixedAsset";
+    readonly ItemCategory: "ItemCategory";
+    readonly ItemGroup: "ItemGroup";
+    readonly Location: "Location";
+    readonly MileageRate: "MileageRate";
+    readonly PaymentMethod: "PaymentMethod";
+    readonly PaymentTerm: "PaymentTerm";
+    readonly Project: "Project";
+    readonly ProjectGroup: "ProjectGroup";
+    readonly ProjectTask: "ProjectTask";
+    readonly ProjectType: "ProjectType";
+    readonly Subsidiary: "Subsidiary";
+    readonly SupplierCategory: "SupplierCategory";
+    readonly SupplierGroup: "SupplierGroup";
+    readonly TaxRate: "TaxRate";
+    readonly TaxSolution: "TaxSolution";
+    readonly TeamAddress: "TeamAddress";
+    readonly UnitOfMeasure: "UnitOfMeasure";
+    readonly Warehouse: "Warehouse";
+    readonly Zone: "Zone";
+    readonly Transaction: "Transaction";
+    readonly Item: "Item";
+    readonly Customer: "Customer";
+    readonly Employee: "Employee";
+    readonly Supplier: "Supplier";
+};
+/**
+ * Valid Zudello modules as object.
+ * @deprecated Use ZUDELLO_MODULES array for Zod compatibility
+ */
+export declare const MODULES: {
+    readonly BUDGETS: "BUDGETS";
+    readonly CONTRACTS: "CONTRACTS";
+    readonly DIMENSIONS: "DIMENSIONS";
+    readonly EXPENSES: "EXPENSES";
+    readonly INVENTORY: "INVENTORY";
+    readonly PURCHASING: "PURCHASING";
+    readonly RELATIONSHIPS: "RELATIONSHIPS";
+    readonly SALES: "SALES";
+};
+/**
+ * Valid Zudello submodules as object.
+ * @deprecated Use ZUDELLO_SUBMODULES array for Zod compatibility
+ */
+export declare const SUBMODULES: {
+    readonly BUDGET: "BUDGET";
+    readonly CONTRACT: "CONTRACT";
+    readonly ACCOUNT: "ACCOUNT";
+    readonly ACCOUNT_CATEGORY: "ACCOUNT_CATEGORY";
+    readonly ACCOUNT_GROUP: "ACCOUNT_GROUP";
+    readonly ACCOUNTING_PERIOD: "ACCOUNTING_PERIOD";
+    readonly AMORTIZATION_SCHEDULE: "AMORTIZATION_SCHEDULE";
+    readonly BATCH: "BATCH";
+    readonly BIN: "BIN";
+    readonly CONTRACT_CATEGORY: "CONTRACT_CATEGORY";
+    readonly CONTRACT_GROUP: "CONTRACT_GROUP";
+    readonly COST_CENTRE: "COST_CENTRE";
+    readonly COST_TYPE: "COST_TYPE";
+    readonly CURRENCY: "CURRENCY";
+    readonly CUSTOMER_CATEGORY: "CUSTOMER_CATEGORY";
+    readonly CUSTOMER_GROUP: "CUSTOMER_GROUP";
+    readonly DEPARTMENT: "DEPARTMENT";
+    readonly EXPENSE_CATEGORY: "EXPENSE_CATEGORY";
+    readonly FIXED_ASSET: "FIXED_ASSET";
+    readonly ITEM_CATEGORY: "ITEM_CATEGORY";
+    readonly ITEM_GROUP: "ITEM_GROUP";
+    readonly LOCATION: "LOCATION";
+    readonly MILEAGE_RATE: "MILEAGE_RATE";
+    readonly PAYMENT_METHOD: "PAYMENT_METHOD";
+    readonly PAYMENT_TERM: "PAYMENT_TERM";
+    readonly PROJECT: "PROJECT";
+    readonly PROJECT_GROUP: "PROJECT_GROUP";
+    readonly PROJECT_TASK: "PROJECT_TASK";
+    readonly PROJECT_TYPE: "PROJECT_TYPE";
+    readonly SUBSIDIARY: "SUBSIDIARY";
+    readonly SUPPLIER_CATEGORY: "SUPPLIER_CATEGORY";
+    readonly SUPPLIER_GROUP: "SUPPLIER_GROUP";
+    readonly TAX_RATE: "TAX_RATE";
+    readonly TAX_SOLUTION: "TAX_SOLUTION";
+    readonly TEAM_ADDRESS: "TEAM_ADDRESS";
+    readonly UNIT_OF_MEASURE: "UNIT_OF_MEASURE";
+    readonly WAREHOUSE: "WAREHOUSE";
+    readonly ZONE: "ZONE";
+    readonly CLAIM: "CLAIM";
+    readonly EXPENSE: "EXPENSE";
+    readonly MILEAGE: "MILEAGE";
+    readonly PAYMENT: "PAYMENT";
+    readonly REFUND: "REFUND";
+    readonly CATALOGUE: "CATALOGUE";
+    readonly RECEIPT: "RECEIPT";
+    readonly CREDIT: "CREDIT";
+    readonly INVOICE: "INVOICE";
+    readonly ORDER: "ORDER";
+    readonly QUOTE: "QUOTE";
+    readonly REQUISITION: "REQUISITION";
+    readonly RETURN: "RETURN";
+    readonly STATEMENT: "STATEMENT";
+    readonly CUSTOMER: "CUSTOMER";
+    readonly EMPLOYEE: "EMPLOYEE";
+    readonly SUPPLIER: "SUPPLIER";
+    readonly REMITTANCE: "REMITTANCE";
+};
+/**
+ * Common status keys as object.
+ * @deprecated Use ZUDELLO_STATUS_KEYS array for Zod compatibility
+ */
+export declare const STATUS_KEYS: {
+    readonly DRAFT: "DRAFT";
+    readonly ACTIVE: "ACTIVE";
+    readonly INACTIVE: "INACTIVE";
+    readonly DELETED: "DELETED";
+    readonly ARCHIVED: "ARCHIVED";
+    readonly PROCESSING: "PROCESSING";
+    readonly APPROVAL: "APPROVAL";
+    readonly REJECT: "REJECT";
+    readonly REJECTED: "REJECTED";
+    readonly UNABLE: "UNABLE";
+    readonly SCANNING: "SCANNING";
+    readonly REVIEW: "REVIEW";
+    readonly READY: "READY";
+    readonly COMPLETE: "COMPLETE";
+    readonly CLOSED: "CLOSED";
+    readonly DUPLICATE: "DUPLICATE";
+    readonly NEW_VENDOR: "NEW_VENDOR";
+    readonly PO_MISSING: "PO_MISSING";
+    readonly PO_VARIANCE: "PO_VARIANCE";
+    readonly GR_PENDING: "GR_PENDING";
+    readonly PENDING: "PENDING";
+    readonly PLACED: "PLACED";
+    readonly PARTIALLY_RECEIVED: "PARTIALLY_RECEIVED";
+    readonly RECEIVED: "RECEIVED";
+    readonly PARTIALLY_INVOICED: "PARTIALLY_INVOICED";
+};
+/**
+ * Valid combinations of model, module, and submodule.
+ * Based on the official Zudello API specification.
+ */
+export declare const ZUDELLO_MODEL_COMBINATIONS: readonly [{
+    readonly model: "Budget";
+    readonly module: "BUDGETS";
+    readonly submodule: "BUDGET";
+}, {
+    readonly model: "Contract";
+    readonly module: "CONTRACTS";
+    readonly submodule: "CONTRACT";
+}, {
+    readonly model: "Account";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "ACCOUNT";
+}, {
+    readonly model: "AccountCategory";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "ACCOUNT_CATEGORY";
+}, {
+    readonly model: "AccountGroup";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "ACCOUNT_GROUP";
+}, {
+    readonly model: "AccountingPeriod";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "ACCOUNTING_PERIOD";
+}, {
+    readonly model: "AmortizationSchedule";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "AMORTIZATION_SCHEDULE";
+}, {
+    readonly model: "Batch";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "BATCH";
+}, {
+    readonly model: "Bin";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "BIN";
+}, {
+    readonly model: "ContractCategory";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "CONTRACT_CATEGORY";
+}, {
+    readonly model: "ContractGroup";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "CONTRACT_GROUP";
+}, {
+    readonly model: "CostCentre";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "COST_CENTRE";
+}, {
+    readonly model: "CostType";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "COST_TYPE";
+}, {
+    readonly model: "Currency";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "CURRENCY";
+}, {
+    readonly model: "CustomerCategory";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "CUSTOMER_CATEGORY";
+}, {
+    readonly model: "CustomerGroup";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "CUSTOMER_GROUP";
+}, {
+    readonly model: "Department";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "DEPARTMENT";
+}, {
+    readonly model: "ExpenseCategory";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "EXPENSE_CATEGORY";
+}, {
+    readonly model: "FixedAsset";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "FIXED_ASSET";
+}, {
+    readonly model: "ItemCategory";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "ITEM_CATEGORY";
+}, {
+    readonly model: "ItemGroup";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "ITEM_GROUP";
+}, {
+    readonly model: "Location";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "LOCATION";
+}, {
+    readonly model: "MileageRate";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "MILEAGE_RATE";
+}, {
+    readonly model: "PaymentMethod";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "PAYMENT_METHOD";
+}, {
+    readonly model: "PaymentTerm";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "PAYMENT_TERM";
+}, {
+    readonly model: "Project";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "PROJECT";
+}, {
+    readonly model: "ProjectGroup";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "PROJECT_GROUP";
+}, {
+    readonly model: "ProjectTask";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "PROJECT_TASK";
+}, {
+    readonly model: "ProjectType";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "PROJECT_TYPE";
+}, {
+    readonly model: "Subsidiary";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "SUBSIDIARY";
+}, {
+    readonly model: "SupplierCategory";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "SUPPLIER_CATEGORY";
+}, {
+    readonly model: "SupplierGroup";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "SUPPLIER_GROUP";
+}, {
+    readonly model: "TaxRate";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "TAX_RATE";
+}, {
+    readonly model: "TaxSolution";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "TAX_SOLUTION";
+}, {
+    readonly model: "TeamAddress";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "TEAM_ADDRESS";
+}, {
+    readonly model: "UnitOfMeasure";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "UNIT_OF_MEASURE";
+}, {
+    readonly model: "Warehouse";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "WAREHOUSE";
+}, {
+    readonly model: "Zone";
+    readonly module: "DIMENSIONS";
+    readonly submodule: "ZONE";
+}, {
+    readonly model: "Transaction";
+    readonly module: "EXPENSES";
+    readonly submodule: "CLAIM";
+}, {
+    readonly model: "Transaction";
+    readonly module: "EXPENSES";
+    readonly submodule: "EXPENSE";
+}, {
+    readonly model: "Transaction";
+    readonly module: "EXPENSES";
+    readonly submodule: "MILEAGE";
+}, {
+    readonly model: "Transaction";
+    readonly module: "EXPENSES";
+    readonly submodule: "PAYMENT";
+}, {
+    readonly model: "Transaction";
+    readonly module: "EXPENSES";
+    readonly submodule: "REFUND";
+}, {
+    readonly model: "Item";
+    readonly module: "INVENTORY";
+    readonly submodule: "CATALOGUE";
+}, {
+    readonly model: "Transaction";
+    readonly module: "INVENTORY";
+    readonly submodule: "RECEIPT";
+}, {
+    readonly model: "Transaction";
+    readonly module: "PURCHASING";
+    readonly submodule: "CREDIT";
+}, {
+    readonly model: "Transaction";
+    readonly module: "PURCHASING";
+    readonly submodule: "INVOICE";
+}, {
+    readonly model: "Transaction";
+    readonly module: "PURCHASING";
+    readonly submodule: "ORDER";
+}, {
+    readonly model: "Transaction";
+    readonly module: "PURCHASING";
+    readonly submodule: "QUOTE";
+}, {
+    readonly model: "Transaction";
+    readonly module: "PURCHASING";
+    readonly submodule: "REQUISITION";
+}, {
+    readonly model: "Transaction";
+    readonly module: "PURCHASING";
+    readonly submodule: "RETURN";
+}, {
+    readonly model: "Transaction";
+    readonly module: "PURCHASING";
+    readonly submodule: "STATEMENT";
+}, {
+    readonly model: "Customer";
+    readonly module: "RELATIONSHIPS";
+    readonly submodule: "CUSTOMER";
+}, {
+    readonly model: "Employee";
+    readonly module: "RELATIONSHIPS";
+    readonly submodule: "EMPLOYEE";
+}, {
+    readonly model: "Supplier";
+    readonly module: "RELATIONSHIPS";
+    readonly submodule: "SUPPLIER";
+}, {
+    readonly model: "Transaction";
+    readonly module: "SALES";
+    readonly submodule: "CREDIT";
+}, {
+    readonly model: "Transaction";
+    readonly module: "SALES";
+    readonly submodule: "INVOICE";
+}, {
+    readonly model: "Transaction";
+    readonly module: "SALES";
+    readonly submodule: "ORDER";
+}, {
+    readonly model: "Transaction";
+    readonly module: "SALES";
+    readonly submodule: "QUOTE";
+}, {
+    readonly model: "Transaction";
+    readonly module: "SALES";
+    readonly submodule: "REMITTANCE";
+}];
+export type ZudelloModelCombination = typeof ZUDELLO_MODEL_COMBINATIONS[number];
+/**
+ * Zod schema for Zudello models.
+ * Use for runtime validation of model inputs.
+ */
+export declare const zudelloModelSchema: z.ZodEnum<["Budget", "Contract", "Account", "AccountCategory", "AccountGroup", "AccountingPeriod", "AmortizationSchedule", "Batch", "Bin", "ContractCategory", "ContractGroup", "CostCentre", "CostType", "Currency", "CustomerCategory", "CustomerGroup", "Department", "ExpenseCategory", "FixedAsset", "ItemCategory", "ItemGroup", "Location", "MileageRate", "PaymentMethod", "PaymentTerm", "Project", "ProjectGroup", "ProjectTask", "ProjectType", "Subsidiary", "SupplierCategory", "SupplierGroup", "TaxRate", "TaxSolution", "TeamAddress", "UnitOfMeasure", "Warehouse", "Zone", "Transaction", "Item", "Customer", "Employee", "Supplier"]>;
+/**
+ * Zod schema for Zudello modules.
+ * Use for runtime validation of module inputs.
+ */
+export declare const zudelloModuleSchema: z.ZodEnum<["BUDGETS", "CONTRACTS", "DIMENSIONS", "EXPENSES", "INVENTORY", "PURCHASING", "RELATIONSHIPS", "SALES"]>;
+/**
+ * Zod schema for Zudello submodules.
+ * Use for runtime validation of submodule inputs.
+ */
+export declare const zudelloSubmoduleSchema: z.ZodEnum<["BUDGET", "CONTRACT", "ACCOUNT", "ACCOUNT_CATEGORY", "ACCOUNT_GROUP", "ACCOUNTING_PERIOD", "AMORTIZATION_SCHEDULE", "BATCH", "BIN", "CONTRACT_CATEGORY", "CONTRACT_GROUP", "COST_CENTRE", "COST_TYPE", "CURRENCY", "CUSTOMER_CATEGORY", "CUSTOMER_GROUP", "DEPARTMENT", "EXPENSE_CATEGORY", "FIXED_ASSET", "ITEM_CATEGORY", "ITEM_GROUP", "LOCATION", "MILEAGE_RATE", "PAYMENT_METHOD", "PAYMENT_TERM", "PROJECT", "PROJECT_GROUP", "PROJECT_TASK", "PROJECT_TYPE", "SUBSIDIARY", "SUPPLIER_CATEGORY", "SUPPLIER_GROUP", "TAX_RATE", "TAX_SOLUTION", "TEAM_ADDRESS", "UNIT_OF_MEASURE", "WAREHOUSE", "ZONE", "CLAIM", "EXPENSE", "MILEAGE", "PAYMENT", "REFUND", "CATALOGUE", "RECEIPT", "CREDIT", "INVOICE", "ORDER", "QUOTE", "REQUISITION", "RETURN", "STATEMENT", "CUSTOMER", "EMPLOYEE", "SUPPLIER", "REMITTANCE"]>;
+/**
+ * Zod schema for Zudello status keys.
+ * IMPORTANT: Statuses are user-configurable. These are default values.
+ */
+export declare const zudelloStatusKeySchema: z.ZodEnum<["DRAFT", "ACTIVE", "INACTIVE", "DELETED", "ARCHIVED", "PROCESSING", "APPROVAL", "REJECT", "REJECTED", "UNABLE", "SCANNING", "REVIEW", "READY", "COMPLETE", "CLOSED", "DUPLICATE", "NEW_VENDOR", "PO_MISSING", "PO_VARIANCE", "GR_PENDING", "PENDING", "PLACED", "PARTIALLY_RECEIVED", "RECEIVED", "PARTIALLY_INVOICED", "INVOICED_NOT_RECEIVED", "READY_TO_RECONCILE", "RECONCILE", "REQUESTED", "CUSTOMER_CHECK", "ITEM_CHECK", "PRICE_CHECK", "STOCK_CHECK", "UNSUPPORTED"]>;
+/**
+ * Check if a string is a valid Zudello model
+ */
+export declare function isValidModel(model: string): model is ZudelloModel;
+/**
+ * Check if a string is a valid Zudello module
+ */
+export declare function isValidModule(module: string): module is ZudelloModule;
+/**
+ * Check if a string is a valid Zudello submodule
+ */
+export declare function isValidSubmodule(submodule: string): submodule is ZudelloSubmodule;
+/**
+ * Check if a string is a valid Zudello status key
+ */
+export declare function isValidStatusKey(statusKey: string): statusKey is ZudelloStatusKey;
+/**
+ * Check if a model/module/submodule combination is valid
+ */
+export declare function isValidCombination(model: string, module?: string, submodule?: string): boolean;
+/**
+ * Get valid modules for a given model
+ */
+export declare function getValidModulesForModel(model: ZudelloModel): ZudelloModule[];
+/**
+ * Get valid submodules for a given model and optional module
+ */
+export declare function getValidSubmodulesForModel(model: ZudelloModel, module?: ZudelloModule): ZudelloSubmodule[];
+/**
+ * Get models available in a specific module
+ */
+export declare function getModelsForModule(module: ZudelloModule): ZudelloModel[];
+/**
+ * Get all valid combinations for a specific model
+ */
+export declare function getCombinationsForModel(model: ZudelloModel): ZudelloModelCombination[];
+/**
+ * Create a Zod schema that validates model/module/submodule combinations
+ */
+export declare function createValidatedModelSchema(moduleParam?: string, submoduleParam?: string): z.ZodEffects<z.ZodString, string, string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/types/errors.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Zudello SDK Error Classes
+ *
+ * Typed error classes for different failure scenarios.
+ * Always wrap API calls in try/catch and handle these errors appropriately.
+ *
+ * @example
+ * import {
+ *     ZudelloClient,
+ *     ZudelloAuthenticationError,
+ *     ZudelloValidationError,
+ *     ZudelloAPIError
+ * } from 'zudello-chat-sdk';
+ *
+ * try {
+ *     const result = await client.search({ model: 'Transaction' });
+ * } catch (error) {
+ *     if (error instanceof ZudelloAuthenticationError) {
+ *         console.log('Token expired or invalid');
+ *     } else if (error instanceof ZudelloValidationError) {
+ *         console.log('Invalid request:', error.message);
+ *     } else if (error instanceof ZudelloAPIError) {
+ *         console.log('API error:', error.statusCode, error.message);
+ *     }
+ * }
+ */
+/**
+ * Base error class for all Zudello SDK errors.
+ */
+export declare class ZudelloError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when SDK configuration is missing or invalid.
+ *
+ * Common causes:
+ * - Missing required environment variables (ZUDELLO_TOKEN, ZUDELLO_CLUSTER_URL, etc.)
+ * - Invalid configuration options passed to ZudelloClient constructor
+ *
+ * @example
+ * // This will throw if ZUDELLO_TOKEN env var is not set
+ * const client = new ZudelloClient();
+ */
+export declare class ZudelloConfigurationError extends ZudelloError {
+    /** The configuration key that is missing or invalid */
+    readonly configKey?: string;
+    constructor(message: string, configKey?: string);
+}
+/**
+ * Thrown when authentication fails (401 responses).
+ *
+ * Common causes:
+ * - Expired token
+ * - Invalid token format
+ * - Token revoked
+ *
+ * Recovery: Obtain a new token and reinitialize the client.
+ */
+export declare class ZudelloAuthenticationError extends ZudelloError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the user lacks permission for the requested operation (403 responses).
+ *
+ * Common causes:
+ * - User doesn't have access to the requested resource
+ * - User doesn't have permission for the operation (e.g., write when only read allowed)
+ * - Resource belongs to a different organization/team
+ */
+export declare class ZudelloPermissionError extends ZudelloError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the requested resource is not found (404 responses).
+ *
+ * Common causes:
+ * - Invalid UUID
+ * - Resource has been deleted
+ * - Resource belongs to a different team
+ */
+export declare class ZudelloNotFoundError extends ZudelloError {
+    /** The UUID or identifier that was not found */
+    readonly resourceId?: string;
+    constructor(message: string, resourceId?: string);
+}
+/**
+ * Thrown when request validation fails.
+ *
+ * Common causes:
+ * - Invalid model name
+ * - Invalid filter syntax
+ * - Missing required fields
+ * - Invalid field values
+ *
+ * Check the `details` property for specific validation errors.
+ */
+export declare class ZudelloValidationError extends ZudelloError {
+    /** Detailed validation error information */
+    readonly details?: Record<string, unknown>;
+    /** The field(s) that failed validation */
+    readonly fields?: string[];
+    constructor(message: string, details?: Record<string, unknown>, fields?: string[]);
+}
+/**
+ * Thrown when the API returns an error response.
+ *
+ * This is a general API error for non-specific failures.
+ * Check `statusCode` and `responseBody` for details.
+ */
+export declare class ZudelloAPIError extends ZudelloError {
+    /** HTTP status code from the API */
+    readonly statusCode: number;
+    /** Raw response body from the API */
+    readonly responseBody?: string;
+    /** Parsed error details if available */
+    readonly errorDetails?: Record<string, unknown>;
+    constructor(message: string, statusCode: number, responseBody?: string, errorDetails?: Record<string, unknown>);
+}
+/**
+ * Thrown when a network error occurs (connection failed, timeout, etc.).
+ *
+ * These are typically transient errors that may succeed on retry.
+ * The SDK has built-in retry logic, so this error means all retries failed.
+ */
+export declare class ZudelloNetworkError extends ZudelloError {
+    /** The underlying error that caused the network failure */
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when the API rate limit is exceeded.
+ *
+ * The SDK has built-in rate limit handling with backoff,
+ * so this error means the rate limit persisted after retries.
+ *
+ * Check `retryAfter` for when to retry (if provided by the API).
+ */
+export declare class ZudelloRateLimitError extends ZudelloError {
+    /** Seconds to wait before retrying (if provided by API) */
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAQ5B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;IACzD,uDAAuD;IACvD,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAKhD;AAED;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;gBAC9C,OAAO,GAAE,MAAmD;CAIzE;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,OAAO,GAAE,MAAmD;CAIzE;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,gDAAgD;IAChD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKjD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,4CAA4C;IAC5C,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,0CAA0C;IAC1C,SAAgB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE;CAMlF;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,oCAAoC;IACpC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,qCAAqC;IACrC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtC,wCAAwC;IACxC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGrD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQzC;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,2DAA2D;IAC3D,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,2DAA2D;IAC3D,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,GAAE,MAA8B,EAAE,UAAU,CAAC,EAAE,MAAM;CAKzE"}