@rebuy/rebuy 2.32.0 → 2.33.0-rc.1

package/dist/gwp/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var gwp_exports = {};
 __export(gwp_exports, {
   getValidGwpProductIds: () => getValidGwpProductIds,
+  hasLostDiscount: () => hasLostDiscount,
   hasUnsupportedRuleTypes: () => hasUnsupportedRuleTypes,
   isDefinitiveRuleAnswer: () => isDefinitiveRuleAnswer,
   shouldRemoveGift: () => shouldRemoveGift
@@ -43,5 +44,6 @@ var hasUnsupportedRuleTypes = (metadata) => [...metadata?.matchedRules ?? [], ..
 var isDefinitiveRuleAnswer = (metadata) => metadata != null && (metadata.matchedRules != null || metadata.unmatchedRules != null);
 
 // src/gwp/shouldRemoveGift.ts
-var shouldRemoveGift = (gift, validIds) => !validIds.has(gift.productId) || !gift.discounted && gift.cost > 0;
+var hasLostDiscount = (gift) => !gift.discounted && gift.cost > 0;
+var shouldRemoveGift = (gift, validIds) => !validIds.has(gift.productId) || hasLostDiscount(gift);
 //# sourceMappingURL=index.js.map

package/dist/gwp/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/gwp/index.ts", "../../src/gwp/getValidGwpProductIds.ts", "../../src/gwp/hasUnsupportedRuleTypes.ts", "../../src/gwp/isDefinitiveRuleAnswer.ts", "../../src/gwp/shouldRemoveGift.ts"],
-  "sourcesContent": ["export * from '~/gwp/getValidGwpProductIds';\nexport * from '~/gwp/hasUnsupportedRuleTypes';\nexport * from '~/gwp/isDefinitiveRuleAnswer';\nexport * from '~/gwp/shouldRemoveGift';\nexport * from '~/gwp/types';\n", "import { type MatchedRule } from '~/gwp/types';\n\n/**\n * The product ids a widget's matched rules currently qualify \u2014 ported from the React\n * extension's `getValidGwpProductIds` (camelCased engine shape). A gift whose product is\n * not in this set no longer qualifies and should be removed.\n */\nexport const getValidGwpProductIds = (matchedRules: MatchedRule[] = []): Set<number> =>\n    new Set(\n        matchedRules\n            .flatMap((rule) => rule.output ?? [])\n            .flatMap((output) => output.products ?? [])\n            .map((product) => Number(product.productId))\n            .filter((id) => Number.isFinite(id))\n    );\n", "import { type GwpMetadata, type MatchedRule } from '~/gwp/types';\n\n/**\n * Rule types the engine can't evaluate correctly in the cart/data-source context (no page URL,\n * no order) \u2014 ported from the React extension. When a widget's rules use these, the matched output\n * is unreliable, so the validator must NOT remove the gift.\n */\nconst UNSUPPORTED_RULE_TYPES = ['url', 'order_tag'];\n\nconst ruleHasUnsupportedType = (rule: MatchedRule): boolean =>\n    (rule.logic ?? []).some((group) =>\n        (group.rules ?? []).some((item) => UNSUPPORTED_RULE_TYPES.includes(item.type ?? ''))\n    );\n\n/**\n * Whether any matched OR unmatched rule uses an unsupported type \u2014 the bail signal: the gift's\n * qualification can't be trusted, so keep it (never remove on uncertainty).\n */\nexport const hasUnsupportedRuleTypes = (metadata?: GwpMetadata | null): boolean =>\n    [...(metadata?.matchedRules ?? []), ...(metadata?.unmatchedRules ?? [])].some(ruleHasUnsupportedType);\n", "import { type GwpMetadata } from '~/gwp/types';\n\n/**\n * Whether the engine metadata is a definitive rule answer the validator may act on. Removal is only\n * safe downstream of a parsed 2xx that actually evaluated rules (onsite-js standard: every degraded\n * path is a no-op): metadata missing entirely \u2014 the tolerated-empty-2xx path \u2014 or carrying NEITHER\n * `matchedRules` NOR `unmatchedRules` is uncertainty, so keep the gifts. `matchedRules: []` alongside\n * `unmatchedRules` IS definitive \u2014 the engine answered and nothing qualifies.\n */\nexport const isDefinitiveRuleAnswer = (metadata?: GwpMetadata | null): metadata is GwpMetadata =>\n    metadata != null && (metadata.matchedRules != null || metadata.unmatchedRules != null);\n", "import { type GwpGift } from '~/gwp/types';\n\n/**\n * Whether a gift line should be removed: either its product no longer qualifies (\u2209 `validIds`),\n * OR it lost its Shopify Function discount (`!discounted && cost > 0`). The Function can't remove\n * a line it failed to discount, so the client must \u2014 this is the complete removal decision the\n * server returns as a receipt (see the rebuy-discount-architecture / GWP E2 notes).\n */\nexport const shouldRemoveGift = (\n    gift: Pick<GwpGift, 'cost' | 'discounted' | 'productId'>,\n    validIds: Set<number>\n): boolean => !validIds.has(gift.productId) || (!gift.discounted && gift.cost > 0);\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOO,IAAM,wBAAwB,CAAC,eAA8B,CAAC,MACjE,IAAI;AAAA,EACA,aACK,QAAQ,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,EACnC,QAAQ,CAAC,WAAW,OAAO,YAAY,CAAC,CAAC,EACzC,IAAI,CAAC,YAAY,OAAO,QAAQ,SAAS,CAAC,EAC1C,OAAO,CAAC,OAAO,OAAO,SAAS,EAAE,CAAC;AAC3C;;;ACPJ,IAAM,yBAAyB,CAAC,OAAO,WAAW;AAElD,IAAM,yBAAyB,CAAC,UAC3B,KAAK,SAAS,CAAC,GAAG;AAAA,EAAK,CAAC,WACpB,MAAM,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,uBAAuB,SAAS,KAAK,QAAQ,EAAE,CAAC;AACvF;AAMG,IAAM,0BAA0B,CAAC,aACpC,CAAC,GAAI,UAAU,gBAAgB,CAAC,GAAI,GAAI,UAAU,kBAAkB,CAAC,CAAE,EAAE,KAAK,sBAAsB;;;ACVjG,IAAM,yBAAyB,CAAC,aACnC,YAAY,SAAS,SAAS,gBAAgB,QAAQ,SAAS,kBAAkB;;;ACF9E,IAAM,mBAAmB,CAC5B,MACA,aACU,CAAC,SAAS,IAAI,KAAK,SAAS,KAAM,CAAC,KAAK,cAAc,KAAK,OAAO;",
+  "sourcesContent": ["export * from '~/gwp/getValidGwpProductIds';\nexport * from '~/gwp/hasUnsupportedRuleTypes';\nexport * from '~/gwp/isDefinitiveRuleAnswer';\nexport * from '~/gwp/shouldRemoveGift';\nexport * from '~/gwp/types';\n", "import { type MatchedRule } from '~/gwp/types';\n\n/**\n * The product ids a widget's matched rules currently qualify \u2014 ported from the React\n * extension's `getValidGwpProductIds` (camelCased engine shape). A gift whose product is\n * not in this set no longer qualifies and should be removed.\n */\nexport const getValidGwpProductIds = (matchedRules: MatchedRule[] = []): Set<number> =>\n    new Set(\n        matchedRules\n            .flatMap((rule) => rule.output ?? [])\n            .flatMap((output) => output.products ?? [])\n            .map((product) => Number(product.productId))\n            .filter((id) => Number.isFinite(id))\n    );\n", "import { type GwpMetadata, type MatchedRule } from '~/gwp/types';\n\n/**\n * Rule types the engine can't evaluate correctly in the cart/data-source context (no page URL,\n * no order) \u2014 ported from the React extension. When a widget's rules use these, the matched output\n * is unreliable, so the validator must NOT remove the gift.\n */\nconst UNSUPPORTED_RULE_TYPES = ['url', 'order_tag'];\n\nconst ruleHasUnsupportedType = (rule: MatchedRule): boolean =>\n    (rule.logic ?? []).some((group) =>\n        (group.rules ?? []).some((item) => UNSUPPORTED_RULE_TYPES.includes(item.type ?? ''))\n    );\n\n/**\n * Whether any matched OR unmatched rule uses an unsupported type \u2014 the bail signal: the gift's\n * qualification can't be trusted, so keep it (never remove on uncertainty).\n */\nexport const hasUnsupportedRuleTypes = (metadata?: GwpMetadata | null): boolean =>\n    [...(metadata?.matchedRules ?? []), ...(metadata?.unmatchedRules ?? [])].some(ruleHasUnsupportedType);\n", "import { type GwpMetadata } from '~/gwp/types';\n\n/**\n * Whether the engine metadata is a definitive rule answer the validator may act on. Removal is only\n * safe downstream of a parsed 2xx that actually evaluated rules (onsite-js standard: every degraded\n * path is a no-op): metadata missing entirely \u2014 the tolerated-empty-2xx path \u2014 or carrying NEITHER\n * `matchedRules` NOR `unmatchedRules` is uncertainty, so keep the gifts. `matchedRules: []` alongside\n * `unmatchedRules` IS definitive \u2014 the engine answered and nothing qualifies.\n */\nexport const isDefinitiveRuleAnswer = (metadata?: GwpMetadata | null): metadata is GwpMetadata =>\n    metadata != null && (metadata.matchedRules != null || metadata.unmatchedRules != null);\n", "import { type GwpGift } from '~/gwp/types';\n\n/**\n * A gift that visibly LOST its Shopify Function discount (`!discounted && cost > 0`). This signal is\n * cart-observable \u2014 it needs NO engine answer \u2014 so `validateGifts` removes such a gift on ANY validation\n * path, even a degraded one: a buyer must never keep paying for a \"gift\" because the rule engine was\n * degraded (`filterInputs`-tolerated empty 2xx, unsupported rule types, an unresolved endpoint, or an error).\n */\nexport const hasLostDiscount = (gift: Pick<GwpGift, 'cost' | 'discounted'>): boolean =>\n    !gift.discounted && gift.cost > 0;\n\n/**\n * Whether a gift line should be removed on a DEFINITIVE rule answer: either its product no longer\n * qualifies (\u2209 `validIds`) OR it {@link hasLostDiscount}. The Function can't remove a line it failed to\n * discount, so the client must \u2014 the complete removal receipt (see rebuy-discount-architecture / GWP E2).\n */\nexport const shouldRemoveGift = (\n    gift: Pick<GwpGift, 'cost' | 'discounted' | 'productId'>,\n    validIds: Set<number>\n): boolean => !validIds.has(gift.productId) || hasLostDiscount(gift);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOO,IAAM,wBAAwB,CAAC,eAA8B,CAAC,MACjE,IAAI;AAAA,EACA,aACK,QAAQ,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,EACnC,QAAQ,CAAC,WAAW,OAAO,YAAY,CAAC,CAAC,EACzC,IAAI,CAAC,YAAY,OAAO,QAAQ,SAAS,CAAC,EAC1C,OAAO,CAAC,OAAO,OAAO,SAAS,EAAE,CAAC;AAC3C;;;ACPJ,IAAM,yBAAyB,CAAC,OAAO,WAAW;AAElD,IAAM,yBAAyB,CAAC,UAC3B,KAAK,SAAS,CAAC,GAAG;AAAA,EAAK,CAAC,WACpB,MAAM,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,uBAAuB,SAAS,KAAK,QAAQ,EAAE,CAAC;AACvF;AAMG,IAAM,0BAA0B,CAAC,aACpC,CAAC,GAAI,UAAU,gBAAgB,CAAC,GAAI,GAAI,UAAU,kBAAkB,CAAC,CAAE,EAAE,KAAK,sBAAsB;;;ACVjG,IAAM,yBAAyB,CAAC,aACnC,YAAY,SAAS,SAAS,gBAAgB,QAAQ,SAAS,kBAAkB;;;ACF9E,IAAM,kBAAkB,CAAC,SAC5B,CAAC,KAAK,cAAc,KAAK,OAAO;AAO7B,IAAM,mBAAmB,CAC5B,MACA,aACU,CAAC,SAAS,IAAI,KAAK,SAAS,KAAK,gBAAgB,IAAI;",
   "names": []
 }

package/dist/gwp/index.mjs

@@ -14,9 +14,11 @@ var hasUnsupportedRuleTypes = (metadata) => [...metadata?.matchedRules ?? [], ..
 var isDefinitiveRuleAnswer = (metadata) => metadata != null && (metadata.matchedRules != null || metadata.unmatchedRules != null);
 
 // src/gwp/shouldRemoveGift.ts
-var shouldRemoveGift = (gift, validIds) => !validIds.has(gift.productId) || !gift.discounted && gift.cost > 0;
+var hasLostDiscount = (gift) => !gift.discounted && gift.cost > 0;
+var shouldRemoveGift = (gift, validIds) => !validIds.has(gift.productId) || hasLostDiscount(gift);
 export {
   getValidGwpProductIds,
+  hasLostDiscount,
   hasUnsupportedRuleTypes,
   isDefinitiveRuleAnswer,
   shouldRemoveGift

package/dist/gwp/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/gwp/getValidGwpProductIds.ts", "../../src/gwp/hasUnsupportedRuleTypes.ts", "../../src/gwp/isDefinitiveRuleAnswer.ts", "../../src/gwp/shouldRemoveGift.ts"],
-  "sourcesContent": ["import { type MatchedRule } from '~/gwp/types';\n\n/**\n * The product ids a widget's matched rules currently qualify \u2014 ported from the React\n * extension's `getValidGwpProductIds` (camelCased engine shape). A gift whose product is\n * not in this set no longer qualifies and should be removed.\n */\nexport const getValidGwpProductIds = (matchedRules: MatchedRule[] = []): Set<number> =>\n    new Set(\n        matchedRules\n            .flatMap((rule) => rule.output ?? [])\n            .flatMap((output) => output.products ?? [])\n            .map((product) => Number(product.productId))\n            .filter((id) => Number.isFinite(id))\n    );\n", "import { type GwpMetadata, type MatchedRule } from '~/gwp/types';\n\n/**\n * Rule types the engine can't evaluate correctly in the cart/data-source context (no page URL,\n * no order) \u2014 ported from the React extension. When a widget's rules use these, the matched output\n * is unreliable, so the validator must NOT remove the gift.\n */\nconst UNSUPPORTED_RULE_TYPES = ['url', 'order_tag'];\n\nconst ruleHasUnsupportedType = (rule: MatchedRule): boolean =>\n    (rule.logic ?? []).some((group) =>\n        (group.rules ?? []).some((item) => UNSUPPORTED_RULE_TYPES.includes(item.type ?? ''))\n    );\n\n/**\n * Whether any matched OR unmatched rule uses an unsupported type \u2014 the bail signal: the gift's\n * qualification can't be trusted, so keep it (never remove on uncertainty).\n */\nexport const hasUnsupportedRuleTypes = (metadata?: GwpMetadata | null): boolean =>\n    [...(metadata?.matchedRules ?? []), ...(metadata?.unmatchedRules ?? [])].some(ruleHasUnsupportedType);\n", "import { type GwpMetadata } from '~/gwp/types';\n\n/**\n * Whether the engine metadata is a definitive rule answer the validator may act on. Removal is only\n * safe downstream of a parsed 2xx that actually evaluated rules (onsite-js standard: every degraded\n * path is a no-op): metadata missing entirely \u2014 the tolerated-empty-2xx path \u2014 or carrying NEITHER\n * `matchedRules` NOR `unmatchedRules` is uncertainty, so keep the gifts. `matchedRules: []` alongside\n * `unmatchedRules` IS definitive \u2014 the engine answered and nothing qualifies.\n */\nexport const isDefinitiveRuleAnswer = (metadata?: GwpMetadata | null): metadata is GwpMetadata =>\n    metadata != null && (metadata.matchedRules != null || metadata.unmatchedRules != null);\n", "import { type GwpGift } from '~/gwp/types';\n\n/**\n * Whether a gift line should be removed: either its product no longer qualifies (\u2209 `validIds`),\n * OR it lost its Shopify Function discount (`!discounted && cost > 0`). The Function can't remove\n * a line it failed to discount, so the client must \u2014 this is the complete removal decision the\n * server returns as a receipt (see the rebuy-discount-architecture / GWP E2 notes).\n */\nexport const shouldRemoveGift = (\n    gift: Pick<GwpGift, 'cost' | 'discounted' | 'productId'>,\n    validIds: Set<number>\n): boolean => !validIds.has(gift.productId) || (!gift.discounted && gift.cost > 0);\n"],
-  "mappings": ";AAOO,IAAM,wBAAwB,CAAC,eAA8B,CAAC,MACjE,IAAI;AAAA,EACA,aACK,QAAQ,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,EACnC,QAAQ,CAAC,WAAW,OAAO,YAAY,CAAC,CAAC,EACzC,IAAI,CAAC,YAAY,OAAO,QAAQ,SAAS,CAAC,EAC1C,OAAO,CAAC,OAAO,OAAO,SAAS,EAAE,CAAC;AAC3C;;;ACPJ,IAAM,yBAAyB,CAAC,OAAO,WAAW;AAElD,IAAM,yBAAyB,CAAC,UAC3B,KAAK,SAAS,CAAC,GAAG;AAAA,EAAK,CAAC,WACpB,MAAM,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,uBAAuB,SAAS,KAAK,QAAQ,EAAE,CAAC;AACvF;AAMG,IAAM,0BAA0B,CAAC,aACpC,CAAC,GAAI,UAAU,gBAAgB,CAAC,GAAI,GAAI,UAAU,kBAAkB,CAAC,CAAE,EAAE,KAAK,sBAAsB;;;ACVjG,IAAM,yBAAyB,CAAC,aACnC,YAAY,SAAS,SAAS,gBAAgB,QAAQ,SAAS,kBAAkB;;;ACF9E,IAAM,mBAAmB,CAC5B,MACA,aACU,CAAC,SAAS,IAAI,KAAK,SAAS,KAAM,CAAC,KAAK,cAAc,KAAK,OAAO;",
+  "sourcesContent": ["import { type MatchedRule } from '~/gwp/types';\n\n/**\n * The product ids a widget's matched rules currently qualify \u2014 ported from the React\n * extension's `getValidGwpProductIds` (camelCased engine shape). A gift whose product is\n * not in this set no longer qualifies and should be removed.\n */\nexport const getValidGwpProductIds = (matchedRules: MatchedRule[] = []): Set<number> =>\n    new Set(\n        matchedRules\n            .flatMap((rule) => rule.output ?? [])\n            .flatMap((output) => output.products ?? [])\n            .map((product) => Number(product.productId))\n            .filter((id) => Number.isFinite(id))\n    );\n", "import { type GwpMetadata, type MatchedRule } from '~/gwp/types';\n\n/**\n * Rule types the engine can't evaluate correctly in the cart/data-source context (no page URL,\n * no order) \u2014 ported from the React extension. When a widget's rules use these, the matched output\n * is unreliable, so the validator must NOT remove the gift.\n */\nconst UNSUPPORTED_RULE_TYPES = ['url', 'order_tag'];\n\nconst ruleHasUnsupportedType = (rule: MatchedRule): boolean =>\n    (rule.logic ?? []).some((group) =>\n        (group.rules ?? []).some((item) => UNSUPPORTED_RULE_TYPES.includes(item.type ?? ''))\n    );\n\n/**\n * Whether any matched OR unmatched rule uses an unsupported type \u2014 the bail signal: the gift's\n * qualification can't be trusted, so keep it (never remove on uncertainty).\n */\nexport const hasUnsupportedRuleTypes = (metadata?: GwpMetadata | null): boolean =>\n    [...(metadata?.matchedRules ?? []), ...(metadata?.unmatchedRules ?? [])].some(ruleHasUnsupportedType);\n", "import { type GwpMetadata } from '~/gwp/types';\n\n/**\n * Whether the engine metadata is a definitive rule answer the validator may act on. Removal is only\n * safe downstream of a parsed 2xx that actually evaluated rules (onsite-js standard: every degraded\n * path is a no-op): metadata missing entirely \u2014 the tolerated-empty-2xx path \u2014 or carrying NEITHER\n * `matchedRules` NOR `unmatchedRules` is uncertainty, so keep the gifts. `matchedRules: []` alongside\n * `unmatchedRules` IS definitive \u2014 the engine answered and nothing qualifies.\n */\nexport const isDefinitiveRuleAnswer = (metadata?: GwpMetadata | null): metadata is GwpMetadata =>\n    metadata != null && (metadata.matchedRules != null || metadata.unmatchedRules != null);\n", "import { type GwpGift } from '~/gwp/types';\n\n/**\n * A gift that visibly LOST its Shopify Function discount (`!discounted && cost > 0`). This signal is\n * cart-observable \u2014 it needs NO engine answer \u2014 so `validateGifts` removes such a gift on ANY validation\n * path, even a degraded one: a buyer must never keep paying for a \"gift\" because the rule engine was\n * degraded (`filterInputs`-tolerated empty 2xx, unsupported rule types, an unresolved endpoint, or an error).\n */\nexport const hasLostDiscount = (gift: Pick<GwpGift, 'cost' | 'discounted'>): boolean =>\n    !gift.discounted && gift.cost > 0;\n\n/**\n * Whether a gift line should be removed on a DEFINITIVE rule answer: either its product no longer\n * qualifies (\u2209 `validIds`) OR it {@link hasLostDiscount}. The Function can't remove a line it failed to\n * discount, so the client must \u2014 the complete removal receipt (see rebuy-discount-architecture / GWP E2).\n */\nexport const shouldRemoveGift = (\n    gift: Pick<GwpGift, 'cost' | 'discounted' | 'productId'>,\n    validIds: Set<number>\n): boolean => !validIds.has(gift.productId) || hasLostDiscount(gift);\n"],
+  "mappings": ";AAOO,IAAM,wBAAwB,CAAC,eAA8B,CAAC,MACjE,IAAI;AAAA,EACA,aACK,QAAQ,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,EACnC,QAAQ,CAAC,WAAW,OAAO,YAAY,CAAC,CAAC,EACzC,IAAI,CAAC,YAAY,OAAO,QAAQ,SAAS,CAAC,EAC1C,OAAO,CAAC,OAAO,OAAO,SAAS,EAAE,CAAC;AAC3C;;;ACPJ,IAAM,yBAAyB,CAAC,OAAO,WAAW;AAElD,IAAM,yBAAyB,CAAC,UAC3B,KAAK,SAAS,CAAC,GAAG;AAAA,EAAK,CAAC,WACpB,MAAM,SAAS,CAAC,GAAG,KAAK,CAAC,SAAS,uBAAuB,SAAS,KAAK,QAAQ,EAAE,CAAC;AACvF;AAMG,IAAM,0BAA0B,CAAC,aACpC,CAAC,GAAI,UAAU,gBAAgB,CAAC,GAAI,GAAI,UAAU,kBAAkB,CAAC,CAAE,EAAE,KAAK,sBAAsB;;;ACVjG,IAAM,yBAAyB,CAAC,aACnC,YAAY,SAAS,SAAS,gBAAgB,QAAQ,SAAS,kBAAkB;;;ACF9E,IAAM,kBAAkB,CAAC,SAC5B,CAAC,KAAK,cAAc,KAAK,OAAO;AAO7B,IAAM,mBAAmB,CAC5B,MACA,aACU,CAAC,SAAS,IAAI,KAAK,SAAS,KAAK,gBAAgB,IAAI;",
   "names": []
 }

package/dist/gwp/shouldRemoveGift.d.ts

@@ -1,9 +1,15 @@
 import { type GwpGift } from '../gwp/types';
 /**
- * Whether a gift line should be removed: either its product no longer qualifies (∉ `validIds`),
- * OR it lost its Shopify Function discount (`!discounted && cost > 0`). The Function can't remove
- * a line it failed to discount, so the client must — this is the complete removal decision the
- * server returns as a receipt (see the rebuy-discount-architecture / GWP E2 notes).
+ * A gift that visibly LOST its Shopify Function discount (`!discounted && cost > 0`). This signal is
+ * cart-observable — it needs NO engine answer — so `validateGifts` removes such a gift on ANY validation
+ * path, even a degraded one: a buyer must never keep paying for a "gift" because the rule engine was
+ * degraded (`filterInputs`-tolerated empty 2xx, unsupported rule types, an unresolved endpoint, or an error).
+ */
+export declare const hasLostDiscount: (gift: Pick<GwpGift, "cost" | "discounted">) => boolean;
+/**
+ * Whether a gift line should be removed on a DEFINITIVE rule answer: either its product no longer
+ * qualifies (∉ `validIds`) OR it {@link hasLostDiscount}. The Function can't remove a line it failed to
+ * discount, so the client must — the complete removal receipt (see rebuy-discount-architecture / GWP E2).
  */
 export declare const shouldRemoveGift: (gift: Pick<GwpGift, "cost" | "discounted" | "productId">, validIds: Set<number>) => boolean;
 //# sourceMappingURL=shouldRemoveGift.d.ts.map

package/dist/gwp/shouldRemoveGift.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shouldRemoveGift.d.ts","sourceRoot":"","sources":["../../src/gwp/shouldRemoveGift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GACzB,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC,EACxD,UAAU,GAAG,CAAC,MAAM,CAAC,KACtB,OAA+E,CAAC"}
+{"version":3,"file":"shouldRemoveGift.d.ts","sourceRoot":"","sources":["../../src/gwp/shouldRemoveGift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,KAAG,OACxC,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GACzB,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC,EACxD,UAAU,GAAG,CAAC,MAAM,CAAC,KACtB,OAAiE,CAAC"}

package/dist/index.js

@@ -2319,8 +2319,10 @@ var CABProgressTier = import_zod23.z.object({
    * the React port's bar-level `tiers[0]` shortcut). `currency` compares money cents against the
    * adjusted subtotal; `item` compares the raw quantity sum of non-excluded lines (the SAME exclusion
    * set as the money path). A mixed-unit bar stays coherent tier by tier: reach, fill share, and
-   * `{{remainingAmount}}` (count-formatted + item/items-pluralized for `item` tiers) each resolve in
-   * their own tier's unit — cross-tier arithmetic never mixes counts with cents.
+   * `{{remainingAmount}}` (a raw `Intl`-localized count for `item` tiers, money for `currency` tiers)
+   * each resolve in their own tier's unit — cross-tier arithmetic never mixes counts with cents. The
+   * count carries no injected noun (no English `item`/`items` inflection on localized copy); merchant
+   * template text supplies grammatically-neutral wording around the token.
    */
   unit: import_zod23.z.enum(progressTierUnits).default(ProgressTierUnit.currency)
 });