@ptkl/sdk 1.3.4 → 1.4.0

package/dist/index.0.10.js

@@ -48,11 +48,15 @@ var ProtokolSDK010 = (function (exports, axios) {
                 token = (_c = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_API_TOKEN) !== null && _c !== void 0 ? _c : token;
                 project_uuid = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_UUID;
                 if (isBrowser) {
-                    if (sessionStorage.getItem('protokol_context') == "forge") {
-                        headers['X-Project-Env'] = (_d = sessionStorage.getItem('forge_app_env')) !== null && _d !== void 0 ? _d : "dev";
+                    if (sessionStorage.getItem('protokol_context') === 'forge') {
+                        headers['X-Project-Env'] = (_d = sessionStorage.getItem('forge_app_env')) !== null && _d !== void 0 ? _d : 'dev';
+                        // pick up forge actor token — overrides any other token source
+                        const forgeToken = sessionStorage.getItem('forge_actor_token');
+                        if (forgeToken)
+                            token = forgeToken;
                     }
                     else {
-                        headers['X-Project-Env'] = (_e = localStorage.getItem('current_env')) !== null && _e !== void 0 ? _e : "dev";
+                        headers['X-Project-Env'] = (_e = localStorage.getItem('current_env')) !== null && _e !== void 0 ? _e : 'dev';
                     }
                 }
             }
@@ -88,6 +92,11 @@ var ProtokolSDK010 = (function (exports, axios) {
     }
 
     class Component extends PlatformBaseClient {
+        /**
+         * @param ref - Component ref (e.g. "ecommerce::order"). Passing a string
+         *   literal lets TypeScript infer the generic C and type find/create/function
+         *   results accordingly.
+         */
         constructor(ref = null) {
             super();
             this.ref = ref;
@@ -233,7 +242,7 @@ var ProtokolSDK010 = (function (exports, axios) {
         async updateMany(data, options) {
             return await this.client.patch(`/v4/system/component/${this.ref}/models/bulk`, {
                 data,
-                options
+                options,
             });
         }
         /**
@@ -638,16 +647,6 @@ var ProtokolSDK010 = (function (exports, axios) {
         async update(uuid, update) {
             return await this.client.patch(`/v1/system/function/${uuid}`, update);
         }
-        /**
-         * Run platform function
-         *
-         * @param id - Function ID
-         * @param d - Object containing input data, query parameters, and headers
-         * @returns - Function result
-         *
-         * @example
-         * const result = await platform.function().run("myFunction", {input: { foo: "bar" }})
-         */
         async run(id, d) {
             const { data } = await this.client.post(`/v1/system/function/run/${id}`, d.input, {
                 params: d.query,
@@ -1102,10 +1101,25 @@ var ProtokolSDK010 = (function (exports, axios) {
     }
 
     class System extends PlatformBaseClient {
-        async resourceResolver(ref, resourceName, format) {
+        /**
+         * Returns all IDL definitions for the current project.
+         * Used by `ptkl generate-types` to emit typed `.d.ts` augmentations.
+         */
+        async idl() {
+            return await this.client.get('/v1/system/idl');
+        }
+        /**
+         * Validates a value against an IDL — either by ref or with an inline IDL object.
+         * Returns `{ data: { valid: true } }` on success or
+         * `{ data: { valid: false, errors: [...] } }` on validation failure.
+         * Throws on HTTP errors (4xx/5xx).
+         */
+        async idlValidate(req) {
+            return await this.client.post('/v1/system/idl/validate', req);
+        }
+        async resourceResolver(prn, format) {
             return await this.client.post("/v3/system/resource-resolver", {
-                type: resourceName,
-                ref,
+                prn,
                 format,
             });
         }
@@ -1407,11 +1421,15 @@ var ProtokolSDK010 = (function (exports, axios) {
                 env = env !== null && env !== void 0 ? env : __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_ENV;
                 token = token !== null && token !== void 0 ? token : __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_API_TOKEN;
                 if (isBrowser) {
-                    if (sessionStorage.getItem('protokol_context') == "forge") {
-                        headers['X-Project-Env'] = (_b = sessionStorage.getItem('forge_app_env')) !== null && _b !== void 0 ? _b : "dev";
+                    if (sessionStorage.getItem('protokol_context') === 'forge') {
+                        headers['X-Project-Env'] = (_b = sessionStorage.getItem('forge_app_env')) !== null && _b !== void 0 ? _b : 'dev';
+                        // pick up forge actor token — overrides any other token source
+                        const forgeToken = sessionStorage.getItem('forge_actor_token');
+                        if (forgeToken)
+                            token = forgeToken;
                     }
                     else {
-                        headers['X-Project-Env'] = (_c = localStorage.getItem('current_env')) !== null && _c !== void 0 ? _c : "dev";
+                        headers['X-Project-Env'] = (_c = localStorage.getItem('current_env')) !== null && _c !== void 0 ? _c : 'dev';
                     }
                 }
             }
@@ -3207,6 +3225,57 @@ var ProtokolSDK010 = (function (exports, axios) {
         }
     }
 
+    class Ecommerce extends IntegrationsBaseClient {
+        /**
+         * Get the ecommerce integration user for the current project.
+         */
+        async get() {
+            return await this.client.get(`/v1/ecomm/user`);
+        }
+        /**
+         * Update ecommerce integration settings (onboarding or partial update).
+         */
+        async update(req) {
+            return await this.client.patch(`/v1/ecomm/user`, req);
+        }
+        /**
+         * Check whether a base domain subdomain is available.
+         */
+        async checkBaseDomain(domain) {
+            return await this.client.post(`/v1/ecomm/base-domain/check`, { domain });
+        }
+        /**
+         * Add a custom domain (returns a verification token for DNS validation).
+         */
+        async addCustomDomain(domain) {
+            return await this.client.post(`/v1/ecomm/domains`, { domain });
+        }
+        /**
+         * Validate a custom domain with its verification token.
+         */
+        async validateCustomDomain(domain, token) {
+            return await this.client.post(`/v1/ecomm/domains/validate`, { domain, token });
+        }
+        /**
+         * Remove a custom domain.
+         */
+        async removeCustomDomain(domain) {
+            return await this.client.delete(`/v1/ecomm/domains`, { data: { domain } });
+        }
+        /**
+         * List pending (unvalidated) custom domains.
+         */
+        async getPendingDomains() {
+            return await this.client.get(`/v1/ecomm/domains/pending`);
+        }
+        /**
+         * List validated custom domains.
+         */
+        async getValidatedDomains() {
+            return await this.client.get(`/v1/ecomm/domains/validated`);
+        }
+    }
+
     class Integrations extends IntegrationsBaseClient {
         constructor(options) {
             super(options);
@@ -3217,6 +3286,7 @@ var ProtokolSDK010 = (function (exports, axios) {
                 'nbs': new NBS().setClient(this.client),
                 'protokol-payments': new Payments().setClient(this.client),
                 'protokol-minimax': new Minimax().setClient(this.client),
+                'protokol-ecommerce': new Ecommerce().setClient(this.client),
             };
         }
         getDMS() {
@@ -3240,6 +3310,9 @@ var ProtokolSDK010 = (function (exports, axios) {
         getSerbiaMinFin() {
             return this.getInterfaceOf('serbia-minfin');
         }
+        getEcommerce() {
+            return this.getInterfaceOf('protokol-ecommerce');
+        }
         async isInstalled(id) {
             const { data } = await this.client.get("/v1/integrations");
             return data.find((i) => i.id == id) !== undefined;
@@ -3285,6 +3358,7 @@ var ProtokolSDK010 = (function (exports, axios) {
     exports.ComponentUtils = ComponentUtils;
     exports.Config = Config;
     exports.DMS = DMS;
+    exports.Ecommerce = Ecommerce;
     exports.Forge = Forge;
     exports.Functions = Functions;
     exports.Integration = Integrations;

package/dist/index.0.9.js

@@ -48,11 +48,15 @@ var ProtokolSDK09 = (function (exports, axios) {
                 token = token !== null && token !== void 0 ? token : __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_API_TOKEN;
                 project_uuid = __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_UUID;
                 if (isBrowser) {
-                    if (sessionStorage.getItem('protokol_context') == "forge") {
-                        headers['X-Project-Env'] = (_b = sessionStorage.getItem('forge_app_env')) !== null && _b !== void 0 ? _b : "dev";
+                    if (sessionStorage.getItem('protokol_context') === 'forge') {
+                        headers['X-Project-Env'] = (_b = sessionStorage.getItem('forge_app_env')) !== null && _b !== void 0 ? _b : 'dev';
+                        // pick up forge actor token — overrides any other token source
+                        const forgeToken = sessionStorage.getItem('forge_actor_token');
+                        if (forgeToken)
+                            token = forgeToken;
                     }
                     else {
-                        headers['X-Project-Env'] = (_c = localStorage.getItem('current_env')) !== null && _c !== void 0 ? _c : "dev";
+                        headers['X-Project-Env'] = (_c = localStorage.getItem('current_env')) !== null && _c !== void 0 ? _c : 'dev';
                     }
                 }
             }
@@ -236,7 +240,7 @@ var ProtokolSDK09 = (function (exports, axios) {
         async updateMany(data, options) {
             return await this.client.patch(`${this.getComponentPath()}/models/bulk`, {
                 data,
-                options
+                options,
             });
         }
         /**
@@ -470,16 +474,6 @@ var ProtokolSDK09 = (function (exports, axios) {
         async update(uuid, update) {
             return await this.client.patch(`/v1/system/function/${uuid}`, update);
         }
-        /**
-         * Run platform function
-         *
-         * @param id - Function ID
-         * @param d - Object containing input data, query parameters, and headers
-         * @returns - Function result
-         *
-         * @example
-         * const result = await platform.function().run("myFunction", {input: { foo: "bar" }})
-         */
         async run(id, d) {
             const { data } = await this.client.post(`/v1/system/function/run/${id}`, d.input, {
                 params: d.query,
@@ -923,10 +917,9 @@ var ProtokolSDK09 = (function (exports, axios) {
     }
 
     class System extends PlatformBaseClient {
-        async resourceResolver(ref, resourceName, format) {
+        async resourceResolver(prn, format) {
             return await this.client.post("/v3/system/resource-resolver", {
-                type: resourceName,
-                ref,
+                prn,
                 format,
             });
         }
@@ -1253,11 +1246,15 @@ var ProtokolSDK09 = (function (exports, axios) {
                 env = env !== null && env !== void 0 ? env : __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_ENV;
                 token = token !== null && token !== void 0 ? token : __global_env__ === null || __global_env__ === void 0 ? void 0 : __global_env__.PROJECT_API_TOKEN;
                 if (isBrowser) {
-                    if (sessionStorage.getItem('protokol_context') == "forge") {
-                        headers['X-Project-Env'] = (_b = sessionStorage.getItem('forge_app_env')) !== null && _b !== void 0 ? _b : "dev";
+                    if (sessionStorage.getItem('protokol_context') === 'forge') {
+                        headers['X-Project-Env'] = (_b = sessionStorage.getItem('forge_app_env')) !== null && _b !== void 0 ? _b : 'dev';
+                        // pick up forge actor token — overrides any other token source
+                        const forgeToken = sessionStorage.getItem('forge_actor_token');
+                        if (forgeToken)
+                            token = forgeToken;
                     }
                     else {
-                        headers['X-Project-Env'] = (_c = localStorage.getItem('current_env')) !== null && _c !== void 0 ? _c : "dev";
+                        headers['X-Project-Env'] = (_c = localStorage.getItem('current_env')) !== null && _c !== void 0 ? _c : 'dev';
                     }
                 }
             }
@@ -2891,6 +2888,57 @@ var ProtokolSDK09 = (function (exports, axios) {
         }
     }
 
+    class Ecommerce extends IntegrationsBaseClient {
+        /**
+         * Get the ecommerce integration user for the current project.
+         */
+        async get() {
+            return await this.client.get(`/v1/ecomm/user`);
+        }
+        /**
+         * Update ecommerce integration settings (onboarding or partial update).
+         */
+        async update(req) {
+            return await this.client.patch(`/v1/ecomm/user`, req);
+        }
+        /**
+         * Check whether a base domain subdomain is available.
+         */
+        async checkBaseDomain(domain) {
+            return await this.client.post(`/v1/ecomm/base-domain/check`, { domain });
+        }
+        /**
+         * Add a custom domain (returns a verification token for DNS validation).
+         */
+        async addCustomDomain(domain) {
+            return await this.client.post(`/v1/ecomm/domains`, { domain });
+        }
+        /**
+         * Validate a custom domain with its verification token.
+         */
+        async validateCustomDomain(domain, token) {
+            return await this.client.post(`/v1/ecomm/domains/validate`, { domain, token });
+        }
+        /**
+         * Remove a custom domain.
+         */
+        async removeCustomDomain(domain) {
+            return await this.client.delete(`/v1/ecomm/domains`, { data: { domain } });
+        }
+        /**
+         * List pending (unvalidated) custom domains.
+         */
+        async getPendingDomains() {
+            return await this.client.get(`/v1/ecomm/domains/pending`);
+        }
+        /**
+         * List validated custom domains.
+         */
+        async getValidatedDomains() {
+            return await this.client.get(`/v1/ecomm/domains/validated`);
+        }
+    }
+
     // import integrations
     class Integrations extends IntegrationsBaseClient {
         constructor(options) {
@@ -2903,6 +2951,7 @@ var ProtokolSDK09 = (function (exports, axios) {
                 'serbia-utilities': new SerbiaUtil().setClient(this.client),
                 'protokol-payments': new Payments().setClient(this.client),
                 'protokol-minimax': new Minimax().setClient(this.client),
+                'protokol-ecommerce': new Ecommerce().setClient(this.client),
             };
         }
         getSerbiaUtilities() {
@@ -2926,6 +2975,9 @@ var ProtokolSDK09 = (function (exports, axios) {
         getMinimax() {
             return this.getInterfaceOf('protokol-minimax');
         }
+        getEcommerce() {
+            return this.getInterfaceOf('protokol-ecommerce');
+        }
         async isInstalled(id) {
             const { data } = await this.client.get("/v1/integrations");
             return data.find((i) => i.id == id) !== undefined;
@@ -2950,6 +3002,7 @@ var ProtokolSDK09 = (function (exports, axios) {
     exports.ComponentUtils = ComponentUtils;
     exports.Config = Config;
     exports.DMS = DMS;
+    exports.Ecommerce = Ecommerce;
     exports.Forge = Forge;
     exports.Functions = Functions;
     exports.Integration = Integrations;

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ptkl/sdk",
-  "version": "1.3.4",
+  "version": "1.4.0",
   "scripts": {
     "build": "rollup -c",
     "build:monaco": "npm run build && node scripts/generate-monaco-types.cjs",
@@ -13,17 +13,17 @@
     ".": {
       "import": "./dist/v0.9/index.esm.js",
       "require": "./dist/v0.9/index.cjs.js",
-      "types": "./dist/v0.9/index.d.ts"
+      "types": "./dist/v0.9/api/index.d.ts"
     },
     "./beta": {
       "import": "./dist/v0.10/index.esm.js",
       "require": "./dist/v0.10/index.cjs.js",
-      "types": "./dist/v0.10/index.d.ts"
+      "types": "./dist/v0.10/api/index.d.ts"
     }
   },
   "main": "./dist/v0.10/index.cjs.js",
   "module": "./dist/v0.10/index.esm.js",
-  "types": "./dist/v0.10/index.d.ts",
+  "types": "./dist/v0.10/api/index.d.ts",
   "author": "protokol.io",
   "license": "ISC",
   "type": "module",
@@ -44,6 +44,7 @@
     "typescript": "^5.6.3"
   },
   "dependencies": {
+    "@ptkl/sdk": "file:",
     "@rollup/plugin-replace": "^6.0.2",
     "axios": "^1.7.7",
     "dom-parser": "^1.1.5",

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

@@ -1,9 +1,22 @@
 import { FindParams, FindOptions, FindResponse, FindAdvancedParams, FindAggregateParams, Model, UpdateOptions, ModifyOptions, StreamHandler, AggregateChainable, ComponentOptions, UpdateManyOptions, CreateManyOptions, Extension, Policy } from "../types/component";
 import PlatformBaseClient from "./platformBaseClient";
 import { AxiosResponse } from "axios";
-export default class Component extends PlatformBaseClient {
+import type { ComponentModels, ComponentFunctions } from "../types/functions";
+type ComponentModel<C extends string> = C extends keyof ComponentModels ? ComponentModels[C] : Model;
+type ComponentFnInput<C extends string, F extends string> = C extends keyof ComponentFunctions ? F extends keyof ComponentFunctions[C] ? ComponentFunctions[C][F] extends {
+    input: infer I;
+} ? I : any : any : any;
+type ComponentFnOutput<C extends string, F extends string> = C extends keyof ComponentFunctions ? F extends keyof ComponentFunctions[C] ? ComponentFunctions[C][F] extends {
+    output: infer O;
+} ? O : any : any : any;
+export default class Component<C extends string = string> extends PlatformBaseClient {
     private ref;
-    constructor(ref?: string | null);
+    /**
+     * @param ref - Component ref (e.g. "ecommerce::order"). Passing a string
+     *   literal lets TypeScript infer the generic C and type find/create/function
+     *   results accordingly.
+     */
+    constructor(ref?: C | null);
     /**
      * Find method to search for models
      *
@@ -25,7 +38,12 @@ export default class Component extends PlatformBaseClient {
      *     }
      * )
      **/
-    find(filters: FindParams, opts?: FindOptions): Promise<AxiosResponse<FindResponse>>;
+    find(filters: FindParams, opts?: FindOptions): Promise<AxiosResponse<{
+        items: ComponentModel<C>[];
+        total: number;
+        page: number;
+        pages: number;
+    }>>;
     /**
      * FindOne method to search for a single model
      *
@@ -39,14 +57,14 @@ export default class Component extends PlatformBaseClient {
      *     name: "John Doe",
      * })
      **/
-    findOne(filter: FindAdvancedParams, opts: FindOptions): Promise<Model | null>;
+    findOne(filter: FindAdvancedParams, opts?: FindOptions): Promise<ComponentModel<C> | null>;
     /**
      * Get model by uuid
      *
      * @param uuid string - The uuid of the model
      * @returns (Promise<Model>)
      */
-    get(uuid: string): Promise<AxiosResponse<Model>>;
+    get(uuid: string): Promise<AxiosResponse<ComponentModel<C>>>;
     /**
      * Update model by uuid
      *
@@ -71,7 +89,7 @@ export default class Component extends PlatformBaseClient {
      *   $addToSet: { roles: "admin" }
      * }, opts)
      */
-    update(uuid: string, data: Record<string, any>, options: UpdateOptions): Promise<AxiosResponse<any, any>>;
+    update(uuid: string, data: Record<string, any>, options?: UpdateOptions): Promise<ComponentModel<C>>;
     /**
      * Update many models
      *
@@ -79,7 +97,7 @@ export default class Component extends PlatformBaseClient {
      * @param options
      * @returns
      */
-    updateMany(data: Record<string, any>[], options: UpdateManyOptions): Promise<AxiosResponse<any, any>>;
+    updateMany(data: Record<string, any>[], options?: UpdateManyOptions): Promise<AxiosResponse<any, any>>;
     /**
      * Create many models
      *
@@ -87,7 +105,7 @@ export default class Component extends PlatformBaseClient {
      * @param options
      * @returns
      */
-    createMany(data: Record<string, any>[], options: CreateManyOptions): Promise<AxiosResponse<any, any>>;
+    createMany(data: Record<string, any>[], options?: CreateManyOptions): Promise<AxiosResponse<any, any>>;
     /**
      * Modify models by filters
      *
@@ -106,7 +124,7 @@ export default class Component extends PlatformBaseClient {
      *   { upsert: false }
      * )
      */
-    modify(filters: Record<string, any>, data: Record<string, any>, options: ModifyOptions): Promise<AxiosResponse<any, any>>;
+    modify(filters: Record<string, any>, data: Record<string, any>, options?: ModifyOptions): Promise<AxiosResponse<any, any>>;
     /**
      * Concurrent update model by uuid with optimistic locking
      *
@@ -126,8 +144,8 @@ export default class Component extends PlatformBaseClient {
      *   $inc: { retry_count: 1 }
      * }, opts)
      */
-    concurrentUpdate(uuid: string, version: number, data: Record<string, any>, options: UpdateOptions): Promise<AxiosResponse<any, any>>;
-    create(model: Record<string, any>): Promise<AxiosResponse<any, any>>;
+    concurrentUpdate(uuid: string, version: number, data: Record<string, any>, options?: UpdateOptions): Promise<AxiosResponse<any, any>>;
+    create(model: C extends keyof ComponentModels ? Partial<ComponentModels[C]> & Record<string, any> : Record<string, any>): Promise<ComponentModel<C>>;
     delete(uuid: string): Promise<AxiosResponse<any, any>>;
     /**
      * Execute aggregate pipeline with optional streaming support
@@ -159,7 +177,7 @@ export default class Component extends PlatformBaseClient {
     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>>;
-    function(name: string, input: any): Promise<AxiosResponse<any, any>>;
+    function<F extends string>(name: F, input?: ComponentFnInput<C, F>): Promise<ComponentFnOutput<C, F>>;
     revisions(uuid: string): Promise<AxiosResponse<any, any>>;
     /**
      * Get a single extension by name from the component

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

@@ -1,18 +1,30 @@
 import PlatformBaseClient from "./platformBaseClient";
+import type { PlatformFunctions, FunctionInput, FunctionOutput } from "../types/functions";
 export default class Functions extends PlatformBaseClient {
     list(): Promise<any>;
     get(ref: string): Promise<any>;
     update(uuid: string, update: any): Promise<any>;
     /**
-     * Run platform function
+     * Run a platform function.
      *
-     * @param id - Function ID
-     * @param d - Object containing input data, query parameters, and headers
-     * @returns - Function result
+     * When the function name is registered in `PlatformFunctions`, input and
+     * output types are inferred automatically from the IDL signature.
+     * Register signatures by running `ptkl generate-types` in your project.
      *
      * @example
-     * const result = await platform.function().run("myFunction", {input: { foo: "bar" }})
+     * // Typed — "send_email" is registered in PlatformFunctions
+     * const result = await fn.run("send_email", { input: { body: "hi", to: "a@b.com" } })
+     * // result: { status: boolean }
+     *
+     * @example
+     * // Untyped fallback for unregistered names
+     * const result = await fn.run("unknown_func", { input: { foo: "bar" } })
      */
+    run<K extends keyof PlatformFunctions>(id: K, d: {
+        input?: FunctionInput<K>;
+        query?: Record<string, string>;
+        headers?: Record<string, string>;
+    }): Promise<FunctionOutput<K>>;
     run(id: string, d: {
         input?: Record<string, any>;
         query?: Record<string, string>;

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

@@ -1,3 +1,4 @@
+export type { PlatformFunctions, PlatformFunction, FunctionInput, FunctionOutput, FunctionCallParams, ComponentModels, ComponentFunctions, ComponentModel, ComponentFunctionInput, ComponentFunctionOutput, } from '../types/functions';
 export { default as Component } from './component';
 export { default as Platform } from './platform';
 export { default as Functions } from './functions';
@@ -22,3 +23,4 @@ export { default as SerbiaMinFin } from './integrations/serbia/minfin';
 export { default as NBS } from './integrations/serbia/nbs';
 export { default as VPFR } from './integrations/serbia/minfin/vpfr';
 export { default as Mail } from './integrations/mail';
+export { default as Ecommerce } from './integrations/ecommerce';

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

@@ -0,0 +1,42 @@
+import IntegrationsBaseClient from "../integrationsBaseClient";
+import { EcommerceIntegrationUser, UpdateEcommerceSettingsRequest, CheckDomainResponse, AddDomainResponse, DomainsResponse } from "../../types/integrations/ecommerce";
+export default class Ecommerce extends IntegrationsBaseClient {
+    /**
+     * Get the ecommerce integration user for the current project.
+     */
+    get(): Promise<EcommerceIntegrationUser>;
+    /**
+     * Update ecommerce integration settings (onboarding or partial update).
+     */
+    update(req: UpdateEcommerceSettingsRequest): Promise<EcommerceIntegrationUser>;
+    /**
+     * Check whether a base domain subdomain is available.
+     */
+    checkBaseDomain(domain: string): Promise<CheckDomainResponse>;
+    /**
+     * Add a custom domain (returns a verification token for DNS validation).
+     */
+    addCustomDomain(domain: string): Promise<AddDomainResponse>;
+    /**
+     * Validate a custom domain with its verification token.
+     */
+    validateCustomDomain(domain: string, token: string): Promise<{
+        integration: EcommerceIntegrationUser;
+        message: string;
+    }>;
+    /**
+     * Remove a custom domain.
+     */
+    removeCustomDomain(domain: string): Promise<{
+        integration: EcommerceIntegrationUser;
+        message: string;
+    }>;
+    /**
+     * List pending (unvalidated) custom domains.
+     */
+    getPendingDomains(): Promise<DomainsResponse>;
+    /**
+     * List validated custom domains.
+     */
+    getValidatedDomains(): Promise<DomainsResponse>;
+}

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

@@ -6,6 +6,7 @@ import IntegrationsBaseClient from "./integrationsBaseClient";
 import Payments from "./integrations/payments";
 import Minimax from "./integrations/minimax";
 import NBS from "./integrations/serbia/nbs";
+import Ecommerce from "./integrations/ecommerce";
 export default class Integrations extends IntegrationsBaseClient {
     private integrations;
     constructor(options?: {
@@ -20,6 +21,7 @@ export default class Integrations extends IntegrationsBaseClient {
     getMail(): Mail;
     getNBS(): NBS;
     getSerbiaMinFin(): MinFin;
+    getEcommerce(): Ecommerce;
     isInstalled(id: string): Promise<boolean>;
     getInterfaceOf(id: string): any;
 }

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

@@ -22,7 +22,7 @@ export default class Platform extends PlatformBaseClient {
     user(): Users;
     app(appType: string): Apps;
     forge(): Forge;
-    component(ref: string): Component;
+    component<C extends string>(ref: C): Component<C>;
     componentUtils(): ComponentUtils;
     ratchet(): Ratchet;
     sandbox(): Sandbox;

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

@@ -1,4 +1,41 @@
 import PlatformBaseClient from "./platformBaseClient";
+export type IDLAllResponse = {
+    components: Record<string, unknown>;
+    functions: Record<string, unknown>;
+};
+export type IDLValidateRequest = {
+    /** Compound ref, e.g. "component:ns::name", "pfn:fnName". Mutually exclusive with `idl`. */
+    ref?: string;
+    /** Inline IDL to validate against. Mutually exclusive with `ref`. */
+    idl?: Record<string, unknown>;
+    /** Field key to validate (required for component/extension refs, ignored for pfn). */
+    field?: string;
+    /** The value to validate. */
+    value: unknown;
+};
+export type IDLValidateResponse = {
+    valid: boolean;
+    errors?: Array<{
+        field?: string;
+        message: string;
+    }>;
+};
 export default class System extends PlatformBaseClient {
-    resourceResolver(ref: string, resourceName: string, format?: string): Promise<import("axios").AxiosResponse<any, any>>;
+    /**
+     * Returns all IDL definitions for the current project.
+     * Used by `ptkl generate-types` to emit typed `.d.ts` augmentations.
+     */
+    idl(): Promise<{
+        data: IDLAllResponse;
+    }>;
+    /**
+     * Validates a value against an IDL — either by ref or with an inline IDL object.
+     * Returns `{ data: { valid: true } }` on success or
+     * `{ data: { valid: false, errors: [...] } }` on validation failure.
+     * Throws on HTTP errors (4xx/5xx).
+     */
+    idlValidate(req: IDLValidateRequest): Promise<{
+        data: IDLValidateResponse;
+    }>;
+    resourceResolver(prn: string, format?: string): Promise<import("axios").AxiosResponse<any, any>>;
 }