react-native-nitro-net 0.3.0 → 0.4.0

package/lib/net.d.ts

@@ -0,0 +1,197 @@
+import { Duplex, DuplexOptions } from 'readable-stream';
+import { EventEmitter } from 'eventemitter3';
+import type { NetSocketDriver, NetConfig } from './Net.nitro';
+declare function isIP(input: string): number;
+declare function isIPv4(input: string): boolean;
+declare function isIPv6(input: string): boolean;
+declare function isVerbose(): boolean;
+declare function setVerbose(enabled: boolean): void;
+declare function getDefaultAutoSelectFamily(): number;
+declare function setDefaultAutoSelectFamily(family: number): void;
+/**
+ * Initialize the network module with custom configuration.
+ * Must be called before any socket/server operations, or the config will be ignored.
+ *
+ * @param config Configuration options
+ * @param config.workerThreads Number of worker threads (0 = use CPU core count)
+ *
+ * @example
+ * ```ts
+ * import { initWithConfig } from 'react-native-nitro-net';
+ *
+ * // Initialize with 4 worker threads
+ * initWithConfig({ workerThreads: 4 });
+ * ```
+ */
+declare function initWithConfig(config: NetConfig): void;
+export interface SocketAddressOptions {
+    address?: string;
+    family?: 'ipv4' | 'ipv6';
+    port?: number;
+    flowlabel?: number;
+}
+export declare class SocketAddress {
+    readonly address: string;
+    readonly family: 'ipv4' | 'ipv6';
+    readonly port: number;
+    readonly flowlabel: number;
+    constructor(options?: SocketAddressOptions);
+    /**
+     * Attempts to parse a string containing a socket address.
+     * Returns a SocketAddress if successful, or undefined if not.
+     *
+     * Supported formats:
+     * - `ip:port` (e.g., `127.0.0.1:8080`, `[::1]:8080`)
+     * - `ip` only (port defaults to 0)
+     */
+    static parse(input: string): SocketAddress | undefined;
+}
+export interface BlockListRule {
+    type: 'address' | 'range' | 'subnet';
+    address?: string;
+    start?: string;
+    end?: string;
+    prefix?: number;
+    family: 'ipv4' | 'ipv6';
+}
+export declare class BlockList {
+    private _rules;
+    /** Returns an array of rules added to the blocklist. */
+    get rules(): BlockListRule[];
+    addAddress(address: string, family?: 'ipv4' | 'ipv6'): void;
+    addRange(start: string, end: string, family?: 'ipv4' | 'ipv6'): void;
+    addSubnet(net: string, prefix: number, family?: 'ipv4' | 'ipv6'): void;
+    check(address: string, family?: 'ipv4' | 'ipv6'): boolean;
+    /**
+     * Serializes the BlockList to a JSON-compatible format.
+     */
+    toJSON(): BlockListRule[];
+    /**
+     * Creates a BlockList from a JSON array of rules.
+     */
+    static fromJSON(json: BlockListRule[]): BlockList;
+    /**
+     * Checks if a given value is a BlockList instance.
+     */
+    static isBlockList(value: unknown): value is BlockList;
+}
+export interface SocketOptions extends DuplexOptions {
+    fd?: any;
+    allowHalfOpen?: boolean;
+    readable?: boolean;
+    writable?: boolean;
+    path?: string;
+    socketDriver?: NetSocketDriver;
+    remoteFamily?: string;
+}
+export declare class Socket extends Duplex {
+    protected _driver: NetSocketDriver | undefined;
+    connecting: boolean;
+    protected _connected: boolean;
+    protected _hadError: boolean;
+    remoteAddress?: string;
+    remotePort?: number;
+    remoteFamily?: string;
+    localAddress?: string;
+    localPort?: number;
+    bytesRead: number;
+    bytesWritten: number;
+    autoSelectFamilyAttemptedAddresses: string[];
+    private _autoSelectFamily;
+    private _timeout;
+    get localFamily(): string;
+    get readyState(): string;
+    get pending(): boolean;
+    constructor(options?: SocketOptions);
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
+    private _setupEvents;
+    private _updateAddresses;
+    address(): {
+        port: number;
+        family: string;
+        address: string;
+    } | null;
+    connect(options: any, connectionListener?: () => void): this;
+    private _connect;
+    private _connectUnix;
+    end(cb?: () => void): this;
+    end(chunk: any, cb?: () => void): this;
+    end(chunk: any, encoding: string, cb?: () => void): this;
+    _write(chunk: any, encoding: string, callback: (error?: Error | null) => void): void;
+    _read(size: number): void;
+    _final(callback: (error?: Error | null) => void): void;
+    destroy(reason?: Error): this;
+    _destroy(err: Error | null, callback: (error: Error | null) => void): void;
+    setTimeout(msecs: number, callback?: () => void): this;
+    /**
+     * Pause the reading of data. That is, 'data' events will not be emitted.
+     * Useful to throttle back an upload.
+     */
+    pause(): this;
+    /**
+     * Resume reading after a call to pause().
+     */
+    resume(): this;
+    /**
+     * Enable/disable the use of Nagle's algorithm.
+     */
+    setNoDelay(noDelay?: boolean): this;
+    setKeepAlive(enable?: boolean, initialDelay?: number): this;
+    ref(): this;
+    unref(): this;
+    /**
+     * Set the encoding for the socket as a Readable Stream.
+     * Use 'utf8', 'hex', etc.
+     */
+    setEncoding(encoding: BufferEncoding): this;
+    get timeout(): number;
+    get bufferSize(): number;
+    resetAndDestroy(): this;
+}
+export declare class Server extends EventEmitter {
+    private _driver;
+    private _sockets;
+    private _connections;
+    private _maxConnections;
+    private _dropMaxConnection;
+    get maxConnections(): number;
+    set maxConnections(value: number);
+    get dropMaxConnection(): boolean;
+    set dropMaxConnection(value: boolean);
+    get listening(): boolean;
+    constructor(options?: any, connectionListener?: (socket: Socket) => void);
+    ref(): this;
+    unref(): this;
+    [Symbol.asyncDispose](): Promise<void>;
+    listen(port?: any, host?: any, backlog?: any, callback?: any): this;
+    close(callback?: (err?: Error) => void): this;
+    address(): {
+        port: number;
+        family: string;
+        address: string;
+    } | null;
+    getConnections(cb: (err: Error | null, count: number) => void): void;
+}
+export declare function createConnection(options: any, connectionListener?: () => void): Socket;
+export declare const connect: typeof createConnection;
+export declare function createServer(options?: any, connectionListener?: (socket: Socket) => void): Server;
+export { isIP, isIPv4, isIPv6, getDefaultAutoSelectFamily, setDefaultAutoSelectFamily, isVerbose, setVerbose, initWithConfig, };
+export type { NetConfig };
+declare const _default: {
+    Socket: typeof Socket;
+    Server: typeof Server;
+    SocketAddress: typeof SocketAddress;
+    BlockList: typeof BlockList;
+    createConnection: typeof createConnection;
+    createServer: typeof createServer;
+    connect: typeof createConnection;
+    isIP: typeof isIP;
+    isIPv4: typeof isIPv4;
+    isIPv6: typeof isIPv6;
+    getDefaultAutoSelectFamily: typeof getDefaultAutoSelectFamily;
+    setDefaultAutoSelectFamily: typeof setDefaultAutoSelectFamily;
+    setVerbose: typeof setVerbose;
+    initWithConfig: typeof initWithConfig;
+};
+export default _default;
+//# sourceMappingURL=net.d.ts.map

package/lib/net.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../src/net.ts"],"names":[],"mappings":"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"}