merchi_sdk_ts 1.8.1 → 1.9.0

package/dist/entities/domain.js

@@ -49,57 +49,6 @@ var Domain = /** @class */ (function (_super) {
             }
             return _this.activeTheme;
         };
-        _this.getDomainId = function () {
-            if (_this.id === undefined || _this.id === null) {
-                throw new Error('id is undefined, did you forget to set it?');
-            }
-            return _this.id;
-        };
-        _this.storefrontV2DomainResource = function (suffix) {
-            if (suffix === void 0) { suffix = ''; }
-            return "/domains/".concat(_this.getDomainId(), "/storefront_v2/").concat(suffix);
-        };
-        _this.storefrontV2Request = function (resource, method, payload) {
-            var fetchOptions = {
-                method: method,
-                query: [['skip_rights', 'y']]
-            };
-            if (payload !== undefined) {
-                fetchOptions.body = JSON.stringify(payload);
-                fetchOptions.headers = { 'Content-Type': 'application/json' };
-            }
-            return _this.merchi.authenticatedFetch(resource, fetchOptions);
-        };
-        _this.getStorefrontV2 = function () {
-            return _this.storefrontV2Request(_this.storefrontV2DomainResource(), 'GET');
-        };
-        _this.provisionStorefrontV2 = function (payload) {
-            return _this.storefrontV2Request(_this.storefrontV2DomainResource('provision/'), 'POST', payload);
-        };
-        _this.createStorefrontChangeRequest = function (payload) {
-            return _this.storefrontV2Request(_this.storefrontV2DomainResource('requests/'), 'POST', payload);
-        };
-        _this.getStorefrontChangeRequest = function (requestId) {
-            return _this.storefrontV2Request("/storefront_change_requests/".concat(String(requestId), "/"), 'GET');
-        };
-        _this.runStorefrontChangeRequest = function (requestId, payload) {
-            return _this.storefrontV2Request("/storefront_change_requests/".concat(String(requestId), "/run/"), 'POST', payload);
-        };
-        _this.approveStorefrontChangeRequest = function (requestId, payload) {
-            return _this.storefrontV2Request("/storefront_change_requests/".concat(String(requestId), "/approve/"), 'POST', payload);
-        };
-        _this.rejectStorefrontChangeRequest = function (requestId, payload) {
-            return _this.storefrontV2Request("/storefront_change_requests/".concat(String(requestId), "/reject/"), 'POST', payload);
-        };
-        _this.getStorefrontV2Deployments = function () {
-            return _this.storefrontV2Request(_this.storefrontV2DomainResource('deployments/'), 'GET');
-        };
-        _this.getStorefrontV2DeploymentLogs = function (deploymentId) {
-            return _this.storefrontV2Request(_this.storefrontV2DomainResource("deployments/".concat(String(deploymentId), "/logs/")), 'GET');
-        };
-        _this.rollbackStorefrontV2 = function (payload) {
-            return _this.storefrontV2Request(_this.storefrontV2DomainResource('rollback/'), 'POST', payload);
-        };
         return _this;
     }
     Domain.resourceName = 'domains';
@@ -265,6 +214,18 @@ var Domain = /** @class */ (function (_super) {
         Domain.property({ type: String }),
         __metadata("design:type", String)
     ], Domain.prototype, "googleMerchantId", void 0);
