zudello-chat-sdk 0.1.1

package/dist/esm/modules/users.js

@@ -0,0 +1,116 @@
+/**
+ * Users Module
+ *
+ * Methods for managing team users, notifications, and language settings.
+ */
+/**
+ * Team user operations for Zudello.
+ */
+export 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 };
+    }
+}
+//# sourceMappingURL=users.js.map

package/dist/esm/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/esm/types.js

@@ -0,0 +1,7 @@
+/**
+ * Zudello SDK Types
+ *
+ * TypeScript interfaces for all SDK operations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

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

package/dist/types/client.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 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 { 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';
+import type { ZudelloClientConfig } from './types';
+/**
+ * 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 declare class ZudelloClient {
+    /** Search and fetch operations */
+    readonly search: SearchModule;
+    /** Resource CRUD and batch operations */
+    readonly resources: ResourcesModule;
+    /** Model introspection */
+    readonly models: ModelsModule;
+    /** Configuration, field settings, statuses, document types */
+    readonly config: ConfigModule;
+    /** Sentences (automation rules) */
+    readonly sentences: SentencesModule;
+    /** Scripts, triggers, and execution logs */
+    readonly automation: AutomationModule;
+    /** Approval workflows and bulk operations */
+    readonly approvals: ApprovalsModule;
+    /** Team users, notifications, language settings */
+    readonly users: UsersModule;
+    /** Organisation-level admin (requires privileges) */
+    readonly org: OrgModule;
+    /** Datasets (lookup tables, DOAs) */
+    readonly datasets: DatasetsModule;
+    /** Export templates and data exports */
+    readonly exports: ExportsModule;
+    /** Quick actions */
+    readonly quickActions: QuickActionsModule;
+    /** Inboxes, budgets, contracts, messages */
+    readonly inboxes: InboxesModule;
+    constructor(config?: ZudelloClientConfig);
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,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;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAa;IACxB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAEpC,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAEpC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAEtC,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAEpC,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IAExB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,oBAAoB;IACpB,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAE1C,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,MAAM,CAAC,EAAE,mBAAmB;CAiBzC"}