@attlaz/client 1.83.0 → 1.84.0

package/dist/Client.d.ts

@@ -24,6 +24,7 @@ import { PlatformLanguageEndpoint } from './Service/PlatformLanguageEndpoint.js'
 import { ProjectEndpoint } from './Service/ProjectEndpoint.js';
 import { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
 import { ProviderTokenEndpoint } from './Service/ProviderTokenEndpoint.js';
+import { VendorProductEndpoint } from './Service/Pulse/VendorProductEndpoint.js';
 import { RunnerEndpoint } from './Service/RunnerEndpoint.js';
 import { RunnerPoolEndpoint } from './Service/RunnerPoolEndpoint.js';
 import { SearchEndpoint } from './Service/SearchEndpoint.js';
@@ -109,6 +110,7 @@ export declare class Client {
     getRunnerPoolEndpoint(): RunnerPoolEndpoint;
     getProviderTokenEndpoint(): ProviderTokenEndpoint;
     getFirewallEndpoint(): FirewallEndpoint;
+    getVendorProductEndpoint(): VendorProductEndpoint;
     private getEndpoint;
     getVersion(): string;
 }

package/dist/Client.js

@@ -24,6 +24,7 @@ import { PlatformLanguageEndpoint } from './Service/PlatformLanguageEndpoint.js'
 import { ProjectEndpoint } from './Service/ProjectEndpoint.js';
 import { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
 import { ProviderTokenEndpoint } from './Service/ProviderTokenEndpoint.js';
+import { VendorProductEndpoint } from './Service/Pulse/VendorProductEndpoint.js';
 import { RunnerEndpoint } from './Service/RunnerEndpoint.js';
 import { RunnerPoolEndpoint } from './Service/RunnerPoolEndpoint.js';
 import { SearchEndpoint } from './Service/SearchEndpoint.js';
@@ -75,6 +76,7 @@ export class Client {
         CollectionsEndpoint,
         RunnerPoolEndpoint,
         ProviderTokenEndpoint,
+        VendorProductEndpoint,
     };
     apiEndpoint = 'https://api.attlaz.com';
     constructor(token = null, config = {}) {
@@ -256,6 +258,9 @@ export class Client {
     getFirewallEndpoint() {
         return this.getEndpoint('firewall', this.Store.FirewallEndpoint);
     }
+    getVendorProductEndpoint() {
+        return this.getEndpoint('vendor-product', this.Store.VendorProductEndpoint);
+    }
     getEndpoint(key, ClassName) {
         if (!this.endpoints.has(key)) {
             try {

package/dist/Model/Pulse/VendorProduct.d.ts

@@ -0,0 +1,26 @@
+import { ApiRecord } from '../ApiRecord.js';
+/**
+ * A competitor's product as tracked by Market Pulse — the `/pulse/vendors/:vendorId/products`
+ * resource. `identifier` is the product's stable id on the competitor's site (the upsert key).
+ */
+export declare class VendorProduct {
+    id: string | null;
+    vendorId: string;
+    identifier: string;
+    name: string | null;
+    image: string | null;
+    gtin: string | null;
+    brand: string | null;
+    url: string | null;
+    sku: string | null;
+    currency: string | null;
+    price: number | null;
+    originalPrice: number | null;
+    shippingCost: number | null;
+    isInStock: boolean | null;
+    properties: Record<string, unknown> | null;
+    createdAt: Date | null;
+    updatedAt: Date | null;
+    constructor(vendorId: string, identifier: string);
+    static parse(raw: ApiRecord): VendorProduct;
+}

package/dist/Model/Pulse/VendorProduct.js

@@ -0,0 +1,53 @@
+/**
+ * A competitor's product as tracked by Market Pulse — the `/pulse/vendors/:vendorId/products`
+ * resource. `identifier` is the product's stable id on the competitor's site (the upsert key).
+ */
+export class VendorProduct {
+    id = null;
+    vendorId;
+    identifier;
+    name = null;
+    image = null;
+    gtin = null;
+    brand = null;
+    url = null;
+    sku = null;
+    currency = null;
+    price = null;
+    originalPrice = null;
+    shippingCost = null;
+    isInStock = null;
+    properties = null;
+    createdAt = null;
+    updatedAt = null;
+    constructor(vendorId, identifier) {
+        this.vendorId = vendorId;
+        this.identifier = identifier;
+    }
+    static parse(raw) {
+        const product = new VendorProduct(raw.vendor, raw.identifier);
+        product.id = raw.id ?? null;
+        product.name = raw.name ?? null;
+        product.image = raw.image ?? null;
+        product.gtin = raw.gtin ?? null;
+        product.brand = raw.brand ?? null;
+        product.url = raw.url ?? null;
+        product.sku = raw.sku ?? null;
+        product.currency = raw.currency ?? null;
+        product.price = toNumber(raw.price);
+        product.originalPrice = toNumber(raw.original_price);
+        product.shippingCost = toNumber(raw.shipping_cost);
+        product.isInStock = typeof raw.is_in_stock === 'boolean' ? raw.is_in_stock : null;
+        product.properties = raw.properties ?? null;
+        product.createdAt = raw.created_at ? new Date(raw.created_at) : null;
+        product.updatedAt = raw.updated_at ? new Date(raw.updated_at) : null;
+        return product;
+    }
+}
+function toNumber(value) {
+    if (value === null || value === undefined || value === '') {
+        return null;
+    }
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+}

package/dist/Service/Pulse/VendorProductEndpoint.d.ts

@@ -0,0 +1,14 @@
+import { VendorProduct } from '../../Model/Pulse/VendorProduct.js';
+import { Endpoint } from '../Endpoint.js';
+/**
+ * Market Pulse competitor products — `/pulse/vendors/:vendorId/products`. Mirrors the PHP client's
+ * MarketPulse\VendorProductEndpoint so the (Node) scraper can upsert competitor products.
+ */
+export declare class VendorProductEndpoint extends Endpoint {
+    /** The product with this identifier for the vendor, or null. */
+    getByIdentifier(vendorId: string, identifier: string): Promise<VendorProduct | null>;
+    /** Create a new vendor product. */
+    save(product: VendorProduct): Promise<VendorProduct>;
+    /** Update the mutable fields of an existing vendor product (JSON-patch style, per the API). */
+    update(product: VendorProduct): Promise<void>;
+}

package/dist/Service/Pulse/VendorProductEndpoint.js

@@ -0,0 +1,49 @@
+import { VendorProduct } from '../../Model/Pulse/VendorProduct.js';
+import { Endpoint } from '../Endpoint.js';
+/**
+ * Market Pulse competitor products — `/pulse/vendors/:vendorId/products`. Mirrors the PHP client's
+ * MarketPulse\VendorProductEndpoint so the (Node) scraper can upsert competitor products.
+ */
+export class VendorProductEndpoint extends Endpoint {
+    /** The product with this identifier for the vendor, or null. */
+    async getByIdentifier(vendorId, identifier) {
+        const result = await this.requestCollection('/pulse/vendors/' + vendorId + '/products?identifier=' + encodeURIComponent(identifier), VendorProduct.parse);
+        const products = result.getData();
+        return products.length > 0 ? products[0] : null;
+    }
+    /** Create a new vendor product. */
+    async save(product) {
+        // camelCase keys are snake_cased by the base Endpoint (originalPrice -> original_price, ...).
+        const body = {
+            name: product.name,
+            image: product.image,
+            identifier: product.identifier,
+            gtin: product.gtin,
+            brand: product.brand,
+            url: product.url,
+            currency: product.currency,
+            price: product.price,
+            originalPrice: product.originalPrice,
+            shippingCost: product.shippingCost,
+            isInStock: product.isInStock,
+            properties: product.properties,
+        };
+        const result = await this.requestObject('/pulse/vendors/' + product.vendorId + '/products', body, VendorProduct.parse, 'POST');
+        return result.getData() ?? product;
+    }
+    /** Update the mutable fields of an existing vendor product (JSON-patch style, per the API). */
+    async update(product) {
+        const operations = [
+            { op: 'add', path: 'price', value: product.price },
+            { op: 'add', path: 'original_price', value: product.originalPrice },
+            { op: 'add', path: 'brand', value: product.brand },
+            { op: 'add', path: 'shipping_cost', value: product.shippingCost },
+            { op: 'add', path: 'is_in_stock', value: product.isInStock },
+            { op: 'add', path: 'url', value: product.url },
+            { op: 'add', path: 'gtin', value: product.gtin },
+            { op: 'add', path: 'image', value: product.image },
+            { op: 'add', path: 'properties', value: product.properties },
+        ];
+        await this.requestObject('/pulse/vendors/' + product.vendorId + '/products/' + product.id, operations, (raw) => raw, 'PATCH');
+    }
+}

package/dist/index.d.ts

@@ -79,6 +79,8 @@ export { ObjectResult } from './Model/Result/ObjectResult.js';
 export { ResultError } from './Model/Result/ResultError.js';
 export { StorageInformation } from './Model/Storage/StorageInformation.js';
 export { StorageType } from './Model/Storage/StorageType.js';
+export { VendorProduct } from './Model/Pulse/VendorProduct.js';
+export { VendorProductEndpoint } from './Service/Pulse/VendorProductEndpoint.js';
 export { StorageItem } from './Model/Storage/StorageItem.js';
 export { StorageItemInformation } from './Model/Storage/StorageItemInformation.js';
 /** Queue * */

package/dist/index.js

@@ -67,6 +67,8 @@ export { ObjectResult } from './Model/Result/ObjectResult.js';
 export { ResultError } from './Model/Result/ResultError.js';
 export { StorageInformation } from './Model/Storage/StorageInformation.js';
 export { StorageType } from './Model/Storage/StorageType.js';
+export { VendorProduct } from './Model/Pulse/VendorProduct.js';
+export { VendorProductEndpoint } from './Service/Pulse/VendorProductEndpoint.js';
 export { StorageItem } from './Model/Storage/StorageItem.js';
 export { StorageItemInformation } from './Model/Storage/StorageItemInformation.js';
 /** Queue * */

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.82.0";
+export declare const VERSION = "1.83.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.82.0";
+export const VERSION = "1.83.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attlaz/client",
-  "version": "1.83.0",
+  "version": "1.84.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",