kicksdk-js 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# kicksdk-js
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+kicksdk for JavaScript. (On npm the name is `kicksdk-js`: npm treats
+`kicksdk` as too close to the unrelated `kick-sdk`.)
+
+Kick (kick.com) without the I/O: requests, response parsers, the realtime chat
+protocol and webhook verification, compiled from the
+[kicksdk](https://github.com/AnisAbdellatif/kicksdk) Rust core to WebAssembly,
+plus `connectChat`, which drives Kick's chat feed with `fetch` and `WebSocket`.
+
+```js
+import * as kick from 'kicksdk-js';
+await kick.init();            // in Node: kick.init(fs.readFileSync(wasmPath))
+
+const chat = kick.connectChat({
+  chatroomId,
+  channelId,
+  onEvent: ({ event }) => {
+    if (event.type === 'chat_message') console.log(`${event.sender.username}: ${event.content}`);
+  },
+  onState: ({ connected, subscribed }) => {},
+});
+chat.close();
+```
+
+**Where the feed works.** Kick's realtime server only accepts a WebSocket whose
+Origin is `https://kick.com`. Node: works (the driver sets the header). Browser:
+only on kick.com - a page there or an extension's content script. Elsewhere,
+relay through a server.
+
+Everything else - `channelRequest` / `parseChannel`, `historyRequest`,
+`livestreamsRequests`, `verifyWebhook`, `parseEvent`, `parseContent`, … -
+returns plain request objects for your `fetch` and parses what comes back.
+Parsers throw an `Error` with a `status` when Kick answered with an error.
+
+See the repository's `docs/KICK.md` for everything known about Kick, with
+sources. MIT OR Apache-2.0. Not affiliated with Kick.

package/index.d.ts

@@ -0,0 +1,34 @@
+export * from './pkg/kicksdk.js';
+
+/** The Origin Kick's realtime server accepts. */
+export const REQUIRED_ORIGIN: 'https://kick.com';
+
+/** Loads the WebAssembly: a URL, a Response, or the .wasm bytes. */
+export function init(input?: string | URL | Request | Response | BufferSource): Promise<void>;
+
+export interface ChatEvent {
+  /** The feed it came on, e.g. `chatrooms.668.v2`. */
+  channel: string;
+  /** Kick's event name, e.g. `App\\Events\\ChatMessageEvent`. */
+  name: string;
+  /** Its data as Kick sent it (usually a JSON string). */
+  data: unknown;
+  /** The same, typed: `{ type: 'chat_message', … }`. */
+  event: { type: string; [key: string]: unknown };
+}
+
+export interface ChatOptions {
+  chatroomId: number;
+  channelId?: number;
+  channels?: string[];
+  onEvent(e: ChatEvent): void;
+  onState?(s: { connected: boolean; subscribed: string[] }): void;
+  onDrop?(reason: string): void;
+  fetch?: typeof fetch;
+  createSocket?(url: string): WebSocket;
+  endpoints?: Partial<{ api: string; id: string; website: string; realtime: string }>;
+  now?(): number;
+}
+
+/** Connects to one channel's chat and keeps it up until `close()`. */
+export function connectChat(options: ChatOptions): { close(): void };

package/index.js

@@ -0,0 +1,220 @@
+// kicksdk for JavaScript: the WebAssembly build of the Rust core, plus
+// connectChat(), which drives the realtime protocol with fetch, WebSocket and
+// timers.
+//
+// Call `await init()` once before anything else (in Node, or anywhere the .wasm
+// cannot be fetched beside this file, pass its bytes: `init(bytes)`).
+//
+// Where it works: Kick's realtime server only takes a socket whose Origin is
+// https://kick.com. Node sets that header itself (see `createSocket` below); a
+// browser cannot, so in a browser connectChat only works on kick.com - a page
+// there, or an extension's content script. Elsewhere, relay through a server.
+
+import initWasm, {
+  initSync,
+  Session,
+  Backoff,
+  chatChannels,
+  chatConnectionRequest,
+  connectionRequest,
+  parseConnection,
+  tokenRequest,
+  parseToken
+} from './pkg/kicksdk.js';
+
+export * from './pkg/kicksdk.js';
+
+export const REQUIRED_ORIGIN = 'https://kick.com';
+
+let ready = null;
+
+/** Loads the WebAssembly. Safe to call more than once. */
+export function init(input) {
+  if (!ready) {
+    if (input instanceof Uint8Array || input instanceof ArrayBuffer) {
+      initSync({ module: input });
+      ready = Promise.resolve();
+    } else {
+      ready = initWasm(input === undefined ? undefined : { module_or_path: input });
+    }
+  }
+  return ready;
+}
+
+const isNode = typeof process !== 'undefined' && !!(process.versions && process.versions.node);
+
+function defaultSocket(url) {
+  // Node's WebSocket (undici) takes headers; a browser's ignores the argument
+  // and sends its own page's origin.
+  return isNode ? new WebSocket(url, { headers: { Origin: REQUIRED_ORIGIN } }) : new WebSocket(url);
+}
+
+async function send(fetchImpl, req) {
+  // A browser drops the headers it forbids (origin, referer) and sends its own.
+  const res = await fetchImpl(req.url, {
+    method: req.method,
+    headers: Object.fromEntries(req.headers),
+    body: req.body ?? undefined,
+    credentials: 'omit'
+  });
+  return { status: res.status, body: await res.text() };
+}
+
+/**
+ * Connects to one channel's chat and keeps the connection up until close().
+ *
+ * @param {object} o
+ * @param {number} o.chatroomId          the chatroom (website API `chatroom.id`)
+ * @param {number} [o.channelId]         the channel; also locates the chat's region
+ * @param {string[]} [o.channels]        feeds to subscribe to; chatChannels() by default
+ * @param {(e: {channel, name, data, event}) => void} o.onEvent
+ * @param {(s: {connected: boolean, subscribed: string[]}) => void} [o.onState]
+ * @param {(reason: string) => void} [o.onDrop]   a connection ended (a new one follows)
+ * @param {typeof fetch} [o.fetch]
+ * @param {(url: string) => WebSocket} [o.createSocket]
+ * @param {object} [o.endpoints]         overrides of Kick's URLs
+ * @param {() => number} [o.now]
+ * @returns {{ close(): void }}
+ */
+export function connectChat(o) {
+  const fetchImpl = o.fetch || ((...a) => fetch(...a));
+  const createSocket = o.createSocket || defaultSocket;
+  const now = o.now || (() => Date.now());
+  const channels = o.channels || chatChannels(o.chatroomId, o.channelId);
+  const backoff = new Backoff();
+  let closed = false;
+  let ws = null;
+  let session = null;
+  let timer = null;
+  let retry = null;
+  let clientId = null;
+
+  const state = () => {
+    if (o.onState && session) {
+      o.onState({ connected: session.isConnected(), subscribed: channels.filter((c) => session.isSubscribed(c)) });
+    }
+  };
+
+  function arm() {
+    clearTimeout(timer);
+    const at = session && session.deadline();
+    if (at !== undefined && at !== null) timer = setTimeout(() => apply(session.tick(now())), Math.max(0, at - now()));
+  }
+
+  function apply(actions) {
+    // Anything still in flight once close() has run - a timer, a token
+    // arriving - finds nothing left to act on.
+    if (closed || !session) return;
+    let changed = false;
+    for (const a of actions) {
+      switch (a.action) {
+        case 'send':
+          if (ws && ws.readyState === 1) ws.send(a.text);
+          break;
+        case 'close':
+          if (o.onDrop) o.onDrop(a.reason);
+          if (ws) ws.close();
+          break;
+        case 'refresh_token':
+          send(fetchImpl, tokenRequest(clientId, o.endpoints))
+            .then((r) => parseToken(r.status, r.body))
+            .then((token) => {
+              if (!closed && session) apply(session.refresh(token, now()));
+            })
+            .catch(() => {
+              // Kick ends the connection when the old token runs out; the
+              // reconnect fetches a new one.
+            });
+          break;
+        case 'subscribed':
+          if (a.channel === channels[0]) backoff.reset();
+          changed = true;
+          break;
+        case 'connected':
+        case 'unsubscribed':
+        case 'subscribe_failed':
+          changed = true;
+          break;
+        case 'event':
+          o.onEvent({ channel: a.channel, name: a.name, data: a.data, event: a.event });
+          break;
+      }
+    }
+    if (changed) state();
+    arm();
+  }
+
+  function again() {
+    if (closed) return;
+    clearTimeout(retry);
+    retry = setTimeout(connect, backoff.nextDelay());
+  }
+
+  async function connect() {
+    if (closed) return;
+    // A guest identity: the token is issued to this id, and so is every
+    // refreshed one for this connection.
+    clientId = crypto.randomUUID();
+    let url;
+    let token;
+    try {
+      const where = o.channelId
+        ? chatConnectionRequest(o.channelId, clientId, o.endpoints)
+        : connectionRequest(clientId, o.endpoints);
+      const c = await send(fetchImpl, where);
+      const found = parseConnection(c.status, c.body).find((x) => x.provider === 'centrifugo');
+      if (!found) throw new Error('Kick offered no Centrifugo server');
+      url = found.url;
+      const t = await send(fetchImpl, tokenRequest(clientId, o.endpoints));
+      token = parseToken(t.status, t.body);
+    } catch (e) {
+      if (o.onDrop) o.onDrop(String((e && e.message) || e));
+      again();
+      return;
+    }
+    if (closed) return;
+
+    if (!session) session = new Session(channels);
+    let socket;
+    try {
+      socket = createSocket(url);
+    } catch (e) {
+      again();
+      return;
+    }
+    ws = socket;
+    socket.onopen = () => apply(session.open(token, now()));
+    socket.onmessage = (e) => {
+      if (ws === socket) apply(session.receive(String(e.data), now()));
+    };
+    socket.onclose = () => {
+      if (ws !== socket) return;
+      ws = null;
+      clearTimeout(timer);
+      apply(session.closed());
+      state();
+      again();
+    };
+    socket.onerror = () => {};
+  }
+
+  connect();
+  return {
+    close() {
+      closed = true;
+      clearTimeout(timer);
+      clearTimeout(retry);
+      if (ws) {
+        const s = ws;
+        ws = null;
+        s.onclose = null;
+        s.close();
+      }
+      if (session) {
+        session.free();
+        session = null;
+      }
+      backoff.free();
+    }
+  };
+}

package/package.json

@@ -1,6 +1,22 @@
 {
   "name": "kicksdk-js",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Kick (kick.com) without the I/O: requests, parsers, the realtime chat protocol and webhook verification, from one Rust core",
+  "license": "MIT OR Apache-2.0",
+  "repository": { "type": "git", "url": "git+https://github.com/AnisAbdellatif/kicksdk.git", "directory": "bindings/js" },
+  "keywords": ["kick", "kick.com", "chat", "streaming", "centrifugo", "webassembly"],
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": { "types": "./index.d.ts", "default": "./index.js" },
+    "./kicksdk_bg.wasm": "./pkg/kicksdk_bg.wasm"
+  },
+  "files": ["index.js", "index.d.ts", "pkg/", "README.md"],
+  "engines": { "node": ">=22" },
+  "sideEffects": false,
+  "scripts": {
+    "build": "../../scripts/build-js.sh",
+    "test": "node --test test/*.test.js"
+  }
+}

