zudello-chat-sdk 0.1.1

package/dist/cjs/errors.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * 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);
+ *     }
+ * }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZudelloRateLimitError = exports.ZudelloNetworkError = exports.ZudelloAPIError = exports.ZudelloValidationError = exports.ZudelloNotFoundError = exports.ZudelloPermissionError = exports.ZudelloAuthenticationError = exports.ZudelloConfigurationError = exports.ZudelloError = void 0;
+/**
+ * Base error class for all Zudello SDK errors.
+ */
+class ZudelloError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ZudelloError';
+        // Maintains proper stack trace for where error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.ZudelloError = ZudelloError;
+/**
+ * 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();
+ */
+class ZudelloConfigurationError extends ZudelloError {
+    /** The configuration key that is missing or invalid */
+    configKey;
+    constructor(message, configKey) {
+        super(message);
+        this.name = 'ZudelloConfigurationError';
+        this.configKey = configKey;
+    }
+}
+exports.ZudelloConfigurationError = ZudelloConfigurationError;
+/**
+ * Thrown when authentication fails (401 responses).
+ *
+ * Common causes:
+ * - Expired token
+ * - Invalid token format
+ * - Token revoked
+ *
+ * Recovery: Obtain a new token and reinitialize the client.
+ */
+class ZudelloAuthenticationError extends ZudelloError {
+    constructor(message = 'Authentication failed - check your token') {
+        super(message);
+        this.name = 'ZudelloAuthenticationError';
+    }
+}
+exports.ZudelloAuthenticationError = ZudelloAuthenticationError;
+/**
+ * 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
+ */
+class ZudelloPermissionError extends ZudelloError {
+    constructor(message = 'Access denied - insufficient permissions') {
+        super(message);
+        this.name = 'ZudelloPermissionError';
+    }
+}
+exports.ZudelloPermissionError = ZudelloPermissionError;
+/**
+ * Thrown when the requested resource is not found (404 responses).
+ *
+ * Common causes:
+ * - Invalid UUID
+ * - Resource has been deleted
+ * - Resource belongs to a different team
+ */
+class ZudelloNotFoundError extends ZudelloError {
+    /** The UUID or identifier that was not found */
+    resourceId;
+    constructor(message, resourceId) {
+        super(message);
+        this.name = 'ZudelloNotFoundError';
+        this.resourceId = resourceId;
+    }
+}
+exports.ZudelloNotFoundError = ZudelloNotFoundError;
+/**
+ * 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.
+ */
+class ZudelloValidationError extends ZudelloError {
+    /** Detailed validation error information */
+    details;
+    /** The field(s) that failed validation */
+    fields;
+    constructor(message, details, fields) {
+        super(message);
+        this.name = 'ZudelloValidationError';
+        this.details = details;
+        this.fields = fields;
+    }
+}
+exports.ZudelloValidationError = ZudelloValidationError;
+/**
+ * Thrown when the API returns an error response.
+ *
+ * This is a general API error for non-specific failures.
+ * Check `statusCode` and `responseBody` for details.
+ */
+class ZudelloAPIError extends ZudelloError {
+    /** HTTP status code from the API */
+    statusCode;
+    /** Raw response body from the API */
+    responseBody;
+    /** Parsed error details if available */
+    errorDetails;
+    constructor(message, statusCode, responseBody, errorDetails) {
+        super(message);
+        this.name = 'ZudelloAPIError';
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.errorDetails = errorDetails;
+    }
+}
+exports.ZudelloAPIError = ZudelloAPIError;
+/**
+ * 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.
+ */
+class ZudelloNetworkError extends ZudelloError {
+    /** The underlying error that caused the network failure */
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = 'ZudelloNetworkError';
+        this.cause = cause;
+    }
+}
+exports.ZudelloNetworkError = ZudelloNetworkError;
+/**
+ * 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).
+ */
+class ZudelloRateLimitError extends ZudelloError {
+    /** Seconds to wait before retrying (if provided by API) */
+    retryAfter;
+    constructor(message = 'Rate limit exceeded', retryAfter) {
+        super(message);
+        this.name = 'ZudelloRateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+exports.ZudelloRateLimitError = ZudelloRateLimitError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

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

package/dist/cjs/http/client.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * HTTP Client for Zudello API
+ *
+ * Handles all HTTP communication including authentication, retries, and error handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const errors_1 = require("../errors");
+// ============================================================================
+// HttpClient
+// ============================================================================
+/**
+ * Low-level HTTP client for Zudello API requests.
+ *
+ * Handles authentication, retries, and error mapping.
+ */
+class HttpClient {
+    config;
+    constructor(config) {
+        this.config = this.resolveConfig(config);
+    }
+    // ==========================================================================
+    // Configuration
+    // ==========================================================================
+    resolveConfig(config) {
+        const token = config?.token ?? process.env.ZUDELLO_TOKEN;
+        const organizationId = config?.organizationId ?? process.env.ZUDELLO_ORG_ID;
+        const teamId = config?.teamId ?? process.env.ZUDELLO_TEAM_ID;
+        const clusterUrl = config?.clusterUrl ?? process.env.ZUDELLO_CLUSTER_URL;
+        const authApiBase = config?.authApiBase ?? process.env.ZUDELLO_AUTH_API_BASE;
+        // Validate required fields
+        if (!token) {
+            throw new errors_1.ZudelloConfigurationError('Missing required configuration: token. Set ZUDELLO_TOKEN environment variable or pass token in config.', 'token');
+        }
+        if (!organizationId) {
+            throw new errors_1.ZudelloConfigurationError('Missing required configuration: organizationId. Set ZUDELLO_ORG_ID environment variable or pass organizationId in config.', 'organizationId');
+        }
+        if (!teamId) {
+            throw new errors_1.ZudelloConfigurationError('Missing required configuration: teamId. Set ZUDELLO_TEAM_ID environment variable or pass teamId in config.', 'teamId');
+        }
+        if (!clusterUrl) {
+            throw new errors_1.ZudelloConfigurationError('Missing required configuration: clusterUrl. Set ZUDELLO_CLUSTER_URL environment variable or pass clusterUrl in config.', 'clusterUrl');
+        }
+        if (!authApiBase) {
+            throw new errors_1.ZudelloConfigurationError('Missing required configuration: authApiBase. Set ZUDELLO_AUTH_API_BASE environment variable or pass authApiBase in config.', 'authApiBase');
+        }
+        return {
+            token,
+            organizationId,
+            teamId,
+            clusterUrl: clusterUrl.replace(/^https?:\/\//, ''), // Remove protocol if present
+            authApiBase,
+            userId: config?.userId ?? process.env.ZUDELLO_USER_ID,
+            userEmail: config?.userEmail ?? process.env.ZUDELLO_USER_EMAIL,
+            maxRetries: config?.maxRetries ?? 3,
+            retryDelay: config?.retryDelay ?? 1000,
+            timeout: config?.timeout ?? 30000,
+        };
+    }
+    get apiBase() {
+        return `https://${this.config.clusterUrl}`;
+    }
+    get headers() {
+        const headers = new Headers();
+        headers.set('Content-Type', 'application/json');
+        headers.set('Authorization', `Bearer ${this.config.token}`);
+        headers.set('x-organization', this.config.organizationId);
+        headers.set('x-team', this.config.teamId);
+        return headers;
+    }
+    // ==========================================================================
+    // HTTP Layer with Retry
+    // ==========================================================================
+    /**
+     * Make a request to the team-data API.
+     */
+    async request(method, endpoint, body, retryCount = 0) {
+        const url = `${this.apiBase}${endpoint}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: this.headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            // Handle specific error status codes
+            if (!response.ok) {
+                return this.handleErrorResponse(response, method, endpoint, body, retryCount, false);
+            }
+            // Parse JSON response with error handling
+            try {
+                return await response.json();
+            }
+            catch {
+                const text = await response.text().catch(() => 'Unable to read response');
+                throw new errors_1.ZudelloAPIError(`Invalid JSON response from API`, response.status, text);
+            }
+        }
+        catch (error) {
+            // Handle timeout specifically
+            if (error instanceof Error && error.name === 'AbortError') {
+                return this.handleNetworkError(new Error(`Request timeout after ${this.config.timeout}ms`), method, endpoint, body, retryCount, false);
+            }
+            return this.handleNetworkError(error, method, endpoint, body, retryCount, false);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Make a request to the authentication API (for organisation-level operations).
+     */
+    async authRequest(method, endpoint, body, retryCount = 0) {
+        const url = `${this.config.authApiBase}${endpoint}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: this.headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            // Handle specific error status codes
+            if (!response.ok) {
+                return this.handleErrorResponse(response, method, endpoint, body, retryCount, true);
+            }
+            // Parse JSON response with error handling
+            try {
+                return await response.json();
+            }
+            catch {
+                const text = await response.text().catch(() => 'Unable to read response');
+                throw new errors_1.ZudelloAPIError(`Invalid JSON response from API`, response.status, text);
+            }
+        }
+        catch (error) {
+            // Handle timeout specifically
+            if (error instanceof Error && error.name === 'AbortError') {
+                return this.handleNetworkError(new Error(`Request timeout after ${this.config.timeout}ms`), method, endpoint, body, retryCount, true);
+            }
+            return this.handleNetworkError(error, method, endpoint, body, retryCount, true);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async handleErrorResponse(response, method, endpoint, body, retryCount, isAuth) {
+        const errorText = await response.text().catch(() => 'Unknown error');
+        // Parse error details if possible
+        let errorDetails;
+        try {
+            errorDetails = JSON.parse(errorText);
+        }
+        catch {
+            // Not JSON, use raw text
+        }
+        switch (response.status) {
+            case 401:
+                throw new errors_1.ZudelloAuthenticationError('Authentication failed - token may be expired or invalid');
+            case 403:
+                throw new errors_1.ZudelloPermissionError(isAuth
+                    ? 'Access forbidden - organisation admin or Zudello staff privileges required'
+                    : `Access denied: ${errorDetails?.message || 'Insufficient permissions'}`);
+            case 404:
+                throw new errors_1.ZudelloNotFoundError(`Resource not found: ${errorDetails?.message || endpoint}`, endpoint);
+            case 422:
+                throw new errors_1.ZudelloValidationError(`Validation failed: ${errorDetails?.message || errorText}`, errorDetails);
+            case 429: {
+                const retryAfter = parseInt(response.headers.get('Retry-After') || '60', 10);
+                if (retryCount < this.config.maxRetries) {
+                    await this.sleep(retryAfter * 1000);
+                    return isAuth
+                        ? this.authRequest(method, endpoint, body, retryCount + 1)
+                        : this.request(method, endpoint, body, retryCount + 1);
+                }
+                throw new errors_1.ZudelloRateLimitError('Rate limit exceeded', retryAfter);
+            }
+            default:
+                // Retry on 5xx errors
+                if (response.status >= 500 && retryCount < this.config.maxRetries) {
+                    await this.sleep(this.config.retryDelay * Math.pow(2, retryCount));
+                    return isAuth
+                        ? this.authRequest(method, endpoint, body, retryCount + 1)
+                        : this.request(method, endpoint, body, retryCount + 1);
+                }
+                throw new errors_1.ZudelloAPIError(`API error (${response.status}): ${errorDetails?.message || response.statusText}`, response.status, errorText, errorDetails);
+        }
+    }
+    async handleNetworkError(error, method, endpoint, body, retryCount, isAuth) {
+        // Re-throw Zudello errors
+        if (error instanceof errors_1.ZudelloConfigurationError ||
+            error instanceof errors_1.ZudelloAuthenticationError ||
+            error instanceof errors_1.ZudelloPermissionError ||
+            error instanceof errors_1.ZudelloNotFoundError ||
+            error instanceof errors_1.ZudelloValidationError ||
+            error instanceof errors_1.ZudelloAPIError ||
+            error instanceof errors_1.ZudelloRateLimitError) {
+            throw error;
+        }
+        // Network errors - retry
+        if (retryCount < this.config.maxRetries) {
+            await this.sleep(this.config.retryDelay * Math.pow(2, retryCount));
+            return isAuth
+                ? this.authRequest(method, endpoint, body, retryCount + 1)
+                : this.request(method, endpoint, body, retryCount + 1);
+        }
+        throw new errors_1.ZudelloNetworkError(`Network error: ${error.message}`, error);
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/http/client.js.map

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

package/dist/cjs/index.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Zudello Chat SDK
+ *
+ * TypeScript SDK for the Zudello API, designed for AI agent code execution in E2B sandboxes.
+ *
+ * @example
+ * import { ZudelloClient, MODELS, MODULES, SUBMODULES } from 'zudello-chat-sdk';
+ *
+ * // Zero-config: reads from environment variables
+ * const client = new ZudelloClient();
+ *
+ * // Search for pending invoices
+ * const invoices = await client.search.query({
+ *     model: MODELS.Transaction,
+ *     module: MODULES.PURCHASING,
+ *     submodule: SUBMODULES.INVOICE,
+ *     filter: { status: 'REVIEW', total__gt: 1000 }
+ * });
+ *
+ * // Auto-pagination with async iterators
+ * for await (const invoice of client.search.list({ model: 'Transaction', module: 'PURCHASING' })) {
+ *     console.log(invoice.document_number);
+ * }
+ *
+ * // Create resources
+ * await client.resources.create({ model: 'Supplier', data: { trading_name: 'ACME' } });
+ *
+ * // Organisation-level admin (requires privileges)
+ * const users = await client.org.listUsers();
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZudelloRateLimitError = exports.ZudelloNetworkError = exports.ZudelloAPIError = exports.ZudelloValidationError = exports.ZudelloNotFoundError = exports.ZudelloPermissionError = exports.ZudelloAuthenticationError = exports.ZudelloConfigurationError = exports.ZudelloError = exports.createValidatedModelSchema = exports.getCombinationsForModel = exports.getModelsForModule = exports.getValidSubmodulesForModel = exports.getValidModulesForModel = exports.isValidCombination = exports.isValidStatusKey = exports.isValidSubmodule = exports.isValidModule = exports.isValidModel = exports.zudelloStatusKeySchema = exports.zudelloSubmoduleSchema = exports.zudelloModuleSchema = exports.zudelloModelSchema = exports.ZUDELLO_MODEL_COMBINATIONS = exports.ZUDELLO_STATUS_KEYS = exports.ZUDELLO_SUBMODULES = exports.ZUDELLO_MODULES = exports.ZUDELLO_MODELS = exports.STATUS_KEYS = exports.SUBMODULES = exports.MODULES = exports.MODELS = exports.ZudelloClient = void 0;
+// Main client
+var client_1 = require("./client");
+Object.defineProperty(exports, "ZudelloClient", { enumerable: true, get: function () { return client_1.ZudelloClient; } });
+// Constants for type-safe usage
+var constants_1 = require("./constants");
+// Legacy object constants (backward compatible)
+Object.defineProperty(exports, "MODELS", { enumerable: true, get: function () { return constants_1.MODELS; } });
+Object.defineProperty(exports, "MODULES", { enumerable: true, get: function () { return constants_1.MODULES; } });
+Object.defineProperty(exports, "SUBMODULES", { enumerable: true, get: function () { return constants_1.SUBMODULES; } });
+Object.defineProperty(exports, "STATUS_KEYS", { enumerable: true, get: function () { return constants_1.STATUS_KEYS; } });
+// Array constants (for Zod enum compatibility)
+Object.defineProperty(exports, "ZUDELLO_MODELS", { enumerable: true, get: function () { return constants_1.ZUDELLO_MODELS; } });
+Object.defineProperty(exports, "ZUDELLO_MODULES", { enumerable: true, get: function () { return constants_1.ZUDELLO_MODULES; } });
+Object.defineProperty(exports, "ZUDELLO_SUBMODULES", { enumerable: true, get: function () { return constants_1.ZUDELLO_SUBMODULES; } });
+Object.defineProperty(exports, "ZUDELLO_STATUS_KEYS", { enumerable: true, get: function () { return constants_1.ZUDELLO_STATUS_KEYS; } });
+// Model combinations
+Object.defineProperty(exports, "ZUDELLO_MODEL_COMBINATIONS", { enumerable: true, get: function () { return constants_1.ZUDELLO_MODEL_COMBINATIONS; } });
+// Zod schemas
+Object.defineProperty(exports, "zudelloModelSchema", { enumerable: true, get: function () { return constants_1.zudelloModelSchema; } });
+Object.defineProperty(exports, "zudelloModuleSchema", { enumerable: true, get: function () { return constants_1.zudelloModuleSchema; } });
+Object.defineProperty(exports, "zudelloSubmoduleSchema", { enumerable: true, get: function () { return constants_1.zudelloSubmoduleSchema; } });
+Object.defineProperty(exports, "zudelloStatusKeySchema", { enumerable: true, get: function () { return constants_1.zudelloStatusKeySchema; } });
+// Validation functions
+Object.defineProperty(exports, "isValidModel", { enumerable: true, get: function () { return constants_1.isValidModel; } });
+Object.defineProperty(exports, "isValidModule", { enumerable: true, get: function () { return constants_1.isValidModule; } });
+Object.defineProperty(exports, "isValidSubmodule", { enumerable: true, get: function () { return constants_1.isValidSubmodule; } });
+Object.defineProperty(exports, "isValidStatusKey", { enumerable: true, get: function () { return constants_1.isValidStatusKey; } });
+Object.defineProperty(exports, "isValidCombination", { enumerable: true, get: function () { return constants_1.isValidCombination; } });
+Object.defineProperty(exports, "getValidModulesForModel", { enumerable: true, get: function () { return constants_1.getValidModulesForModel; } });
+Object.defineProperty(exports, "getValidSubmodulesForModel", { enumerable: true, get: function () { return constants_1.getValidSubmodulesForModel; } });
+Object.defineProperty(exports, "getModelsForModule", { enumerable: true, get: function () { return constants_1.getModelsForModule; } });
+Object.defineProperty(exports, "getCombinationsForModel", { enumerable: true, get: function () { return constants_1.getCombinationsForModel; } });
+Object.defineProperty(exports, "createValidatedModelSchema", { enumerable: true, get: function () { return constants_1.createValidatedModelSchema; } });
+// Error classes
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "ZudelloError", { enumerable: true, get: function () { return errors_1.ZudelloError; } });
+Object.defineProperty(exports, "ZudelloConfigurationError", { enumerable: true, get: function () { return errors_1.ZudelloConfigurationError; } });
+Object.defineProperty(exports, "ZudelloAuthenticationError", { enumerable: true, get: function () { return errors_1.ZudelloAuthenticationError; } });
+Object.defineProperty(exports, "ZudelloPermissionError", { enumerable: true, get: function () { return errors_1.ZudelloPermissionError; } });
+Object.defineProperty(exports, "ZudelloNotFoundError", { enumerable: true, get: function () { return errors_1.ZudelloNotFoundError; } });
+Object.defineProperty(exports, "ZudelloValidationError", { enumerable: true, get: function () { return errors_1.ZudelloValidationError; } });
+Object.defineProperty(exports, "ZudelloAPIError", { enumerable: true, get: function () { return errors_1.ZudelloAPIError; } });
+Object.defineProperty(exports, "ZudelloNetworkError", { enumerable: true, get: function () { return errors_1.ZudelloNetworkError; } });
+Object.defineProperty(exports, "ZudelloRateLimitError", { enumerable: true, get: function () { return errors_1.ZudelloRateLimitError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AAEH,cAAc;AACd,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AAEtB,gCAAgC;AAChC,yCAmCqB;AAlCnB,gDAAgD;AAChD,mGAAA,MAAM,OAAA;AACN,oGAAA,OAAO,OAAA;AACP,uGAAA,UAAU,OAAA;AACV,wGAAA,WAAW,OAAA;AACX,+CAA+C;AAC/C,2GAAA,cAAc,OAAA;AACd,4GAAA,eAAe,OAAA;AACf,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,qBAAqB;AACrB,uHAAA,0BAA0B,OAAA;AAC1B,cAAc;AACd,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AACtB,uBAAuB;AACvB,yGAAA,YAAY,OAAA;AACZ,0GAAA,aAAa,OAAA;AACb,6GAAA,gBAAgB,OAAA;AAChB,6GAAA,gBAAgB,OAAA;AAChB,+GAAA,kBAAkB,OAAA;AAClB,oHAAA,uBAAuB,OAAA;AACvB,uHAAA,0BAA0B,OAAA;AAC1B,+GAAA,kBAAkB,OAAA;AAClB,oHAAA,uBAAuB,OAAA;AACvB,uHAAA,0BAA0B,OAAA;AAS5B,gBAAgB;AAChB,mCAUkB;AAThB,sGAAA,YAAY,OAAA;AACZ,mHAAA,yBAAyB,OAAA;AACzB,oHAAA,0BAA0B,OAAA;AAC1B,gHAAA,sBAAsB,OAAA;AACtB,8GAAA,oBAAoB,OAAA;AACpB,gHAAA,sBAAsB,OAAA;AACtB,yGAAA,eAAe,OAAA;AACf,6GAAA,mBAAmB,OAAA;AACnB,+GAAA,qBAAqB,OAAA"}

package/dist/cjs/modules/approvals.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Approvals Module
+ *
+ * Methods for managing approval workflows and bulk approval operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApprovalsModule = void 0;
+/**
+ * Approval workflow operations for Zudello.
+ */
+class ApprovalsModule {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Bulk approve or reject milestones.
+     *
+     * @example
+     * const result = await client.approvals.bulkApproveMilestones([
+     *     { resource_model: 'Transaction', resource_uuid: 'inv-uuid-1', status: 'APPROVED' },
+     *     { resource_model: 'Transaction', resource_uuid: 'inv-uuid-2', status: 'APPROVED' },
+     *     { resource_model: 'Transaction', resource_uuid: 'inv-uuid-3', status: 'REJECTED', reason: 'Invalid amount' }
+     * ]);
+     */
+    async bulkApproveMilestones(items) {
+        const response = await this.http.request('POST', '/team-data/v1/approval/milestones/bulk', { items });
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Bulk approval failed' };
+        }
+        return { success: true, data: response };
+    }
+    /**
+     * Bulk send approval reminders.
+     *
+     * @example
+     * await client.approvals.bulkSendReminders(['inv-uuid-1', 'inv-uuid-2']);
+     */
+    async bulkSendReminders(resourceUuids) {
+        const response = await this.http.request('POST', '/team-data/v1/approval/reminders/bulk', { resource_uuids: resourceUuids });
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Failed to send reminders' };
+        }
+        return { success: true };
+    }
+    /**
+     * Get approval flows for a resource.
+     *
+     * @param model - The model name (e.g., 'Transaction')
+     * @param uuid - The resource UUID
+     */
+    async getFlows(model, uuid) {
+        const response = await this.http.request('GET', `/team-data/v1/approval/flows?model=${encodeURIComponent(model)}&uuid=${encodeURIComponent(uuid)}`);
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Failed to get approval flows' };
+        }
+        return { success: true, data: response.data ?? [] };
+    }
+    /**
+     * Get user groups for the team.
+     *
+     * @example
+     * const groups = await client.approvals.getUserGroups({ userGroupType: 'APPROVAL' });
+     */
+    async getUserGroups(options = {}) {
+        const params = new URLSearchParams();
+        if (options.status)
+            params.set('status', options.status);
+        if (options.userGroupType)
+            params.set('user_group_type', options.userGroupType);
+        if (options.search)
+            params.set('search', options.search);
+        if (options.includeMemberIds)
+            params.set('include_member_ids', 'true');
+        if (options.limit)
+            params.set('limit', String(options.limit));
+        if (options.offset)
+            params.set('offset', String(options.offset));
+        if (options.namePattern)
+            params.set('name_pattern', options.namePattern);
+        const response = await this.http.request('GET', `/team-data/v1/user-groups/?${params.toString()}`);
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Failed to get user groups' };
+        }
+        return { success: true, data: response.data ?? [] };
+    }
+}
+exports.ApprovalsModule = ApprovalsModule;
+//# sourceMappingURL=approvals.js.map

package/dist/cjs/modules/approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../../src/modules/approvals.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAUH;;GAEG;AACH,MAAa,eAAe;IACG;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;OASG;IACH,KAAK,CAAC,qBAAqB,CACzB,KAAqB;QAErB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACtC,MAAM,EACN,wCAAwC,EACxC,EAAE,KAAK,EAAE,CACV,CAAC;QACF,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,IAAI,sBAAsB,EAAE,CAAC;QACjG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CACrB,aAAuB;QAEvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACtC,MAAM,EACN,uCAAuC,EACvC,EAAE,cAAc,EAAE,aAAa,EAAE,CAClC,CAAC;QACF,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,IAAI,0BAA0B,EAAE,CAAC;QACrG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,KAAa,EACb,IAAY;QAEZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACtC,KAAK,EACL,sCAAsC,kBAAkB,CAAC,KAAK,CAAC,SAAS,kBAAkB,CAAC,IAAI,CAAC,EAAE,CACnG,CAAC;QACF,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,IAAI,8BAA8B,EAAE,CAAC;QACzG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACjB,UAAgC,EAAE;QAElC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,aAAa;YAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAChF,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,gBAAgB;YAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,WAAW;YAAE,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACtC,KAAK,EACL,8BAA8B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAClD,CAAC;QACF,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,IAAI,2BAA2B,EAAE,CAAC;QACtG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IACtD,CAAC;CACF;AA9FD,0CA8FC"}