+    __decorate([
+        Domain.property({ type: Boolean }),
+        __metadata("design:type", Boolean)
+    ], Domain.prototype, "googleProductReviewsFeedEnabled", void 0);
+    __decorate([
+        Domain.property({ type: String }),
+        __metadata("design:type", Object)
+    ], Domain.prototype, "googleProductReviewsFeedToken", void 0);
+    __decorate([
+        Domain.property({ type: String }),
+        __metadata("design:type", Object)
+    ], Domain.prototype, "googleProductReviewsFeedUrl", void 0);
     __decorate([
         Domain.property({ type: String }),
         __metadata("design:type", Object)

package/dist/entities/domain.test.js

@@ -66,129 +66,3 @@ test('fail to delete non-existant domain', function () {
     expect(fetch.mock.calls[0][1].method).toBe('DELETE');
     return invocation.catch(function (e) { return expect(e.statusCode).toEqual(404); });
 });
-test('can get storefront v2 config', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    domain.id = 42;
-    var fetch = mockFetch(true, {}, 200);
-    domain.getStorefrontV2();
-    var fetchUrl = fetch.mock.calls[0][0];
-    var query = fetch.mock.calls[0][1].query;
-    expect(fetch.mock.calls[0][1].method).toBe('GET');
-    expect(fetchUrl).toContain('/domains/42/storefront_v2/');
-    expect(query).toContainEqual(['skip_rights', 'y']);
-});
-test('can provision storefront v2', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    domain.id = 42;
-    var fetch = mockFetch(true, {}, 200);
-    domain.provisionStorefrontV2({ force: true });
-    var fetchUrl = fetch.mock.calls[0][0];
-    var body = JSON.parse(fetch.mock.calls[0][1].body);
-    expect(fetch.mock.calls[0][1].method).toBe('POST');
-    expect(fetchUrl).toContain('/domains/42/storefront_v2/provision/');
-    expect(body).toEqual({ force: true });
-});
-test('can create storefront v2 change request', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    domain.id = 42;
-    var fetch = mockFetch(true, {}, 200);
-    domain.createStorefrontChangeRequest({ prompt: 'update hero' });
-    var fetchUrl = fetch.mock.calls[0][0];
-    var body = JSON.parse(fetch.mock.calls[0][1].body);
-    expect(fetch.mock.calls[0][1].method).toBe('POST');
-    expect(fetchUrl).toContain('/domains/42/storefront_v2/requests/');
-    expect(body).toEqual({ prompt: 'update hero' });
-});
-test('can get storefront v2 change request by id', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    var fetch = mockFetch(true, {}, 200);
-    domain.getStorefrontChangeRequest(9);
-    var fetchUrl = fetch.mock.calls[0][0];
-    expect(fetch.mock.calls[0][1].method).toBe('GET');
-    expect(fetchUrl).toContain('/storefront_change_requests/9/');
-});
-test('can run storefront v2 change request', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    var fetch = mockFetch(true, {}, 200);
-    domain.runStorefrontChangeRequest(9, {
-        status: 'running',
-        pullRequestNumber: 42,
-        checksSummary: {
-            overall: 'passing',
-            counts: { total: 4, passed: 4, failed: 0, pending: 0, neutral: 0 },
-        },
-        checksUpdatedAt: '2026-05-15T00:00:00Z',
-    });
-    var fetchUrl = fetch.mock.calls[0][0];
-    var body = JSON.parse(fetch.mock.calls[0][1].body);
-    expect(fetch.mock.calls[0][1].method).toBe('POST');
-    expect(fetchUrl).toContain('/storefront_change_requests/9/run/');
-    expect(body).toEqual({
-        status: 'running',
-        pullRequestNumber: 42,
-        checksSummary: {
-            overall: 'passing',
-            counts: { total: 4, passed: 4, failed: 0, pending: 0, neutral: 0 },
-        },
-        checksUpdatedAt: '2026-05-15T00:00:00Z',
-    });
-});
-test('can approve storefront v2 change request', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    var fetch = mockFetch(true, {}, 200);
-    domain.approveStorefrontChangeRequest(9, { comment: 'looks good' });
-    var fetchUrl = fetch.mock.calls[0][0];
-    var body = JSON.parse(fetch.mock.calls[0][1].body);
-    expect(fetch.mock.calls[0][1].method).toBe('POST');
-    expect(fetchUrl).toContain('/storefront_change_requests/9/approve/');
-    expect(body).toEqual({ comment: 'looks good' });
-});
-test('can reject storefront v2 change request', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    var fetch = mockFetch(true, {}, 200);
-    domain.rejectStorefrontChangeRequest(9, { reason: 'needs edits' });
-    var fetchUrl = fetch.mock.calls[0][0];
-    var body = JSON.parse(fetch.mock.calls[0][1].body);
-    expect(fetch.mock.calls[0][1].method).toBe('POST');
-    expect(fetchUrl).toContain('/storefront_change_requests/9/reject/');
-    expect(body).toEqual({ reason: 'needs edits' });
-});
-test('can get storefront v2 deployments', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    domain.id = 42;
-    var fetch = mockFetch(true, {}, 200);
-    domain.getStorefrontV2Deployments();
-    var fetchUrl = fetch.mock.calls[0][0];
-    expect(fetch.mock.calls[0][1].method).toBe('GET');
-    expect(fetchUrl).toContain('/domains/42/storefront_v2/deployments/');
-});
-test('can get storefront v2 deployment logs', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    domain.id = 42;
-    var fetch = mockFetch(true, {}, 200);
-    domain.getStorefrontV2DeploymentLogs('dep_123');
-    var fetchUrl = fetch.mock.calls[0][0];
-    expect(fetch.mock.calls[0][1].method).toBe('GET');
-    expect(fetchUrl).toContain('/domains/42/storefront_v2/deployments/dep_123/logs/');
-});
-test('can rollback storefront v2 deployment', function () {
-    var merchi = new Merchi();
-    var domain = new merchi.Domain();
-    domain.id = 42;
-    var fetch = mockFetch(true, {}, 200);
-    domain.rollbackStorefrontV2({ deploymentId: 'dep_123' });
-    var fetchUrl = fetch.mock.calls[0][0];
-    var body = JSON.parse(fetch.mock.calls[0][1].body);
-    expect(fetch.mock.calls[0][1].method).toBe('POST');
-    expect(fetchUrl).toContain('/domains/42/storefront_v2/rollback/');
-    expect(body).toEqual({ deploymentId: 'dep_123' });
-});

package/dist/entities/notification.test.js

@@ -19,3 +19,33 @@ test('can list notifications with notificationSender filter', function () {
         expect(query).toContainEqual(['notification_sender', '123']);
     });
 });
