@attlaz/client 1.96.0 → 1.97.0

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();

package/dist/Service/AdapterConnectionEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../Http/Data/Path.js';
 import { AdapterConnection } from '../Model/Adapter/AdapterConnection.js';
 import { parseTestConnectionResult } from '../Model/Adapter/TestConnectionResult.js';
 import { QueryString } from '../Http/Data/QueryString.js';
@@ -6,7 +7,7 @@ import { Endpoint } from './Endpoint.js';
 export class AdapterConnectionEndpoint extends Endpoint {
     async getConnections(projectId, pagination) {
         try {
-            const queryString = new QueryString('/projects/' + projectId + '/connections');
+            const queryString = new QueryString(path('/projects/:projectId/connections', { projectId }));
             queryString.addPagination(pagination);
             return await this.requestCollection(queryString, AdapterConnection.parse);
         }
@@ -19,7 +20,7 @@ export class AdapterConnectionEndpoint extends Endpoint {
     }
     async getConnectionById(connectionId) {
         try {
-            const url = '/connections/' + connectionId;
+            const url = path('/connections/:connectionId', { connectionId });
             const result = await this.requestObject(url, null, AdapterConnection.parse);
             return result.getData();
         }
@@ -32,7 +33,7 @@ export class AdapterConnectionEndpoint extends Endpoint {
     }
     async getConnectionByKey(projectId, connectionKey) {
         try {
-            const url = '/projects/' + projectId + '/connections/' + connectionKey;
+            const url = path('/projects/:projectId/connections/:connectionKey', { projectId, connectionKey });
             const result = await this.requestObject(url, null, AdapterConnection.parse);
             return result.getData();
         }
@@ -45,7 +46,7 @@ export class AdapterConnectionEndpoint extends Endpoint {
     }
     async getConnectionConfiguration(connectionId) {
         try {
-            const url = '/connections/' + connectionId + '/configuration';
+            const url = path('/connections/:connectionId/configuration', { connectionId });
             const parser = (raw) => ({
                 id: raw.id,
                 adapterConnectionId: raw.adapter_connection,
@@ -63,7 +64,7 @@ export class AdapterConnectionEndpoint extends Endpoint {
     }
     async saveConnection(projectId, connection) {
         try {
-            const url = '/projects/' + projectId + '/connections';
+            const url = path('/projects/:projectId/connections', { projectId });
             const result = await this.requestObject(url, connection, AdapterConnection.parse, 'POST');
             const updatedAdapterConnection = result.getData();
             if (updatedAdapterConnection === null) {
@@ -80,7 +81,7 @@ export class AdapterConnectionEndpoint extends Endpoint {
     }
     async saveConnectionConfiguration(connectionId, configuration) {
         try {
-            const url = '/connections/' + connectionId + '/configuration';
+            const url = path('/connections/:connectionId/configuration', { connectionId });
             const parser = (raw) => ({ saved: raw.saved });
             const result = await this.requestObject(url, { configuration: configuration }, parser, 'POST');
             const res = result.getData();
@@ -97,7 +98,7 @@ export class AdapterConnectionEndpoint extends Endpoint {
         }
     }
     async getConnectionEvents(connectionId, pagination) {
-        const queryString = new QueryString('/adapters/connections/' + connectionId + '/events');
+        const queryString = new QueryString(path('/adapters/connections/:connectionId/events', { connectionId }));
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, AdapterConnectionEvent.parse);
     }
@@ -113,7 +114,7 @@ export class AdapterConnectionEndpoint extends Endpoint {
      * `POST /connections/:id/check` route on Core-Api (removed).
      */
     async testConnection(connectionId) {
-        const url = '/services/' + connectionId + '/test-connection';
+        const url = path('/services/:connectionId/test-connection', { connectionId });
         const result = await this.requestObject(url, null, parseTestConnectionResult, 'POST');
         const data = result.getData();
         if (data === null) {

package/dist/Service/AdapterEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../Http/Data/Path.js';
 import { Adapter } from '../Model/Adapter/Adapter.js';
 import { AdapterConfiguration } from '../Model/Adapter/AdapterConfiguration.js';
 import { QueryString } from '../Http/Data/QueryString.js';
@@ -22,7 +23,7 @@ export class AdapterEndpoint extends Endpoint {
     }
     async getAdapter(adapterId, withMedia = false) {
         try {
-            const queryString = new QueryString('/adapters/' + adapterId);
+            const queryString = new QueryString(path('/adapters/:adapterId', { adapterId }));
             if (withMedia) {
                 queryString.set('with-media', true);
             }
@@ -38,7 +39,7 @@ export class AdapterEndpoint extends Endpoint {
     }
     async getAdapterConfiguration(adapterId) {
         try {
-            const url = '/adapters/' + adapterId + '/configuration';
+            const url = path('/adapters/:adapterId/configuration', { adapterId });
             return await this.requestCollection(url, AdapterConfiguration.parse);
         }
         catch (error) {

package/dist/Service/ChannelEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../Http/Data/Path.js';
 import { Channel } from '../Model/Messaging/Channel/Channel.js';
 import { ChannelHistory } from '../Model/Messaging/ChannelHistory.js';
 import { QueryString } from '../Http/Data/QueryString.js';
@@ -5,7 +6,7 @@ import { Endpoint } from './Endpoint.js';
 export class ChannelEndpoint extends Endpoint {
     async getById(channelId) {
         try {
-            const result = await this.requestObject('/channels/' + channelId + '', null, Channel.parse);
+            const result = await this.requestObject(path('/channels/:channelId', { channelId }), null, Channel.parse);
             return result.getData();
         }
         catch (ex) {
@@ -17,7 +18,7 @@ export class ChannelEndpoint extends Endpoint {
     }
     async getByWorkspace(workspaceId, pagination = null) {
         try {
-            const queryString = new QueryString('/workspaces/' + workspaceId + '/channels');
+            const queryString = new QueryString(path('/workspaces/:workspaceId/channels', { workspaceId }));
             queryString.addPagination(pagination);
             const result = await this.requestCollection(queryString, Channel.parse);
             return result;
@@ -45,7 +46,7 @@ export class ChannelEndpoint extends Endpoint {
     }
     async getMessages(channelId, pagination = null) {
         try {
-            const querystring = new QueryString('/channels/' + channelId + '/messages');
+            const querystring = new QueryString(path('/channels/:channelId/messages', { channelId }));
             querystring.addPagination(pagination);
             const result = await this.requestCollection(querystring, ChannelHistory.parse);
             return result;
@@ -76,7 +77,7 @@ export class ChannelEndpoint extends Endpoint {
     }
     async testChannel(subscriberChannel) {
         try {
-            const url = '/channels/' + subscriberChannel.id + '/test';
+            const url = path('/channels/:id/test', { id: subscriberChannel.id });
             const parser = (raw) => ({ tested: raw.tested });
             const result = await this.requestObject(url, {}, parser, 'POST');
             const re = result.getData();

package/dist/Service/CodeDeployEndpoint.js

@@ -1,9 +1,10 @@
+import { path } from '../Http/Data/Path.js';
 import { CodeDeploy } from '../Model/Project/CodeDeploy.js';
 import { Endpoint } from './Endpoint.js';
 export class CodeDeployEndpoint extends Endpoint {
     async getById(deployId) {
         try {
-            const rawDeploy = await this.requestObject('/deploys/' + deployId, null, CodeDeploy.parse);
+            const rawDeploy = await this.requestObject(path('/deploys/:deployId', { deployId }), null, CodeDeploy.parse);
             return rawDeploy.getData();
         }
         catch (error) {
@@ -15,7 +16,7 @@ export class CodeDeployEndpoint extends Endpoint {
     }
     async getLatestDeploy(codeSourceId) {
         try {
-            const rawDeploy = await this.requestObject('/codesources/' + codeSourceId + '/latestdeploy', null, CodeDeploy.parse);
+            const rawDeploy = await this.requestObject(path('/codesources/:codeSourceId/latestdeploy', { codeSourceId }), null, CodeDeploy.parse);
             return rawDeploy.getData();
         }
         catch (error) {
@@ -27,7 +28,7 @@ export class CodeDeployEndpoint extends Endpoint {
     }
     async getByCodeSource(codeSourceId) {
         try {
-            const rawDeploys = await this.requestCollection('/codesources/' + codeSourceId + '/deploys', CodeDeploy.parse);
+            const rawDeploys = await this.requestCollection(path('/codesources/:codeSourceId/deploys', { codeSourceId }), CodeDeploy.parse);
             return rawDeploys;
         }
         catch (error) {
@@ -39,7 +40,7 @@ export class CodeDeployEndpoint extends Endpoint {
     }
     async requestDeploy(codeSourceId) {
         try {
-            const result = await this.requestObject('/codesources/' + codeSourceId + '/deploys', null, CodeDeploy.parse, 'POST');
+            const result = await this.requestObject(path('/codesources/:codeSourceId/deploys', { codeSourceId }), null, CodeDeploy.parse, 'POST');
             const requestedDeploy = result.getData();
             if (requestedDeploy === null) {
                 throw new Error('Deploy not requested');

package/dist/Service/CodeSourceStrategiesEndpoint.js

@@ -1,13 +1,14 @@
+import { path } from '../Http/Data/Path.js';
 import { CodeSourceBuildStrategy } from '../Model/Deployment/CodeSourceBuildStrategy.js';
 import { CodeSourceRunStrategy } from '../Model/Deployment/CodeSourceRunStrategy.js';
 import { Endpoint } from './Endpoint.js';
 export class CodeSourceStrategiesEndpoint extends Endpoint {
     async getAllBuildStrategies(workspaceId) {
-        const cmd = '/workspaces/' + workspaceId + '/codesources/buildstrategies';
+        const cmd = path('/workspaces/:workspaceId/codesources/buildstrategies', { workspaceId });
         return await this.requestCollection(cmd, CodeSourceBuildStrategy.parse);
     }
     async getAllRunStrategies(workspaceId) {
-        const cmd = '/workspaces/' + workspaceId + '/codesources/runstrategies';
+        const cmd = path('/workspaces/:workspaceId/codesources/runstrategies', { workspaceId });
         return await this.requestCollection(cmd, CodeSourceRunStrategy.parse);
     }
 }

package/dist/Service/CollectionsEndpoint.js

@@ -1,16 +1,17 @@
+import { path } from '../Http/Data/Path.js';
 import { QueryString } from '../Http/Data/QueryString.js';
 import { Collection } from '../Model/Collections/Collection.js';
 import { Endpoint } from './Endpoint.js';
 import { CollectionRecord } from '../Model/Collections/CollectionRecord.js';
 export class CollectionsEndpoint extends Endpoint {
     async getAll(projectId, pagination) {
-        const qs = new QueryString('/projects/' + projectId + '/collections');
+        const qs = new QueryString(path('/projects/:projectId/collections', { projectId }));
         qs.addPagination(pagination);
         return await this.requestCollection(qs, Collection.parse);
     }
     async getById(collectionId) {
         try {
-            const qs = new QueryString('/collections/' + collectionId + '');
+            const qs = new QueryString(path('/collections/:collectionId', { collectionId }));
             const result = await this.requestObject(qs, null, Collection.parse);
             return result.getData();
         }
@@ -23,7 +24,7 @@ export class CollectionsEndpoint extends Endpoint {
     }
     async getRecords(collectionId, pagination) {
         try {
-            const qs = new QueryString('/collections/' + collectionId + '/records');
+            const qs = new QueryString(path('/collections/:collectionId/records', { collectionId }));
             qs.addPagination(pagination);
             return await this.requestCollection(qs, CollectionRecord.parse);
         }
@@ -36,7 +37,7 @@ export class CollectionsEndpoint extends Endpoint {
     }
     async addRecord(collectionId, properties) {
         try {
-            const qs = new QueryString('/collections/' + collectionId + '');
+            const qs = new QueryString(path('/collections/:collectionId', { collectionId }));
             const result = await this.requestObject(qs, { properties }, CollectionRecord.parse, 'POST');
             const updatedWorkspace = result.getData();
             if (updatedWorkspace === null) {

package/dist/Service/CommandExecutionEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../Http/Data/Path.js';
 import { QueryString } from '../Http/Data/QueryString.js';
 import { CommandExecutionHistory } from '../Model/Command/CommandExecutionHistory.js';
 import { CommandExecutionStatus } from '../Model/Command/CommandExecutionStatus.js';
@@ -24,7 +25,7 @@ export class CommandExecutionEndpoint extends Endpoint {
         return await this.requestCollection(queryString, CommandExecutionEndpoint.parse, null, 'GET');
     }
     async getById(id) {
-        const queryString = new QueryString('/system/command-executions/' + id);
+        const queryString = new QueryString(path('/system/command-executions/:id', { id }));
         const result = await this.requestObject(queryString, null, CommandExecutionEndpoint.parse, 'GET');
         return result.getData();
     }

package/dist/Service/ConfigEndpoint.d.ts

@@ -3,6 +3,11 @@ import { CollectionResult } from '../Model/Result/CollectionResult.js';
 import { Endpoint } from './Endpoint.js';
 export declare class ConfigEndpoint extends Endpoint {
     getConfigByFlow(flowId: string, projectEnvironmentId?: string | null): Promise<CollectionResult<Config>>;
-    getByProjectEnvironment(projectEnvironmentId?: string | null): Promise<CollectionResult<Config>>;
+    /**
+     * The id is required: the API route is `/projectenvironments/:projectEnvironmentId/configvalues`
+     * and 404s on an unknown environment. It used to default to null, which built
+     * `/projectenvironments/null/configvalues` — a request that could never succeed.
+     */
+    getByProjectEnvironment(projectEnvironmentId: string): Promise<CollectionResult<Config>>;
     saveConfigs(projectId: string, configs: Config[]): Promise<CollectionResult<Config>>;
 }

package/dist/Service/ConfigEndpoint.js

@@ -1,3 +1,4 @@
+import { path } from '../Http/Data/Path.js';
 import { Utils } from '../Utils.js';
 import { Config } from '../Model/Config.js';
 import { Endpoint } from './Endpoint.js';
@@ -8,7 +9,7 @@ export class ConfigEndpoint extends Endpoint {
             if (!Utils.isNullOrUndefined(projectEnvironmentId)) {
                 parameters = { environment: projectEnvironmentId };
             }
-            const result = await this.requestCollection('/flows/' + flowId + '/configvalues', Config.parse, parameters);
+            const result = await this.requestCollection(path('/flows/:flowId/configvalues', { flowId }), Config.parse, parameters);
             return result;
         }
         catch (error) {
@@ -18,9 +19,14 @@ export class ConfigEndpoint extends Endpoint {
             throw error;
         }
     }
-    async getByProjectEnvironment(projectEnvironmentId = null) {
+    /**
+     * The id is required: the API route is `/projectenvironments/:projectEnvironmentId/configvalues`
+     * and 404s on an unknown environment. It used to default to null, which built
+     * `/projectenvironments/null/configvalues` — a request that could never succeed.
+     */
+    async getByProjectEnvironment(projectEnvironmentId) {
         try {
-            const result = await this.requestCollection('/projectenvironments/' + projectEnvironmentId + '/configvalues', Config.parse);
+            const result = await this.requestCollection(path('/projectenvironments/:projectEnvironmentId/configvalues', { projectEnvironmentId }), Config.parse);
             return result;
         }
         catch (error) {