@xyo-network/bridge-http 2.111.3 → 3.0.0

package/dist/browser/index-browser.d.ts

@@ -1,3 +1,105 @@
-export * from './HttpBridgeClientOnly.ts';
-export * from './HttpBridgeConfig.ts';
-//# sourceMappingURL=index-browser.d.ts.map
+import { BridgeConfig, BridgeModule, BridgeExposeOptions, BridgeUnexposeOptions, BridgeParams } from '@xyo-network/bridge-model';
+import * as _xyo_network_module_model from '@xyo-network/module-model';
+import { ModuleQueryResult, ModuleInstance, ModuleIdentifier, ModuleFilterOptions, AnyConfigSchema } from '@xyo-network/module-model';
+import * as _xyo_network_payload_model from '@xyo-network/payload-model';
+import { Payload, Schema } from '@xyo-network/payload-model';
+import * as _xyo_network_account from '@xyo-network/account';
+import * as _xylabs_object from '@xylabs/object';
+import { EmptyObject } from '@xylabs/object';
+import { Address } from '@xylabs/hex';
+import { ModuleProxyParams, BridgeModuleResolverParams, AbstractBridgeModuleResolver, AbstractBridge } from '@xyo-network/bridge-abstract';
+import { Mutex, Semaphore } from 'async-mutex';
+import { LRUCache } from 'lru-cache';
+import { QueryBoundWitness } from '@xyo-network/boundwitness-model';
+import { AxiosJson } from '@xylabs/axios';
+import { Promisable } from '@xylabs/promise';
+
+interface BridgeQuerySender {
+    sendBridgeQuery: <TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(targetAddress: Address, query: TQuery, payloads?: TIn[]) => Promise<ModuleQueryResult<TOut>>;
+}
+type HttpModuleProxyParams = ModuleProxyParams & {
+    querySender: BridgeQuerySender;
+};
+
+interface HttpBridgeModuleResolverParams extends BridgeModuleResolverParams {
+    querySender: BridgeQuerySender;
+    rootUrl: string;
+}
+declare class HttpBridgeModuleResolver<T extends HttpBridgeModuleResolverParams = HttpBridgeModuleResolverParams> extends AbstractBridgeModuleResolver<T> {
+    protected _resolvedCache: LRUCache<Lowercase<string>, ModuleInstance<_xylabs_object.BaseParamsFields & {
+        account?: _xyo_network_account.AccountInstance | "random";
+        addToResolvers?: boolean;
+        additionalSigners?: _xyo_network_account.AccountInstance[];
+        allowNameResolution?: boolean;
+        config: _xyo_network_payload_model.SchemaFields & _xyo_network_payload_model.PayloadFields & Omit<_xyo_network_module_model.ArchivingModuleConfig & _xyo_network_module_model.ModuleConfigFields & _xyo_network_payload_model.SchemaFields & _xyo_network_payload_model.PayloadFields & {
+            schema: "network.xyo.module.config";
+        }, "schema"> & {
+            schema: string;
+        };
+        ephemeralQueryAccountEnabled?: boolean;
+        moduleIdentifierTransformers?: _xyo_network_module_model.ModuleIdentifierTransformer[];
+    }, _xyo_network_module_model.ModuleEventData<object>> | {
+        notFound: boolean;
+    }, unknown>;
+    protected _resolvedCacheMutex: Mutex;
+    get querySender(): BridgeQuerySender;
+    moduleUrl(address: Address): URL;
+    resolveHandler<T extends ModuleInstance = ModuleInstance>(id: ModuleIdentifier, options?: ModuleFilterOptions<T>, params?: Partial<HttpModuleProxyParams>): Promise<T[]>;
+}
+
+type HttpBridgeConfigSchema = 'network.xyo.bridge.http.config';
+declare const HttpBridgeConfigSchema: HttpBridgeConfigSchema;
+type HttpBridgeConfig<TConfig extends EmptyObject = EmptyObject, TSchema extends string | void = void> = BridgeConfig<{
+    client?: BridgeConfig['client'] & {
+        url: string;
+    };
+    failureRetryTime?: number;
+    failureTimeCacheMax?: number;
+    host?: {
+        port: number;
+    };
+    maxConnections?: number;
+    maxPayloadSizeWarning?: number;
+    nodeUrl?: string;
+    schema: HttpBridgeConfigSchema;
+} & TConfig, TSchema extends string ? TSchema : HttpBridgeConfigSchema>;
+
+interface HttpBridgeParams$1 extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {
+    axios?: AxiosJson;
+}
+declare class HttpBridgeBase<TParams extends HttpBridgeParams$1> extends AbstractBridge<TParams> implements BridgeModule<TParams>, BridgeQuerySender {
+    static axios: AxiosJson;
+    static readonly configSchemas: Schema[];
+    static readonly defaultConfigSchema: Schema;
+    static defaultFailureRetryTime: number;
+    static defaultMaxConnections: number;
+    static defaultMaxPayloadSizeWarning: number;
+    static maxFailureCacheSize: number;
+    private _axios?;
+    private _discoverRootsMutex;
+    private _failureTimeCache;
+    private _querySemaphore?;
+    private _resolver?;
+    get axios(): AxiosJson;
+    get clientUrl(): string;
+    get failureRetryTime(): number;
+    get maxConnections(): number;
+    get maxPayloadSizeWarning(): number;
+    get querySemaphore(): Semaphore;
+    get resolver(): HttpBridgeModuleResolver<HttpBridgeModuleResolverParams>;
+    exposeHandler(_id: string, _options?: BridgeExposeOptions | undefined): Promisable<ModuleInstance[]>;
+    exposedHandler(): Promisable<Address[]>;
+    getRoots(force?: boolean): Promise<ModuleInstance[]>;
+    moduleUrl(address: Address): URL;
+    sendBridgeQuery<TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(targetAddress: Address, query: TQuery, payloads?: TIn[]): Promise<ModuleQueryResult<TOut>>;
+    unexposeHandler(_id: string, _options?: BridgeUnexposeOptions | undefined): Promisable<ModuleInstance[]>;
+    private getRootState;
+    private resolveRootNode;
+}
+
+interface HttpBridgeParams extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {
+}
+declare class HttpBridge<TParams extends HttpBridgeParams> extends HttpBridgeBase<TParams> {
+}
+
+export { HttpBridge, type HttpBridgeConfig, HttpBridgeConfigSchema, type HttpBridgeParams };

