@ptkl/sdk 1.3.4 → 1.5.0

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

@@ -0,0 +1,199 @@
+export type IDNamePair = {
+    id: string;
+    name: string;
+};
+export type ShippingMethodsConfig = {
+    methods: IDNamePair[];
+};
+export type PaymentMethodsConfig = {
+    methods: IDNamePair[];
+};
+export type PaymentProvidersConfig = {
+    options?: IDNamePair;
+};
+export type CartSettings = {
+    shipping_methods: ShippingMethodsConfig;
+    payment_methods: PaymentMethodsConfig;
+    payment_providers: PaymentProvidersConfig;
+};
+export type PriceSettings = {
+    default_currency: IDNamePair;
+};
+export type I18nSettings = {
+    default_locale: IDNamePair;
+    locales: IDNamePair[];
+};
+export type LogoConfig = {
+    position: number;
+    src: string;
+    alt: string;
+    width: number;
+    height: number;
+};
+export type ItemsConfig = {
+    position: number;
+    menu: IDNamePair;
+};
+export type ActionsConfig = {
+    position: number;
+    icons: Record<string, any>;
+};
+export type HeaderSettings = {
+    logo: LogoConfig;
+    items: ItemsConfig;
+    actions: ActionsConfig;
+};
+export type HomepageSection = {
+    id: string;
+    type: string;
+    show: boolean;
+    settings: Record<string, any>;
+};
+export type HomepageSettings = {
+    sections: HomepageSection[];
+};
+export type CategoryInfoConfig = {
+    text_position: IDNamePair;
+    show_title: boolean;
+    show_description: boolean;
+    show_image: boolean;
+};
+export type CategoryHeaderConfig = {
+    use_breadcrumbs: boolean;
+    category_info: CategoryInfoConfig;
+};
+export type CategoryFiltersConfig = {
+    show: boolean;
+    type: IDNamePair;
+    use_accordion: boolean;
+};
+export type CategorySettings = {
+    header: CategoryHeaderConfig;
+    filters: CategoryFiltersConfig;
+};
+export type DisplayConfig = {
+    show: boolean;
+    text_position: IDNamePair;
+    position: number;
+};
+export type SimpleDisplayConfig = {
+    show: boolean;
+};
+export type InventoryConfig = {
+    show: boolean;
+    text_position: IDNamePair;
+    position: number;
+    allow_backorder: boolean;
+};
+export type ActionButtonConfig = {
+    icon: IDNamePair;
+    button_variant: IDNamePair;
+    show: boolean;
+};
+export type ProductActionsConfig = {
+    position: number;
+    align: IDNamePair;
+    add_to_cart: ActionButtonConfig;
+    add_to_wishlist: ActionButtonConfig;
+};
+export type QuantitySelectorConfig = {
+    show: boolean;
+    text_position: IDNamePair;
+};
+export type ProductInfoConfig = {
+    title: DisplayConfig;
+    sku: DisplayConfig;
+    stock_status: SimpleDisplayConfig;
+    inventory: InventoryConfig;
+    description: DisplayConfig;
+    variants: DisplayConfig;
+    price: DisplayConfig;
+    actions: ProductActionsConfig;
+    discount_badge?: SimpleDisplayConfig;
+    quantity_selector?: QuantitySelectorConfig;
+    specifications?: SimpleDisplayConfig;
+};
+export type ProductSettings = {
+    product_info: ProductInfoConfig;
+};
+export type FooterLogoConfig = {
+    src: string;
+    alt: string;
+    width: number;
+    height: number;
+};
+export type FooterColumnOne = {
+    logo: FooterLogoConfig;
+    socials: any[];
+};
+export type FooterSettings = {
+    column_one: FooterColumnOne;
+};
+export type EcommerceSettings = {
+    maintenance: boolean;
+    cart: CartSettings;
+    price: PriceSettings;
+    i18n: I18nSettings;
+    header: HeaderSettings;
+    homepage: HomepageSettings;
+    category: CategorySettings;
+    product: ProductSettings;
+    footer: FooterSettings;
+    theme?: any;
+};
+export type EcommEnvSettings = {
+    dev: EcommerceSettings | null;
+    live: EcommerceSettings | null;
+};
+export type CompanyInfo = {
+    vat_number: string;
+    legal_name: string;
+    company_name: string;
+    address: string;
+    city: string;
+    zip_code: string;
+    phone: string;
+    email: string;
+    legal_representative: string;
+    additional_info?: Record<string, any>;
+};
+export type Documentation = {
+    terms_of_service: string | null;
+    privacy_policy: string | null;
+};
+export type EcommerceIntegrationUser = {
+    project_uuid: string;
+    base_domain: string;
+    custom_domains: string[];
+    company: CompanyInfo;
+    merchant_description: string;
+    mcc: string[];
+    documentation: Documentation;
+    product_types: string[];
+    settings: EcommEnvSettings;
+    data: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string | null;
+};
+export type UpdateEcommerceSettingsRequest = {
+    base_domain?: string;
+    custom_domains?: string[];
+    company?: Partial<CompanyInfo>;
+    merchant_description?: string;
+    mcc?: string[];
+    product_types?: string[];
+    documentation?: Partial<Documentation>;
+    settings?: Partial<EcommEnvSettings>;
+};
+export type CheckDomainResponse = {
+    domain: string;
+    available: boolean;
+};
+export type AddDomainResponse = {
+    integration: EcommerceIntegrationUser;
+    verification_token: string;
+};
+export type DomainsResponse = {
+    domains: string[];
+};

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

