@attlaz/client 1.95.0 → 1.97.0

package/dist/Logging/Service/LogEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Log } from '../Model/Log.js';
 import { LogStream } from '../Model/LogStream.js';
@@ -36,12 +37,13 @@ export class LogEndpoint extends Endpoint {
             const strTags = arrTags.join(',');
             arrQuery.push('tags=' + strTags);
         }
-        const cmd = '/logstreams/' + logQuery.logStreamId.toString() + '/logs/?' + arrQuery.join('&');
+        const cmd = path('/logstreams/:logStreamId/logs/', { logStreamId: logQuery.logStreamId.toString() })
+            + '?' + arrQuery.join('&');
         const result = await this.requestCollection(cmd, Log.parse);
         return result;
     }
     async getCursoredLogEntries(logStreamId, pagination, filter) {
-        const queryString = new QueryString('/logstreams/' + logStreamId.toString() + '/logs');
+        const queryString = new QueryString(path('/logstreams/:logStreamId/logs', { logStreamId: logStreamId.toString() }));
         queryString.addPagination(pagination);
         if (filter !== null && filter !== undefined) {
             queryString.set('filter', JSON.stringify(filter));
@@ -51,7 +53,7 @@ export class LogEndpoint extends Endpoint {
     }
     async save(log) {
         try {
-            const cmd = '/logstreams/' + log.logStream.toString() + '/logs';
+            const cmd = path('/logstreams/:logStream/logs', { logStream: log.logStream.toString() });
             const result = await this.requestObject(cmd, log, Log.parse, 'POST');
             const updatedLogEntry = result.getData();
             if (updatedLogEntry === null) {
@@ -66,8 +68,12 @@ export class LogEndpoint extends Endpoint {
             throw error;
         }
     }
-    async delete(logId) {
-        const cmd = '/logstreams/:streamId/logs/' + logId;
+    /**
+     * The stream id was missing here: the path was built with the literal text `:streamId`, so every
+     * call requested `/logstreams/:streamId/logs/<id>` and could never have matched the route.
+     */
+    async delete(logStreamId, logId) {
+        const cmd = path('/logstreams/:logStreamId/logs/:logId', { logStreamId, logId });
         try {
             const parser = (raw) => ({ deleted: raw.deleted });
             const result = await this.requestObject(cmd, null, parser, 'DELETE');
@@ -86,7 +92,7 @@ export class LogEndpoint extends Endpoint {
         }
     }
     async clear(logStreamId) {
-        const cmd = '/logstreams/' + logStreamId.toString() + '/clear';
+        const cmd = path('/logstreams/:logStreamId/clear', { logStreamId: logStreamId.toString() });
         try {
             const parser = (raw) => ({ cleared: raw.cleared });
             const result = await this.requestObject(cmd, null, parser, 'POST');
@@ -106,7 +112,7 @@ export class LogEndpoint extends Endpoint {
     }
     async getInformation(logStreamId) {
         try {
-            const url = '/logstreams/' + logStreamId.toString() + '/info';
+            const url = path('/logstreams/:logStreamId/info', { logStreamId: logStreamId.toString() });
             const result = await this.requestObject(url, null, LogStreamInformation.parse);
             return result.getData();
         }
@@ -118,7 +124,7 @@ export class LogEndpoint extends Endpoint {
         }
     }
     async getByProject(projectId, pagination = null) {
-        const queryString = new QueryString('projects/' + projectId + '/logstreams');
+        const queryString = new QueryString(path('projects/:projectId/logstreams', { projectId }));
         queryString.addPagination(pagination);
         const parser = (raw) => new LogStream(new LogStreamId(raw.id), raw.name);
         const result = await this.requestCollection(queryString, parser);

package/dist/{Pulse → MarketPulse}/Service/CompetitorEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Endpoint } from '../../Service/Endpoint.js';
 import { Competitor } from '../Model/Competitor.js';
@@ -7,17 +8,17 @@ import { Competitor } from '../Model/Competitor.js';
  */
 export class CompetitorEndpoint extends Endpoint {
     async getByCatalog(catalogId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/competing-vendors');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/competing-vendors', { catalogId: catalogId.toString() }));
         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');
+        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. */
     async add(catalogId, vendorId) {
-        const result = await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/competing-vendors', { vendor: vendorId }, Competitor.parse, 'POST');
+        const result = await this.requestObject(path('/pulse/catalogs/:catalogId/competing-vendors', { catalogId: catalogId.toString() }), { vendor: vendorId }, Competitor.parse, 'POST');
         return result.getData();
     }
 }

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

@@ -32,5 +32,6 @@ export declare class CrawlJobEndpoint extends Endpoint {
     markPagesParsed(crawlJobId: string, urls: string[]): Promise<void>;
     /** Mark pages as failed (terminal, e.g. blocked/unfetchable). */
     markPagesFailed(crawlJobId: string, urls: string[]): Promise<void>;
+    /** @param suffix a literal trailing segment, e.g. `/pages/crawled` — not caller data. */
     private postUrls;
 }

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

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { CrawlJob } from '../Model/CrawlJob.js';
 import { Endpoint } from '../../Service/Endpoint.js';
@@ -18,7 +19,7 @@ export class CrawlJobEndpoint extends Endpoint {
     }
     /** Update a crawl job's status ('started', 'finished', 'cancelled'). */
     async updateStatus(crawlJobId, status) {
-        const result = await this.requestObject('/pulse/crawl-jobs/' + crawlJobId, { status }, CrawlJob.parse, 'PATCH');
+        const result = await this.requestObject(path('/pulse/crawl-jobs/:crawlJobId', { crawlJobId }), { status }, CrawlJob.parse, 'PATCH');
         const job = result.getData();
         if (job === null) {
             throw new Error('Unable to update crawl job: empty response');
@@ -27,7 +28,7 @@ export class CrawlJobEndpoint extends Endpoint {
     }
     /** A vendor's crawl jobs (newest first), each with progress (`total` / `processed`). */
     async getByVendor(vendorId, pagination = null) {
-        const queryString = new QueryString('/pulse/vendors/' + vendorId + '/crawl-jobs');
+        const queryString = new QueryString(path('/pulse/vendors/:vendorId/crawl-jobs', { vendorId }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, CrawlJob.parse);
     }
@@ -38,13 +39,13 @@ export class CrawlJobEndpoint extends Endpoint {
      * and returns the jobs of their vendors.
      */
     async getByCatalog(catalogId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/crawl-jobs');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/crawl-jobs', { catalogId: catalogId.toString() }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, CrawlJob.parse);
     }
     /** The crawl job with this id, or null. */
     async getById(crawlJobId) {
-        const result = await this.requestObject('/pulse/crawl-jobs/' + crawlJobId, null, CrawlJob.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/crawl-jobs/:crawlJobId', { crawlJobId }), null, CrawlJob.parse, 'GET');
         return result.getData();
     }
     /** Register the pages this crawl will process (idempotent server-side). */
@@ -63,10 +64,11 @@ export class CrawlJobEndpoint extends Endpoint {
     async markPagesFailed(crawlJobId, urls) {
         await this.postUrls(crawlJobId, '/pages/failed', urls);
     }
-    async postUrls(crawlJobId, path, urls) {
+    /** @param suffix a literal trailing segment, e.g. `/pages/crawled` — not caller data. */
+    async postUrls(crawlJobId, suffix, urls) {
         if (urls.length === 0) {
             return;
         }
-        await this.requestObject('/pulse/crawl-jobs/' + crawlJobId + path, { urls }, (raw) => raw, 'POST');
+        await this.requestObject(path('/pulse/crawl-jobs/:crawlJobId', { crawlJobId }) + suffix, { urls }, (raw) => raw, 'POST');
     }
 }

package/dist/{Pulse → MarketPulse}/Service/IndexJobEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Endpoint } from '../../Service/Endpoint.js';
 import { IndexJob } from '../Model/IndexJob.js';
@@ -9,23 +10,23 @@ import { VendorStatus } from '../Model/VendorStatus.js';
 export class IndexJobEndpoint extends Endpoint {
     /** Index jobs across every competitor of a catalog, newest first. */
     async getByCatalog(catalogId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/index-jobs');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/index-jobs', { catalogId: catalogId.toString() }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, IndexJob.parse);
     }
     /** Index jobs of one competitor. */
     async getByVendor(catalogId, vendorId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/vendors/' + vendorId + '/index-jobs');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/vendors/:vendorId/index-jobs', { catalogId: catalogId.toString(), vendorId }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, IndexJob.parse);
     }
     /** Queue a re-index of a competitor's products, so later matching sees current data. */
     async requestReindex(catalogId, vendorId) {
-        await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/vendors/' + vendorId + '/reindex', {}, (raw) => raw, 'POST');
+        await this.requestObject(path('/pulse/catalogs/:catalogId/vendors/:vendorId/reindex', { catalogId: catalogId.toString(), vendorId }), {}, (raw) => raw, 'POST');
     }
     /** How fresh a competitor's index and matches are, plus any match job running right now. */
     async getVendorStatus(catalogId, vendorId) {
-        const result = await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/vendors/' + vendorId + '/status', null, VendorStatus.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/catalogs/:catalogId/vendors/:vendorId/status', { catalogId: catalogId.toString(), vendorId }), null, VendorStatus.parse, 'GET');
         return result.getData();
     }
 }

package/dist/{Pulse → MarketPulse}/Service/PriceAlertEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Endpoint } from '../../Service/Endpoint.js';
 import { PriceAlertConfig } from '../Model/PriceAlertConfig.js';
@@ -7,27 +8,27 @@ import { PriceAlertEvent } from '../Model/PriceAlertEvent.js';
  */
 export class PriceAlertEndpoint extends Endpoint {
     async getConfigs(catalogId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/price-alert-configs');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/price-alert-configs', { catalogId: catalogId.toString() }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, PriceAlertConfig.parse);
     }
     async getConfig(alertConfigId) {
-        const result = await this.requestObject('/pulse/price-alert-configs/' + alertConfigId, null, PriceAlertConfig.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/price-alert-configs/:alertConfigId', { alertConfigId }), null, PriceAlertConfig.parse, 'GET');
         return result.getData();
     }
     async createConfig(catalogId, data) {
-        const result = await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/price-alert-configs', data, PriceAlertConfig.parse, 'POST');
+        const result = await this.requestObject(path('/pulse/catalogs/:catalogId/price-alert-configs', { catalogId: catalogId.toString() }), data, PriceAlertConfig.parse, 'POST');
         return result.getData();
     }
     async updateConfig(alertConfigId, data) {
-        const result = await this.requestObject('/pulse/price-alert-configs/' + alertConfigId, data, PriceAlertConfig.parse, 'PATCH');
+        const result = await this.requestObject(path('/pulse/price-alert-configs/:alertConfigId', { alertConfigId }), data, PriceAlertConfig.parse, 'PATCH');
         return result.getData();
     }
     async deleteConfig(alertConfigId) {
-        await this.requestObject('/pulse/price-alert-configs/' + alertConfigId, null, (raw) => raw, 'DELETE');
+        await this.requestObject(path('/pulse/price-alert-configs/:alertConfigId', { alertConfigId }), null, (raw) => raw, 'DELETE');
     }
     async getEvents(alertConfigId, pagination = null) {
-        const queryString = new QueryString('/pulse/price-alert-configs/' + alertConfigId + '/events');
+        const queryString = new QueryString(path('/pulse/price-alert-configs/:alertConfigId/events', { alertConfigId }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, PriceAlertEvent.parse);
     }
@@ -36,7 +37,7 @@ export class PriceAlertEndpoint extends Endpoint {
      * when from the session, so the request carries no body.
      */
     async acknowledgeEvent(alertEventId) {
-        const result = await this.requestObject('/pulse/price-alert-events/' + alertEventId, {}, PriceAlertEvent.parse, 'PATCH');
+        const result = await this.requestObject(path('/pulse/price-alert-events/:alertEventId', { alertEventId }), {}, PriceAlertEvent.parse, 'PATCH');
         return result.getData();
     }
 }

package/dist/{Pulse → MarketPulse}/Service/PricingEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Endpoint } from '../../Service/Endpoint.js';
 import { PriceSuggestion } from '../Model/PriceSuggestion.js';
@@ -8,28 +9,28 @@ import { PricingRule } from '../Model/PricingRule.js';
  */
 export class PricingEndpoint extends Endpoint {
     async getRules(catalogId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/pricing-rules');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/pricing-rules', { catalogId: catalogId.toString() }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, PricingRule.parse);
     }
     async getRule(pricingRuleId) {
-        const result = await this.requestObject('/pulse/pricing-rules/' + pricingRuleId, null, PricingRule.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/pricing-rules/:pricingRuleId', { pricingRuleId }), null, PricingRule.parse, 'GET');
         return result.getData();
     }
     async createRule(catalogId, data) {
-        const result = await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/pricing-rules', data, PricingRule.parse, 'POST');
+        const result = await this.requestObject(path('/pulse/catalogs/:catalogId/pricing-rules', { catalogId: catalogId.toString() }), data, PricingRule.parse, 'POST');
         return result.getData();
     }
     async updateRule(pricingRuleId, data) {
-        const result = await this.requestObject('/pulse/pricing-rules/' + pricingRuleId, data, PricingRule.parse, 'PATCH');
+        const result = await this.requestObject(path('/pulse/pricing-rules/:pricingRuleId', { pricingRuleId }), data, PricingRule.parse, 'PATCH');
         return result.getData();
     }
     async deleteRule(pricingRuleId) {
-        await this.requestObject('/pulse/pricing-rules/' + pricingRuleId, null, (raw) => raw, 'DELETE');
+        await this.requestObject(path('/pulse/pricing-rules/:pricingRuleId', { pricingRuleId }), null, (raw) => raw, 'DELETE');
     }
     /** Price suggestions of a catalog, optionally only those in one status. */
     async getSuggestions(catalogId, pagination = null, status = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/price-suggestions');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/price-suggestions', { catalogId: catalogId.toString() }));
         if (status !== null) {
             queryString.set('status', status);
         }
@@ -37,7 +38,7 @@ export class PricingEndpoint extends Endpoint {
         return await this.requestCollection(queryString, PriceSuggestion.parse);
     }
     async getSuggestion(priceSuggestionId) {
-        const result = await this.requestObject('/pulse/price-suggestions/' + priceSuggestionId, null, PriceSuggestion.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/price-suggestions/:priceSuggestionId', { priceSuggestionId }), null, PriceSuggestion.parse, 'GET');
         return result.getData();
     }
     /**
@@ -45,7 +46,7 @@ export class PricingEndpoint extends Endpoint {
      * itself is done by a flow, which sets `appliedAt`.
      */
     async reviewSuggestion(priceSuggestionId, status) {
-        const result = await this.requestObject('/pulse/price-suggestions/' + priceSuggestionId, { status }, PriceSuggestion.parse, 'PATCH');
+        const result = await this.requestObject(path('/pulse/price-suggestions/:priceSuggestionId', { priceSuggestionId }), { status }, PriceSuggestion.parse, 'PATCH');
         return result.getData();
     }
 }

package/dist/{Pulse → MarketPulse}/Service/ProductGroupEndpoint.js

@@ -1,19 +1,20 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Endpoint } from '../../Service/Endpoint.js';
 import { ProductGroup } from '../Model/ProductGroup.js';
 /** Product groups — `/pulse/catalogs/:catalogId/product-groups`. */
 export class ProductGroupEndpoint extends Endpoint {
     async getByCatalog(catalogId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/product-groups');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/product-groups', { catalogId: catalogId.toString() }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, ProductGroup.parse);
     }
     async getById(productGroupId) {
-        const result = await this.requestObject('/pulse/product-groups/' + productGroupId, null, ProductGroup.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/product-groups/:productGroupId', { productGroupId }), null, ProductGroup.parse, 'GET');
         return result.getData();
     }
     async create(catalogId, data) {
-        const result = await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/product-groups', data, ProductGroup.parse, 'POST');
+        const result = await this.requestObject(path('/pulse/catalogs/:catalogId/product-groups', { catalogId: catalogId.toString() }), data, ProductGroup.parse, 'POST');
         return result.getData();
     }
 }

package/dist/{Pulse → MarketPulse}/Service/ProductMatchEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Endpoint } from '../../Service/Endpoint.js';
 import { ProductMatch } from '../Model/ProductMatch.js';
@@ -9,7 +10,7 @@ import { ReviewMatch } from '../Model/ReviewMatch.js';
 export class ProductMatchEndpoint extends Endpoint {
     /** The review queue of a catalog; pending matches unless `statuses` says otherwise. */
     async getForReview(catalogId, pagination = null, filters = {}) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/matches');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/matches', { catalogId: catalogId.toString() }));
         queryString.set('status', (filters.statuses ?? ['pending']).join(','));
         if (filters.competitor) {
             queryString.set('competitor', filters.competitor);
@@ -25,20 +26,20 @@ export class ProductMatchEndpoint extends Endpoint {
     }
     /** The match record, or null. */
     async getById(matchId) {
-        const result = await this.requestObject('/pulse/matches/' + matchId, null, ProductMatch.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/matches/:matchId', { matchId }), null, ProductMatch.parse, 'GET');
         return result.getData();
     }
     /** Confirm a match. `note` records why, for the reviewer's own audit trail. */
     async accept(matchId, note = null) {
-        await this.requestObject('/pulse/matches/' + matchId + '/accept', note === null ? {} : { note }, (raw) => raw, 'POST');
+        await this.requestObject(path('/pulse/matches/:matchId/accept', { matchId }), note === null ? {} : { note }, (raw) => raw, 'POST');
     }
     /** Reject a match, so it stops counting towards the competitor's price index. */
     async decline(matchId, note = null) {
-        await this.requestObject('/pulse/matches/' + matchId + '/decline', note === null ? {} : { note }, (raw) => raw, 'POST');
+        await this.requestObject(path('/pulse/matches/:matchId/decline', { matchId }), note === null ? {} : { note }, (raw) => raw, 'POST');
     }
     /** How many matches were discovered and reviewed over time, optionally for one competitor. */
     async getHistory(catalogId, competitor = null, interval = 'day') {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/matches/history');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/matches/history', { catalogId: catalogId.toString() }));
         queryString.set('interval', interval);
         if (competitor !== null) {
             queryString.set('competitor', competitor);

package/dist/{Pulse → MarketPulse}/Service/ProductMatchJobEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { ProductMatchJob } from '../Model/ProductMatchJob.js';
 import { Endpoint } from '../../Service/Endpoint.js';
@@ -8,23 +9,23 @@ import { Endpoint } from '../../Service/Endpoint.js';
 export class ProductMatchJobEndpoint extends Endpoint {
     /** Every match job of a catalog, newest first. */
     async getByCatalog(catalogId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/match-jobs');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/match-jobs', { catalogId: catalogId.toString() }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, ProductMatchJob.parse);
     }
     /** The match jobs of one of the catalog's competitors. */
     async getByVendor(catalogId, vendorId, pagination = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/vendors/' + vendorId + '/match-jobs');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/vendors/:vendorId/match-jobs', { catalogId: catalogId.toString(), vendorId }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, ProductMatchJob.parse);
     }
     /** Queue a matching run of the catalog against one competitor. */
     async requestMatching(catalogId, vendorId) {
-        await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/vendors/' + vendorId + '/match', {}, (raw) => raw, 'POST');
+        await this.requestObject(path('/pulse/catalogs/:catalogId/vendors/:vendorId/match', { catalogId: catalogId.toString(), vendorId }), {}, (raw) => raw, 'POST');
     }
     /** The match job with this id, or null. */
     async getById(productMatchJobId) {
-        const result = await this.requestObject('/pulse/match-jobs/' + productMatchJobId, null, ProductMatchJob.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/match-jobs/:productMatchJobId', { productMatchJobId }), null, ProductMatchJob.parse, 'GET');
         return result.getData();
     }
 }

package/dist/{Pulse → MarketPulse}/Service/PulseCatalogProductEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Endpoint } from '../../Service/Endpoint.js';
 import { CatalogProductWithMatches } from '../Model/CatalogProductWithMatches.js';
@@ -13,7 +14,7 @@ export class PulseCatalogProductEndpoint extends Endpoint {
      * anything the simple filters cannot express.
      */
     async getProducts(catalogId, pagination = null, filters = {}, filter = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/products');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/products', { catalogId: catalogId.toString() }));
         queryString.set('expand', ['matches.vendor']);
         if (filters.brand) {
             queryString.set('brand', filters.brand);
@@ -39,7 +40,7 @@ export class PulseCatalogProductEndpoint extends Endpoint {
         return await this.requestCollection(queryString, CatalogProductWithMatches.parse);
     }
     async getFilterOptions(catalogId) {
-        const result = await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/filter-options', null, (raw) => ({
+        const result = await this.requestObject(path('/pulse/catalogs/:catalogId/filter-options', { catalogId: catalogId.toString() }), null, (raw) => ({
             brands: raw.brands ?? [],
             categories: raw.categories ?? [],
             productGroups: raw.product_groups ?? [],
@@ -49,6 +50,6 @@ export class PulseCatalogProductEndpoint extends Endpoint {
     }
     /** Recalculate the catalog's cached statistics (price index, match counts, segments). */
     async recomputeStatistics(catalogId) {
-        await this.requestObject('/pulse/catalogs/' + catalogId.toString() + '/recompute-stats', {}, (raw) => raw, 'POST');
+        await this.requestObject(path('/pulse/catalogs/:catalogId/recompute-stats', { catalogId: catalogId.toString() }), {}, (raw) => raw, 'POST');
     }
 }

package/dist/{Pulse → MarketPulse}/Service/PulseStatisticsEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { Endpoint } from '../../Service/Endpoint.js';
 import { PriceIndexSnapshotEntry } from '../Model/PriceIndexSnapshotEntry.js';
@@ -9,7 +10,7 @@ import { TopCompetitor } from '../Model/TopCompetitor.js';
 export class PulseStatisticsEndpoint extends Endpoint {
     /** Headline figures (products tracked, matches, competitors …) against the previous period. */
     async getAccountSummary(catalogId) {
-        return await this.requestCollection('/pulse/catalogs/' + catalogId.toString() + '/statistics/account-summary', (raw) => ({
+        return await this.requestCollection(path('/pulse/catalogs/:catalogId/statistics/account-summary', { catalogId: catalogId.toString() }), (raw) => ({
             id: raw.id,
             title: raw.title,
             currentAmount: raw.current_amount ?? 0,
@@ -18,7 +19,7 @@ export class PulseStatisticsEndpoint extends Endpoint {
     }
     /** Distribution of the catalog's products across price or profit segments. */
     async getProductSegments(catalogId, type = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/statistics/product-segments');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/statistics/product-segments', { catalogId: catalogId.toString() }));
         if (type !== null) {
             queryString.set('type', type);
         }
@@ -33,7 +34,7 @@ export class PulseStatisticsEndpoint extends Endpoint {
      * the comparison against the previous period spans.
      */
     async getTopCompetitors(catalogId, limit = null, period = null) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/statistics/top-competitors');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/statistics/top-competitors', { catalogId: catalogId.toString() }));
         if (limit !== null) {
             queryString.set('limit', limit);
         }
@@ -47,7 +48,7 @@ export class PulseStatisticsEndpoint extends Endpoint {
      * optionally a product group to scope to and a date range (`YYYY-MM-DD`).
      */
     async getPriceIndexHistory(catalogId, competitorIds = [], options = {}) {
-        const queryString = new QueryString('/pulse/catalogs/' + catalogId.toString() + '/statistics/price-index-history');
+        const queryString = new QueryString(path('/pulse/catalogs/:catalogId/statistics/price-index-history', { catalogId: catalogId.toString() }));
         if (competitorIds.length > 0) {
             queryString.set('competitor', competitorIds.join(','));
         }

package/dist/{Pulse → MarketPulse}/Service/VendorProductEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../../Http/Data/Path.js';
 import { QueryString } from '../../Http/Data/QueryString.js';
 import { CompetingVendorProduct } from '../Model/CompetingVendorProduct.js';
 import { VendorProduct } from '../Model/VendorProduct.js';
@@ -10,7 +11,7 @@ import { Endpoint } from '../../Service/Endpoint.js';
 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 result = await this.requestCollection(path('/pulse/vendors/:vendorId/products', { vendorId }) + '?identifier=' + encodeURIComponent(identifier), VendorProduct.parse);
         const products = result.getData();
         return products.length > 0 ? products[0] : null;
     }
@@ -19,18 +20,18 @@ export class VendorProductEndpoint extends Endpoint {
      * Same products as {@link getByVendor}, read through the competitor, so `competitorId` is set.
      */
     async getByCompetitor(competitorId, pagination = null) {
-        const queryString = new QueryString('/pulse/competing-vendors/' + competitorId + '/products');
+        const queryString = new QueryString(path('/pulse/competing-vendors/:competitorId/products', { competitorId }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, CompetingVendorProduct.parse);
     }
     /** A single competitor product — `/pulse/competing-vendors/products/:id`. */
     async getCompetitorProductById(competingVendorProductId) {
-        const result = await this.requestObject('/pulse/competing-vendors/products/' + competingVendorProductId, null, CompetingVendorProduct.parse, 'GET');
+        const result = await this.requestObject(path('/pulse/competing-vendors/products/:competingVendorProductId', { competingVendorProductId }), null, CompetingVendorProduct.parse, 'GET');
         return result.getData();
     }
     /** A vendor's products. */
     async getByVendor(vendorId, pagination = null) {
-        const queryString = new QueryString('/pulse/vendors/' + vendorId + '/products');
+        const queryString = new QueryString(path('/pulse/vendors/:vendorId/products', { vendorId }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, VendorProduct.parse);
     }
@@ -39,7 +40,7 @@ export class VendorProductEndpoint extends Endpoint {
      * entries (the API defaults to 365).
      */
     async getPriceHistory(vendorProductId, limit = null) {
-        const queryString = new QueryString('/pulse/vendor-products/' + vendorProductId + '/price-history');
+        const queryString = new QueryString(path('/pulse/vendor-products/:vendorProductId/price-history', { vendorProductId }));
         if (limit !== null) {
             queryString.set('limit', limit.toString());
         }
@@ -63,7 +64,7 @@ export class VendorProductEndpoint extends Endpoint {
             isInStock: product.isInStock,
             properties: product.properties,
         };
-        const result = await this.requestObject('/pulse/vendors/' + product.vendorId + '/products', body, VendorProduct.parse, 'POST');
+        const result = await this.requestObject(path('/pulse/vendors/:vendorId/products', { vendorId: product.vendorId }), body, VendorProduct.parse, 'POST');
         return result.getData() ?? product;
     }
     /** Update the mutable fields of an existing vendor product (JSON-patch style, per the API). */
@@ -79,6 +80,9 @@ export class VendorProductEndpoint extends Endpoint {
             { 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');
+        if (product.id === null) {
+            throw new Error('Unable to update vendor product: the product has no id. Save it first.');
+        }
+        await this.requestObject(path('/pulse/vendors/:vendorId/products/:id', { vendorId: product.vendorId, id: product.id }), operations, (raw) => raw, 'PATCH');
     }
 }

package/dist/Service/AccessTokenEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../Http/Data/Path.js';
 import { QueryString } from '../Http/Data/QueryString.js';
 import { UserAccessToken } from '../Model/AccessToken/UserAccessToken.js';
 import { Endpoint } from './Endpoint.js';
@@ -43,7 +44,7 @@ export class AccessTokenEndpoint extends Endpoint {
     }
     async update(tokenId, name) {
         try {
-            const url = '/access-tokens/' + tokenId;
+            const url = path('/access-tokens/:tokenId', { tokenId });
             const result = await this.requestObject(url, {
                 name,
             }, UserAccessToken.parse, 'POST');
@@ -62,7 +63,7 @@ export class AccessTokenEndpoint extends Endpoint {
     }
     async revoke(tokenId) {
         try {
-            const url = '/access-tokens/' + tokenId;
+            const url = path('/access-tokens/:tokenId', { tokenId });
             const parser = (raw) => ({ revoked: raw.revoked });
             const result = await this.requestObject(url, null, parser, 'DELETE');
             const res = result.getData();