@doswiftly/storefront-sdk 21.0.0 → 22.0.0

package/dist/core/index.d.ts

@@ -67,6 +67,7 @@ export { AUTH_COOKIE_NAME, AUTH_COOKIE_DEFAULTS, type AuthCookieConfig, REFRESH_
 export { LANGUAGE_COOKIE_NAME, LANGUAGE_COOKIE_MAX_AGE, LANGUAGE_HEADER_NAME } from './language/cookie-config';
 export { CURRENCY_COOKIE_NAME, CURRENCY_COOKIE_MAX_AGE, CURRENCY_HEADER_NAME } from './currency/cookie-config';
 export { CART_COOKIE_NAME, CART_COOKIE_MAX_AGE, parseCartCookieValue, formatCartCookieValue, type CartCredentials, } from './cart/cookie-config';
+export { REFERRAL_COOKIE_NAME, REFERRAL_COOKIE_MAX_AGE, REFERRAL_CODE_MAX_LENGTH, REFERRAL_CODE_PATTERN, extractReferralCodeFromUrl, } from './referral/cookie-config';
 export { matchesRoute, type RouteProtectionConfig } from './auth/routes';
 export { createSetTokenHandler, createClearTokenHandler, createWhoamiHandler, originAllowlistValidator, trustedForwardedHostValidator, } from './auth/handlers';
 export type { OriginValidator, OriginValidatorContext } from './auth/handlers';

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAGxG,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,YAAY,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAGjF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGpF,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,0BAA0B,EAC1B,KAAK,cAAc,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAEV,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,KAAK,EACL,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,EACL,cAAc,EAGd,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,+BAA+B,EAC/B,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,WAAW,EAEX,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,gCAAgC,EAChC,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAGhB,gBAAgB,EAEhB,wBAAwB,EACxB,YAAY,EACZ,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,UAAU,EACV,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACnG,YAAY,EACV,QAAQ,EACR,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAG/G,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAG/G,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGlF,OAAO,EAAE,KAAK,SAAS,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}

package/dist/core/index.js

@@ -84,6 +84,8 @@ export { LANGUAGE_COOKIE_NAME, LANGUAGE_COOKIE_MAX_AGE, LANGUAGE_HEADER_NAME } f
 export { CURRENCY_COOKIE_NAME, CURRENCY_COOKIE_MAX_AGE, CURRENCY_HEADER_NAME } from './currency/cookie-config';
 // Cart cookie config + composite value parser/formatter (`<cartId>.<secret>`)
 export { CART_COOKIE_NAME, CART_COOKIE_MAX_AGE, parseCartCookieValue, formatCartCookieValue, } from './cart/cookie-config';
+// Referral cookie config + URL extractor (loyalty referral program capture)
+export { REFERRAL_COOKIE_NAME, REFERRAL_COOKIE_MAX_AGE, REFERRAL_CODE_MAX_LENGTH, REFERRAL_CODE_PATTERN, extractReferralCodeFromUrl, } from './referral/cookie-config';
 // Auth route matching
 export { matchesRoute } from './auth/routes';
 // Auth cookie handlers (API route factories)

package/dist/core/middleware/session-retry.d.ts

@@ -4,15 +4,14 @@
  * When a request fails with HTTP 401 (the access token lapsed between the
  * proactive refresh and this call):
  *
- *   - **Read query** — refresh the session once and replay the request (R2.1).
+ *   - **Read query** — refresh the session once and replay the request.
  *     Because this middleware is the outermost one, the retry re-runs the auth
  *     middleware, which re-reads the freshly-stored token. Concurrent 401s share
- *     a single renewal because the injected `refresh` dedupes in-flight calls
- *     (R2.2). If the refresh also fails, the session is gone — signal and bail
- *     (R2.4).
+ *     a single renewal because the injected `refresh` dedupes in-flight calls.
+ *     If the refresh also fails, the session is gone — signal and bail.
  *
  *   - **Mutation** — never auto-retry (mutations are sacred; client-side
- *     idempotency is not guaranteed). Bail and signal the session loss (R2.3).
+ *     idempotency is not guaranteed). Bail and signal the session loss.
  *
  * Auth operations (login / signup / refresh / logout) are exempt: they own
  * their own error handling, and retrying the refresh op itself would recurse.
