@perkamo/sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.1.0 - 2026-06-02
+
+### Added
+
+- Initial public JavaScript and TypeScript SDK package for trusted backend
+  integrations.
+- Added `createPerkamoClient` with `emit`, `batch`, `profile` and preview
+  `subscribeProfile` helpers.
+- Added automatic tenant API key headers for server-side REST calls.
+- Added automatic HMAC request signatures for mutating event ingestion calls.
+- Added configurable `fetch` adapter and request timeout support.
+- Re-exported shared public response and profile types from `@perkamo/sdk-core`.
+
+### Security
+
+- Signs mutating API requests with `x-perkamo-timestamp` and
+  `x-perkamo-signature`, binding the HTTP method, path and raw JSON body to the
+  server API key.
+- Keeps tenant server API keys as backend-only configuration; browser/profile
+  stream support requires short-lived tokens and remains preview-labeled.

package/README.md

@@ -0,0 +1,90 @@
+# `@perkamo/sdk`
+
+Server-side JavaScript and TypeScript client for the Perkamo API.
+
+See the full customer developer guide in
+[`../../docs/sdk-api.md`](../../docs/sdk-api.md).
+
+## Quick Start
+
+```ts
+import { createPerkamoClient } from "@perkamo/sdk";
+
+const perkamo = createPerkamoClient({
+  baseUrl: "https://api.perkamo.com",
+  tenant: "commerce-test",
+  apiKey: () => process.env.PERKAMO_SECRET_KEY,
+});
+
+const result = await perkamo.emit(
+  "customer_123",
+  "purchase.completed",
+  {
+    order_id: "order_1092",
+    amount: 12900,
+    currency: "CZK",
+  },
+  { txId: "order_1092" },
+);
+// result: EventIngestResponse — delta, wallet_state, level, unlocked, …
+```
+
+## API
+
+### `createPerkamoClient(options): PerkamoClient`
+
+| Option      | Type                                        | Description                                  |
+| ----------- | ------------------------------------------- | -------------------------------------------- |
+| `baseUrl`   | `string`                                    | API base URL, e.g. `https://api.perkamo.com` |
+| `tenant`    | `string`                                    | Space slug, e.g. `commerce-test`             |
+| `apiKey`    | `string \| () => string \| Promise<string>` | Server API key — never in browser code       |
+| `fetch`     | `typeof fetch`                              | Custom fetch for tests or edge runtimes      |
+| `timeoutMs` | `number`                                    | Request timeout in milliseconds              |
+
+### `client.emit(userId, event, context?, options?): Promise<EventIngestResponse>`
+
+Sends one activity event to `POST /v1/events`. Auto-generates a transaction ID when `options.txId` is omitted.
+
+### `client.batch(events): Promise<BatchIngestResponse>`
+
+Sends up to 100 events in one request to `POST /v1/events:batch`. Each event requires an explicit `transaction_id`. The client `tenant` is injected when `event.tenant` is omitted.
+
+### `client.profile(userId): Promise<PerkamoProfile>`
+
+Reads the current server-authoritative profile from `GET /v1/profile/{userId}`.
+
+### `client.subscribeProfile(userId, streamToken, onProfile, onError?): ProfileSubscription`
+
+Preview helper for the planned profile SSE stream flow. Do not treat this as a stable v1 server API contract yet; the stable v1 public HTTP API is backend-first. When profile streams are enabled for an integration, they require a short-lived stream token minted by your backend — never pass tenant API keys to browser subscriptions.
+
+### `PerkamoApiError`
+
+Thrown on non-2xx responses. Has `status: number` and `body: unknown` properties.
+
+```ts
+import { PerkamoApiError } from "@perkamo/sdk";
+
+try {
+  await perkamo.emit("user", "event");
+} catch (err) {
+  if (err instanceof PerkamoApiError) {
+    console.error(err.status, err.body);
+  }
+}
+```
+
+## Reserved context fields
+
+The SDK rejects context keys that Perkamo computes server-side: `xp`, `wallet`, `wallets`, `rewards`, `level`, `perks`, `achievements`. Use event context only for business facts (order ID, amount, category).
+
+## Security
+
+Server API keys belong only in your backend or secret manager — never in browser,
+mobile, or embedded widget code. Browser-token key metadata and allowed request
+origins are separate from customer-site CSP, but client-safe browser routes and
+profile stream token verification are preview work rather than stable v1 API
+surface.
+
+The SDK automatically signs mutating API requests with
+`x-perkamo-timestamp` and `x-perkamo-signature`, binding the method, path and
+raw JSON body to the server API key.

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+import { type BatchIngestResponse, type EventIngestResponse, type PerkamoEventContext, type PerkamoProfile } from "@perkamo/sdk-core";
+export { PerkamoApiError, type BatchIngestResponse, type EventIngestResponse, type PerkamoProfile, type WalletDelta, type PerkamoLevel, type PerkamoUnlockedPerk, type PerkamoProfileFlags, } from "@perkamo/sdk-core";
+export type PerkamoClientOptions = {
+    /** Perkamo API base URL, e.g. `https://api.perkamo.com`. */
+    baseUrl: string;
+    /** Space slug, e.g. `commerce-test`. Must match the API key's Space. */
+    tenant: string;
+    /**
+     * Server API key or an async function that returns one.
+     * Keep server keys in backend environment variables — never in browser code.
+     */
+    apiKey?: string | (() => string | Promise<string>);
+    /** Custom fetch implementation for tests or runtimes without global fetch. */
+    fetch?: typeof fetch;
+    /** Request timeout in milliseconds. Default: no timeout. */
+    timeoutMs?: number;
+};
+export type EmitOptions = {
+    /**
+     * Idempotency key. Use a stable business ID (order ID, booking ID, …).
+     * The SDK generates a UUID when omitted — safe for low-stakes events.
+     */
+    txId?: string;
+    /** Event timestamp. Defaults to current time when omitted. */
+    occurredAt?: Date;
+};
+/**
+ * A single event for `batch()`. `tenant` is optional — when omitted it
+ * inherits from the client's configured `tenant`.
+ */
+export type BatchEventInput = {
+    user_id: string;
+    event: string;
+    /** Idempotency key. Required — unlike `emit()`, batch does not auto-generate. */
+    transaction_id: string;
+    /** Overrides the client tenant for this event. Rarely needed. */
+    tenant?: string;
+    context?: PerkamoEventContext;
+    occurred_at?: string;
+};
+export type ProfileSubscription = {
+    close(): void;
+};
+export type PerkamoClient = {
+    /**
+     * Sends one activity event to `POST /v1/events`.
+     *
+     * @param userId  Your stable user identifier.
+     * @param event   Stable event name, e.g. `purchase.completed`.
+     * @param context Supporting facts. Do not include computed state fields.
+     * @param options Override transaction ID or event timestamp.
+     */
+    emit(userId: string, event: string, context?: PerkamoEventContext, options?: EmitOptions): Promise<EventIngestResponse>;
+    /**
+     * Sends up to 100 events in one request to `POST /v1/events:batch`.
+     * Each event requires an explicit `transaction_id`.
+     * `tenant` defaults to the client's configured `tenant` when omitted.
+     */
+    batch(events: BatchEventInput[]): Promise<BatchIngestResponse>;
+    /**
+     * Reads the current server-authoritative profile state from
+     * `GET /v1/profile/{userId}`.
+     */
+    profile(userId: string): Promise<PerkamoProfile>;
+    /**
+     * Opens a profile SSE stream with a short-lived stream token minted by the
+     * customer backend. Never pass tenant API keys to browser subscriptions.
+     */
+    subscribeProfile(userId: string, streamToken: string, onProfile: (profile: PerkamoProfile) => void, onError?: (error: Event | Error) => void): ProfileSubscription;
+};
+export type PerkamoRequestSignatureInput = {
+    apiKey: string;
+    timestamp: string;
+    method: string;
+    path: string;
+    body: string;
+};
+export declare function createPerkamoRequestSignature(input: PerkamoRequestSignatureInput): Promise<string>;
+export declare function createPerkamoClient(options: PerkamoClientOptions): PerkamoClient;
+//# 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":"AAAA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAExB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,MAAM,oBAAoB,GAAG;IACjC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,UAAU,CAAC,EAAE,IAAI,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAIF,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;;;OAOG;IACH,IAAI,CACF,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE/D;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjD;;;OAGG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,EAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,KAAK,IAAI,GACvC,mBAAmB,CAAC;CACxB,CAAC;AAMF,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AA2BF,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAqED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAqGhF"}

