@lingxia/bridge 0.5.1 → 0.6.3

package/dist/es5/invocation.js

@@ -13,6 +13,17 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 import { BRIDGE_ERROR } from "./types";
 var BridgeInvocationError = /** @class */ (function (_super) {
     __extends(BridgeInvocationError, _super);
@@ -45,6 +56,22 @@ export function toBridgeError(err) {
     var message = err instanceof Error ? err.message : typeof err === "string" ? err : "Unknown error";
     return new BridgeInvocationError(BRIDGE_ERROR.INTERNAL_ERROR, message);
 }
+export function toNativeError(err) {
+    var bridgeError = toBridgeError(err);
+    return __assign({ code: String(bridgeError.code || BRIDGE_ERROR.INTERNAL_ERROR), message: typeof bridgeError.message === "string" && bridgeError.message.trim() !== ""
+            ? bridgeError.message
+            : "Unknown error" }, (bridgeError.data === undefined ? {} : { data: bridgeError.data }));
+}
+export function isNativeError(error, code) {
+    if (!error || typeof error !== "object")
+        return false;
+    var candidate = error;
+    if (typeof candidate.code !== "string" || candidate.code.trim() === "")
+        return false;
+    if (typeof candidate.message !== "string")
+        return false;
+    return code === undefined || candidate.code === code;
+}
 export function resolveParams(source) {
     if (typeof source === "function") {
         return source();

package/dist/index.d.ts

@@ -5,7 +5,8 @@
  * - Bridge initialization for native communication
  * - Error UI rendering when page cannot be loaded
  */
-export type { BridgeConfig, CallOptions, ChannelOpenOptions, BridgeErrorCode, ChannelEventName, DataSubscriber, ErrorInfo, HostChannelApi, HostApi, LingXiaBridgeInterface, LxChannel, LxBridgeError, LxMethod, LxMethodParams, LxMethodResult, LxMethodStreamData, LxStream, NativeComponentMessage, NotifyOptions, StateInfo, StreamCallOptions, StreamEventName, } from './types';
-export { LingXiaBridge, host, initBridge } from './bridge';
+export type { BridgeConfig, CallOptions, ChannelCloseEvent, ChannelOptions, ChannelOpenOptions, BridgeErrorCode, ChannelEventName, DataSubscriber, ErrorInfo, LingXiaBridgeInterface, LxChannel, LxBridgeError, LxMethod, LxMethodParams, LxMethodResult, LxMethodStreamData, LxStream, NativeComponentMessage, NativeChannel, NativeError, NativeStream, NotifyOptions, InvokeOptions, StateInfo, StreamCallOptions, StreamOptions, StreamEventName, } from './types';
+export { LingXiaBridge, channel, initBridge, invoke, notify, stream, } from './bridge';
+export { isNativeError } from './invocation';
 export { renderErrorUI, hasError, getErrorInfo } from './error';
 export { boot, bootWhenReady } from './boot';

package/dist/invocation.d.ts

@@ -6,6 +6,8 @@ export type StreamResult<TMethod> = TMethod extends (...args: any[]) => LxStream
 export type ChannelIn<TMethod> = TMethod extends (...args: any[]) => Promise<LxChannel<infer TIn, any>> ? TIn : never;
 export type ChannelOut<TMethod> = TMethod extends (...args: any[]) => Promise<LxChannel<any, infer TOut>> ? TOut : never;
 export declare function toBridgeError(err: unknown): LxBridgeError;
+export declare function toNativeError(err: unknown): import("./types").NativeError;
+export declare function isNativeError(error: unknown, code?: string): error is import("./types").NativeError;
 export declare function resolveParams<T>(source?: ParamsSource<T>): T | undefined;
 export declare function stableParamKey(value: unknown): string;
 export declare function invokeMethod<TMethod extends (...args: any[]) => any>(method: TMethod, params: unknown): ReturnType<TMethod>;

package/dist/types.d.ts

@@ -31,6 +31,11 @@ export interface LxBridgeError {
     message?: string;
     data?: unknown;
 }
+export interface NativeError {
+    code: string;
+    message: string;
+    data?: unknown;
+}
 export interface StateInfo {
     rev: number;
     initial: boolean;
@@ -79,12 +84,11 @@ export interface LxStream<TData = unknown, TResult = unknown> extends AsyncItera
     readonly id: string;
     readonly result: Promise<TResult>;
 }
-export interface HostChannelApi {
-    [namespace: string]: unknown;
-}
-export interface HostApi {
-    channel: HostChannelApi;
-    [namespace: string]: unknown;
+export interface NativeStream<TEvent = unknown, TResult = void> {
+    onEvent(listener: (event: TEvent) => void): () => void;
+    onError(listener: (error: NativeError) => void): () => void;
+    result: Promise<TResult>;
+    cancel(): void;
 }
 export interface LxChannel<TIn = unknown, TOut = TIn> extends AsyncIterable<TIn> {
     send(payload: TOut): void;
@@ -95,6 +99,16 @@ export interface LxChannel<TIn = unknown, TOut = TIn> extends AsyncIterable<TIn>
     [Symbol.asyncIterator](): AsyncIterator<TIn, void, void>;
     readonly id: string;
 }
+export interface ChannelCloseEvent {
+    code?: string;
+    reason?: string;
+}
+export interface NativeChannel<TIn = unknown, TOut = unknown> {
+    send(message: TIn): void;
+    onMessage(listener: (message: TOut) => void): () => void;
+    onClose(listener: (event: ChannelCloseEvent) => void): () => void;
+    close(code?: string, reason?: string): void;
+}
 declare global {
     interface Window {
         __LX_BRIDGE_CFG?: BridgeConfig;
@@ -114,7 +128,6 @@ declare global {
         NativeComponentBridge?: {
             postMessage: (message: string) => void;
         };
-        host?: HostApi;
         webkit?: {
             messageHandlers: {
                 [key: string]: {
@@ -125,17 +138,14 @@ declare global {
     }
 }
 export interface LingXiaBridgeInterface {
-    call(method: string, params?: unknown, options?: CallOptions): Promise<unknown>;
-    call<M extends LxMethod>(method: M, params?: LxMethodParams<M>, options?: CallOptions): Promise<LxMethodResult<M>>;
-    stream(method: string, params?: unknown, options?: StreamCallOptions): LxStream<unknown, unknown>;
-    stream<M extends LxMethod>(method: M, params?: LxMethodParams<M>, options?: StreamCallOptions): LxStream<LxMethodStreamData<M>, LxMethodResult<M>>;
-    notify(method: string, params?: unknown, options?: NotifyOptions): void;
+    invoke<TResult = unknown, TInput = void>(route: string, input?: TInput, options?: InvokeOptions): Promise<TResult>;
+    stream<TEvent = unknown, TResult = void, TInput = void>(route: string, input?: TInput, options?: StreamOptions): NativeStream<TEvent, TResult>;
+    notify<TInput = void>(route: string, input?: TInput, options?: NotifyOptions): void;
+    channel<TIn = unknown, TOut = unknown>(route: string, input?: unknown, options?: ChannelOptions): Promise<NativeChannel<TIn, TOut>>;
+    raw: LingXiaBridgeRawInterface;
     state: {
         subscribe(callback: DataSubscriber): () => void;
     };
-    channel: {
-        open<TIn = unknown, TOut = TIn>(topic: string, params?: unknown, options?: ChannelOpenOptions): Promise<LxChannel<TIn, TOut>>;
-    };
     _connectWebMessagePort(port: MessagePort): void;
     _receiveEvaluateMessage(messageString: string): void;
     debug: {
@@ -163,3 +173,19 @@ export interface LingXiaBridgeInterface {
     };
     isReady(): boolean;
 }
+export interface LingXiaBridgeRawInterface {
+    call(method: string, params?: unknown, options?: CallOptions): Promise<unknown>;
+    call<M extends LxMethod>(method: M, params?: LxMethodParams<M>, options?: CallOptions): Promise<LxMethodResult<M>>;
+    stream(method: string, params?: unknown, options?: StreamCallOptions): LxStream<unknown, unknown>;
+    stream<M extends LxMethod>(method: M, params?: LxMethodParams<M>, options?: StreamCallOptions): LxStream<LxMethodStreamData<M>, LxMethodResult<M>>;
+    notify(method: string, params?: unknown, options?: NotifyOptions): void;
+    channel: {
+        open<TIn = unknown, TOut = TIn>(topic: string, params?: unknown, options?: ChannelOpenOptions): Promise<LxChannel<TIn, TOut>>;
+    };
+}
+export interface InvokeOptions extends CallOptions {
+}
+export interface StreamOptions extends StreamCallOptions {
+}
+export interface ChannelOptions extends ChannelOpenOptions {
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingxia/bridge",
-  "version": "0.5.1",
+  "version": "0.6.3",
   "private": false,
   "description": "LingXia Web Runtime - Bridge, boot, and error handling for WebView",
   "type": "module",

package/dist/es2020/image-proxy.js

@@ -1,82 +0,0 @@
-import { getPlatformOS } from './runtime-env';
-const PROXY_PREFIX = 'lx://proxy/';
-function shouldProxyImageUrl(trimmed) {
-    if (trimmed.length === 0) {
-        return false;
-    }
-    if (trimmed.startsWith('lx://') ||
-        trimmed.startsWith('data:') ||
-        trimmed.startsWith('blob:') ||
-        trimmed.startsWith('file:')) {
-        return false;
-    }
-    return trimmed.startsWith('http://') || trimmed.startsWith('https://');
-}
-function toProxyUrl(url) {
-    const b64 = btoa(url);
-    const urlSafe = b64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '');
-    return `${PROXY_PREFIX}${urlSafe}`;
-}
-function proxyImageUrl(url) {
-    const trimmed = url.trim();
-    if (!shouldProxyImageUrl(trimmed))
-        return url;
-    return toProxyUrl(trimmed);
-}
-export function setupImageProxy() {
-    const os = getPlatformOS();
-    if (os !== 'iOS' && os !== 'macOS')
-        return;
-    if (typeof window === 'undefined' || typeof document === 'undefined')
-        return;
-    if (typeof HTMLImageElement === 'undefined')
-        return;
-    const proto = HTMLImageElement.prototype;
-    if (proto.__lxProxyPatched)
-        return;
-    proto.__lxProxyPatched = true;
-    const originalSetAttribute = proto.setAttribute;
-    proto.setAttribute = function (name, value) {
-        if (typeof name === 'string' && name.toLowerCase() === 'src' && typeof value === 'string') {
-            return originalSetAttribute.call(this, name, proxyImageUrl(value));
-        }
-        return originalSetAttribute.call(this, name, value);
-    };
-    const srcDescriptor = Object.getOwnPropertyDescriptor(proto, 'src');
-    if (srcDescriptor?.set) {
-        Object.defineProperty(proto, 'src', {
-            configurable: srcDescriptor.configurable,
-            enumerable: srcDescriptor.enumerable,
-            get: srcDescriptor.get,
-            set(value) {
-                if (typeof value === 'string') {
-                    srcDescriptor.set?.call(this, proxyImageUrl(value));
-                }
-                else {
-                    srcDescriptor.set?.call(this, value);
-                }
-            },
-        });
-    }
-    const rewriteExisting = () => {
-        const imgs = document.querySelectorAll('img[src]');
-        imgs.forEach((img) => {
-            const src = img.getAttribute('src');
-            if (!src)
-                return;
-            const proxied = proxyImageUrl(src);
-            if (proxied !== src) {
-                originalSetAttribute.call(img, 'src', proxied);
-            }
-        });
-    };
-    const domReadyListener = {
-        handleEvent: () => rewriteExisting(),
-    };
-    if (document.readyState === 'loading') {
-        document.addEventListener('DOMContentLoaded', domReadyListener);
-    }
-    else {
-        rewriteExisting();
-    }
-}

package/dist/es5/image-proxy.js

@@ -1,83 +0,0 @@
-import { getPlatformOS } from './runtime-env';
-var PROXY_PREFIX = 'lx://proxy/';
-function shouldProxyImageUrl(trimmed) {
-    if (trimmed.length === 0) {
-        return false;
-    }
-    if (trimmed.startsWith('lx://') ||
-        trimmed.startsWith('data:') ||
-        trimmed.startsWith('blob:') ||
-        trimmed.startsWith('file:')) {
-        return false;
-    }
-    return trimmed.startsWith('http://') || trimmed.startsWith('https://');
-}
-function toProxyUrl(url) {
-    var b64 = btoa(url);
-    var urlSafe = b64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '');
-    return "".concat(PROXY_PREFIX).concat(urlSafe);
-}
-function proxyImageUrl(url) {
-    var trimmed = url.trim();
-    if (!shouldProxyImageUrl(trimmed))
-        return url;
-    return toProxyUrl(trimmed);
-}
-export function setupImageProxy() {
-    var os = getPlatformOS();
-    if (os !== 'iOS' && os !== 'macOS')
-        return;
-    if (typeof window === 'undefined' || typeof document === 'undefined')
-        return;
-    if (typeof HTMLImageElement === 'undefined')
-        return;
-    var proto = HTMLImageElement.prototype;
-    if (proto.__lxProxyPatched)
-        return;
-    proto.__lxProxyPatched = true;
-    var originalSetAttribute = proto.setAttribute;
-    proto.setAttribute = function (name, value) {
-        if (typeof name === 'string' && name.toLowerCase() === 'src' && typeof value === 'string') {
-            return originalSetAttribute.call(this, name, proxyImageUrl(value));
-        }
-        return originalSetAttribute.call(this, name, value);
-    };
-    var srcDescriptor = Object.getOwnPropertyDescriptor(proto, 'src');
-    if (srcDescriptor === null || srcDescriptor === void 0 ? void 0 : srcDescriptor.set) {
-        Object.defineProperty(proto, 'src', {
-            configurable: srcDescriptor.configurable,
-            enumerable: srcDescriptor.enumerable,
-            get: srcDescriptor.get,
-            set: function (value) {
-                var _a, _b;
-                if (typeof value === 'string') {
-                    (_a = srcDescriptor.set) === null || _a === void 0 ? void 0 : _a.call(this, proxyImageUrl(value));
-                }
-                else {
-                    (_b = srcDescriptor.set) === null || _b === void 0 ? void 0 : _b.call(this, value);
-                }
-            },
-        });
-    }
-    var rewriteExisting = function () {
-        var imgs = document.querySelectorAll('img[src]');
-        imgs.forEach(function (img) {
-            var src = img.getAttribute('src');
-            if (!src)
-                return;
-            var proxied = proxyImageUrl(src);
-            if (proxied !== src) {
-                originalSetAttribute.call(img, 'src', proxied);
-            }
-        });
-    };
-    var domReadyListener = {
-        handleEvent: function () { return rewriteExisting(); },
-    };
-    if (document.readyState === 'loading') {
-        document.addEventListener('DOMContentLoaded', domReadyListener);
-    }
-    else {
-        rewriteExisting();
-    }
-}

package/dist/image-proxy.d.ts

@@ -1 +0,0 @@
-export declare function setupImageProxy(): void;