@tiledev/sdk-apptile-live-selling 0.1.0

package/dist/auctions.d.ts

@@ -0,0 +1,3 @@
+import type { AuctionsAPI } from './types';
+export declare const auctions: AuctionsAPI;
+//# sourceMappingURL=auctions.d.ts.map

package/dist/auctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auctions.d.ts","sourceRoot":"","sources":["../src/auctions.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAA+B,WAAW,EAAE,MAAM,SAAS,CAAC;AAuExE,eAAO,MAAM,QAAQ,EAAE,WAmFtB,CAAC"}

package/dist/auctions.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auctions = void 0;
+/**
+ * Auctions and giveaways.
+ *
+ * The Zego channels (the live engine) carry the round — who is leading, what the next bid is, when the
+ * clock stops — and are authoritative for the UI. These REST calls are the durable path: a bid is
+ * recorded so the host has a ledger that survives a dropped socket, a giveaway entry so it outlives the
+ * app session. Neither response drives the UI; the host's broadcast does.
+ *
+ * All anonymous through the company header, save the unpaid-wins read, which needs the customer's own
+ * token and so goes through the injected `customerAccountRequest`.
+ */
+const client_1 = require("./client");
+const TERMS_KEY = 'auction.termsAccepted';
+// ─── Unpaid wins (customer-account metafield) ────────────────────────────────
+const UNPAID_WINS_QUERY = /* GraphQL */ `
+  query AuctionWins {
+    customer {
+      metafield(namespace: "auction", key: "winner") {
+        value
+      }
+    }
+  }
+`;
+async function fetchWinnerMetafield() {
+    var _a, _b;
+    const customerAccountRequest = (0, client_1.getCustomerAccountRequest)();
+    if (!customerAccountRequest)
+        return null;
+    const data = await customerAccountRequest(UNPAID_WINS_QUERY);
+    const value = (_b = (_a = data.customer) === null || _a === void 0 ? void 0 : _a.metafield) === null || _b === void 0 ? void 0 : _b.value;
+    if (!value)
+        return null;
+    const parsed = JSON.parse(value);
+    return parsed && typeof parsed === 'object' ? parsed : null;
+}
+/**
+ * An entry there is actually something to charge for.
+ *
+ * `productId` is the whole test: without it nothing can be resolved, priced or put in a cart, so the
+ * entry is unpayable however well-formed the rest of it looks. A missing *variant* is not a defect —
+ * the host records no variant when a lot has only one, and the win resolves to it.
+ */
+function isPayable(raw) {
+    return !!raw && typeof raw === 'object' && !!raw.productId;
+}
+/**
+ * The streams with something payable outstanding — NOT simply the metafield's keys.
+ *
+ * This is the difference between a gate that can be cleared and one that cannot. The keys and the
+ * payable entries are not the same set: a key can survive with an empty array, or with entries that
+ * carry no `productId`, and nothing in the system prunes it. Read as "streams owed", such a key blocks
+ * bidding on every other stream while `wins()` reports nothing to pay and the wins tab shows an empty
+ * list — the customer is locked out with no action available to them, and no support call fixes it
+ * either. Both readers now agree because both use this.
+ *
+ * The error is deliberately one-sided. Skipping an unpayable key can at worst let through a bid the
+ * host refuses; counting one blocks a paying customer permanently.
+ */
+function payableStreamIds(parsed) {
+    return Object.keys(parsed).filter((streamingId) => {
+        const entries = parsed[streamingId];
+        return Array.isArray(entries) && entries.some(isPayable);
+    });
+}
+// ─── Namespace ─────────────────────────────────────────────────────────────
+exports.auctions = {
+    async recordBid(params) {
+        var _a;
+        await (0, client_1.liveSellingRequest)('/live-streaming/bid/vote', {
+            method: 'POST',
+            body: {
+                streaming_id: params.streamingId,
+                company_id: (_a = (0, client_1.getCompanyId)()) !== null && _a !== void 0 ? _a : (0, client_1.getConfig)().companyId,
+                bidding_price: params.amount,
+                viewer_id: params.bidderId,
+                viewer_name: params.bidderName,
+                meta: { product_id: params.storeProductId },
+            },
+        });
+    },
+    async enterGiveaway(params) {
+        var _a;
+        const body = await (0, client_1.liveSellingRequest)('/live-streaming/giveaway/register', {
+            method: 'POST',
+            body: {
+                streaming_id: params.streamingId,
+                product_id: params.storeProductId,
+                user_id: params.customerGid,
+                display_name: params.displayName,
+                zego_user_id: params.viewerId,
+            },
+        });
+        // The host echoes the customer it registered; anything else means the entry did not take.
+        return !!((_a = body === null || body === void 0 ? void 0 : body.data) === null || _a === void 0 ? void 0 : _a.user_id);
+    },
+    async hasAcceptedTerms() {
+        return (await (0, client_1.storageGet)(TERMS_KEY)) === 'true';
+    },
+    async acceptTerms() {
+        await (0, client_1.storageSet)(TERMS_KEY, 'true');
+    },
+    async unpaidStreamIds() {
+        try {
+            const parsed = await fetchWinnerMetafield();
+            return parsed ? payableStreamIds(parsed) : [];
+        }
+        catch {
+            // A metafield read failing must not lock a customer out of bidding.
+            return [];
+        }
+    },
+    async wins() {
+        const parsed = await fetchWinnerMetafield();
+        if (!parsed)
+            return null;
+        /**
+         * The first stream with something payable, rather than the first key.
+         *
+         * One tab per checkout is the host's model — the cart carries a single `auction_id` and the gate
+         * stops a customer accruing wins on a second stream while the first is unpaid — so in practice
+         * there is one. Taking `Object.keys()[0]` regardless meant a leftover empty key hid a real win
+         * sitting behind it, and the customer was blocked by the very win the tab refused to show.
+         */
+        const [streamingId] = payableStreamIds(parsed);
+        if (!streamingId)
+            return null;
+        const items = (Array.isArray(parsed[streamingId]) ? parsed[streamingId] : [])
+            .filter(isPayable)
+            .map((raw) => {
+            var _a;
+            return ({
+                productGid: `gid://shopify/Product/${raw.productId}`,
+                variantId: raw.variantId != null && raw.variantId !== '' ? String(raw.variantId) : null,
+                winningBid: Number(raw.winningBid) || 0,
+                isGiveaway: !!raw.isGiveaway,
+                discountCode: (_a = raw.discountCode) !== null && _a !== void 0 ? _a : null,
+            });
+        });
+        return items.length ? { streamingId, items } : null;
+    },
+    isBiddingBlocked(unpaidStreamIds, streamingId) {
+        if (unpaidStreamIds.length === 0)
+            return false;
+        if (!streamingId)
+            return true;
+        return !unpaidStreamIds.includes(streamingId);
+    },
+};
+//# sourceMappingURL=auctions.js.map