@@ -35,7 +34,7 @@ export interface SessionRetryOptions {
     /**
      * Renew the session (refresh token → cookie sync → store update). Resolves
      * `true` on success. MUST dedupe concurrent calls so simultaneous 401s share
-     * a single renewal (R2.2).
+     * a single renewal.
      */
     refresh: () => Promise<boolean>;
     /** Notify that the session is gone (a mutation 401, or a query whose refresh-retry failed). */

package/dist/core/middleware/session-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-retry.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/session-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAQlE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,+FAA+F;IAC/F,gBAAgB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACvD,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,CAgC/E"}
+{"version":3,"file":"session-retry.d.ts","sourceRoot":"","sources":["../../../src/core/middleware/session-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAQlE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,+FAA+F;IAC/F,gBAAgB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACvD,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,CAgC/E"}

package/dist/core/middleware/session-retry.js

@@ -4,15 +4,14 @@
  * When a request fails with HTTP 401 (the access token lapsed between the
  * proactive refresh and this call):
  *
- *   - **Read query** — refresh the session once and replay the request (R2.1).
+ *   - **Read query** — refresh the session once and replay the request.
  *     Because this middleware is the outermost one, the retry re-runs the auth
  *     middleware, which re-reads the freshly-stored token. Concurrent 401s share
- *     a single renewal because the injected `refresh` dedupes in-flight calls
- *     (R2.2). If the refresh also fails, the session is gone — signal and bail
- *     (R2.4).
+ *     a single renewal because the injected `refresh` dedupes in-flight calls.
+ *     If the refresh also fails, the session is gone — signal and bail.
  *
  *   - **Mutation** — never auto-retry (mutations are sacred; client-side
- *     idempotency is not guaranteed). Bail and signal the session loss (R2.3).
+ *     idempotency is not guaranteed). Bail and signal the session loss.
  *
  * Auth operations (login / signup / refresh / logout) are exempt: they own
  * their own error handling, and retrying the refresh op itself would recurse.
@@ -52,14 +51,14 @@ export function sessionRetryMiddleware(options) {
             if (!isUnauthorized(err))
                 throw err;
             if (request.isMutation) {
-                // R2.3 — mutations are sacred: bail, never auto-retry.
+                // Mutations are sacred: bail, never auto-retry.
                 onSessionExpired({ reason: 'mutation-unauthorized', cause: err });
                 throw err;
             }
-            // R2.1 / R2.2 — read query: refresh once (deduped) and replay.
+            // Read query: refresh once (deduped) and replay.
             const renewed = await refresh();
             if (!renewed) {
-                // R2.4 — the refresh also failed; the session is gone.
+                // The refresh also failed; the session is gone.
                 onSessionExpired({ reason: 'reactive-refresh-failed', cause: err });
                 throw err;
             }

package/dist/core/operations/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/core/operations/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsHH,eAAO,MAAM,cAAc,QASzB,CAAC;AAEH,eAAO,MAAM,eAAe,QAS1B,CAAC;AAEH,eAAO,MAAM,sBAAsB,QASjC,CAAC;AAEH,eAAO,MAAM,eAAe,QAW1B,CAAC;AAMH,eAAO,MAAM,cAAc,QAOzB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAYnC,CAAC"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/core/operations/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA0HH,eAAO,MAAM,cAAc,QASzB,CAAC;AAEH,eAAO,MAAM,eAAe,QAS1B,CAAC;AAEH,eAAO,MAAM,sBAAsB,QASjC,CAAC;AAEH,eAAO,MAAM,eAAe,QAW1B,CAAC;AAMH,eAAO,MAAM,cAAc,QAOzB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAYnC,CAAC"}

package/dist/core/operations/auth.js

@@ -53,6 +53,8 @@ const MAILING_ADDRESS_FRAGMENT_AUTH = `
     company
     streetLine1
     streetLine2
+    buildingNumber
+    flatNumber
     city
     state
     stateCode
@@ -90,6 +92,8 @@ const CUSTOMER_FRAGMENT = `
       id
       streetLine1
       streetLine2
+      buildingNumber
+      flatNumber
       city
       company
       country

package/dist/core/operations/cart.d.ts

@@ -85,7 +85,7 @@ export declare const CART_UPDATE_GIFT_CARD_RECIPIENT: string;
  * flow decisions). The cart itself is NOT returned — after completion it is
  * CONVERTED/locked, so the storefront drops its local cart and works with the
  * Order. `order` is non-null on success. `paymentUrl` is intentionally NOT in
- * the payload (Decision D4) — the storefront calls a separate `paymentCreate`
+ * the payload — the payment session is created by a separate `paymentCreate`
  * mutation after checking `order.canCreatePayment`.
  */
 export declare const CART_COMPLETE: string;
