(feat): redesign WASM module, add TypeScript SDK, migrate to pnpm

wasm/types/mtp_wasm.d.ts

@@ -0,0 +1,173 @@
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+  readonly memory: WebAssembly.Memory;
+}
+
+export interface DisposableWasmObject {
+  free(): void;
+  [Symbol.dispose](): void;
+}
+
+export type StateChangeCallback = (state: ConnectionState) => void;
+export type MessageCallback = (frame: ParsedFrame) => void;
+export type ErrorCallback = (error: string) => void;
+
+export interface Ed25519GenerateResult {
+  signer: WasmEd25519Signer;
+  secretKey: Uint8Array;
+  publicKey: Uint8Array;
+}
+
+export interface AuthResponse {
+  connected: boolean;
+  clientNonce?: Uint8Array;
+  assignedId?: number;
+  timestamp?: number;
+  signature?: Uint8Array;
+}
+
+export interface ParsedResponse {
+  _id?: number;
+  _type: string;
+  [field: string]: unknown;
+}
+
+export interface ParsedFrame {
+  id?: number;
+  type: string;
+  sender?: bigint;
+  receiver?: bigint;
+  data: Record<string, unknown>;
+  raw: Uint8Array;
+}
+
+export class ConnectionConfig implements DisposableWasmObject {
+  constructor(url: string);
+  free(): void;
+  [Symbol.dispose](): void;
+  client_id: bigint;
+  server_certificate_hashes: string[];
+  readonly url: string;
+}
+
+export enum ConnectionState {
+  Disconnected = 0,
+  Connecting = 1,
+  Connected = 2,
+  Failed = 3,
+}
+
+export enum WasmLogHint {
+  Info = 0,
+  Warning = 1,
+  Error = 2,
+}
+
+export class WasmChaCha20Poly1305 implements DisposableWasmObject {
+  constructor(key: Uint8Array);
+  free(): void;
+  [Symbol.dispose](): void;
+  decrypt(ciphertext: Uint8Array, aad: Uint8Array): Uint8Array;
+  encrypt(plaintext: Uint8Array, aad: Uint8Array): Uint8Array;
+}
+
+export class WasmClient implements DisposableWasmObject {
+  constructor(
+    on_state_change: StateChangeCallback,
+    on_message: MessageCallback,
+    on_error: ErrorCallback,
+  );
+  free(): void;
+  [Symbol.dispose](): void;
+  auth_connect(
+    config: ConnectionConfig,
+    host_public_key_bytes: Uint8Array,
+    keyring_bytes: Uint8Array,
+    client_id: bigint,
+  ): Promise<bigint>;
+  auth_register(
+    config: ConnectionConfig,
+    host_public_key_bytes: Uint8Array,
+    keyring_bytes: Uint8Array,
+  ): Promise<bigint>;
+  connect(config: ConnectionConfig): Promise<void>;
+  disconnect(): void;
+  request(frame: Uint8Array, response_type?: string | null): Promise<ParsedFrame>;
+  send(frame: Uint8Array): Promise<void>;
+  start_protocol_pings(interval_ms: number, client_id: bigint): void;
+  stop_protocol_pings(): void;
+  subscribe(message_type: string, callback: MessageCallback): number;
+  unsubscribe(id: number): boolean;
+  static is_supported(): boolean;
+  readonly state: ConnectionState;
+}
+
+export class WasmEd25519Signer implements DisposableWasmObject {
+  constructor(secret_key: Uint8Array);
+  free(): void;
+  [Symbol.dispose](): void;
+  sign(message: Uint8Array): Uint8Array;
+  verify(message: Uint8Array, signature: Uint8Array): void;
+}
+
+export class WasmKeyring implements DisposableWasmObject {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  static from_bytes(bytes: Uint8Array): WasmKeyring;
+  public_key_bundle(): WasmPublicKeyBundle;
+  to_bytes(): Uint8Array;
+}
+
+export class WasmPublicKeyBundle implements DisposableWasmObject {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  static from_bytes(bytes: Uint8Array): WasmPublicKeyBundle;
+  to_bytes(): Uint8Array;
+  readonly kem_public_key: Uint8Array;
+  readonly sig_cl_public_key: Uint8Array;
+  readonly sig_pq_public_key: Uint8Array;
+}
+
+export class WasmSubscriptionRouter implements DisposableWasmObject {
+  constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  dispatch(message_type: string, message: unknown): boolean;
+  subscribe(message_type: string, callback: (message: unknown) => void): void;
+  unsubscribe(message_type: string): boolean;
+}
+
+export function build_ping_frame(
+  client_id: bigint,
+  description: string,
+  timestamp: bigint,
+  data: Uint8Array,
+): Uint8Array;
+
+export function build_frame(message_type: string, data: Record<string, unknown>, options?: {
+  id?: number;
+  sender?: bigint | number;
+  receiver?: bigint | number;
+}): Uint8Array;
+
+export function ed25519_generate(): Ed25519GenerateResult;
+export function ed25519_verify(public_key: Uint8Array, message: Uint8Array, signature: Uint8Array): void;
+export function format_frame(frame: Uint8Array): string;
+export function keyring_from_ed25519(secret_key: Uint8Array, public_key: Uint8Array): Uint8Array;
+export function main(): void;
+export function parse_auth_response(response: Uint8Array): AuthResponse;
+export function parse_frame(frame: Uint8Array): ParsedFrame;
+export function wasm_derive_encryption_key(ikm: Uint8Array, salt: Uint8Array, context: Uint8Array): Uint8Array;
+export function wasm_hkdf_expand(ikm: Uint8Array, salt: Uint8Array, info: Uint8Array, len: number): Uint8Array;
+export function wasm_sha256(data: Uint8Array): Uint8Array;
+export function wasm_sha256_double(data: Uint8Array): Uint8Array;
+
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+export default function init(
+  module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>,
+): Promise<InitOutput>;