@araminix/lib 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amin Abbasi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,194 @@
-# Temporary Holding Version
+# @araminix/lib
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Universal, type-safe multiplexed WebSocket streaming and functional communication protocol.**
+
+[![npm version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://www.npmjs.com/package/@araminix/lib)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.4-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20.0.0-green.svg)](https://nodejs.org/)
+
+**Araminix Lib** (`@araminix/lib`) provides the foundational communication layer for modern real-time applications. Designed to be completely **isomorphic**, it runs seamlessly across **Node.js**, **Web Browsers**, **Web Workers**, and modern frontend frameworks (React, Vue, Svelte, Angular).
+
+Instead of maintaining multiple raw WebSocket connections or writing complex manual event dispatchers, `@araminix/lib` introduces **typed, multiplexed bidirectional streams** over a single persistent WebSocket connection, backed by a robust **`Result<T, E>` monad** for compile-time error resilience.
+
+---
+
+## 🌟 Key Features
+
+- ⚡ **Multiplexed Bidirectional Streams**: Run hundreds of independent data streams over a single physical WebSocket connection with isolated lifecycles, flow control, and arguments.
+- 🛡️ **Zero-Exception Result Monad**: Functional `Result<T, E>`, `Ok`, `Err`, `deal()`, and `wrap()` abstractions prevent unhandled promise rejections and force explicit error handling.
+- 🌐 **Truly Isomorphic / Universal**: Single codebase operating identically in the browser (native `WebSocket`) and Node.js (`ws` / `websocket`).
+- 📦 **Typed Protocol Envelopes**: Built-in runtime-validated message types (`NewStream`, `AcceptStream`, `DataStream`, `CloseStream`, `PingStream`, `PongStream`) validated via `io-ts`.
+- 🔍 **Structured Logger**: Configurable, timestamped, colored logging utility supporting dynamic levels (`TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`).
+- 🚀 **Zero Overhead**: Minimal dependencies, pure ESM, fully tree-shakeable, and bundled with complete TypeScript `.d.ts` declaration maps.
+
+---
+
+## 📦 Installation
+
+```bash
+# npm
+npm install @araminix/lib
+
+# pnpm
+pnpm add @araminix/lib
+
+# yarn
+yarn add @araminix/lib
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Connecting and Opening a Multiplexed Stream
+
+```typescript
+import { Client, Socket, Stream } from '@araminix/lib';
+
+// Connect client to a WebSocket endpoint
+const client = new Client({
+    url: 'wss://api.example.com/ws/session',
+});
+
+const connectResult = await client.connect();
+
+if (connectResult.isOk()) {
+    const socket: Socket = connectResult.unwrap();
+
+    // Open an outgoing typed stream over the single WebSocket connection
+    const streamResult = await socket.outgoingStream<{ channelId: string }, string, string>('chatRoom', { channelId: 'room-42' });
+
+    if (streamResult.isOk()) {
+        const stream = streamResult.unwrap();
+
+        // Send data through the stream
+        await stream.write('Hello from client!');
+
+        // Read incoming messages
+        const incoming = await stream.read();
+        if (incoming.isOk()) {
+            console.log('Received:', incoming.unwrap());
+        }
+
+        // Gracefully close stream
+        stream.closeOk();
+    }
+}
+```
+
+---
+
+### 2. Handling Incoming Streams
+
+```typescript
+import { loop, LoopResult, Socket } from '@araminix/lib';
+
+export function handleSocket(socket: Socket) {
+    loop(async () => {
+        // Wait for an incoming stream named 'sensorData'
+        const streamResult = await socket.incomingStream('sensorData');
+        if (streamResult.isErr()) return LoopResult.Stop;
+
+        const stream = streamResult.unwrap();
+        console.log(`Stream initialized with arguments:`, stream.args);
+
+        // Process stream data
+        const readResult = await stream.read();
+        if (readResult.isOk()) {
+            console.log('Sensor payload:', readResult.unwrap());
+            await stream.write({ status: 'ACK' });
+        }
+
+        stream.closeOk();
+        return LoopResult.Cont;
+    });
+}
+```
+
+---
+
+### 3. Safe Functional Programming with `Result<T, E>`
+
+Eliminate `try/catch` boilerplate and unhandled promise crashes:
+
+```typescript
+import { deal, Err, Ok, Result, wrap } from '@araminix/lib';
+
+// 1. Creating typed Results
+function parseNumber(input: string): Result<number, string> {
+    const val = Number(input);
+    return isNaN(val) ? new Err('Invalid number') : new Ok(val);
+}
+
+// 2. Safely wrapping third-party promises
+const fetchResult = await wrap(fetch('https://api.example.com/data'));
+if (fetchResult.isOk()) {
+    console.log('HTTP Status:', fetchResult.unwrap().status);
+} else {
+    console.error('Network failure:', fetchResult.e);
+}
+
+// 3. Deferred execution with deal()
+const [promise, resolve] = deal<string>();
+setTimeout(() => resolve(new Ok('Completed!')), 100);
+const result = await promise;
+```
+
+---
+
+## 📐 Architecture Overview
+
+```
+                   Single WebSocket Connection
+Client (Browser / Node) <=====================> Server (@araminix/platform)
+                             |          |
+            +----------------+          +----------------+
+            |                                            |
+     Stream "chat"                               Stream "telemetry"
+   [DataStream -> "hello"]                    [DataStream -> { cpu: 45 }]
+```
+
+---
+
+## 🛠️ API Reference
+
+### Core Classes & Exports
+
+| Export                     | Type     | Description                                                                              |
+| -------------------------- | -------- | ---------------------------------------------------------------------------------------- |
+| `Socket`                   | Class    | High-level wrapper over a connection providing stream multiplexing and state inspection. |
+| `Connection`               | Class    | Manages low-level WebSocket frames, keepalives, and stream controllers.                  |
+| `Stream<TArgs, TIn, TOut>` | Class    | Represents an independent, bidirectional typed channel over a `Socket`.                  |
+| `Client`                   | Class    | Isomorphic WebSocket connector supporting headers, tokens, and reconnects.               |
+| `Result<T, E>`             | Class    | Monadic result container (`Ok<T>` or `Err<E>`).                                          |
+| `Logger`                   | Class    | Leveled structured logger (`TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`).                   |
+| `wrap` / `wrapSync`        | Function | Converts throwing functions/promises into `Result` instances.                            |
+| `deal`                     | Function | Creates an inverted deferred promise tuple `[promise, resolve]`.                         |
+
+---
+
+## 🧪 Testing
+
+```bash
+# Run unit tests
+npm test
+
+# Run tests with built-in code coverage report
+npm run test:coverage
+```
+
+---
+
+## 👤 Author
+
+**Amin Abbasi**
+
+- Organization: [araminix](https://github.com/araminix)
+- GitHub: [@abbasi](https://github.com)
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import * as messages from './src/messages.js';
+import { InitStreamErr, Stream, StreamCloseCodes, StreamErr } from './src/stream.js';
+export * from './src/Socket.js';
+export * from './src/connection.js';
+export * from './src/utils/index.js';
+export * from './src/client.js';
+export { Stream, StreamErr, InitStreamErr, messages as Message, StreamCloseCodes };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErF,cAAc,iBAAiB,CAAC;AAEhC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+import * as messages from './src/messages.js';
+import { InitStreamErr, Stream, StreamCloseCodes, StreamErr } from './src/stream.js';
+export * from './src/Socket.js';
+export * from './src/connection.js';
+export * from './src/utils/index.js';
+export * from './src/client.js';
+export { Stream, StreamErr, InitStreamErr, messages as Message, StreamCloseCodes };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErF,cAAc,iBAAiB,CAAC;AAEhC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/src/Socket.d.ts

@@ -0,0 +1,26 @@
+import { CloseCodes, Connection } from './connection.js';
+import { InitStreamErr, Stream } from './stream.js';
+import { Result } from './utils/result.js';
+export declare enum SocketErr {
+    Closed = 0,
+    Concurrent = 1
+}
+export declare enum ConnectionStatus {
+    Connecting = "connecting",
+    Open = "open",
+    Closing = "closing",
+    Closed = "closed",
+    Unknown = "unknown"
+}
+export declare class Socket {
+    connection: Connection;
+    constructor(connection: Connection);
+    incomingStream<TArgs = unknown, TDataIn = unknown, TDataOut = unknown>(name: string): Promise<Result<Stream<TArgs, TDataIn, TDataOut>, SocketErr>>;
+    get arg(): string;
+    waitClose(): Promise<CloseCodes>;
+    isDead(): boolean;
+    destroy(): void;
+    outgoingStream<TArgs = unknown, TDataIn = unknown, TDataOut = unknown>(name: string, args?: TArgs): Promise<Result<Stream<TArgs, TDataIn, TDataOut>, InitStreamErr>>;
+    getConnectionStatus(): ConnectionStatus;
+}
+//# sourceMappingURL=Socket.d.ts.map

package/dist/src/Socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Socket.d.ts","sourceRoot":"","sources":["../../src/Socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,oBAAY,SAAS;IACjB,MAAM,IAAI;IACV,UAAU,IAAI;CACjB;AAED,oBAAY,gBAAgB;IACxB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;CACtB;AAED,qBAAa,MAAM;IACf,UAAU,EAAE,UAAU,CAAC;IAEvB,YAAY,UAAU,EAAE,UAAU,EAEjC;IAEK,cAAc,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC,CAEvJ;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAEK,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAErC;IAED,MAAM,IAAI,OAAO,CAEhB;IAED,OAAO,IAAI,IAAI,CAEd;IAED,cAAc,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAEnK;IAED,mBAAmB,IAAI,gBAAgB,CAmBtC;CACJ"}

package/dist/src/Socket.js

@@ -0,0 +1,61 @@
+import { CloseCodes } from './connection.js';
+export var SocketErr;
+(function (SocketErr) {
+    SocketErr[SocketErr["Closed"] = 0] = "Closed";
+    SocketErr[SocketErr["Concurrent"] = 1] = "Concurrent";
+})(SocketErr || (SocketErr = {}));
+export var ConnectionStatus;
+(function (ConnectionStatus) {
+    ConnectionStatus["Connecting"] = "connecting";
+    ConnectionStatus["Open"] = "open";
+    ConnectionStatus["Closing"] = "closing";
+    ConnectionStatus["Closed"] = "closed";
+    ConnectionStatus["Unknown"] = "unknown";
+})(ConnectionStatus || (ConnectionStatus = {}));
+export class Socket {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    async incomingStream(name) {
+        return await this.connection.acquireStream(name);
+    }
+    get arg() {
+        return this.connection.arg;
+    }
+    async waitClose() {
+        return this.connection.closePromise;
+    }
+    isDead() {
+        return this.connection?.dead === true;
+    }
+    destroy() {
+        this.connection.destroy(CloseCodes.Intentional);
+    }
+    outgoingStream(name, args) {
+        return this.connection.newOutgoingStream(name, args);
+    }
+    getConnectionStatus() {
+        try {
+            const ws = this.connection?.ws;
+            if (!ws)
+                return ConnectionStatus.Unknown;
+            switch (ws.readyState) {
+                case 0:
+                    return ConnectionStatus.Connecting;
+                case 1:
+                    return ConnectionStatus.Open;
+                case 2:
+                    return ConnectionStatus.Closing;
+                case 3:
+                    return ConnectionStatus.Closed;
+                default:
+                    return ConnectionStatus.Unknown;
+            }
+        }
+        catch {
+            return ConnectionStatus.Unknown;
+        }
+    }
+}
+//# sourceMappingURL=Socket.js.map

package/dist/src/Socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Socket.js","sourceRoot":"","sources":["../../src/Socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,iBAAiB,CAAC;AAIzD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACjB,6CAAU,CAAA;IACV,qDAAc,CAAA;AAClB,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAED,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IACxB,6CAAyB,CAAA;IACzB,iCAAa,CAAA;IACb,uCAAmB,CAAA;IACnB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;AACvB,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAED,MAAM,OAAO,MAAM;IACf,UAAU,CAAa;IAEvB,YAAY,UAAsB;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,cAAc,CAAyD,IAAY;QACrF,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAA2B,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,GAAG;QACH,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;IACxC,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,UAAU,EAAE,IAAI,KAAK,IAAI,CAAC;IAC1C,CAAC;IAED,OAAO;QACH,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IAED,cAAc,CAAyD,IAAY,EAAE,IAAY;QAC7F,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAA2B,IAAI,EAAE,IAAa,CAAC,CAAC;IAC5F,CAAC;IAED,mBAAmB;QACf,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YAC/B,IAAI,CAAC,EAAE;gBAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC;YACzC,QAAQ,EAAE,CAAC,UAAU,EAAE,CAAC;gBACpB,KAAK,CAAC;oBACF,OAAO,gBAAgB,CAAC,UAAU,CAAC;gBACvC,KAAK,CAAC;oBACF,OAAO,gBAAgB,CAAC,IAAI,CAAC;gBACjC,KAAK,CAAC;oBACF,OAAO,gBAAgB,CAAC,OAAO,CAAC;gBACpC,KAAK,CAAC;oBACF,OAAO,gBAAgB,CAAC,MAAM,CAAC;gBACnC;oBACI,OAAO,gBAAgB,CAAC,OAAO,CAAC;YACxC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,gBAAgB,CAAC,OAAO,CAAC;QACpC,CAAC;IACL,CAAC;CACJ"}

package/dist/src/client.d.ts

@@ -0,0 +1,74 @@
+import { AxiosResponse } from 'axios';
+import { CloseCodes } from './connection.js';
+import { Socket, SocketErr } from './Socket.js';
+import { R } from './utils/index.js';
+import { Err, Ok, Result } from './utils/result.js';
+export declare const axiosService: import("axios").AxiosStatic;
+export interface FileInfo {
+    name: string;
+    size: number;
+    mimetype: string;
+    id?: string;
+    userId: string;
+}
+export interface ClientOptions {
+    hp?: number;
+    host: string;
+    wsHost: string;
+    mount?: string;
+    token?: string;
+}
+export declare enum ConnectFail {
+    Unexpected = "Unexpected",
+    Unauthorized = "Unauthorized",
+    NotFound = "NotFound",
+    Denied = "Denied"
+}
+export declare enum AgentClientErrorType {
+    Communication = "Communication",
+    Execution = "Execution"
+}
+export declare abstract class AgentClientError {
+    abstract type: AgentClientErrorType;
+}
+export declare class CommunicationClientAgentError<E = unknown> implements AgentClientError {
+    readonly e: E;
+    readonly type = AgentClientErrorType.Communication;
+    constructor(e: E);
+}
+export declare class ExecutionClientAgentError<E = unknown> implements AgentClientError {
+    readonly e: E;
+    readonly type = AgentClientErrorType.Execution;
+    constructor(e: E);
+}
+export declare class AgentClient {
+    private socket;
+    constructor(socket: Socket);
+    onTask<TTask = unknown, TResult = unknown, TError = unknown>(name: string): Promise<Result<[TTask, (value: Result<TResult, TError>) => R], SocketErr>>;
+    destroy(): void;
+    post<TData = unknown, TResult = unknown, E = unknown>(name: string, data: TData, hp?: number): Promise<Result<TResult, AgentClientError>>;
+    waitClose(): Promise<CloseCodes>;
+}
+export declare class Client {
+    private readonly mount;
+    private readonly token;
+    private readonly host;
+    private readonly wsHost;
+    private readonly hp?;
+    constructor({ host, wsHost, mount, token, hp }: ClientOptions);
+    auth<TAuthData = unknown, TAuthResponse = unknown, TErr = unknown>(data: TAuthData): Promise<Result<AxiosResponse<TAuthResponse>, TErr>>;
+    gauth<TResponse = unknown, TErr = unknown>(access_token: string): Promise<Result<AxiosResponse<TResponse>, TErr | void>>;
+    deauth(): Promise<Ok<void> | Err<void, void>>;
+    request2FA<T = unknown, E = unknown>(): Promise<Result<AxiosResponse<T>, E>>;
+    enable2FA<T = unknown, E = unknown>(secret: string, code: string): Promise<Result<AxiosResponse<T>, E>>;
+    verify2FA<T = unknown, E = unknown>(accountName: string, code: string, uuid: string): Promise<Result<AxiosResponse<T>, E>>;
+    disable2FA<T = unknown, E = unknown>(): Promise<Result<AxiosResponse<T>, E>>;
+    upload(file: string | Blob): Promise<Result<FileInfo, void>>;
+    getFileLink(file: string | FileInfo): string;
+    getPresignedUploadUrl<T = unknown, E = unknown>(): Promise<Result<AxiosResponse<T>, E>>;
+    getPresignedDownloadUrl<T = unknown, E = unknown>(fileId: string): Promise<Result<AxiosResponse<T>, E>>;
+    private reconnect;
+    connectAgent(): Promise<Result<AgentClient, ConnectFail>>;
+    connect(name: string, arg?: string): Promise<Result<Socket, ConnectFail>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

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

package/dist/src/client.js

@@ -0,0 +1,226 @@
+import axios from 'axios';
+import WS from 'websocket';
+import { CloseCodes, Connection, WsCloseCodes } from './connection.js';
+import { Socket } from './Socket.js';
+import { err, ok, once, trimSlash, wrap } from './utils/index.js';
+import { deal, Err, Ok } from './utils/result.js';
+export const axiosService = axios;
+export var ConnectFail;
+(function (ConnectFail) {
+    ConnectFail["Unexpected"] = "Unexpected";
+    ConnectFail["Unauthorized"] = "Unauthorized";
+    ConnectFail["NotFound"] = "NotFound";
+    ConnectFail["Denied"] = "Denied";
+})(ConnectFail || (ConnectFail = {}));
+export var AgentClientErrorType;
+(function (AgentClientErrorType) {
+    AgentClientErrorType["Communication"] = "Communication";
+    AgentClientErrorType["Execution"] = "Execution";
+})(AgentClientErrorType || (AgentClientErrorType = {}));
+export class AgentClientError {
+}
+export class CommunicationClientAgentError {
+    e;
+    type = AgentClientErrorType.Communication;
+    constructor(e) {
+        this.e = e;
+    }
+}
+export class ExecutionClientAgentError {
+    e;
+    type = AgentClientErrorType.Execution;
+    constructor(e) {
+        this.e = e;
+    }
+}
+export class AgentClient {
+    socket;
+    constructor(socket) {
+        this.socket = socket;
+    }
+    async onTask(name) {
+        const streamResult = await this.socket.incomingStream(name);
+        if (streamResult.isErr()) {
+            return new Err(streamResult.e);
+        }
+        const stream = streamResult.unwrap();
+        const [promise, resolve] = deal();
+        once(async () => {
+            const result = await promise;
+            await stream.write(result.serialize());
+        });
+        return new Ok([stream.args, resolve]);
+    }
+    destroy() {
+        this.socket.destroy();
+    }
+    async post(name, data, hp = 10) {
+        const stream = await this.socket.outgoingStream('post', { name, data });
+        if (stream.isErr()) {
+            return new Err(new CommunicationClientAgentError(stream.e));
+        }
+        const readResult = await stream.unwrap().read(hp);
+        if (readResult.isErr()) {
+            return new Err(new CommunicationClientAgentError(readResult.e));
+        }
+        const read = readResult.unwrap();
+        if (typeof read !== 'object' || read === null || !('ok' in read)) {
+            return new Err(new CommunicationClientAgentError('Format'));
+        }
+        if (read.ok === true) {
+            return new Ok(read.v);
+        }
+        return new Err(new ExecutionClientAgentError(read.e));
+    }
+    async waitClose() {
+        return await this.socket.waitClose();
+    }
+}
+export class Client {
+    mount;
+    token;
+    host;
+    wsHost;
+    hp;
+    constructor({ host, wsHost, mount, token, hp }) {
+        this.mount = mount ? `/${trimSlash(mount)}` : '';
+        this.token = token ? `ws-token/${token}` : 'ws';
+        this.host = host;
+        this.wsHost = wsHost;
+        this.hp = hp;
+    }
+    async auth(data) {
+        const res = await wrap(axios.post(`${this.host}${this.mount}/auth`, data));
+        if (res.isOk())
+            return new Ok(res.v);
+        return new Err(res.e);
+    }
+    async gauth(access_token) {
+        if (!this.token)
+            return new Err(undefined);
+        const res = await wrap(axios.post(`${this.host}${this.mount}/gauth`, { access_token }));
+        if (res.isOk())
+            return new Ok(res.v);
+        return new Err(res.e);
+    }
+    async deauth() {
+        const res = await wrap(axios.delete(`${this.host}${this.mount}/auth`));
+        if (res.isOk())
+            return ok();
+        return err();
+    }
+    async request2FA() {
+        const res = await wrap(axios.post(`${this.host}${this.mount}/2fa/request`));
+        if (res.isOk())
+            return new Ok(res.v);
+        return new Err(res.e);
+    }
+    async enable2FA(secret, code) {
+        const res = await wrap(axios.post(`${this.host}${this.mount}/2fa/enable`, { secret, code }));
+        if (res.isOk())
+            return new Ok(res.v);
+        return new Err(res.e);
+    }
+    async verify2FA(accountName, code, uuid) {
+        const res = await wrap(axios.post(`${this.host}${this.mount}/2fa/verify`, { accountName, code, uuid }));
+        if (res.isOk())
+            return new Ok(res.v);
+        return new Err(res.e);
+    }
+    async disable2FA() {
+        const res = await wrap(axios.delete(`${this.host}${this.mount}/2fa/disable`));
+        if (res.isOk())
+            return new Ok(res.v);
+        return new Err(res.e);
+    }
+    async upload(file) {
+        const form = new FormData();
+        form.append('file', file);
+        const options = this.token ? { headers: { 'x-token': this.token } } : undefined;
+        const res = await wrap(axios.post(`${this.host}${this.mount}/file`, form, options));
+        if (res.isOk())
+            return new Ok(res.v.data);
+        return new Err(undefined);
+    }
+    getFileLink(file) {
+        if (typeof file === 'string') {
+            return `${this.host}${this.mount}/file/${file}`;
+        }
+        return `${this.host}${this.mount}/file/${file.id}/${file.name}`;
+    }
+    async getPresignedUploadUrl() {
+        const res = await wrap(axios.post(`${this.host}${this.mount}/storage/upload`));
+        if (res.isOk())
+            return new Ok(res.v);
+        return new Err(res.e);
+    }
+    async getPresignedDownloadUrl(fileId) {
+        const res = await wrap(axios.get(`${this.host}${this.mount}/storage/${fileId}`));
+        if (res.isOk())
+            return new Ok(res.v);
+        return new Err(res.e);
+    }
+    reconnect(url, connection) {
+        const ws = new WS.w3cwebsocket(url);
+        connection.connect(ws, false);
+    }
+    async connectAgent() {
+        const socket = await this.connect('agent');
+        if (socket.isErr()) {
+            return new Err(socket.e);
+        }
+        return new Ok(new AgentClient(socket.unwrap()));
+    }
+    connect(name, arg) {
+        const pathArg = arg ? `/${arg}` : '';
+        const url = `${this.wsHost}${this.mount}/${this.token}/${name}${pathArg}`;
+        let connection;
+        const [promise, resolve] = deal();
+        const inter = {
+            hp: this.hp,
+            onDestroy: function () { },
+            onDisconnect: (code) => {
+                switch (code) {
+                    case WsCloseCodes.ConcurrentConnection: {
+                        resolve(new Err(ConnectFail.Unexpected));
+                        connection.destroy(CloseCodes.Concurrent);
+                        break;
+                    }
+                    case WsCloseCodes.Denied: {
+                        resolve(new Err(ConnectFail.Denied));
+                        connection.destroy(CloseCodes.Unauthorized);
+                        break;
+                    }
+                    case WsCloseCodes.Normal: {
+                        resolve(new Err(ConnectFail.Unexpected));
+                        connection.destroy(CloseCodes.Intentional);
+                        break;
+                    }
+                    case WsCloseCodes.Unauthorized: {
+                        resolve(new Err(ConnectFail.Unauthorized));
+                        connection.destroy(CloseCodes.Unauthorized);
+                        break;
+                    }
+                    case WsCloseCodes.NotFound: {
+                        resolve(new Err(ConnectFail.NotFound));
+                        connection.destroy(CloseCodes.Unexpected);
+                        break;
+                    }
+                    default: {
+                        setTimeout(() => {
+                            this.reconnect(url, connection);
+                        }, 500);
+                        break;
+                    }
+                }
+            },
+            onAccept: () => {
+                resolve(new Ok(new Socket(connection)));
+            },
+        };
+        connection = new Connection(inter, arg ?? '');
+        this.reconnect(url, connection);
+        return promise;
+    }
+}
+//# sourceMappingURL=client.js.map