+test('list forwards skipCount=true as skip_count query param', function () {
+    var merchi = new Merchi();
+    var fetch = mockFetch(true, {
+        'notifications': [],
+        // backend returns ``available: null`` when skip_count was honoured
+        'available': null,
+        'count': 0
+    }, 200);
+    var options = { skipCount: true };
+    return merchi.Notification.list(options).then(function (response) {
+        var query = fetch.mock.calls[0][1]['query'];
+        expect(query).toContainEqual(['skip_count', 'true']);
+        // ``available`` must round-trip as ``null``; the typed metadata
+        // is now ``number | null``, so consumers can detect the absence.
+        expect(response.metadata.available).toBeNull();
+    });
+});
+test('list omits skip_count when skipCount is not set', function () {
+    var merchi = new Merchi();
+    var fetch = mockFetch(true, {
+        'notifications': [],
+        'available': 0,
+        'count': 0
+    }, 200);
+    return merchi.Notification.list({}).then(function () {
+        var query = fetch.mock.calls[0][1]['query'];
+        var skipCountEntries = query.filter(function (entry) { return entry[0] === 'skip_count'; });
+        expect(skipCountEntries).toEqual([]);
+    });
+});

package/dist/entity.js

@@ -614,6 +614,14 @@ var Entity = /** @class */ (function () {
             if (options.limit !== undefined) {
                 fetchOptions.query.push(['limit', options.limit.toString()]);
             }
+            if (options.skipCount !== undefined) {
+                // Snake-case is the canonical form on the server; the API
+                // also accepts ``skipCount`` via its camelCase alias, but
+                // matching the wire shape of the other ``*_only`` /
+                // ``*_filter`` flags keeps logs and traffic captures
+                // consistent.
+                fetchOptions.query.push(['skip_count', options.skipCount.toString()]);
+            }
             if (options.q !== undefined) {
                 fetchOptions.query.push(['q', options.q]);
             }

package/dist/index.js

@@ -51,6 +51,7 @@ import { Payment } from './entities/payment.js';
 import { PaymentDevice } from './entities/payment_device.js';
 import { PhoneNumber } from './entities/phone_number.js';
 import { Product } from './entities/product.js';
+import { ProductReview } from './entities/product_review.js';
 import { ProductionComment } from './entities/production_comment.js';
 import { Quote } from './entities/quote.js';
 import { QuoteItem } from './entities/quote_item.js';
@@ -82,4 +83,4 @@ import * as constants from './constants/index.js';
 import * as request from './request.js';
 import * as util from './util/index.js';
 import { toastNotifications } from './toasts.js';
-export { constants, request, util, toastNotifications, Address, AgentConversation, AgentSkill, AgentSkillVersion, AgentSkillApproval, DomainChatSettings, SupportConversation, SupportMessage, Assignment, AutomaticPaymentRelationship, Bank, Cart, CartItem, CartShipmentGroup, CartShipmentQuote, Category, Company, CompanyInvitation, Component, ComponentTag, ComponentVersion, CountryTax, Discount, DiscountGroup, Domain, DomainInvitation, DomainTag, Draft, DraftComment, DraftTemplate, EmailAddress, EmailCounter, EnrolledDomain, Entity, ExchangeRate, InternalTag, Inventory, InventoryUnitVariation, Invoice, Item, Job, JobComment, MatchingInventory, Menu, MenuItem, Merchi, MerchiFile, Notification, Page, Payment, PaymentDevice, PhoneNumber, Product, ProductionComment, Quote, QuoteItem, Reminder, apiFetch, apiFetchWithProgress, Session, Shipment, ShipmentLog, ShipmentItem, ShipmentItemFulfillment, ShipmentMethod, ShipmentMethodVariation, ShortUrl, SubscriptionPlan, SupplyDomain, SystemRole, Theme, ThemeCssSetting, User, UserCompany, Variation, VariationField, VariationFieldsOption, VariationOption, VariationsGroup, generateUUID, getCookie };
+export { constants, request, util, toastNotifications, Address, AgentConversation, AgentSkill, AgentSkillVersion, AgentSkillApproval, DomainChatSettings, SupportConversation, SupportMessage, Assignment, AutomaticPaymentRelationship, Bank, Cart, CartItem, CartShipmentGroup, CartShipmentQuote, Category, Company, CompanyInvitation, Component, ComponentTag, ComponentVersion, CountryTax, Discount, DiscountGroup, Domain, DomainInvitation, DomainTag, Draft, DraftComment, DraftTemplate, EmailAddress, EmailCounter, EnrolledDomain, Entity, ExchangeRate, InternalTag, Inventory, InventoryUnitVariation, Invoice, Item, Job, JobComment, MatchingInventory, Menu, MenuItem, Merchi, MerchiFile, Notification, Page, Payment, PaymentDevice, PhoneNumber, Product, ProductReview, ProductionComment, Quote, QuoteItem, Reminder, apiFetch, apiFetchWithProgress, Session, Shipment, ShipmentLog, ShipmentItem, ShipmentItemFulfillment, ShipmentMethod, ShipmentMethodVariation, ShortUrl, SubscriptionPlan, SupplyDomain, SystemRole, Theme, ThemeCssSetting, User, UserCompany, Variation, VariationField, VariationFieldsOption, VariationOption, VariationsGroup, generateUUID, getCookie };

package/dist/merchi.js

@@ -20,6 +20,7 @@ import { VariationField } from './entities/variation_field.js';
 import { VariationOption } from './entities/variation_option.js';
 import { ProductionComment } from './entities/production_comment.js';
 import { Product } from './entities/product.js';
+import { ProductReview } from './entities/product_review.js';
 import { InternalTag } from './entities/internal_tag.js';
 import { Inventory } from './entities/inventory.js';
 import { InventoryGroup } from './entities/inventory_group.js';
@@ -254,6 +255,7 @@ var Merchi = /** @class */ (function () {
         this.CountryTax = this.setupClass(CountryTax);
         this.ShortUrl = this.setupClass(ShortUrl);
         this.Product = this.setupClass(Product);
+        this.ProductReview = this.setupClass(ProductReview);
         this.SystemRole = this.setupClass(SystemRole);
         this.CartItem = this.setupClass(CartItem);
         this.UserCompany = this.setupClass(UserCompany);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "merchi_sdk_ts",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "main": "dist/index.js",
   "type": "module",
   "repository": "git@github.com:merchisdk/merchi_sdk_ts.git",

package/src/entities/domain.test.ts

@@ -77,139 +77,3 @@ test('fail to delete non-existant domain', () => {
   expect(fetch.mock.calls[0][1].method).toBe('DELETE');
   return invocation.catch(e => expect(e.statusCode).toEqual(404));
 });
-
-test('can get storefront v2 config', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  domain.id = 42;
-  const fetch = mockFetch(true, {}, 200);
-  domain.getStorefrontV2();
-  const fetchUrl = fetch.mock.calls[0][0];
-  const query = fetch.mock.calls[0][1].query;
-  expect(fetch.mock.calls[0][1].method).toBe('GET');
-  expect(fetchUrl).toContain('/domains/42/storefront_v2/');
-  expect(query).toContainEqual(['skip_rights', 'y']);
-});
-
-test('can provision storefront v2', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  domain.id = 42;
-  const fetch = mockFetch(true, {}, 200);
-  domain.provisionStorefrontV2({force: true});
-  const fetchUrl = fetch.mock.calls[0][0];
-  const body = JSON.parse(fetch.mock.calls[0][1].body as string);
-  expect(fetch.mock.calls[0][1].method).toBe('POST');
-  expect(fetchUrl).toContain('/domains/42/storefront_v2/provision/');
-  expect(body).toEqual({force: true});
-});
-
-test('can create storefront v2 change request', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  domain.id = 42;
-  const fetch = mockFetch(true, {}, 200);
-  domain.createStorefrontChangeRequest({prompt: 'update hero'});
-  const fetchUrl = fetch.mock.calls[0][0];
-  const body = JSON.parse(fetch.mock.calls[0][1].body as string);
-  expect(fetch.mock.calls[0][1].method).toBe('POST');
-  expect(fetchUrl).toContain('/domains/42/storefront_v2/requests/');
-  expect(body).toEqual({prompt: 'update hero'});
-});
-
-test('can get storefront v2 change request by id', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  const fetch = mockFetch(true, {}, 200);
-  domain.getStorefrontChangeRequest(9);
-  const fetchUrl = fetch.mock.calls[0][0];
-  expect(fetch.mock.calls[0][1].method).toBe('GET');
-  expect(fetchUrl).toContain('/storefront_change_requests/9/');
-});
-
-test('can run storefront v2 change request', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  const fetch = mockFetch(true, {}, 200);
-  domain.runStorefrontChangeRequest(9, {
-    status: 'running',
-    pullRequestNumber: 42,
-    checksSummary: {
-      overall: 'passing',
-      counts: {total: 4, passed: 4, failed: 0, pending: 0, neutral: 0},
-    },
-    checksUpdatedAt: '2026-05-15T00:00:00Z',
-  });
-  const fetchUrl = fetch.mock.calls[0][0];
-  const body = JSON.parse(fetch.mock.calls[0][1].body as string);
-  expect(fetch.mock.calls[0][1].method).toBe('POST');
-  expect(fetchUrl).toContain('/storefront_change_requests/9/run/');
-  expect(body).toEqual({
-    status: 'running',
-    pullRequestNumber: 42,
-    checksSummary: {
-      overall: 'passing',
-      counts: {total: 4, passed: 4, failed: 0, pending: 0, neutral: 0},
-    },
-    checksUpdatedAt: '2026-05-15T00:00:00Z',
-  });
-});
-
-test('can approve storefront v2 change request', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  const fetch = mockFetch(true, {}, 200);
-  domain.approveStorefrontChangeRequest(9, {comment: 'looks good'});
-  const fetchUrl = fetch.mock.calls[0][0];
-  const body = JSON.parse(fetch.mock.calls[0][1].body as string);
-  expect(fetch.mock.calls[0][1].method).toBe('POST');
-  expect(fetchUrl).toContain('/storefront_change_requests/9/approve/');
-  expect(body).toEqual({comment: 'looks good'});
-});
-
-test('can reject storefront v2 change request', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  const fetch = mockFetch(true, {}, 200);
-  domain.rejectStorefrontChangeRequest(9, {reason: 'needs edits'});
-  const fetchUrl = fetch.mock.calls[0][0];
-  const body = JSON.parse(fetch.mock.calls[0][1].body as string);
-  expect(fetch.mock.calls[0][1].method).toBe('POST');
-  expect(fetchUrl).toContain('/storefront_change_requests/9/reject/');
-  expect(body).toEqual({reason: 'needs edits'});
-});
-
-test('can get storefront v2 deployments', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  domain.id = 42;
-  const fetch = mockFetch(true, {}, 200);
-  domain.getStorefrontV2Deployments();
-  const fetchUrl = fetch.mock.calls[0][0];
-  expect(fetch.mock.calls[0][1].method).toBe('GET');
-  expect(fetchUrl).toContain('/domains/42/storefront_v2/deployments/');
-});
-
-test('can get storefront v2 deployment logs', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  domain.id = 42;
-  const fetch = mockFetch(true, {}, 200);
-  domain.getStorefrontV2DeploymentLogs('dep_123');
-  const fetchUrl = fetch.mock.calls[0][0];
-  expect(fetch.mock.calls[0][1].method).toBe('GET');
-  expect(fetchUrl).toContain('/domains/42/storefront_v2/deployments/dep_123/logs/');
-});
-
-test('can rollback storefront v2 deployment', () => {
-  const merchi = new Merchi();
-  const domain = new merchi.Domain();
-  domain.id = 42;
-  const fetch = mockFetch(true, {}, 200);
-  domain.rollbackStorefrontV2({deploymentId: 'dep_123'});
-  const fetchUrl = fetch.mock.calls[0][0];
-  const body = JSON.parse(fetch.mock.calls[0][1].body as string);
-  expect(fetch.mock.calls[0][1].method).toBe('POST');
-  expect(fetchUrl).toContain('/domains/42/storefront_v2/rollback/');
-  expect(body).toEqual({deploymentId: 'dep_123'});
-});

