@attlaz/client 1.88.0 → 1.89.0

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

@@ -0,0 +1,25 @@
+import { ApiRecord } from '../../Model/ApiRecord.js';
+/** `dynamic` groups are evaluated from {@link ProductGroup.criteria}; `manual` ones hold a fixed list. */
+export type ProductGroupType = 'dynamic' | 'manual';
+/**
+ * A named subset of a catalog's products — the `/pulse/product-groups` resource. Pricing rules and
+ * price alerts are scoped to one, and the product list can be filtered by it.
+ *
+ * `criteria` is the raw rule object of a dynamic group (`{"brand": "Philips"}`,
+ * `{"sales_volume": {">": 100}}`); its shape is open, so it is passed through untouched.
+ */
+export declare class ProductGroup {
+    id: string;
+    catalogId: string;
+    name: string;
+    description: string | null;
+    groupType: ProductGroupType;
+    criteria: Record<string, unknown>;
+    /** Created from a built-in template rather than by hand. */
+    isTemplate: boolean;
+    templateKey: string | null;
+    createdAt: Date | null;
+    updatedAt: Date | null;
+    constructor(id: string, catalogId: string, name: string);
+    static parse(raw: ApiRecord): ProductGroup;
+}

package/dist/Pulse/Model/ProductGroup.js

@@ -0,0 +1,36 @@
+/**
+ * A named subset of a catalog's products — the `/pulse/product-groups` resource. Pricing rules and
+ * price alerts are scoped to one, and the product list can be filtered by it.
+ *
+ * `criteria` is the raw rule object of a dynamic group (`{"brand": "Philips"}`,
+ * `{"sales_volume": {">": 100}}`); its shape is open, so it is passed through untouched.
+ */
+export class ProductGroup {
+    id;
+    catalogId;
+    name;
+    description = null;
+    groupType = 'dynamic';
+    criteria = {};
+    /** Created from a built-in template rather than by hand. */
+    isTemplate = false;
+    templateKey = null;
+    createdAt = null;
+    updatedAt = null;
+    constructor(id, catalogId, name) {
+        this.id = id;
+        this.catalogId = catalogId;
+        this.name = name;
+    }
+    static parse(raw) {
+        const group = new ProductGroup(raw.id, raw.catalog, raw.name ?? '');
+        group.description = raw.description ?? null;
+        group.groupType = raw.group_type ?? 'dynamic';
+        group.criteria = raw.criteria ?? {};
+        group.isTemplate = raw.is_template === true;
+        group.templateKey = raw.template_key ?? null;
+        group.createdAt = raw.created_at ? new Date(raw.created_at) : null;
+        group.updatedAt = raw.updated_at ? new Date(raw.updated_at) : null;
+        return group;
+    }
+}

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

@@ -0,0 +1,21 @@
+import { ApiRecord } from '../../Model/ApiRecord.js';
+/** Where a match came from and what happened to it since. */
+export type ProductMatchStatus = 'pending' | 'accepted' | 'declined';
+/**
+ * The link between one of the catalog's products and a competitor's — the `/pulse/matches/:matchId`
+ * resource.
+ *
+ * This is the match *record*: how it was made (`matchType`), how sure the matcher was
+ * (`confidence`, 0-1) and whether a human has since accepted or declined it. The two products it
+ * joins are read through {@link MatchedVendorProduct} or {@link ReviewMatch}.
+ */
+export declare class ProductMatch {
+    id: string;
+    matchType: string;
+    confidence: number | null;
+    metadata: Record<string, unknown> | null;
+    status: ProductMatchStatus;
+    createdAt: Date | null;
+    constructor(id: string);
+    static parse(raw: ApiRecord): ProductMatch;
+}

package/dist/Pulse/Model/ProductMatch.js

@@ -0,0 +1,28 @@
+/**
+ * The link between one of the catalog's products and a competitor's — the `/pulse/matches/:matchId`
+ * resource.
+ *
+ * This is the match *record*: how it was made (`matchType`), how sure the matcher was
+ * (`confidence`, 0-1) and whether a human has since accepted or declined it. The two products it
+ * joins are read through {@link MatchedVendorProduct} or {@link ReviewMatch}.
+ */
+export class ProductMatch {
+    id;
+    matchType = '';
+    confidence = null;
+    metadata = null;
+    status = 'pending';
+    createdAt = null;
+    constructor(id) {
+        this.id = id;
+    }
+    static parse(raw) {
+        const match = new ProductMatch(raw.id);
+        match.matchType = raw.match_type ?? '';
+        match.confidence = raw.confidence ?? null;
+        match.metadata = raw.metadata ?? null;
+        match.status = raw.status ?? 'pending';
+        match.createdAt = raw.created_at ? new Date(raw.created_at) : null;
+        return match;
+    }
+}

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