package/dist/neutral/index-browser.d.ts

@@ -1,3 +1,105 @@
-export * from './HttpBridgeClientOnly.ts';
-export * from './HttpBridgeConfig.ts';
-//# sourceMappingURL=index-browser.d.ts.map
+import { BridgeConfig, BridgeModule, BridgeExposeOptions, BridgeUnexposeOptions, BridgeParams } from '@xyo-network/bridge-model';
+import * as _xyo_network_module_model from '@xyo-network/module-model';
+import { ModuleQueryResult, ModuleInstance, ModuleIdentifier, ModuleFilterOptions, AnyConfigSchema } from '@xyo-network/module-model';
+import * as _xyo_network_payload_model from '@xyo-network/payload-model';
+import { Payload, Schema } from '@xyo-network/payload-model';
+import * as _xyo_network_account from '@xyo-network/account';
+import * as _xylabs_object from '@xylabs/object';
+import { EmptyObject } from '@xylabs/object';
+import { Address } from '@xylabs/hex';
+import { ModuleProxyParams, BridgeModuleResolverParams, AbstractBridgeModuleResolver, AbstractBridge } from '@xyo-network/bridge-abstract';
+import { Mutex, Semaphore } from 'async-mutex';
+import { LRUCache } from 'lru-cache';
+import { QueryBoundWitness } from '@xyo-network/boundwitness-model';
+import { AxiosJson } from '@xylabs/axios';
+import { Promisable } from '@xylabs/promise';
+
+interface BridgeQuerySender {
+    sendBridgeQuery: <TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(targetAddress: Address, query: TQuery, payloads?: TIn[]) => Promise<ModuleQueryResult<TOut>>;
+}
+type HttpModuleProxyParams = ModuleProxyParams & {
+    querySender: BridgeQuerySender;
+};
+
+interface HttpBridgeModuleResolverParams extends BridgeModuleResolverParams {
+    querySender: BridgeQuerySender;
+    rootUrl: string;
+}
+declare class HttpBridgeModuleResolver<T extends HttpBridgeModuleResolverParams = HttpBridgeModuleResolverParams> extends AbstractBridgeModuleResolver<T> {
+    protected _resolvedCache: LRUCache<Lowercase<string>, ModuleInstance<_xylabs_object.BaseParamsFields & {
+        account?: _xyo_network_account.AccountInstance | "random";
+        addToResolvers?: boolean;
+        additionalSigners?: _xyo_network_account.AccountInstance[];
+        allowNameResolution?: boolean;
+        config: _xyo_network_payload_model.SchemaFields & _xyo_network_payload_model.PayloadFields & Omit<_xyo_network_module_model.ArchivingModuleConfig & _xyo_network_module_model.ModuleConfigFields & _xyo_network_payload_model.SchemaFields & _xyo_network_payload_model.PayloadFields & {
+            schema: "network.xyo.module.config";
+        }, "schema"> & {
+            schema: string;
+        };
+        ephemeralQueryAccountEnabled?: boolean;
+        moduleIdentifierTransformers?: _xyo_network_module_model.ModuleIdentifierTransformer[];
+    }, _xyo_network_module_model.ModuleEventData<object>> | {
+        notFound: boolean;
+    }, unknown>;
+    protected _resolvedCacheMutex: Mutex;
+    get querySender(): BridgeQuerySender;
+    moduleUrl(address: Address): URL;
+    resolveHandler<T extends ModuleInstance = ModuleInstance>(id: ModuleIdentifier, options?: ModuleFilterOptions<T>, params?: Partial<HttpModuleProxyParams>): Promise<T[]>;
+}
+
+type HttpBridgeConfigSchema = 'network.xyo.bridge.http.config';
+declare const HttpBridgeConfigSchema: HttpBridgeConfigSchema;
+type HttpBridgeConfig<TConfig extends EmptyObject = EmptyObject, TSchema extends string | void = void> = BridgeConfig<{
+    client?: BridgeConfig['client'] & {
+        url: string;
+    };
+    failureRetryTime?: number;
+    failureTimeCacheMax?: number;
+    host?: {
+        port: number;
+    };
+    maxConnections?: number;
+    maxPayloadSizeWarning?: number;
+    nodeUrl?: string;
+    schema: HttpBridgeConfigSchema;
+} & TConfig, TSchema extends string ? TSchema : HttpBridgeConfigSchema>;
+
+interface HttpBridgeParams$1 extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {
+    axios?: AxiosJson;
+}
+declare class HttpBridgeBase<TParams extends HttpBridgeParams$1> extends AbstractBridge<TParams> implements BridgeModule<TParams>, BridgeQuerySender {
+    static axios: AxiosJson;
+    static readonly configSchemas: Schema[];
+    static readonly defaultConfigSchema: Schema;
+    static defaultFailureRetryTime: number;
+    static defaultMaxConnections: number;
+    static defaultMaxPayloadSizeWarning: number;
+    static maxFailureCacheSize: number;
+    private _axios?;
+    private _discoverRootsMutex;
+    private _failureTimeCache;
+    private _querySemaphore?;
+    private _resolver?;
+    get axios(): AxiosJson;
+    get clientUrl(): string;
+    get failureRetryTime(): number;
+    get maxConnections(): number;
+    get maxPayloadSizeWarning(): number;
+    get querySemaphore(): Semaphore;
+    get resolver(): HttpBridgeModuleResolver<HttpBridgeModuleResolverParams>;
+    exposeHandler(_id: string, _options?: BridgeExposeOptions | undefined): Promisable<ModuleInstance[]>;
+    exposedHandler(): Promisable<Address[]>;
+    getRoots(force?: boolean): Promise<ModuleInstance[]>;
+    moduleUrl(address: Address): URL;
+    sendBridgeQuery<TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(targetAddress: Address, query: TQuery, payloads?: TIn[]): Promise<ModuleQueryResult<TOut>>;
+    unexposeHandler(_id: string, _options?: BridgeUnexposeOptions | undefined): Promisable<ModuleInstance[]>;
+    private getRootState;
+    private resolveRootNode;
+}
+
+interface HttpBridgeParams extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {
+}
+declare class HttpBridge<TParams extends HttpBridgeParams> extends HttpBridgeBase<TParams> {
+}
+
+export { HttpBridge, type HttpBridgeConfig, HttpBridgeConfigSchema, type HttpBridgeParams };

