@fkn/lib 0.2.1 → 0.3.1

package/api/webvpn/udp.d.ts

@@ -0,0 +1,30 @@
+import { UdpSocketOption } from './packets/udp';
+export type { UdpSocketOption } from './packets/udp';
+export { UDP_OPTION_BROADCAST, UDP_OPTION_TTL, UDP_OPTION_MULTICAST_TTL_V4, UDP_OPTION_MULTICAST_LOOP_V4, UDP_OPTION_MULTICAST_LOOP_V6, UDP_OPTION_ADD_MEMBERSHIP_V4, UDP_OPTION_DROP_MEMBERSHIP_V4, UDP_OPTION_ADD_MEMBERSHIP_V6, UDP_OPTION_DROP_MEMBERSHIP_V6, UDP_OPTION_SEND_BUFFER_SIZE, UDP_OPTION_RECV_BUFFER_SIZE, } from './packets/udp';
+export declare const webVpnUdpSocket: ({ type, port, address }: {
+    type: "udp4" | "udp6";
+    port: number;
+    address: string;
+}) => Promise<{
+    localAddress: string;
+    localFamily: "IPv4" | "IPv6";
+    localPort: number;
+    dataReadableStream: ReadableStream<{
+        data: ArrayBuffer;
+        size: number;
+        family: "IPv4" | "IPv6";
+        address: string;
+        port: number;
+    }>;
+    connect: ({ remoteAddress: _remoteAddress, remotePort }: {
+        remoteAddress: string;
+        remotePort: number;
+    }) => Promise<void>;
+    send: ({ message, address: _remoteAddress, port: remotePort }: {
+        message: ArrayBuffer;
+        address?: string;
+        port?: number;
+    }) => Promise<void>;
+    close: () => Promise<void>;
+    setOption: (option: UdpSocketOption) => Promise<void>;
+}>;

package/api/webvpn/utils.d.ts

@@ -0,0 +1,26 @@
+import { AddressLookupResult } from '../dns';
+import { Address4, Address6 } from 'ip-address';
+export declare const textEncoder: TextEncoder;
+export declare const textDecoder: TextDecoder;
+export declare class DNSError extends Error {
+    code: string;
+    errno: number;
+    syscall: string;
+    hostname: string;
+    constructor(hostname: string);
+}
+export declare const addressLookupToAddress: (addressLookup: AddressLookupResult) => Promise<{
+    address: Address4 | Address6;
+    addressType: 0 | 1;
+}>;
+export declare const readableStreamCloner: <T>(readableStream: ReadableStream<T>) => () => ReadableStream<T>;
+export declare const streamWriterToWritableStreamCloner: <T>(writer: WritableStreamDefaultWriter<T>, options?: {
+    neverClose?: boolean;
+}) => () => WritableStream<T>;
+export declare const createPacketFilterTransformStream: <T>(filter: (packet: T) => boolean) => TransformStream<T, T>;
+export declare const makeExternalPromise: <T>(resolve?: (arg: T) => void, reject?: (err: Error) => void) => {
+    promise: Promise<T>;
+    resolve: (arg: T) => void;
+    reject: (err: Error) => void;
+};
+export declare const makeIdCounter: (max?: number) => () => number;

package/api/webvpn/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/api/webvpn/webtransport.d.ts

@@ -0,0 +1,63 @@
+import { ServerMetadataPacket } from './packets/metadata';
+import { Address4, Address6 } from 'ip-address';
+export interface WebTransportOptions {
+    address: string;
+    serverCertificateHashes: {
+        algorithm: string;
+        value: number[];
+    };
+}
+type BidirectionalStreams = {
+    readable: ReadableStream<Uint8Array>;
+    writable: WritableStream<Uint8Array>;
+};
+export declare const configureWebVpn: (opts: {
+    origin?: string;
+    certHashes?: WebTransportOptions["serverCertificateHashes"];
+}) => void;
+declare const makeWebVPNWebTransport: () => Promise<{
+    webtransport: WebTransport;
+    getNewPacketId: () => number;
+    getTcpDataReadableStreamForSocketId: (socketId: number, options?: {
+        signal?: AbortSignal;
+    }) => Promise<BidirectionalStreams>;
+    getUdpDataReadableStreamForSocketId: (socketId: number) => ReadableStream<{
+        readonly _type: "ServerUdpDataPacket";
+        readonly offset: number;
+        readonly socketId: number;
+        readonly remoteAddressType: 0 | 1 | 2;
+        readonly remoteAddress: Address4 | Address6 | undefined;
+        readonly remotePort: number | undefined;
+        readonly dataLength: number;
+        readonly data: ArrayBuffer;
+    }>;
+    getPacketForId: (packetId: number) => Promise<ServerMetadataPacket>;
+    getMetadataReadableStreamForSocketId: (socketId: number) => ReadableStream<ServerMetadataPacket>;
+    getMetadataReadableStreamForLocalAddress: (address: Address4 | Address6) => ReadableStream<ServerMetadataPacket>;
+    getMetadataWritableStream: () => WritableStream<Uint8Array<ArrayBufferLike>>;
+    getDatagramWritableStream: () => WritableStream<Uint8Array<ArrayBufferLike>>;
+}>;
+export type WebVPNWebTransport = Awaited<ReturnType<typeof makeWebVPNWebTransport>>;
+export declare const getWebVpnWebTransport: () => Promise<{
+    webtransport: WebTransport;
+    getNewPacketId: () => number;
+    getTcpDataReadableStreamForSocketId: (socketId: number, options?: {
+        signal?: AbortSignal;
+    }) => Promise<BidirectionalStreams>;
+    getUdpDataReadableStreamForSocketId: (socketId: number) => ReadableStream<{
+        readonly _type: "ServerUdpDataPacket";
+        readonly offset: number;
+        readonly socketId: number;
+        readonly remoteAddressType: 0 | 1 | 2;
+        readonly remoteAddress: Address4 | Address6 | undefined;
+        readonly remotePort: number | undefined;
+        readonly dataLength: number;
+        readonly data: ArrayBuffer;
+    }>;
+    getPacketForId: (packetId: number) => Promise<ServerMetadataPacket>;
+    getMetadataReadableStreamForSocketId: (socketId: number) => ReadableStream<ServerMetadataPacket>;
+    getMetadataReadableStreamForLocalAddress: (address: Address4 | Address6) => ReadableStream<ServerMetadataPacket>;
+    getMetadataWritableStream: () => WritableStream<Uint8Array<ArrayBufferLike>>;
+    getDatagramWritableStream: () => WritableStream<Uint8Array<ArrayBufferLike>>;
+}>;
+export {};