package/dist/auctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auctions.js","sourceRoot":"","sources":["../src/auctions.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The one transport for the Apptile live-selling gateway, plus the config singleton every namespace
+ * reads.
+ *
+ * Auth is the company id alone: every viewer endpoint is anonymous, and the `x-company-id` header is
+ * what scopes the response. This host must never see the customer's bearer token — the single exception
+ * is the unpaid-wins read, which the host app supplies as `customerAccountRequest` and which never
+ * routes through here.
+ *
+ * Replaces the app's `APP_CONFIG.liveSelling` / `LIVE_CONFIG` globals with an explicit `configure`.
+ */
+import type { CustomerAccountRequest, LiveSellingConfig, Logger, StorageAdapter } from './types';
+import type { CommerceAdapter, IdentityAdapter } from './sessionTypes';
+/** The service stores bare numeric Shopify ids; everything downstream speaks GIDs. */
+export declare function toProductGid(id: string): string;
+/**
+ * A failed gateway call, with the status kept on the error.
+ *
+ * Callers that can act on *which* failure it was need the code — a guest invite that is expired (410)
+ * versus unknown (404) are different things to tell someone.
+ */
+export declare class LiveSellingError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+export declare function setConfig(config: LiveSellingConfig): void;
+export declare function getConfig(): LiveSellingConfig;
+export declare function isConfigured(): boolean;
+export declare function getCompanyId(): string | null;
+export declare function getStorage(): StorageAdapter;
+export declare function getLogger(): Logger;
+/**
+ * A handled-data report: `warn` where the host app has one, `error` where it does not.
+ *
+ * Never silent. A host that has not implemented `warn` still needs to hear that a win names a variant
+ * belonging to another product — dropping the report to keep the console clean would trade a merchant's
+ * data fault for silence, and that fault reaches a shopper as the wrong size in a cart.
+ */
+export declare function logWarning(error: unknown, context?: Record<string, unknown>): void;
+export declare function getCustomerAccountRequest(): CustomerAccountRequest | null;
+/** Null when the host app configured no storefront; the session then resolves no products. */
+export declare function getCommerce(): CommerceAdapter<unknown> | null;
+/** Null when nobody is identified beyond the per-install viewer id — bidding is then never offered. */
+export declare function getIdentity(): IdentityAdapter | null;
+/**
+ * The gateway request. The company header is the only credential; a body implies JSON. `X-Request-Source`
+ * marks the traffic as first-party app rather than a web widget.
+ */
+export declare function liveSellingRequest<T>(path: string, options?: {
+    params?: Record<string, string | number>;
+    method?: 'GET' | 'POST';
+    body?: unknown;
+}): Promise<T>;
+/**
+ * A stable random id. Uses the platform `crypto.randomUUID` when present (browsers, modern React
+ * Native, Node) and falls back to a Math.random hex string — replacing the app's `expo-crypto`
+ * dependency so the package carries no native crypto peer.
+ */
+export declare function randomId(length?: number): string;
+/** Storage reads may be sync or async depending on the adapter; normalise to a promise. */
+export declare function storageGet(key: string): Promise<string | null>;
+export declare function storageSet(key: string, value: string): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIvE,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAIpC;AA4BD,wBAAgB,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAMzD;AAED,wBAAgB,SAAS,IAAI,iBAAiB,CAG7C;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,UAAU,IAAI,cAAc,CAE3C;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIlF;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,GAAG,IAAI,CAEzE;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,CAE7D;AAED,uGAAuG;AACvG,wBAAgB,WAAW,IAAI,eAAe,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,SAAK,GAAG,MAAM,CAM5C;AAED,2FAA2F;AAC3F,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEpE;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E"}