package/src/entities/domain.ts

@@ -21,43 +21,6 @@ import { DomainChatSettings } from './domain_chat_settings.js';
 import { Theme } from './theme.js';
 import { DomainType } from '../constants/domain_types.js';
 import { ShipmentMethod } from './shipment_method.js';
-import { RequestOptions } from '../request.js';
-
-export type StorefrontChangeRequestStatus =
-  | 'created'
-  | 'running'
-  | 'preview_ready'
-  | 'approved'
-  | 'rejected';
-
-export interface StorefrontChecksSummary {
-  overall?: 'passing' | 'failing' | 'pending' | 'unknown';
-  statusState?: string;
-  counts?: {
-    total?: number;
-    passed?: number;
-    failed?: number;
-    pending?: number;
-    neutral?: number;
-  };
-  updatedAt?: string;
-}
-
-export interface StorefrontV2ChangeRequest {
-  id: number;
-  domainId: number;
-  storefrontV2Id: number;
-  status: StorefrontChangeRequestStatus;
-  prompt: string;
-  branchName?: string | null;
-  commitSha?: string | null;
-  pullRequestNumber?: number | null;
-  previewUrl?: string | null;
-  summary?: string | null;
-  checksSummary?: StorefrontChecksSummary | null;
-  checksUpdatedAt?: string | null;
-  errorDetails?: string | null;
-}
 
 export class Domain extends Entity {
   protected static resourceName = 'domains';
@@ -184,6 +147,15 @@ export class Domain extends Entity {
   @Domain.property({type: String})
   public googleMerchantId?: string;
 
+  @Domain.property({type: Boolean})
+  public googleProductReviewsFeedEnabled?: boolean;
+
+  @Domain.property({type: String})
+  public googleProductReviewsFeedToken?: string | null;
+
+  @Domain.property({type: String})
+  public googleProductReviewsFeedUrl?: string | null;
+
   @Domain.property({type: String})
   public socialBitchute?: string | null;
 
@@ -319,117 +291,4 @@ export class Domain extends Entity {
     }
     return this.activeTheme!;
   };
-
-  private getDomainId = () => {
-    if (this.id === undefined || this.id === null) {
-      throw new Error('id is undefined, did you forget to set it?');
-    }
-    return this.id;
-  };
-
-  private storefrontV2DomainResource = (suffix = '') => {
-    return `/domains/${this.getDomainId()}/storefront_v2/${suffix}`;
-  };
-
-  private storefrontV2Request = (
-    resource: string,
-    method: 'GET' | 'POST',
-    payload?: Record<string, any>
-  ) => {
-    const fetchOptions: RequestOptions = {
-      method: method,
-      query: [['skip_rights', 'y']]
-    };
-    if (payload !== undefined) {
-      fetchOptions.body = JSON.stringify(payload);
-      fetchOptions.headers = {'Content-Type': 'application/json'};
-    }
-    return this.merchi.authenticatedFetch(resource, fetchOptions);
-  };
-
-  public getStorefrontV2 = () => {
-    return this.storefrontV2Request(this.storefrontV2DomainResource(), 'GET');
-  };
-
-  public provisionStorefrontV2 = (payload?: Record<string, any>) => {
-    return this.storefrontV2Request(
-      this.storefrontV2DomainResource('provision/'),
-      'POST',
-      payload
-    );
-  };
-
-  public createStorefrontChangeRequest = (
-    payload?: Record<string, any>
-  ): Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}> => {
-    return this.storefrontV2Request(
-      this.storefrontV2DomainResource('requests/'),
-      'POST',
-      payload
-    ) as Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}>;
-  };
-
-  public getStorefrontChangeRequest = (
-    requestId: number | string
-  ): Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}> => {
-    return this.storefrontV2Request(
-      `/storefront_change_requests/${String(requestId)}/`,
-      'GET'
-    ) as Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}>;
-  };
-
-  public runStorefrontChangeRequest = (
-    requestId: number | string,
-    payload?: Record<string, any>
-  ): Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}> => {
-    return this.storefrontV2Request(
-      `/storefront_change_requests/${String(requestId)}/run/`,
-      'POST',
-      payload
-    ) as Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}>;
-  };
-
-  public approveStorefrontChangeRequest = (
-    requestId: number | string,
-    payload?: Record<string, any>
-  ): Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}> => {
-    return this.storefrontV2Request(
-      `/storefront_change_requests/${String(requestId)}/approve/`,
-      'POST',
-      payload
-    ) as Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}>;
-  };
-
-  public rejectStorefrontChangeRequest = (
-    requestId: number | string,
-    payload?: Record<string, any>
-  ): Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}> => {
-    return this.storefrontV2Request(
-      `/storefront_change_requests/${String(requestId)}/reject/`,
-      'POST',
-      payload
-    ) as Promise<{storefrontChangeRequest: StorefrontV2ChangeRequest}>;
-  };
-
-  public getStorefrontV2Deployments = () => {
-    return this.storefrontV2Request(
-      this.storefrontV2DomainResource('deployments/'),
-      'GET'
-    );
-  };
-
-  public getStorefrontV2DeploymentLogs = (deploymentId: number | string) => {
-    return this.storefrontV2Request(
-      this.storefrontV2DomainResource(`deployments/${String(deploymentId)}/logs/`),
-      'GET'
-    );
-  };
-
-  public rollbackStorefrontV2 = (payload?: Record<string, any>) => {
-    return this.storefrontV2Request(
-      this.storefrontV2DomainResource('rollback/'),
-      'POST',
-      payload
-    );
-  };
 }

