@znt/sdk-nodejs 1.0.0

package/dist/connection.d.ts

@@ -0,0 +1,32 @@
+import type { JsonObject, RequestOptions } from "./types.js";
+export interface ZntConnectionOptions {
+    endpoint?: string;
+    connectTimeoutMs?: number;
+    requestTimeoutMs?: number;
+    maxRequestBytes?: number;
+}
+export declare function resolveDefaultEndpoint(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, home?: string): string;
+export declare class ZntConnection {
+    readonly endpoint: string;
+    readonly connectTimeoutMs: number;
+    readonly requestTimeoutMs: number;
+    readonly maxRequestBytes: number;
+    private socket;
+    private connectingSocket;
+    private connecting;
+    private buffer;
+    private nextRequestId;
+    private readonly pending;
+    constructor(options?: ZntConnectionOptions);
+    get connected(): boolean;
+    connect(): Promise<void>;
+    call<TResult>(method: string, params?: JsonObject, options?: RequestOptions): Promise<TResult>;
+    disconnect(): void;
+    private allocateRequestId;
+    private handleData;
+    private handleResponse;
+    private failProtocol;
+    private rejectAll;
+    private cleanupPending;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EAIf,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,IAAI,GAAE,MAAkB,GACvB,MAAM,CAQR;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;gBAEhD,OAAO,GAAE,oBAAyB;IAO9C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8ExB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAsE5G,UAAU,IAAI,IAAI;IAWlB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,cAAc;IA8BtB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/connection.js

@@ -0,0 +1,275 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createConnection } from "node:net";
+import { ZntAbortError, ZntProtocolError, ZntRpcError, ZntTimeoutError, ZntTransportError, } from "./errors.js";
+const DEFAULT_CONNECT_TIMEOUT_MS = 5_000;
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_REQUEST_BYTES = 10 * 1024 * 1024;
+export function resolveDefaultEndpoint(env = process.env, platform = process.platform, home = homedir()) {
+    if (env.ZNT_ENDPOINT) {
+        return env.ZNT_ENDPOINT;
+    }
+    if (platform === "win32") {
+        return String.raw `\\.\pipe\znt-core`;
+    }
+    return join(home, ".znt", "znt.sock");
+}
+export class ZntConnection {
+    endpoint;
+    connectTimeoutMs;
+    requestTimeoutMs;
+    maxRequestBytes;
+    socket;
+    connectingSocket;
+    connecting;
+    buffer = "";
+    nextRequestId = 1;
+    pending = new Map();
+    constructor(options = {}) {
+        this.endpoint = options.endpoint ?? resolveDefaultEndpoint();
+        this.connectTimeoutMs = options.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.maxRequestBytes = options.maxRequestBytes ?? DEFAULT_MAX_REQUEST_BYTES;
+    }
+    get connected() {
+        return Boolean(this.socket && !this.socket.destroyed);
+    }
+    async connect() {
+        if (this.connected) {
+            return;
+        }
+        if (this.connecting) {
+            return this.connecting;
+        }
+        const attempt = new Promise((resolve, reject) => {
+            const socket = createConnection(this.endpoint);
+            this.connectingSocket = socket;
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    if (this.connectingSocket === socket) {
+                        this.connectingSocket = undefined;
+                    }
+                    socket.destroy();
+                    reject(new ZntTransportError(`Timed out connecting to znt-core after ${this.connectTimeoutMs} ms`, this.endpoint));
+                }
+            }, this.connectTimeoutMs);
+            socket.setEncoding("utf8");
+            socket.on("data", (chunk) => {
+                if (this.socket === socket) {
+                    this.handleData(chunk);
+                }
+            });
+            socket.on("error", (error) => {
+                if (!settled) {
+                    settled = true;
+                    if (this.connectingSocket === socket) {
+                        this.connectingSocket = undefined;
+                    }
+                    clearTimeout(timer);
+                    reject(new ZntTransportError(`Could not connect to znt-core at ${this.endpoint}`, this.endpoint, { cause: error }));
+                }
+            });
+            socket.on("close", () => {
+                if (!settled) {
+                    settled = true;
+                    if (this.connectingSocket === socket) {
+                        this.connectingSocket = undefined;
+                    }
+                    clearTimeout(timer);
+                    reject(new ZntTransportError(`Connection to znt-core at ${this.endpoint} closed before it was ready`, this.endpoint));
+                }
+                if (this.socket === socket) {
+                    this.socket = undefined;
+                    this.buffer = "";
+                    this.rejectAll(new ZntTransportError(`Connection to znt-core at ${this.endpoint} closed`, this.endpoint));
+                }
+            });
+            socket.once("connect", () => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                if (this.connectingSocket === socket) {
+                    this.connectingSocket = undefined;
+                }
+                clearTimeout(timer);
+                this.socket = socket;
+                resolve();
+            });
+        });
+        this.connecting = attempt;
+        try {
+            await attempt;
+        }
+        finally {
+            if (this.connecting === attempt) {
+                this.connecting = undefined;
+            }
+        }
+    }
+    async call(method, params = {}, options = {}) {
+        if (!method) {
+            throw new TypeError("method must be a non-empty string");
+        }
+        if (!isPlainObject(params)) {
+            throw new TypeError("params must be a JSON object");
+        }
+        if (options.signal?.aborted) {
+            throw new ZntAbortError();
+        }
+        const id = this.allocateRequestId();
+        const frame = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+        if (Buffer.byteLength(frame, "utf8") > this.maxRequestBytes) {
+            throw new ZntProtocolError(`JSON-RPC request exceeds the ${this.maxRequestBytes}-byte znt-core limit`);
+        }
+        await this.connect();
+        if (options.signal?.aborted) {
+            throw new ZntAbortError();
+        }
+        const socket = this.socket;
+        if (!socket || socket.destroyed) {
+            throw new ZntTransportError(`Connection to znt-core at ${this.endpoint} is not available`, this.endpoint);
+        }
+        const timeoutMs = options.timeoutMs ?? this.requestTimeoutMs;
+        return new Promise((resolve, reject) => {
+            const pending = {
+                method,
+                resolve,
+                reject,
+                timer: undefined,
+                signal: options.signal,
+                abortListener: undefined,
+            };
+            if (timeoutMs > 0) {
+                pending.timer = setTimeout(() => {
+                    this.pending.delete(id);
+                    this.cleanupPending(pending);
+                    reject(new ZntTimeoutError(method, timeoutMs));
+                }, timeoutMs);
+            }
+            if (options.signal) {
+                pending.abortListener = () => {
+                    this.pending.delete(id);
+                    this.cleanupPending(pending);
+                    reject(new ZntAbortError());
+                };
+                options.signal.addEventListener("abort", pending.abortListener, { once: true });
+                if (options.signal.aborted) {
+                    pending.abortListener();
+                    return;
+                }
+            }
+            this.pending.set(id, pending);
+            socket.write(`${frame}\n`, "utf8", (error) => {
+                if (!error) {
+                    return;
+                }
+                if (this.pending.delete(id)) {
+                    this.cleanupPending(pending);
+                    reject(new ZntTransportError(`Failed to send ${method} to znt-core`, this.endpoint, { cause: error }));
+                }
+            });
+        });
+    }
+    disconnect() {
+        const socket = this.socket;
+        const connectingSocket = this.connectingSocket;
+        this.socket = undefined;
+        this.connectingSocket = undefined;
+        this.buffer = "";
+        this.rejectAll(new ZntTransportError(`Connection to znt-core at ${this.endpoint} was closed by the client`, this.endpoint));
+        socket?.destroy();
+        connectingSocket?.destroy();
+    }
+    allocateRequestId() {
+        for (;;) {
+            const id = this.nextRequestId;
+            this.nextRequestId = id >= Number.MAX_SAFE_INTEGER ? 1 : id + 1;
+            if (!this.pending.has(id)) {
+                return id;
+            }
+        }
+    }
+    handleData(chunk) {
+        this.buffer += chunk;
+        for (;;) {
+            const newline = this.buffer.indexOf("\n");
+            if (newline < 0) {
+                return;
+            }
+            const line = this.buffer.slice(0, newline).trim();
+            this.buffer = this.buffer.slice(newline + 1);
+            if (!line) {
+                continue;
+            }
+            let response;
+            try {
+                response = JSON.parse(line);
+            }
+            catch (error) {
+                this.failProtocol(new ZntProtocolError("znt-core returned malformed JSON", { cause: error }));
+                return;
+            }
+            this.handleResponse(response);
+        }
+    }
+    handleResponse(response) {
+        if (!response || response.jsonrpc !== "2.0" || !("id" in response)) {
+            this.failProtocol(new ZntProtocolError("znt-core returned an invalid JSON-RPC response"));
+            return;
+        }
+        const pending = this.pending.get(response.id);
+        if (!pending) {
+            return;
+        }
+        this.pending.delete(response.id);
+        this.cleanupPending(pending);
+        if ("error" in response) {
+            const failure = response;
+            const rpcErrorOptions = {
+                code: failure.error.code,
+                message: failure.error.message,
+                method: pending.method,
+                requestId: response.id,
+            };
+            if (failure.error.data !== undefined) {
+                rpcErrorOptions.data = failure.error.data;
+            }
+            pending.reject(new ZntRpcError(rpcErrorOptions));
+            return;
+        }
+        pending.resolve(response.result);
+    }
+    failProtocol(error) {
+        const socket = this.socket;
+        this.socket = undefined;
+        this.buffer = "";
+        this.rejectAll(error);
+        socket?.destroy();
+    }
+    rejectAll(error) {
+        for (const pending of this.pending.values()) {
+            this.cleanupPending(pending);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+    cleanupPending(pending) {
+        if (pending.timer) {
+            clearTimeout(pending.timer);
+        }
+        if (pending.signal && pending.abortListener) {
+            pending.signal.removeEventListener("abort", pending.abortListener);
+        }
+    }
+}
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/daemon.d.ts

@@ -0,0 +1,48 @@
+export interface ZntDaemonOptions {
+    coreBinaryPath?: string;
+    configPath?: string;
+    daemonCwd?: string;
+    daemonStartTimeoutMs?: number;
+}
+export interface StartDaemonOptions extends ZntDaemonOptions {
+    endpoint: string;
+    probe(): Promise<void>;
+}
+export interface DownloadCoreOptions {
+    version?: string;
+    signal?: AbortSignal;
+}
+export interface CoreDownloadResult {
+    binaryPath: string;
+    bytesDownloaded: number;
+    configPath: string;
+    sha256: string;
+    version: string | null;
+}
+export interface ConfigValidationResult {
+    valid: true;
+    providerChecked: boolean;
+    message: string;
+}
+export declare function resolveCoreInstallDirectory(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, home?: string): string;
+export declare function resolveCoreBinaryPath(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, home?: string): string;
+export declare function resolveManagedConfigPath(coreBinaryPath?: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, home?: string): string;
+export declare function resolveCoreReleaseAssetKey(platform?: NodeJS.Platform, arch?: string): string;
+export declare function getInstalledCorePath(options?: ZntDaemonOptions): Promise<string>;
+export declare function isManagedCoreConfigured(options?: ZntDaemonOptions): Promise<boolean>;
+export declare function isManagedCoreInstalled(options?: ZntDaemonOptions, expectedVersion?: string): Promise<boolean>;
+export declare function removeManagedCore(options?: ZntDaemonOptions): Promise<boolean>;
+export declare function startManagedDaemon(options: StartDaemonOptions): Promise<void>;
+export declare function downloadManagedCore(options?: DownloadCoreOptions, coreBinaryPath?: string, configuredConfigPath?: string): Promise<CoreDownloadResult>;
+export declare function getDefaultConfig(options?: ZntDaemonOptions): Promise<string>;
+export declare function validateManagedConfig(configPath: string, options?: ZntDaemonOptions & {
+    checkProvider?: boolean;
+    signal?: AbortSignal;
+}): Promise<ConfigValidationResult>;
+export declare function storeManagedSecret(reference: string, secret: string, options?: ZntDaemonOptions & {
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function deleteManagedSecret(reference: string, options?: ZntDaemonOptions & {
+    signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

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