@ptkl/sdk 1.10.0 → 1.12.0

package/dist/v0.10/index.esm.js

@@ -112,73 +112,60 @@ class Component extends PlatformBaseClient {
         super();
         this.ref = ref;
     }
-    /**
-     * Find method to search for models
-     *
-     * @param {FindParams} filters - The filters to apply to the search
-     * @param {FindOptions} opts - The options to apply to the search
-     *
-     * @returns {Promise<FindResponse>} - The result of the search
-     *
-     * @example
-     * platform.component(name).find({
-     *     currentPage: 1,
-     *     perPage: 10,
-     * })
-     *
-     * // advanced search
-     * platform.component(name).find({
-     *     $adv: {
-     *         name: "John Doe",
-     *     }
-     * )
-     **/
-    async find(filters, opts) {
-        var _a;
-        let payload = {
-            context: filters,
-            ref: this.ref,
-        };
-        let ctx = payload.context;
-        let offset = ctx.currentPage;
-        if (offset == undefined) {
-            offset = 0;
-        }
-        let limit = ctx.perPage;
-        if (limit == undefined || limit == -1) {
-            limit = 10;
-        }
-        let sortDesc = 1;
-        if (ctx.sortDesc) {
-            sortDesc = -1;
-        }
-        if (ctx.filterOn === undefined) {
-            ctx.filterOn = [];
-        }
-        let params = {
-            offset: offset,
-            sortBy: ctx.sortBy,
-            sortDesc: sortDesc,
-            filter: ctx.filter,
-            filterOn: ctx.filterOn,
-            limit: limit,
-            dateFrom: ctx.dateFrom,
-            dateTo: ctx.dateTo,
-            dateField: ctx.dateField,
-        };
-        if (ctx.only && ctx.only.length > 0) {
-            params.only = ctx.only;
-        }
-        if (Object.keys(ctx.$adv || []).length > 0) {
-            params.$adv = [(_a = ctx.$adv) !== null && _a !== void 0 ? _a : {}];
-        }
-        if (ctx.$aggregate && ctx.$aggregate.length > 0) {
-            params.$aggregate = ctx.$aggregate;
+    find(filters, opts) {
+        if (opts && opts.stream === true) {
+            let onMetaCallback = () => { };
+            let onDataCallback = () => { };
+            let onErrorCallback;
+            let onEndCallback;
+            let isFirstLine = true;
+            const chainable = {
+                onMeta: (callback) => {
+                    onMetaCallback = callback;
+                    return chainable;
+                },
+                onData: (callback) => {
+                    onDataCallback = callback;
+                    return chainable;
+                },
+                onError: (callback) => {
+                    onErrorCallback = callback;
+                    return chainable;
+                },
+                onEnd: (callback) => {
+                    onEndCallback = callback;
+                    return chainable;
+                },
+                stream: () => {
+                    const body = this._buildFindBody(filters, opts);
+                    const handler = {
+                        onData: async (doc) => {
+                            if (isFirstLine) {
+                                isFirstLine = false;
+                                const result = onMetaCallback(doc);
+                                if (result instanceof Promise)
+                                    await result;
+                            }
+                            else {
+                                const result = onDataCallback(doc);
+                                if (result instanceof Promise)
+                                    await result;
+                            }
+                        },
+                        onError: onErrorCallback,
+                        onEnd: onEndCallback,
+                    };
+                    return this._streamNDJSON(`/v4/system/component/${this.ref}/models/stream`, {
+                        'Accept': 'application/x-ndjson',
+                        'Content-Type': 'application/json',
+                        'Accept-Language': (opts === null || opts === void 0 ? void 0 : opts.locale) || 'en_US',
+                    }, handler, body);
+                }
+            };
+            return chainable;
         }
-        return await this.client.post(`/v4/system/component/${this.ref}/models`, {
-            ...params,
-            options: opts
-        }, {
+        const body = this._buildFindBody(filters, opts);
+        return this.client.post(`/v4/system/component/${this.ref}/models`, body, {
             headers: {
                 "Accept-Language": (opts === null || opts === void 0 ? void 0 : opts.locale) || "en_US",
             }
@@ -207,6 +194,34 @@ class Component extends PlatformBaseClient {
         }
         return null;
     }
+    /** @private Build the POST body shared by `find` (streaming and non-streaming) */
+    _buildFindBody(filters, opts) {
+        var _a, _b;
+        let ctx = { ...filters };
+        let offset = (_a = ctx.currentPage) !== null && _a !== void 0 ? _a : 0;
+        let limit = (ctx.perPage == null || ctx.perPage === -1) ? 10 : ctx.perPage;
+        let sortDesc = ctx.sortDesc ? -1 : 1;
+        if (ctx.filterOn === undefined)
+            ctx.filterOn = [];
+        const params = {
+            offset,
+            sortBy: ctx.sortBy,
+            sortDesc,
+            filter: ctx.filter,
+            filterOn: ctx.filterOn,
+            limit,
+            dateFrom: ctx.dateFrom,
+            dateTo: ctx.dateTo,
+            dateField: ctx.dateField,
+        };
+        if (ctx.only && ctx.only.length > 0)
+            params.only = ctx.only;
+        if (Object.keys(ctx.$adv || {}).length > 0)
+            params.$adv = [(_b = ctx.$adv) !== null && _b !== void 0 ? _b : {}];
+        if (ctx.$aggregate && ctx.$aggregate.length > 0)
+            params.$aggregate = ctx.$aggregate;
+        return { ...params, options: opts };
+    }
     /**
      * Get model by uuid
      *
@@ -1273,6 +1288,7 @@ class Workflow extends PlatformBaseClient {
 }
 
 class Forge extends PlatformBaseClient {
+    // --- Management (appservice) ---
     async bundleUpload(buffer) {
         return await this.client.post(`/luma/appservice/v1/forge/upload`, buffer, {
             headers: {
@@ -1290,6 +1306,170 @@ class Forge extends PlatformBaseClient {
     async list() {
         return await this.client.get(`/luma/appservice/v1/forge`);
     }
+    async listServices(ref) {
+        return await this.client.get(`/luma/appservice/v1/forge/${ref}/services`);
+    }
+    // --- Variables ---
+    async getVariables(ref) {
+        return await this.client.get(`/luma/appservice/v1/forge/${ref}/variables`);
+    }
+    async updateVariables(ref, variables) {
+        return await this.client.patch(`/luma/appservice/v1/forge/${ref}/variables`, variables);
+    }
+    async addVariable(ref, key, value) {
+        var _a;
+        const resp = await this.client.get(`/luma/appservice/v1/forge/${ref}/variables`);
+        const current = (_a = resp.data) !== null && _a !== void 0 ? _a : {};
+        current[key] = value;
+        return await this.client.patch(`/luma/appservice/v1/forge/${ref}/variables`, current);
+    }
+    // --- Service execution (forge-runtime) ---
+    async callService(appUuid, serviceName, options) {
+        var _a;
+        const queryString = (options === null || options === void 0 ? void 0 : options.query)
+            ? '?' + new URLSearchParams(options.query).toString()
+            : '';
+        return await this.client.post(`/luma/forge-runtime/api/services/${appUuid}/${serviceName}${queryString}`, (_a = options === null || options === void 0 ? void 0 : options.body) !== null && _a !== void 0 ? _a : {}, (options === null || options === void 0 ? void 0 : options.headers) ? { headers: options.headers } : undefined);
+    }
+}
+
+const BASE = '/luma/kortex/v1';
+class Kortex extends PlatformBaseClient {
+    // ── Agents ──
+    async createAgent(data) {
+        return await this.client.post(`${BASE}/agents`, data);
+    }
+    async listAgents(params) {
+        return await this.client.get(`${BASE}/agents`, { params });
+    }
+    async getAgent(uuid) {
+        return await this.client.get(`${BASE}/agents/${uuid}`);
+    }
+    async updateAgent(uuid, data) {
+        return await this.client.patch(`${BASE}/agents/${uuid}`, data);
+    }
+    async deleteAgent(uuid) {
+        return await this.client.delete(`${BASE}/agents/${uuid}`);
+    }
+    async listAgentKnowledgeBases(agentUUID) {
+        return await this.client.get(`${BASE}/agents/${agentUUID}/knowledge-bases`);
+    }
+    // ── Knowledge Bases ──
+    async createKnowledgeBase(data) {
+        return await this.client.post(`${BASE}/knowledge-bases`, data);
+    }
+    async listKnowledgeBases(params) {
+        return await this.client.get(`${BASE}/knowledge-bases`, { params });
+    }
+    async getKnowledgeBase(uuid) {
+        return await this.client.get(`${BASE}/knowledge-bases/${uuid}`);
+    }
+    async updateKnowledgeBase(uuid, data) {
+        return await this.client.put(`${BASE}/knowledge-bases/${uuid}`, data);
+    }
+    async deleteKnowledgeBase(uuid) {
+        return await this.client.delete(`${BASE}/knowledge-bases/${uuid}`);
+    }
+    // ── Documents ──
+    async listDocuments(kbUUID, params) {
+        return await this.client.get(`${BASE}/knowledge-bases/${kbUUID}/documents`, { params });
+    }
+    async uploadDocument(kbUUID, formData) {
+        return await this.client.post(`${BASE}/knowledge-bases/${kbUUID}/documents`, formData, {
+            headers: { 'Content-Type': 'multipart/form-data' },
+            timeout: 120000,
+        });
+    }
+    async getDocument(kbUUID, uuid) {
+        return await this.client.get(`${BASE}/knowledge-bases/${kbUUID}/documents/${uuid}`);
+    }
+    async deleteDocument(kbUUID, uuid) {
+        return await this.client.delete(`${BASE}/knowledge-bases/${kbUUID}/documents/${uuid}`);
+    }
+    async retryDocument(kbUUID, uuid) {
+        return await this.client.post(`${BASE}/knowledge-bases/${kbUUID}/documents/${uuid}/retry`);
+    }
+    // ── Conversations ──
+    async createConversation(data) {
+        return await this.client.post(`${BASE}/conversations`, data);
+    }
+    async listConversations(params) {
+        return await this.client.get(`${BASE}/conversations`, { params });
+    }
+    async getConversation(uuid) {
+        return await this.client.get(`${BASE}/conversations/${uuid}`);
+    }
+    async updateConversation(uuid, data) {
+        return await this.client.put(`${BASE}/conversations/${uuid}`, data);
+    }
+    async deleteConversation(uuid) {
+        return await this.client.delete(`${BASE}/conversations/${uuid}`);
+    }
+    async archiveConversation(uuid) {
+        return await this.client.post(`${BASE}/conversations/${uuid}/archive`);
+    }
+    async unarchiveConversation(uuid) {
+        return await this.client.post(`${BASE}/conversations/${uuid}/unarchive`);
+    }
+    async addParticipant(conversationUUID, data) {
+        return await this.client.post(`${BASE}/conversations/${conversationUUID}/participants`, data);
+    }
+    async removeParticipant(conversationUUID, agentUUID) {
+        return await this.client.delete(`${BASE}/conversations/${conversationUUID}/participants/${agentUUID}`);
+    }
+    // ── Messages / Completions ──
+    async sendMessage(conversationUUID, data) {
+        return await this.client.post(`${BASE}/conversations/${conversationUUID}/messages`, data);
+    }
+    async streamMessage(conversationUUID, data) {
+        return await this.client.post(`${BASE}/conversations/${conversationUUID}/messages`, { ...data, stream: true }, {
+            responseType: 'stream',
+            timeout: 120000,
+        });
+    }
+    async listMessages(conversationUUID, params) {
+        return await this.client.get(`${BASE}/conversations/${conversationUUID}/messages`, { params });
+    }
+    async injectMessage(conversationUUID, data) {
+        return await this.client.post(`${BASE}/conversations/${conversationUUID}/messages/inject`, data);
+    }
+    // ── OCR ──
+    async ocr(data) {
+        return await this.client.post(`${BASE}/ocr`, data, { timeout: 120000 });
+    }
+    // ── User Access ──
+    async createUserAccess(data) {
+        return await this.client.post(`${BASE}/user-access`, data);
+    }
+    async listUserAccess(params) {
+        return await this.client.get(`${BASE}/user-access`, { params });
+    }
+    async getUserAccess(uuid) {
+        return await this.client.get(`${BASE}/user-access/${uuid}`);
+    }
+    async updateUserAccess(uuid, data) {
+        return await this.client.patch(`${BASE}/user-access/${uuid}`, data);
+    }
+    async deleteUserAccess(uuid) {
+        return await this.client.delete(`${BASE}/user-access/${uuid}`);
+    }
+    async getUserMonthlyUsage(uuid, params) {
+        return await this.client.get(`${BASE}/user-access/${uuid}/usage`, { params });
+    }
+    async getUserUsageBreakdown(uuid) {
+        return await this.client.get(`${BASE}/user-access/${uuid}/usage/breakdown`);
+    }
+    async getMyAccess() {
+        return await this.client.get(`${BASE}/my-access`);
+    }
+    // ── Usage (Admin) ──
+    async listUsage(params) {
+        return await this.client.get(`${BASE}/usage`, { params });
+    }
+    // ── Tier ──
+    async getTier() {
+        return await this.client.get(`${BASE}/tier`);
+    }
 }
 
 class Project extends PlatformBaseClient {
@@ -1516,6 +1696,9 @@ class Platform extends PlatformBaseClient {
     forge() {
         return (new Forge()).setClient(this.client);
     }
+    kortex() {
+        return (new Kortex()).setClient(this.client);
+    }
     component(ref) {
         return (new Component(ref)).setClient(this.client);
     }
@@ -1882,6 +2065,12 @@ class DMS extends IntegrationsBaseClient {
     async generateDocument(payload) {
         return this.requestv2('POST', 'documents/document/generate', { data: payload });
     }
+    async listDocumentRevisions(path) {
+        return this.requestv2('GET', `documents/revisions/${path}`);
+    }
+    async getDocumentRevision(path, version) {
+        return this.requestv2('GET', `documents/revision/${path}`, { params: { version } });
+    }
     async fillPdf(data) {
         const { input_path, output_path, output_pdf = false, output_type, output_file_name, replace, form_data, forms } = data;
         const responseType = output_pdf ? 'arraybuffer' : 'json';
@@ -3428,6 +3617,45 @@ class Ecommerce extends IntegrationsBaseClient {
     }
 }
 
+class Timber extends IntegrationsBaseClient {
+    async query(params = {}) {
+        const { data } = await this.client.get("/v1/timber/logs", {
+            params: this.normalizeParams(params),
+        });
+        return data;
+    }
+    async write(payload) {
+        const { data } = await this.client.post("/v1/timber/logs", payload);
+        return data;
+    }
+    async usage() {
+        const { data } = await this.client.get("/v1/timber/usage");
+        return data;
+    }
+    async debug(message, payload) {
+        return this.write({ ...payload, message, level: 'debug' });
+    }
+    async info(message, payload) {
+        return this.write({ ...payload, message, level: 'info' });
+    }
+    async warn(message, payload) {
+        return this.write({ ...payload, message, level: 'warn' });
+    }
+    async error(message, payload) {
+        return this.write({ ...payload, message, level: 'error' });
+    }
+    normalizeParams(params) {
+        const normalized = { ...params };
+        if (params.from instanceof Date) {
+            normalized.from = params.from.toISOString();
+        }
+        if (params.to instanceof Date) {
+            normalized.to = params.to.toISOString();
+        }
+        return normalized;
+    }
+}
+
 class Integrations extends IntegrationsBaseClient {
     constructor(options) {
         super(options);
@@ -3439,6 +3667,7 @@ class Integrations extends IntegrationsBaseClient {
             'protokol-payments': new Payments().setClient(this.client),
             'protokol-minimax': new Minimax().setClient(this.client),
             'protokol-ecommerce': new Ecommerce().setClient(this.client),
+            'protokol-timber': new Timber().setClient(this.client),
         };
     }
     getDMS() {
@@ -3465,6 +3694,9 @@ class Integrations extends IntegrationsBaseClient {
     getEcommerce() {
         return this.getInterfaceOf('protokol-ecommerce');
     }
+    getTimber() {
+        return this.getInterfaceOf('protokol-timber');
+    }
     async list() {
         const { data } = await this.client.get("/v1/integrations");
         return data;
@@ -3639,4 +3871,4 @@ class Invoicing extends PlatformBaseClient {
     }
 }
 
-export { APIUser, Apps, Component, ComponentUtils, Config, DMS, Ecommerce, Forge, Functions, Integrations as Integration, Integrations, Invoicing, Mail, NBS, PRN, Payments, Platform, Project, Ratchet, Sandbox, MinFin as SerbiaMinFin, System, Thunder, Users, VPFR, Workflow, parsePRN };
+export { APIUser, Apps, Component, ComponentUtils, Config, DMS, Ecommerce, Forge, Functions, Integrations as Integration, Integrations, Invoicing, Kortex, Mail, NBS, PRN, Payments, Platform, Project, Ratchet, Sandbox, MinFin as SerbiaMinFin, System, Thunder, Timber, Users, VPFR, Workflow, parsePRN };

package/dist/v0.10/types/component.d.ts

@@ -18,6 +18,7 @@ type FindOptions = {
     buildTTL?: number;
     locale?: string;
     unmaskPasswords?: boolean;
+    stream?: boolean;
 };
 type FindResponse = {
     items: Model[];
@@ -48,6 +49,29 @@ type AggregateChainable = {
     then: <T>(resolve?: (value: any) => T, reject?: (error: any) => any) => Promise<T>;
     catch: (reject: (error: any) => any) => Promise<any>;
 };
+/**
+ * Pagination metadata emitted as the first NDJSON line from findStream
+ */
+type FindStreamMeta = {
+    total: number;
+    total_filtered: number;
+    total_pages: number;
+    page: number;
+};
+/**
+ * Callback invoked once with pagination metadata before any records
+ */
+type FindStreamMetaCallback = (meta: FindStreamMeta) => void | Promise<void>;
+/**
+ * Chainable find stream result for cursor-based NDJSON pagination
+ */
+type FindChainable = {
+    onMeta: (callback: FindStreamMetaCallback) => FindChainable;
+    onData: (callback: StreamCallback) => FindChainable;
+    onError: (callback: (error: Error) => void) => FindChainable;
+    onEnd: (callback: () => void) => FindChainable;
+    stream: () => Promise<void>;
+};
 type FindAdvancedParams = {
     [key: string]: any;
 };
@@ -410,4 +434,4 @@ type SetupData = {
     settings?: Settings;
 };
 type ComponentCreateResponse = ComponentListItem;
-export { FindParams, FindOptions, FindResponse, FindAdvancedParams, FindAggregateParams, Model, UpdateOptions, ModifyOptions, UpdateOperators, UpdateAggregate, ModelUpdateData, ComponentOptions, ComponentListResponse, ComponentListItem, ComponentLabel, ComponentWorkspace, StreamCallback, StreamHandler, AggregateChainable, UpdateManyOptions, CreateManyOptions, Settings, SettingsField, FieldRoles, FieldConstraints, Context, Preset, PresetContext, Filters, Function, Extension, Policy, FieldAccessConfig, TemplatesDist, SetupData, ComponentCreateResponse, };
+export { FindParams, FindOptions, FindResponse, FindAdvancedParams, FindAggregateParams, Model, UpdateOptions, ModifyOptions, UpdateOperators, UpdateAggregate, ModelUpdateData, ComponentOptions, ComponentListResponse, ComponentListItem, ComponentLabel, ComponentWorkspace, StreamCallback, StreamHandler, AggregateChainable, FindChainable, FindStreamMeta, FindStreamMetaCallback, UpdateManyOptions, CreateManyOptions, Settings, SettingsField, FieldRoles, FieldConstraints, Context, Preset, PresetContext, Filters, Function, Extension, Policy, FieldAccessConfig, TemplatesDist, SetupData, ComponentCreateResponse, };

package/dist/v0.10/types/integrations.d.ts

@@ -339,3 +339,9 @@ export type DocumentGenerateResponse = {
     /** Rendered document content */
     content: string;
 };
+export type DocumentRevisionItem = {
+    version: string;
+    documentVersion: number;
+    updatedBy: DocumentAuditEntry;
+};
+export type DocumentRevisionListResponse = DocumentRevisionItem[];