package/src/entities/notification.test.ts

@@ -22,3 +22,37 @@ test('can list notifications with notificationSender filter', () => {
     expect(query).toContainEqual(['notification_sender', '123']);
   });
 });
+
+test('list forwards skipCount=true as skip_count query param', () => {
+  const merchi = new Merchi();
+  const fetch = mockFetch(true, {
+    'notifications': [],
+    // backend returns ``available: null`` when skip_count was honoured
+    'available': null,
+    'count': 0
+  }, 200);
+  const options = { skipCount: true };
+  return merchi.Notification.list(options).then((response) => {
+    const query = fetch.mock.calls[0][1]['query'];
+    expect(query).toContainEqual(['skip_count', 'true']);
+    // ``available`` must round-trip as ``null``; the typed metadata
+    // is now ``number | null``, so consumers can detect the absence.
+    expect(response.metadata.available).toBeNull();
+  });
+});
+
+test('list omits skip_count when skipCount is not set', () => {
+  const merchi = new Merchi();
+  const fetch = mockFetch(true, {
+    'notifications': [],
+    'available': 0,
+    'count': 0
+  }, 200);
+  return merchi.Notification.list({}).then(() => {
+    const query = fetch.mock.calls[0][1]['query'];
+    const skipCountEntries = query.filter(
+      (entry: [string, string]) => entry[0] === 'skip_count'
+    );
+    expect(skipCountEntries).toEqual([]);
+  });
+});

