bitsnap-react 1.18.0 → 1.19.0

package/dist/widgets-BVOSj9fU.d.ts

@@ -0,0 +1,547 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { L as LocaleTables } from './texts-9kfgClsA.js';
+
+/**
+ * Buyer side of the Bitsnap chat service (`bitsnap-messaging`): the shapes
+ * the library works with. The wire is snake_case JSON; `client.ts` maps it to
+ * these camelCase types. Times are ISO 8601 strings, `null` when absent.
+ */
+/** Default base URL of the chat service. */
+declare const DEFAULT_CHAT_API_URL = "https://chat.bitsnap.pl";
+/** Default NATS WebSocket URL, used when the realtime token lists no server. */
+declare const DEFAULT_CHAT_REALTIME_URL = "wss://bitsnap-nats-queue-production.up.railway.app";
+/** One paid order that gives a pack thread creator replies. */
+type ChatPack = {
+    orderId: string;
+    productId?: string;
+    replies: number;
+    used: number;
+    left: number;
+    expiresAt: string | null;
+    expired: boolean;
+};
+/** A stored message, or the pending answer of a send. */
+type ChatMessage = {
+    id: string;
+    threadId: string;
+    authorEmail: string;
+    body: string;
+    attachmentKey?: string;
+    attachmentKind?: string;
+    createdAt: string;
+    pinned: boolean;
+    /** Soft deleted: the body is empty. */
+    deleted: boolean;
+    /** A message of the service, such as the creator's away notice. */
+    system: boolean;
+    /** `"pending"` in the answer of a send: queued, not stored yet. */
+    status?: "pending";
+};
+/** The state of a conversation for the caller (`ThreadView` on the wire). */
+type ChatThreadSummary = {
+    id: string;
+    kind: "pack" | "channel";
+    channelId?: string;
+    /** For a buyer, the creator's e-mail (pack) or the channel name. */
+    title: string;
+    lastMessage?: ChatMessage;
+    unread: number;
+    repliesTotal: number;
+    repliesUsed: number;
+    repliesLeft: number;
+    expiresAt: string | null;
+    /** The caller cannot write: every pack has expired. */
+    composerLocked: boolean;
+    productId?: string;
+    /** The creator's promise in hours ("odpowiedź w ciągu 48 h"), 0 for none. */
+    responseHours: number;
+    packs: ChatPack[];
+    muted: boolean;
+};
+/** A channel the caller may read. */
+type ChatChannelSummary = {
+    id: string;
+    name: string;
+    topic: string;
+    welcome: string;
+    whoCanPost: "creator" | "members";
+    productId: string;
+    /** `creator`, `member` or `muted`. */
+    role: string;
+    memberCount: number;
+    createdAt: string;
+    blockLinks: boolean;
+    blockMedia: boolean;
+    cooldownSeconds: number;
+};
+/** A pack the buyer holds and has not opened a thread for yet. */
+type ChatPackEntitlement = {
+    productId: string;
+    name: string;
+    repliesLeftHint: number;
+    expiresAt: string | null;
+};
+/** A community product the buyer holds; `channelId` once a channel is bound. */
+type ChatChannelEntitlement = {
+    productId: string;
+    channelId?: string;
+};
+/** `GET /v1/me`: the buyer's chat in one project. */
+type ChatMe = {
+    email: string;
+    threads: ChatThreadSummary[];
+    entitlements: {
+        packs: ChatPackEntitlement[];
+        channels: ChatChannelEntitlement[];
+    };
+    channels: ChatChannelSummary[];
+};
+/** One page of history, newest first as the service answers it. */
+type ChatMessagePage = {
+    messages: ChatMessage[];
+    hasMore: boolean;
+};
+/** The thread part of a send answer. */
+type ChatThreadState = Pick<ChatThreadSummary, "id" | "kind" | "repliesTotal" | "repliesUsed" | "repliesLeft" | "expiresAt" | "composerLocked" | "responseHours">;
+/** `POST /v1/threads/{id}/messages` answers 202 with the queued message. */
+type ChatSendResult = {
+    message: ChatMessage;
+    thread: ChatThreadState;
+};
+type ChatReportReason = "spam" | "abuse" | "illegal" | "other";
+/** `POST /v1/realtime/token`. */
+type ChatRealtimeToken = {
+    jwt: string;
+    expiresAt: string;
+    servers: string[];
+    subjects: string[];
+    truncated: boolean;
+};
+/** Live events on the thread or channel subject. */
+type ChatRealtimeEvent = {
+    type: "message.created";
+    message: ChatMessage;
+} | {
+    type: "message.rejected";
+    id: string;
+    reason: string;
+} | {
+    type: "message.deleted";
+    id: string;
+} | {
+    type: "message.pinned";
+    id: string;
+} | {
+    type: "message.unpinned";
+    id: string;
+};
+/** How a conversation hears about new messages. */
+type ChatLiveMode = "connecting" | "live" | "polling" | "off";
+
+/**
+ * An error answer of the chat service (`{"error":"<code>"}`), or `network`
+ * (status 0) when the request did not get an answer.
+ *
+ * Codes the buyer UI handles: `unauthorized` (401), `plan_required`,
+ * `locked`, `muted`, `blocked`, `forbidden`, `read_only` (403), `not_found`
+ * (404), `moderation_link`, `moderation_banned_word`, `moderation_media`
+ * (422), `cooldown` (429, with `retryAfter`), `unavailable` (503),
+ * `invalid_project` (400).
+ */
+declare class ChatError extends Error {
+    readonly code: string;
+    readonly status: number;
+    /** `cooldown`: seconds to wait before the next post. */
+    readonly retryAfter?: number;
+    /** Extra fields of the answer (`locked`: `product_id`, `price_cents`, `welcome`). */
+    readonly data: Record<string, unknown>;
+    constructor(code: string, status: number, data?: Record<string, unknown>);
+}
+type ChatClientOptions = {
+    /** Project id sent as `X-Bitsnap-Project`. */
+    projectId: string;
+    /** Bearer credential: the panel session token or a `bcht_` buyer token. */
+    token: string;
+    /** Base URL of the chat service. Defaults to `https://chat.bitsnap.pl`. */
+    baseUrl?: string;
+    /** Replaces `fetch` (tests, server rendering). */
+    fetch?: typeof fetch;
+};
+/** The buyer calls of the chat service HTTP API. */
+type ChatClient = {
+    readonly baseUrl: string;
+    readonly projectId: string;
+    me(): Promise<ChatMe>;
+    /** Opens or returns the pack thread of a service product. */
+    openThread(productId: string): Promise<ChatThreadSummary>;
+    /** Newest first; `before` is a message id. */
+    messages(threadId: string, options?: {
+        before?: string;
+        limit?: number;
+    }): Promise<ChatMessagePage>;
+    /** Queues a message. The service answers 202 with `status: "pending"`. */
+    send(threadId: string, input: {
+        body: string;
+        clientId?: string;
+    }): Promise<ChatSendResult>;
+    deleteMessage(threadId: string, messageId: string): Promise<void>;
+    mute(threadId: string, muted: boolean): Promise<void>;
+    report(input: {
+        threadId: string;
+        messageId?: string;
+        reason: ChatReportReason;
+        note?: string;
+    }): Promise<void>;
+    markRead(threadId: string, messageId: string): Promise<void>;
+    /**
+     * A NATS token for every conversation the caller may read. The answer is
+     * kept until a minute and a half before it expires (the service mints one
+     * per caller every 10 s); `fresh` asks for a new one.
+     */
+    realtimeToken(options?: {
+        fresh?: boolean;
+    }): Promise<ChatRealtimeToken>;
+};
+declare function createChatClient(options: ChatClientOptions): ChatClient;
+/** Parses one live event of the thread or channel subject. */
+declare function parseRealtimeEvent(raw: unknown): ChatRealtimeEvent | null;
+
+/** The part of `@nats-io/nats-core` the chat uses. */
+type NatsModule = {
+    wsconnect(options: {
+        servers: string[];
+        authenticator: unknown;
+        name?: string;
+        reconnect?: boolean;
+        maxReconnectAttempts?: number;
+    }): Promise<NatsConnectionLike>;
+    jwtAuthenticator(jwt: () => string): unknown;
+};
+type NatsConnectionLike = {
+    subscribe(subject: string, options: {
+        callback: (error: Error | null, msg: {
+            data: Uint8Array;
+        }) => void;
+    }): {
+        unsubscribe(): void;
+    };
+    closed(): Promise<void | Error>;
+    close(): Promise<void>;
+};
+type LiveOptions = {
+    client: ChatClient;
+    /** `thread` for a pack thread, `channel` for a channel. */
+    kind: "thread" | "channel";
+    /** Thread id (a channel thread has the channel's id). */
+    id: string;
+    onEvent: (event: ChatRealtimeEvent) => void;
+    onMode: (mode: ChatLiveMode) => void;
+    /** Loads the newest page: the fallback, and the catch-up after a connect. */
+    poll: () => Promise<void>;
+    /** Polling interval while the socket is down. Default 8 s. */
+    pollIntervalMs?: number;
+    /** Delay before the socket is tried again after a failure. Default 60 s. */
+    retryMs?: number;
+    /** Overrides the WebSocket servers of the realtime token. */
+    realtimeUrl?: string;
+    /** Replaces the NATS loader (tests). */
+    loadNats?: () => Promise<NatsModule>;
+};
+/**
+ * Listens to one conversation: a realtime token from the chat service, then
+ * a subscribe-only NATS WebSocket on the conversation's subject. When any
+ * step fails (no WebSocket, token refused, subject not granted, socket
+ * closed) it polls the newest page instead and tries the socket again later.
+ * Returns the stop function.
+ */
+declare function startLive(options: LiveOptions): () => void;
+
+/**
+ * Every string of the chat (panel "Wiadomości", `ChatThread`, `Channel`).
+ * Pass a partial object through the `texts` prop to override any of them,
+ * whatever the locale. Placeholders like `{count}` stay in overrides.
+ *
+ * Counts use three forms (`One`, `Few`, `Many`) for Polish; English uses
+ * `One` and `Many`.
+ */
+type ChatTexts = {
+    inboxHeading: string;
+    inboxIntro: string;
+    inboxEmpty: string;
+    inboxError: string;
+    loading: string;
+    retry: string;
+    back: string;
+    selectConversation: string;
+    kindChat: string;
+    kindChannel: string;
+    startSection: string;
+    startChat: string;
+    openChannel: string;
+    channelNotReady: string;
+    chatFallbackTitle: string;
+    channelFallbackTitle: string;
+    /** Placeholder `{count}`. */
+    repliesLeftOne: string;
+    repliesLeftFew: string;
+    repliesLeftMany: string;
+    noRepliesLeft: string;
+    /** Placeholder `{date}`. */
+    expiresOn: string;
+    /** Placeholder `{date}`. */
+    expiredOn: string;
+    /** Placeholder `{hours}`. */
+    responseHours: string;
+    /** Placeholder `{count}`. */
+    unread: string;
+    /** Placeholder `{count}`. */
+    members: string;
+    mutedBadge: string;
+    noMessagesYet: string;
+    emptyThread: string;
+    emptyChannel: string;
+    privacyNote: string;
+    loadOlder: string;
+    you: string;
+    creator: string;
+    systemLabel: string;
+    pinned: string;
+    deletedPlaceholder: string;
+    attachment: string;
+    composerLabel: string;
+    composerPlaceholder: string;
+    send: string;
+    composerExpired: string;
+    composerCreatorOnly: string;
+    composerMuted: string;
+    composerReadOnly: string;
+    lockRepliesTitle: string;
+    lockRepliesBody: string;
+    lockExpiredTitle: string;
+    lockExpiredBody: string;
+    lockThreadTitle: string;
+    lockThreadBody: string;
+    lockChannelTitle: string;
+    lockChannelBody: string;
+    buyPack: string;
+    buyAccess: string;
+    buying: string;
+    buyError: string;
+    pending: string;
+    notConfirmed: string;
+    rejectedLink: string;
+    rejectedBannedWord: string;
+    rejectedMedia: string;
+    /** Placeholder `{seconds}`. */
+    rejectedCooldown: string;
+    rejectedBlocked: string;
+    rejectedMuted: string;
+    rejectedReadOnly: string;
+    rejectedPackEmpty: string;
+    rejectedForbidden: string;
+    rejectedGeneric: string;
+    failedNetwork: string;
+    editMessage: string;
+    retrySend: string;
+    dismiss: string;
+    messageActions: string;
+    deleteMessage: string;
+    deleteConfirm: string;
+    reportMessage: string;
+    conversationActions: string;
+    muteThread: string;
+    unmuteThread: string;
+    muteError: string;
+    reportConversation: string;
+    reportTitle: string;
+    reportConversationTitle: string;
+    reportReason: string;
+    reasonSpam: string;
+    reasonAbuse: string;
+    reasonIllegal: string;
+    reasonOther: string;
+    reportNote: string;
+    reportSend: string;
+    reportCancel: string;
+    reportSent: string;
+    reportError: string;
+    liveLabel: string;
+    pollingLabel: string;
+    errorNoToken: string;
+    errorUnauthorized: string;
+    errorPlan: string;
+    errorNotFound: string;
+    errorUnavailable: string;
+    errorGeneric: string;
+};
+declare const CHAT_TEXT_TABLES: LocaleTables<keyof ChatTexts>;
+/** Chat strings for a locale (default: the library locale), with overrides. */
+declare function getChatTexts(overrides?: Partial<ChatTexts>, locale?: string): ChatTexts;
+
+/** What to open: a pack thread (by product or id) or a channel. */
+type ConversationTarget = {
+    kind: "thread";
+    threadId?: string;
+    productId?: string;
+} | {
+    kind: "channel";
+    channelId: string;
+    productId?: string;
+};
+/** The client-side state of a message the service has not stored. */
+type LocalMessageState = {
+    state: "pending" | "unconfirmed" | "rejected" | "failed";
+    /** Error code or live reject reason. */
+    reason?: string;
+    retryAfter?: number;
+    /** An earlier send of this message may have been queued: retries keep its id. */
+    keepId?: boolean;
+};
+type ConversationMessage = ChatMessage & {
+    local?: LocalMessageState;
+};
+/**
+ * Why the buyer sees the lock: `replies` (no creator replies left, writing
+ * still works), `expired` (every pack expired), `no-pack` (no thread and no
+ * pack for the product), `no-access` (a paid channel without a grant).
+ */
+type ConversationLock = {
+    reason: "replies" | "expired" | "no-pack" | "no-access";
+    productId?: string;
+    priceCents?: number;
+    welcome?: string;
+};
+type ConversationState = {
+    status: "loading" | "ready" | "locked" | "error";
+    error?: ChatError;
+    threadId?: string;
+    /** The caller's e-mail, lowercased. */
+    me?: string;
+    thread?: ChatThreadSummary;
+    channel?: ChatChannelSummary;
+    lock?: ConversationLock;
+    /** Oldest first. */
+    messages: ConversationMessage[];
+    hasMore: boolean;
+    loadingOlder: boolean;
+    live: ChatLiveMode;
+};
+type ConversationActions = {
+    send(body: string): Promise<void>;
+    /** Sends a failed or refused message again. */
+    retry(id: string): Promise<void>;
+    /** Removes a message that was not stored. */
+    discard(id: string): void;
+    deleteMessage(id: string): Promise<void>;
+    report(input: {
+        messageId?: string;
+        reason: ChatReportReason;
+        note?: string;
+    }): Promise<void>;
+    setMuted(muted: boolean): Promise<void>;
+    loadOlder(): Promise<void>;
+    reload(): void;
+};
+type UseConversationOptions = {
+    /**
+     * `undefined` when there is no credential (the state is an error), `null`
+     * while the credential is still being looked up (the state stays loading).
+     */
+    client: ChatClient | null | undefined;
+    target: ConversationTarget;
+    pollIntervalMs?: number;
+    realtimeUrl?: string;
+    loadNats?: () => Promise<NatsModule>;
+    /** A pending send counts as unconfirmed after this long. Default 45 s. */
+    confirmTimeoutMs?: number;
+};
+/**
+ * State and actions of one conversation: resolves the thread (opening a pack
+ * thread when the buyer holds a pack and has none yet), loads the newest
+ * page, listens live (or polls) and sends optimistically.
+ */
+declare function useConversation(options: UseConversationOptions): ConversationState & ConversationActions;
+
+/** What the lock's buy action gets. */
+type ChatBuyRequest = {
+    /** The product (or variant) to sell: `buyProductId`, else the locked product. */
+    productId: string;
+    /** `replies`, `expired`, `no-pack` or `no-access`. */
+    reason: ConversationLock["reason"];
+    /** Known for a locked channel (from the chat service). */
+    priceCents?: number;
+};
+/** Props shared by `ChatThread` and `Channel`. */
+type ChatWidgetBaseProps = {
+    /**
+     * Public Bitsnap project id of the shop. The cart uses it, the panel
+     * session is looked up with it, and it is the `X-Bitsnap-Project` of the
+     * chat service unless `chatProjectID` is given.
+     */
+    projectID: string;
+    /** Project id for the chat service, when it differs from `projectID`. */
+    chatProjectID?: string;
+    /**
+     * Bearer for the chat service: a `bcht_` buyer token from your server
+     * (`POST /api/v1/chat/buyer-token`). Defaults to the customer panel session
+     * of this browser (after `PanelLogin`).
+     */
+    token?: string;
+    /** Chat service base URL. Defaults to `https://chat.bitsnap.pl`. */
+    apiUrl?: string;
+    /** NATS WebSocket URL overriding the one of the realtime token. */
+    realtimeUrl?: string;
+    /** Bitsnap host of the panel session (`setHost`), when not the default. */
+    host?: string;
+    /** Polling interval in ms while the live connection is down. Default 8000. */
+    pollIntervalMs?: number;
+    /** Language of the default texts; defaults to the library locale. */
+    locale?: string;
+    /** Text overrides, whatever the locale. */
+    texts?: Partial<ChatTexts>;
+    /** Heading of the conversation. */
+    title?: string;
+    /** Shows a back button in the header. */
+    onBack?: () => void;
+    /**
+     * The lock's "Kup pakiet" / "Kup dostęp". Default: add the product to the
+     * page cart and open it (mount `BitsnapCheckout` on the page). Throw to
+     * show the error line.
+     */
+    onBuy?: (request: ChatBuyRequest) => Promise<void> | void;
+    /** The product or variant the buy action sells (e.g. the pack variant). */
+    buyProductId?: string;
+    className?: string;
+    /** A ready client (tests, custom transport). Replaces token and URLs. */
+    client?: ChatClient;
+    /** @internal Replaces the NATS loader (tests). */
+    loadNats?: () => Promise<NatsModule>;
+};
+type ChatThreadProps = ChatWidgetBaseProps & {
+    /** The service product of the pack: opens its thread, creating it if needed. */
+    productId?: string;
+    /** An existing thread. Give this or `productId`. */
+    threadId?: string;
+};
+type ChannelProps = ChatWidgetBaseProps & {
+    /** The channel (its id is also the id of its conversation). */
+    channelId: string;
+    /** The community product sold by the lock; defaults to the channel's own. */
+    productId?: string;
+};
+/**
+ * A buyer's pack thread for one service product: history, live updates,
+ * sending with pending and refused states, report and mute, and the lock
+ * with "Kup pakiet" when the replies are used up or the pack expired.
+ * Load `bitsnap-react/dist/index.css` once.
+ */
+declare function ChatThread(props: ChatThreadProps): react_jsx_runtime.JSX.Element;
+/**
+ * A community channel: messages, live updates, posting when the channel
+ * allows it (with the channel's moderation refusals shown on the message),
+ * report, and the lock with "Kup dostęp" for a buyer without a grant.
+ * Load `bitsnap-react/dist/index.css` once.
+ */
+declare function Channel(props: ChannelProps): react_jsx_runtime.JSX.Element;
+
+export { type ChatPackEntitlement as A, type ChatRealtimeEvent as B, type ChatTexts as C, DEFAULT_CHAT_API_URL as D, type ChatRealtimeToken as E, type ChatReportReason as F, type ChatSendResult as G, type ChatThreadState as H, type ChatThreadSummary as I, type LiveOptions as L, type UseConversationOptions as U, Channel as a, ChatThread as b, type ChannelProps as c, type ChatBuyRequest as d, type ChatThreadProps as e, type ChatWidgetBaseProps as f, ChatError as g, createChatClient as h, type ChatClient as i, type ChatClientOptions as j, type ConversationLock as k, type ConversationMessage as l, type ConversationTarget as m, CHAT_TEXT_TABLES as n, getChatTexts as o, parseRealtimeEvent as p, DEFAULT_CHAT_REALTIME_URL as q, type ChatChannelEntitlement as r, startLive as s, type ChatChannelSummary as t, useConversation as u, type ChatLiveMode as v, type ChatMe as w, type ChatMessage as x, type ChatMessagePage as y, type ChatPack as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitsnap-react",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "This is Bitsnap React library for easy integration with any website which is using React framework",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -14,9 +14,10 @@
     "clean": "rimraf ./dist",
     "dev": "node scripts/write-version.mjs && tsup --watch",
     "dev:publish": "pnpm dev --env.publish",
-    "test": "tsup src/components/checkout/appearance.test.ts src/components/checkout/texts.test.ts src/components/checkout/buy-error.test.ts src/components/checkout/cart-buy-error.test.tsx src/lib/appearance-core.test.ts src/lib/texts.test.ts src/components/returns/appearance.test.ts src/components/returns/texts.test.ts src/components/returns/errors.test.ts src/components/returns/money.test.ts src/components/returns/session-storage.test.ts src/components/returns/state-machine.test.ts src/components/returns/selection.test.ts src/components/returns/legacy.test.ts src/panel/returns-appearance.test.ts src/components/products/appearance.test.ts src/components/products/texts.test.ts src/components/products/format.test.ts src/components/products/fetch.test.ts src/components/products/useProducts.test.ts src/components/products/cart-target.test.ts src/components/checkout/cart-items.test.ts src/components/checkout/pending-order.test.ts src/components/checkout/quantity.test.ts src/components/checkout/cart-a11y.test.tsx src/components/checkout/payment-method.test.ts src/components/checkout/cart-payment-method.test.tsx src/course/logic.test.ts src/course/accent.test.ts src/course/texts.test.ts src/course/datasource.test.ts src/course/sanitize.test.ts src/course/VideoPlayer.test.tsx src/course/PanelCourse.test.tsx src/consent/core/cookie.test.ts src/consent/core/texts.test.ts src/consent/core/activate.test.ts src/consent/core/gcm.test.ts src/consent/core/contrast.test.ts src/consent/core/controller.test.ts src/consent/embed.test.ts src/consent/react.test.tsx src/consent/react-shown.test.tsx src/analytics/core.test.ts src/analytics/embed.test.ts src/analytics/instrument.test.tsx src/analytics/page-views.test.tsx src/analytics/visitor.test.ts src/components/checkout/visitor-header.test.ts src/components/products/impressions.test.ts src/components/products/ProductList.analytics.test.tsx src/components/checkout/cart-analytics.test.tsx src/components/checkout/apple-pay-analytics.test.tsx src/components/notifications/notifications-analytics.test.tsx src/components/returns/returns-analytics.test.tsx src/panel/panel-analytics.test.tsx src/course/course-analytics.test.tsx src/viewer3d/viewer3d.test.ts src/viewer3d/Model3DViewer.test.tsx src/panel/panel-products.test.tsx src/ui/email-code-login/email-code-login.test.tsx src/ui/email-code-login/login-brand-logo.test.tsx src/panel/panel-login.test.tsx src/components/returns/returns-login.test.tsx src/components/notifications/notifications-login.test.tsx src/panel/audio-player/audio-player.test.tsx --format esm --out-dir .test-dist --no-config --external jsdom --silent && node --test --test-force-exit \".test-dist/**/*.test.mjs\"",
+    "test": "tsup src/components/checkout/appearance.test.ts src/components/checkout/texts.test.ts src/components/checkout/buy-error.test.ts src/components/checkout/cart-buy-error.test.tsx src/lib/appearance-core.test.ts src/lib/texts.test.ts src/components/returns/appearance.test.ts src/components/returns/texts.test.ts src/components/returns/errors.test.ts src/components/returns/money.test.ts src/components/returns/session-storage.test.ts src/components/returns/state-machine.test.ts src/components/returns/selection.test.ts src/components/returns/legacy.test.ts src/panel/returns-appearance.test.ts src/components/products/appearance.test.ts src/components/products/texts.test.ts src/components/products/format.test.ts src/components/products/fetch.test.ts src/components/products/useProducts.test.ts src/components/products/cart-target.test.ts src/components/checkout/cart-items.test.ts src/components/checkout/pending-order.test.ts src/components/checkout/quantity.test.ts src/components/checkout/cart-a11y.test.tsx src/components/checkout/payment-method.test.ts src/components/checkout/cart-payment-method.test.tsx src/course/logic.test.ts src/course/accent.test.ts src/course/texts.test.ts src/course/datasource.test.ts src/course/sanitize.test.ts src/course/VideoPlayer.test.tsx src/course/PanelCourse.test.tsx src/consent/core/cookie.test.ts src/consent/core/texts.test.ts src/consent/core/activate.test.ts src/consent/core/gcm.test.ts src/consent/core/contrast.test.ts src/consent/core/controller.test.ts src/consent/embed.test.ts src/consent/react.test.tsx src/consent/react-shown.test.tsx src/analytics/core.test.ts src/analytics/embed.test.ts src/analytics/instrument.test.tsx src/analytics/page-views.test.tsx src/analytics/visitor.test.ts src/components/checkout/visitor-header.test.ts src/components/products/impressions.test.ts src/components/products/ProductList.analytics.test.tsx src/components/checkout/cart-analytics.test.tsx src/components/checkout/apple-pay-analytics.test.tsx src/components/notifications/notifications-analytics.test.tsx src/components/returns/returns-analytics.test.tsx src/panel/panel-analytics.test.tsx src/course/course-analytics.test.tsx src/viewer3d/viewer3d.test.ts src/viewer3d/Model3DViewer.test.tsx src/panel/panel-products.test.tsx src/ui/email-code-login/email-code-login.test.tsx src/ui/email-code-login/login-brand-logo.test.tsx src/panel/panel-login.test.tsx src/components/returns/returns-login.test.tsx src/components/notifications/notifications-login.test.tsx src/panel/audio-player/audio-player.test.tsx src/express/client.test.ts src/express/cart-record.test.ts src/express/cart-session.test.ts src/express/revolut.test.ts src/express/return-url.test.ts src/express/loaders.test.ts src/components/express/express-ssr.test.tsx src/components/express/InPostPayButton.test.tsx src/components/express/RevolutPayButton.test.tsx src/chat/client.test.ts src/chat/realtime.test.ts src/chat/widgets.test.tsx src/chat/panel-messages.test.tsx --format esm --out-dir .test-dist --no-config --external jsdom --silent && node --test --test-force-exit \".test-dist/**/*.test.mjs\"",
     "test:types": "tsc -p test/consumer/tsconfig.json",
-    "test:package": "node test/consumer/verify-package.mjs"
+    "test:package": "node test/consumer/verify-package.mjs",
+    "test:express-ssr": "pnpm build && node --test test/express.ssr.test.cjs"
   },
   "repository": {
     "type": "git",
@@ -64,6 +65,7 @@
     "@formkit/auto-animate": "^0.8.2",
     "@google-pay/button-react": "^3.2.1",
     "@inpost-pay/widget": "^2.2.0",
+    "@nats-io/nats-core": "3.4.0",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-label": "^2.1.8",
     "@radix-ui/react-popover": "^1.1.15",
@@ -196,6 +198,16 @@
         "default": "./dist/course.js"
       }
     },
