@namiml/sdk-core 3.4.12-dev.202609281806 → 3.4.12-dev.202609281859

package/dist/index.cjs

@@ -106,7 +106,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.12", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.12-dev.202609281806", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.12-dev.202609281859", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -7370,211 +7370,6 @@ async function timeoutRequest$1(url, options = {}, timeout) {
     return response;
 }
 
-function requirePlatformID(target, propertyKey, descriptor) {
-    const originalMethod = descriptor.value;
-    descriptor.value = function (...args) {
-        if (!this.platformID) {
-            throw new PlatformIDRequiredError();
-        }
-        return originalMethod.apply(this, args);
-    };
-    return descriptor;
-}
-function requireDeviceID(target, propertyKey, descriptor) {
-    const originalMethod = descriptor.value;
-    descriptor.value = function (...args) {
-        const device = storageService.getDevice();
-        if (!device?.id) {
-            throw new DeviceIDRequiredError();
-        }
-        return originalMethod.apply(this, args);
-    };
-    return descriptor;
-}
-
-class NamiAPI {
-    get deviceID() {
-        return storageService.getDevice()?.id;
-    }
-    constructor() {
-        const config = storageService.getNamiConfig();
-        if (!this.platformID && config) {
-            this.configure(config);
-        }
-    }
-    static configure(config) {
-        this.instance.configure(config);
-    }
-    configure(config) {
-        this.baseURL = getBaseUrl(config.namiCommands);
-        this.platformID = config.appPlatformID;
-    }
-    /**
-     * Clear cached baseURL and platformID so the next `configure()` call
-     * re-derives them from fresh storage. Called from `Nami.reset()`.
-     *
-     * Without this, the NamiAPI singleton holds the previous lifecycle's
-     * platform/base URL even after storage has been wiped — any in-flight
-     * or queued request after reset would hit the old endpoint.
-     */
-    static reset() {
-        this.instance.reset();
-    }
-    reset() {
-        this.baseURL = undefined;
-        this.platformID = undefined;
-    }
-    async login(externalId) {
-        if (!externalId) {
-            throw new ExternalIDRequiredError();
-        }
-        const path = `device/${this.deviceID}/login/`;
-        const data = { external_id: externalId };
-        return await this.requestBodyAPI(path, data, 'PUT');
-    }
-    async logout() {
-        const path = `device/${this.deviceID}/logout/`;
-        return await this.requestBodyAPI(path, {}, 'PUT');
-    }
-    async startSession(sessionStartTime) {
-        const path = `device/${this.deviceID}/session/`;
-        const resp = await this.requestBodyAPI(path, {
-            start_time: sessionStartTime,
-            app_env: "production",
-        });
-        storageService.setSessionCounter();
-        if (resp.id) {
-            storageService.setSessionId(resp.id);
-        }
-    }
-    async postImpression(options) {
-        const path = `device/${this.deviceID}/impression/`;
-        const resp = await this.requestBodyAPI(path, options, "POST", true);
-        if (resp.id) {
-            storageService.setLastImpressionId(resp.id);
-            // Notify the flow-completion engine (no-op unless a flow is open) so it
-            // can bind this impression to the current screen's completion context.
-            NamiAPI.impressionListener?.(resp.id);
-        }
-    }
-    /**
-     * Reports a flow completion result against a prior impression
-     * (NAM-1545 / Flow Completion Step). UPDATE-only on the server; the
-     * impression must already exist. `keepalive` so a dismiss-triggered PATCH
-     * survives page unload on web.
-     */
-    async patchImpressionCompletion(impressionId, completion_result, completion_result_date) {
-        const path = `device/${this.deviceID}/impression/${impressionId}/`;
-        await this.requestBodyAPI(path, { completion_result, completion_result_date }, "PATCH", true);
-    }
-    async postConversion(options) {
-        const path = `device/${this.deviceID}/transaction/`;
-        await this.requestBodyAPI(path, options, "POST", true);
-    }
-    async purchaseValidation(options) {
-        const path = `device/${this.deviceID}/purchase_event/`;
-        await this.requestBodyAPI(path, options, "PUT");
-    }
-    async fetchAPI(path, timeout, retries) {
-        const url = `${this.baseURL}/${this.platformID}/` + path;
-        return await withRetry(url, undefined, timeout, retries);
-    }
-    async requestBodyAPI(path, bodyData, method = "POST", keepalive = false, timeout, retries) {
-        const url = `${this.baseURL}/${this.platformID}/` + path;
-        const options = {
-            method,
-            headers: {
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify(bodyData),
-            keepalive,
-        };
-        return await withRetry(url, options, timeout, retries);
-    }
-}
-NamiAPI.instance = new NamiAPI();
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "login", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "logout", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "startSession", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "postImpression", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "patchImpressionCompletion", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "postConversion", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "purchaseValidation", null);
-__decorate([
-    requirePlatformID
-], NamiAPI.prototype, "fetchAPI", null);
-__decorate([
-    requirePlatformID
-], NamiAPI.prototype, "requestBodyAPI", null);
-
-function isNamiFlowCampaign(campaign) {
-    return campaign?.flow != null;
-}
-/**
- * @enum NamiCampaignRuleType
- * Types of Nami campaigns
- */
-exports.NamiCampaignRuleType = void 0;
-(function (NamiCampaignRuleType) {
-    NamiCampaignRuleType["DEFAULT"] = "default";
-    NamiCampaignRuleType["LABEL"] = "label";
-    NamiCampaignRuleType["UNKNOWN"] = "unknown";
-    NamiCampaignRuleType["URL"] = "url";
-})(exports.NamiCampaignRuleType || (exports.NamiCampaignRuleType = {}));
-// NamiCampaignManagerStatic interface + const proxy live in
-// `src/managers/campaign.ts`. They must stay out of this file: PaywallState
-// type-imports from here, and pulling in the manager class triggers a
-// constructor chain that runs before PaywallState finishes loading. See NAM-1207.
-
-/**
- * Get initial paywalls from storage service.
- * @returns An array of initial paywalls from storage service.
- */
-const getInitialPaywalls = () => {
-    return storageService.getPaywalls(exports.INITIAL_PAYWALLS) ?? [];
-};
-/**
- * Get all API paywalls from storage service.
- * @returns An array of API paywalls from storage service.
- */
-const getApiPaywalls = () => {
-    return storageService.getPaywalls(exports.API_PAYWALLS) ?? [];
-};
-/**
- * Get all paywalls from both API and Initial sources, ensuring uniqueness.
- * This function combines paywalls from both sources and filters out duplicates.
- * API Data takes precedence over Initial Data.
- *
- * @returns A combined list of unique paywalls based on both API and Initial data.
- */
-const allPaywalls = () => {
-    const paywalls = compact([...getApiPaywalls(), ...getInitialPaywalls()]);
-    return uniqBy(paywalls, "id");
-};
-const getPaywall = (paywallId) => {
-    const paywalls = allPaywalls();
-    return paywalls.find((paywall) => paywall.id === paywallId);
-};
-const hasAllPaywalls = (paywallIds) => {
-    const paywalls = allPaywalls();
-    const paywallIdSet = new Set(paywalls.map(p => p.id));
-    return paywallIds.every(id => paywallIdSet.has(id));
-};
-
 const globalScope = typeof globalThis !== 'undefined' ? globalThis :
     typeof self !== 'undefined' ? self :
         typeof global !== 'undefined' ? global :