package/dist/index.js

@@ -0,0 +1,179 @@
+import { assertSafeEventInput, createTransactionId, PerkamoApiError, } from "@perkamo/sdk-core";
+export { PerkamoApiError, } from "@perkamo/sdk-core";
+// ─── Internal helpers ─────────────────────────────────────────────────────────
+const signatureVersion = "v1";
+async function resolveApiKey(apiKey) {
+    return typeof apiKey === "function" ? apiKey() : apiKey;
+}
+function bytesToHex(bytes) {
+    return Array.from(bytes)
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+}
+async function sha256Hex(value) {
+    const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(value));
+    return bytesToHex(new Uint8Array(digest));
+}
+function requestPath(input) {
+    const url = new URL(input);
+    return `${url.pathname}${url.search}`;
+}
+export async function createPerkamoRequestSignature(input) {
+    const encoder = new TextEncoder();
+    const key = await globalThis.crypto.subtle.importKey("raw", encoder.encode(input.apiKey), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const baseString = [
+        signatureVersion,
+        input.timestamp,
+        input.method.toUpperCase(),
+        input.path,
+        await sha256Hex(input.body),
+    ].join(".");
+    const signature = await globalThis.crypto.subtle.sign("HMAC", key, encoder.encode(baseString));
+    return `${signatureVersion}=${bytesToHex(new Uint8Array(signature))}`;
+}
+async function authorizedHeaders(options, withBody = false, signedRequest) {
+    const headers = {};
+    if (withBody)
+        headers["content-type"] = "application/json";
+    const apiKey = await resolveApiKey(options.apiKey);
+    if (apiKey) {
+        headers["x-perkamo-api-key"] = apiKey;
+        if (signedRequest) {
+            const timestamp = String(Math.floor(Date.now() / 1000));
+            headers["x-perkamo-timestamp"] = timestamp;
+            headers["x-perkamo-signature"] = await createPerkamoRequestSignature({
+                apiKey,
+                timestamp,
+                method: signedRequest.method,
+                path: requestPath(signedRequest.input),
+                body: signedRequest.body,
+            });
+        }
+    }
+    return headers;
+}
+function requireFetch(customFetch) {
+    const fetcher = customFetch ?? globalThis.fetch;
+    if (!fetcher) {
+        throw new Error("Perkamo SDK requires fetch or a fetch-compatible adapter");
+    }
+    return fetcher;
+}
+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));
+}
+function requireEventSource() {
+    if (!globalThis.EventSource) {
+        throw new Error("Perkamo profile subscriptions require EventSource support");
+    }
+    return globalThis.EventSource;
+}
+async function throwIfError(response) {
+    if (response.ok)
+        return;
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        body = null;
+    }
+    throw new PerkamoApiError(response.status, body);
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+export function createPerkamoClient(options) {
+    const fetcher = requireFetch(options.fetch);
+    const baseUrl = options.baseUrl.replace(/\/$/, "");
+    function go(input, init) {
+        return fetchWithTimeout(fetcher, input, init, options.timeoutMs);
+    }
+    return {
+        async emit(userId, event, context = {}, emitOptions = {}) {
+            const input = {
+                tenant: options.tenant,
+                user_id: userId,
+                event,
+                transaction_id: emitOptions.txId ?? createTransactionId(),
+                context,
+                occurred_at: (emitOptions.occurredAt ?? new Date()).toISOString(),
+            };
+            assertSafeEventInput(input);
+            const url = `${baseUrl}/v1/events`;
+            const body = JSON.stringify(input);
+            const response = await go(url, {
+                method: "POST",
+                headers: await authorizedHeaders(options, true, {
+                    method: "POST",
+                    input: url,
+                    body,
+                }),
+                body,
+            });
+            await throwIfError(response);
+            return response.json();
+        },
+        async batch(events) {
+            const fullEvents = events.map((e) => ({
+                tenant: e.tenant ?? options.tenant,
+                user_id: e.user_id,
+                event: e.event,
+                transaction_id: e.transaction_id,
+                context: e.context,
+                occurred_at: e.occurred_at,
+            }));
+            for (const event of fullEvents)
+                assertSafeEventInput(event);
+            const url = `${baseUrl}/v1/events:batch`;
+            const body = JSON.stringify({ events: fullEvents });
+            const response = await go(url, {
+                method: "POST",
+                headers: await authorizedHeaders(options, true, {
+                    method: "POST",
+                    input: url,
+                    body,
+                }),
+                body,
+            });
+            await throwIfError(response);
+            return response.json();
+        },
+        async profile(userId) {
+            const response = await go(`${baseUrl}/v1/profile/${encodeURIComponent(userId)}`, {
+                headers: await authorizedHeaders(options, false),
+            });
+            await throwIfError(response);
+            return response.json();
+        },
+        subscribeProfile(userId, streamToken, onProfile, onError) {
+            if (!streamToken.trim()) {
+                throw new Error("Perkamo profile subscriptions require a short-lived stream token");
+            }
+            const EventSourceCtor = requireEventSource();
+            const url = new URL(`${baseUrl}/v1/profile/${encodeURIComponent(userId)}/stream`);
+            url.searchParams.set("tenant", options.tenant);
+            url.searchParams.set("token", streamToken);
+            const 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);
+            return {
+                close() {
+                    source.close();
+                },
+            };
+        },
+    };
+}
+//# 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/sdk",
+  "version": "0.1.0",
+  "description": "Browser, Node.js and React Native compatible Perkamo client.",
+  "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.0"
+  },
+  "devDependencies": {
+    "vitest": "4.1.7"
+  }
+}