+    "./chat": {
+      "import": {
+        "types": "./dist/chat.d.mts",
+        "default": "./dist/chat.mjs"
+      },
+      "require": {
+        "types": "./dist/chat.d.ts",
+        "default": "./dist/chat.js"
+      }
+    },
     "./consent": {
       "import": {
         "types": "./dist/consent.d.mts",
@@ -244,6 +256,9 @@
       "course": [
         "./dist/course.d.ts"
       ],
+      "chat": [
+        "./dist/chat.d.ts"
+      ],
       "consent": [
         "./dist/consent.d.ts"
       ],

package/dist/CartProvider-OEI526IN.js

@@ -1,2 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkV5ECGBFWjs = require('./chunk-V5ECGBFW.js');require('./chunk-ZATPBYOA.js');require('./chunk-KOYBZORL.js');require('./chunk-VNV5BD4X.js');require('./chunk-G4V2KWTV.js');require('./chunk-4HGZZJEL.js');require('./chunk-DP2NOHCI.js');var _chunk7RXW6XFYjs = require('./chunk-7RXW6XFY.js');require('./chunk-W3RGQYPD.js');require('./chunk-JSDGZ4NY.js');exports.MARKETING_AGREEMENT_ID = _chunkV5ECGBFWjs.H; exports.bitsnapProjectID = _chunkV5ECGBFWjs.I; exports.default = _chunkV5ECGBFWjs.P; exports.getCartLines = _chunkV5ECGBFWjs.M; exports.getCheckoutMethods = _chunkV5ECGBFWjs.Q; exports.getCheckoutSelection = _chunkV5ECGBFWjs.L; exports.getLocale = _chunk7RXW6XFYjs.f; exports.getProjectID = _chunkV5ECGBFWjs.K; exports.reconcileOrderOfLastPayment = _chunkV5ECGBFWjs.N; exports.setLocale = _chunk7RXW6XFYjs.e; exports.setProjectID = _chunkV5ECGBFWjs.J; exports.useCartProvider = _chunkV5ECGBFWjs.O;
-//# sourceMappingURL=CartProvider-OEI526IN.js.map

package/dist/CartProvider-OEI526IN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/emems/web/bitsnap/bitsnap/bitsnap-react/dist/CartProvider-OEI526IN.js"],"names":[],"mappings":"AAAA,+HAAsG,+BAA4B,+BAA4B,+BAA4B,+BAA4B,+BAA4B,+BAA4B,sDAA+C,+BAA4B,+BAA4B,siBAAmQ","file":"/home/emems/web/bitsnap/bitsnap/bitsnap-react/dist/CartProvider-OEI526IN.js"}

package/dist/CartProvider-RYAA3JDA.mjs

@@ -1,2 +0,0 @@
-import{H as c,I as d,J as e,K as f,L as g,M as h,N as i,O as j,P as k,Q as l}from"./chunk-WJO5GSY3.mjs";import"./chunk-4OVOKGGS.mjs";import"./chunk-KOVKUJAW.mjs";import"./chunk-5X7TP3TQ.mjs";import"./chunk-CUPG4B5W.mjs";import"./chunk-EVIDNS22.mjs";import"./chunk-5R6AGO3Z.mjs";import"./chunk-GEBRXFT3.mjs";import"./chunk-CF45RDMD.mjs";import{e as a,f as b}from"./chunk-VNYHJT6V.mjs";import"./chunk-MDCP5JNP.mjs";import"./chunk-U6FLIRIV.mjs";export{c as MARKETING_AGREEMENT_ID,d as bitsnapProjectID,k as default,h as getCartLines,l as getCheckoutMethods,g as getCheckoutSelection,b as getLocale,f as getProjectID,i as reconcileOrderOfLastPayment,a as setLocale,e as setProjectID,j as useCartProvider};
-//# sourceMappingURL=CartProvider-RYAA3JDA.mjs.map

package/dist/PanelModelFiles-7HPXWONN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/emems/web/bitsnap/bitsnap/bitsnap-react/dist/PanelModelFiles-7HPXWONN.js","../src/panel/components/PanelModelFiles.tsx"],"names":["COPY","formatSize","bytes","en","value","mb","fmt"],"mappings":"AAAA,uuBAA8C,sDAAwC,+BAA4B,8CCArF,yDACA,8BACkB,+CAsG3C,IAhEEA,CAAAA,CAA+B,CACnC,EAAA,CAAI,CACF,KAAA,CAAO,UAAA,CACP,QAAA,CAAU,mDAAA,CACV,QAAA,CAAU,SAAA,CACV,SAAA,CAAW,yBAAA,CACX,OAAA,CAAS,UAAA,CACT,SAAA,CAAW,SAAA,CACX,WAAA,CAAa,gBAAA,CACb,OAAA,CAAS,uCAAA,CACT,OAAA,CAAS,sBAAA,CACT,OAAA,CAAS,kCAAA,CACT,OAAA,CAAS,CACN,CAAA,CAAoC,gDAAA,CACpC,CAAA,CAAiC,uCAAA,CACjC,CAAA,CAAgC,uDAAA,CAChC,CAAA,CAA+B,mCAAA,CAC/B,CAAA,CAA+B,uCAAA,CAC/B,CAAA,CAA8B,uCACjC,CAAA,CACA,KAAA,CAAO,iEACT,CAAA,CACA,EAAA,CAAI,CACF,KAAA,CAAO,UAAA,CACP,QAAA,CAAU,sDAAA,CACV,QAAA,CAAU,UAAA,CACV,SAAA,CAAW,iBAAA,CACX,OAAA,CAAS,SAAA,CACT,SAAA,CAAW,WAAA,CACX,WAAA,CAAa,cAAA,CACb,OAAA,CAAS,+BAAA,CACT,OAAA,CAAS,oBAAA,CACT,OAAA,CAAS,8BAAA,CACT,OAAA,CAAS,CACN,CAAA,CAAoC,0CAAA,CACpC,CAAA,CAAiC,8BAAA,CACjC,CAAA,CAAgC,qCAAA,CAChC,CAAA,CAA+B,+BAAA,CAC/B,CAAA,CAA+B,+BAAA,CAC/B,CAAA,CAA8B,wBACjC,CAAA,CACA,KAAA,CAAO,8CACT,CACF,CAAA,CAEA,SAASC,CAAAA,CAAWC,CAAAA,CAAeC,CAAAA,CAAqB,CACtD,IAAMC,CAAAA,CAAQ,MAAA,CAAOF,CAAK,CAAA,CAC1B,EAAA,CAAI,CAAC,MAAA,CAAO,QAAA,CAASE,CAAK,CAAA,EAAKA,CAAAA,EAAS,CAAA,CAAG,MAAO,EAAA,CAClD,IAAMC,CAAAA,CAAKD,CAAAA,CAAAA,CAAS,IAAA,CAAO,IAAA,CAAA,CACrBE,CAAAA,CAAM,IAAI,IAAA,CAAK,YAAA,CAAaH,CAAAA,CAAK,OAAA,CAAU,OAAA,CAAS,CACxD,qBAAA,CAAuB,CACzB,CAAC,CAAA,CACD,OAAOE,CAAAA,EAAM,CAAA,CAAI,CAAA,EAAA","file":"/home/emems/web/bitsnap/bitsnap/bitsnap-react/dist/PanelModelFiles-7HPXWONN.js","sourcesContent":[null,"import { createClient } from \"@connectrpc/connect\";\nimport { useTransport } from \"@connectrpc/connect-query\";\nimport { useCallback, useMemo, useState } from \"react\";\n\nimport { getLocale } from \"../../components/checkout/locale\";\nimport {\n  ModelDeliveryFailure,\n  ModelDeliveryService,\n  ModelFileState,\n  type PurchasedModel,\n} from \"../../gen/proto/public/v1/model_delivery_pb\";\n\n/**\n * \"3D files\" of the customer panel: the 3D files of the buyer's paid orders in\n * this shop (`public.v1.ModelDeliveryService`), with a download button, the\n * licence and the \"seller removed the file\" state. The download URL is signed\n * on click and expires quickly, so it is never rendered into the page.\n *\n * Older Bitsnap servers have no such service: any transport error (404,\n * unimplemented, network) hides the section, so the panel looks as before.\n *\n * Loaded on demand (with `model-files-client.ts`) only when the buyer has 3D\n * files, so the main bundle carries just `model-files-load.ts`.\n */\n\ntype Copy = {\n  title: string;\n  subtitle: string;\n  download: string;\n  preparing: string;\n  licence: string;\n  purchased: string;\n  accessUntil: string;\n  removed: string;\n  contact: string;\n  expired: string;\n  failure: Partial<Record<ModelDeliveryFailure, string>>;\n  error: string;\n};\n\nconst COPY: { pl: Copy; en: Copy } = {\n  pl: {\n    title: \"Pliki 3D\",\n    subtitle: \"Pobierasz zawsze aktualną wersję pliku.\",\n    download: \"Pobierz\",\n    preparing: \"Przygotowuję…\",\n    licence: \"Licencja\",\n    purchased: \"Kupiono\",\n    accessUntil: \"Dostęp do\",\n    removed: \"Sprzedawca usunął ten plik.\",\n    contact: \"Napisz do sprzedawcy\",\n    expired: \"Dostęp do pliku wygasł\",\n    failure: {\n      [ModelDeliveryFailure.UNAUTHORIZED]: \"Sesja wygasła. Zaloguj się ponownie.\",\n      [ModelDeliveryFailure.NOT_FOUND]: \"Nie znaleźliśmy tego pliku.\",\n      [ModelDeliveryFailure.REFUNDED]: \"Zamówienie zostało zwrócone lub anulowane.\",\n      [ModelDeliveryFailure.EXPIRED]: \"Dostęp do pliku wygasł.\",\n      [ModelDeliveryFailure.REMOVED]: \"Sprzedawca usunął ten plik.\",\n      [ModelDeliveryFailure.UNPAID]: \"Zamówienie nie jest opłacone.\",\n    },\n    error: \"Nie udało się pobrać pliku. Spróbuj ponownie.\",\n  },\n  en: {\n    title: \"3D files\",\n    subtitle: \"You always download the current version of the file.\",\n    download: \"Download\",\n    preparing: \"Preparing…\",\n    licence: \"Licence\",\n    purchased: \"Purchased\",\n    accessUntil: \"Access until\",\n    removed: \"The seller removed this file.\",\n    contact: \"Contact the seller\",\n    expired: \"Access to the file has ended\",\n    failure: {\n      [ModelDeliveryFailure.UNAUTHORIZED]: \"Your session has expired. Sign in again.\",\n      [ModelDeliveryFailure.NOT_FOUND]: \"We could not find this file.\",\n      [ModelDeliveryFailure.REFUNDED]: \"The order was refunded or canceled.\",\n      [ModelDeliveryFailure.EXPIRED]: \"Access to the file has ended.\",\n      [ModelDeliveryFailure.REMOVED]: \"The seller removed this file.\",\n      [ModelDeliveryFailure.UNPAID]: \"The order is not paid.\",\n    },\n    error: \"The file could not be downloaded. Try again.\",\n  },\n};\n\nfunction formatSize(bytes: bigint, en: boolean): string {\n  const value = Number(bytes);\n  if (!Number.isFinite(value) || value <= 0) return \"\";\n  const mb = value / (1024 * 1024);\n  const fmt = new Intl.NumberFormat(en ? \"en-GB\" : \"pl-PL\", {\n    maximumFractionDigits: 1,\n  });\n  return mb >= 1 ? `${fmt.format(mb)} MB` : `${fmt.format(value / 1024)} KB`;\n}\n\nfunction formatDate(seconds: bigint | undefined, en: boolean): string {\n  if (seconds == null || seconds <= 0n) return \"\";\n  return new Intl.DateTimeFormat(en ? \"en-GB\" : \"pl-PL\", {\n    dateStyle: \"medium\",\n  }).format(new Date(Number(seconds) * 1000));\n}\n\nfunction CubeIcon({ className }: { className?: string }) {\n  return (\n    <svg\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth={1.5}\n      className={className}\n      aria-hidden\n    >\n      <path d=\"M12 2.5 3.5 7v10L12 21.5 20.5 17V7L12 2.5Z\" strokeLinejoin=\"round\" />\n      <path d=\"M3.5 7 12 11.5 20.5 7M12 11.5v10\" strokeLinejoin=\"round\" />\n    </svg>\n  );\n}\n\nexport default function PanelModelFiles({\n  accessToken,\n  models,\n  buttonStyle,\n}: {\n  accessToken: string;\n  models: PurchasedModel[];\n  buttonStyle?: React.CSSProperties;\n}) {\n  const en = getLocale().toLowerCase().startsWith(\"en\");\n  const t = en ? COPY.en : COPY.pl;\n  const transport = useTransport();\n  const client = useMemo(\n    () => createClient(ModelDeliveryService, transport),\n    [transport],\n  );\n  const [pending, setPending] = useState<string | null>(null);\n  const [errors, setErrors] = useState<Record<string, string>>({});\n\n  const download = useCallback(\n    async (model: PurchasedModel, index: number) => {\n      const key = `${model.orderId}:${model.lineId}:${index}`;\n      setPending(key);\n      setErrors((current) => ({ ...current, [key]: \"\" }));\n      try {\n        const response = await client.getModelFileDownloadUrl({\n          accessToken,\n          orderId: model.orderId,\n          lineId: model.lineId,\n          fileIndex: index,\n        });\n        if (response.result.case === \"success\") {\n          // An attachment: the browser downloads it and stays on the panel.\n          window.location.assign(response.result.value.url);\n        } else {\n          const failure =\n            response.result.case === \"failure\" ? response.result.value : undefined;\n          setErrors((current) => ({\n            ...current,\n            [key]: (failure != null ? t.failure[failure] : undefined) ?? t.error,\n          }));\n        }\n      } catch {\n        setErrors((current) => ({ ...current, [key]: t.error }));\n      } finally {\n        setPending(null);\n      }\n    },\n    [client, accessToken, t],\n  );\n\n  if (models.length === 0) return null;\n\n  return (\n    <section\n      aria-labelledby=\"bitsnap-panel-model-files\"\n      className=\"mt-10 w-full max-w-5xl\"\n      data-testid=\"model-files\"\n    >\n      <div className=\"rounded-2xl border border-neutral-200 bg-white dark:border-neutral-800 dark:bg-neutral-900\">\n        <header className=\"border-b border-neutral-200 px-5 py-4 dark:border-neutral-800\">\n          <h2\n            id=\"bitsnap-panel-model-files\"\n            className=\"text-lg font-semibold text-neutral-900 dark:text-neutral-50\"\n          >\n            {t.title}\n          </h2>\n          <p className=\"mt-0.5 text-sm text-neutral-500 dark:text-neutral-400\">\n            {t.subtitle}\n          </p>\n        </header>\n        <ul className=\"grid grid-cols-1 gap-4 p-4 sm:grid-cols-2 xl:grid-cols-3\">\n          {models.map((model) => {\n            const title = model.variantName\n              ? `${model.productName} – ${model.variantName}`\n              : model.productName;\n            return (\n              <li\n                key={`${model.orderId}:${model.lineId}`}\n                className=\"flex min-w-0 flex-col gap-4 rounded-xl border border-neutral-200 p-4 dark:border-neutral-700\"\n                data-state={ModelFileState[model.state]}\n              >\n                <div className=\"flex min-w-0 flex-1 items-center gap-4\">\n                  <div className=\"flex size-14 shrink-0 items-center justify-center overflow-hidden rounded-xl bg-neutral-100 text-neutral-400 dark:bg-neutral-800\">\n                    {model.thumbnailUrl ? (\n                      <img\n                        src={model.thumbnailUrl}\n                        alt={title}\n                        className=\"size-full object-contain\"\n                        loading=\"lazy\"\n                      />\n                    ) : (\n                      <CubeIcon className=\"size-7\" />\n                    )}\n                  </div>\n                  <div className=\"min-w-0\">\n                    <p className=\"break-words font-medium text-neutral-900 dark:text-neutral-50\">\n                      {title}\n                    </p>\n                    <p className=\"mt-0.5 text-sm text-neutral-500 dark:text-neutral-400\">\n                      {[\n                        model.files[0]\n                          ? `${model.files[0].format.toUpperCase()} · ${formatSize(model.files[0].fileSize, en)}`\n                          : \"\",\n                        `${t.purchased} ${formatDate(model.purchasedAt, en)}`,\n                        model.accessExpiresAt != null &&\n                        model.state === ModelFileState.AVAILABLE\n                          ? `${t.accessUntil} ${formatDate(model.accessExpiresAt, en)}`\n                          : \"\",\n                      ]\n                        .filter(Boolean)\n                        .join(\" · \")}\n                    </p>\n                    {model.licence && (\n                      <p className=\"mt-0.5 text-sm text-neutral-600 dark:text-neutral-300\">\n                        {t.licence}:{\" \"}\n                        {model.licence.url ? (\n                          <a\n                            href={model.licence.url}\n                            target=\"_blank\"\n                            rel=\"noopener noreferrer\"\n                            className=\"underline underline-offset-2 hover:text-neutral-900 dark:hover:text-neutral-50\"\n                          >\n                            {model.licence.name}\n                          </a>\n                        ) : (\n                          model.licence.name\n                        )}\n                      </p>\n                    )}\n                    {model.state === ModelFileState.REMOVED && (\n                      <p\n                        className=\"mt-1 text-sm text-neutral-700 dark:text-neutral-200\"\n                        data-model-removed=\"\"\n                      >\n                        {t.removed}\n                        {model.seller?.email && (\n                          <>\n                            {\" \"}\n                            {t.contact}\n                            {model.seller.name ? ` (${model.seller.name})` : \"\"}:{\" \"}\n                            <a\n                              className=\"font-medium underline underline-offset-2\"\n                              href={`mailto:${model.seller.email}`}\n                            >\n                              {model.seller.email}\n                            </a>\n                          </>\n                        )}\n                      </p>\n                    )}\n                    {model.state === ModelFileState.EXPIRED && (\n                      <p className=\"mt-1 text-sm text-neutral-700 dark:text-neutral-200\">\n                        {t.expired}\n                        {model.accessExpiresAt != null\n                          ? ` ${formatDate(model.accessExpiresAt, en)}`\n                          : \"\"}\n                        .\n                      </p>\n                    )}\n                  </div>\n                </div>\n                {model.state === ModelFileState.AVAILABLE &&\n                  model.files.map((file) => {\n                    const key = `${model.orderId}:${model.lineId}:${file.index}`;\n                    const busy = pending === key;\n                    return (\n                      <div\n                        key={key}\n                        className=\"flex flex-col items-start gap-1 sm:items-end\"\n                      >\n                        <button\n                          type=\"button\"\n                          onClick={() => void download(model, file.index)}\n                          disabled={pending != null}\n                          aria-busy={busy || undefined}\n                          aria-label={`${t.download}: ${file.fileName}`}\n                          data-model-download=\"\"\n                          style={buttonStyle}\n                          className=\"min-h-11 inline-flex h-10 items-center justify-center rounded-lg bg-neutral-900 px-4 text-sm font-medium text-white transition-opacity hover:opacity-90 disabled:opacity-60 dark:bg-neutral-50 dark:text-neutral-900\"\n                        >\n                          {busy ? t.preparing : t.download}\n                        </button>\n                        {errors[key] && (\n                          <p\n                            className=\"text-sm text-red-700 dark:text-red-400\"\n                            role=\"alert\"\n                          >\n                            {errors[key]}\n                          </p>\n                        )}\n                      </div>\n                    );\n                  })}\n              </li>\n            );\n          })}\n        </ul>\n      </div>\n    </section>\n  );\n}\n"]}

