@ptkl/sdk 1.8.0 → 1.9.2

package/dist/index.0.10.js

@@ -3469,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];
@@ -3483,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`, {
@@ -3522,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;
@@ -3533,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

@@ -372,6 +372,9 @@ var ProtokolSDK09 = (function (exports, axios) {
         async settings() {
             return await this.client.get(`/v3/system/component/settings/${this.ref}`);
         }
+        async settingsForVersion(version) {
+            return await this.client.get(`/v3/system/component/settings/${this.ref}/${version}`);
+        }
         async saveSettings(settings, version) {
             return await this.client.post(`/v3/system/component/settings/${this.ref}/${version}`, settings);
         }
@@ -3006,10 +3009,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];
@@ -3020,6 +3031,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
@@ -3037,6 +3175,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;
@@ -3049,6 +3188,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.8.0",
+  "version": "1.9.2",
   "scripts": {
     "build": "rollup -c",
     "build:monaco": "npm run build && node scripts/generate-monaco-types.cjs",

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

@@ -18,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/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
   },
@@ -22435,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];
@@ -22449,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`, {
@@ -22488,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;
@@ -22499,3 +22635,4 @@ exports.Thunder = Thunder;
 exports.Users = Users;
 exports.VPFR = VPFR;
 exports.Workflow = Workflow;
+exports.parsePRN = parsePRN;

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

@@ -3468,10 +3468,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];
@@ -3482,6 +3490,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`, {
@@ -3507,4 +3642,4 @@ class Invoicing extends PlatformBaseClient {
     }
 }
 
-export { APIUser, Apps, Component, ComponentUtils, Config, DMS, Ecommerce, Forge, Functions, Integrations as Integration, Integrations, Invoicing, Mail, NBS, Payments, Platform, Project, Ratchet, Sandbox, MinFin as SerbiaMinFin, System, Thunder, Users, VPFR, Workflow };
+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 };

package/dist/v0.10/util/prn.d.ts

@@ -0,0 +1,38 @@
+export interface ParsedPRN {
+    type: string;
+    ref: string;
+    path: string;
+    params: Record<string, string>;
+}
+export declare class PRN {
+    private readonly _raw;
+    private constructor();
+    /**
+     * Validates a PRN string and returns it as a PRN instance.
+     * Throws if the string is not a valid PRN.
+     */
+    static parse(s: string): PRN;
+    /**
+     * Constructs a PRN from its constituent parts.
+     * Params are sorted by key for deterministic output.
+     */
+    static create(type: string, ref: string, path?: string, params?: Record<string, string>): PRN;
+    private _parse;
+    /** The resource category — e.g. "component", "integration", "user". */
+    get type(): string;
+    /** The resource identifier within its type — slug, UUID, name. */
+    get ref(): string;
+    /** The resource path segment, or empty string if absent. */
+    get path(): string;
+    /** All query-string key-value pairs, or empty object if none. */
+    get params(): Record<string, string>;
+    /** Returns the value for the given query-param key, or empty string if not present. */
+    param(key: string): string;
+    toString(): string;
+}
+/**
+ * Convenience wrapper around PRN.parse.
+ * Validates a PRN string and returns a PRN instance.
+ * Throws if the string is not a valid PRN.
+ */
+export declare function parsePRN(s: string): PRN;

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

@@ -121,6 +121,7 @@ export default class Component extends PlatformBaseClient {
      */
     aggregate(pipeline: FindAggregateParams): AggregateChainable;
     settings(): Promise<AxiosResponse<any, any>>;
+    settingsForVersion(version: string): Promise<AxiosResponse<any, any>>;
     saveSettings(settings: any, version: string): Promise<AxiosResponse<any, any>>;
     saveTemplatesDist(version: string, sdkVersion: string, engine: string, dist: Record<string, string>): Promise<any>;
     workflow(event: string, input: any): Promise<AxiosResponse<any, any>>;

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

@@ -17,6 +17,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.9/api/integrations.d.ts

@@ -21,6 +21,8 @@ export default class Integrations extends IntegrationsBaseClient {
     getPayments(): Payments;
     getMinimax(): Minimax;
     getEcommerce(): Ecommerce;
+    list(): Promise<any>;
     isInstalled(id: string): Promise<boolean>;
+    isActive(id: string): Promise<boolean>;
     getInterfaceOf(id: string): any;
 }

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

@@ -14620,7 +14620,7 @@ var transitionalDefaults = {
   clarifyTimeoutError: false
 };
 
-var URLSearchParams = require$$0$1.URLSearchParams;
+var URLSearchParams$1 = require$$0$1.URLSearchParams;
 
 const ALPHA = 'abcdefghijklmnopqrstuvwxyz';
 
@@ -14648,7 +14648,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
   },
@@ -19340,6 +19340,9 @@ class Component extends PlatformBaseClient {
     async settings() {
         return await this.client.get(`/v3/system/component/settings/${this.ref}`);
     }
+    async settingsForVersion(version) {
+        return await this.client.get(`/v3/system/component/settings/${this.ref}/${version}`);
+    }
     async saveSettings(settings, version) {
         return await this.client.post(`/v3/system/component/settings/${this.ref}/${version}`, settings);
     }
@@ -21974,10 +21977,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];
@@ -21988,6 +21999,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);
+}
+
 // API v0.9 
 // Export all API modules for version 0.9
 // This version has specific method signatures and behaviors for v0.9
@@ -22005,6 +22143,7 @@ exports.Integration = Integrations;
 exports.Integrations = Integrations;
 exports.Invoicing = Invoicing;
 exports.Mail = Mail;
+exports.PRN = PRN;
 exports.Payments = Payments;
 exports.Platform = Platform;
 exports.Project = Project;
@@ -22017,3 +22156,4 @@ exports.Users = Users;
 exports.VPFR = VPFR;
 exports.Workflow = Workflow;
 exports.default = Platform;
+exports.parsePRN = parsePRN;

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

@@ -371,6 +371,9 @@ class Component extends PlatformBaseClient {
     async settings() {
         return await this.client.get(`/v3/system/component/settings/${this.ref}`);
     }
+    async settingsForVersion(version) {
+        return await this.client.get(`/v3/system/component/settings/${this.ref}/${version}`);
+    }
     async saveSettings(settings, version) {
         return await this.client.post(`/v3/system/component/settings/${this.ref}/${version}`, settings);
     }
@@ -3005,10 +3008,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];
@@ -3019,8 +3030,135 @@ 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);
+}
+
 // API v0.9 
 // Export all API modules for version 0.9
 // This version has specific method signatures and behaviors for v0.9
 
-export { APIUser, Apps, Component, ComponentUtils, Config, DMS, Ecommerce, Forge, Functions, Integrations as Integration, Integrations, Invoicing, Mail, Payments, Platform, Project, Ratchet, Sandbox, SerbiaUtil, System, Thunder, Users, VPFR, Workflow, Platform as default };
+export { APIUser, Apps, Component, ComponentUtils, Config, DMS, Ecommerce, Forge, Functions, Integrations as Integration, Integrations, Invoicing, Mail, PRN, Payments, Platform, Project, Ratchet, Sandbox, SerbiaUtil, System, Thunder, Users, VPFR, Workflow, Platform as default, parsePRN };

package/dist/v0.9/util/prn.d.ts

@@ -0,0 +1,38 @@
+export interface ParsedPRN {
+    type: string;
+    ref: string;
+    path: string;
+    params: Record<string, string>;
+}
+export declare class PRN {
+    private readonly _raw;
+    private constructor();
+    /**
+     * Validates a PRN string and returns it as a PRN instance.
+     * Throws if the string is not a valid PRN.
+     */
+    static parse(s: string): PRN;
+    /**
+     * Constructs a PRN from its constituent parts.
+     * Params are sorted by key for deterministic output.
+     */
+    static create(type: string, ref: string, path?: string, params?: Record<string, string>): PRN;
+    private _parse;
+    /** The resource category — e.g. "component", "integration", "user". */
+    get type(): string;
+    /** The resource identifier within its type — slug, UUID, name. */
+    get ref(): string;
+    /** The resource path segment, or empty string if absent. */
+    get path(): string;
+    /** All query-string key-value pairs, or empty object if none. */
+    get params(): Record<string, string>;
+    /** Returns the value for the given query-param key, or empty string if not present. */
+    param(key: string): string;
+    toString(): string;
+}
+/**
+ * Convenience wrapper around PRN.parse.
+ * Validates a PRN string and returns a PRN instance.
+ * Throws if the string is not a valid PRN.
+ */
+export declare function parsePRN(s: string): PRN;

package/package.json

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