@@ -7798,6 +7593,227 @@ function uuidFromSplitPosition(namiCommands) {
     return value && !isNaN(numericalValue) ? generateUuidForSplitPosition(numericalValue) : undefined;
 }
 
+function requirePlatformID(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = function (...args) {
+        if (!this.platformID) {
+            throw new PlatformIDRequiredError();
+        }
+        return originalMethod.apply(this, args);
+    };
+    return descriptor;
+}
+function requireDeviceID(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = function (...args) {
+        const device = storageService.getDevice();
+        if (!device?.id) {
+            throw new DeviceIDRequiredError();
+        }
+        return originalMethod.apply(this, args);
+    };
+    return descriptor;
+}
+
+class NamiAPI {
+    get deviceID() {
+        return storageService.getDevice()?.id;
+    }
+    constructor() {
+        const config = storageService.getNamiConfig();
+        if (!this.platformID && config) {
+            this.configure(config);
+        }
+    }
+    static configure(config) {
+        this.instance.configure(config);
+    }
+    configure(config) {
+        this.baseURL = getBaseUrl(config.namiCommands);
+        this.platformID = config.appPlatformID;
+    }
+    /**
+     * Clear cached baseURL and platformID so the next `configure()` call
+     * re-derives them from fresh storage. Called from `Nami.reset()`.
+     *
+     * Without this, the NamiAPI singleton holds the previous lifecycle's
+     * platform/base URL even after storage has been wiped — any in-flight
+     * or queued request after reset would hit the old endpoint.
+     */
+    static reset() {
+        this.instance.reset();
+    }
+    reset() {
+        this.baseURL = undefined;
+        this.platformID = undefined;
+    }
+    async login(externalId) {
+        if (!externalId) {
+            throw new ExternalIDRequiredError();
+        }
+        const path = `device/${this.deviceID}/login/`;
+        const data = { external_id: externalId };
+        return await this.requestBodyAPI(path, data, 'PUT');
+    }
+    async logout() {
+        const path = `device/${this.deviceID}/logout/`;
+        return await this.requestBodyAPI(path, {}, 'PUT');
+    }
+    async startSession(sessionStartTime) {
+        const path = `device/${this.deviceID}/session/`;
+        const resp = await this.requestBodyAPI(path, {
+            start_time: sessionStartTime,
+            app_env: "production",
+        });
+        storageService.setSessionCounter();
+        if (resp.id) {
+            storageService.setSessionId(resp.id);
+        }
+    }
+    async postImpression(options) {
+        const path = `device/${this.deviceID}/impression/`;
+        // Declare the id rather than taking it from the response. Three things depended on that
+        // response before NAM-4421:
+        //
+        // 1. Retries were not idempotent. `withRetry` re-sends on any non-ok response, so a backend
+        //    (or a proxy) that created the impression and then returned 5xx got a *second* impression
+        //    per retry — up to three rows for one page view, inflating the denominator of paywall
+        //    conversion rate.
+        // 2. Until the response landed, `getLastImpressionId()` still held the previous page's id, so
+        //    anything snapshotting in that window — including `setPurchaseImpression()` on a buy tap —
+        //    copied the wrong page.
+        // 3. When every retry failed, the id was never published at all, so storage kept the previous
+        //    page's id and purchases here were attributed to the page before this one.
+        const impressionId = options.id ?? generateUUID();
+        const body = {
+            ...options,
+            id: impressionId,
+            impression_date: options.impression_date ?? new Date().toISOString(),
+        };
+        storageService.setLastImpressionId(impressionId);
+        // Notify the flow-completion engine (no-op unless a flow is open) so it
+        // can bind this impression to the current screen's completion context.
+        NamiAPI.impressionListener?.(impressionId);
+        await this.requestBodyAPI(path, body, "POST", true);
+    }
+    /**
+     * Reports a flow completion result against a prior impression
+     * (NAM-1545 / Flow Completion Step). UPDATE-only on the server; the
+     * impression must already exist. `keepalive` so a dismiss-triggered PATCH
+     * survives page unload on web.
+     */
+    async patchImpressionCompletion(impressionId, completion_result, completion_result_date) {
+        const path = `device/${this.deviceID}/impression/${impressionId}/`;
+        await this.requestBodyAPI(path, { completion_result, completion_result_date }, "PATCH", true);
+    }
+    async postConversion(options) {
+        const path = `device/${this.deviceID}/transaction/`;
+        await this.requestBodyAPI(path, options, "POST", true);
+    }
+    async purchaseValidation(options) {
+        const path = `device/${this.deviceID}/purchase_event/`;
+        await this.requestBodyAPI(path, options, "PUT");
+    }
+    async fetchAPI(path, timeout, retries) {
+        const url = `${this.baseURL}/${this.platformID}/` + path;
+        return await withRetry(url, undefined, timeout, retries);
+    }
+    async requestBodyAPI(path, bodyData, method = "POST", keepalive = false, timeout, retries) {
+        const url = `${this.baseURL}/${this.platformID}/` + path;
+        const options = {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(bodyData),
+            keepalive,
+        };
+        return await withRetry(url, options, timeout, retries);
+    }
+}
+NamiAPI.instance = new NamiAPI();
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "login", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "logout", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "startSession", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "postImpression", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "patchImpressionCompletion", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "postConversion", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "purchaseValidation", null);
+__decorate([
+    requirePlatformID
+], NamiAPI.prototype, "fetchAPI", null);
+__decorate([
+    requirePlatformID
+], NamiAPI.prototype, "requestBodyAPI", null);
+
+function isNamiFlowCampaign(campaign) {
+    return campaign?.flow != null;
+}
+/**
+ * @enum NamiCampaignRuleType
+ * Types of Nami campaigns
+ */
+exports.NamiCampaignRuleType = void 0;
+(function (NamiCampaignRuleType) {
+    NamiCampaignRuleType["DEFAULT"] = "default";
+    NamiCampaignRuleType["LABEL"] = "label";
+    NamiCampaignRuleType["UNKNOWN"] = "unknown";
+    NamiCampaignRuleType["URL"] = "url";
+})(exports.NamiCampaignRuleType || (exports.NamiCampaignRuleType = {}));
+// NamiCampaignManagerStatic interface + const proxy live in
+// `src/managers/campaign.ts`. They must stay out of this file: PaywallState
+// type-imports from here, and pulling in the manager class triggers a
+// constructor chain that runs before PaywallState finishes loading. See NAM-1207.
+
+/**
+ * Get initial paywalls from storage service.
+ * @returns An array of initial paywalls from storage service.
+ */
+const getInitialPaywalls = () => {
+    return storageService.getPaywalls(exports.INITIAL_PAYWALLS) ?? [];
+};
+/**
+ * Get all API paywalls from storage service.
+ * @returns An array of API paywalls from storage service.
+ */
+const getApiPaywalls = () => {
+    return storageService.getPaywalls(exports.API_PAYWALLS) ?? [];
+};
+/**
+ * Get all paywalls from both API and Initial sources, ensuring uniqueness.
+ * This function combines paywalls from both sources and filters out duplicates.
+ * API Data takes precedence over Initial Data.
+ *
+ * @returns A combined list of unique paywalls based on both API and Initial data.
+ */
+const allPaywalls = () => {
+    const paywalls = compact([...getApiPaywalls(), ...getInitialPaywalls()]);
+    return uniqBy(paywalls, "id");
+};
+const getPaywall = (paywallId) => {
+    const paywalls = allPaywalls();
+    return paywalls.find((paywall) => paywall.id === paywallId);
+};
+const hasAllPaywalls = (paywallIds) => {
+    const paywalls = allPaywalls();
+    const paywallIdSet = new Set(paywalls.map(p => p.id));
+    return paywallIds.every(id => paywallIdSet.has(id));
+};
+
 const formatDistanceLocale$1j = {
   lessThanXSeconds: {
     one: "minder as 'n sekonde",

package/dist/index.d.ts

@@ -3153,6 +3153,12 @@ type Session = {
 };
 type Impression = {
     id?: string;
+    /**
+     * When the page was presented, as an ISO-8601 string. Distinct from when the request is sent:
+     * the POST is retried on failure, so arrival time would date a retried page view by its last
+     * attempt and file it in the wrong reporting period (NAM-4421 / NAM-4419).
+     */
+    impression_date?: string;
     session?: string;
     segment?: string;
     call_to_action?: string;

package/dist/index.mjs

@@ -104,7 +104,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.4.12", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.12-dev.202609281806", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.12-dev.202609281859", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -7368,211 +7368,6 @@ async function timeoutRequest$1(url, options = {}, timeout) {
     return response;
 }
 
-function requirePlatformID(target, propertyKey, descriptor) {
-    const originalMethod = descriptor.value;
-    descriptor.value = function (...args) {
-        if (!this.platformID) {
-            throw new PlatformIDRequiredError();
-        }
-        return originalMethod.apply(this, args);
-    };
-    return descriptor;
-}
-function requireDeviceID(target, propertyKey, descriptor) {
-    const originalMethod = descriptor.value;
-    descriptor.value = function (...args) {
-        const device = storageService.getDevice();
-        if (!device?.id) {
-            throw new DeviceIDRequiredError();
-        }
-        return originalMethod.apply(this, args);
-    };
-    return descriptor;
-}
-
-class NamiAPI {
-    get deviceID() {
-        return storageService.getDevice()?.id;
-    }
-    constructor() {
-        const config = storageService.getNamiConfig();
-        if (!this.platformID && config) {
-            this.configure(config);
-        }
-    }
-    static configure(config) {
-        this.instance.configure(config);
-    }
-    configure(config) {
-        this.baseURL = getBaseUrl(config.namiCommands);
-        this.platformID = config.appPlatformID;
-    }
-    /**
-     * Clear cached baseURL and platformID so the next `configure()` call
-     * re-derives them from fresh storage. Called from `Nami.reset()`.
-     *
-     * Without this, the NamiAPI singleton holds the previous lifecycle's
-     * platform/base URL even after storage has been wiped — any in-flight
-     * or queued request after reset would hit the old endpoint.
-     */
-    static reset() {
-        this.instance.reset();
-    }
-    reset() {
-        this.baseURL = undefined;
-        this.platformID = undefined;
-    }
-    async login(externalId) {
-        if (!externalId) {
-            throw new ExternalIDRequiredError();
-        }
-        const path = `device/${this.deviceID}/login/`;
-        const data = { external_id: externalId };
-        return await this.requestBodyAPI(path, data, 'PUT');
-    }
-    async logout() {
-        const path = `device/${this.deviceID}/logout/`;
-        return await this.requestBodyAPI(path, {}, 'PUT');
-    }
-    async startSession(sessionStartTime) {
-        const path = `device/${this.deviceID}/session/`;
-        const resp = await this.requestBodyAPI(path, {
-            start_time: sessionStartTime,
-            app_env: "production",
-        });
-        storageService.setSessionCounter();
-        if (resp.id) {
-            storageService.setSessionId(resp.id);
-        }
-    }
-    async postImpression(options) {
-        const path = `device/${this.deviceID}/impression/`;
-        const resp = await this.requestBodyAPI(path, options, "POST", true);
-        if (resp.id) {
-            storageService.setLastImpressionId(resp.id);
-            // Notify the flow-completion engine (no-op unless a flow is open) so it
-            // can bind this impression to the current screen's completion context.
-            NamiAPI.impressionListener?.(resp.id);
-        }
-    }
-    /**
-     * Reports a flow completion result against a prior impression
-     * (NAM-1545 / Flow Completion Step). UPDATE-only on the server; the
-     * impression must already exist. `keepalive` so a dismiss-triggered PATCH
-     * survives page unload on web.
-     */
-    async patchImpressionCompletion(impressionId, completion_result, completion_result_date) {
-        const path = `device/${this.deviceID}/impression/${impressionId}/`;
-        await this.requestBodyAPI(path, { completion_result, completion_result_date }, "PATCH", true);
-    }
-    async postConversion(options) {
-        const path = `device/${this.deviceID}/transaction/`;
-        await this.requestBodyAPI(path, options, "POST", true);
-    }
-    async purchaseValidation(options) {
-        const path = `device/${this.deviceID}/purchase_event/`;
-        await this.requestBodyAPI(path, options, "PUT");
-    }
-    async fetchAPI(path, timeout, retries) {
-        const url = `${this.baseURL}/${this.platformID}/` + path;
-        return await withRetry(url, undefined, timeout, retries);
-    }
-    async requestBodyAPI(path, bodyData, method = "POST", keepalive = false, timeout, retries) {
-        const url = `${this.baseURL}/${this.platformID}/` + path;
-        const options = {
-            method,
-            headers: {
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify(bodyData),
-            keepalive,
-        };
-        return await withRetry(url, options, timeout, retries);
-    }
-}
-NamiAPI.instance = new NamiAPI();
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "login", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "logout", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "startSession", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "postImpression", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "patchImpressionCompletion", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "postConversion", null);
-__decorate([
-    requireDeviceID
-], NamiAPI.prototype, "purchaseValidation", null);
-__decorate([
-    requirePlatformID
-], NamiAPI.prototype, "fetchAPI", null);
-__decorate([
-    requirePlatformID
-], NamiAPI.prototype, "requestBodyAPI", null);
-
-function isNamiFlowCampaign(campaign) {
-    return campaign?.flow != null;
-}
-/**
- * @enum NamiCampaignRuleType
- * Types of Nami campaigns
- */
-var NamiCampaignRuleType;
-(function (NamiCampaignRuleType) {
-    NamiCampaignRuleType["DEFAULT"] = "default";
-    NamiCampaignRuleType["LABEL"] = "label";
-    NamiCampaignRuleType["UNKNOWN"] = "unknown";
-    NamiCampaignRuleType["URL"] = "url";
-})(NamiCampaignRuleType || (NamiCampaignRuleType = {}));
-// NamiCampaignManagerStatic interface + const proxy live in
-// `src/managers/campaign.ts`. They must stay out of this file: PaywallState
-// type-imports from here, and pulling in the manager class triggers a
-// constructor chain that runs before PaywallState finishes loading. See NAM-1207.
-
-/**
- * Get initial paywalls from storage service.
- * @returns An array of initial paywalls from storage service.
- */
-const getInitialPaywalls = () => {
-    return storageService.getPaywalls(INITIAL_PAYWALLS) ?? [];
-};
-/**
- * Get all API paywalls from storage service.
- * @returns An array of API paywalls from storage service.
- */
-const getApiPaywalls = () => {
-    return storageService.getPaywalls(API_PAYWALLS) ?? [];
-};
-/**
- * Get all paywalls from both API and Initial sources, ensuring uniqueness.
- * This function combines paywalls from both sources and filters out duplicates.
- * API Data takes precedence over Initial Data.
- *
- * @returns A combined list of unique paywalls based on both API and Initial data.
- */
-const allPaywalls = () => {
-    const paywalls = compact([...getApiPaywalls(), ...getInitialPaywalls()]);
-    return uniqBy(paywalls, "id");
-};
-const getPaywall = (paywallId) => {
-    const paywalls = allPaywalls();
-    return paywalls.find((paywall) => paywall.id === paywallId);
-};
-const hasAllPaywalls = (paywallIds) => {
-    const paywalls = allPaywalls();
-    const paywallIdSet = new Set(paywalls.map(p => p.id));
-    return paywallIds.every(id => paywallIdSet.has(id));
-};
-
 const globalScope = typeof globalThis !== 'undefined' ? globalThis :
     typeof self !== 'undefined' ? self :
         typeof global !== 'undefined' ? global :
@@ -7796,6 +7591,227 @@ function uuidFromSplitPosition(namiCommands) {
     return value && !isNaN(numericalValue) ? generateUuidForSplitPosition(numericalValue) : undefined;
 }
 
+function requirePlatformID(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = function (...args) {
+        if (!this.platformID) {
+            throw new PlatformIDRequiredError();
+        }
+        return originalMethod.apply(this, args);
+    };
+    return descriptor;
+}
+function requireDeviceID(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = function (...args) {
+        const device = storageService.getDevice();
+        if (!device?.id) {
+            throw new DeviceIDRequiredError();
+        }
+        return originalMethod.apply(this, args);
+    };
+    return descriptor;
+}
+
+class NamiAPI {
+    get deviceID() {
+        return storageService.getDevice()?.id;
+    }
+    constructor() {
+        const config = storageService.getNamiConfig();
+        if (!this.platformID && config) {
+            this.configure(config);
+        }
+    }
+    static configure(config) {
+        this.instance.configure(config);
+    }
+    configure(config) {
+        this.baseURL = getBaseUrl(config.namiCommands);
+        this.platformID = config.appPlatformID;
+    }
+    /**
+     * Clear cached baseURL and platformID so the next `configure()` call
+     * re-derives them from fresh storage. Called from `Nami.reset()`.
+     *
+     * Without this, the NamiAPI singleton holds the previous lifecycle's
+     * platform/base URL even after storage has been wiped — any in-flight
+     * or queued request after reset would hit the old endpoint.
+     */
+    static reset() {
+        this.instance.reset();
+    }
+    reset() {
+        this.baseURL = undefined;
+        this.platformID = undefined;
+    }
+    async login(externalId) {
+        if (!externalId) {
+            throw new ExternalIDRequiredError();
+        }
+        const path = `device/${this.deviceID}/login/`;
+        const data = { external_id: externalId };
+        return await this.requestBodyAPI(path, data, 'PUT');
+    }
+    async logout() {
+        const path = `device/${this.deviceID}/logout/`;
+        return await this.requestBodyAPI(path, {}, 'PUT');
+    }
+    async startSession(sessionStartTime) {
+        const path = `device/${this.deviceID}/session/`;
+        const resp = await this.requestBodyAPI(path, {
+            start_time: sessionStartTime,
+            app_env: "production",
+        });
+        storageService.setSessionCounter();
+        if (resp.id) {
+            storageService.setSessionId(resp.id);
+        }
+    }
+    async postImpression(options) {
+        const path = `device/${this.deviceID}/impression/`;
+        // Declare the id rather than taking it from the response. Three things depended on that
+        // response before NAM-4421:
+        //
+        // 1. Retries were not idempotent. `withRetry` re-sends on any non-ok response, so a backend
+        //    (or a proxy) that created the impression and then returned 5xx got a *second* impression
+        //    per retry — up to three rows for one page view, inflating the denominator of paywall
+        //    conversion rate.
+        // 2. Until the response landed, `getLastImpressionId()` still held the previous page's id, so
+        //    anything snapshotting in that window — including `setPurchaseImpression()` on a buy tap —
+        //    copied the wrong page.
+        // 3. When every retry failed, the id was never published at all, so storage kept the previous
+        //    page's id and purchases here were attributed to the page before this one.
+        const impressionId = options.id ?? generateUUID();
+        const body = {
+            ...options,
+            id: impressionId,
+            impression_date: options.impression_date ?? new Date().toISOString(),
+        };
+        storageService.setLastImpressionId(impressionId);
+        // Notify the flow-completion engine (no-op unless a flow is open) so it
+        // can bind this impression to the current screen's completion context.
+        NamiAPI.impressionListener?.(impressionId);
+        await this.requestBodyAPI(path, body, "POST", true);
+    }
+    /**
+     * Reports a flow completion result against a prior impression
+     * (NAM-1545 / Flow Completion Step). UPDATE-only on the server; the
+     * impression must already exist. `keepalive` so a dismiss-triggered PATCH
+     * survives page unload on web.
+     */
+    async patchImpressionCompletion(impressionId, completion_result, completion_result_date) {
+        const path = `device/${this.deviceID}/impression/${impressionId}/`;
+        await this.requestBodyAPI(path, { completion_result, completion_result_date }, "PATCH", true);
+    }
+    async postConversion(options) {
+        const path = `device/${this.deviceID}/transaction/`;
+        await this.requestBodyAPI(path, options, "POST", true);
+    }
+    async purchaseValidation(options) {
+        const path = `device/${this.deviceID}/purchase_event/`;
+        await this.requestBodyAPI(path, options, "PUT");
+    }
+    async fetchAPI(path, timeout, retries) {
+        const url = `${this.baseURL}/${this.platformID}/` + path;
+        return await withRetry(url, undefined, timeout, retries);
+    }
+    async requestBodyAPI(path, bodyData, method = "POST", keepalive = false, timeout, retries) {
+        const url = `${this.baseURL}/${this.platformID}/` + path;
+        const options = {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(bodyData),
+            keepalive,
+        };
+        return await withRetry(url, options, timeout, retries);
+    }
+}
+NamiAPI.instance = new NamiAPI();
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "login", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "logout", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "startSession", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "postImpression", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "patchImpressionCompletion", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "postConversion", null);
+__decorate([
+    requireDeviceID
+], NamiAPI.prototype, "purchaseValidation", null);
+__decorate([
+    requirePlatformID
+], NamiAPI.prototype, "fetchAPI", null);
+__decorate([
+    requirePlatformID
+], NamiAPI.prototype, "requestBodyAPI", null);
+
+function isNamiFlowCampaign(campaign) {
+    return campaign?.flow != null;
+}
+/**
+ * @enum NamiCampaignRuleType
+ * Types of Nami campaigns
+ */
+var NamiCampaignRuleType;
+(function (NamiCampaignRuleType) {
+    NamiCampaignRuleType["DEFAULT"] = "default";
+    NamiCampaignRuleType["LABEL"] = "label";
+    NamiCampaignRuleType["UNKNOWN"] = "unknown";
+    NamiCampaignRuleType["URL"] = "url";
+})(NamiCampaignRuleType || (NamiCampaignRuleType = {}));
+// NamiCampaignManagerStatic interface + const proxy live in
+// `src/managers/campaign.ts`. They must stay out of this file: PaywallState
+// type-imports from here, and pulling in the manager class triggers a
+// constructor chain that runs before PaywallState finishes loading. See NAM-1207.
+
+/**
+ * Get initial paywalls from storage service.
+ * @returns An array of initial paywalls from storage service.
+ */
+const getInitialPaywalls = () => {
+    return storageService.getPaywalls(INITIAL_PAYWALLS) ?? [];
+};
+/**
+ * Get all API paywalls from storage service.
+ * @returns An array of API paywalls from storage service.
+ */
+const getApiPaywalls = () => {
+    return storageService.getPaywalls(API_PAYWALLS) ?? [];
+};
+/**
+ * Get all paywalls from both API and Initial sources, ensuring uniqueness.
+ * This function combines paywalls from both sources and filters out duplicates.
+ * API Data takes precedence over Initial Data.
+ *
+ * @returns A combined list of unique paywalls based on both API and Initial data.
+ */
+const allPaywalls = () => {
+    const paywalls = compact([...getApiPaywalls(), ...getInitialPaywalls()]);
+    return uniqBy(paywalls, "id");
+};
+const getPaywall = (paywallId) => {
+    const paywalls = allPaywalls();
+    return paywalls.find((paywall) => paywall.id === paywallId);
+};
+const hasAllPaywalls = (paywallIds) => {
+    const paywalls = allPaywalls();
+    const paywallIdSet = new Set(paywalls.map(p => p.id));
+    return paywallIds.every(id => paywallIdSet.has(id));
+};
+
 const formatDistanceLocale$1j = {
   lessThanXSeconds: {
     one: "minder as 'n sekonde",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namiml/sdk-core",
-  "version": "3.4.12-dev.202609281806",
+  "version": "3.4.12-dev.202609281859",
   "description": "Platform-agnostic core for the Nami SDK — business logic, API, types, and state management",
   "type": "module",
   "main": "./dist/index.cjs",