package/src/entities/product_review.ts

@@ -0,0 +1,221 @@
+import { Entity } from '../entity.js';
+import type { RequestOptions } from '../request.js';
+import type { Domain } from './domain.js';
+import type { Job } from './job.js';
+import type { Product } from './product.js';
+
+/** Create payload; the API expects ``jobId`` — pass ``job`` with at least ``id``. */
+export interface ProductReviewCreateInput {
+  job: { id: number };
+  rating: number;
+  title?: string | null;
+  content?: string | null;
+}
+
+export interface ProductReviewPatchInput {
+  status?: string;
+  rejectionReason?: string | null;
+  rating?: number;
+  title?: string | null;
+  content?: string | null;
+}
+
+/**
+ * Post-purchase product review. List/create are nested under ``/products/:id/reviews/``;
+ * updates use ``/product-reviews/:id/``. Do not use :meth:`Entity.create` / :meth:`Entity.list`
+ * for this resource.
+ *
+ * API responses use ``jobId``, ``productId``, and ``domainId``; this entity maps those onto
+ * ``job``, ``product``, and ``domain`` (minimal ``{ id }`` objects unless the API nests more).
+ */
+export class ProductReview extends Entity {
+  protected static resourceName = 'product-reviews';
+  protected static singularName = 'productReview';
+  protected static pluralName = 'productReviews';
+
+  @ProductReview.property()
+  public id?: number;
+
+  @ProductReview.property({ type: 'Product' })
+  public product?: Product;
+
+  @ProductReview.property({ type: 'Domain' })
+  public domain?: Domain;
+
+  @ProductReview.property({ type: Number })
+  public authorUserId?: number;
+
+  @ProductReview.property({ type: String })
+  public authorName?: string | null;
+
+  @ProductReview.property({ type: 'Job' })
+  public job?: Job;
+
+  @ProductReview.property({ type: Number })
+  public rating?: number;
+
+  @ProductReview.property({ type: String })
+  public title?: string | null;
+
+  @ProductReview.property({ type: String })
+  public content?: string | null;
+
+  @ProductReview.property({ type: String })
+  public status?: string;
+
+  @ProductReview.property({ type: Number })
+  public purchaseInvoiceId?: number | null;
+
+  /** ISO 8601 string from the API. */
+  @ProductReview.property({ type: String })
+  public submittedAt?: string | null;
+
+  /** ISO 8601 string from the API. */
+  @ProductReview.property({ type: String })
+  public updatedAt?: string | null;
+
+  @ProductReview.property({ type: String })
+  public rejectionReason?: string | null;
+
+  /**
+   * Map flat API fields (``jobId``, ``productId``, ``domainId``) to nested
+   * ``job`` / ``product`` / ``domain`` objects before :meth:`Entity.fromJson`.
+   */
+  public static normalizeApiJson(json: any): any {
+    if (json === null || json === undefined || typeof json !== 'object') {
+      return json;
+    }
+    const row: any = { ...json };
+    if (row.jobId !== undefined && row.job === undefined) {
+      if (row.jobId != null) {
+        row.job = { id: row.jobId };
+      }
+      delete row.jobId;
+    }
+    if (row.productId !== undefined && row.product === undefined) {
+      if (row.productId != null) {
+        row.product = { id: row.productId };
+      }
+      delete row.productId;
+    }
+    if (row.domainId !== undefined && row.domain === undefined) {
+      if (row.domainId != null) {
+        row.domain = { id: row.domainId };
+      }
+      delete row.domainId;
+    }
+    return row;
+  }
+
+  /**
+   * Domain managers/admins: list reviews for a product.
+   */
+  public static listForProduct(
+    this: typeof ProductReview,
+    productId: number,
+    options?: { withRights?: boolean }
+  ): Promise<ProductReview[]> {
+    const Constructor = this;
+    const resource = `/products/${productId}/reviews/`;
+    const fetchOptions: RequestOptions = { method: 'GET' };
+    fetchOptions.query = [];
+    if (!(options && options.withRights)) {
+      fetchOptions.query.push(['skip_rights', 'y']);
+    }
+    return Constructor.merchi.authenticatedFetch(resource, fetchOptions).then(
+      (data: any) => {
+        const raw = data.productReviews ?? [];
+        return raw.map((row: any) => {
+          const e: ProductReview = new Constructor() as ProductReview;
+          e.fromJson(ProductReview.normalizeApiJson(row));
+          return e;
+        });
+      }
+    );
+  }
+
+  /**
+   * Buyer: create a review for the catalog ``productId`` (master product).
+   * ``body.job.id`` must be a completed job whose line item resolves to this product.
+   */
+  public static createForProduct(
+    this: typeof ProductReview,
+    productId: number,
+    body: ProductReviewCreateInput,
+    options?: { withRights?: boolean }
+  ): Promise<ProductReview> {
+    const Constructor = this;
+    const resource = `/products/${productId}/reviews/`;
+    const wire: Record<string, unknown> = {
+      jobId: body.job.id,
+      rating: body.rating,
+    };
+    if (body.title !== undefined) {
+      wire.title = body.title;
+    }
+    if (body.content !== undefined) {
+      wire.content = body.content;
+    }
+    const fetchOptions: RequestOptions = {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(wire),
+    };
+    fetchOptions.query = [];
+    if (!(options && options.withRights)) {
+      fetchOptions.query.push(['skip_rights', 'y']);
+    }
+    return Constructor.merchi.authenticatedFetch(resource, fetchOptions).then(
+      (data: any) => {
+        const e: ProductReview = new Constructor() as ProductReview;
+        e.fromJson(ProductReview.normalizeApiJson(data.productReview));
+        return e;
+      }
+    );
+  }
+
+  /**
+   * Partial update (moderation or author edit). Uses ``multipart/form-data`` fields
+   * matching the Merchi API.
+   */
+  public patch(
+    payload: ProductReviewPatchInput,
+    options?: { withRights?: boolean }
+  ): Promise<this> {
+    const id = this.id;
+    if (id === undefined) {
+      throw new Error('ProductReview.id is required to patch');
+    }
+    const resource = `/product-reviews/${String(id)}/`;
+    const form = new FormData();
+    if (payload.status !== undefined) {
+      form.set('status', payload.status);
+    }
+    if (payload.rejectionReason !== undefined) {
+      form.set('rejectionReason', payload.rejectionReason ?? '');
+    }
+    if (payload.rating !== undefined) {
+      form.set('rating', String(payload.rating));
+    }
+    if (payload.title !== undefined) {
+      form.set('title', payload.title ?? '');
+    }
+    if (payload.content !== undefined) {
+      form.set('content', payload.content ?? '');
+    }
+    const fetchOptions: RequestOptions = { method: 'PATCH', body: form };
+    fetchOptions.query = [];
+    if (!(options && options.withRights)) {
+      fetchOptions.query.push(['skip_rights', 'y']);
+    }
+    const singularName = (this.constructor as typeof ProductReview)
+      .singularName;
+    return this.merchi.authenticatedFetch(resource, fetchOptions).then(
+      (data: any) => {
+        this.fromJson(ProductReview.normalizeApiJson(data[singularName]));
+        this.cleanDirty();
+        return this;
+      }
+    );
+  }
+}