@@ -0,0 +1,27 @@
+import { ApiRecord } from '../../Model/ApiRecord.js';
+export type ProductMatchJobStatus = 'pending' | 'started' | 'cancelled' | 'stopped' | 'finished';
+/**
+ * One run of matching a catalog's products against a competitor's — the `/pulse/match-jobs`
+ * resource. `strategy` / `strategyVersion` identify the matching strategy that produced the
+ * matches, `matchesFound` is counted per job at read time.
+ *
+ * The list (`/pulse/catalogs/:catalogId/match-jobs`), the vendor list and the single-job endpoint
+ * all return this same shape.
+ */
+export declare class ProductMatchJob {
+    id: string;
+    catalogId: string;
+    vendorId: string;
+    strategy: string;
+    strategyVersion: string;
+    configuration: Record<string, unknown> | null;
+    status: ProductMatchJobStatus;
+    productsTotal: number | null;
+    productsProcessed: number | null;
+    matchesFound: number | null;
+    createdAt: Date | null;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    constructor(id: string, catalogId: string, vendorId: string);
+    static parse(raw: ApiRecord): ProductMatchJob;
+}

package/dist/Pulse/Model/ProductMatchJob.js

@@ -0,0 +1,42 @@
+/**
+ * One run of matching a catalog's products against a competitor's — the `/pulse/match-jobs`
+ * resource. `strategy` / `strategyVersion` identify the matching strategy that produced the
+ * matches, `matchesFound` is counted per job at read time.
+ *
+ * The list (`/pulse/catalogs/:catalogId/match-jobs`), the vendor list and the single-job endpoint
+ * all return this same shape.
+ */
+export class ProductMatchJob {
+    id;
+    catalogId;
+    vendorId;
+    strategy = '';
+    strategyVersion = '';
+    configuration = null;
+    status = 'pending';
+    productsTotal = null;
+    productsProcessed = null;
+    matchesFound = null;
+    createdAt = null;
+    startedAt = null;
+    completedAt = null;
+    constructor(id, catalogId, vendorId) {
+        this.id = id;
+        this.catalogId = catalogId;
+        this.vendorId = vendorId;
+    }
+    static parse(raw) {
+        const job = new ProductMatchJob(raw.id, raw.catalog, raw.vendor);
+        job.strategy = raw.strategy ?? '';
+        job.strategyVersion = raw.strategy_version ?? '';
+        job.configuration = raw.configuration ?? null;
+        job.status = raw.status ?? 'pending';
+        job.productsTotal = raw.products_total ?? null;
+        job.productsProcessed = raw.products_processed ?? null;
+        job.matchesFound = raw.matches_found ?? null;
+        job.createdAt = raw.created_at ? new Date(raw.created_at) : null;
+        job.startedAt = raw.started_at ? new Date(raw.started_at) : null;
+        job.completedAt = raw.completed_at ? new Date(raw.completed_at) : null;
+        return job;
+    }
+}

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

@@ -0,0 +1,42 @@
+import { ApiRecord } from '../../Model/ApiRecord.js';
+import { ProductMatchStatus } from './ProductMatch.js';
+/** One side of a match, reduced to what a reviewer needs to judge it. */
+export type ReviewProduct = {
+    id: string;
+    name: string;
+    brand: string | null;
+    gtin: string | null;
+    price: number | null;
+    url: string | null;
+    image: string | null;
+    category: string | null;
+    inStock: boolean | null;
+};
+/** The competitor side additionally names the vendor it came from. */
+export type ReviewCompetitorProduct = ReviewProduct & {
+    vendor: {
+        id: string;
+        name: string;
+        icon: string | null;
+    };
+};
+/**
+ * A match queued for human review — the `/pulse/catalogs/:catalogId/matches` resource.
+ *
+ * Both products are returned side by side so a reviewer can accept or decline without a second
+ * request; `confidence` is the matcher's own certainty (0-1).
+ */
+export declare class ReviewMatch {
+    /** The id of the match record — the value to pass to accept/decline. */
+    matchId: string;
+    status: ProductMatchStatus;
+    confidence: number | null;
+    createdAt: Date | null;
+    own: ReviewProduct;
+    competitor: ReviewCompetitorProduct;
+    constructor(matchId: string, own: ReviewProduct, competitor: ReviewCompetitorProduct);
+    /** Alias of {@link matchId}: collection helpers key rows on `id`. */
+    get id(): string;
+    static parse(raw: ApiRecord): ReviewMatch;
+    private static parseProduct;
+}