package/dist/client.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveSellingError = void 0;
+exports.toProductGid = toProductGid;
+exports.setConfig = setConfig;
+exports.getConfig = getConfig;
+exports.isConfigured = isConfigured;
+exports.getCompanyId = getCompanyId;
+exports.getStorage = getStorage;
+exports.getLogger = getLogger;
+exports.logWarning = logWarning;
+exports.getCustomerAccountRequest = getCustomerAccountRequest;
+exports.getCommerce = getCommerce;
+exports.getIdentity = getIdentity;
+exports.liveSellingRequest = liveSellingRequest;
+exports.randomId = randomId;
+exports.storageGet = storageGet;
+exports.storageSet = storageSet;
+const SHOPIFY_PRODUCT_GID = 'gid://shopify/Product/';
+/** The service stores bare numeric Shopify ids; everything downstream speaks GIDs. */
+function toProductGid(id) {
+    return id.startsWith('gid://') ? id : `${SHOPIFY_PRODUCT_GID}${id}`;
+}
+/**
+ * A failed gateway call, with the status kept on the error.
+ *
+ * Callers that can act on *which* failure it was need the code — a guest invite that is expired (410)
+ * versus unknown (404) are different things to tell someone.
+ */
+class LiveSellingError extends Error {
+    constructor(status) {
+        super(`Live-selling API responded ${status}`);
+        this.status = status;
+        this.name = 'LiveSellingError';
+    }
+}
+exports.LiveSellingError = LiveSellingError;
+const SILENT = { error: () => undefined };
+/** Prefers `window.localStorage`; falls back to a process-lifetime in-memory map. */
+function defaultStorage() {
+    const ls = globalThis.localStorage;
+    if (ls && typeof ls.getItem === 'function')
+        return ls;
+    const mem = new Map();
+    return {
+        getItem: (key) => (mem.has(key) ? mem.get(key) : null),
+        setItem: (key, value) => {
+            mem.set(key, value);
+        },
+        removeItem: (key) => {
+            mem.delete(key);
+        },
+    };
+}
+const state = { config: null, storage: defaultStorage(), logger: SILENT };
+function setConfig(config) {
+    var _a, _b;
+    if (!config.apiUrl)
+        throw new Error('liveSelling.configure: apiUrl is required');
+    if (!config.companyId)
+        throw new Error('liveSelling.configure: companyId is required');
+    state.config = config;
+    state.storage = (_a = config.storage) !== null && _a !== void 0 ? _a : defaultStorage();
+    state.logger = (_b = config.logger) !== null && _b !== void 0 ? _b : SILENT;
+}
+function getConfig() {
+    if (!state.config)
+        throw new Error('liveSelling.configure() must be called before any other method');
+    return state.config;
+}
+function isConfigured() {
+    return state.config !== null;
+}
+function getCompanyId() {
+    var _a, _b;
+    return (_b = (_a = state.config) === null || _a === void 0 ? void 0 : _a.companyId) !== null && _b !== void 0 ? _b : null;
+}
+function getStorage() {
+    return state.storage;
+}
+function getLogger() {
+    return state.logger;
+}
+/**
+ * A handled-data report: `warn` where the host app has one, `error` where it does not.
+ *
+ * Never silent. A host that has not implemented `warn` still needs to hear that a win names a variant
+ * belonging to another product — dropping the report to keep the console clean would trade a merchant's
+ * data fault for silence, and that fault reaches a shopper as the wrong size in a cart.
+ */
+function logWarning(error, context) {
+    const logger = state.logger;
+    if (logger.warn)
+        logger.warn(error, context);
+    else
+        logger.error(error, context);
+}
+function getCustomerAccountRequest() {
+    var _a, _b;
+    return (_b = (_a = state.config) === null || _a === void 0 ? void 0 : _a.customerAccountRequest) !== null && _b !== void 0 ? _b : null;
+}
+/** Null when the host app configured no storefront; the session then resolves no products. */
+function getCommerce() {
+    var _a, _b;
+    return (_b = (_a = state.config) === null || _a === void 0 ? void 0 : _a.commerce) !== null && _b !== void 0 ? _b : null;
+}
+/** Null when nobody is identified beyond the per-install viewer id — bidding is then never offered. */
+function getIdentity() {
+    var _a, _b;
+    return (_b = (_a = state.config) === null || _a === void 0 ? void 0 : _a.identity) !== null && _b !== void 0 ? _b : null;
+}
+/**
+ * The gateway request. The company header is the only credential; a body implies JSON. `X-Request-Source`
+ * marks the traffic as first-party app rather than a web widget.
+ */
+async function liveSellingRequest(path, options) {
+    var _a, _b;
+    const config = getConfig();
+    const query = (options === null || options === void 0 ? void 0 : options.params)
+        ? `?${new URLSearchParams(Object.entries(options.params).map(([k, v]) => [k, String(v)]))}`
+        : '';
+    const response = await fetch(`${config.apiUrl}${path}${query}`, {
+        method: (_a = options === null || options === void 0 ? void 0 : options.method) !== null && _a !== void 0 ? _a : 'GET',
+        headers: {
+            'x-company-id': config.companyId,
+            'X-Request-Source': (_b = config.requestSource) !== null && _b !== void 0 ? _b : 'APPTILE',
+            ...((options === null || options === void 0 ? void 0 : options.body) ? { 'Content-Type': 'application/json' } : {}),
+        },
+        body: (options === null || options === void 0 ? void 0 : options.body) ? JSON.stringify(options.body) : undefined,
+    });
+    if (!response.ok)
+        throw new LiveSellingError(response.status);
+    return (await response.json());
+}
+/**
+ * A stable random id. Uses the platform `crypto.randomUUID` when present (browsers, modern React
+ * Native, Node) and falls back to a Math.random hex string — replacing the app's `expo-crypto`
+ * dependency so the package carries no native crypto peer.
+ */
+function randomId(length = 16) {
+    var _a;
+    const uuid = typeof ((_a = globalThis.crypto) === null || _a === void 0 ? void 0 : _a.randomUUID) === 'function'
+        ? globalThis.crypto.randomUUID()
+        : `${Date.now().toString(16)}${Math.random().toString(16).slice(2)}${Math.random().toString(16).slice(2)}`;
+    return uuid.replace(/-/g, '').slice(0, length);
+}
+/** Storage reads may be sync or async depending on the adapter; normalise to a promise. */
+async function storageGet(key) {
+    return Promise.resolve(getStorage().getItem(key));
+}
+async function storageSet(key, value) {
+    await Promise.resolve(getStorage().setItem(key, value));
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/clips.d.ts

@@ -0,0 +1,3 @@
+import type { ClipsAPI } from './types';
+export declare const clips: ClipsAPI;
+//# sourceMappingURL=clips.d.ts.map

package/dist/clips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clips.d.ts","sourceRoot":"","sources":["../src/clips.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,SAAS,CAAC;AAwBlD,eAAO,MAAM,KAAK,EAAE,QAyBnB,CAAC"}

package/dist/clips.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clips = void 0;
+/**
+ * Clips, from the gateway's video collections.
+ *
+ * A video collection is a merchant-ordered playlist of clips, selected by `videoCollectionId` alone.
+ * A clip is not its own recording: every item points at the FULL HLS playlist of the livestream it was
+ * cut from and carries the cut as `start`/`end` query params. The CDN ignores them, so the window is
+ * the client's to honour — parsed off here into `startMs`/`endMs`. Left on the URL they read as already
+ * applied, and each clip silently plays a whole show from the top.
+ */
+const client_1 = require("./client");
+/**
+ * Splits the trim window off the playlist URL. Read with a regex rather than `URL.searchParams`, which
+ * React Native does not implement for reading a parsed URL back.
+ */
+function readTrimWindow(url) {
+    const [videoUrl, query = ''] = url.split('?');
+    const readMs = (key) => {
+        const found = query.match(new RegExp(`(?:^|&)${key}=(\\d+)`));
+        return found ? Number(found[1]) : null;
+    };
+    return { videoUrl, startMs: readMs('start'), endMs: readMs('end') };
+}
+exports.clips = {
+    async list() {
+        var _a, _b;
+        const { videoCollectionId } = (0, client_1.getConfig)();
+        /**
+         * No collection means this store has not curated a reel — an empty one, not an error. Worth an
+         * early return: the id is not scoped by the company header, so a blank one requests
+         * `/video-collections/` and a stale one happily returns another brand's clips with a 200.
+         */
+        if (!videoCollectionId)
+            return [];
+        const body = await (0, client_1.liveSellingRequest)(`/widget/plugin/video-collections/${videoCollectionId}`);
+        return ((_b = (_a = body.data) === null || _a === void 0 ? void 0 : _a.items) !== null && _b !== void 0 ? _b : [])
+            .filter((item) => !!(item === null || item === void 0 ? void 0 : item.url))
+            .map((item, index) => {
+            var _a, _b, _c;
+            return ({
+                // Server-side unique, but an item could arrive without one and two clips must never collide.
+                id: item.shoppable_feed_id || `clip-${index}`,
+                title: ((_a = item.title) === null || _a === void 0 ? void 0 : _a.trim()) || '',
+                posterUrl: ((_b = item.thumbnail) === null || _b === void 0 ? void 0 : _b.trim()) || null,
+                productIds: ((_c = item.product_ids) !== null && _c !== void 0 ? _c : []).map(client_1.toProductGid),
+                ...readTrimWindow(item.url),
+            });
+        });
+    },
+};
+//# sourceMappingURL=clips.js.map

package/dist/clips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clips.js","sourceRoot":"","sources":["../src/clips.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,qCAAuE;AAYvE;;;GAGG;AACH,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,CAAC,QAAQ,EAAE,KAAK,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC;QAC9D,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAEY,QAAA,KAAK,GAAa;IAC7B,KAAK,CAAC,IAAI;;QACR,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAA,kBAAS,GAAE,CAAC;QAC1C;;;;WAIG;QACH,IAAI,CAAC,iBAAiB;YAAE,OAAO,EAAE,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,IAAA,2BAAkB,EAElC,oCAAoC,iBAAiB,EAAE,CAAC,CAAC;QAE5D,OAAO,CAAC,MAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,KAAK,mCAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,IAAI,EAAoD,EAAE,CAAC,CAAC,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,CAAA,CAAC;aAC/E,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;;YAAC,OAAA,CAAC;gBACrB,6FAA6F;gBAC7F,EAAE,EAAE,IAAI,CAAC,iBAAiB,IAAI,QAAQ,KAAK,EAAE;gBAC7C,KAAK,EAAE,CAAA,MAAA,IAAI,CAAC,KAAK,0CAAE,IAAI,EAAE,KAAI,EAAE;gBAC/B,SAAS,EAAE,CAAA,MAAA,IAAI,CAAC,SAAS,0CAAE,IAAI,EAAE,KAAI,IAAI;gBACzC,UAAU,EAAE,CAAC,MAAA,IAAI,CAAC,WAAW,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,qBAAY,CAAC;gBACtD,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;aAC5B,CAAC,CAAA;SAAA,CAAC,CAAC;IACR,CAAC;CACF,CAAC"}

package/dist/commentLinks.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Links inside live comments: finding them, and deciding where a tap should go.
+ *
+ * A host pastes storefront links into the chat — "here's the dress" — and a product link should open
+ * the app's own Product screen, not bounce the shopper into the browser. Pure and platform-free so the
+ * rules can be reasoned about (and tested) without a renderer.
+ *
+ * `classifyCommentLink` takes the app's own storefront hosts as an argument rather than reading a global
+ * config — that is the one piece of app coupling the engine's original had, lifted into a parameter.
+ */
+import type { CommentUrlPreview } from './types';
+export type CommentLink = {
+    kind: 'product';
+    handle: string;
+    variantId: string | null;
+    url: string;
+} | {
+    kind: 'collection';
+    handle: string;
+    url: string;
+} | {
+    kind: 'external';
+    url: string;
+};
+export type CommentSegment = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'link';
+    text: string;
+    url: string;
+};
+/** Splits a comment into text and link runs. Every link is kept. */
+export declare function toCommentSegments(text: string): CommentSegment[];
+/** True when the comment has anything tappable. */
+export declare function hasCommentLink(text: string): boolean;
+/**
+ * What a link points at. `storefrontHosts` are the app's own domains; products are checked before
+ * collections because Shopify writes nested `/collections/x/products/y` paths.
+ */
+export declare function classifyCommentLink(url: string, storefrontHosts: string[]): CommentLink;
+/** The host's unfurled link card, if the comment carried a usable one. */
+export declare function toUrlPreview(raw: unknown): CommentUrlPreview | undefined;
+/** The domain, for a card's caption. */
+export declare function displayHost(url: string): string;
+//# sourceMappingURL=commentLinks.d.ts.map

