zudello-chat-sdk 0.1.1

package/dist/cjs/modules/users.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Users Module
+ *
+ * Methods for managing team users, notifications, and language settings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsersModule = void 0;
+/**
+ * Team user operations for Zudello.
+ */
+class UsersModule {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Get users for the team.
+     *
+     * @example
+     * const users = await client.users.list({ status: 'ACTIVE' });
+     */
+    async list(options = {}) {
+        const params = new URLSearchParams();
+        if (options.status)
+            params.set('status', options.status);
+        if (options.search)
+            params.set('search', options.search);
+        if (options.namePattern)
+            params.set('name_pattern', options.namePattern);
+        if (options.emailDomain)
+            params.set('email_domain', options.emailDomain);
+        if (options.limit)
+            params.set('limit', String(options.limit));
+        if (options.offset)
+            params.set('offset', String(options.offset));
+        const response = await this.http.request('GET', `/team-data/v1/users/?${params.toString()}`);
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Failed to list users' };
+        }
+        return { success: true, data: response.data ?? [] };
+    }
+    /**
+     * Get available notification types.
+     */
+    async getNotificationTypes() {
+        const response = await this.http.request('GET', '/team-data/v1/notification/user/notification_types');
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Failed to get notification types' };
+        }
+        return { success: true, data: response.data ?? [] };
+    }
+    /**
+     * Get notification preferences for a user.
+     */
+    async getNotificationPreferences(userUuid) {
+        const response = await this.http.request('GET', `/team-data/v1/notification/user/preferences?user_uuid=${encodeURIComponent(userUuid)}`);
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Failed to get notification preferences' };
+        }
+        return { success: true, data: response.data ?? [] };
+    }
+    /**
+     * Update notification preferences.
+     */
+    async updateNotificationPreferences(preferences) {
+        const response = await this.http.request('POST', '/team-data/v1/notification/user/preferences', preferences);
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Failed to update notification preferences' };
+        }
+        return { success: true, data: response.data ?? [] };
+    }
+    /**
+     * Get language placeholders.
+     */
+    async getLanguagePlaceholders() {
+        const params = new URLSearchParams({
+            resource_type: 'language_placeholders',
+            team_uuid: this.http.config.teamId,
+        });
+        const response = await this.http.request('GET', `/general-store/api/v1/resources/?${params.toString()}`);
+        if (response.success === false) {
+            return { success: false, error: response.message || response.error || 'Failed to get language placeholders' };
+        }
+        const resource = response.data?.[0];
+        return { success: true, data: resource?.payload?.lang ?? {} };
+    }
+    /**
+     * Update language placeholders.
+     */
+    async updateLanguagePlaceholders(placeholders) {
+        // First get the existing resource to get its UUID
+        const params = new URLSearchParams({
+            resource_type: 'language_placeholders',
+            team_uuid: this.http.config.teamId,
+        });
+        const existing = await this.http.request('GET', `/general-store/api/v1/resources/?${params.toString()}`);
+        if (existing.success === false) {
+            return { success: false, error: existing.message || existing.error || 'Failed to get existing language placeholders' };
+        }
+        const resource = existing.data?.[0];
+        if (resource?.uuid) {
+            // Update existing
+            const updateResponse = await this.http.request('PUT', `/general-store/api/v1/resources/${resource.uuid}?resource_type=language_placeholders`, { payload: { lang: placeholders }, team_uuid: this.http.config.teamId, uuid: resource.uuid });
+            if (updateResponse.success === false) {
+                return { success: false, error: updateResponse.message || updateResponse.error || 'Failed to update language placeholders' };
+            }
+        }
+        else {
+            // Create new
+            const createResponse = await this.http.request('POST', `/general-store/api/v1/resources/?resource_type=language_placeholders`, { payload: { lang: placeholders }, team_uuid: this.http.config.teamId });
+            if (createResponse.success === false) {
+                return { success: false, error: createResponse.message || createResponse.error || 'Failed to create language placeholders' };
+            }
+        }
+        return { success: true };
+    }
+}
+exports.UsersModule = UsersModule;
+//# sourceMappingURL=users.js.map

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

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

package/dist/cjs/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Zudello SDK Types
+ *
+ * TypeScript interfaces for all SDK operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/esm/client.js