package/dist/Pulse/Model/ReviewMatch.js

@@ -0,0 +1,55 @@
+/**
+ * A match queued for human review — the `/pulse/catalogs/:catalogId/matches` resource.
+ *
+ * Both products are returned side by side so a reviewer can accept or decline without a second
+ * request; `confidence` is the matcher's own certainty (0-1).
+ */
+export class ReviewMatch {
+    /** The id of the match record — the value to pass to accept/decline. */
+    matchId;
+    status = 'pending';
+    confidence = null;
+    createdAt = null;
+    own;
+    competitor;
+    constructor(matchId, own, competitor) {
+        this.matchId = matchId;
+        this.own = own;
+        this.competitor = competitor;
+    }
+    /** Alias of {@link matchId}: collection helpers key rows on `id`. */
+    get id() {
+        return this.matchId;
+    }
+    static parse(raw) {
+        const rawCompetitor = raw.competitor;
+        const rawVendor = rawCompetitor.vendor;
+        const match = new ReviewMatch(
+        // The API strips the `_id` suffix, so `match_id` arrives as `match`.
+        raw.match, ReviewMatch.parseProduct(raw.own), {
+            ...ReviewMatch.parseProduct(rawCompetitor),
+            vendor: {
+                id: rawVendor.id,
+                name: rawVendor.name,
+                icon: rawVendor.icon ?? null,
+            },
+        });
+        match.status = raw.status ?? 'pending';
+        match.confidence = raw.confidence ?? null;
+        match.createdAt = raw.created_at ? new Date(raw.created_at) : null;
+        return match;
+    }
+    static parseProduct(raw) {
+        return {
+            id: raw.id,
+            name: raw.name,
+            brand: raw.brand ?? null,
+            gtin: raw.gtin ?? null,
+            price: raw.price ?? null,
+            url: raw.url ?? null,
+            image: raw.image ?? null,
+            category: raw.category ?? null,
+            inStock: typeof raw.in_stock === 'boolean' ? raw.in_stock : null,
+        };
+    }
+}

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

@@ -0,0 +1,23 @@
+import { ApiRecord } from '../../Model/ApiRecord.js';
+/**
+ * A competitor in the "top competitors" ranking of a catalog — the
+ * `/pulse/catalogs/:catalogId/statistics/top-competitors` resource.
+ *
+ * A denormalised read model: it carries the vendor's display fields so a leaderboard renders from
+ * one request, and the previous price index so the trend can be shown without a second series.
+ */
+export declare class TopCompetitor {
+    competitorId: string;
+    vendorId: string;
+    vendorName: string;
+    vendorDomain: string;
+    vendorIcon: string | null;
+    matchCount: number;
+    productCount: number;
+    priceIndex: number | null;
+    previousPriceIndex: number | null;
+    constructor(competitorId: string, vendorId: string);
+    /** Alias of {@link competitorId}: collection helpers key rows on `id`. */
+    get id(): string;
+    static parse(raw: ApiRecord): TopCompetitor;
+}

package/dist/Pulse/Model/TopCompetitor.js

@@ -0,0 +1,37 @@
+/**
+ * A competitor in the "top competitors" ranking of a catalog — the
+ * `/pulse/catalogs/:catalogId/statistics/top-competitors` resource.
+ *
+ * A denormalised read model: it carries the vendor's display fields so a leaderboard renders from
+ * one request, and the previous price index so the trend can be shown without a second series.
+ */
+export class TopCompetitor {
+    competitorId;
+    vendorId;
+    vendorName = '';
+    vendorDomain = '';
+    vendorIcon = null;
+    matchCount = 0;
+    productCount = 0;
+    priceIndex = null;
+    previousPriceIndex = null;
+    constructor(competitorId, vendorId) {
+        this.competitorId = competitorId;
+        this.vendorId = vendorId;
+    }
+    /** Alias of {@link competitorId}: collection helpers key rows on `id`. */
+    get id() {
+        return this.competitorId;
+    }
+    static parse(raw) {
+        const competitor = new TopCompetitor(raw.competitor, raw.vendor);
+        competitor.vendorName = raw.vendor_name ?? '';
+        competitor.vendorDomain = raw.vendor_domain ?? '';
+        competitor.vendorIcon = raw.vendor_icon ?? null;
+        competitor.matchCount = Number(raw.match_count ?? 0);
+        competitor.productCount = Number(raw.product_count ?? 0);
+        competitor.priceIndex = raw.price_index ?? null;
+        competitor.previousPriceIndex = raw.previous_price_index ?? null;
+        return competitor;
+    }
+}

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