package/dist/commentLinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commentLinks.d.ts","sourceRoot":"","sources":["../src/commentLinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKjD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAkDhD,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAmBhE;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,WAAW,CAgBvF;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAWxE;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/commentLinks.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCommentSegments = toCommentSegments;
+exports.hasCommentLink = hasCommentLink;
+exports.classifyCommentLink = classifyCommentLink;
+exports.toUrlPreview = toUrlPreview;
+exports.displayHost = displayHost;
+const URL_PATTERN = /(?:https?:\/\/|www\.)[^\s<>"']+/gi;
+const TRAILING_PUNCTUATION = /[.,;:!?'"]+$/;
+function trimUrl(raw) {
+    let url = raw.replace(TRAILING_PUNCTUATION, '');
+    while ((url.endsWith(')') && !url.includes('(')) || (url.endsWith(']') && !url.includes('['))) {
+        url = url.slice(0, -1);
+    }
+    return url;
+}
+function toHref(url) {
+    return /^https?:\/\//i.test(url) ? url : `https://${url}`;
+}
+/** Port, credentials, case and a leading `www.` are all noise — `www.x.com` and `x.com` are one shop. */
+function normaliseHost(raw) {
+    return raw
+        .split('@')
+        .pop()
+        .split(':')[0]
+        .toLowerCase()
+        .replace(/^www\./, '');
+}
+function hostOf(url) {
+    const match = /^https?:\/\/([^/?#]+)/i.exec(toHref(url));
+    return match ? normaliseHost(match[1]) : null;
+}
+function pathOf(url) {
+    return toHref(url).replace(/^https?:\/\/[^/?#]*/i, '').replace(/[?#].*$/, '');
+}
+function decodeHandle(raw) {
+    try {
+        return decodeURIComponent(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+/** The variant a product link points at, promoted to a Storefront gid. */
+function variantIdOf(href) {
+    const match = /[?&]variant=([^&#]+)/i.exec(href);
+    const raw = (match === null || match === void 0 ? void 0 : match[1]) ? decodeURIComponent(match[1]) : '';
+    if (!raw)
+        return null;
+    if (raw.startsWith('gid://'))
+        return raw;
+    return /^\d+$/.test(raw) ? `gid://shopify/ProductVariant/${raw}` : null;
+}
+/** Splits a comment into text and link runs. Every link is kept. */
+function toCommentSegments(text) {
+    var _a;
+    if (!text)
+        return [];
+    const segments = [];
+    let cursor = 0;
+    for (const match of text.matchAll(new RegExp(URL_PATTERN))) {
+        const raw = match[0];
+        const start = (_a = match.index) !== null && _a !== void 0 ? _a : 0;
+        const url = trimUrl(raw);
+        const dropped = raw.slice(url.length);
+        if (start > cursor)
+            segments.push({ kind: 'text', text: text.slice(cursor, start) });
+        segments.push({ kind: 'link', text: url, url: toHref(url) });
+        cursor = start + raw.length;
+        if (dropped)
+            segments.push({ kind: 'text', text: dropped });
+    }
+    if (cursor < text.length)
+        segments.push({ kind: 'text', text: text.slice(cursor) });
+    return segments;
+}
+/** True when the comment has anything tappable. */
+function hasCommentLink(text) {
+    return new RegExp(URL_PATTERN).test(text !== null && text !== void 0 ? text : '');
+}
+/**
+ * What a link points at. `storefrontHosts` are the app's own domains; products are checked before
+ * collections because Shopify writes nested `/collections/x/products/y` paths.
+ */
+function classifyCommentLink(url, storefrontHosts) {
+    const href = toHref(url);
+    const host = hostOf(href);
+    const ours = !!host && storefrontHosts.some((h) => normaliseHost(h) === host);
+    if (!ours)
+        return { kind: 'external', url: href };
+    const path = pathOf(href);
+    const product = /\/products\/([^/]+)/i.exec(path);
+    if (product === null || product === void 0 ? void 0 : product[1]) {
+        return { kind: 'product', handle: decodeHandle(product[1]), variantId: variantIdOf(href), url: href };
+    }
+    const collection = /\/collections\/([^/]+)/i.exec(path);
+    if (collection === null || collection === void 0 ? void 0 : collection[1])
+        return { kind: 'collection', handle: decodeHandle(collection[1]), url: href };
+    return { kind: 'external', url: href };
+}
+/** The host's unfurled link card, if the comment carried a usable one. */
+function toUrlPreview(raw) {
+    const data = raw;
+    const url = typeof (data === null || data === void 0 ? void 0 : data.url) === 'string' ? data.url.trim() : '';
+    if (!url)
+        return undefined;
+    const image = typeof (data === null || data === void 0 ? void 0 : data.image) === 'string' ? data.image : null;
+    return {
+        url: toHref(url),
+        title: typeof (data === null || data === void 0 ? void 0 : data.title) === 'string' && data.title ? data.title : null,
+        description: typeof (data === null || data === void 0 ? void 0 : data.description) === 'string' && data.description ? data.description : null,
+        image: image ? image.replace(/^http:\/\//i, 'https://') : null,
+    };
+}
+/** The domain, for a card's caption. */
+function displayHost(url) {
+    var _a;
+    return (_a = hostOf(url)) !== null && _a !== void 0 ? _a : url;
+}
+//# sourceMappingURL=commentLinks.js.map

package/dist/commentLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commentLinks.js","sourceRoot":"","sources":["../src/commentLinks.ts"],"names":[],"mappings":"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"}