package/src/entity.ts

@@ -159,11 +159,22 @@ interface ListOptions {
   teamOnly?: boolean;
   turnaroundTimeDays?: number;
   withRights?: boolean;
+  // Opt out of the unbounded ``SELECT count(*)`` the API runs to
+  // populate ``available``. When ``skipCount`` is true the response's
+  // ``available`` is ``null``. Use this whenever the caller only
+  // renders the visible page of rows (search modals, autocomplete,
+  // navbar dropdowns, infinite scroll, ...) and never reads
+  // ``metadata.available``. Paginated tables that show "Showing X
+  // of Y" or compute a page count must NOT set this.
+  skipCount?: boolean;
 }
 
 export interface ListMetadata {
   canCreate?: boolean;
-  available: number;
+  // ``null`` when the caller passed ``skipCount: true``: the API
+  // intentionally skipped the ``COUNT(*)`` query. JSON consumers
+  // can detect the absence rather than mistaking it for zero.
+  available: number | null;
   count: number;
   limit: number;
   offset: number;
@@ -417,6 +428,16 @@ export class Entity {
       if (options.limit !== undefined) {
         fetchOptions.query.push(['limit', options.limit.toString()]);
       }
+      if (options.skipCount !== undefined) {
+        // Snake-case is the canonical form on the server; the API
+        // also accepts ``skipCount`` via its camelCase alias, but
+        // matching the wire shape of the other ``*_only`` /
+        // ``*_filter`` flags keeps logs and traffic captures
+        // consistent.
+        fetchOptions.query.push(
+          ['skip_count', options.skipCount.toString()]
+        );
+      }
       if (options.q !== undefined) {
         fetchOptions.query.push(['q', options.q]);
       }

package/src/index.ts

@@ -51,6 +51,11 @@ import { Payment } from './entities/payment.js';
 import { PaymentDevice } from './entities/payment_device.js';
 import { PhoneNumber } from './entities/phone_number.js';
 import { Product } from './entities/product.js';
+import { ProductReview } from './entities/product_review.js';
+export type {
+  ProductReviewCreateInput,
+  ProductReviewPatchInput,
+} from './entities/product_review.js';
 import { ProductionComment } from './entities/production_comment.js';
 import { Quote } from './entities/quote.js';
 import { QuoteItem } from './entities/quote_item.js';
@@ -142,6 +147,7 @@ export {
   PaymentDevice,
   PhoneNumber,
   Product,
+  ProductReview,
   ProductionComment,
   Quote,
   QuoteItem,

package/src/merchi.ts

@@ -14,6 +14,7 @@ import { VariationField } from './entities/variation_field.js';
 import { VariationOption } from './entities/variation_option.js';
 import { ProductionComment } from './entities/production_comment.js';
 import { Product } from './entities/product.js';
+import { ProductReview } from './entities/product_review.js';
 import { InternalTag } from './entities/internal_tag.js';
 import { Inventory } from './entities/inventory.js';
 import { InventoryGroup } from './entities/inventory_group.js';
@@ -155,6 +156,7 @@ export class Merchi {
   public Job: typeof Job;
   public DomainInvitation: typeof DomainInvitation;
   public Product: typeof Product;
+  public ProductReview: typeof ProductReview;
   public DomainTag: typeof DomainTag;
   public EmailAddress: typeof EmailAddress;
   public PhoneNumber: typeof PhoneNumber;
@@ -330,6 +332,9 @@ export class Merchi {
     this.CountryTax = this.setupClass(CountryTax) as typeof CountryTax;
     this.ShortUrl = this.setupClass(ShortUrl) as typeof ShortUrl;
     this.Product = this.setupClass(Product) as typeof Product;
+    this.ProductReview = this.setupClass(
+      ProductReview
+    ) as typeof ProductReview;
     this.SystemRole = this.setupClass(SystemRole) as typeof SystemRole;
     this.CartItem = this.setupClass(CartItem) as typeof CartItem;
     this.UserCompany = this.setupClass(UserCompany) as typeof UserCompany;