flbrowser-core 0.1.0

package/README.md

@@ -0,0 +1,108 @@
+# @danu/danu
+
+Browser library for Fledger network, compiled to WebAssembly.
+
+## Installation
+
+For local development:
+```bash
+npm install file:../package/pkg
+```
+
+When published:
+```bash
+npm install @danu/danu
+```
+
+## Usage
+
+```typescript
+import init, { FlNode, initialize } from '@danu/danu';
+
+// Initialize WASM module
+await init();
+
+// Set up logging and panic hooks
+initialize();
+
+// Create a node instance
+const node = new FlNode();
+
+// Connect to signal server
+await node.connect('wss://signal.fledg.re');
+
+// Get connection status
+const status = node.get_connection_status();
+console.log(status);
+
+// Get statistics
+const stats = node.get_stats();
+console.log(stats);
+
+// Set up event listener for asynchronous events
+node.set_event_listener((event) => {
+  console.log('Event:', event.type, event.data);
+
+  switch (event.type) {
+    case 'connecting':
+      console.log('Connecting to:', event.data.signal_server);
+      break;
+    case 'connected':
+      console.log('Connected!');
+      break;
+    case 'message':
+      console.log('Message received:', event.data);
+      break;
+    // ... handle other events
+  }
+});
+
+// Remove event listener when done
+node.remove_event_listener();
+```
+
+## Event System
+
+The package emits events for asynchronous operations. Set up a listener to receive them:
+
+```typescript
+node.set_event_listener((event: { type: string, data: any }) => {
+  // Handle events
+});
+```
+
+**Common Event Types:**
+- `connecting` - Connection attempt started
+- `connected` - Successfully connected
+- `disconnected` - Connection closed
+- `message` - Message received from peer
+- `peer_joined` - Peer joined the network
+- `peer_left` - Peer left the network
+- `error` - An error occurred
+```
+
+## Building
+
+```bash
+# Development build
+make build
+
+# Production build
+make build-release
+
+# Clean build artifacts
+make clean
+
+# Create npm package
+make pack
+```
+
+## Requirements
+
+- Rust toolchain
+- wasm-pack (`cargo install wasm-pack`)
+- Node.js >= 18
+
+## License
+
+MIT OR Apache-2.0

package/flbrowser_core.d.ts

@@ -0,0 +1,201 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * The `ReadableStreamType` enum.
+ *
+ * *This API requires the following crate features to be activated: `ReadableStreamType`*
+ */
+
+type ReadableStreamType = "bytes";
+
+/**
+ * Main DaNode interface for browser
+ */
+export class DaNode {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Add an event listener callback
+     * The callback will be called with events in the format: { type: string, data: any }
+     * Returns a ListenerId that can be used to remove this specific listener
+     */
+    add_event_listener(callback: Function): ListenerId;
+    static from_config(cfg: NetConf): Promise<DaNode>;
+    /**
+     * Create a new DaNode instance
+     */
+    static from_default(): Promise<DaNode>;
+    get_realm(id: RealmID): Promise<DaRealm>;
+    /**
+     * Get basic statistics
+     */
+    get_stats(): any;
+    /**
+     * Remove a specific event listener by its ID
+     */
+    remove_event_listener(listener_id: ListenerId): void;
+    sync(): Promise<void>;
+}
+
+export class DaRealm {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    get_path(path: string): string;
+    get_path_data(path: string, data: string): Uint8Array;
+}
+
+export class FloID {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    toString(): string;
+}
+
+export class IntoUnderlyingByteSource {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    cancel(): void;
+    pull(controller: ReadableByteStreamController): Promise<any>;
+    start(controller: ReadableByteStreamController): void;
+    readonly autoAllocateChunkSize: number;
+    readonly type: ReadableStreamType;
+}
+
+export class IntoUnderlyingSink {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    abort(reason: any): Promise<any>;
+    close(): Promise<any>;
+    write(chunk: any): Promise<any>;
+}
+
+export class IntoUnderlyingSource {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    cancel(): void;
+    pull(controller: ReadableStreamDefaultController): Promise<any>;
+}
+
+/**
+ * Unique identifier for an event listener
+ */
+export class ListenerId {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Get the numeric ID value
+     */
+    value(): number;
+}
+
+export class NetConf {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+}
+
+export enum NodeStatus {
+    ConnectSignal = 0,
+    ConnectedNodes = 1,
+    AvailableNodes = 2,
+    DisconnectSignal = 3,
+    DisconnectNodes = 4,
+    RealmAvailable = 5,
+    ReceivedFlo = 6,
+}
+
+export class RealmID {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    toString(): string;
+}
+
+/**
+ * Initialize the WASM module with logging and panic hooks
+ */
+export function initialize(): void;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_danode_free: (a: number, b: number) => void;
+    readonly __wbg_darealm_free: (a: number, b: number) => void;
+    readonly __wbg_floid_free: (a: number, b: number) => void;
+    readonly __wbg_listenerid_free: (a: number, b: number) => void;
+    readonly __wbg_netconf_free: (a: number, b: number) => void;
+    readonly danode_add_event_listener: (a: number, b: any) => [number, number, number];
+    readonly danode_from_config: (a: number) => any;
+    readonly danode_from_default: () => any;
+    readonly danode_get_realm: (a: number, b: number) => any;
+    readonly danode_get_stats: (a: number) => any;
+    readonly danode_remove_event_listener: (a: number, b: number) => [number, number];
+    readonly danode_sync: (a: number) => any;
+    readonly darealm_get_path: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly darealm_get_path_data: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly floid_toString: (a: number) => [number, number];
+    readonly initialize: () => void;
+    readonly listenerid_value: (a: number) => number;
+    readonly realmid_toString: (a: number) => [number, number];
+    readonly __wbg_realmid_free: (a: number, b: number) => void;
+    readonly __wbg_intounderlyingbytesource_free: (a: number, b: number) => void;
+    readonly __wbg_intounderlyingsink_free: (a: number, b: number) => void;
+    readonly __wbg_intounderlyingsource_free: (a: number, b: number) => void;
+    readonly intounderlyingbytesource_autoAllocateChunkSize: (a: number) => number;
+    readonly intounderlyingbytesource_cancel: (a: number) => void;
+    readonly intounderlyingbytesource_pull: (a: number, b: any) => any;
+    readonly intounderlyingbytesource_start: (a: number, b: any) => void;
+    readonly intounderlyingbytesource_type: (a: number) => number;
+    readonly intounderlyingsink_abort: (a: number, b: any) => any;
+    readonly intounderlyingsink_close: (a: number) => any;
+    readonly intounderlyingsink_write: (a: number, b: any) => any;
+    readonly intounderlyingsource_cancel: (a: number) => void;
+    readonly intounderlyingsource_pull: (a: number, b: any) => any;
+    readonly wasm_bindgen__closure__destroy__ha917655cf973976a: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__h2072d9fd4fb6b987: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__hc77efcacde91f08c: (a: number, b: number) => void;
+    readonly wasm_bindgen__closure__destroy__h2e4299a9319bc03b: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h4d8a9638d0e04172: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h0d268f64b67d3868: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h1f94d242aababef4: (a: number, b: number, c: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h8c172a5ae5173bf3: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h2fda946b1c2a6d9b: (a: number, b: number) => void;
+    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 __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __externref_drop_slice: (a: number, b: number) => void;
+    readonly __externref_table_dealloc: (a: 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>;