package/dist/chunk-4HGZZJEL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/emems/web/bitsnap/bitsnap/bitsnap-react/dist/chunk-4HGZZJEL.js","../src/lib/client-header.ts"],"names":["CLIENT_HEADER_NAME","CLIENT_HEADER_VALUE","SDK_VERSION"],"mappings":"AAAA,+HAAuC,ICG1BA,CAAAA,CAAqB,kBAAA,CACrBC,CAAAA,CAAsB,CAAA,cAAA,EAAiBC,kBAAW,CAAA,CAAA","file":"/home/emems/web/bitsnap/bitsnap/bitsnap-react/dist/chunk-4HGZZJEL.js","sourcesContent":[null,"import type { Interceptor } from \"@connectrpc/connect\";\nimport { SDK_VERSION } from \"../version\";\n\nexport const CLIENT_HEADER_NAME = \"X-Bitsnap-Client\";\nexport const CLIENT_HEADER_VALUE = `bitsnap-react@${SDK_VERSION}`;\n\nexport const CLIENT_QUERY_PARAM = \"bs_client\";\n\n/**\n * Spread into the `headers` of a fetch that already triggers a CORS preflight\n * (JSON POST, Connect RPC). Never use it on a simple cross-origin GET: the\n * custom header would force a preflight that older servers and merchant\n * proxies do not allow. Use `withClientParam` there.\n */\nexport const clientHeaders: Record<string, string> = {\n  [CLIENT_HEADER_NAME]: CLIENT_HEADER_VALUE,\n};\n\n/** Connect interceptor adding the client header to every RPC. */\nexport const clientHeaderInterceptor: Interceptor = (next) => (req) => {\n  req.header.set(CLIENT_HEADER_NAME, CLIENT_HEADER_VALUE);\n  return next(req);\n};\n\n/** Adds `bs_client=<pkg>@<ver>` to a URL, for simple GETs that must stay preflight-free. */\nexport function withClientParam(url: string): string {\n  const hash = url.indexOf(\"#\");\n  const base = hash === -1 ? url : url.slice(0, hash);\n  const fragment = hash === -1 ? \"\" : url.slice(hash);\n  const separator = base.includes(\"?\") ? (/[?&]$/.test(base) ? \"\" : \"&\") : \"?\";\n  return `${base}${separator}${CLIENT_QUERY_PARAM}=${encodeURIComponent(CLIENT_HEADER_VALUE)}${fragment}`;\n}\n"]}