@@ -45,7 +45,7 @@ export default class Component extends PlatformBaseClient {
      *     name: "John Doe",
      * })
      **/
-    findOne(filter: FindAdvancedParams, opts: FindOptions): Promise<Model | null>;
+    findOne(filter: FindAdvancedParams, opts?: FindOptions): Promise<Model | null>;
     /**
      * Get model by uuid
      *
@@ -60,7 +60,7 @@ export default class Component extends PlatformBaseClient {
      * @param data
      * @returns
      */
-    update(uuid: string, data: Record<string, any>, options: UpdateOptions): Promise<AxiosResponse<any, any>>;
+    update(uuid: string, data: Record<string, any>, options?: UpdateOptions): Promise<AxiosResponse<any, any>>;
     /**
      * Update many models
      *
@@ -68,7 +68,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
      *
@@ -76,7 +76,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
      *
@@ -84,7 +84,7 @@ export default class Component extends PlatformBaseClient {
      * @param options
      * @returns
      */
-    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
      *
@@ -93,7 +93,7 @@ export default class Component extends PlatformBaseClient {
      * @param data
      * @returns
      */
-    concurrentUpdate(uuid: string, version: number, data: Record<string, any>, options: UpdateOptions): Promise<AxiosResponse<any, any>>;
+    concurrentUpdate(uuid: string, version: number, data: Record<string, any>, options?: UpdateOptions): Promise<AxiosResponse<any, any>>;
     create(model: Record<string, any>): Promise<AxiosResponse<any, any>>;
     delete(uuid: string): Promise<AxiosResponse<any, any>>;
     /**

package/dist/v0.9/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.9/api/index.d.ts

@@ -21,5 +21,6 @@ export { default as DMS } from './integrations/dms';
 export { default as SerbiaUtil } from './integrations/serbiaUtil';
 export { default as VPFR } from './integrations/vpfr';
 export { default as Mail } from './integrations/mail';
+export { default as Ecommerce } from './integrations/ecommerce';
 import Platfrom from './platform';
 export default Platfrom;

package/dist/v0.9/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.9/api/integrations.d.ts

@@ -5,6 +5,7 @@ import VPFR from "./integrations/vpfr";
 import IntegrationsBaseClient from "./integrationsBaseClient";
 import Payments from "./integrations/payments";
 import Minimax from "./integrations/minimax";
+import Ecommerce from "./integrations/ecommerce";
 export default class Integrations extends IntegrationsBaseClient {
     private integrations;
     constructor(options?: {
@@ -19,6 +20,7 @@ export default class Integrations extends IntegrationsBaseClient {
     getMail(): Mail;
     getPayments(): Payments;
     getMinimax(): Minimax;
+    getEcommerce(): Ecommerce;
     isInstalled(id: string): Promise<boolean>;
     getInterfaceOf(id: string): any;
 }

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

@@ -1,4 +1,4 @@
 import PlatformBaseClient from "./platformBaseClient";
 export default class System extends PlatformBaseClient {
-    resourceResolver(ref: string, resourceName: string, format?: string): Promise<import("axios").AxiosResponse<any, any>>;
+    resourceResolver(prn: string, format?: string): Promise<import("axios").AxiosResponse<any, any>>;
 }

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

@@ -19016,11 +19016,15 @@ class PlatformBaseClient extends BaseClient {
             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';
                 }
             }
         }
@@ -19045,8 +19049,7 @@ class PlatformBaseClient extends BaseClient {
             headers: {
                 ...headers,
                 'Content-Type': 'application/json',
-            },
-            withCredentials: true,
+            }
         });
         super(client);
         this.env = null;
@@ -19204,7 +19207,7 @@ class Component extends PlatformBaseClient {
     async updateMany(data, options) {
         return await this.client.patch(`${this.getComponentPath()}/models/bulk`, {
             data,
-            options
+            options,
         });
     }
     /**
@@ -19438,16 +19441,6 @@ class Functions extends PlatformBaseClient {
     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,
@@ -19891,10 +19884,9 @@ class Sandbox extends PlatformBaseClient {
 }
 
 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,
         });
     }
@@ -20221,11 +20213,15 @@ class IntegrationsBaseClient extends BaseClient {
             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';
                 }
             }
         }
@@ -20249,8 +20245,7 @@ class IntegrationsBaseClient extends BaseClient {
             timeout: 30000,
             headers: {
                 ...headers,
-            },
-            withCredentials: true,
+            }
         });
         super(client);
         this.env = null;
@@ -21859,6 +21854,57 @@ class Minimax extends IntegrationsBaseClient {
     }
 }
 
+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) {
@@ -21871,6 +21917,7 @@ class Integrations extends IntegrationsBaseClient {
             '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() {
@@ -21894,6 +21941,9 @@ class Integrations extends IntegrationsBaseClient {
     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;
@@ -21918,6 +21968,7 @@ exports.Component = Component;
 exports.ComponentUtils = ComponentUtils;
 exports.Config = Config;
 exports.DMS = DMS;
+exports.Ecommerce = Ecommerce;
 exports.Forge = Forge;
 exports.Functions = Functions;
 exports.Integration = Integrations;