package/dist/node/index.d.ts

@@ -1,3 +1,128 @@
-export * from './HttpBridgeConfig.ts';
-export * from './HttpBridgeFull.ts';
-//# sourceMappingURL=index.d.ts.map
+import * as _xylabs_object from '@xylabs/object';
+import { EmptyObject } from '@xylabs/object';
+import { BridgeConfig, BridgeModule, BridgeExposeOptions, BridgeUnexposeOptions, BridgeParams } from '@xyo-network/bridge-model';
+import * as _store__types_express_serve_static_core_npm_4_19_5_6a71bb1fe8_package from '.store/@types-express-serve-static-core-npm-4.19.5-6a71bb1fe8/package';
+import { Server } from 'node:http';
+import { Address } from '@xylabs/hex';
+import { QueryBoundWitness } from '@xyo-network/boundwitness-model';
+import * as _xyo_network_module_model from '@xyo-network/module-model';
+import { ModuleQueryResult, ModuleInstance, ModuleIdentifier, ModuleFilterOptions, AnyConfigSchema } from '@xyo-network/module-model';
+import * as _xyo_network_payload_model from '@xyo-network/payload-model';
+import { Payload, Schema } from '@xyo-network/payload-model';
+import express, { Application, Request, Response } from 'express';
+import * as _xyo_network_account from '@xyo-network/account';
+import { ModuleProxyParams, BridgeModuleResolverParams, AbstractBridgeModuleResolver, AbstractBridge } from '@xyo-network/bridge-abstract';
+import { Mutex, Semaphore } from 'async-mutex';
+import { LRUCache } from 'lru-cache';
+import { AxiosJson } from '@xylabs/axios';
+import { Promisable } from '@xylabs/promise';
+
+type HttpBridgeConfigSchema = 'network.xyo.bridge.http.config';
+declare const HttpBridgeConfigSchema: HttpBridgeConfigSchema;
+type HttpBridgeConfig<TConfig extends EmptyObject = EmptyObject, TSchema extends string | void = void> = BridgeConfig<{
+    client?: BridgeConfig['client'] & {
+        url: string;
+    };
+    failureRetryTime?: number;
+    failureTimeCacheMax?: number;
+    host?: {
+        port: number;
+    };
+    maxConnections?: number;
+    maxPayloadSizeWarning?: number;
+    nodeUrl?: string;
+    schema: HttpBridgeConfigSchema;
+} & TConfig, TSchema extends string ? TSchema : HttpBridgeConfigSchema>;
+
+interface BridgeQuerySender {
+    sendBridgeQuery: <TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(targetAddress: Address, query: TQuery, payloads?: TIn[]) => Promise<ModuleQueryResult<TOut>>;
+}
+type HttpModuleProxyParams = ModuleProxyParams & {
+    querySender: BridgeQuerySender;
+};
+
+interface HttpBridgeModuleResolverParams extends BridgeModuleResolverParams {
+    querySender: BridgeQuerySender;
+    rootUrl: string;
+}
+declare class HttpBridgeModuleResolver<T extends HttpBridgeModuleResolverParams = HttpBridgeModuleResolverParams> extends AbstractBridgeModuleResolver<T> {
+    protected _resolvedCache: LRUCache<Lowercase<string>, ModuleInstance<_xylabs_object.BaseParamsFields & {
+        account?: _xyo_network_account.AccountInstance | "random";
+        addToResolvers?: boolean;
+        additionalSigners?: _xyo_network_account.AccountInstance[];
+        allowNameResolution?: boolean;
+        config: _xyo_network_payload_model.SchemaFields & _xyo_network_payload_model.PayloadFields & Omit<_xyo_network_module_model.ArchivingModuleConfig & _xyo_network_module_model.ModuleConfigFields & _xyo_network_payload_model.SchemaFields & _xyo_network_payload_model.PayloadFields & {
+            schema: "network.xyo.module.config";
+        }, "schema"> & {
+            schema: string;
+        };
+        ephemeralQueryAccountEnabled?: boolean;
+        moduleIdentifierTransformers?: _xyo_network_module_model.ModuleIdentifierTransformer[];
+    }, _xyo_network_module_model.ModuleEventData<object>> | {
+        notFound: boolean;
+    }, unknown>;
+    protected _resolvedCacheMutex: Mutex;
+    get querySender(): BridgeQuerySender;
+    moduleUrl(address: Address): URL;
+    resolveHandler<T extends ModuleInstance = ModuleInstance>(id: ModuleIdentifier, options?: ModuleFilterOptions<T>, params?: Partial<HttpModuleProxyParams>): Promise<T[]>;
+}
+
+interface HttpBridgeParams$1 extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {
+    axios?: AxiosJson;
+}
+declare class HttpBridgeBase<TParams extends HttpBridgeParams$1> extends AbstractBridge<TParams> implements BridgeModule<TParams>, BridgeQuerySender {
+    static axios: AxiosJson;
+    static readonly configSchemas: Schema[];
+    static readonly defaultConfigSchema: Schema;
+    static defaultFailureRetryTime: number;
+    static defaultMaxConnections: number;
+    static defaultMaxPayloadSizeWarning: number;
+    static maxFailureCacheSize: number;
+    private _axios?;
+    private _discoverRootsMutex;
+    private _failureTimeCache;
+    private _querySemaphore?;
+    private _resolver?;
+    get axios(): AxiosJson;
+    get clientUrl(): string;
+    get failureRetryTime(): number;
+    get maxConnections(): number;
+    get maxPayloadSizeWarning(): number;
+    get querySemaphore(): Semaphore;
+    get resolver(): HttpBridgeModuleResolver<HttpBridgeModuleResolverParams>;
+    exposeHandler(_id: string, _options?: BridgeExposeOptions | undefined): Promisable<ModuleInstance[]>;
+    exposedHandler(): Promisable<Address[]>;
+    getRoots(force?: boolean): Promise<ModuleInstance[]>;
+    moduleUrl(address: Address): URL;
+    sendBridgeQuery<TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(targetAddress: Address, query: TQuery, payloads?: TIn[]): Promise<ModuleQueryResult<TOut>>;
+    unexposeHandler(_id: string, _options?: BridgeUnexposeOptions | undefined): Promisable<ModuleInstance[]>;
+    private getRootState;
+    private resolveRootNode;
+}
+
+type AddressPathParams = {
+    address: Address;
+};
+type PostAddressRequestBody = [QueryBoundWitness, undefined | Payload[]];
+interface HttpBridgeParams extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {
+}
+declare class HttpBridge<TParams extends HttpBridgeParams> extends HttpBridgeBase<TParams> {
+    protected _app?: Application;
+    protected _exposedModules: WeakRef<ModuleInstance>[];
+    protected _server?: Server;
+    protected get app(): express.Application;
+    exposeChild(mod: ModuleInstance, options?: BridgeExposeOptions | undefined): Promise<ModuleInstance[]>;
+    exposeHandler(address: Address, options?: BridgeExposeOptions | undefined): Promise<ModuleInstance[]>;
+    exposedHandler(): Address[];
+    startHandler(): Promise<boolean>;
+    stopHandler(_timeout?: number | undefined): Promise<boolean>;
+    unexposeHandler(address: Address, options?: BridgeUnexposeOptions | undefined): Promise<ModuleInstance[]>;
+    protected callLocalModule(address: Address, query: QueryBoundWitness, payloads: Payload[]): Promise<ModuleQueryResult | null>;
+    protected handleGet(req: Request<AddressPathParams, ModuleQueryResult, PostAddressRequestBody>, res: Response): Promise<void>;
+    protected handlePost(req: Request<AddressPathParams, ModuleQueryResult, PostAddressRequestBody>, res: Response): Promise<express.Response<any, Record<string, any>> | undefined>;
+    protected initializeApp(): _store__types_express_serve_static_core_npm_4_19_5_6a71bb1fe8_package.Express;
+    protected startHttpServer(): Promise<boolean>;
+    protected stopHttpServer(): Promise<boolean>;
+}
+
+export { HttpBridge, type HttpBridgeConfig, HttpBridgeConfigSchema, type HttpBridgeParams };