@protoc-gen-go-wasmjs/runtime 0.0.14

package/dist/client/index.d.mts

@@ -0,0 +1,169 @@
+import { BrowserServiceManager } from '../browser/index.mjs';
+
+/**
+ * WASM Response interface for all service calls
+ */
+interface WASMResponse<T = any> {
+    success: boolean;
+    message: string;
+    data: T;
+}
+/**
+ * Error class for WASM-specific errors
+ */
+declare class WasmError extends Error {
+    readonly methodPath?: string | undefined;
+    constructor(message: string, methodPath?: string | undefined);
+}
+
+/**
+ * Base WASM service client containing all non-template-dependent logic
+ */
+declare abstract class WASMServiceClient {
+    protected wasm: any;
+    protected wasmLoadPromise: Promise<void> | null;
+    protected browserServiceManager: BrowserServiceManager | null;
+    constructor();
+    /**
+     * Register a browser service implementation
+     * Can be used to register browser services from any package
+     */
+    registerBrowserService(name: string, implementation: any): void;
+    /**
+     * Check if WASM is ready for operations
+     */
+    isReady(): boolean;
+    /**
+     * Wait for WASM to be ready (use during initialization)
+     */
+    waitUntilReady(): Promise<void>;
+    /**
+     * Internal method to call WASM functions with JSON conversion
+     */
+    callMethod<TRequest, TResponse>(methodPath: string, request: TRequest): Promise<TResponse>;
+    /**
+     * Internal method to call async WASM functions with callback
+     */
+    callMethodWithCallback<TRequest>(methodPath: string, request: TRequest, callback: (response: any, error?: string) => void): Promise<void>;
+    /**
+     * Internal method to call server streaming WASM functions
+     */
+    callStreamingMethod<TRequest, TResponse>(methodPath: string, request: TRequest, callback: (response: TResponse | null, error: string | null, done: boolean) => boolean): void;
+    /**
+     * Ensure WASM module is loaded (synchronous version for service calls)
+     */
+    protected ensureWASMLoaded(): void;
+    /**
+     * Load the WASM module asynchronously
+     */
+    loadWasm(wasmPath: string): Promise<void>;
+    /**
+     * Load the WASM module implementation (implemented by subclasses)
+     * This is abstract because it contains template-specific logic
+     */
+    protected abstract loadWASMModule(wasmPath: string): Promise<void>;
+    /**
+     * Abstract method for getting WASM method function by path
+     * Implementation depends on API structure (namespaced, flat, service_based)
+     */
+    protected abstract getWasmMethod(methodPath: string): Function;
+}
+
+/**
+ * Configuration for API structure and bundle behavior
+ */
+interface WASMBundleConfig {
+    moduleName: string;
+    apiStructure: 'namespaced' | 'flat' | 'service_based';
+    jsNamespace: string;
+}
+/**
+ * WASM Bundle - manages loading and shared access to a WASM module
+ * One bundle per WASM file, shared by multiple service clients
+ */
+declare class WASMBundle {
+    private wasm;
+    private wasmLoadPromise;
+    private browserServiceManager;
+    private config;
+    constructor(config: WASMBundleConfig);
+    /**
+     * Register a browser service implementation
+     */
+    registerBrowserService(name: string, implementation: any): void;
+    /**
+     * Check if WASM is ready for operations
+     */
+    isReady(): boolean;
+    /**
+     * Wait for WASM to be ready (use during initialization)
+     */
+    waitUntilReady(): Promise<void>;
+    /**
+     * Load the WASM module asynchronously (singleton pattern)
+     */
+    loadWasm(wasmPath: string): Promise<void>;
+    /**
+     * Get WASM method function by path
+     */
+    getWasmMethod(methodPath: string): Function;
+    /**
+     * Internal method to call WASM functions with JSON conversion
+     */
+    callMethod<TRequest, TResponse>(methodPath: string, request: TRequest): Promise<TResponse>;
+    /**
+     * Internal method to call async WASM functions with callback
+     */
+    callMethodWithCallback<TRequest>(methodPath: string, request: TRequest, callback: (response: any, error?: string) => void): Promise<void>;
+    /**
+     * Internal method to call server streaming WASM functions
+     */
+    callStreamingMethod<TRequest, TResponse>(methodPath: string, request: TRequest, callback: (response: TResponse | null, error: string | null, done: boolean) => boolean): void;
+    /**
+     * Ensure WASM module is loaded (synchronous version for service calls)
+     */
+    private ensureWASMLoaded;
+    /**
+     * Load the WASM module implementation
+     */
+    private loadWASMModule;
+    /**
+     * Check if WASM is pre-loaded (for testing)
+     */
+    private checkIfPreLoaded;
+    /**
+     * Verify WASM APIs are available after loading
+     */
+    private verifyWASMLoaded;
+}
+
+/**
+ * Base service client that references a shared WASM bundle
+ * Lightweight facade for service-specific method calls
+ */
+declare abstract class ServiceClient {
+    protected bundle: WASMBundle;
+    constructor(bundle: WASMBundle);
+    /**
+     * Check if the underlying WASM bundle is ready
+     */
+    isReady(): boolean;
+    /**
+     * Wait for the underlying WASM bundle to be ready
+     */
+    waitUntilReady(): Promise<void>;
+    /**
+     * Call a synchronous WASM method
+     */
+    protected callMethod<TRequest, TResponse>(methodPath: string, request: TRequest): Promise<TResponse>;
+    /**
+     * Call an asynchronous WASM method with callback
+     */
+    protected callMethodWithCallback<TRequest>(methodPath: string, request: TRequest, callback: (response: any, error?: string) => void): Promise<void>;
+    /**
+     * Call a server streaming WASM method
+     */
+    protected callStreamingMethod<TRequest, TResponse>(methodPath: string, request: TRequest, callback: (response: TResponse | null, error: string | null, done: boolean) => boolean): void;
+}
+
+export { ServiceClient, WASMBundle, type WASMBundleConfig, type WASMResponse, WASMServiceClient, WasmError };

