@ptkl/sdk 1.5.3 → 1.6.0

package/README.md

@@ -13,4 +13,33 @@ const platform = new Platform({
 
 // now you can
 const results = await platform.function().run("hello_world", {text: "Hi!"})
+```
+
+### Component Query Options (beta)
+
+For the beta SDK export (`@ptkl/sdk/beta`), component model reads support:
+
+- `cacheTTL` (number, seconds) in `find` options
+- `only` (string[]) field projection in `find` filters
+
+```ts
+const resp = await platform.component("ecommerce::orders").find(
+    {
+        currentPage: 1,
+        perPage: 20,
+        only: ["uuid", "status", "total"],
+    },
+    {
+        cacheTTL: 0, // force fresh read
+        locale: "en_US",
+    }
+)
+```
+
+### Thunder Projection (beta)
+
+Thunder read methods support optional `only` projection fields:
+
+```ts
+const row = await platform.thunder().findOne("user_settings", { user_id: 42 }, ["theme", "timezone"])
 ```

package/dist/index.0.10.js

@@ -78,6 +78,7 @@ var ProtokolSDK010 = (function (exports, axios) {
             const client = axios.create({
                 baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io",
                 timeout: 30000,
+                withCredentials: true,
                 headers: {
                     ...headers,
                     'Content-Type': 'application/json',
@@ -154,6 +155,13 @@ var ProtokolSDK010 = (function (exports, axios) {
                 dateTo: ctx.dateTo,
                 dateField: ctx.dateField,
             };
+            if (ctx.only && ctx.only.length > 0) {
+                params.only = ctx.only;
+            }
+            else if (ctx.includeFields && ctx.includeFields.length > 0) {
+                // Backward-compatible alias. The API now prefers `only`.
+                params.includeFields = ctx.includeFields;
+            }
             if (Object.keys(ctx.$adv || []).length > 0) {
                 params.$adv = [(_a = ctx.$adv) !== null && _a !== void 0 ? _a : {}];
             }
@@ -560,11 +568,122 @@ var ProtokolSDK010 = (function (exports, axios) {
             return await this.client.delete(`/v4/system/component/${this.ref}/${version}/policies/${name}`);
         }
         /**
-         * Internal method to handle NDJSON streaming responses
+         * Internal method to handle NDJSON streaming responses.
+         * Uses native fetch + ReadableStream in browser environments and
+         * Axios responseType:'stream' in Node.js environments.
          *
          * @private
          */
         async _streamNDJSON(url, headers, handler, body) {
+            const inBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
+            if (inBrowser) {
+                return this._streamNDJSONBrowser(url, headers, handler, body);
+            }
+            else {
+                return this._streamNDJSONNode(url, headers, handler, body);
+            }
+        }
+        /**
+         * Browser implementation: native fetch + ReadableStream (NDJSON).
+         * @private
+         */
+        async _streamNDJSONBrowser(url, headers, handler, body) {
+            var _a, _b;
+            try {
+                // Derive full URL from the axios instance's baseURL
+                const baseURL = ((_a = this.client.defaults.baseURL) !== null && _a !== void 0 ? _a : 'https://lemon.protokol.io').replace(/\/$/, '');
+                const fullURL = `${baseURL}${url}`;
+                // Collect auth/env headers from the axios instance defaults
+                const defaultHeaders = {};
+                const axDefaults = this.client.defaults.headers;
+                for (const [k, v] of Object.entries(axDefaults)) {
+                    if (typeof v === 'string')
+                        defaultHeaders[k] = v;
+                }
+                if (axDefaults.common && typeof axDefaults.common === 'object') {
+                    for (const [k, v] of Object.entries(axDefaults.common)) {
+                        if (typeof v === 'string')
+                            defaultHeaders[k] = v;
+                    }
+                }
+                const mergedHeaders = {
+                    'Content-Type': 'application/json',
+                    ...defaultHeaders,
+                    ...headers,
+                };
+                const response = await fetch(fullURL, {
+                    method: 'POST',
+                    headers: mergedHeaders,
+                    body: JSON.stringify(body),
+                    credentials: 'include',
+                });
+                if (!response.ok) {
+                    const err = new Error(`Aggregate stream failed: ${response.status} ${response.statusText}`);
+                    if (handler.onError)
+                        handler.onError(err);
+                    throw err;
+                }
+                if (!response.body) {
+                    if (handler.onEnd)
+                        handler.onEnd();
+                    return;
+                }
+                const reader = response.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) {
+                        if (buffer.trim()) {
+                            try {
+                                const document = JSON.parse(buffer);
+                                const result = handler.onData(document);
+                                if (result instanceof Promise) {
+                                    await result.catch((err) => { if (handler.onError)
+                                        handler.onError(err); });
+                                }
+                            }
+                            catch (err) {
+                                if (handler.onError)
+                                    handler.onError(err);
+                            }
+                        }
+                        if (handler.onEnd)
+                            handler.onEnd();
+                        break;
+                    }
+                    buffer += decoder.decode(value, { stream: true });
+                    const lines = buffer.split('\n');
+                    buffer = (_b = lines.pop()) !== null && _b !== void 0 ? _b : '';
+                    for (const line of lines) {
+                        if (!line.trim())
+                            continue;
+                        try {
+                            const document = JSON.parse(line);
+                            const result = handler.onData(document);
+                            if (result instanceof Promise) {
+                                await result.catch((err) => { if (handler.onError)
+                                    handler.onError(err); });
+                            }
+                        }
+                        catch (err) {
+                            if (handler.onError)
+                                handler.onError(err);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                if (handler.onError)
+                    handler.onError(err);
+                throw err;
+            }
+        }
+        /**
+         * Node.js implementation: Axios responseType:'stream' + EventEmitter API.
+         * @private
+         */
+        async _streamNDJSONNode(url, headers, handler, body) {
             try {
                 const config = {
                     headers,
@@ -576,61 +695,52 @@ var ProtokolSDK010 = (function (exports, axios) {
                 return new Promise((resolve, reject) => {
                     stream.on('data', (chunk) => {
                         buffer += chunk.toString();
-                        // Process complete lines (separated by newlines)
                         const lines = buffer.split('\n');
-                        buffer = lines.pop() || ''; // Keep incomplete line in buffer
+                        buffer = lines.pop() || '';
                         for (const line of lines) {
                             if (line.trim()) {
                                 try {
                                     const document = JSON.parse(line);
                                     const result = handler.onData(document);
-                                    // Support async callbacks
                                     if (result instanceof Promise) {
                                         result.catch((err) => {
-                                            if (handler.onError) {
+                                            if (handler.onError)
                                                 handler.onError(err);
-                                            }
                                         });
                                     }
                                 }
                                 catch (err) {
-                                    if (handler.onError) {
+                                    if (handler.onError)
                                         handler.onError(err);
-                                    }
                                 }
                             }
                         }
                     });
                     stream.on('end', () => {
-                        // Process any remaining data in buffer
                         if (buffer.trim()) {
                             try {
                                 const document = JSON.parse(buffer);
                                 handler.onData(document);
                             }
                             catch (err) {
-                                if (handler.onError) {
+                                if (handler.onError)
                                     handler.onError(err);
-                                }
                             }
                         }
-                        if (handler.onEnd) {
+                        if (handler.onEnd)
                             handler.onEnd();
-                        }
                         resolve();
                     });
                     stream.on('error', (err) => {
-                        if (handler.onError) {
+                        if (handler.onError)
                             handler.onError(err);
-                        }
                         reject(err);
                     });
                 });
             }
             catch (err) {
-                if (handler.onError) {
+                if (handler.onError)
                     handler.onError(err);
-                }
                 throw err;
             }
         }
@@ -834,12 +944,13 @@ var ProtokolSDK010 = (function (exports, axios) {
     }
 
     class Thunder extends PlatformBaseClient {
-        async read(type, filters, flag, options) {
+        async read(type, filters, flag, options, only) {
             return await this.client.post("/v3/system/thunder", {
                 type,
                 filters,
                 flag,
                 options,
+                only,
             });
         }
         async write(type, filters, d, flag) {
@@ -853,14 +964,14 @@ var ProtokolSDK010 = (function (exports, axios) {
         async operation(name, filters, data) {
             return await this.write(name, filters, data, "Operation");
         }
-        async find(name, filters) {
-            return await this.read(name, filters, "Find");
+        async find(name, filters, only) {
+            return await this.read(name, filters, "Find", undefined, only);
         }
-        async findOne(name, filters) {
-            return await this.read(name, filters, "FindOne");
+        async findOne(name, filters, only) {
+            return await this.read(name, filters, "FindOne", undefined, only);
         }
-        async paginate(name, filters, options) {
-            return await this.read(name, filters, "Paginate", options);
+        async paginate(name, filters, options, only) {
+            return await this.read(name, filters, "Paginate", options, only);
         }
         async upsert(name, filters, data) {
             return await this.write(name, filters, data, "Upsert");
@@ -1450,6 +1561,7 @@ var ProtokolSDK010 = (function (exports, axios) {
             const client = axios.create({
                 baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io/luma/integrations",
                 timeout: 30000,
+                withCredentials: true,
                 headers: {
                     ...headers,
                 },
@@ -1728,6 +1840,9 @@ var ProtokolSDK010 = (function (exports, axios) {
         async createDocumentComment(payload) {
             return this.requestv2('POST', 'documents/document/comment', { data: payload });
         }
+        async generateDocument(payload) {
+            return this.requestv2('POST', 'documents/document/generate', { data: payload });
+        }
         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';

package/dist/index.0.9.js

@@ -78,6 +78,7 @@ var ProtokolSDK09 = (function (exports, axios) {
             const client = axios.create({
                 baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io",
                 timeout: 30000,
+                withCredentials: true,
                 headers: {
                     ...headers,
                     'Content-Type': 'application/json',
@@ -1275,6 +1276,7 @@ var ProtokolSDK09 = (function (exports, axios) {
             const client = axios.create({
                 baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io/luma/integrations",
                 timeout: 30000,
+                withCredentials: true,
                 headers: {
                     ...headers,
                 }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ptkl/sdk",
-  "version": "1.5.3",
+  "version": "1.6.0",
   "scripts": {
     "build": "rollup -c",
     "build:monaco": "npm run build && node scripts/generate-monaco-types.cjs",

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

@@ -303,10 +303,22 @@ export default class Component<C extends string = string> extends PlatformBaseCl
      */
     deletePolicy(name: string, version: string): Promise<AxiosResponse<any, any>>;
     /**
-     * Internal method to handle NDJSON streaming responses
+     * Internal method to handle NDJSON streaming responses.
+     * Uses native fetch + ReadableStream in browser environments and
+     * Axios responseType:'stream' in Node.js environments.
      *
      * @private
      */
     private _streamNDJSON;
+    /**
+     * Browser implementation: native fetch + ReadableStream (NDJSON).
+     * @private
+     */
+    private _streamNDJSONBrowser;
+    /**
+     * Node.js implementation: Axios responseType:'stream' + EventEmitter API.
+     * @private
+     */
+    private _streamNDJSONNode;
 }
 export { FindParams, FindOptions, FindResponse, FindAdvancedParams, FindAggregateParams, Model, UpdateOptions, StreamHandler, AggregateChainable, ComponentOptions, Extension, };

package/dist/v0.10/api/integrations/dms.d.ts

@@ -1,6 +1,6 @@
 import IntegrationsBaseClient from "../integrationsBaseClient";
 import { AxiosResponse } from "axios";
-import { PDFFillOptions, DataConversionParams, DataValidationParams, DataInfoParams, DataInfo, DataValidationResult, ConversionOptions, HTML2PDFOptions, PDF2HTMLOptions, MediaUploadPayload, MediaUploadBase64Payload, DocumentListParams, DocumentListResponse, DocumentCreatePayload, DocumentUpdatePayload, DocumentRestorePayload, DocumentCommentPayload, DocumentResponse } from "../../types/integrations";
+import { PDFFillOptions, DataConversionParams, DataValidationParams, DataInfoParams, DataInfo, DataValidationResult, ConversionOptions, HTML2PDFOptions, PDF2HTMLOptions, MediaUploadPayload, MediaUploadBase64Payload, DocumentListParams, DocumentListResponse, DocumentCreatePayload, DocumentUpdatePayload, DocumentRestorePayload, DocumentCommentPayload, DocumentResponse, DocumentGeneratePayload, DocumentGenerateResponse } from "../../types/integrations";
 /**
  * Document Management System (DMS) API client
  *
@@ -142,6 +142,7 @@ export default class DMS extends IntegrationsBaseClient {
     listDeletedDocuments(params?: DocumentListParams): Promise<AxiosResponse<DocumentListResponse>>;
     restoreDocument(payload: DocumentRestorePayload): Promise<AxiosResponse<DocumentResponse>>;
     createDocumentComment(payload: DocumentCommentPayload): Promise<AxiosResponse<any, any>>;
+    generateDocument(payload: DocumentGeneratePayload): Promise<AxiosResponse<DocumentGenerateResponse>>;
     fillPdf(data: PDFFillOptions): Promise<AxiosResponse<any, any>>;
     /**
      * Convert data between different formats (JSON, CSV, Excel)

package/dist/v0.10/api/thunder.d.ts

@@ -1,11 +1,11 @@
 import PlatformBaseClient from "./platformBaseClient";
 export default class Thunder extends PlatformBaseClient {
-    read(type: string, filters: any, flag: string, options?: any): Promise<import("axios").AxiosResponse<any, any>>;
+    read(type: string, filters: any, flag: string, options?: any, only?: string[]): Promise<import("axios").AxiosResponse<any, any>>;
     write(type: string, filters: any, d: any, flag: any): Promise<import("axios").AxiosResponse<any, any>>;
     operation(name: string, filters: any, data: any): Promise<import("axios").AxiosResponse<any, any>>;
-    find(name: string, filters: any): Promise<import("axios").AxiosResponse<any, any>>;
-    findOne(name: string, filters: any): Promise<import("axios").AxiosResponse<any, any>>;
-    paginate(name: string, filters: any, options?: any): Promise<import("axios").AxiosResponse<any, any>>;
+    find(name: string, filters: any, only?: string[]): Promise<import("axios").AxiosResponse<any, any>>;
+    findOne(name: string, filters: any, only?: string[]): Promise<import("axios").AxiosResponse<any, any>>;
+    paginate(name: string, filters: any, options?: any, only?: string[]): Promise<import("axios").AxiosResponse<any, any>>;
     upsert(name: string, filters: any, data: any): Promise<import("axios").AxiosResponse<any, any>>;
     insertOne(name: string, data: any): Promise<import("axios").AxiosResponse<any, any>>;
     updateOne(name: string, filters: any, data: any): Promise<import("axios").AxiosResponse<any, any>>;

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

@@ -19044,6 +19044,7 @@ class PlatformBaseClient extends BaseClient {
         const client = axios.create({
             baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io",
             timeout: 30000,
+            withCredentials: true,
             headers: {
                 ...headers,
                 'Content-Type': 'application/json',
@@ -19120,6 +19121,13 @@ class Component extends PlatformBaseClient {
             dateTo: ctx.dateTo,
             dateField: ctx.dateField,
         };
+        if (ctx.only && ctx.only.length > 0) {
+            params.only = ctx.only;
+        }
+        else if (ctx.includeFields && ctx.includeFields.length > 0) {
+            // Backward-compatible alias. The API now prefers `only`.
+            params.includeFields = ctx.includeFields;
+        }
         if (Object.keys(ctx.$adv || []).length > 0) {
             params.$adv = [(_a = ctx.$adv) !== null && _a !== void 0 ? _a : {}];
         }
@@ -19526,11 +19534,122 @@ class Component extends PlatformBaseClient {
         return await this.client.delete(`/v4/system/component/${this.ref}/${version}/policies/${name}`);
     }
     /**
-     * Internal method to handle NDJSON streaming responses
+     * Internal method to handle NDJSON streaming responses.
+     * Uses native fetch + ReadableStream in browser environments and
+     * Axios responseType:'stream' in Node.js environments.
      *
      * @private
      */
     async _streamNDJSON(url, headers, handler, body) {
+        const inBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
+        if (inBrowser) {
+            return this._streamNDJSONBrowser(url, headers, handler, body);
+        }
+        else {
+            return this._streamNDJSONNode(url, headers, handler, body);
+        }
+    }
+    /**
+     * Browser implementation: native fetch + ReadableStream (NDJSON).
+     * @private
+     */
+    async _streamNDJSONBrowser(url, headers, handler, body) {
+        var _a, _b;
+        try {
+            // Derive full URL from the axios instance's baseURL
+            const baseURL = ((_a = this.client.defaults.baseURL) !== null && _a !== void 0 ? _a : 'https://lemon.protokol.io').replace(/\/$/, '');
+            const fullURL = `${baseURL}${url}`;
+            // Collect auth/env headers from the axios instance defaults
+            const defaultHeaders = {};
+            const axDefaults = this.client.defaults.headers;
+            for (const [k, v] of Object.entries(axDefaults)) {
+                if (typeof v === 'string')
+                    defaultHeaders[k] = v;
+            }
+            if (axDefaults.common && typeof axDefaults.common === 'object') {
+                for (const [k, v] of Object.entries(axDefaults.common)) {
+                    if (typeof v === 'string')
+                        defaultHeaders[k] = v;
+                }
+            }
+            const mergedHeaders = {
+                'Content-Type': 'application/json',
+                ...defaultHeaders,
+                ...headers,
+            };
+            const response = await fetch(fullURL, {
+                method: 'POST',
+                headers: mergedHeaders,
+                body: JSON.stringify(body),
+                credentials: 'include',
+            });
+            if (!response.ok) {
+                const err = new Error(`Aggregate stream failed: ${response.status} ${response.statusText}`);
+                if (handler.onError)
+                    handler.onError(err);
+                throw err;
+            }
+            if (!response.body) {
+                if (handler.onEnd)
+                    handler.onEnd();
+                return;
+            }
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    if (buffer.trim()) {
+                        try {
+                            const document = JSON.parse(buffer);
+                            const result = handler.onData(document);
+                            if (result instanceof Promise) {
+                                await result.catch((err) => { if (handler.onError)
+                                    handler.onError(err); });
+                            }
+                        }
+                        catch (err) {
+                            if (handler.onError)
+                                handler.onError(err);
+                        }
+                    }
+                    if (handler.onEnd)
+                        handler.onEnd();
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = (_b = lines.pop()) !== null && _b !== void 0 ? _b : '';
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const document = JSON.parse(line);
+                        const result = handler.onData(document);
+                        if (result instanceof Promise) {
+                            await result.catch((err) => { if (handler.onError)
+                                handler.onError(err); });
+                        }
+                    }
+                    catch (err) {
+                        if (handler.onError)
+                            handler.onError(err);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (handler.onError)
+                handler.onError(err);
+            throw err;
+        }
+    }
+    /**
+     * Node.js implementation: Axios responseType:'stream' + EventEmitter API.
+     * @private
+     */
+    async _streamNDJSONNode(url, headers, handler, body) {
         try {
             const config = {
                 headers,
@@ -19542,61 +19661,52 @@ class Component extends PlatformBaseClient {
             return new Promise((resolve, reject) => {
                 stream.on('data', (chunk) => {
                     buffer += chunk.toString();
-                    // Process complete lines (separated by newlines)
                     const lines = buffer.split('\n');
-                    buffer = lines.pop() || ''; // Keep incomplete line in buffer
+                    buffer = lines.pop() || '';
                     for (const line of lines) {
                         if (line.trim()) {
                             try {
                                 const document = JSON.parse(line);
                                 const result = handler.onData(document);
-                                // Support async callbacks
                                 if (result instanceof Promise) {
                                     result.catch((err) => {
-                                        if (handler.onError) {
+                                        if (handler.onError)
                                             handler.onError(err);
-                                        }
                                     });
                                 }
                             }
                             catch (err) {
-                                if (handler.onError) {
+                                if (handler.onError)
                                     handler.onError(err);
-                                }
                             }
                         }
                     }
                 });
                 stream.on('end', () => {
-                    // Process any remaining data in buffer
                     if (buffer.trim()) {
                         try {
                             const document = JSON.parse(buffer);
                             handler.onData(document);
                         }
                         catch (err) {
-                            if (handler.onError) {
+                            if (handler.onError)
                                 handler.onError(err);
-                            }
                         }
                     }
-                    if (handler.onEnd) {
+                    if (handler.onEnd)
                         handler.onEnd();
-                    }
                     resolve();
                 });
                 stream.on('error', (err) => {
-                    if (handler.onError) {
+                    if (handler.onError)
                         handler.onError(err);
-                    }
                     reject(err);
                 });
             });
         }
         catch (err) {
-            if (handler.onError) {
+            if (handler.onError)
                 handler.onError(err);
-            }
             throw err;
         }
     }
@@ -19800,12 +19910,13 @@ class ComponentUtils extends PlatformBaseClient {
 }
 
 class Thunder extends PlatformBaseClient {
-    async read(type, filters, flag, options) {
+    async read(type, filters, flag, options, only) {
         return await this.client.post("/v3/system/thunder", {
             type,
             filters,
             flag,
             options,
+            only,
         });
     }
     async write(type, filters, d, flag) {
@@ -19819,14 +19930,14 @@ class Thunder extends PlatformBaseClient {
     async operation(name, filters, data) {
         return await this.write(name, filters, data, "Operation");
     }
-    async find(name, filters) {
-        return await this.read(name, filters, "Find");
+    async find(name, filters, only) {
+        return await this.read(name, filters, "Find", undefined, only);
     }
-    async findOne(name, filters) {
-        return await this.read(name, filters, "FindOne");
+    async findOne(name, filters, only) {
+        return await this.read(name, filters, "FindOne", undefined, only);
     }
-    async paginate(name, filters, options) {
-        return await this.read(name, filters, "Paginate", options);
+    async paginate(name, filters, options, only) {
+        return await this.read(name, filters, "Paginate", options, only);
     }
     async upsert(name, filters, data) {
         return await this.write(name, filters, data, "Upsert");
@@ -20416,6 +20527,7 @@ class IntegrationsBaseClient extends BaseClient {
         const client = axios.create({
             baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io/luma/integrations",
             timeout: 30000,
+            withCredentials: true,
             headers: {
                 ...headers,
             },
@@ -20694,6 +20806,9 @@ class DMS extends IntegrationsBaseClient {
     async createDocumentComment(payload) {
         return this.requestv2('POST', 'documents/document/comment', { data: payload });
     }
+    async generateDocument(payload) {
+        return this.requestv2('POST', 'documents/document/generate', { data: payload });
+    }
     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';

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

@@ -77,6 +77,7 @@ class PlatformBaseClient extends BaseClient {
         const client = axios.create({
             baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io",
             timeout: 30000,
+            withCredentials: true,
             headers: {
                 ...headers,
                 'Content-Type': 'application/json',
@@ -153,6 +154,13 @@ class Component extends PlatformBaseClient {
             dateTo: ctx.dateTo,
             dateField: ctx.dateField,
         };
+        if (ctx.only && ctx.only.length > 0) {
+            params.only = ctx.only;
+        }
+        else if (ctx.includeFields && ctx.includeFields.length > 0) {
+            // Backward-compatible alias. The API now prefers `only`.
+            params.includeFields = ctx.includeFields;
+        }
         if (Object.keys(ctx.$adv || []).length > 0) {
             params.$adv = [(_a = ctx.$adv) !== null && _a !== void 0 ? _a : {}];
         }
@@ -559,11 +567,122 @@ class Component extends PlatformBaseClient {
         return await this.client.delete(`/v4/system/component/${this.ref}/${version}/policies/${name}`);
     }
     /**
-     * Internal method to handle NDJSON streaming responses
+     * Internal method to handle NDJSON streaming responses.
+     * Uses native fetch + ReadableStream in browser environments and
+     * Axios responseType:'stream' in Node.js environments.
      *
      * @private
      */
     async _streamNDJSON(url, headers, handler, body) {
+        const inBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
+        if (inBrowser) {
+            return this._streamNDJSONBrowser(url, headers, handler, body);
+        }
+        else {
+            return this._streamNDJSONNode(url, headers, handler, body);
+        }
+    }
+    /**
+     * Browser implementation: native fetch + ReadableStream (NDJSON).
+     * @private
+     */
+    async _streamNDJSONBrowser(url, headers, handler, body) {
+        var _a, _b;
+        try {
+            // Derive full URL from the axios instance's baseURL
+            const baseURL = ((_a = this.client.defaults.baseURL) !== null && _a !== void 0 ? _a : 'https://lemon.protokol.io').replace(/\/$/, '');
+            const fullURL = `${baseURL}${url}`;
+            // Collect auth/env headers from the axios instance defaults
+            const defaultHeaders = {};
+            const axDefaults = this.client.defaults.headers;
+            for (const [k, v] of Object.entries(axDefaults)) {
+                if (typeof v === 'string')
+                    defaultHeaders[k] = v;
+            }
+            if (axDefaults.common && typeof axDefaults.common === 'object') {
+                for (const [k, v] of Object.entries(axDefaults.common)) {
+                    if (typeof v === 'string')
+                        defaultHeaders[k] = v;
+                }
+            }
+            const mergedHeaders = {
+                'Content-Type': 'application/json',
+                ...defaultHeaders,
+                ...headers,
+            };
+            const response = await fetch(fullURL, {
+                method: 'POST',
+                headers: mergedHeaders,
+                body: JSON.stringify(body),
+                credentials: 'include',
+            });
+            if (!response.ok) {
+                const err = new Error(`Aggregate stream failed: ${response.status} ${response.statusText}`);
+                if (handler.onError)
+                    handler.onError(err);
+                throw err;
+            }
+            if (!response.body) {
+                if (handler.onEnd)
+                    handler.onEnd();
+                return;
+            }
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    if (buffer.trim()) {
+                        try {
+                            const document = JSON.parse(buffer);
+                            const result = handler.onData(document);
+                            if (result instanceof Promise) {
+                                await result.catch((err) => { if (handler.onError)
+                                    handler.onError(err); });
+                            }
+                        }
+                        catch (err) {
+                            if (handler.onError)
+                                handler.onError(err);
+                        }
+                    }
+                    if (handler.onEnd)
+                        handler.onEnd();
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = (_b = lines.pop()) !== null && _b !== void 0 ? _b : '';
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const document = JSON.parse(line);
+                        const result = handler.onData(document);
+                        if (result instanceof Promise) {
+                            await result.catch((err) => { if (handler.onError)
+                                handler.onError(err); });
+                        }
+                    }
+                    catch (err) {
+                        if (handler.onError)
+                            handler.onError(err);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (handler.onError)
+                handler.onError(err);
+            throw err;
+        }
+    }
+    /**
+     * Node.js implementation: Axios responseType:'stream' + EventEmitter API.
+     * @private
+     */
+    async _streamNDJSONNode(url, headers, handler, body) {
         try {
             const config = {
                 headers,
@@ -575,61 +694,52 @@ class Component extends PlatformBaseClient {
             return new Promise((resolve, reject) => {
                 stream.on('data', (chunk) => {
                     buffer += chunk.toString();
-                    // Process complete lines (separated by newlines)
                     const lines = buffer.split('\n');
-                    buffer = lines.pop() || ''; // Keep incomplete line in buffer
+                    buffer = lines.pop() || '';
                     for (const line of lines) {
                         if (line.trim()) {
                             try {
                                 const document = JSON.parse(line);
                                 const result = handler.onData(document);
-                                // Support async callbacks
                                 if (result instanceof Promise) {
                                     result.catch((err) => {
-                                        if (handler.onError) {
+                                        if (handler.onError)
                                             handler.onError(err);
-                                        }
                                     });
                                 }
                             }
                             catch (err) {
-                                if (handler.onError) {
+                                if (handler.onError)
                                     handler.onError(err);
-                                }
                             }
                         }
                     }
                 });
                 stream.on('end', () => {
-                    // Process any remaining data in buffer
                     if (buffer.trim()) {
                         try {
                             const document = JSON.parse(buffer);
                             handler.onData(document);
                         }
                         catch (err) {
-                            if (handler.onError) {
+                            if (handler.onError)
                                 handler.onError(err);
-                            }
                         }
                     }
-                    if (handler.onEnd) {
+                    if (handler.onEnd)
                         handler.onEnd();
-                    }
                     resolve();
                 });
                 stream.on('error', (err) => {
-                    if (handler.onError) {
+                    if (handler.onError)
                         handler.onError(err);
-                    }
                     reject(err);
                 });
             });
         }
         catch (err) {
-            if (handler.onError) {
+            if (handler.onError)
                 handler.onError(err);
-            }
             throw err;
         }
     }
@@ -833,12 +943,13 @@ class ComponentUtils extends PlatformBaseClient {
 }
 
 class Thunder extends PlatformBaseClient {
-    async read(type, filters, flag, options) {
+    async read(type, filters, flag, options, only) {
         return await this.client.post("/v3/system/thunder", {
             type,
             filters,
             flag,
             options,
+            only,
         });
     }
     async write(type, filters, d, flag) {
@@ -852,14 +963,14 @@ class Thunder extends PlatformBaseClient {
     async operation(name, filters, data) {
         return await this.write(name, filters, data, "Operation");
     }
-    async find(name, filters) {
-        return await this.read(name, filters, "Find");
+    async find(name, filters, only) {
+        return await this.read(name, filters, "Find", undefined, only);
     }
-    async findOne(name, filters) {
-        return await this.read(name, filters, "FindOne");
+    async findOne(name, filters, only) {
+        return await this.read(name, filters, "FindOne", undefined, only);
     }
-    async paginate(name, filters, options) {
-        return await this.read(name, filters, "Paginate", options);
+    async paginate(name, filters, options, only) {
+        return await this.read(name, filters, "Paginate", options, only);
     }
     async upsert(name, filters, data) {
         return await this.write(name, filters, data, "Upsert");
@@ -1449,6 +1560,7 @@ class IntegrationsBaseClient extends BaseClient {
         const client = axios.create({
             baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io/luma/integrations",
             timeout: 30000,
+            withCredentials: true,
             headers: {
                 ...headers,
             },
@@ -1727,6 +1839,9 @@ class DMS extends IntegrationsBaseClient {
     async createDocumentComment(payload) {
         return this.requestv2('POST', 'documents/document/comment', { data: payload });
     }
+    async generateDocument(payload) {
+        return this.requestv2('POST', 'documents/document/generate', { data: payload });
+    }
     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';

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

@@ -9,11 +9,13 @@ type FindParams = {
     dateFrom?: string;
     dateTo?: string;
     dateField?: string;
+    only?: string[];
+    includeFields?: string[];
     $adv?: FindAdvancedParams;
     $aggregate?: FindAggregateParams[];
 };
 type FindOptions = {
-    cacheTTL?: boolean;
+    cacheTTL?: number;
     buildTTL?: number;
     locale?: string;
     unmaskPasswords?: boolean;

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

@@ -319,3 +319,23 @@ export type DocumentCommentPayload = {
     /** Comment end position */
     to?: number;
 };
+/**
+ * Payload for generating (rendering) a document template with data
+ */
+export type DocumentGeneratePayload = {
+    /** Path to the document template */
+    path: string;
+    /** Variant to render (defaults to "default") */
+    variant?: string;
+    /** Data map passed to the Go text/template engine */
+    data: Record<string, any>;
+};
+/**
+ * Response from document generation
+ */
+export type DocumentGenerateResponse = {
+    /** Whether the generation was successful */
+    status: boolean;
+    /** Rendered document content */
+    content: string;
+};

package/dist/v0.9/index.cjs.js

@@ -19046,6 +19046,7 @@ class PlatformBaseClient extends BaseClient {
         const client = axios.create({
             baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io",
             timeout: 30000,
+            withCredentials: true,
             headers: {
                 ...headers,
                 'Content-Type': 'application/json',
@@ -20243,6 +20244,7 @@ class IntegrationsBaseClient extends BaseClient {
         const client = axios.create({
             baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io/luma/integrations",
             timeout: 30000,
+            withCredentials: true,
             headers: {
                 ...headers,
             }

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

@@ -77,6 +77,7 @@ class PlatformBaseClient extends BaseClient {
         const client = axios.create({
             baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io",
             timeout: 30000,
+            withCredentials: true,
             headers: {
                 ...headers,
                 'Content-Type': 'application/json',
@@ -1274,6 +1275,7 @@ class IntegrationsBaseClient extends BaseClient {
         const client = axios.create({
             baseURL: host !== null && host !== void 0 ? host : "https://lemon.protokol.io/luma/integrations",
             timeout: 30000,
+            withCredentials: true,
             headers: {
                 ...headers,
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ptkl/sdk",
-  "version": "1.5.3",
+  "version": "1.6.0",
   "scripts": {
     "build": "rollup -c",
     "build:monaco": "npm run build && node scripts/generate-monaco-types.cjs",