@@ -0,0 +1,12 @@
+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.
+ */
+export declare class Vendor {
+    id: string;
+    name: string;
+    icon: string | null;
+    constructor(id: string, name: string);
+    static parse(raw: ApiRecord): Vendor;
+}

package/dist/Pulse/Model/Vendor.js

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export class Vendor {
+    id;
+    name;
+    icon = null;
+    constructor(id, name) {
+        this.id = id;
+        this.name = name;
+    }
+    static parse(raw) {
+        const vendor = new Vendor(raw.id, raw.name ?? '');
+        vendor.icon = raw.icon ?? null;
+        return vendor;
+    }
+}

package/dist/{Model/Pulse → Pulse/Model}/VendorProduct.d.ts

@@ -1,4 +1,4 @@
-import { ApiRecord } from '../ApiRecord.js';
+import { ApiRecord } from '../../Model/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).
@@ -23,4 +23,9 @@ export declare class VendorProduct {
     updatedAt: Date | null;
     constructor(vendorId: string, identifier: string);
     static parse(raw: ApiRecord): VendorProduct;
+    /**
+     * Read the fields every vendor-product response carries. Split out so a subclass can reuse it
+     * from its own `parse` without repeating them.
+     */
+    protected fill(raw: ApiRecord): void;
 }

package/dist/{Model/Pulse → Pulse/Model}/VendorProduct.js