package/dist/client/index.d.ts

@@ -0,0 +1,169 @@
+import { BrowserServiceManager } from '../browser/index.js';
+
+/**
+ * WASM Response interface for all service calls
+ */
+interface WASMResponse<T = any> {
+    success: boolean;
+    message: string;
+    data: T;
+}
+/**
+ * Error class for WASM-specific errors
+ */
+declare class WasmError extends Error {
+    readonly methodPath?: string | undefined;
+    constructor(message: string, methodPath?: string | undefined);
+}
+
+/**
+ * Base WASM service client containing all non-template-dependent logic
+ */
+declare abstract class WASMServiceClient {
+    protected wasm: any;
+    protected wasmLoadPromise: Promise<void> | null;
+    protected browserServiceManager: BrowserServiceManager | null;
+    constructor();
+    /**
+     * Register a browser service implementation
+     * Can be used to register browser services from any package
+     */
+    registerBrowserService(name: string, implementation: any): void;
+    /**
+     * Check if WASM is ready for operations
+     */
+    isReady(): boolean;
+    /**
+     * Wait for WASM to be ready (use during initialization)
+     */
+    waitUntilReady(): Promise<void>;
+    /**
+     * Internal method to call WASM functions with JSON conversion
+     */
+    callMethod<TRequest, TResponse>(methodPath: string, request: TRequest): Promise<TResponse>;
+    /**
+     * Internal method to call async WASM functions with callback
+     */
+    callMethodWithCallback<TRequest>(methodPath: string, request: TRequest, callback: (response: any, error?: string) => void): Promise<void>;
+    /**
+     * Internal method to call server streaming WASM functions
+     */
+    callStreamingMethod<TRequest, TResponse>(methodPath: string, request: TRequest, callback: (response: TResponse | null, error: string | null, done: boolean) => boolean): void;
+    /**
+     * Ensure WASM module is loaded (synchronous version for service calls)
+     */
+    protected ensureWASMLoaded(): void;
+    /**
+     * Load the WASM module asynchronously
+     */
+    loadWasm(wasmPath: string): Promise<void>;
+    /**
+     * Load the WASM module implementation (implemented by subclasses)
+     * This is abstract because it contains template-specific logic
+     */
+    protected abstract loadWASMModule(wasmPath: string): Promise<void>;
+    /**
+     * Abstract method for getting WASM method function by path
+     * Implementation depends on API structure (namespaced, flat, service_based)
+     */
+    protected abstract getWasmMethod(methodPath: string): Function;
+}
+
+/**
+ * Configuration for API structure and bundle behavior
+ */
+interface WASMBundleConfig {
+    moduleName: string;
+    apiStructure: 'namespaced' | 'flat' | 'service_based';
+    jsNamespace: string;
+}
+/**
+ * WASM Bundle - manages loading and shared access to a WASM module
+ * One bundle per WASM file, shared by multiple service clients
+ */
+declare class WASMBundle {
+    private wasm;
+    private wasmLoadPromise;
+    private browserServiceManager;
+    private config;
+    constructor(config: WASMBundleConfig);
+    /**
+     * Register a browser service implementation
+     */
+    registerBrowserService(name: string, implementation: any): void;
+    /**
+     * Check if WASM is ready for operations
+     */
+    isReady(): boolean;
+    /**
+     * Wait for WASM to be ready (use during initialization)
+     */
+    waitUntilReady(): Promise<void>;
+    /**
+     * Load the WASM module asynchronously (singleton pattern)
+     */
+    loadWasm(wasmPath: string): Promise<void>;
+    /**
+     * Get WASM method function by path
+     */
+    getWasmMethod(methodPath: string): Function;
+    /**
+     * Internal method to call WASM functions with JSON conversion
+     */
+    callMethod<TRequest, TResponse>(methodPath: string, request: TRequest): Promise<TResponse>;
+    /**
+     * Internal method to call async WASM functions with callback
+     */
+    callMethodWithCallback<TRequest>(methodPath: string, request: TRequest, callback: (response: any, error?: string) => void): Promise<void>;
+    /**
+     * Internal method to call server streaming WASM functions
+     */
+    callStreamingMethod<TRequest, TResponse>(methodPath: string, request: TRequest, callback: (response: TResponse | null, error: string | null, done: boolean) => boolean): void;
+    /**
+     * Ensure WASM module is loaded (synchronous version for service calls)
+     */
+    private ensureWASMLoaded;
+    /**
+     * Load the WASM module implementation
+     */
+    private loadWASMModule;
+    /**
+     * Check if WASM is pre-loaded (for testing)
+     */
+    private checkIfPreLoaded;
+    /**
+     * Verify WASM APIs are available after loading
+     */
+    private verifyWASMLoaded;
+}
+
+/**
+ * Base service client that references a shared WASM bundle
+ * Lightweight facade for service-specific method calls
+ */
+declare abstract class ServiceClient {
+    protected bundle: WASMBundle;
+    constructor(bundle: WASMBundle);
+    /**
+     * Check if the underlying WASM bundle is ready
+     */
+    isReady(): boolean;
+    /**
+     * Wait for the underlying WASM bundle to be ready
+     */
+    waitUntilReady(): Promise<void>;
+    /**
+     * Call a synchronous WASM method
+     */
+    protected callMethod<TRequest, TResponse>(methodPath: string, request: TRequest): Promise<TResponse>;
+    /**
+     * Call an asynchronous WASM method with callback
+     */
+    protected callMethodWithCallback<TRequest>(methodPath: string, request: TRequest, callback: (response: any, error?: string) => void): Promise<void>;
+    /**
+     * Call a server streaming WASM method
+     */
+    protected callStreamingMethod<TRequest, TResponse>(methodPath: string, request: TRequest, callback: (response: TResponse | null, error: string | null, done: boolean) => boolean): void;
+}
+
+export { ServiceClient, WASMBundle, type WASMBundleConfig, type WASMResponse, WASMServiceClient, WasmError };