@shopkit/data-layer 1.4.3 → 1.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3810,7 +3810,31 @@ var ProductService2 = class extends BaseCustomService {
3810
3810
  PRODUCT_ENDPOINTS.getProducts(options?.version),
3811
3811
  "POST",
3812
3812
  requestParams,
3813
- options
3813
+ {
3814
+ ...options || {},
3815
+ // A list read cannot know which products come back before it runs, so it
3816
+ // takes the broad `products` tag — the one place a broad tag is the correct
3817
+ // answer rather than a blunt one. Per-product reads deliberately omit it
3818
+ // (see getProduct), which is what keeps `revalidateTag("products")` from
3819
+ // becoming a catalog-wide PDP purge: it lands only on the surfaces that
3820
+ // actually render a list — sitemaps, search endpoints, PLP rails.
3821
+ //
3822
+ // This is the producer that tag had been missing. Merchant inventory routes
3823
+ // have been calling `revalidateTag("products")` all along, against nothing:
3824
+ // no read attached it, so those deliveries returned 200 having invalidated
3825
+ // nothing. Same failure the removed `search.reindex` event had, mirrored to
3826
+ // the producer side.
3827
+ //
3828
+ // No `search` tag on a query-bearing read: it would be attached only
3829
+ // alongside `products` and purged only alongside `products`, so it could
3830
+ // never invalidate anything `products` did not already reach. See the note
3831
+ // on CACHE_INVALIDATION_TYPES in @shopkit/webhooks — a tag with no
3832
+ // independent effect is the same dead weight as one with no producer.
3833
+ next: {
3834
+ ...options?.next || {},
3835
+ tags: [CacheTags.products(), ...options?.next?.tags || []]
3836
+ }
3837
+ }
3814
3838
  );
3815
3839
  if (!result || !result.products) {
3816
3840
  return formatResponse({
@@ -4193,7 +4217,40 @@ var ProductService2 = class extends BaseCustomService {
4193
4217
  PRODUCT_ENDPOINTS.getCollectionsByHandles(options?.version),
4194
4218
  "POST",
4195
4219
  payload,
4196
- options
4220
+ {
4221
+ ...options || {},
4222
+ // The same tags the single-collection `getCollection` attaches, one set
4223
+ // per requested handle. This is the batch form of that read, so it has to
4224
+ // carry the same invalidation coverage: without it, moving a template from
4225
+ // COLLECTION to COLLECTION_BY_HANDLES silently opts the page out of
4226
+ // webhook invalidation, and it stays stale until its own `revalidate`
4227
+ // window elapses.
4228
+ //
4229
+ // Not hypothetical: home pages render their product grids through this
4230
+ // read, so `revalidateTag(collection:<handle>)` from a product.updated
4231
+ // webhook — which did purge that product's PDP and its collection page —
4232
+ // matched nothing on the home page, and an edited title sat there for the
4233
+ // rest of the ISR window.
4234
+ //
4235
+ // Same rationale and the same deliberate omission of `revalidate` as
4236
+ // getProductsByHandles above. Tagging a POST works: Next records a fetch's
4237
+ // tags on the enclosing page's cache entry before it decides whether the
4238
+ // response itself is cacheable.
4239
+ //
4240
+ // The type guard mirrors getProductsByHandles — CacheTags.collection()
4241
+ // calls .trim() on its argument and this array is widget-supplied, so a
4242
+ // stray null would throw and fail the whole read, not just one tag.
4243
+ next: {
4244
+ ...options?.next || {},
4245
+ tags: [
4246
+ CacheTags.collections(),
4247
+ ...handles.filter(
4248
+ (h) => typeof h === "string" && h.trim() !== ""
4249
+ ).map((h) => CacheTags.collection(h)),
4250
+ ...options?.next?.tags || []
4251
+ ]
4252
+ }
4253
+ }
4197
4254
  );
4198
4255
  if (!result || !result.collections) {
4199
4256
  return formatResponse({
@@ -4251,7 +4308,24 @@ var ProductService2 = class extends BaseCustomService {
4251
4308
  PRODUCT_ENDPOINTS.getCollectionFilters(options?.version, handle),
4252
4309
  "GET",
4253
4310
  void 0,
4254
- options
4311
+ {
4312
+ ...options || {},
4313
+ // Facets are derived from this collection's products — price range, brands,
4314
+ // availability — so anything that invalidates the collection invalidates its
4315
+ // filters. One tag, keyed on the same handle, means the existing
4316
+ // product.updated / collection.updated purges already cover them.
4317
+ //
4318
+ // No broad `collections` tag here, unlike getCollection: a filter set belongs
4319
+ // to exactly one collection, and bulk collection events already purge every
4320
+ // affected handle individually.
4321
+ next: {
4322
+ ...options?.next || {},
4323
+ tags: [
4324
+ CacheTags.collection(handle),
4325
+ ...options?.next?.tags || []
4326
+ ]
4327
+ }
4328
+ }
4255
4329
  );
4256
4330
  if (!result) {
4257
4331
  return formatResponse({