@perkamo/browser 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# `@perkamo/browser` Changelog
+
+## 0.1.0 - 2026-06-02
+
+### Added
+
+- Added browser-safe token client for planned client event/profile routes.
+- Added lightweight progress widget mount helper.
+- Added JSON-safe profile helpers and security guards for browser integrations.
+
+## 0.1.1 - 2026-06-02
+
+### Changed
+
+- Add a browser-safe client, JSON-safe profile helpers, stream-token support and progress widget helpers for public web integrations.

package/README.md

@@ -0,0 +1,109 @@
+# `@perkamo/browser`
+
+Browser-safe Perkamo client and lightweight widget helpers.
+
+Use this package only with short-lived tokens minted by your own backend. Never
+put a Perkamo server API key in browser, mobile, or embedded widget code.
+
+```bash
+npm install @perkamo/browser
+```
+
+## Client
+
+```ts
+import { createPerkamoBrowserClient } from "@perkamo/browser";
+
+const perkamo = createPerkamoBrowserClient({
+  baseUrl: "https://api.perkamo.com",
+  tenant: "commerce-test",
+  getToken: async () => {
+    const response = await fetch("/api/perkamo/token", {
+      method: "POST",
+      credentials: "include",
+    });
+    if (!response.ok) throw new Error("Unable to create Perkamo token");
+    return (await response.json()).token;
+  },
+});
+
+await perkamo.emit("page.viewed", { path: location.pathname });
+const profile = await perkamo.getProfileJson();
+document.querySelector("#points").textContent = String(profile.wallets.points ?? 0);
+```
+
+The client calls browser-token routes:
+
+- `POST /v1/client/events`
+- `GET /v1/client/profile/me`
+- `GET /v1/client/profile/me/stream`
+
+These routes require a short-lived bearer token issued by the customer's backend.
+The browser package rejects server-authoritative event context fields such as
+`xp`, `wallet`, `wallets`, `level`, `perks`, `rewards` and `achievements`.
+
+Profile helpers:
+
+| Method             | Purpose                                                                  |
+| ------------------ | ------------------------------------------------------------------------ |
+| `getProfile()`     | Returns the raw typed profile response from `GET /v1/client/profile/me`. |
+| `profile()`        | Alias for `getProfile()`.                                                |
+| `getProfileJson()` | Returns a JSON-safe profile snapshot for app/storefront rendering.       |
+| `profileJson()`    | Alias for `getProfileJson()`.                                            |
+
+`getProfileJson()` omits `traits` by default because customer traits can contain
+personal data. Opt in only when the current page needs them:
+
+```ts
+const profile = await perkamo.getProfileJson({ includeTraits: true });
+```
+
+Security defaults:
+
+- `baseUrl` must use HTTPS unless it is localhost or `allowInsecureHttp` is set
+  for local testing.
+- Runtime options named `apiKey`, `serverApiKey`, `secret` or `signingSecret`
+  are rejected before any network request.
+- Browser tokens should be kept in memory and refreshed through `getToken`.
+- Profile streams require `getStreamToken` so a regular bearer token is not put
+  into an EventSource URL.
+
+```ts
+const perkamo = createPerkamoBrowserClient({
+  baseUrl: "https://api.perkamo.com",
+  tenant: "commerce-test",
+  getToken: () => fetchJson("/api/perkamo/token").then((body) => body.token),
+  getStreamToken: () =>
+    fetchJson("/api/perkamo/stream-token").then((body) => body.token),
+});
+
+const subscription = perkamo.subscribeProfile((profile) => {
+  renderProfile(profile);
+});
+```
+
+## Progress Widget
+
+```ts
+import {
+  createPerkamoBrowserClient,
+  mountPerkamoProgressWidget,
+} from "@perkamo/browser";
+
+const client = createPerkamoBrowserClient({
+  baseUrl: "https://api.perkamo.com",
+  tenant: "commerce-test",
+  getToken: () =>
+    fetch("/api/perkamo/token", { method: "POST" })
+      .then((r) => r.json())
+      .then((r) => r.token),
+});
+
+mountPerkamoProgressWidget({
+  client,
+  target: "#perkamo-progress",
+});
+```
+
+The widget is intentionally small and unstyled. Customers should own the final
+presentation in their app or storefront theme.

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+import { type EventIngestResponse, type PerkamoAchievements, type PerkamoEventContext, type PerkamoLevel, type PerkamoLevelProgress, type PerkamoNextPerk, type PerkamoProfile, type PerkamoProfileFlags, type PerkamoUnlockedPerk } from "@perkamo/sdk-core";
+export { PerkamoApiError, type EventIngestResponse, type PerkamoProfile, } from "@perkamo/sdk-core";
+export type BrowserTokenProvider = () => string | Promise<string>;
+export type PerkamoBrowserClientOptions = {
+    baseUrl: string;
+    tenant: string;
+    getToken: BrowserTokenProvider;
+    getStreamToken?: BrowserTokenProvider;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+    allowInsecureHttp?: boolean;
+};
+export type BrowserEmitOptions = {
+    txId?: string;
+    occurredAt?: Date;
+};
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type PerkamoProfileJsonOptions = {
+    /**
+     * Profile traits can contain customer-defined personal data. The browser JSON
+     * helper omits them unless the integration opts in explicitly.
+     */
+    includeTraits?: boolean;
+};
+export type PerkamoProfileJson = {
+    user_id: string;
+    traits?: JsonObject;
+    wallets: Record<string, number>;
+    level: PerkamoLevel;
+    progress?: PerkamoLevelProgress;
+    perks: PerkamoUnlockedPerk[];
+    next_perks: PerkamoNextPerk[];
+    achievements: PerkamoAchievements;
+    flags: PerkamoProfileFlags;
+};
+export type PerkamoBrowserClient = {
+    emit(event: string, context?: PerkamoEventContext, options?: BrowserEmitOptions): Promise<EventIngestResponse>;
+    getProfile(): Promise<PerkamoProfile>;
+    profile(): Promise<PerkamoProfile>;
+    getProfileJson(options?: PerkamoProfileJsonOptions): Promise<PerkamoProfileJson>;
+    profileJson(options?: PerkamoProfileJsonOptions): Promise<PerkamoProfileJson>;
+    subscribeProfile(onProfile: (profile: PerkamoProfile) => void, onError?: (error: Event | Error) => void): {
+        close(): void;
+    };
+};
+export type PerkamoProgressWidgetOptions = {
+    client: PerkamoBrowserClient;
+    target: Element | string;
+    labels?: {
+        level?: string;
+        points?: string;
+        perks?: string;
+        loading?: string;
+        error?: string;
+    };
+};
+export declare function toProfileJson(profile: PerkamoProfile, options?: PerkamoProfileJsonOptions): PerkamoProfileJson;
+export declare function createPerkamoBrowserClient(options: PerkamoBrowserClientOptions): PerkamoBrowserClient;
+export declare function mountPerkamoProgressWidget(options: PerkamoProgressWidgetOptions): {
+    refresh(): Promise<void>;
+    destroy(): void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,232 @@
+import { PerkamoApiError, assertSafeEventInput, createTransactionId, } from "@perkamo/sdk-core";
+export { PerkamoApiError, } from "@perkamo/sdk-core";
+function requireFetch(customFetch) {
+    const fetcher = customFetch ?? globalThis.fetch;
+    if (!fetcher) {
+        throw new Error("@perkamo/browser requires fetch support");
+    }
+    return fetcher;
+}
+function assertNoServerSecrets(options) {
+    for (const key of ["apiKey", "serverApiKey", "secret", "signingSecret"]) {
+        if (key in options) {
+            throw new Error(`@perkamo/browser does not accept '${key}'. Mint short-lived browser tokens on your backend and pass getToken instead.`);
+        }
+    }
+}
+function assertSecureBaseUrl(baseUrl, allowInsecureHttp) {
+    const url = new URL(baseUrl);
+    if (url.protocol === "https:")
+        return;
+    const localHosts = new Set(["localhost", "127.0.0.1", "::1", "[::1]"]);
+    if (url.protocol === "http:" && (allowInsecureHttp || localHosts.has(url.hostname))) {
+        return;
+    }
+    throw new Error("@perkamo/browser requires an HTTPS baseUrl. Use allowInsecureHttp only for local development.");
+}
+function requireDocument() {
+    if (!globalThis.document) {
+        throw new Error("Perkamo widgets require a browser document");
+    }
+    return globalThis.document;
+}
+function requireEventSource() {
+    if (!globalThis.EventSource) {
+        throw new Error("Perkamo profile streams require EventSource support");
+    }
+    return globalThis.EventSource;
+}
+function fetchWithTimeout(fetcher, input, init, timeoutMs) {
+    if (!timeoutMs)
+        return fetcher(input, init);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    return fetcher(input, { ...init, signal: controller.signal }).finally(() => clearTimeout(timer));
+}
+async function throwIfError(response) {
+    if (response.ok)
+        return;
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        body = null;
+    }
+    throw new PerkamoApiError(response.status, body);
+}
+async function authorizationHeader(getToken) {
+    const token = await getToken();
+    if (!token.trim()) {
+        throw new Error("@perkamo/browser getToken returned an empty token");
+    }
+    return `Bearer ${token}`;
+}
+function cloneJsonValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function optionalJsonObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    return cloneJsonValue(value);
+}
+export function toProfileJson(profile, options = {}) {
+    return {
+        user_id: profile.user_id,
+        ...(options.includeTraits
+            ? { traits: optionalJsonObject(profile.traits) ?? {} }
+            : {}),
+        wallets: cloneJsonValue(profile.wallets),
+        level: cloneJsonValue(profile.level),
+        ...(profile.progress ? { progress: cloneJsonValue(profile.progress) } : {}),
+        perks: cloneJsonValue(profile.perks),
+        next_perks: cloneJsonValue(profile.next_perks),
+        achievements: cloneJsonValue(profile.achievements),
+        flags: cloneJsonValue(profile.flags),
+    };
+}
+export function createPerkamoBrowserClient(options) {
+    assertNoServerSecrets(options);
+    assertSecureBaseUrl(options.baseUrl, options.allowInsecureHttp === true);
+    const fetcher = requireFetch(options.fetch);
+    const baseUrl = options.baseUrl.replace(/\/$/, "");
+    async function go(input, init) {
+        return fetchWithTimeout(fetcher, input, init, options.timeoutMs);
+    }
+    async function headers(withBody = false) {
+        return {
+            ...(withBody ? { "content-type": "application/json" } : {}),
+            authorization: await authorizationHeader(options.getToken),
+        };
+    }
+    async function getProfile() {
+        const response = await go(`${baseUrl}/v1/client/profile/me`, {
+            headers: await headers(),
+        });
+        await throwIfError(response);
+        return response.json();
+    }
+    async function getProfileJson(profileOptions = {}) {
+        return toProfileJson(await getProfile(), profileOptions);
+    }
+    return {
+        async emit(event, context = {}, emitOptions = {}) {
+            const input = {
+                tenant: options.tenant,
+                user_id: "me",
+                event,
+                transaction_id: emitOptions.txId ?? createTransactionId(),
+                context,
+                occurred_at: (emitOptions.occurredAt ?? new Date()).toISOString(),
+            };
+            assertSafeEventInput(input);
+            const response = await go(`${baseUrl}/v1/client/events`, {
+                method: "POST",
+                headers: await headers(true),
+                body: JSON.stringify({
+                    event: input.event,
+                    transaction_id: input.transaction_id,
+                    context: input.context,
+                    occurred_at: input.occurred_at,
+                }),
+            });
+            await throwIfError(response);
+            return response.json();
+        },
+        getProfile,
+        profile: getProfile,
+        getProfileJson,
+        profileJson: getProfileJson,
+        subscribeProfile(onProfile, onError) {
+            if (!options.getStreamToken) {
+                throw new Error("@perkamo/browser profile streams require getStreamToken so regular bearer tokens are not placed in URLs");
+            }
+            const EventSourceCtor = requireEventSource();
+            const url = new URL(`${baseUrl}/v1/client/profile/me/stream`);
+            url.searchParams.set("tenant", options.tenant);
+            let closed = false;
+            let source = null;
+            void Promise.resolve(options.getStreamToken())
+                .then((token) => {
+                if (closed)
+                    return;
+                if (!token.trim()) {
+                    throw new Error("@perkamo/browser getStreamToken returned an empty token");
+                }
+                url.searchParams.set("token", token);
+                source = new EventSourceCtor(url.toString());
+                source.onmessage = (event) => {
+                    try {
+                        onProfile(JSON.parse(event.data));
+                    }
+                    catch (caught) {
+                        onError?.(caught instanceof Error
+                            ? caught
+                            : new Error("Perkamo profile stream message could not be parsed"));
+                    }
+                };
+                source.onerror = (event) => onError?.(event);
+            })
+                .catch((error) => onError?.(error instanceof Error ? error : new Error(String(error))));
+            return {
+                close() {
+                    closed = true;
+                    source?.close();
+                },
+            };
+        },
+    };
+}
+function resolveTarget(target) {
+    if (typeof target !== "string")
+        return target;
+    const element = requireDocument().querySelector(target);
+    if (!element) {
+        throw new Error(`Perkamo widget target '${target}' was not found`);
+    }
+    return element;
+}
+function renderProfile(target, profile, labels) {
+    const level = profile.level;
+    const points = Object.entries(profile.wallets)
+        .map(([wallet, value]) => `${wallet}: ${value}`)
+        .join(" · ");
+    target.textContent = [
+        `${labels.level} ${level.level}`,
+        `${labels.points}: ${points || "0"}`,
+        `${labels.perks}: ${profile.perks.length}`,
+    ].join("\n");
+}
+export function mountPerkamoProgressWidget(options) {
+    const target = resolveTarget(options.target);
+    const labels = {
+        level: options.labels?.level ?? "Level",
+        points: options.labels?.points ?? "Points",
+        perks: options.labels?.perks ?? "Perks",
+        loading: options.labels?.loading ?? "Loading Perkamo profile...",
+        error: options.labels?.error ?? "Unable to load Perkamo profile.",
+    };
+    let destroyed = false;
+    async function refresh() {
+        target.textContent = labels.loading;
+        try {
+            const profile = await options.client.profile();
+            if (!destroyed)
+                renderProfile(target, profile, labels);
+        }
+        catch {
+            if (!destroyed)
+                target.textContent = labels.error;
+        }
+    }
+    void refresh();
+    return {
+        refresh,
+        destroy() {
+            destroyed = true;
+            target.textContent = "";
+            target.innerHTML = "";
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@perkamo/browser",
+  "version": "0.1.1",
+  "description": "Browser-safe Perkamo client and widget helpers.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run src",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "format": "prettier --write src",
+    "format:check": "prettier --check src"
+  },
+  "dependencies": {
+    "@perkamo/sdk-core": "0.1.1"
+  },
+  "devDependencies": {
+    "vitest": "4.1.7"
+  }
+}