package/pkg/kicksdk.d.ts

@@ -0,0 +1,366 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * Reconnect delays: 1 s doubling to 30 s.
+ */
+export class Backoff {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * From `initialMs`, doubling to `maxMs`.
+     */
+    constructor(initial_ms?: number | null, max_ms?: number | null);
+    /**
+     * The next wait, ms.
+     */
+    nextDelay(): number;
+    /**
+     * A connection worked.
+     */
+    reset(): void;
+}
+
+/**
+ * One connection's protocol. Each method returns the actions to carry out.
+ */
+export class Session {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * The socket closed.
+     */
+    closed(): any;
+    /**
+     * When to call `tick` next, in ms, or undefined.
+     */
+    deadline(): number | undefined;
+    /**
+     * Whether Kick accepted the connection.
+     */
+    isConnected(): boolean;
+    /**
+     * Whether a feed is subscribed.
+     */
+    isSubscribed(channel: string): boolean;
+    /**
+     * A session for these feeds.
+     */
+    constructor(channels: string[]);
+    /**
+     * The socket opened.
+     */
+    open(token: string, now: number): any;
+    /**
+     * A text frame arrived.
+     */
+    receive(text: string, now: number): any;
+    /**
+     * A new token, after a `refresh_token` action.
+     */
+    refresh(token: string, now: number): any;
+    /**
+     * The clock reached `deadline()`.
+     */
+    tick(now: number): any;
+}
+
+/**
+ * An app token request (client credentials).
+ */
+export function appTokenRequest(client_id: string, client_secret: string, endpoints_: any): any;
+
+/**
+ * Bans a user for good.
+ */
+export function banRequest(session: string, channel_slug: string, username: string, endpoints_: any): any;
+
+/**
+ * A channel by slug (`kick.com/api/v2`): chatroom id, followers, live state.
+ */
+export function channelRequest(slug: string, endpoints_: any): any;
+
+/**
+ * A user as a channel sees them.
+ */
+export function channelUserRequest(channel_slug: string, username: string, endpoints_: any): any;
+
+/**
+ * `/channels` for up to 50 user ids.
+ */
+export function channelsByIdsRequest(token: string, user_ids: Float64Array, endpoints_: any): any;
+
+/**
+ * `/channels` for up to 50 slugs (one unknown slug fails them all).
+ */
+export function channelsBySlugsRequest(token: string, slugs: string[], endpoints_: any): any;
+
+/**
+ * The feeds for one chat, the chat feed first.
+ */
+export function chatChannels(chatroom_id: number, channel_id?: number | null): string[];
+
+/**
+ * Where a channel's chat is served.
+ */
+export function chatConnectionRequest(channel_id: number, client_id: string, endpoints_: any): any;
+
+/**
+ * Where Kick's realtime is served in general.
+ */
+export function connectionRequest(client_id: string, endpoints_: any): any;
+
+/**
+ * Deletes a message.
+ */
+export function deleteMessageRequest(session: string, chatroom_id: number, message_id: string, endpoints_: any): any;
+
+/**
+ * An emote's image URL.
+ */
+export function emoteUrl(id: string): string;
+
+/**
+ * Recent chat and the pin, by channel id.
+ */
+export function historyRequest(channel_id: number, endpoints_: any): any;
+
+/**
+ * `/livestreams` for any number of user ids: one request per 50.
+ */
+export function livestreamsRequests(token: string, user_ids: Float64Array, endpoints_: any): any;
+
+/**
+ * The signed-in viewer's standing on a channel.
+ */
+export function meRequest(session: string, channel_slug: string, endpoints_: any): any;
+
+/**
+ * Whether an acting call worked; throws with `status` if not.
+ */
+export function parseAction(status: number, body: string): void;
+
+/**
+ * Reads an app token answer.
+ */
+export function parseAppToken(status: number, body: string): any;
+
+/**
+ * Reads a website channel answer.
+ */
+export function parseChannel(status: number, body: string): any;
+
+/**
+ * Reads a channel user answer.
+ */
+export function parseChannelUser(status: number, body: string): any;
+
+/**
+ * Reads a `/channels` answer.
+ */
+export function parseChannels(status: number, body: string): any;
+
+/**
+ * Reads either connection answer: `[{provider, url}…]`.
+ */
+export function parseConnection(status: number, body: string): any;
+
+/**
+ * A message's text and emotes.
+ */
+export function parseContent(text: string, combine: boolean): any;
+
+/**
+ * A feed event, typed: `{type: "chat_message", …}`. `data` as Kick sent it.
+ */
+export function parseEvent(name: string, data: any): any;
+
+/**
+ * Reads a history answer: `{messages, pinned}`.
+ */
+export function parseHistory(status: number, body: string): any;
+
+/**
+ * Reads a `/livestreams` answer.
+ */
+export function parseLivestreams(status: number, body: string): any;
+
+/**
+ * Reads a `me` answer.
+ */
+export function parseMe(status: number, body: string): any;
+
+/**
+ * The PEM from a public key answer.
+ */
+export function parsePublicKey(status: number, body: string): string;
+
+/**
+ * Reads a subscriptions answer.
+ */
+export function parseSubscriptions(status: number, body: string): any;
+
+/**
+ * The token from a token answer.
+ */
+export function parseToken(status: number, body: string): string;
+
+/**
+ * Reads a delivery's body by its type header, without checking anything.
+ */
+export function parseWebhook(event_type: string, body: string): any;
+
+/**
+ * Pins a message (the feed's data for it, whole) for `minutes`.
+ */
+export function pinRequest(session: string, channel_slug: string, message: any, minutes: number, endpoints_: any): any;
+
+/**
+ * The webhook signing key request.
+ */
+export function publicKeyRequest(endpoints_: any): any;
+
+/**
+ * Sends a message, or a reply when `replyTo` is
+ * `{message_id, content, sender_id, sender_username}`.
+ */
+export function sendRequest(session: string, chatroom_id: number, text: string, message_ref: string, reply_to: any, endpoints_: any): any;
+
+/**
+ * Subscribes the app to webhook `events` (`[{name, version}]`) for one channel.
+ */
+export function subscribeRequest(token: string, broadcaster_user_id: number, events: any, endpoints_: any): any;
+
+/**
+ * Every webhook subscription the app has.
+ */
+export function subscriptionsRequest(token: string, endpoints_: any): any;
+
+/**
+ * Times a user out.
+ */
+export function timeoutRequest(session: string, channel_slug: string, username: string, minutes: number, endpoints_: any): any;
+
+/**
+ * A guest token request for `clientId`.
+ */
+export function tokenRequest(client_id: string, endpoints_: any): any;
+
+/**
+ * The top live streams, overall or in a category or language: up to 100.
+ * `sort` is `"viewer_count"` (the default) or `"started_at"`.
+ */
+export function topLivestreamsRequest(token: string, category_id: number | null | undefined, language: string | null | undefined, sort: string | null | undefined, limit: number | null | undefined, endpoints_: any): any;
+
+/**
+ * Lifts a ban or timeout.
+ */
+export function unbanRequest(session: string, channel_slug: string, username: string, endpoints_: any): any;
+
+/**
+ * Removes the pin.
+ */
+export function unpinRequest(session: string, channel_slug: string, endpoints_: any): any;
+
+/**
+ * Removes subscriptions, 50 per request.
+ */
+export function unsubscribeRequests(token: string, ids: string[], endpoints_: any): any;
+
+/**
+ * Checks a delivery: `headers` as `[[name, value]…]` or an object, `body` the
+ * raw text. Returns the typed event, or throws.
+ */
+export function verifyWebhook(public_key_pem: string, headers: any, body: string): any;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_backoff_free: (a: number, b: number) => void;
+    readonly __wbg_session_free: (a: number, b: number) => void;
+    readonly appTokenRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly backoff_new: (a: number, b: number, c: number, d: number) => number;
+    readonly backoff_nextDelay: (a: number) => number;
+    readonly backoff_reset: (a: number) => void;
+    readonly banRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number, number];
+    readonly channelRequest: (a: number, b: number, c: any) => [number, number, number];
+    readonly channelUserRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly channelsByIdsRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly channelsBySlugsRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly chatChannels: (a: number, b: number, c: number) => [number, number];
+    readonly chatConnectionRequest: (a: number, b: number, c: number, d: any) => [number, number, number];
+    readonly connectionRequest: (a: number, b: number, c: any) => [number, number, number];
+    readonly deleteMessageRequest: (a: number, b: number, c: number, d: number, e: number, f: any) => [number, number, number];
+    readonly emoteUrl: (a: number, b: number) => [number, number];
+    readonly historyRequest: (a: number, b: any) => [number, number, number];
+    readonly livestreamsRequests: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly meRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly parseAction: (a: number, b: number, c: number) => [number, number];
+    readonly parseAppToken: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseChannel: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseChannelUser: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseChannels: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseConnection: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseContent: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseEvent: (a: number, b: number, c: any) => [number, number, number];
+    readonly parseHistory: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseLivestreams: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseMe: (a: number, b: number, c: number) => [number, number, number];
+    readonly parsePublicKey: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly parseSubscriptions: (a: number, b: number, c: number) => [number, number, number];
+    readonly parseToken: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly parseWebhook: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly pinRequest: (a: number, b: number, c: number, d: number, e: any, f: number, g: any) => [number, number, number];
+    readonly publicKeyRequest: (a: any) => [number, number, number];
+    readonly sendRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: any, i: any) => [number, number, number];
+    readonly session_closed: (a: number) => [number, number, number];
+    readonly session_deadline: (a: number) => [number, number];
+    readonly session_isConnected: (a: number) => number;
+    readonly session_isSubscribed: (a: number, b: number, c: number) => number;
+    readonly session_new: (a: number, b: number) => number;
+    readonly session_open: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly session_receive: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly session_refresh: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly session_tick: (a: number, b: number) => [number, number, number];
+    readonly subscribeRequest: (a: number, b: number, c: number, d: any, e: any) => [number, number, number];
+    readonly subscriptionsRequest: (a: number, b: number, c: any) => [number, number, number];
+    readonly timeoutRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: any) => [number, number, number];
+    readonly tokenRequest: (a: number, b: number, c: any) => [number, number, number];
+    readonly topLivestreamsRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: any) => [number, number, number];
+    readonly unbanRequest: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number, number];
+    readonly unpinRequest: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly unsubscribeRequests: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly verifyWebhook: (a: number, b: number, c: any, d: number, e: number) => [number, number, number];
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_exn_store: (a: number) => void;
+    readonly __externref_table_alloc: () => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __externref_drop_slice: (a: number, b: number) => void;
+    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;