@@ -97,19 +97,20 @@ export declare const CART_COMPLETE: string;
  */
 export declare const PAYMENT_CREATE: string;
 /**
- * cartClearPaymentSelection Mutation (Adv-1 Phase A1-2) — explicit deselect
- * dla storefront accordion UI ("wróć do wyboru metody"). Atomic NULL na
- * wszystkich 4 payment selection fields, idempotent. Cart MUSI być ACTIVE
- * (CONVERTED reject z `ALREADY_COMPLETED`).
+ * cartClearPaymentSelection Mutation — explicit deselect for "back to payment
+ * method selection" storefront accordion UI. Atomically NULLs all 4 payment
+ * selection fields, idempotent. The cart MUST be ACTIVE (CONVERTED carts are
+ * rejected with `ALREADY_COMPLETED`).
  */
 export declare const CART_CLEAR_PAYMENT_SELECTION: string;
 /**
- * cartValidateDiscountCode Query — read-only preview discount applicability
- * (Decision D3). No cart side effects; storefront UI używa do inline feedback
- * gdy klient wpisuje kod (przed wywołaniem cartDiscountCodesUpdate).
+ * cartValidateDiscountCode Query — read-only preview of discount applicability;
+ * validation must not mutate cart state. No cart side effects; storefront UI
+ * uses it for inline feedback while the customer types a code (before calling
+ * cartDiscountCodesUpdate).
  *
- * Caching guidance: `fetchPolicy: 'network-only'` lub key zawierający
- * `cart.subtotal` (discount eligibility może zależeć od minimum order amount).
+ * Caching guidance: `fetchPolicy: 'network-only'` or a key that includes
+ * `cart.subtotal` (discount eligibility may depend on a minimum order amount).
  */
 export declare const CART_VALIDATE_DISCOUNT_CODE: string;
 //# sourceMappingURL=cart.d.ts.map

package/dist/core/operations/cart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../../src/core/operations/cart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsbH,eAAO,MAAM,UAAU,QAOrB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,QAehD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,QAO1C,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAO/B,CAAC;AAMH,eAAO,MAAM,WAAW,QAYtB,CAAC;AAEH,eAAO,MAAM,cAAc,QAWzB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAW5B,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAW5B,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAWrC,CAAC;AAEH,eAAO,MAAM,gBAAgB,QAW3B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAWjC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAWrC,CAAC;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,QAWrB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAWnC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAY/B,CAAC;AAMH,eAAO,MAAM,yBAAyB,QAWpC,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAWnC,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAWtC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAWrC,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAW/B,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAWhC,CAAC;AAEH,eAAO,MAAM,+BAA+B,QAW1C,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,QAWxB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAWzB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,QAWvC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,QAoBtC,CAAC"}
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../../src/core/operations/cart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwbH,eAAO,MAAM,UAAU,QAOrB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,QAehD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,QAO1C,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAO/B,CAAC;AAMH,eAAO,MAAM,WAAW,QAYtB,CAAC;AAEH,eAAO,MAAM,cAAc,QAWzB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAW5B,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAW5B,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAWrC,CAAC;AAEH,eAAO,MAAM,gBAAgB,QAW3B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAWjC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAWrC,CAAC;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,QAWrB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAWnC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAY/B,CAAC;AAMH,eAAO,MAAM,yBAAyB,QAWpC,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAWnC,CAAC;AAEH,eAAO,MAAM,2BAA2B,QAWtC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAWrC,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAW/B,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAWhC,CAAC;AAEH,eAAO,MAAM,+BAA+B,QAW1C,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,QAWxB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAWzB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,QAWvC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,QAoBtC,CAAC"}

package/dist/core/operations/cart.js

