@attlaz/client 1.97.0 → 1.99.0

package/dist/Client.d.ts

@@ -8,6 +8,7 @@ import { ChannelEndpoint } from './Service/ChannelEndpoint.js';
 import { CodeDeployEndpoint } from './Service/CodeDeployEndpoint.js';
 import { CodeSourceStrategiesEndpoint } from './Service/CodeSourceStrategiesEndpoint.js';
 import { CollectionsEndpoint } from './Service/CollectionsEndpoint.js';
+import { ComponentEndpoint } from './Service/ComponentEndpoint.js';
 import { CommandExecutionEndpoint } from './Service/CommandExecutionEndpoint.js';
 import { ConfigEndpoint } from './Service/ConfigEndpoint.js';
 import { ConfigurationEndpoint } from './Service/ConfigurationEndpoint.js';
@@ -20,6 +21,7 @@ import { HealthAlertEndpoint } from './Service/HealthAlertEndpoint.js';
 import { InboxEndpoint } from './Service/InboxEndpoint.js';
 import { LogEndpoint } from './Logging/Service/LogEndpoint.js';
 import { PlatformEndpoint } from './Service/PlatformEndpoint.js';
+import { TimezoneEndpoint } from './Service/TimezoneEndpoint.js';
 import { PlatformLanguageEndpoint } from './Service/PlatformLanguageEndpoint.js';
 import { ProjectEndpoint } from './Service/ProjectEndpoint.js';
 import { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
@@ -37,6 +39,7 @@ import { ProductGroupEndpoint } from './MarketPulse/Service/ProductGroupEndpoint
 import { CatalogProductEndpoint } from './Catalog/Service/CatalogProductEndpoint.js';
 import { GenerateContentEndpoint } from './DataEnrichment/Service/GenerateContentEndpoint.js';
 import { CompetitorEndpoint } from './MarketPulse/Service/CompetitorEndpoint.js';
+import { VendorEndpoint } from './MarketPulse/Service/VendorEndpoint.js';
 import { PulseStatisticsEndpoint } from './MarketPulse/Service/PulseStatisticsEndpoint.js';
 import { QualityEndpoint } from './DataQuality/Service/QualityEndpoint.js';
 import { CatalogFeedEndpoint } from './FeedManagement/Service/CatalogFeedEndpoint.js';
@@ -100,6 +103,7 @@ export declare class Client {
     getConfigEndpoint(): ConfigEndpoint;
     getInboxEndpoint(): InboxEndpoint;
     getPlatformEndpoint(): PlatformEndpoint;
+    getTimezoneEndpoint(): TimezoneEndpoint;
     getSubscriberEndpoint(): SubscriberEndpoint;
     getLogEndPoint(): LogEndpoint;
     getFlowEndpoint(): FlowEndpoint;
@@ -121,6 +125,7 @@ export declare class Client {
     getUserActionEndpoint(): UserActionEndpoint;
     getCommandExecutionEndpoint(): CommandExecutionEndpoint;
     getAccessTokenEndpoint(): AccessTokenEndpoint;
+    getComponentEndpoint(): ComponentEndpoint;
     getCollectionsEndpoint(): CollectionsEndpoint;
     getRunnerPoolEndpoint(): RunnerPoolEndpoint;
     getProviderTokenEndpoint(): ProviderTokenEndpoint;
@@ -138,6 +143,7 @@ export declare class Client {
     getProductGroupEndpoint(): ProductGroupEndpoint;
     getGenerateContentEndpoint(): GenerateContentEndpoint;
     getCompetitorEndpoint(): CompetitorEndpoint;
+    getVendorEndpoint(): VendorEndpoint;
     getPulseStatisticsEndpoint(): PulseStatisticsEndpoint;
     getQualityEndpoint(): QualityEndpoint;
     getCatalogFeedEndpoint(): CatalogFeedEndpoint;

package/dist/Client.js

@@ -8,6 +8,7 @@ import { ChannelEndpoint } from './Service/ChannelEndpoint.js';
 import { CodeDeployEndpoint } from './Service/CodeDeployEndpoint.js';
 import { CodeSourceStrategiesEndpoint } from './Service/CodeSourceStrategiesEndpoint.js';
 import { CollectionsEndpoint } from './Service/CollectionsEndpoint.js';
+import { ComponentEndpoint } from './Service/ComponentEndpoint.js';
 import { CommandExecutionEndpoint } from './Service/CommandExecutionEndpoint.js';
 import { ConfigEndpoint } from './Service/ConfigEndpoint.js';
 import { ConfigurationEndpoint } from './Service/ConfigurationEndpoint.js';
@@ -20,6 +21,7 @@ import { HealthAlertEndpoint } from './Service/HealthAlertEndpoint.js';
 import { InboxEndpoint } from './Service/InboxEndpoint.js';
 import { LogEndpoint } from './Logging/Service/LogEndpoint.js';
 import { PlatformEndpoint } from './Service/PlatformEndpoint.js';
+import { TimezoneEndpoint } from './Service/TimezoneEndpoint.js';
 import { PlatformLanguageEndpoint } from './Service/PlatformLanguageEndpoint.js';
 import { ProjectEndpoint } from './Service/ProjectEndpoint.js';
 import { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
@@ -37,6 +39,7 @@ import { ProductGroupEndpoint } from './MarketPulse/Service/ProductGroupEndpoint
 import { CatalogProductEndpoint } from './Catalog/Service/CatalogProductEndpoint.js';
 import { GenerateContentEndpoint } from './DataEnrichment/Service/GenerateContentEndpoint.js';
 import { CompetitorEndpoint } from './MarketPulse/Service/CompetitorEndpoint.js';
+import { VendorEndpoint } from './MarketPulse/Service/VendorEndpoint.js';
 import { PulseStatisticsEndpoint } from './MarketPulse/Service/PulseStatisticsEndpoint.js';
 import { QualityEndpoint } from './DataQuality/Service/QualityEndpoint.js';
 import { CatalogFeedEndpoint } from './FeedManagement/Service/CatalogFeedEndpoint.js';
@@ -62,6 +65,7 @@ export class Client {
         AdapterEndpoint,
         ChannelEndpoint,
         CodeDeployEndpoint,
+        ComponentEndpoint,
         CodeSourceStrategiesEndpoint,
         CommandExecutionEndpoint,
         ConfigEndpoint,
@@ -74,6 +78,7 @@ export class Client {
         InboxEndpoint,
         LogEndpoint,
         PlatformEndpoint,
+        TimezoneEndpoint,
         PlatformLanguageEndpoint,
         ProjectEndpoint,
         ProjectEnvironmentEndpoint,
@@ -104,6 +109,7 @@ export class Client {
         CatalogProductEndpoint,
         GenerateContentEndpoint,
         CompetitorEndpoint,
+        VendorEndpoint,
         PulseStatisticsEndpoint,
         QualityEndpoint,
         CatalogFeedEndpoint,
@@ -213,6 +219,9 @@ export class Client {
     getPlatformEndpoint() {
         return this.getEndpoint('platform', this.Store.PlatformEndpoint);
     }
+    getTimezoneEndpoint() {
+        return this.getEndpoint('timezone', this.Store.TimezoneEndpoint);
+    }
     getSubscriberEndpoint() {
         return this.getEndpoint('subscriber', this.Store.SubscriberEndpoint);
     }
@@ -276,6 +285,9 @@ export class Client {
     getAccessTokenEndpoint() {
         return this.getEndpoint('accesstoken', this.Store.AccessTokenEndpoint);
     }
+    getComponentEndpoint() {
+        return this.getEndpoint('component', this.Store.ComponentEndpoint);
+    }
     getCollectionsEndpoint() {
         return this.getEndpoint('collections', this.Store.CollectionsEndpoint);
     }
@@ -327,6 +339,9 @@ export class Client {
     getCompetitorEndpoint() {
         return this.getEndpoint('competitor', this.Store.CompetitorEndpoint);
     }
+    getVendorEndpoint() {
+        return this.getEndpoint('vendor', this.Store.VendorEndpoint);
+    }
     getPulseStatisticsEndpoint() {
         return this.getEndpoint('pulse-statistics', this.Store.PulseStatisticsEndpoint);
     }

package/dist/MarketPulse/Model/Competitor.d.ts

@@ -11,11 +11,12 @@ export declare class Competitor {
     id: string;
     vendorId: string;
     name: string;
-    domain: string;
+    /** The competitor's storefront root, scheme included — e.g. `https://shop.com/nl`. */
+    url: string;
     icon: string | null;
     type: string | null;
-    /** Which index (embedding set) the competitor's products are held in. */
-    index: string;
+    /** ISO 4217 code this storefront quotes prices in. */
+    currency: string | null;
     matchCount: number;
     productCount: number;
     priceIndex: number;

package/dist/MarketPulse/Model/Competitor.js

@@ -10,11 +10,12 @@ export class Competitor {
     id;
     vendorId;
     name;
-    domain = '';
+    /** The competitor's storefront root, scheme included — e.g. `https://shop.com/nl`. */
+    url = '';
     icon = null;
     type = null;
-    /** Which index (embedding set) the competitor's products are held in. */
-    index = '';
+    /** ISO 4217 code this storefront quotes prices in. */
+    currency = null;
     matchCount = 0;
     productCount = 0;
     priceIndex = 0;
@@ -28,10 +29,10 @@ export class Competitor {
     }
     static parse(raw) {
         const competitor = new Competitor(raw.id, raw.vendor, raw.name ?? '');
-        competitor.domain = raw.domain ?? '';
+        competitor.url = raw.url ?? '';
         competitor.icon = raw.icon ?? null;
         competitor.type = raw.type ?? null;
-        competitor.index = raw.index ?? '';
+        competitor.currency = raw.currency ?? null;
         competitor.matchCount = Number(raw.match_count ?? 0);
         competitor.productCount = Number(raw.product_count ?? 0);
         competitor.priceIndex = Number(raw.price_index ?? 0);

package/dist/MarketPulse/Model/MatchedVendorProduct.d.ts

@@ -19,10 +19,16 @@ export declare class MatchedVendorProduct {
     image: string | null;
     brand: string | null;
     gtin: string | null;
+    sku: string | null;
     url: string | null;
     price: number;
+    originalPrice: number | null;
+    /** ISO 4217. Null falls back to the vendor's currency — never assume EUR when rendering. */
+    currency: string | null;
     shippingCost: number;
     inStock: boolean | null;
+    /** The scraped attribute bag (category, tags, variant options). Keys are data, not schema. */
+    properties: Record<string, unknown> | null;
     updatedAt: Date | null;
     constructor(id: string);
     static parse(raw: ApiRecord): MatchedVendorProduct;

package/dist/MarketPulse/Model/MatchedVendorProduct.js

@@ -18,10 +18,16 @@ export class MatchedVendorProduct {
     image = null;
     brand = null;
     gtin = null;
+    sku = null;
     url = null;
     price = 0;
+    originalPrice = null;
+    /** ISO 4217. Null falls back to the vendor's currency — never assume EUR when rendering. */
+    currency = null;
     shippingCost = 0;
     inStock = null;
+    /** The scraped attribute bag (category, tags, variant options). Keys are data, not schema. */
+    properties = null;
     updatedAt = null;
     constructor(id) {
         this.id = id;
@@ -38,10 +44,16 @@ export class MatchedVendorProduct {
         product.image = raw.image ?? null;
         product.brand = raw.brand ?? null;
         product.gtin = raw.gtin ?? null;
+        product.sku = raw.sku ?? null;
         product.url = raw.url ?? null;
         product.price = parseFloat(raw.price) || 0;
+        product.originalPrice = raw.original_price === null || raw.original_price === undefined
+            ? null
+            : parseFloat(raw.original_price);
+        product.currency = raw.currency ?? null;
         product.shippingCost = parseFloat(raw.shipping_cost) || 0;
         product.inStock = typeof raw.in_stock === 'boolean' ? raw.in_stock : null;
+        product.properties = raw.properties ?? null;
         product.updatedAt = raw.updated ? new Date(raw.updated) : null;
         return product;
     }

package/dist/MarketPulse/Model/ReviewMatch.d.ts

@@ -6,11 +6,19 @@ export type ReviewProduct = {
     name: string;
     brand: string | null;
     gtin: string | null;
+    sku: string | null;
     price: number | null;
+    originalPrice: number | null;
+    /** ISO 4217. Null falls back to the vendor's currency — never assume EUR when rendering. */
+    currency: string | null;
+    shippingCost: number | null;
     url: string | null;
     image: string | null;
+    /** Lifted out of {@link properties} because the matcher scores against it. */
     category: string | null;
     inStock: boolean | null;
+    /** The scraped attribute bag (tags, variant options, …). Keys are data, not schema. */
+    properties: Record<string, unknown> | null;
 };
 /** The competitor side additionally names the vendor it came from. */
 export type ReviewCompetitorProduct = ReviewProduct & {

package/dist/MarketPulse/Model/ReviewMatch.js

@@ -45,11 +45,16 @@ export class ReviewMatch {
             name: raw.name,
             brand: raw.brand ?? null,
             gtin: raw.gtin ?? null,
+            sku: raw.sku ?? null,
             price: raw.price ?? null,
+            originalPrice: raw.original_price ?? null,
+            currency: raw.currency ?? null,
+            shippingCost: raw.shipping_cost ?? null,
             url: raw.url ?? null,
             image: raw.image ?? null,
             category: raw.category ?? null,
             inStock: typeof raw.in_stock === 'boolean' ? raw.in_stock : null,
+            properties: raw.properties ?? null,
         };
     }
 }

package/dist/MarketPulse/Model/TopCompetitor.d.ts

@@ -10,7 +10,7 @@ export declare class TopCompetitor {
     competitorId: string;
     vendorId: string;
     vendorName: string;
-    vendorDomain: string;
+    vendorUrl: string;
     vendorIcon: string | null;
     matchCount: number;
     productCount: number;

package/dist/MarketPulse/Model/TopCompetitor.js

@@ -9,7 +9,7 @@ export class TopCompetitor {
     competitorId;
     vendorId;
     vendorName = '';
-    vendorDomain = '';
+    vendorUrl = '';
     vendorIcon = null;
     matchCount = 0;
     productCount = 0;
@@ -26,7 +26,7 @@ export class TopCompetitor {
     static parse(raw) {
         const competitor = new TopCompetitor(raw.competitor, raw.vendor);
         competitor.vendorName = raw.vendor_name ?? '';
-        competitor.vendorDomain = raw.vendor_domain ?? '';
+        competitor.vendorUrl = raw.vendor_url ?? '';
         competitor.vendorIcon = raw.vendor_icon ?? null;
         competitor.matchCount = Number(raw.match_count ?? 0);
         competitor.productCount = Number(raw.product_count ?? 0);

package/dist/MarketPulse/Model/Vendor.d.ts

@@ -2,11 +2,20 @@ import { ApiRecord } from '../../Model/ApiRecord.js';
 /**
  * A shop whose products Market Pulse tracks — your own or a competitor's. It is the same entity in
  * both roles; a {@link Competitor} is a vendor as one catalog watches it.
+ *
+ * One vendor is one storefront view: a single `url`, a single `currency`. A merchant selling in
+ * several markets is several vendors.
  */
 export declare class Vendor {
     id: string;
     name: string;
+    /** Storefront root, scheme included, no trailing slash — e.g. `https://shop.com/nl`. */
+    url: string;
     icon: string | null;
+    /** ISO 4217 code this storefront quotes prices in. */
+    currency: string | null;
+    /** Platform hint used to pick a scrape strategy, e.g. `shopify`. */
+    type: string | null;
     constructor(id: string, name: string);
     static parse(raw: ApiRecord): Vendor;
 }

package/dist/MarketPulse/Model/Vendor.js

@@ -1,18 +1,30 @@
 /**
  * A shop whose products Market Pulse tracks — your own or a competitor's. It is the same entity in
  * both roles; a {@link Competitor} is a vendor as one catalog watches it.
+ *
+ * One vendor is one storefront view: a single `url`, a single `currency`. A merchant selling in
+ * several markets is several vendors.
  */
 export class Vendor {
     id;
     name;
+    /** Storefront root, scheme included, no trailing slash — e.g. `https://shop.com/nl`. */
+    url = '';
     icon = null;
+    /** ISO 4217 code this storefront quotes prices in. */
+    currency = null;
+    /** Platform hint used to pick a scrape strategy, e.g. `shopify`. */
+    type = null;
     constructor(id, name) {
         this.id = id;
         this.name = name;
     }
     static parse(raw) {
         const vendor = new Vendor(raw.id, raw.name ?? '');
+        vendor.url = raw.url ?? '';
         vendor.icon = raw.icon ?? null;
+        vendor.currency = raw.currency ?? null;
+        vendor.type = raw.type ?? null;
         return vendor;
     }
 }

package/dist/MarketPulse/Service/CompetitorEndpoint.d.ts

@@ -10,6 +10,28 @@ import { Competitor } from '../Model/Competitor.js';
 export declare class CompetitorEndpoint extends Endpoint {
     getByCatalog(catalogId: CatalogId | string, pagination?: CursorPagination | null): Promise<CollectionResult<Competitor>>;
     getById(competitorId: string): Promise<Competitor | null>;
-    /** Start watching a vendor as a competitor of this catalog. */
-    add(catalogId: CatalogId | string, vendorId: string): Promise<Competitor | null>;
+    /**
+     * Start watching an existing vendor as a competitor of this catalog.
+     *
+     * The vendor must already exist — create it with {@link VendorEndpoint.create} first. Re-adding
+     * a previously removed competitor reactivates the original link, so its matches and price
+     * history survive.
+     *
+     * Returns the link itself (`id`, `catalog`, `vendor`), not the populated competitor; read it
+     * back with {@link getById} if you need the counts and timestamps.
+     */
+    add(catalogId: CatalogId | string, vendorId: string): Promise<CompetitorLink | null>;
+    /**
+     * Stop watching a competitor.
+     *
+     * The vendor, its products and their price history are kept — only the catalog↔vendor link is
+     * retired, so {@link add} can resume it later.
+     */
+    remove(catalogId: CatalogId | string, competitorId: string): Promise<void>;
 }
+/** The catalog↔vendor link row returned by {@link CompetitorEndpoint.add}. */
+export type CompetitorLink = {
+    id: string;
+    catalogId: string;
+    vendorId: string;
+};

package/dist/MarketPulse/Service/CompetitorEndpoint.js

@@ -16,9 +16,34 @@ export class CompetitorEndpoint extends Endpoint {
         const result = await this.requestObject(path('/pulse/competing-vendors/:competitorId', { competitorId }), null, Competitor.parse, 'GET');
         return result.getData();
     }
-    /** Start watching a vendor as a competitor of this catalog. */
+    /**
+     * Start watching an existing vendor as a competitor of this catalog.
+     *
+     * The vendor must already exist — create it with {@link VendorEndpoint.create} first. Re-adding
+     * a previously removed competitor reactivates the original link, so its matches and price
+     * history survive.
+     *
+     * Returns the link itself (`id`, `catalog`, `vendor`), not the populated competitor; read it
+     * back with {@link getById} if you need the counts and timestamps.
+     */
     async add(catalogId, vendorId) {
-        const result = await this.requestObject(path('/pulse/catalogs/:catalogId/competing-vendors', { catalogId: catalogId.toString() }), { vendor: vendorId }, Competitor.parse, 'POST');
+        const result = await this.requestObject(path('/pulse/catalogs/:catalogId/competing-vendors', { catalogId: catalogId.toString() }), { vendor: vendorId }, (raw) => ({
+            id: raw.id,
+            catalogId: raw.catalog,
+            vendorId: raw.vendor,
+        }), 'POST');
         return result.getData();
     }
+    /**
+     * Stop watching a competitor.
+     *
+     * The vendor, its products and their price history are kept — only the catalog↔vendor link is
+     * retired, so {@link add} can resume it later.
+     */
+    async remove(catalogId, competitorId) {
+        await this.requestObject(path('/pulse/catalogs/:catalogId/competing-vendors/:competitorId', {
+            catalogId: catalogId.toString(),
+            competitorId,
+        }), null, (raw) => raw, 'DELETE');
+    }
 }

package/dist/MarketPulse/Service/VendorEndpoint.d.ts

@@ -0,0 +1,26 @@
+import { Endpoint } from '../../Service/Endpoint.js';
+import { Vendor } from '../Model/Vendor.js';
+/**
+ * Vendors — the shops Market Pulse knows about, independent of who watches them.
+ *
+ * Creating a vendor and watching it as a competitor are separate steps: create here, then link it
+ * to a catalog with {@link CompetitorEndpoint.add}. That split is what lets one vendor be watched
+ * by several catalogs without being duplicated.
+ *
+ * There is deliberately no "list vendors" method: vendors are global, so listing them would expose
+ * every customer's tracked shops. Discovery gets designed alongside the UI that needs it.
+ */
+export declare class VendorEndpoint extends Endpoint {
+    getById(vendorId: string): Promise<Vendor | null>;
+    /**
+     * Register a shop.
+     *
+     * `url` is normalised server-side (scheme added, trailing slash dropped, host lowercased), and a
+     * storefront that already has a vendor is rejected — so this is safe to call without checking
+     * first, but it will throw rather than return the existing vendor.
+     *
+     * @param url Storefront root. A locale path is significant: `https://shop.com/nl` is a
+     *        different storefront from `https://shop.com`.
+     */
+    create(name: string, url: string, currency?: string | null, type?: string | null): Promise<Vendor | null>;
+}

package/dist/MarketPulse/Service/VendorEndpoint.js

@@ -0,0 +1,33 @@
+import { path } from '../../Http/Data/Path.js';
+import { Endpoint } from '../../Service/Endpoint.js';
+import { Vendor } from '../Model/Vendor.js';
+/**
+ * Vendors — the shops Market Pulse knows about, independent of who watches them.
+ *
+ * Creating a vendor and watching it as a competitor are separate steps: create here, then link it
+ * to a catalog with {@link CompetitorEndpoint.add}. That split is what lets one vendor be watched
+ * by several catalogs without being duplicated.
+ *
+ * There is deliberately no "list vendors" method: vendors are global, so listing them would expose
+ * every customer's tracked shops. Discovery gets designed alongside the UI that needs it.
+ */
+export class VendorEndpoint extends Endpoint {
+    async getById(vendorId) {
+        const result = await this.requestObject(path('/pulse/vendors/:vendorId', { vendorId }), null, Vendor.parse, 'GET');
+        return result.getData();
+    }
+    /**
+     * Register a shop.
+     *
+     * `url` is normalised server-side (scheme added, trailing slash dropped, host lowercased), and a
+     * storefront that already has a vendor is rejected — so this is safe to call without checking
+     * first, but it will throw rather than return the existing vendor.
+     *
+     * @param url Storefront root. A locale path is significant: `https://shop.com/nl` is a
+     *        different storefront from `https://shop.com`.
+     */
+    async create(name, url, currency = null, type = null) {
+        const result = await this.requestObject('/pulse/vendors', { name, url, currency, type }, Vendor.parse, 'POST');
+        return result.getData();
+    }
+}

package/dist/MarketPulse/Service/VendorProductEndpoint.js

@@ -55,6 +55,7 @@ export class VendorProductEndpoint extends Endpoint {
             image: product.image,
             identifier: product.identifier,
             gtin: product.gtin,
+            sku: product.sku,
             brand: product.brand,
             url: product.url,
             currency: product.currency,
@@ -70,6 +71,7 @@ export class VendorProductEndpoint extends Endpoint {
     /** Update the mutable fields of an existing vendor product (JSON-patch style, per the API). */
     async update(product) {
         const operations = [
+            { op: 'add', path: 'name', value: product.name },
             { op: 'add', path: 'price', value: product.price },
             { op: 'add', path: 'original_price', value: product.originalPrice },
             { op: 'add', path: 'brand', value: product.brand },
@@ -78,6 +80,8 @@ export class VendorProductEndpoint extends Endpoint {
             { op: 'add', path: 'url', value: product.url },
             { op: 'add', path: 'gtin', value: product.gtin },
             { op: 'add', path: 'image', value: product.image },
+            { op: 'add', path: 'sku', value: product.sku },
+            { op: 'add', path: 'currency', value: product.currency },
             { op: 'add', path: 'properties', value: product.properties },
         ];
         if (product.id === null) {

package/dist/Model/Component/Component.d.ts

@@ -0,0 +1,25 @@
+import { State } from '../State.js';
+import { ComponentKind } from './ComponentKind.js';
+import { ComponentVersion } from './ComponentVersion.js';
+/** One thing the platform builds and deploys: an api, a service, or the runner. */
+export declare class Component {
+    id: string;
+    name: string;
+    kind: ComponentKind;
+    /** Registry path without a tag, e.g. `registry.gitlab.com/attlaz/platform/message_service`. */
+    imageRepository: string;
+    /**
+     * The version that *should* be deployed — desired state, set by promoting. Null means the
+     * component is not managed this way, never "deploy nothing".
+     */
+    activeVersionId: string | null;
+    /**
+     * The active version itself, present only when requested with `?expand=active_version`.
+     * Null both when nothing is promoted and when the caller did not ask for it — check
+     * `activeVersionId` to tell those apart.
+     */
+    activeVersion: ComponentVersion | null;
+    createdAt: Date;
+    updatedAt: Date;
+    state: State;
+}

package/dist/Model/Component/Component.js

@@ -0,0 +1,22 @@
+/** One thing the platform builds and deploys: an api, a service, or the runner. */
+export class Component {
+    id;
+    name;
+    kind;
+    /** Registry path without a tag, e.g. `registry.gitlab.com/attlaz/platform/message_service`. */
+    imageRepository;
+    /**
+     * The version that *should* be deployed — desired state, set by promoting. Null means the
+     * component is not managed this way, never "deploy nothing".
+     */
+    activeVersionId;
+    /**
+     * The active version itself, present only when requested with `?expand=active_version`.
+     * Null both when nothing is promoted and when the caller did not ask for it — check
+     * `activeVersionId` to tell those apart.
+     */
+    activeVersion = null;
+    createdAt;
+    updatedAt;
+    state;
+}

package/dist/Model/Component/ComponentKind.d.ts

@@ -0,0 +1,8 @@
+export declare enum ComponentKind {
+    Api = "api",
+    Service = "service",
+    Runner = "runner"
+}
+export declare namespace ComponentKind {
+    const fromString: (input: string) => ComponentKind;
+}

package/dist/Model/Component/ComponentKind.js

@@ -0,0 +1,18 @@
+export var ComponentKind;
+(function (ComponentKind) {
+    ComponentKind["Api"] = "api";
+    ComponentKind["Service"] = "service";
+    ComponentKind["Runner"] = "runner";
+})(ComponentKind || (ComponentKind = {}));
+(function (ComponentKind) {
+    ComponentKind.fromString = (input) => {
+        switch (input) {
+            case ComponentKind.Api:
+            case ComponentKind.Service:
+            case ComponentKind.Runner:
+                return input;
+            default:
+                throw new Error('Unknown ComponentKind "' + input + '"');
+        }
+    };
+})(ComponentKind || (ComponentKind = {}));

package/dist/Model/Component/ComponentStatus.d.ts

@@ -0,0 +1,31 @@
+/**
+ * What one Kubernetes deployment of a component actually runs, as last observed.
+ *
+ * The counterpart to `Component.activeVersionId`: that is what should run, this is what does.
+ * One row per deployment — a component running several version lines has several.
+ */
+export declare class ComponentStatus {
+    id: string;
+    componentId: string;
+    namespace: string;
+    deploymentName: string;
+    /** Fully-qualified image including the tag, exactly as the container reports it. */
+    image: string;
+    readyReplicas: number;
+    desiredReplicas: number;
+    /**
+     * Whether enough replicas are ready to serve. **True for a deployment scaled to zero** — with no
+     * replicas wanted, the requirement is trivially met. Treat `desiredReplicas > 0 &&
+     * readyReplicas < desiredReplicas` as unhealthy rather than trusting this alone.
+     */
+    available: boolean;
+    /**
+     * Reads backwards: false means the last rollout missed its deadline, i.e. the deploy failed.
+     * True covers both a settled deployment and one still rolling out. Replica counts cannot
+     * substitute — a new pod that never becomes ready leaves the old ones serving, so the counts
+     * still look right while the deploy has failed.
+     */
+    progressing: boolean;
+    /** When the cluster was last read. Stale means nobody has looked, not that all is well. */
+    observedAt: Date;
+}

package/dist/Model/Component/ComponentStatus.js

@@ -0,0 +1,31 @@
+/**
+ * What one Kubernetes deployment of a component actually runs, as last observed.
+ *
+ * The counterpart to `Component.activeVersionId`: that is what should run, this is what does.
+ * One row per deployment — a component running several version lines has several.
+ */
+export class ComponentStatus {
+    id;
+    componentId;
+    namespace;
+    deploymentName;
+    /** Fully-qualified image including the tag, exactly as the container reports it. */
+    image;
+    readyReplicas;
+    desiredReplicas;
+    /**
+     * Whether enough replicas are ready to serve. **True for a deployment scaled to zero** — with no
+     * replicas wanted, the requirement is trivially met. Treat `desiredReplicas > 0 &&
+     * readyReplicas < desiredReplicas` as unhealthy rather than trusting this alone.
+     */
+    available;
+    /**
+     * Reads backwards: false means the last rollout missed its deadline, i.e. the deploy failed.
+     * True covers both a settled deployment and one still rolling out. Replica counts cannot
+     * substitute — a new pod that never becomes ready leaves the old ones serving, so the counts
+     * still look right while the deploy has failed.
+     */
+    progressing;
+    /** When the cluster was last read. Stale means nobody has looked, not that all is well. */
+    observedAt;
+}

package/dist/Model/Component/ComponentVersion.d.ts

@@ -0,0 +1,16 @@
+import { State } from '../State.js';
+/** One tag of a component as the container registry has it. */
+export declare class ComponentVersion {
+    id: string;
+    componentId: string;
+    /** The registry tag, e.g. `1.15.1`. */
+    version: string;
+    /** Fully-qualified reference including the tag. */
+    image: string;
+    /**
+     * When the image was published to the registry and became available to select. Not a build time,
+     * and not evidence it was ever deployed — most versions never are.
+     */
+    releasedAt: Date;
+    state: State;
+}

package/dist/Model/Component/ComponentVersion.js

@@ -0,0 +1,15 @@
+/** One tag of a component as the container registry has it. */
+export class ComponentVersion {
+    id;
+    componentId;
+    /** The registry tag, e.g. `1.15.1`. */
+    version;
+    /** Fully-qualified reference including the tag. */
+    image;
+    /**
+     * When the image was published to the registry and became available to select. Not a build time,
+     * and not evidence it was ever deployed — most versions never are.
+     */
+    releasedAt;
+    state;
+}

package/dist/Model/Timezone.d.ts

@@ -0,0 +1,18 @@
+import { ApiRecord } from './ApiRecord.js';
+/**
+ * A timezone the platform accepts, as reported by the API.
+ *
+ * The list comes from the server rather than from the browser's own `Intl`: the two run different
+ * tz database versions, so a browser-built list can offer a zone the API then rejects, or spell one
+ * differently from the name the API stores.
+ */
+export declare class Timezone {
+    name: string;
+    /**
+     * Offset from UTC in minutes at the moment the API answered — positive east of Greenwich, and
+     * not a whole number of hours everywhere (Asia/Katmandu is 345). It follows daylight saving, so
+     * it is a value to display, never one to store or to compare zones by.
+     */
+    utcOffsetMinutes: number;
+    static parse(raw: ApiRecord): Timezone;
+}

package/dist/Model/Timezone.js

@@ -0,0 +1,22 @@
+/**
+ * A timezone the platform accepts, as reported by the API.
+ *
+ * The list comes from the server rather than from the browser's own `Intl`: the two run different
+ * tz database versions, so a browser-built list can offer a zone the API then rejects, or spell one
+ * differently from the name the API stores.
+ */
+export class Timezone {
+    name;
+    /**
+     * Offset from UTC in minutes at the moment the API answered — positive east of Greenwich, and
+     * not a whole number of hours everywhere (Asia/Katmandu is 345). It follows daylight saving, so
+     * it is a value to display, never one to store or to compare zones by.
+     */
+    utcOffsetMinutes;
+    static parse(raw) {
+        const timezone = new Timezone();
+        timezone.name = raw.name;
+        timezone.utcOffsetMinutes = raw.utc_offset_minutes;
+        return timezone;
+    }
+}

package/dist/Service/ComponentEndpoint.d.ts

@@ -0,0 +1,33 @@
+import { Component } from '../Model/Component/Component.js';
+import { ComponentKind } from '../Model/Component/ComponentKind.js';
+import { ComponentStatus } from '../Model/Component/ComponentStatus.js';
+import { ComponentVersion } from '../Model/Component/ComponentVersion.js';
+import { CursorPagination } from '../Model/Pagination/CursorPagination.js';
+import { CollectionResult } from '../Model/Result/CollectionResult.js';
+import { Endpoint } from './Endpoint.js';
+/**
+ * The platform's own inventory: what we build, which versions the registry has, what the cluster is
+ * actually running, and which version each component should run.
+ *
+ * Root-only, reads included.
+ */
+export declare class ComponentEndpoint extends Endpoint {
+    /**
+     * @param expand pass `['active_version']` to receive the promoted version inline instead of
+     *               just its id — one call rather than one per component.
+     * @param kinds  restrict to these kinds; a collection, so apis and services can be fetched
+     *               together without the runner.
+     */
+    getAll(pagination?: CursorPagination | null, expand?: string[] | null, kinds?: ComponentKind[] | null): Promise<CollectionResult<Component>>;
+    getVersions(componentId: string, pagination?: CursorPagination | null): Promise<CollectionResult<ComponentVersion>>;
+    /** Observed state for every component at once — one call, not one per component. */
+    getStatus(pagination?: CursorPagination | null): Promise<CollectionResult<ComponentStatus>>;
+    /**
+     * Declare which version a component should run. Writes desired state only — the rollout is a
+     * separate asynchronous step that can fail, so a success here does not mean it is running.
+     */
+    setActiveVersion(componentId: string, versionId: string): Promise<void>;
+    private static parseComponent;
+    private static parseVersion;
+    private static parseStatus;
+}

package/dist/Service/ComponentEndpoint.js

@@ -0,0 +1,100 @@
+import { path } from '../Http/Data/Path.js';
+import { QueryString } from '../Http/Data/QueryString.js';
+import { Component } from '../Model/Component/Component.js';
+import { ComponentKind } from '../Model/Component/ComponentKind.js';
+import { ComponentStatus } from '../Model/Component/ComponentStatus.js';
+import { ComponentVersion } from '../Model/Component/ComponentVersion.js';
+import { State } from '../Model/State.js';
+import { Utils } from '../Utils.js';
+import { Endpoint } from './Endpoint.js';
+/**
+ * The platform's own inventory: what we build, which versions the registry has, what the cluster is
+ * actually running, and which version each component should run.
+ *
+ * Root-only, reads included.
+ */
+export class ComponentEndpoint extends Endpoint {
+    /**
+     * @param expand pass `['active_version']` to receive the promoted version inline instead of
+     *               just its id — one call rather than one per component.
+     * @param kinds  restrict to these kinds; a collection, so apis and services can be fetched
+     *               together without the runner.
+     */
+    async getAll(pagination = null, expand = null, kinds = null) {
+        const queryString = new QueryString('/system/components');
+        queryString.addPagination(pagination);
+        if (kinds !== null && kinds.length > 0) {
+            queryString.set('kind', kinds);
+        }
+        if (expand !== null && expand.length > 0) {
+            queryString.set('expand', expand);
+        }
+        return await this.requestCollection(queryString, ComponentEndpoint.parseComponent, null, 'GET');
+    }
+    async getVersions(componentId, pagination = null) {
+        const queryString = new QueryString(path('/system/components/:componentId/versions', { componentId }));
+        queryString.addPagination(pagination);
+        return await this.requestCollection(queryString, ComponentEndpoint.parseVersion, null, 'GET');
+    }
+    /** Observed state for every component at once — one call, not one per component. */
+    async getStatus(pagination = null) {
+        const queryString = new QueryString('/system/component-status');
+        queryString.addPagination(pagination);
+        return await this.requestCollection(queryString, ComponentEndpoint.parseStatus, null, 'GET');
+    }
+    /**
+     * Declare which version a component should run. Writes desired state only — the rollout is a
+     * separate asynchronous step that can fail, so a success here does not mean it is running.
+     */
+    async setActiveVersion(componentId, versionId) {
+        const queryString = new QueryString(path('/system/components/:componentId/active-version', { componentId }));
+        // `_formatted` because formatParameters() strips a trailing `_id` from body keys, which
+        // would turn `version_id` into `version` — a key the endpoint does not read.
+        await this.requestObject(queryString, { version_id: versionId, _formatted: true }, (raw) => raw, 'POST');
+    }
+    static parseComponent(raw) {
+        const component = new Component();
+        component.id = raw.id;
+        component.name = raw.name;
+        component.kind = ComponentKind.fromString(raw.kind);
+        component.imageRepository = raw.image_repository;
+        // `active_version` is either the id or, when expanded, the version itself.
+        const activeVersion = raw.active_version ?? null;
+        if (activeVersion !== null && typeof activeVersion === 'object') {
+            component.activeVersion = ComponentEndpoint.parseVersion(activeVersion);
+            component.activeVersionId = component.activeVersion.id;
+        }
+        else {
+            component.activeVersionId = activeVersion;
+            component.activeVersion = null;
+        }
+        component.createdAt = Utils.parseRawDate(raw.created_at);
+        component.updatedAt = Utils.parseRawDate(raw.updated_at);
+        component.state = State.fromString(raw.state);
+        return component;
+    }
+    static parseVersion(raw) {
+        const version = new ComponentVersion();
+        version.id = raw.id;
+        version.componentId = raw.component;
+        version.version = raw.version;
+        version.image = raw.image;
+        version.releasedAt = Utils.parseRawDate(raw.released_at);
+        version.state = State.fromString(raw.state);
+        return version;
+    }
+    static parseStatus(raw) {
+        const status = new ComponentStatus();
+        status.id = raw.id;
+        status.componentId = raw.component;
+        status.namespace = raw.namespace;
+        status.deploymentName = raw.deployment_name;
+        status.image = raw.image;
+        status.readyReplicas = raw.ready_replicas;
+        status.desiredReplicas = raw.desired_replicas;
+        status.available = raw.available;
+        status.progressing = raw.progressing;
+        status.observedAt = Utils.parseRawDate(raw.observed_at);
+        return status;
+    }
+}

package/dist/Service/TimezoneEndpoint.d.ts

@@ -0,0 +1,13 @@
+import { CollectionResult } from '../Model/Result/CollectionResult.js';
+import { Timezone } from '../Model/Timezone.js';
+import { Endpoint } from './Endpoint.js';
+export declare class TimezoneEndpoint extends Endpoint {
+    /**
+     * Every timezone a schedule or a user profile can be set to.
+     *
+     * Deliberately not paginated: this is a fixed reference list of a few hundred entries owned by
+     * the platform's runtime, not a growing collection, and a picker needs all of it to filter
+     * against.
+     */
+    getAll(): Promise<CollectionResult<Timezone>>;
+}

package/dist/Service/TimezoneEndpoint.js

@@ -0,0 +1,15 @@
+import { QueryString } from '../Http/Data/QueryString.js';
+import { Timezone } from '../Model/Timezone.js';
+import { Endpoint } from './Endpoint.js';
+export class TimezoneEndpoint extends Endpoint {
+    /**
+     * Every timezone a schedule or a user profile can be set to.
+     *
+     * Deliberately not paginated: this is a fixed reference list of a few hundred entries owned by
+     * the platform's runtime, not a growing collection, and a picker needs all of it to filter
+     * against.
+     */
+    async getAll() {
+        return await this.requestCollection(new QueryString('/timezones'), Timezone.parse);
+    }
+}

package/dist/index.d.ts

@@ -127,7 +127,8 @@ export { CatalogProductEndpoint } from './Catalog/Service/CatalogProductEndpoint
 export { GenerateContentBatch } from './DataEnrichment/Model/GenerateContentBatch.js';
 export { GenerateContentBatchData } from './DataEnrichment/Model/GenerateContentBatchData.js';
 export { GenerateContentEndpoint } from './DataEnrichment/Service/GenerateContentEndpoint.js';
-export { CompetitorEndpoint } from './MarketPulse/Service/CompetitorEndpoint.js';
+export { CompetitorEndpoint, CompetitorLink } from './MarketPulse/Service/CompetitorEndpoint.js';
+export { VendorEndpoint } from './MarketPulse/Service/VendorEndpoint.js';
 export { MarketSummaryEntry } from './MarketPulse/Model/MarketSummaryEntry.js';
 export { ProductSegmentType } from './MarketPulse/Model/ProductSegmentType.js';
 export { ProductsSegment } from './MarketPulse/Model/ProductsSegment.js';
@@ -160,6 +161,7 @@ export { SearchResult } from './Model/Search/SearchResult.js';
 export { Trigger } from './Model/Trigger/Trigger.js';
 /** Worker* */
 export { Platform } from './Model/Worker/Platform.js';
+export { Timezone } from './Model/Timezone.js';
 export { PlatformImage } from './Model/Worker/PlatformImage.js';
 export { InfrastructureConfiguration } from './Model/Worker/InfrastructureConfiguration.js';
 /** Deployment * */
@@ -208,6 +210,10 @@ export type { UserActionFilter } from './Model/User/UserActionFilter.js';
 export { UserSummary } from './Model/User/UserSummary.js';
 export type { UserSummaryType } from './Model/User/UserSummary.js';
 export { RunnerImage } from './Model/Runner/RunnerImage.js';
+export { Component } from './Model/Component/Component.js';
+export { ComponentKind } from './Model/Component/ComponentKind.js';
+export { ComponentStatus } from './Model/Component/ComponentStatus.js';
+export { ComponentVersion } from './Model/Component/ComponentVersion.js';
 export { CommandExecutionHistory } from './Model/Command/CommandExecutionHistory.js';
 export { CommandExecutionStatus } from './Model/Command/CommandExecutionStatus.js';
 export { CommandExecutionFilter } from './Model/Command/CommandExecutionFilter.js';
@@ -222,6 +228,7 @@ export { LogEndpoint } from './Logging/Service/LogEndpoint.js';
 export { WorkspaceMemberEndpoint } from './Service/WorkspaceMemberEndpoint.js';
 export { InboxEndpoint } from './Service/InboxEndpoint.js';
 export { PlatformEndpoint } from './Service/PlatformEndpoint.js';
+export { TimezoneEndpoint } from './Service/TimezoneEndpoint.js';
 export { CodeDeployEndpoint } from './Service/CodeDeployEndpoint.js';
 export { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
 export { SearchEndpoint } from './Service/SearchEndpoint.js';

package/dist/index.js

@@ -104,6 +104,7 @@ export { CatalogProductEndpoint } from './Catalog/Service/CatalogProductEndpoint
 export { GenerateContentBatch } from './DataEnrichment/Model/GenerateContentBatch.js';
 export { GenerateContentEndpoint } from './DataEnrichment/Service/GenerateContentEndpoint.js';
 export { CompetitorEndpoint } from './MarketPulse/Service/CompetitorEndpoint.js';
+export { VendorEndpoint } from './MarketPulse/Service/VendorEndpoint.js';
 export { PulseStatisticsEndpoint } from './MarketPulse/Service/PulseStatisticsEndpoint.js';
 export { QualityDataset } from './DataQuality/Model/QualityDataset.js';
 export { QualityEntity } from './DataQuality/Model/QualityEntity.js';
@@ -126,6 +127,7 @@ export { SearchResult } from './Model/Search/SearchResult.js';
 export { Trigger } from './Model/Trigger/Trigger.js';
 /** Worker* */
 export { Platform } from './Model/Worker/Platform.js';
+export { Timezone } from './Model/Timezone.js';
 export { PlatformImage } from './Model/Worker/PlatformImage.js';
 export { InfrastructureConfiguration } from './Model/Worker/InfrastructureConfiguration.js';
 /** Deployment * */
@@ -171,6 +173,10 @@ export { UserAuthProvider } from './Model/User/UserAuthProvider.js';
 export { UserAction } from './Model/User/UserAction.js';
 export { UserSummary } from './Model/User/UserSummary.js';
 export { RunnerImage } from './Model/Runner/RunnerImage.js';
+export { Component } from './Model/Component/Component.js';
+export { ComponentKind } from './Model/Component/ComponentKind.js';
+export { ComponentStatus } from './Model/Component/ComponentStatus.js';
+export { ComponentVersion } from './Model/Component/ComponentVersion.js';
 export { CommandExecutionHistory } from './Model/Command/CommandExecutionHistory.js';
 export { CommandExecutionStatus } from './Model/Command/CommandExecutionStatus.js';
 export { Endpoint } from './Service/Endpoint.js';
@@ -185,6 +191,7 @@ export { LogEndpoint } from './Logging/Service/LogEndpoint.js';
 export { WorkspaceMemberEndpoint } from './Service/WorkspaceMemberEndpoint.js';
 export { InboxEndpoint } from './Service/InboxEndpoint.js';
 export { PlatformEndpoint } from './Service/PlatformEndpoint.js';
+export { TimezoneEndpoint } from './Service/TimezoneEndpoint.js';
 export { CodeDeployEndpoint } from './Service/CodeDeployEndpoint.js';
 export { ProjectEnvironmentEndpoint } from './Service/ProjectEnvironmentEndpoint.js';
 export { SearchEndpoint } from './Service/SearchEndpoint.js';

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.97.0";
+export declare const VERSION = "1.98.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.97.0";
+export const VERSION = "1.98.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attlaz/client",
-  "version": "1.97.0",
+  "version": "1.99.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -37,14 +37,15 @@
   "license": "MIT",
   "scripts": {
     "prebuild": "npm run setversion",
-    "prepare": "npm run clean && tsc --project tsconfig.production.json && npm run setversion",
-    "build": "npm run clean && tsc",
+    "prepare": "npm run clean && tsc --project tsconfig.build.json && npm run setversion",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
     "setversion": "node -p \"'export const VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
     "clean": "rimraf dist",
     "scan": "docker run -v .:/path zricethezav/gitleaks:latest detect --source=\"/path\" ",
-    "test": "jest",
-    "test:unit": "jest --config jest.config.unit.js",
-    "typecheck": "tsc --project tsconfig.json --noEmit"
+    "test": "vitest run --mode unit",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "test-integration": "vitest run --mode integration",
+    "test-live": "vitest --mode unit"
   },
   "publishConfig": {
     "access": "public",
@@ -52,7 +53,6 @@
     "registry": "https://registry.npmjs.org"
   },
   "devDependencies": {
-    "@types/jest": "^30.0.0",
     "@types/node": "^26.1.2",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
@@ -63,10 +63,9 @@
     "eslint-plugin-jsdoc": "^62.9.0",
     "eslint-plugin-prefer-arrow": "^1.2.3",
     "eslint-plugin-promise": "^7.3.0",
-    "jest": "^30.4.2",
     "rimraf": "^6.1.3",
-    "ts-jest": "^29.4.12",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
   },
   "directories": {
     "test": "test"