@namiml/web-sdk 1.6.0 → 1.6.2

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.6.2 (July 28, 2025)
+
+### New Features
+- **Nami.sdkVersion** - Method to get the internal SDK version
+- Added support for QR Code components
+- On Device Segment Selection for A/B testing
+- Support Base64, Gzipped Initial Configurations
+- Support Fully Uppercase Text Components
+
+### Enhancements
+- Paywall actions will now trigger if no flow action for a button is defined
+
+### Bug Fixes
+- Dynamic widths on Responsive Grid components
+
+## 1.6.1 (July 13, 2025)
+
+### Improvements
+- Fix type exports in declaration files
+
 ## 1.6.0 (July 10, 2025)
 
 ### New Features

package/dist/components/ContextProvider.d.ts

@@ -5,7 +5,7 @@ import { NamiSKU } from '../types/externals/sku';
 import { NamiCampaign } from '../types/externals/campaign';
 import { TDevice } from '../types/device';
 import { Callback } from '../types/components/containers';
-import type { NamiFlow } from 'src/nami/flow/NamiFlow';
+import type { NamiFlow } from '../nami/flow/NamiFlow';
 export declare const initialState: TPaywallContext;
 declare class ContextProvider extends EventTarget implements ReactiveController {
     host: ReactiveControllerHost | null;

package/dist/components/Paywall.d.ts

@@ -3,7 +3,7 @@ import { NamiElement } from './NamiElement';
 import { PropertyValues, TemplateResult } from 'lit';
 import { NamiCampaign } from '../types/externals/campaign';
 import { NamiPaywallEvent } from '../types/externals/paywall';
-import type { NamiFlow } from 'src/nami/flow/NamiFlow';
+import type { NamiFlow } from '../nami/flow/NamiFlow';
 declare class PaywallComponent extends NamiElement {
     campaign: NamiCampaign | undefined;
     paywall: IPaywall | undefined;

package/dist/components/elements/QRCode.d.ts

@@ -0,0 +1,9 @@
+import { NamiElement } from "../NamiElement";
+import { TQRCodeComponent } from "../../types/components/elements";
+export declare class NamiQRCode extends NamiElement {
+    component: TQRCodeComponent;
+    protected styles(): import("lit").CSSResult;
+    private renderQr;
+    firstUpdated(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}

package/dist/components/index.d.ts

@@ -17,6 +17,7 @@ import { NamiCarouselContainer } from "./containers/CarouselContainer";
 import { NamiVolumeButton } from "./elements/VolumeButton";
 import { NamiPlayPauseButton } from "./elements/PlayPauseButton";
 import { NamiStack } from "./elements/Stack";
+import { NamiQRCode } from "./elements/QRCode";
 declare global {
     interface HTMLElementTagNameMap {
         "nami-spacer": NamiSpacer;
@@ -39,6 +40,7 @@ declare global {
         "nami-volume-button": NamiVolumeButton;
         "nami-play-pause-button": NamiPlayPauseButton;
         "nami-stack": NamiStack;
+        "nami-qr-code": NamiQRCode;
     }
 }
-export { NamiSpacer, NamiButton, NamiHeader, NamiFooter, NamiText, NamiSegmentPicker, NamiSegmentPickerItem, NamiContainer, NamiProductContainer, NamiImage, NamiBackgroundContainer, NamiContentContainer, NamiSymbol, NamiVideo, NamiCollapseContainer, NamiResponsiveGrid, NamiCarouselContainer, NamiPlayPauseButton, NamiVolumeButton, NamiStack };
+export { NamiSpacer, NamiButton, NamiHeader, NamiFooter, NamiText, NamiSegmentPicker, NamiSegmentPickerItem, NamiContainer, NamiProductContainer, NamiImage, NamiBackgroundContainer, NamiContentContainer, NamiSymbol, NamiVideo, NamiCollapseContainer, NamiResponsiveGrid, NamiCarouselContainer, NamiPlayPauseButton, NamiVolumeButton, NamiStack, NamiQRCode, };

package/dist/components/utils/actionTap.d.ts

@@ -15,3 +15,4 @@ export declare const setState: () => {
 export declare const selectSKU: (sku: NamiSKU) => void;
 export declare const purchaseSelectedSKU: (sku: NamiSKU) => void;
 export declare const reloadProducts: () => void;
+export declare function shouldHoist(onTap?: UserAction): boolean;

package/dist/components/utils/state.d.ts

@@ -2,7 +2,7 @@ import { ISkuMenu, TInitialState } from "../../types/paywall";
 import { NamiProductDetails } from "../../types/externals/product";
 import { PaywallSKU } from "../../types/sku";
 import { NamiPaywallLaunchContext } from "../../nami-web";
-import { TCarouselSlide } from "src/types/components/containers";
+import { TCarouselSlide } from "../../types/components/containers";
 export declare function currentSku(productDetails: NamiProductDetails[], initialState: TInitialState, skuMenus: ISkuMenu[], skus: PaywallSKU[]): {
     [key: string]: any;
 };

package/dist/components/utils/styles.d.ts

@@ -1,4 +1,4 @@
-import { TCarouselContainer } from "src/types/components/containers";
+import { TCarouselContainer } from "../../types/components/containers";
 import { TBaseComponent, TContainerPosition } from "../../types/components";
 import { TSegmentPickerItem, TTextLikeComponent } from "../../types/components/elements";
 export declare function parseSize(value: string | number, scaleFactor: number): string;

package/dist/core/errors.d.ts

@@ -3,6 +3,12 @@ export declare class RetryLimitExceededError extends Error {
     status: number;
     constructor(statusCode: number, message: string);
 }
+export declare class APIError extends Error {
+}
+export declare class ConflictError extends APIError {
+    status: number;
+    constructor();
+}
 export declare class SDKNotInitializedError extends Error {
     constructor();
 }
@@ -33,17 +39,17 @@ export declare class AnonymousLoginError extends Error {
 export declare class AnonymousCDPError extends Error {
     constructor();
 }
-export declare class BadRequestError extends Error {
+export declare class BadRequestError extends APIError {
     constructor(message: string);
 }
-export declare class NotFoundError extends Error {
+export declare class NotFoundError extends APIError {
     constructor(message: string);
 }
-export declare class ClientError extends Error {
+export declare class ClientError extends APIError {
     statusCode: number;
     constructor(statusCode: number, message: string);
 }
-export declare class InternalServerError extends Error {
+export declare class InternalServerError extends APIError {
     constructor(message: string);
 }
 export declare const handleErrors: (status: number, path: string) => void;

package/dist/nami/api.d.ts

@@ -15,6 +15,6 @@ export declare class NamiAPI {
     postImpression(options: Impression): Promise<void>;
     postConversion(options: TransactionRequest): Promise<void>;
     purchaseValidation(options: PurchaseValidationRequest): Promise<void>;
-    fetchAPI<T>(path: string): Promise<T>;
-    requestBodyAPI<T, U>(path: string, bodyData: T, method?: string, keepalive?: boolean, timeout?: number): Promise<U>;
+    fetchAPI<T>(path: string, timeout?: number, retries?: number): Promise<T>;
+    requestBodyAPI<T, U>(path: string, bodyData: T, method?: string, keepalive?: boolean, timeout?: number, retries?: number): Promise<U>;
 }

package/dist/nami/customer.d.ts

@@ -10,6 +10,7 @@ type AccountStateHandler = (action: AccountStateAction, success: boolean, error?
 export declare class NamiCustomerManager {
     static instance: NamiCustomerManager;
     private emitter;
+    constructor();
     /**
      * Checks if the customer is logged in.
      *

package/dist/nami/flow/NamiFlow.d.ts

@@ -1,9 +1,9 @@
-import type { NamiFlowObjectDTO, NamiFlowStep } from "src/types/flow";
-import type { NamiCampaign, NamiFlowCampaign } from 'src/types/externals/campaign';
-import type { NamiPaywallLaunchContext } from 'src/types/externals/paywall';
-import type { PaywallComponent } from "src/components/Paywall";
+import type { NamiFlowObjectDTO, NamiFlowOn, NamiFlowStep } from "../../types/flow";
+import type { NamiCampaign, NamiFlowCampaign } from '../../types/externals/campaign';
+import type { NamiPaywallLaunchContext } from '../../types/externals/paywall';
+import type { PaywallComponent } from "../../components/Paywall";
 import type { NamiFlowManager } from "./NamiFlowManager";
-import type { NamiButton } from "src/components";
+import type { NamiButton } from "../../components";
 export declare class BasicNamiFlow implements NamiFlowObjectDTO {
     id: string;
     name: string;
@@ -28,7 +28,7 @@ export declare class NamiFlow extends BasicNamiFlow {
     manager: NamiFlowManager;
     currentButton?: NamiButton;
     constructor(campaign: NamiFlowCampaign, paywall: PaywallComponent, manager: NamiFlowManager, context?: NamiPaywallLaunchContext);
-    setupFlowEntry(): void;
+    private registerResolvers;
     get currentFlowStep(): NamiFlowStep | undefined;
     get nextStepAvailable(): boolean;
     get previousStepAvailable(): boolean;
@@ -41,7 +41,12 @@ export declare class NamiFlow extends BasicNamiFlow {
     private backToPreviousScreenStep;
     forward(stepId: string): void;
     executeLifecycle(step: NamiFlowStep, key: string): void;
-    triggerActions(actionId: string, button?: NamiButton): void;
+    private lifecycles;
+    triggerActions(actionId: string, component?: NamiButton): void;
+    executeFullLifecycles(lifecycles: NamiFlowOn[]): void;
+    triggerBeforeActions(actionId: string, component?: NamiButton): void;
+    triggerAfterActions(actionId: string, component?: NamiButton): void;
+    currentStepHasHoistedPrimaryActions(actionId: string): boolean;
     private shouldRun;
     private performAction;
     private nextStep;

package/dist/nami/flow/NamiFlowManager.d.ts

@@ -1,8 +1,8 @@
-import type { NamiFlowEventHandler, NamiFlowHandoffStepHandler } from "src/types/flow";
+import type { NamiFlowEventHandler, NamiFlowHandoffStepHandler } from "../../types/flow";
 import { NamiFlow } from "./NamiFlow";
-import type { NamiFlowCampaign } from 'src/types/externals/campaign';
-import { NamiPaywallLaunchContext } from 'src/types/externals/paywall';
-import { PaywallComponent } from "src/components/Paywall";
+import type { NamiFlowCampaign } from '../../types/externals/campaign';
+import { NamiPaywallLaunchContext } from '../../types/externals/paywall';
+import { PaywallComponent } from "../../components/Paywall";
 export declare class NamiFlowManager {
     private static _instance;
     static get instance(): NamiFlowManager;
@@ -15,4 +15,6 @@ export declare class NamiFlowManager {
     static registerEventHandler(eventHandler: NamiFlowEventHandler): void;
     static resume(): void;
     presentFlow(campaign: NamiFlowCampaign, paywall: PaywallComponent, context?: NamiPaywallLaunchContext): NamiFlow;
+    static finish(): void;
+    static isFlowOpen(): boolean;
 }

package/dist/nami/index.d.ts

@@ -4,6 +4,7 @@ export declare class Nami {
     #private;
     static instance: Nami;
     get isInitialized(): boolean;
+    static sdkVersion(): string;
     /**
      * Configures and initializes the SDK.
      * This method must be called as the first thing before interacting with the SDK.

package/dist/nami/utils/campaign.d.ts

@@ -1,6 +1,9 @@
-import { NamiCampaign } from "../../types/externals/campaign";
+import { NamiAnonymousCampaign, NamiCampaign, NamiCampaignSegment } from "../../types/externals/campaign";
 import { IPaywall } from "../../types/paywall";
+import type { TDevice } from '../../types/device';
 export declare const isValidUrl: (label: string) => boolean;
+export declare const selectSegment: (segments: NamiCampaignSegment[], splitPosition: number) => NamiCampaignSegment;
+export declare const mapAnonymousCampaigns: (campaigns: NamiAnonymousCampaign[], splitPosition: number, formFactor?: TDevice) => NamiCampaign[];
 export declare const allCampaigns: () => NamiCampaign[];
 export declare const getPaywallDataFromLabel: (value: string, type?: string) => {
     campaign: NamiCampaign | undefined;

package/dist/nami/utils/resolvers/ConditionalEvaluator.d.ts

@@ -1,4 +1,4 @@
-import { NamiConditions } from "src/types/conditions";
+import { NamiConditions } from "../../../types/conditions";
 type Resolver = (identifier: string) => any;
 export declare class NamiConditionEvaluator {
     private static instance;

package/dist/nami/utils/resolvers/FlowLiquidResolver.d.ts

@@ -1,4 +1,4 @@
-import type { NamiFlowManager } from "src/nami/flow/NamiFlowManager";
+import type { NamiFlowManager } from "../../../nami/flow/NamiFlowManager";
 /**
  * Resolver for liquid-style flow variables, without requiring namespace prefixes.
  * We drop BaseNamespaceResolver since we don't need namespace registration or stripping.

package/dist/nami/utils/resolvers/LaunchContextResolver.d.ts

@@ -1,4 +1,4 @@
-import { NamiPaywallLaunchContext } from "src/nami-web";
+import { NamiPaywallLaunchContext } from "../../../nami-web";
 import { BaseNamespaceResolver } from "./BaseNameSpaceResolver";
 export declare class LaunchContextResolver extends BaseNamespaceResolver {
     protected readonly namespace = "LaunchContext";