@ptkl/sdk 1.7.1 → 1.9.1

package/dist/index.0.10.js

@@ -1253,6 +1253,21 @@ var ProtokolSDK010 = (function (exports, axios) {
     }
 
     class Workflow extends PlatformBaseClient {
+        async create(data) {
+            return await this.client.post(`/v1/project/workflow/workflow`, data);
+        }
+        async update(id, data) {
+            return await this.client.patch(`/v1/project/workflow/workflow/${id}`, data);
+        }
+        async get(id) {
+            return await this.client.get(`/v1/project/workflow/workflow/${id}`);
+        }
+        async list() {
+            return await this.client.get(`/v1/project/workflow/workflows`);
+        }
+        async delete(id) {
+            return await this.client.delete(`/v1/project/workflow/workflow/${id}`);
+        }
         async trigger(id, event, data) {
             return await this.client.post(`/v1/project/workflow/workflow/${id}/event/${event}`, data);
         }
@@ -3454,10 +3469,18 @@ var ProtokolSDK010 = (function (exports, axios) {
         getEcommerce() {
             return this.getInterfaceOf('protokol-ecommerce');
         }
+        async list() {
+            const { data } = await this.client.get("/v1/integrations");
+            return data;
+        }
         async isInstalled(id) {
             const { data } = await this.client.get("/v1/integrations");
             return data.find((i) => i.id == id) !== undefined;
         }
+        async isActive(id) {
+            const { data } = await this.client.get("/v1/integrations");
+            return data.find((i) => i.id == id && i.status == "active") !== undefined;
+        }
         getInterfaceOf(id) {
             try {
                 return this.integrations[id];
@@ -3468,6 +3491,133 @@ var ProtokolSDK010 = (function (exports, axios) {
         }
     }
 
+    // PRN — Protokol Resource Name
+    //
+    // Format:
+    //   prn:<type>:<ref>[:<path>][?<query>]
+    //
+    // Examples:
+    //   prn:component:my-component:settings.api_key
+    //   prn:integration:protokol-ecommerce:company.legal_name?lang=en
+    //   prn:user:actor:forge?app=abc123&behalf=user-uuid
+    /**
+     * Splits s on sep into at most n parts, keeping the remainder in the last part.
+     * Mirrors Go's strings.SplitN behaviour.
+     */
+    function splitN(s, sep, n) {
+        const parts = [];
+        let start = 0;
+        for (let i = 1; i < n; i++) {
+            const idx = s.indexOf(sep, start);
+            if (idx === -1)
+                break;
+            parts.push(s.slice(start, idx));
+            start = idx + sep.length;
+        }
+        parts.push(s.slice(start));
+        return parts;
+    }
+    class PRN {
+        constructor(raw) {
+            this._raw = raw;
+        }
+        /**
+         * Validates a PRN string and returns it as a PRN instance.
+         * Throws if the string is not a valid PRN.
+         */
+        static parse(s) {
+            const parts = splitN(s, ':', 4);
+            if (parts.length < 3) {
+                throw new Error(`invalid PRN "${s}": expected format prn:<type>:<ref>[:<path>]`);
+            }
+            if (parts[0] !== 'prn') {
+                throw new Error(`invalid PRN "${s}": must start with 'prn'`);
+            }
+            if (!parts[1]) {
+                throw new Error(`invalid PRN "${s}": type must not be empty`);
+            }
+            if (!parts[2]) {
+                throw new Error(`invalid PRN "${s}": ref must not be empty`);
+            }
+            return new PRN(s);
+        }
+        /**
+         * Constructs a PRN from its constituent parts.
+         * Params are sorted by key for deterministic output.
+         */
+        static create(type, ref, path, params) {
+            let s = `prn:${type}:${ref}`;
+            if (path) {
+                s += `:${path}`;
+            }
+            if (params && Object.keys(params).length > 0) {
+                const sorted = Object.keys(params).sort();
+                const qs = new URLSearchParams();
+                for (const k of sorted) {
+                    qs.set(k, params[k]);
+                }
+                s += `?${qs.toString()}`;
+            }
+            return new PRN(s);
+        }
+        _parse() {
+            var _a, _b;
+            const s = this._raw;
+            const parts = splitN(s, ':', 4);
+            const type = (_a = parts[1]) !== null && _a !== void 0 ? _a : '';
+            const ref = (_b = parts[2]) !== null && _b !== void 0 ? _b : '';
+            let path = '';
+            const params = {};
+            if (parts.length === 4 && parts[3]) {
+                const rawPath = parts[3];
+                const qIdx = rawPath.indexOf('?');
+                if (qIdx >= 0) {
+                    path = rawPath.slice(0, qIdx);
+                    const qs = new URLSearchParams(rawPath.slice(qIdx + 1));
+                    qs.forEach((v, k) => {
+                        params[k] = v;
+                    });
+                }
+                else {
+                    path = rawPath;
+                }
+            }
+            return { type, ref, path, params };
+        }
+        /** The resource category — e.g. "component", "integration", "user". */
+        get type() {
+            return this._parse().type;
+        }
+        /** The resource identifier within its type — slug, UUID, name. */
+        get ref() {
+            return this._parse().ref;
+        }
+        /** The resource path segment, or empty string if absent. */
+        get path() {
+            return this._parse().path;
+        }
+        /** All query-string key-value pairs, or empty object if none. */
+        get params() {
+            return this._parse().params;
+        }
+        /** Returns the value for the given query-param key, or empty string if not present. */
+        param(key) {
+            var _a;
+            return (_a = this._parse().params[key]) !== null && _a !== void 0 ? _a : '';
+        }
+        toString() {
+            return this._raw;
+        }
+    }
+    /**
+     * Convenience wrapper around PRN.parse.
+     * Validates a PRN string and returns a PRN instance.
+     * Throws if the string is not a valid PRN.
+     */
+    function parsePRN(s) {
+        return PRN.parse(s);
+    }
+
     class Invoicing extends PlatformBaseClient {
         async getSalesInvoices(provider, page) {
             return await this.request("GET", `invoices/${provider}/sales`, {
@@ -3507,6 +3657,7 @@ var ProtokolSDK010 = (function (exports, axios) {
     exports.Invoicing = Invoicing;
     exports.Mail = Mail;
     exports.NBS = NBS;
+    exports.PRN = PRN;
     exports.Payments = Payments;
     exports.Platform = Platform;
     exports.Project = Project;
@@ -3518,6 +3669,7 @@ var ProtokolSDK010 = (function (exports, axios) {
     exports.Users = Users;
     exports.VPFR = VPFR;
     exports.Workflow = Workflow;
+    exports.parsePRN = parsePRN;
 
     return exports;
 

package/dist/index.0.9.js

@@ -940,6 +940,21 @@ var ProtokolSDK09 = (function (exports, axios) {
     }
 
     class Workflow extends PlatformBaseClient {
+        async create(data) {
+            return await this.client.post(`/v1/project/workflow/workflow`, data);
+        }
+        async update(id, data) {
+            return await this.client.patch(`/v1/project/workflow/workflow/${id}`, data);
+        }
+        async get(id) {
+            return await this.client.get(`/v1/project/workflow/workflow/${id}`);
+        }
+        async list() {
+            return await this.client.get(`/v1/project/workflow/workflows`);
+        }
+        async delete(id) {
+            return await this.client.delete(`/v1/project/workflow/workflow/${id}`);
+        }
         async trigger(id, event, data) {
             return await this.client.post(`/v1/project/workflow/workflow/${id}/event/${event}`, data);
         }
@@ -2991,10 +3006,18 @@ var ProtokolSDK09 = (function (exports, axios) {
         getEcommerce() {
             return this.getInterfaceOf('protokol-ecommerce');
         }
+        async list() {
+            const { data } = await this.client.get("/v1/integrations");
+            return data;
+        }
         async isInstalled(id) {
             const { data } = await this.client.get("/v1/integrations");
             return data.find((i) => i.id == id) !== undefined;
         }
+        async isActive(id) {
+            const { data } = await this.client.get("/v1/integrations");
+            return data.find((i) => i.id == id && i.status == "active") !== undefined;
+        }
         getInterfaceOf(id) {
             try {
                 return this.integrations[id];
@@ -3005,6 +3028,133 @@ var ProtokolSDK09 = (function (exports, axios) {
         }
     }
 
+    // PRN — Protokol Resource Name
+    //
+    // Format:
+    //   prn:<type>:<ref>[:<path>][?<query>]
+    //
+    // Examples:
+    //   prn:component:my-component:settings.api_key
+    //   prn:integration:protokol-ecommerce:company.legal_name?lang=en
+    //   prn:user:actor:forge?app=abc123&behalf=user-uuid
+    /**
+     * Splits s on sep into at most n parts, keeping the remainder in the last part.
+     * Mirrors Go's strings.SplitN behaviour.
+     */
+    function splitN(s, sep, n) {
+        const parts = [];
+        let start = 0;
+        for (let i = 1; i < n; i++) {
+            const idx = s.indexOf(sep, start);
+            if (idx === -1)
+                break;
+            parts.push(s.slice(start, idx));
+            start = idx + sep.length;
+        }
+        parts.push(s.slice(start));
+        return parts;
+    }
+    class PRN {
+        constructor(raw) {
+            this._raw = raw;
+        }
+        /**
+         * Validates a PRN string and returns it as a PRN instance.
+         * Throws if the string is not a valid PRN.
+         */
+        static parse(s) {
+            const parts = splitN(s, ':', 4);
+            if (parts.length < 3) {
+                throw new Error(`invalid PRN "${s}": expected format prn:<type>:<ref>[:<path>]`);
+            }
+            if (parts[0] !== 'prn') {
+                throw new Error(`invalid PRN "${s}": must start with 'prn'`);
+            }
+            if (!parts[1]) {
+                throw new Error(`invalid PRN "${s}": type must not be empty`);
+            }
+            if (!parts[2]) {
+                throw new Error(`invalid PRN "${s}": ref must not be empty`);
+            }
+            return new PRN(s);
+        }
+        /**
+         * Constructs a PRN from its constituent parts.
+         * Params are sorted by key for deterministic output.
+         */
+        static create(type, ref, path, params) {
+            let s = `prn:${type}:${ref}`;
+            if (path) {
+                s += `:${path}`;
+            }
+            if (params && Object.keys(params).length > 0) {
+                const sorted = Object.keys(params).sort();
+                const qs = new URLSearchParams();
+                for (const k of sorted) {
+                    qs.set(k, params[k]);
+                }
+                s += `?${qs.toString()}`;
+            }
+            return new PRN(s);
+        }
+        _parse() {
+            var _a, _b;
+            const s = this._raw;
+            const parts = splitN(s, ':', 4);
+            const type = (_a = parts[1]) !== null && _a !== void 0 ? _a : '';
+            const ref = (_b = parts[2]) !== null && _b !== void 0 ? _b : '';
+            let path = '';
+            const params = {};
+            if (parts.length === 4 && parts[3]) {
+                const rawPath = parts[3];
+                const qIdx = rawPath.indexOf('?');
+                if (qIdx >= 0) {
+                    path = rawPath.slice(0, qIdx);
+                    const qs = new URLSearchParams(rawPath.slice(qIdx + 1));
+                    qs.forEach((v, k) => {
+                        params[k] = v;
+                    });
+                }
+                else {
+                    path = rawPath;
+                }
+            }
+            return { type, ref, path, params };
+        }
+        /** The resource category — e.g. "component", "integration", "user". */
+        get type() {
+            return this._parse().type;
+        }
+        /** The resource identifier within its type — slug, UUID, name. */
+        get ref() {
+            return this._parse().ref;
+        }
+        /** The resource path segment, or empty string if absent. */
+        get path() {
+            return this._parse().path;
+        }
+        /** All query-string key-value pairs, or empty object if none. */
+        get params() {
+            return this._parse().params;
+        }
+        /** Returns the value for the given query-param key, or empty string if not present. */
+        param(key) {
+            var _a;
+            return (_a = this._parse().params[key]) !== null && _a !== void 0 ? _a : '';
+        }
+        toString() {
+            return this._raw;
+        }
+    }
+    /**
+     * Convenience wrapper around PRN.parse.
+     * Validates a PRN string and returns a PRN instance.
+     * Throws if the string is not a valid PRN.
+     */
+    function parsePRN(s) {
+        return PRN.parse(s);
+    }
+
     // API v0.9 
     // Export all API modules for version 0.9
     // This version has specific method signatures and behaviors for v0.9
@@ -3022,6 +3172,7 @@ var ProtokolSDK09 = (function (exports, axios) {
     exports.Integrations = Integrations;
     exports.Invoicing = Invoicing;
     exports.Mail = Mail;
+    exports.PRN = PRN;
     exports.Payments = Payments;
     exports.Platform = Platform;
     exports.Project = Project;
@@ -3034,6 +3185,7 @@ var ProtokolSDK09 = (function (exports, axios) {
     exports.VPFR = VPFR;
     exports.Workflow = Workflow;
     exports.default = Platform;
+    exports.parsePRN = parsePRN;
 
     Object.defineProperty(exports, '__esModule', { value: true });
 

package/dist/package.json

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

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

@@ -1,5 +1,6 @@
 export type { PlatformFunctions, PlatformFunction, FunctionInput, FunctionOutput, FunctionCallParams, ComponentModels, ComponentFunctions, ComponentModel, ComponentFunctionInput, ComponentFunctionOutput, } from '../types/functions';
 export type { Settings, SettingsField, FieldRoles, FieldConstraints, Context, Preset, PresetContext, Filters, Extension, Policy, SetupData, Model, } from '../types/component';
+export type { WorkflowModel, WorkflowSettings, WorkflowNode, WorkflowNodeConnection, WorkflowCreatePayload, WorkflowUpdatePayload, WorkflowListResponse, } from '../types/workflow';
 export { default as Component } from './component';
 export { default as Platform } from './platform';
 export { default as Functions } from './functions';
@@ -17,6 +18,8 @@ export { default as Project } from './project';
 export { default as Config } from './config';
 export { default as Integrations } from './integrations';
 export { default as Integration } from './integrations';
+export { PRN, parsePRN } from '../util/prn';
+export type { ParsedPRN } from '../util/prn';
 export { default as Payments } from './integrations/payments';
 export { default as Invoicing } from './integrations/invoicing';
 export { default as DMS } from './integrations/dms';

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

@@ -22,6 +22,8 @@ export default class Integrations extends IntegrationsBaseClient {
     getNBS(): NBS;
     getSerbiaMinFin(): MinFin;
     getEcommerce(): Ecommerce;
+    list(): Promise<any>;
     isInstalled(id: string): Promise<boolean>;
+    isActive(id: string): Promise<boolean>;
     getInterfaceOf(id: string): any;
 }

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

@@ -1,5 +1,12 @@
+import { AxiosResponse } from 'axios';
 import PlatformBaseClient from "./platformBaseClient";
+import { WorkflowModel, WorkflowCreatePayload, WorkflowUpdatePayload, WorkflowListResponse } from '../types/workflow';
 export default class Workflow extends PlatformBaseClient {
-    trigger(id: string, event: string, data: any): Promise<import("axios").AxiosResponse<any, any>>;
-    publish(event: string, data: any): Promise<import("axios").AxiosResponse<any, any>>;
+    create(data: WorkflowCreatePayload): Promise<AxiosResponse<WorkflowModel>>;
+    update(id: string, data: WorkflowUpdatePayload): Promise<AxiosResponse<WorkflowModel>>;
+    get(id: string): Promise<AxiosResponse<WorkflowModel>>;
+    list(): Promise<AxiosResponse<WorkflowListResponse>>;
+    delete(id: string): Promise<AxiosResponse<void>>;
+    trigger(id: string, event: string, data: any): Promise<AxiosResponse<any, any>>;
+    publish(event: string, data: any): Promise<AxiosResponse<any, any>>;
 }

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

@@ -14618,7 +14618,7 @@ var transitionalDefaults = {
   clarifyTimeoutError: false
 };
 
-var URLSearchParams = require$$0$1.URLSearchParams;
+var URLSearchParams$1 = require$$0$1.URLSearchParams;
 
 const ALPHA = 'abcdefghijklmnopqrstuvwxyz';
 
@@ -14646,7 +14646,7 @@ const generateString = (size = 16, alphabet = ALPHABET.ALPHA_DIGIT) => {
 var platform$1 = {
   isNode: true,
   classes: {
-    URLSearchParams,
+    URLSearchParams: URLSearchParams$1,
     FormData: FormData$1,
     Blob: typeof Blob !== 'undefined' && Blob || null
   },
@@ -20219,6 +20219,21 @@ class System extends PlatformBaseClient {
 }
 
 class Workflow extends PlatformBaseClient {
+    async create(data) {
+        return await this.client.post(`/v1/project/workflow/workflow`, data);
+    }
+    async update(id, data) {
+        return await this.client.patch(`/v1/project/workflow/workflow/${id}`, data);
+    }
+    async get(id) {
+        return await this.client.get(`/v1/project/workflow/workflow/${id}`);
+    }
+    async list() {
+        return await this.client.get(`/v1/project/workflow/workflows`);
+    }
+    async delete(id) {
+        return await this.client.delete(`/v1/project/workflow/workflow/${id}`);
+    }
     async trigger(id, event, data) {
         return await this.client.post(`/v1/project/workflow/workflow/${id}/event/${event}`, data);
     }
@@ -22420,10 +22435,18 @@ class Integrations extends IntegrationsBaseClient {
     getEcommerce() {
         return this.getInterfaceOf('protokol-ecommerce');
     }
+    async list() {
+        const { data } = await this.client.get("/v1/integrations");
+        return data;
+    }
     async isInstalled(id) {
         const { data } = await this.client.get("/v1/integrations");
         return data.find((i) => i.id == id) !== undefined;
     }
+    async isActive(id) {
+        const { data } = await this.client.get("/v1/integrations");
+        return data.find((i) => i.id == id && i.status == "active") !== undefined;
+    }
     getInterfaceOf(id) {
         try {
             return this.integrations[id];
@@ -22434,6 +22457,133 @@ class Integrations extends IntegrationsBaseClient {
     }
 }
 
+// PRN — Protokol Resource Name
+//
+// Format:
+//   prn:<type>:<ref>[:<path>][?<query>]
+//
+// Examples:
+//   prn:component:my-component:settings.api_key
+//   prn:integration:protokol-ecommerce:company.legal_name?lang=en
+//   prn:user:actor:forge?app=abc123&behalf=user-uuid
+/**
+ * Splits s on sep into at most n parts, keeping the remainder in the last part.
+ * Mirrors Go's strings.SplitN behaviour.
+ */
+function splitN(s, sep, n) {
+    const parts = [];
+    let start = 0;
+    for (let i = 1; i < n; i++) {
+        const idx = s.indexOf(sep, start);
+        if (idx === -1)
+            break;
+        parts.push(s.slice(start, idx));
+        start = idx + sep.length;
+    }
+    parts.push(s.slice(start));
+    return parts;
+}
+class PRN {
+    constructor(raw) {
+        this._raw = raw;
+    }
+    /**
+     * Validates a PRN string and returns it as a PRN instance.
+     * Throws if the string is not a valid PRN.
+     */
+    static parse(s) {
+        const parts = splitN(s, ':', 4);
+        if (parts.length < 3) {
+            throw new Error(`invalid PRN "${s}": expected format prn:<type>:<ref>[:<path>]`);
+        }
+        if (parts[0] !== 'prn') {
+            throw new Error(`invalid PRN "${s}": must start with 'prn'`);
+        }
+        if (!parts[1]) {
+            throw new Error(`invalid PRN "${s}": type must not be empty`);
+        }
+        if (!parts[2]) {
+            throw new Error(`invalid PRN "${s}": ref must not be empty`);
+        }
+        return new PRN(s);
+    }
+    /**
+     * Constructs a PRN from its constituent parts.
+     * Params are sorted by key for deterministic output.
+     */
+    static create(type, ref, path, params) {
+        let s = `prn:${type}:${ref}`;
+        if (path) {
+            s += `:${path}`;
+        }
+        if (params && Object.keys(params).length > 0) {
+            const sorted = Object.keys(params).sort();
+            const qs = new URLSearchParams();
+            for (const k of sorted) {
+                qs.set(k, params[k]);
+            }
+            s += `?${qs.toString()}`;
+        }
+        return new PRN(s);
+    }
+    _parse() {
+        var _a, _b;
+        const s = this._raw;
+        const parts = splitN(s, ':', 4);
+        const type = (_a = parts[1]) !== null && _a !== void 0 ? _a : '';
+        const ref = (_b = parts[2]) !== null && _b !== void 0 ? _b : '';
+        let path = '';
+        const params = {};
+        if (parts.length === 4 && parts[3]) {
+            const rawPath = parts[3];
+            const qIdx = rawPath.indexOf('?');
+            if (qIdx >= 0) {
+                path = rawPath.slice(0, qIdx);
+                const qs = new URLSearchParams(rawPath.slice(qIdx + 1));
+                qs.forEach((v, k) => {
+                    params[k] = v;
+                });
+            }
+            else {
+                path = rawPath;
+            }
+        }
+        return { type, ref, path, params };
+    }
+    /** The resource category — e.g. "component", "integration", "user". */
+    get type() {
+        return this._parse().type;
+    }
+    /** The resource identifier within its type — slug, UUID, name. */
+    get ref() {
+        return this._parse().ref;
+    }
+    /** The resource path segment, or empty string if absent. */
+    get path() {
+        return this._parse().path;
+    }
+    /** All query-string key-value pairs, or empty object if none. */
+    get params() {
+        return this._parse().params;
+    }
+    /** Returns the value for the given query-param key, or empty string if not present. */
+    param(key) {
+        var _a;
+        return (_a = this._parse().params[key]) !== null && _a !== void 0 ? _a : '';
+    }
+    toString() {
+        return this._raw;
+    }
+}
+/**
+ * Convenience wrapper around PRN.parse.
+ * Validates a PRN string and returns a PRN instance.
+ * Throws if the string is not a valid PRN.
+ */
+function parsePRN(s) {
+    return PRN.parse(s);
+}
+
 class Invoicing extends PlatformBaseClient {
     async getSalesInvoices(provider, page) {
         return await this.request("GET", `invoices/${provider}/sales`, {
@@ -22473,6 +22623,7 @@ exports.Integrations = Integrations;
 exports.Invoicing = Invoicing;
 exports.Mail = Mail;
 exports.NBS = NBS;
+exports.PRN = PRN;
 exports.Payments = Payments;
 exports.Platform = Platform;
 exports.Project = Project;
@@ -22484,3 +22635,4 @@ exports.Thunder = Thunder;
 exports.Users = Users;
 exports.VPFR = VPFR;
 exports.Workflow = Workflow;
+exports.parsePRN = parsePRN;