@@ -26,6 +26,15 @@ export class VendorProduct {
     }
     static parse(raw) {
         const product = new VendorProduct(raw.vendor, raw.identifier);
+        product.fill(raw);
+        return product;
+    }
+    /**
+     * Read the fields every vendor-product response carries. Split out so a subclass can reuse it
+     * from its own `parse` without repeating them.
+     */
+    fill(raw) {
+        const product = this;
         product.id = raw.id ?? null;
         product.name = raw.name ?? null;
         product.image = raw.image ?? null;
@@ -41,7 +50,6 @@ export class VendorProduct {
         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) {

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

@@ -0,0 +1,18 @@
+import { ApiRecord } from '../../Model/ApiRecord.js';
+/**
+ * One recorded price point of a competitor product — the `/pulse/vendor-products/:id/price-history`
+ * resource. Written when a crawl finds a price that differs from the last recorded one, so the
+ * entries are change points rather than a reading per crawl.
+ */
+export declare class VendorProductPriceHistoryEntry {
+    id: string;
+    vendorProductId: string;
+    price: number | null;
+    originalPrice: number | null;
+    shippingCost: number | null;
+    isInStock: boolean | null;
+    isPromotion: boolean | null;
+    recordedAt: Date | null;
+    constructor(id: string, vendorProductId: string);
+    static parse(raw: ApiRecord): VendorProductPriceHistoryEntry;
+}

package/dist/Pulse/Model/VendorProductPriceHistoryEntry.js

@@ -0,0 +1,36 @@
+/**
+ * One recorded price point of a competitor product — the `/pulse/vendor-products/:id/price-history`
+ * resource. Written when a crawl finds a price that differs from the last recorded one, so the
+ * entries are change points rather than a reading per crawl.
+ */
+export class VendorProductPriceHistoryEntry {
+    id;
+    vendorProductId;
+    price = null;
+    originalPrice = null;
+    shippingCost = null;
+    isInStock = null;
+    isPromotion = null;
+    recordedAt = null;
+    constructor(id, vendorProductId) {
+        this.id = id;
+        this.vendorProductId = vendorProductId;
+    }
+    static parse(raw) {
+        const entry = new VendorProductPriceHistoryEntry(raw.id, raw.vendor_product);
+        entry.price = toNumber(raw.price);
+        entry.originalPrice = toNumber(raw.original_price);
+        entry.shippingCost = toNumber(raw.shipping_cost);
+        entry.isInStock = typeof raw.is_in_stock === 'boolean' ? raw.is_in_stock : null;
+        entry.isPromotion = typeof raw.is_promotion === 'boolean' ? raw.is_promotion : null;
+        entry.recordedAt = raw.recorded_at ? new Date(raw.recorded_at) : null;
+        return entry;
+    }
+}
+function toNumber(value) {
+    if (value === null || value === undefined || value === '') {
+        return null;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}

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

@@ -0,0 +1,25 @@
+import { ApiRecord } from '../../Model/ApiRecord.js';
+/** Progress of a match job that is running right now; null when none is. */
+export type RunningMatch = {
+    productsTotal: number | null;
+    productsProcessed: number | null;
+    matchesFound: number;
+};
+/**
+ * How fresh a competitor's data is within a catalog — the
+ * `/pulse/catalogs/:catalogId/vendors/:vendorId/status` resource.
+ *
+ * `shouldReindex` / `shouldRematch` are the API's judgement that the vendor's products have moved
+ * on since the last index or match run, so the UI can offer to re-run them.
+ */
+export declare class VendorStatus {
+    vendorId: string;
+    lastIndexedAt: Date | null;
+    lastImportedAt: Date | null;
+    lastMatchedAt: Date | null;
+    shouldReindex: boolean;
+    shouldRematch: boolean;
+    runningMatch: RunningMatch | null;
+    constructor(vendorId: string);
+    static parse(raw: ApiRecord): VendorStatus;
+}

package/dist/Pulse/Model/VendorStatus.js

@@ -0,0 +1,34 @@
+/**
+ * How fresh a competitor's data is within a catalog — the
+ * `/pulse/catalogs/:catalogId/vendors/:vendorId/status` resource.
+ *
+ * `shouldReindex` / `shouldRematch` are the API's judgement that the vendor's products have moved
+ * on since the last index or match run, so the UI can offer to re-run them.
+ */
+export class VendorStatus {
+    vendorId;
+    lastIndexedAt = null;
+    lastImportedAt = null;
+    lastMatchedAt = null;
+    shouldReindex = false;
+    shouldRematch = false;
+    runningMatch = null;
+    constructor(vendorId) {
+        this.vendorId = vendorId;
+    }
+    static parse(raw) {
+        const status = new VendorStatus(raw.vendor);
+        status.lastIndexedAt = raw.last_indexed_at ? new Date(raw.last_indexed_at) : null;
+        status.lastImportedAt = raw.last_imported_at ? new Date(raw.last_imported_at) : null;
+        status.lastMatchedAt = raw.last_matched_at ? new Date(raw.last_matched_at) : null;
+        status.shouldReindex = raw.should_reindex === true;
+        status.shouldRematch = raw.should_rematch === true;
+        const running = raw.running_match ?? null;
+        status.runningMatch = running === null ? null : {
+            productsTotal: running.products_total ?? null,
+            productsProcessed: running.products_processed ?? null,
+            matchesFound: running.matches_found ?? 0,
+        };
+        return status;
+    }
+}

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

@@ -0,0 +1,15 @@
+import { CatalogId } from '../../Catalog/Model/CatalogId.js';
+import { CursorPagination } from '../../Model/Pagination/CursorPagination.js';
+import { CollectionResult } from '../../Model/Result/CollectionResult.js';
+import { Endpoint } from '../../Service/Endpoint.js';
+import { Competitor } from '../Model/Competitor.js';
+/**
+ * The competitors a catalog is watched against — `/pulse/catalogs/:catalogId/competing-vendors`
+ * for the catalog's list, `/pulse/competing-vendors/:competitorId` for one.
+ */
+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>;
+}

package/dist/Pulse/Service/CompetitorEndpoint.js

@@ -0,0 +1,23 @@
+import { QueryString } from '../../Http/Data/QueryString.js';
+import { Endpoint } from '../../Service/Endpoint.js';
+import { Competitor } from '../Model/Competitor.js';
+/**
+ * The competitors a catalog is watched against — `/pulse/catalogs/:catalogId/competing-vendors`
+ * for the catalog's list, `/pulse/competing-vendors/:competitorId` for one.
+ */
+export class CompetitorEndpoint extends Endpoint {
+    async getByCatalog(catalogId, pagination = null) {
+        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/competing-vendors');
+        queryString.addPagination(pagination);
+        return await this.requestCollection(queryString, Competitor.parse);
+    }
+    async getById(competitorId) {
+        const result = await this.requestObject('/pulse/competing-vendors/' + competitorId, null, Competitor.parse, 'GET');
+        return result.getData();
+    }
+    /** Start watching a vendor as a competitor of this catalog. */
+    async add(catalogId, vendorId) {
+        const result = await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/competing-vendors', { vendor: vendorId }, Competitor.parse, 'POST');
+        return result.getData();
+    }
+}

package/dist/{Service/Pulse → Pulse/Service}/CrawlJobEndpoint.d.ts

@@ -1,5 +1,8 @@
-import { CrawlJob, CrawlJobStatus } from '../../Model/Pulse/CrawlJob.js';
-import { Endpoint } from '../Endpoint.js';
+import { CatalogId } from '../../Catalog/Model/CatalogId.js';
+import { CursorPagination } from '../../Model/Pagination/CursorPagination.js';
+import { CrawlJob, CrawlJobStatus } from '../Model/CrawlJob.js';
+import { CollectionResult } from '../../Model/Result/CollectionResult.js';
+import { Endpoint } from '../../Service/Endpoint.js';
 /**
  * Market Pulse crawl jobs — `/pulse/crawl-jobs`. Mirrors the PHP client's MarketPulse\CrawlJobEndpoint.
  * A crawl job's lifecycle drives the vendor's "last scraped" timestamp and, on `finished`, triggers
@@ -11,7 +14,14 @@ export declare class CrawlJobEndpoint extends Endpoint {
     /** Update a crawl job's status ('started', 'finished', 'cancelled'). */
     updateStatus(crawlJobId: string, status: CrawlJobStatus): Promise<CrawlJob>;
     /** A vendor's crawl jobs (newest first), each with progress (`total` / `processed`). */
-    getByVendor(vendorId: string): Promise<CrawlJob[]>;
+    getByVendor(vendorId: string, pagination?: CursorPagination | null): Promise<CollectionResult<CrawlJob>>;
+    /**
+     * Crawl jobs across every competitor of a catalog (newest first).
+     *
+     * A crawl job belongs to a vendor, not to a catalog — the API resolves the catalog's competitors
+     * and returns the jobs of their vendors.
+     */
+    getByCatalog(catalogId: CatalogId | string, pagination?: CursorPagination | null): Promise<CollectionResult<CrawlJob>>;
     /** The crawl job with this id, or null. */
     getById(crawlJobId: string): Promise<CrawlJob | null>;
     /** Register the pages this crawl will process (idempotent server-side). */

package/dist/{Service/Pulse → Pulse/Service}/CrawlJobEndpoint.js

@@ -1,5 +1,6 @@
-import { CrawlJob } from '../../Model/Pulse/CrawlJob.js';
-import { Endpoint } from '../Endpoint.js';
+import { QueryString } from '../../Http/Data/QueryString.js';
+import { CrawlJob } from '../Model/CrawlJob.js';
+import { Endpoint } from '../../Service/Endpoint.js';
 /**
  * Market Pulse crawl jobs — `/pulse/crawl-jobs`. Mirrors the PHP client's MarketPulse\CrawlJobEndpoint.
  * A crawl job's lifecycle drives the vendor's "last scraped" timestamp and, on `finished`, triggers
@@ -25,9 +26,21 @@ export class CrawlJobEndpoint extends Endpoint {
         return job;
     }
     /** A vendor's crawl jobs (newest first), each with progress (`total` / `processed`). */
-    async getByVendor(vendorId) {
-        const result = await this.requestCollection('/pulse/vendors/' + vendorId + '/crawl-jobs', CrawlJob.parse);
-        return result.getData();
+    async getByVendor(vendorId, pagination = null) {
+        const queryString = new QueryString('/pulse/vendors/' + vendorId + '/crawl-jobs');
+        queryString.addPagination(pagination);
+        return await this.requestCollection(queryString, CrawlJob.parse);
+    }
+    /**
+     * Crawl jobs across every competitor of a catalog (newest first).
+     *
+     * A crawl job belongs to a vendor, not to a catalog — the API resolves the catalog's competitors
+     * and returns the jobs of their vendors.
+     */
+    async getByCatalog(catalogId, pagination = null) {
+        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/crawl-jobs');
+        queryString.addPagination(pagination);
+        return await this.requestCollection(queryString, CrawlJob.parse);
     }
     /** The crawl job with this id, or null. */
     async getById(crawlJobId) {