@@ -162,6 +162,8 @@ const MAILING_ADDRESS_FRAGMENT = `
     company
     streetLine1
     streetLine2
+    buildingNumber
+    flatNumber
     city
     state
     stateCode
@@ -640,7 +642,7 @@ export const CART_RECOVERY_REDEEM = composeOperation(`
   ${CART_WARNING_FRAGMENT}
 `);
 // ---------------------------------------------------------------------------
-// Phase 3 — Cart completion lifecycle mutations
+// Cart completion lifecycle mutations
 // ---------------------------------------------------------------------------
 export const CART_SET_SHIPPING_ADDRESS = composeOperation(`
   mutation CartSetShippingAddress($input: CartSetShippingAddressInput!) {
@@ -732,7 +734,7 @@ export const CART_UPDATE_GIFT_CARD_RECIPIENT = composeOperation(`
  * flow decisions). The cart itself is NOT returned — after completion it is
  * CONVERTED/locked, so the storefront drops its local cart and works with the
  * Order. `order` is non-null on success. `paymentUrl` is intentionally NOT in
- * the payload (Decision D4) — the storefront calls a separate `paymentCreate`
+ * the payload — the payment session is created by a separate `paymentCreate`
  * mutation after checking `order.canCreatePayment`.
  */
 export const CART_COMPLETE = composeOperation(`
@@ -766,10 +768,10 @@ export const PAYMENT_CREATE = composeOperation(`
   ${PAYMENT_WARNING_FRAGMENT}
 `);
 /**
- * cartClearPaymentSelection Mutation (Adv-1 Phase A1-2) — explicit deselect
- * dla storefront accordion UI ("wróć do wyboru metody"). Atomic NULL na
- * wszystkich 4 payment selection fields, idempotent. Cart MUSI być ACTIVE
- * (CONVERTED reject z `ALREADY_COMPLETED`).
+ * cartClearPaymentSelection Mutation — explicit deselect for "back to payment
+ * method selection" storefront accordion UI. Atomically NULLs all 4 payment
+ * selection fields, idempotent. The cart MUST be ACTIVE (CONVERTED carts are
+ * rejected with `ALREADY_COMPLETED`).
  */
 export const CART_CLEAR_PAYMENT_SELECTION = composeOperation(`
   mutation CartClearPaymentSelection($input: CartClearPaymentSelectionInput!) {
@@ -784,12 +786,13 @@ export const CART_CLEAR_PAYMENT_SELECTION = composeOperation(`
   ${CART_WARNING_FRAGMENT}
 `);
 /**
- * cartValidateDiscountCode Query — read-only preview discount applicability
- * (Decision D3). No cart side effects; storefront UI używa do inline feedback
- * gdy klient wpisuje kod (przed wywołaniem cartDiscountCodesUpdate).
+ * cartValidateDiscountCode Query — read-only preview of discount applicability;
+ * validation must not mutate cart state. No cart side effects; storefront UI
+ * uses it for inline feedback while the customer types a code (before calling
+ * cartDiscountCodesUpdate).
  *
- * Caching guidance: `fetchPolicy: 'network-only'` lub key zawierający
- * `cart.subtotal` (discount eligibility może zależeć od minimum order amount).
+ * Caching guidance: `fetchPolicy: 'network-only'` or a key that includes
+ * `cart.subtotal` (discount eligibility may depend on a minimum order amount).
  */
 export const CART_VALIDATE_DISCOUNT_CODE = composeOperation(`
   query CartValidateDiscountCode($cartId: ID!, $discountCode: String!) {

package/dist/core/referral/cookie-config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Referral cookie configuration — platform contract.
+ *
+ * When a visitor lands on the storefront through a referral link
+ * (`https://shop.example/register?ref=REF-AB12CD34`), the code must survive
+ * navigation until the visitor actually signs up — possibly minutes or days
+ * later. The SDK persists it in a readable first-party cookie and the signup
+ * form passes it to `customerSignup(input: { referralCode })`.
+ *
+ * Used by:
+ * - `captureReferralCode` / `useReferralCapture` (client-side capture on landing)
+ * - `readReferralCodeCookie` (client + server readers at signup time)
+ */
+export declare const REFERRAL_COOKIE_NAME = "referral-code";
+/**
+ * Default cookie lifetime: 30 days.
+ *
+ * This is the "landing → signup" window only. It is intentionally NOT tied to
+ * the shop's referral validity setting (days the referred customer has to
+ * place their first order) — that window starts at signup and is validated
+ * exclusively by the backend. Coupling the two would be wrong: a shop giving
+ * referred customers 7 days to order would silently lose visitors who sign up
+ * 8 days after clicking the link. Override per call via
+ * `captureReferralCode({ maxAge })` if you need a different capture window.
+ */
+export declare const REFERRAL_COOKIE_MAX_AGE: number;
+/**
+ * Maximum accepted code length — longer values are ignored as garbage.
+ * Mirrors the `customerSignup` input contract (the API rejects longer codes).
+ */
+export declare const REFERRAL_CODE_MAX_LENGTH = 50;
+/**
+ * Accepted code shape: letters, digits and dashes (codes are case-insensitive —
+ * the API uppercases on lookup). Mirrors the platform referral-code charset;
+ * a non-conforming value is never persisted to the cookie, because the API
+ * would silently ignore it at signup anyway — storing it for 30 days would
+ * just carry dead weight (or someone's injection attempt) around. Widen this
+ * pattern only together with the `customerSignup.referralCode` API contract.
+ */
+export declare const REFERRAL_CODE_PATTERN: RegExp;
+/**
+ * Extract a referral code from a URL or a search string.
+ *
+ * Accepts a full or relative URL (`https://shop.example/register?ref=CODE`,
+ * `/register?ref=CODE`), a search string starting with `?` (`?ref=CODE`) or a
+ * `URL` instance. Returns the trimmed code, or `null` when the parameter is
+ * absent, empty, longer than {@link REFERRAL_CODE_MAX_LENGTH} or outside
+ * {@link REFERRAL_CODE_PATTERN} (such values would be ignored by the API
+ * anyway, so they are never persisted).
+ *
+ * @param input - URL, `URL` instance or `?`-prefixed search string to inspect.
+ * @param paramName - Query parameter carrying the code (default `'ref'` —
+ *   matches the share links generated by the platform).
+ */
+export declare function extractReferralCodeFromUrl(input: string | URL, paramName?: string): string | null;
+//# sourceMappingURL=cookie-config.d.ts.map

package/dist/core/referral/cookie-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-config.d.ts","sourceRoot":"","sources":["../../../src/core/referral/cookie-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,QAAoB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,SAAS,SAAQ,GAAG,MAAM,GAAG,IAAI,CAyBhG"}

package/dist/core/referral/cookie-config.js

@@ -0,0 +1,83 @@
+/**
+ * Referral cookie configuration — platform contract.
+ *
+ * When a visitor lands on the storefront through a referral link
+ * (`https://shop.example/register?ref=REF-AB12CD34`), the code must survive
+ * navigation until the visitor actually signs up — possibly minutes or days
+ * later. The SDK persists it in a readable first-party cookie and the signup
+ * form passes it to `customerSignup(input: { referralCode })`.
+ *
+ * Used by:
+ * - `captureReferralCode` / `useReferralCapture` (client-side capture on landing)
+ * - `readReferralCodeCookie` (client + server readers at signup time)
+ */
+export const REFERRAL_COOKIE_NAME = 'referral-code';
+/**
+ * Default cookie lifetime: 30 days.
+ *
+ * This is the "landing → signup" window only. It is intentionally NOT tied to
+ * the shop's referral validity setting (days the referred customer has to
+ * place their first order) — that window starts at signup and is validated
+ * exclusively by the backend. Coupling the two would be wrong: a shop giving
+ * referred customers 7 days to order would silently lose visitors who sign up
+ * 8 days after clicking the link. Override per call via
+ * `captureReferralCode({ maxAge })` if you need a different capture window.
+ */
+export const REFERRAL_COOKIE_MAX_AGE = 30 * 24 * 60 * 60; // 30 days
+/**
+ * Maximum accepted code length — longer values are ignored as garbage.
+ * Mirrors the `customerSignup` input contract (the API rejects longer codes).
+ */
+export const REFERRAL_CODE_MAX_LENGTH = 50;
+/**
+ * Accepted code shape: letters, digits and dashes (codes are case-insensitive —
+ * the API uppercases on lookup). Mirrors the platform referral-code charset;
+ * a non-conforming value is never persisted to the cookie, because the API
+ * would silently ignore it at signup anyway — storing it for 30 days would
+ * just carry dead weight (or someone's injection attempt) around. Widen this
+ * pattern only together with the `customerSignup.referralCode` API contract.
+ */
+export const REFERRAL_CODE_PATTERN = /^[A-Za-z0-9-]+$/;
+/**
+ * Extract a referral code from a URL or a search string.
+ *
+ * Accepts a full or relative URL (`https://shop.example/register?ref=CODE`,
+ * `/register?ref=CODE`), a search string starting with `?` (`?ref=CODE`) or a
+ * `URL` instance. Returns the trimmed code, or `null` when the parameter is
+ * absent, empty, longer than {@link REFERRAL_CODE_MAX_LENGTH} or outside
+ * {@link REFERRAL_CODE_PATTERN} (such values would be ignored by the API
+ * anyway, so they are never persisted).
+ *
+ * @param input - URL, `URL` instance or `?`-prefixed search string to inspect.
+ * @param paramName - Query parameter carrying the code (default `'ref'` —
+ *   matches the share links generated by the platform).
+ */
+export function extractReferralCodeFromUrl(input, paramName = 'ref') {
+    let params;
+    if (input instanceof URL) {
+        params = input.searchParams;
+    }
+    else {
+        const raw = input.trim();
+        if (!raw)
+            return null;
+        if (raw.startsWith('?')) {
+            // Search-string form: "?ref=CODE&utm_source=x"
+            params = new URLSearchParams(raw.slice(1));
+        }
+        else {
+            // Full or relative URL — the base argument makes relative paths
+            // ("/register?ref=CODE") parse too.
+            try {
+                params = new URL(raw, 'http://localhost').searchParams;
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    const value = params.get(paramName)?.trim() ?? '';
+    if (!value || value.length > REFERRAL_CODE_MAX_LENGTH || !REFERRAL_CODE_PATTERN.test(value))
+        return null;
+    return value;
+}

package/dist/react/components/PaymentInstrumentSection.d.ts

@@ -1,17 +1,18 @@
 /**
- * `<PaymentInstrumentSection>` — radio-group container dla payment instruments
- * w obrębie jednej method (np. lista bankow + BLIK code entry w BLIK method,
- * lista wallets + brand cards w CARD method). Renders jeden `<PaymentInstrumentTile>`
- * per item z keyboard nav (Arrow Up/Down, Home/End) + ARIA `role="radiogroup"`.
+ * `<PaymentInstrumentSection>` — radio-group container for the payment
+ * instruments within a single method (e.g. a bank list + BLIK code entry in a
+ * BLIK method, wallets + card brands in a CARD method). Renders one
+ * `<PaymentInstrumentTile>` per item with keyboard nav (Arrow Up/Down,
+ * Home/End) + ARIA `role="radiogroup"`.
  *
- * Headless — section + tiles bez własnego stylingu. Pass `sectionClassName`
- * dla layoutu (grid/flex), `tileClassName` dla per-tile styling, optional
- * `iconClassName`/`labelClassName` dla wewnętrznej struktury tile.
+ * Headless — section + tiles ship without any styling. Pass `sectionClassName`
+ * for the layout (grid/flex), `tileClassName` for per-tile styling, optional
+ * `iconClassName`/`labelClassName` for the tile's inner structure.
  *
- * Auto-group **nie jest** implementowane w tym sub-sprincie — backend już
- * zwraca instruments sorted (BLIK + wallets pierwsze → banks alpha → others)
- * z `availablePaymentMethods.methods[].instruments[]`. Komponent renderuje
- * w order'ze otrzymanym, bez własnej resort logic.
+ * Auto-grouping is **not** implemented — the backend already returns
+ * instruments sorted (BLIK + wallets first → banks alphabetically → others)
+ * in `availablePaymentMethods.methods[].instruments[]`. The component renders
+ * them in the order received, with no re-sorting logic of its own.
  *
  * @example
  * ```tsx
@@ -24,32 +25,31 @@
  *   tileClassName="rounded border p-3 data-[selected=true]:border-blue-500"
  * />
  * ```
- *
- * Added by payment-instrument-preselection-advanced sub-sprint Adv-2 Req 9.
  */
 import type { PaymentMethod } from '../../core/generated/operation-types';
 /**
- * Minimalna projekcja `PaymentMethod` używana przez section — wymaga tylko
- * `instruments[]`. Caller może pass pełną `PaymentMethod` z `availablePaymentMethods`
- * query — extra pola (id, name, providersAvailable, etc.) są ignorowane.
+ * Minimal projection of `PaymentMethod` used by the section — only
+ * `instruments[]` is required. The caller may pass a full `PaymentMethod` from
+ * the `availablePaymentMethods` query — extra fields (id, name,
+ * providersAvailable, etc.) are ignored.
  */
 export type PaymentInstrumentSectionMethod = Pick<PaymentMethod, 'instruments'>;
 export interface PaymentInstrumentSectionProps {
-    /** Payment method z `instruments[]` listą (null/empty → komponent zwraca null). */
+    /** Payment method with an `instruments[]` list (null/empty → the component returns null). */
     method: PaymentInstrumentSectionMethod;
-    /** Currently selected instrument code — controlled by parent. Undefined gdy buyer nie wybrał. */
+    /** Currently selected instrument code — controlled by parent. Undefined when the buyer has not picked one yet. */
     selectedInstrumentCode?: string;
-    /** Callback gdy buyer selektuje instrument. Parent persistuje state + odpala `cartSelectPaymentMethod`. */
+    /** Callback fired when the buyer selects an instrument. The parent persists the state + calls `cartSelectPaymentMethod`. */
     onSelectInstrument: (instrumentCode: string) => void;
-    /** Optional class dla outer section element — typically grid/flex layout. */
+    /** Optional class for the outer section element — typically grid/flex layout. */
     sectionClassName?: string;
-    /** Optional class dla each `<PaymentInstrumentTile>` — passed jako `className`. */
+    /** Optional class for each `<PaymentInstrumentTile>` — passed as `className`. */
     tileClassName?: string;
-    /** Optional class dla brand image inside tiles — passed jako `iconClassName`. */
+    /** Optional class for the brand image inside tiles — passed as `iconClassName`. */
     iconClassName?: string;
-    /** Optional class dla label span inside tiles — passed jako `labelClassName`. */
+    /** Optional class for the label span inside tiles — passed as `labelClassName`. */
     labelClassName?: string;
-    /** Optional ARIA label dla radiogroup. Defaults to nothing (caller's responsibility — section typically nested w wider label structure). */
+    /** Optional ARIA label for the radiogroup. Defaults to nothing (caller's responsibility — the section is typically nested in a wider label structure). */
     ariaLabel?: string;
 }
 export declare function PaymentInstrumentSection({ method, selectedInstrumentCode, onSelectInstrument, sectionClassName, tileClassName, iconClassName, labelClassName, ariaLabel, }: PaymentInstrumentSectionProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/react/components/PaymentInstrumentSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PaymentInstrumentSection.d.ts","sourceRoot":"","sources":["../../../src/react/components/PaymentInstrumentSection.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,sCAAsC,CAAC;AAG7F;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAEhF,MAAM,WAAW,6BAA6B;IAC5C,mFAAmF;IACnF,MAAM,EAAE,8BAA8B,CAAC;IACvC,iGAAiG;IACjG,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,2GAA2G;IAC3G,kBAAkB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4IAA4I;IAC5I,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,SAAS,GACV,EAAE,6BAA6B,kDAmF/B"}
+{"version":3,"file":"PaymentInstrumentSection.d.ts","sourceRoot":"","sources":["../../../src/react/components/PaymentInstrumentSection.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,sCAAsC,CAAC;AAG7F;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAEhF,MAAM,WAAW,6BAA6B;IAC5C,6FAA6F;IAC7F,MAAM,EAAE,8BAA8B,CAAC;IACvC,kHAAkH;IAClH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,4HAA4H;IAC5H,kBAAkB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0JAA0J;IAC1J,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,SAAS,GACV,EAAE,6BAA6B,kDAoF/B"}

package/dist/react/components/PaymentInstrumentSection.js

@@ -1,17 +1,18 @@
 /**
- * `<PaymentInstrumentSection>` — radio-group container dla payment instruments
- * w obrębie jednej method (np. lista bankow + BLIK code entry w BLIK method,
- * lista wallets + brand cards w CARD method). Renders jeden `<PaymentInstrumentTile>`
- * per item z keyboard nav (Arrow Up/Down, Home/End) + ARIA `role="radiogroup"`.
+ * `<PaymentInstrumentSection>` — radio-group container for the payment
+ * instruments within a single method (e.g. a bank list + BLIK code entry in a
+ * BLIK method, wallets + card brands in a CARD method). Renders one
+ * `<PaymentInstrumentTile>` per item with keyboard nav (Arrow Up/Down,
+ * Home/End) + ARIA `role="radiogroup"`.
  *
- * Headless — section + tiles bez własnego stylingu. Pass `sectionClassName`
- * dla layoutu (grid/flex), `tileClassName` dla per-tile styling, optional
- * `iconClassName`/`labelClassName` dla wewnętrznej struktury tile.
+ * Headless — section + tiles ship without any styling. Pass `sectionClassName`
+ * for the layout (grid/flex), `tileClassName` for per-tile styling, optional
+ * `iconClassName`/`labelClassName` for the tile's inner structure.
  *
- * Auto-group **nie jest** implementowane w tym sub-sprincie — backend już
- * zwraca instruments sorted (BLIK + wallets pierwsze → banks alpha → others)
- * z `availablePaymentMethods.methods[].instruments[]`. Komponent renderuje
- * w order'ze otrzymanym, bez własnej resort logic.
+ * Auto-grouping is **not** implemented — the backend already returns
+ * instruments sorted (BLIK + wallets first → banks alphabetically → others)
+ * in `availablePaymentMethods.methods[].instruments[]`. The component renders
+ * them in the order received, with no re-sorting logic of its own.
  *
  * @example
  * ```tsx
@@ -24,8 +25,6 @@
  *   tileClassName="rounded border p-3 data-[selected=true]:border-blue-500"
  * />
  * ```
- *
- * Added by payment-instrument-preselection-advanced sub-sprint Adv-2 Req 9.
  */
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -75,8 +74,9 @@ export function PaymentInstrumentSection({ method, selectedInstrumentCode, onSel
         return null;
     }
     return (_jsx("div", { ref: sectionRef, role: "radiogroup", "aria-label": ariaLabel, onKeyDown: handleKeyDown, className: sectionClassName, children: instruments.map((instrument) => {
-            // Cast to tile-projection shape — instruments[] z generated types ma więcej pól
-            // niż tile potrzebuje (provider, type), tile picks subset jawnie.
+            // Cast to the tile-projection shape — instruments[] from the generated
+            // types carries more fields than the tile needs (provider, type); the
+            // tile picks its subset explicitly.
             const tileInstrument = {
                 code: instrument.code,
                 displayName: instrument.displayName,

package/dist/react/components/PaymentInstrumentTile.d.ts

@@ -1,21 +1,22 @@
 /**
  * `<PaymentInstrumentTile>` — single payment instrument tile (BLIK code,
- * bank logo, wallet button, card brand). Headless — buyer-facing button
- * z accessibility wbudowanym (`role="radio"`, `aria-checked`, `aria-label`,
- * `data-instrument-code`, `data-display-hint`). Pass className per part
- * (button, icon, label) żeby zintegrować z Tailwind / CSS Modules /
- * styled-components — komponent nie ma własnego stylingu.
+ * bank logo, wallet button, card brand). Headless — a buyer-facing button
+ * with accessibility built in (`role="radio"`, `aria-checked`, `aria-label`,
+ * `data-instrument-code`, `data-display-hint`). Pass a className per part
+ * (button, icon, label) to integrate with Tailwind / CSS Modules /
+ * styled-components — the component has no styling of its own.
  *
- * `displayHint` dispatch — backend hint jak storefront powinien renderować
- * instrument. Komponent emituje hint jako `data-display-hint` attribute na
- * `<button>` żeby caller mógł stylizować przez CSS attribute selektory:
+ * `displayHint` dispatch — a backend hint describing how the storefront should
+ * render the instrument. The component emits the hint as a `data-display-hint`
+ * attribute on the `<button>` so the caller can style it through CSS attribute
+ * selectors:
  *
- *   - `BRANDED_TILE` — bank logo / wallet icon dominuje, label jako caption.
- *   - `PROMINENT_BUTTON` — duże CTA (BLIK code entry), brand image pominięty.
- *   - `RADIO_OPTION` — radio-list look, image (jeśli is) + label inline.
- *   - `DROPDOWN_OPTION` — text-only dla dropdown integration (caller wrap).
+ *   - `BRANDED_TILE` — bank logo / wallet icon dominates, label as a caption.
+ *   - `PROMINENT_BUTTON` — large CTA (BLIK code entry), brand image omitted.
+ *   - `RADIO_OPTION` — radio-list look, image (when present) + label inline.
+ *   - `DROPDOWN_OPTION` — text-only for dropdown integration (caller wraps it).
  *
- * Headless = no opinion. CSS styling decyduje, komponent tylko hint'uje.
+ * Headless = no opinion. CSS styling decides, the component only hints.
  *
  * @example
  * ```tsx
@@ -27,21 +28,19 @@
  *   labelClassName="font-semibold"
  * />
  * ```
- *
- * Added by payment-instrument-preselection-advanced sub-sprint Adv-2 Req 9.
  */
 import type { PaymentInstrument } from '../../core/generated/operation-types';
 /**
- * Minimalna projekcja `PaymentInstrument` używana przez tile. Caller może
- * pass pełny instrument z `availablePaymentMethods` query — extra pola
- * (provider, type) są ignorowane przez komponent (UI nie branchuje na
- * provider — gateway-agnostic, code + displayHint wystarczą).
+ * Minimal projection of `PaymentInstrument` used by the tile. The caller may
+ * pass a full instrument from the `availablePaymentMethods` query — extra
+ * fields (provider, type) are ignored by the component (the UI never branches
+ * on the provider — gateway-agnostic, code + displayHint are enough).
  */
 export type PaymentInstrumentTileInstrument = Pick<PaymentInstrument, 'code' | 'displayName' | 'displayHint' | 'enabled'> & Partial<Pick<PaymentInstrument, 'brandImage'>>;
 export interface PaymentInstrumentTileProps {
     /** Instrument projection — gateway code, label, display hint, enabled state. */
     instrument: PaymentInstrumentTileInstrument;
-    /** True gdy ten tile jest currently selected w parent section. Controls `aria-checked` + `data-selected`. */
+    /** True when this tile is currently selected in the parent section. Controls `aria-checked` + `data-selected`. */
     selected: boolean;
     /** Click handler — caller updates selected state external (controlled component). */
     onSelect: () => void;

package/dist/react/components/PaymentInstrumentTile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PaymentInstrumentTile.d.ts","sourceRoot":"","sources":["../../../src/react/components/PaymentInstrumentTile.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAChD,iBAAiB,EACjB,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CACnD,GACC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,UAAU,EAAE,+BAA+B,CAAC;IAC5C,6GAA6G;IAC7G,QAAQ,EAAE,OAAO,CAAC;IAClB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,GACf,EAAE,0BAA0B,2CAuB5B"}
+{"version":3,"file":"PaymentInstrumentTile.d.ts","sourceRoot":"","sources":["../../../src/react/components/PaymentInstrumentTile.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAChD,iBAAiB,EACjB,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CACnD,GACC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,UAAU,EAAE,+BAA+B,CAAC;IAC5C,kHAAkH;IAClH,QAAQ,EAAE,OAAO,CAAC;IAClB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,GACf,EAAE,0BAA0B,2CAuB5B"}