@toktikhq/sdk-js 0.2.0

package/dist/index.js

@@ -0,0 +1,66 @@
+import { HttpTransport } from "./http.js";
+import { AccountResource, ContentResource, CreatorsResource, ExportsResource, GiftersResource, LiveResource, RankingsResource, TrendsResource } from "./resources.js";
+import { RealtimeStream } from "./realtime.js";
+export * from "./http.js";
+export * from "./resources.js";
+export * from "./realtime.js";
+/**
+ * Typed client for the TokTik Developer API.
+ *
+ * ```ts
+ * const client = new TokTikClient({ apiKey: process.env.TOKTIK_API_KEY! });
+ * const board = await client.rankings.official({ board: "hourly", region: "VN" });
+ * const stream = await client.live.stream(["@creator"], { onEvent: (e) => console.log(e.event) });
+ * ```
+ *
+ * Most data methods return the provenance envelope **unchanged** — `data` alongside the `provenance`
+ * block describing how fresh the answer is and how it was obtained. The SDK never strips it, because
+ * for observed (rather than officially published) data that context is part of the answer.
+ * `exports.*` and `account.usage()` are the documented exceptions: the server does not envelope them.
+ */
+export class TokTikClient {
+    http;
+    live;
+    rankings;
+    creators;
+    content;
+    gifters;
+    trends;
+    exports;
+    account;
+    constructor(options) {
+        this.http = new HttpTransport(options);
+        const live = new LiveResource(this.http);
+        this.live = Object.assign(live, {
+            stream: async (creatorIds, handlers, streamOptions = {}) => {
+                const stream = new RealtimeStream(async () => {
+                    const minted = await live.streamToken();
+                    return { token: minted.token, wsUrl: minted.wsUrl };
+                }, handlers, streamOptions);
+                await stream.connect(creatorIds);
+                return stream;
+            }
+        });
+        this.rankings = new RankingsResource(this.http);
+        this.creators = new CreatorsResource(this.http);
+        this.content = new ContentResource(this.http);
+        this.gifters = new GiftersResource(this.http);
+        this.trends = new TrendsResource(this.http);
+        this.exports = new ExportsResource(this.http);
+        this.account = new AccountResource(this.http);
+    }
+    // --- Pre-D3.1 surface, kept so existing callers keep compiling. Prefer the namespaces above. ---
+    /** @deprecated Use `client.live.listSessions()`. */
+    listLiveSessions(options = {}) {
+        return this.live.listSessions(options);
+    }
+    /** @deprecated Use `client.live.getSession()`. */
+    getLiveSession(id) {
+        return this.live.getSession(id);
+    }
+    /** @deprecated Use `client.live.creatorPerformance()`. */
+    listCreatorPerformance(creatorUniqueId, options = {}) {
+        return this.live.creatorPerformance(creatorUniqueId, options);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAA4B,MAAM,WAAW,CAAC;AACpE,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,cAAc,EAGf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAqD,MAAM,eAAe,CAAC;AAElG,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAE9B;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,YAAY;IACN,IAAI,CAAgB;IAE5B,IAAI,CAOX;IACO,QAAQ,CAAmB;IAC3B,QAAQ,CAAmB;IAC3B,OAAO,CAAkB;IACzB,OAAO,CAAkB;IACzB,MAAM,CAAiB;IACvB,OAAO,CAAkB;IACzB,OAAO,CAAkB;IAElC,YAAY,OAA4B;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YAC9B,MAAM,EAAE,KAAK,EACX,UAAoB,EACpB,QAA0B,EAC1B,gBAAuC,EAAE,EACzC,EAAE;gBACF,MAAM,MAAM,GAAG,IAAI,cAAc,CAC/B,KAAK,IAAI,EAAE;oBACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;oBACxC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtD,CAAC,EACD,QAAQ,EACR,aAAa,CACd,CAAC;gBACF,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACjC,OAAO,MAAM,CAAC;YAChB,CAAC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,kGAAkG;IAElG,oDAAoD;IACpD,gBAAgB,CACd,UAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,kDAAkD;IAClD,cAAc,CAAC,EAAU;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,0DAA0D;IAC1D,sBAAsB,CACpB,eAAuB,EACvB,UAA6B,EAAE;QAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/realtime.js

@@ -0,0 +1,197 @@
+function defaultSocketFactory(url, token) {
+    const Ctor = globalThis.WebSocket;
+    if (!Ctor) {
+        throw new Error("No WebSocket implementation is available. Pass RealtimeStreamOptions.socketFactory (e.g. wrapping the `ws` package on Node).");
+    }
+    // Two values, in this order: the literal marker `bearer` then the token. The gateway selects and
+    // echoes `bearer` (never the token), and a WebSocket client that offered subprotocols closes the
+    // socket immediately if the server selects none — so the marker MUST be offered verbatim. The
+    // combined `bearer.<token>` form the gateway also parses does NOT satisfy that echo, which is how
+    // this manifests: the handshake authenticates, then the connection drops within milliseconds.
+    return new Ctor(url, ["bearer", token]);
+}
+/**
+ * A live subscription set over one WebSocket.
+ *
+ * Owns three things the caller should not have to: token lifetime (re-minted per connection, so an
+ * expiry mid-stream costs a reconnect rather than a dead socket), reconnection with exponential
+ * backoff + jitter (a fleet reconnecting in lockstep after a gateway restart is a self-inflicted
+ * thundering herd), and subscription resume — the gateway keeps no per-connection memory, so the
+ * new socket must re-subscribe or the caller silently receives nothing.
+ */
+export class RealtimeStream {
+    mintToken;
+    handlers;
+    socket = null;
+    creators = new Set();
+    closed = false;
+    attempt = 0;
+    /** True only between `onopen` and the socket going away — `send()` before this throws in real runtimes. */
+    opened = false;
+    reconnectTimer = null;
+    /**
+     * Bumped by `close()` and by each `open()`. An `open()` that started before the bump finds its
+     * generation stale and discards the socket it just created — otherwise `close()` racing an
+     * in-flight `open()` leaves a live, unreferenced socket behind (still billed, never closed).
+     */
+    generation = 0;
+    options;
+    constructor(mintToken, handlers, options = {}) {
+        this.mintToken = mintToken;
+        this.handlers = handlers;
+        this.options = {
+            maxReconnectAttempts: options.maxReconnectAttempts ?? Infinity,
+            baseReconnectDelayMs: options.baseReconnectDelayMs ?? 500,
+            maxReconnectDelayMs: options.maxReconnectDelayMs ?? 30_000,
+            socketFactory: options.socketFactory ?? defaultSocketFactory,
+            setTimeoutImpl: options.setTimeoutImpl ?? ((handler, ms) => setTimeout(handler, ms)),
+            clearTimeoutImpl: options.clearTimeoutImpl ?? ((handle) => clearTimeout(handle)),
+            random: options.random ?? Math.random
+        };
+    }
+    /** Creators currently subscribed (survives reconnects). */
+    get subscriptions() {
+        return [...this.creators];
+    }
+    /** True only once the socket is OPEN and accepting frames — not merely constructed. */
+    get isConnected() {
+        return this.socket !== null && this.opened;
+    }
+    async connect(creatorIds = []) {
+        for (const creatorId of creatorIds)
+            this.creators.add(normalizeCreatorId(creatorId));
+        await this.open();
+    }
+    subscribe(creatorId) {
+        const normalized = normalizeCreatorId(creatorId);
+        this.creators.add(normalized);
+        this.send({ type: "subscribe", creatorId: normalized });
+    }
+    unsubscribe(creatorId) {
+        const normalized = normalizeCreatorId(creatorId);
+        this.creators.delete(normalized);
+        this.send({ type: "unsubscribe", creatorId: normalized });
+    }
+    /** Stop for good. Cancels reconnection — this is not a transient drop. */
+    close() {
+        this.closed = true;
+        this.generation += 1;
+        this.opened = false;
+        if (this.reconnectTimer !== null) {
+            this.options.clearTimeoutImpl(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        const socket = this.socket;
+        this.socket = null;
+        socket?.close(1000, "client closed");
+    }
+    send(message) {
+        // Only a socket that has actually OPENED accepts frames — a real WebSocket throws
+        // `InvalidStateError` while CONNECTING. Mid-connect / mid-reconnect the intent already lives in
+        // `creators`, and the resume on the next open replays it, so dropping the frame here is correct.
+        if (!this.opened)
+            return;
+        this.socket?.send(JSON.stringify(message));
+    }
+    async open() {
+        if (this.closed)
+            return;
+        // A fresh token per connection is what makes expiry a non-event: the only way a token dies
+        // mid-stream is if the socket outlives it, and any reconnect re-mints.
+        // An explicit reconnect supersedes any armed retry; leaving it armed causes a second, pointless
+        // teardown + token mint moments later.
+        if (this.reconnectTimer !== null) {
+            this.options.clearTimeoutImpl(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        const generation = ++this.generation;
+        // A second `connect()`/reconnect supersedes whatever is live now — tear it down before building
+        // the replacement, or the old socket keeps streaming (and billing) with nobody holding it.
+        const superseded = this.socket;
+        this.socket = null;
+        this.opened = false;
+        superseded?.close(1000, "superseded");
+        const { token, wsUrl } = await this.mintToken();
+        // `close()` (or another open) may have happened while the token was in flight.
+        if (this.closed || generation !== this.generation)
+            return;
+        const socket = this.options.socketFactory(wsUrl, token);
+        if (this.closed || generation !== this.generation) {
+            socket.close(1000, "superseded");
+            return;
+        }
+        this.socket = socket;
+        socket.onopen = () => {
+            if (generation !== this.generation)
+                return;
+            const attemptThatSucceeded = this.attempt;
+            this.attempt = 0;
+            this.opened = true;
+            for (const creatorId of this.creators)
+                socket.send(JSON.stringify({ type: "subscribe", creatorId }));
+            // Report the attempt number that actually reconnected, not the reset counter.
+            if (attemptThatSucceeded > 0)
+                this.handlers.onReconnect?.(attemptThatSucceeded);
+        };
+        socket.onmessage = (event) => {
+            const raw = typeof event.data === "string" ? event.data : String(event.data);
+            let frame;
+            try {
+                frame = JSON.parse(raw);
+            }
+            catch {
+                this.handlers.onError?.(new Error(`realtime frame was not JSON: ${raw.slice(0, 120)}`));
+                return;
+            }
+            if (frame.type === "event")
+                this.handlers.onEvent?.(frame);
+            else if (frame.type === "status")
+                this.handlers.onStatus?.(frame);
+            else if (frame.type === "error")
+                this.handlers.onError?.(frame);
+        };
+        socket.onerror = () => {
+            // `onclose` always follows; reconnecting from both would double-schedule.
+            this.handlers.onError?.(new Error("realtime socket error"));
+        };
+        socket.onclose = () => {
+            if (generation !== this.generation)
+                return;
+            this.socket = null;
+            this.opened = false;
+            if (this.closed)
+                return;
+            this.scheduleReconnect();
+        };
+    }
+    scheduleReconnect() {
+        // Reachable from the open() catch path after a close(), where retrying is not wanted.
+        if (this.closed)
+            return;
+        if (this.attempt >= this.options.maxReconnectAttempts) {
+            this.handlers.onError?.(new Error(`realtime reconnect gave up after ${this.attempt} attempts`));
+            return;
+        }
+        this.attempt += 1;
+        // Exponential backoff with FULL jitter: without jitter every client of a restarted gateway
+        // returns in the same instant and knocks it over again.
+        const ceiling = Math.min(this.options.maxReconnectDelayMs, this.options.baseReconnectDelayMs * 2 ** (this.attempt - 1));
+        const delay = Math.floor(this.options.random() * ceiling);
+        this.reconnectTimer = this.options.setTimeoutImpl(() => {
+            this.reconnectTimer = null;
+            if (this.closed)
+                return;
+            void this.open().catch((error) => {
+                this.handlers.onError?.(error instanceof Error ? error : new Error(String(error)));
+                // A failed re-mint (e.g. 402/403) must not end the loop silently; back off and retry.
+                this.scheduleReconnect();
+            });
+        }, delay);
+    }
+}
+/** Mirrors the gateway's own normalisation so the SDK and server agree on subscription identity. */
+export function normalizeCreatorId(value) {
+    const trimmed = value.trim().replace(/^@/u, "");
+    return /^[a-zA-Z0-9._]{2,24}$/u.test(trimmed) ? trimmed.toLowerCase() : trimmed;
+}
+//# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

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

package/dist/resources.js

@@ -0,0 +1,208 @@
+/** `live:read` + `live:stream` — LIVE sessions, per-creator performance, realtime handshake token. */
+export class LiveResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    listSessions(options = {}) {
+        return this.http.get("/v1/live/sessions", { ...options });
+    }
+    getSession(id) {
+        return this.http.get(`/v1/live/sessions/${encodeURIComponent(id)}`);
+    }
+    creatorPerformance(creatorUniqueId, options = {}) {
+        return this.http.get(`/v1/live/creators/${encodeURIComponent(creatorUniqueId)}/performance`, { ...options });
+    }
+    /**
+     * Mint a short-lived realtime handshake token (D2.3). `client.live.stream()` calls this for you —
+     * use it directly only when driving the WebSocket yourself.
+     */
+    streamToken() {
+        return this.http.post("/v1/live/stream/token");
+    }
+    /**
+     * LIVE video playback sources for a creator who is live now (D2.12). `live:stream`, not
+     * `live:read` — this is the video, not the metrics. The customer's runtime fetches the stream
+     * itself from TikTok's CDN. `status` is `live` (with `hlsUrl`/`flvUrl`), `no_playback`, or
+     * `offline`; a room still being resolved answers `202` (poll again).
+     */
+    playback(creatorUniqueId) {
+        return this.http.get(`/v1/live/creators/${encodeURIComponent(creatorUniqueId)}/playback`);
+    }
+}
+/**
+ * `rank:read`. Provenance-enveloped: `rankings-service.ts` returns
+ * `ProvenanceEnvelope<OfficialRankingResponse>` — `{ data: { board }, provenance }`.
+ */
+export class RankingsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** `board` is required by the server; there is no default. */
+    official(options) {
+        return this.http.get("/v1/rankings/official", { ...options });
+    }
+    /**
+     * Region "movers" — the creators whose rank changed most since the board's previous period, split
+     * into `gainers` (moved up) and `losers` (moved down), each biggest-move-first and capped by
+     * `limit` (1–99, default 20). Identity is masked by your plan tier exactly as `official`.
+     */
+    movers(options) {
+        return this.http.get("/v1/rankings/movers", { ...options });
+    }
+    /**
+     * Retained periods of a board, newest first — the source for a rank trend.
+     *
+     * `limit` counts PERIODS (1–24, default 12), not rows: each period carries the whole 99-rank
+     * board. Page with `cursor` (opaque). One request costs one credit regardless of how many
+     * periods come back.
+     */
+    history(options) {
+        return this.http.get("/v1/rankings/history", { ...options });
+    }
+    /**
+     * The regions a board can be read for, with each one's coverage and the boards it has captured.
+     *
+     * Call this instead of guessing: boards are keyed by BUCKET — `US+`, `MENA`, `LATAM`, `DE+` — and
+     * an ISO country code like `US` or `DE` matches no board at all, so it comes back coverage-gated
+     * rather than empty. The list reflects what has actually been captured, not what is configured.
+     *
+     * Each region also carries `notOfferedBoards`: the boards proven absent from TikTok's product
+     * there. Hide or disable only those. A board missing from `boards` may simply be one we have not
+     * captured yet, and it still answers for itself with an honest `not-covered`.
+     */
+    regions() {
+        return this.http.get("/v1/rankings/regions");
+    }
+    /**
+     * The per-game gaming boards a region offers — the source for the `game` parameter of a
+     * `board: "gaming_game"` read on `official` (and `movers` / `history`). Pass `games[].gameKey`
+     * verbatim; never hardcode a game list (the R5.7 lesson applied to games).
+     *
+     * `status` is `offered` (readable now) or `not_offered` (a game TikTok has pulled). An empty
+     * `games` array is a valid answer, not an error: the region runs only the aggregate gaming board,
+     * so show no game selector. `region` is a BUCKET key exactly as `regions` reports; omit it to
+     * accept the server default.
+     */
+    games(options = {}) {
+        return this.http.get("/v1/rankings/gaming/games", { ...options });
+    }
+}
+/** `creator:read` — profile, change history, analysis. Videos live on `content` (`content:read`). */
+export class CreatorsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Handle/name search. */
+    list(options = {}) {
+        return this.http.get("/v1/creators", { ...options });
+    }
+    get(uid) {
+        return this.http.get(`/v1/creators/${encodeURIComponent(uid)}`);
+    }
+    changes(uid, options = {}) {
+        return this.http.get(`/v1/creators/${encodeURIComponent(uid)}/changes`, { ...options });
+    }
+    analysis(uid) {
+        return this.http.get(`/v1/creators/${encodeURIComponent(uid)}/analysis`);
+    }
+    /** R4.5 — the same read in both directions; a real upstream walk bills the heavier SKU. */
+    following(uid, options = {}) {
+        return this.http.get(`/v1/creators/${encodeURIComponent(uid)}/following`, { ...options });
+    }
+    followers(uid, options = {}) {
+        return this.http.get(`/v1/creators/${encodeURIComponent(uid)}/followers`, { ...options });
+    }
+}
+/** `content:read` — a creator's videos, one video, its comments. Sold separately from the profile. */
+export class ContentResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Takes no query parameters — the route declares no querystring schema and the service uses a
+     * fixed internal limit. (A param passed here would be silently ignored, not rejected, which is why
+     * an acceptance run cannot catch it — the route has no schema to reject against.) */
+    creatorVideos(uid) {
+        return this.http.get(`/v1/creators/${encodeURIComponent(uid)}/videos`);
+    }
+    /** D6.1 — the creator's active story tray, fetched fresh through the signed mobile path. Empty
+     * tray (never an error) when no signed credential is configured. */
+    creatorStories(uid) {
+        return this.http.get(`/v1/creators/${encodeURIComponent(uid)}/stories`);
+    }
+    video(videoId) {
+        return this.http.get(`/v1/videos/${encodeURIComponent(videoId)}`);
+    }
+    videoComments(videoId, options = {}) {
+        return this.http.get(`/v1/videos/${encodeURIComponent(videoId)}/comments`, { ...options });
+    }
+}
+/** `gifter:read` — whale intelligence. Its own SKU, hence its own namespace. */
+export class GiftersResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(options = {}) {
+        return this.http.get("/v1/gifters", { ...options });
+    }
+    get(gifterKey, options = {}) {
+        return this.http.get(`/v1/gifters/${encodeURIComponent(gifterKey)}`, { ...options });
+    }
+    forCreator(handle, options = {}) {
+        return this.http.get(`/v1/creators/${encodeURIComponent(handle)}/gifters`, { ...options });
+    }
+}
+/** `trend:read` */
+export class TrendsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Note: this route takes no `limit`. */
+    list(options = {}) {
+        return this.http.get("/v1/trends", { ...options });
+    }
+}
+/** `export` — async bulk extracts. */
+export class ExportsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Takes no query parameters. */
+    list() {
+        return this.http.get("/v1/exports");
+    }
+    create(input) {
+        return this.http.post("/v1/exports", input);
+    }
+    get(id) {
+        return this.http.get(`/v1/exports/${encodeURIComponent(id)}`);
+    }
+    /**
+     * The finished extract itself — **`text/csv`, not JSON**, returned as a string. Parsing it as JSON
+     * (as an earlier version of this SDK did) silently yields `undefined`.
+     */
+    download(id) {
+        return this.http.getText(`/v1/exports/${encodeURIComponent(id)}/download`);
+    }
+}
+/** `keys:manage` — what this key may do, and what it has spent. */
+export class AccountResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    entitlements(options = {}) {
+        return this.http.get("/v1/entitlements", { ...options });
+    }
+    /** Not provenance-enveloped — `usage-service.ts` returns this shape directly. */
+    usage(options = {}) {
+        return this.http.get("/v1/usage", { ...options });
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@toktikhq/sdk-js",
+  "version": "0.2.0",
+  "description": "Typed JavaScript client for the TokTik Developer API (REST + realtime LIVE events)",
+  "keywords": [
+    "tiktok",
+    "live",
+    "realtime",
+    "developer-api"
+  ],
+  "license": "MIT",
+  "homepage": "https://docs.toktikhq.com/docs/sdks",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "npm run build --workspace @v2/contracts && node ./scripts/build.mjs",
+    "prepack": "npm run build && npm run test:package",
+    "test:package": "node ./scripts/verify-package.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts"
+  },
+  "devDependencies": {
+    "@v2/contracts": "0.1.0",
+    "rollup": "^4.60.1",
+    "rollup-plugin-dts": "^6.5.1"
+  }
+}