@@ -0,0 +1,120 @@
+/**
+ * Zudello SDK Client
+ *
+ * Main client class for interacting with the Zudello API.
+ * Designed for use in E2B sandboxes with environment variable configuration.
+ *
+ * @example
+ * import { ZudelloClient } 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: 'Transaction',
+ *     module: 'PURCHASING',
+ *     submodule: 'INVOICE',
+ *     filter: { status: 'REVIEW' }
+ * });
+ *
+ * // 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 Corp', code: 'SUP-001' }
+ * });
+ *
+ * // Organisation-level admin (requires privileges)
+ * const users = await client.org.listUsers();
+ */
+import { HttpClient } from './http/client';
+import { SearchModule } from './modules/search';
+import { ResourcesModule } from './modules/resources';
+import { ModelsModule } from './modules/models';
+import { ConfigModule } from './modules/config';
+import { SentencesModule } from './modules/sentences';
+import { AutomationModule } from './modules/automation';
+import { ApprovalsModule } from './modules/approvals';
+import { UsersModule } from './modules/users';
+import { OrgModule } from './modules/org';
+import { DatasetsModule } from './modules/datasets';
+import { ExportsModule } from './modules/exports';
+import { QuickActionsModule } from './modules/quick-actions';
+import { InboxesModule } from './modules/inboxes';
+/**
+ * Main client for the Zudello API.
+ *
+ * Configuration is read from environment variables by default:
+ * - `ZUDELLO_TOKEN`: Authentication token (required)
+ * - `ZUDELLO_ORG_ID`: Organization UUID (required)
+ * - `ZUDELLO_TEAM_ID`: Team UUID (required)
+ * - `ZUDELLO_CLUSTER_URL`: API cluster URL (required)
+ * - `ZUDELLO_AUTH_API_BASE`: Auth API base URL (required)
+ * - `ZUDELLO_USER_ID`: User UUID (optional)
+ * - `ZUDELLO_USER_EMAIL`: User email (optional)
+ *
+ * @throws {ZudelloConfigurationError} If required configuration is missing
+ *
+ * @example
+ * // Auto-configured from environment
+ * const client = new ZudelloClient();
+ *
+ * // Or explicit configuration
+ * const client = new ZudelloClient({
+ *     token: 'your-token',
+ *     organizationId: 'org-uuid',
+ *     teamId: 'team-uuid',
+ *     clusterUrl: 'api.1.global.zudello.io',
+ *     authApiBase: 'https://auth.zudello.io'
+ * });
+ */
+export class ZudelloClient {
+    /** Search and fetch operations */
+    search;
+    /** Resource CRUD and batch operations */
+    resources;
+    /** Model introspection */
+    models;
+    /** Configuration, field settings, statuses, document types */
+    config;
+    /** Sentences (automation rules) */
+    sentences;
+    /** Scripts, triggers, and execution logs */
+    automation;
+    /** Approval workflows and bulk operations */
+    approvals;
+    /** Team users, notifications, language settings */
+    users;
+    /** Organisation-level admin (requires privileges) */
+    org;
+    /** Datasets (lookup tables, DOAs) */
+    datasets;
+    /** Export templates and data exports */
+    exports;
+    /** Quick actions */
+    quickActions;
+    /** Inboxes, budgets, contracts, messages */
+    inboxes;
+    constructor(config) {
+        const http = new HttpClient(config);
+        this.search = new SearchModule(http);
+        this.resources = new ResourcesModule(http);
+        this.models = new ModelsModule(http);
+        this.config = new ConfigModule(http);
+        this.sentences = new SentencesModule(http);
+        this.automation = new AutomationModule(http);
+        this.approvals = new ApprovalsModule(http);
+        this.users = new UsersModule(http);
+        this.org = new OrgModule(http);
+        this.datasets = new DatasetsModule(http);
+        this.exports = new ExportsModule(http);
+        this.quickActions = new QuickActionsModule(http);
+        this.inboxes = new InboxesModule(http);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIlD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,aAAa;IACxB,kCAAkC;IACzB,MAAM,CAAe;IAE9B,yCAAyC;IAChC,SAAS,CAAkB;IAEpC,0BAA0B;IACjB,MAAM,CAAe;IAE9B,8DAA8D;IACrD,MAAM,CAAe;IAE9B,mCAAmC;IAC1B,SAAS,CAAkB;IAEpC,4CAA4C;IACnC,UAAU,CAAmB;IAEtC,6CAA6C;IACpC,SAAS,CAAkB;IAEpC,mDAAmD;IAC1C,KAAK,CAAc;IAE5B,qDAAqD;IAC5C,GAAG,CAAY;IAExB,qCAAqC;IAC5B,QAAQ,CAAiB;IAElC,wCAAwC;IAC/B,OAAO,CAAgB;IAEhC,oBAAoB;IACX,YAAY,CAAqB;IAE1C,4CAA4C;IACnC,OAAO,CAAgB;IAEhC,YAAY,MAA4B;QACtC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;CACF"}