@ac-kit/node 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @ac-kit/node
 
+## 0.3.0
+
+### Minor Changes
+
+- a5c4d66: - New `InetAddress`, `InetEndpoint` and `toInetAddress`, moved here from
+    `@ac-kit/core` — an `InetAddress` answers what the OS told us, a family and an
+    opaque address string, rather than being an address you can compute with, so
+    it belongs beside the Node APIs that report it rather than in
+    `@ac-kit/net-address`. `composeInetAddress` is renamed `toInetAddress`: it
+    exists solely to normalise the inconsistent `family` field Node reports, which
+    arrives as `"IPv4"`, as `4` or as `null` depending on which API answered, and
+    "compose" named none of that. Its behaviour, including the `UnsupportedError`
+    it throws on any other family, is unchanged.
+  - New `isPathWithin` / `assertPathWithin` and their symlink-resolving `…Async`
+    counterparts, plus the `PathEscapeError` they throw. Proving that a resolved
+    path stayed inside a root directory is the check that stands between a
+    user-supplied name and `../../../etc/passwd`, and it is routinely written as
+    `resolved.startsWith(root)` — which accepts `/var/data-evil` for a root of
+    `/var/data`. Comparing resolved path segments makes the separator implicit
+    instead of something the caller has to remember to append, and settles the
+    trailing-separator, `.`/`..` and relative-input cases on the way. The
+    asynchronous variants resolve both sides through `realpath`, falling back to
+    the longest existing prefix so a path can be checked before it is created, and
+    rethrow any error other than a missing path — a check that could not look must
+    not answer "within". They narrow the check-to-use window rather than closing
+    it, which the documentation says plainly; the asserting forms return the
+    resolved path so a caller uses the value that was checked instead of resolving
+    a second time. Case folding defaults to the platform's convention —
+    insensitive on Windows, sensitive elsewhere — and is an option, because Node
+    cannot report what the volume actually does and a case-insensitive mount under
+    a case-sensitive platform would otherwise read as a different root.
+
+### Patch Changes
+
+- Updated dependencies [a5c4d66]
+- Updated dependencies [a5c4d66]
+  - @ac-kit/core@0.3.0
+  - @ac-kit/async@0.1.2
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -22,12 +22,15 @@ await writeFileAtomic("config.json", JSON.stringify(config));
 
 ## What it covers
 
-- **Sockets** — promise-based TCP, TLS, IPC and UDP classes.
+- **Sockets** — promise-based TCP, TLS, IPC and UDP classes, addressed with
+  `InetAddress` / `InetEndpoint` and `toInetAddress`, which normalizes the
+  inconsistent `family` field Node reports.
 - **Servers** — promise-based TCP, TLS and IPC listeners, dispatching typed
   connection events.
 - **Filesystem** — `walkPaths`, `writeFileAtomic`, `existsAsync`,
   `isDirectoryAsync`, `fileContentEqual`, `compressFile`, `createTempDir`,
-  `escapePath`.
+  `escapePath`, and `isPathWithin` / `assertPathWithinAsync` for proving a path
+  stays inside a root directory, symbolic links included.
 - **Processes** — `execAsync`, forking, and typed `NodeError` /
   `NodeSystemError` / `NodeExecError` / `ProcessExitError`.
 - **Modules** — `importModule`, `optionalImport`, `resolveModule`.

package/dist/error/process-exit-error.d.ts

@@ -1,4 +1,4 @@
-import { INodeExecError } from "./node-exec-error.js";
+import type { INodeExecError } from "./node-exec-error.js";
 /**
  * Error thrown when a shell command exits with a non-zero code or is terminated
  * by a signal.
@@ -9,14 +9,27 @@ export declare class ProcessExitError extends Error {
     readonly killed: boolean;
     constructor(code: string | number | null, signal: NodeJS.Signals | null, killed: boolean, options?: ErrorOptions);
 }
+export type ProcessExitWithOutputErrorOptions = ErrorOptions & {
+    /**
+     * How much of the failing stream the message keeps, counted in characters for
+     * string output and in bytes for `Buffer` output. Default `32768`.
+     */
+    readonly maxOutputLength?: number | null;
+};
 /**
  * Error thrown when a shell command exits with a non-zero code or is terminated
  * by a signal, including its stdout and stderr output.
+ *
+ * The message appends the failing stream — `stderr` when it holds anything but
+ * whitespace, `stdout` otherwise — keeping its tail up to
+ * {@link ProcessExitWithOutputErrorOptions.maxOutputLength} and stating how much
+ * it dropped. {@link stdout} and {@link stderr} always carry the untruncated
+ * output.
  */
 export declare class ProcessExitWithOutputError extends ProcessExitError {
     readonly stdout: string | Buffer;
     readonly stderr: string | Buffer;
-    static fromNodeExecError(error: INodeExecError): ProcessExitWithOutputError;
-    constructor(code: string | number | null, signal: NodeJS.Signals | null, killed: boolean, stdout: string | Buffer, stderr: string | Buffer, options?: ErrorOptions);
+    static fromNodeExecError(error: INodeExecError, options?: Exclude<ProcessExitWithOutputErrorOptions, "cause">): ProcessExitWithOutputError;
+    constructor(code: string | number | null, signal: NodeJS.Signals | null, killed: boolean, stdout: string | Buffer, stderr: string | Buffer, options?: ProcessExitWithOutputErrorOptions);
 }
 //# sourceMappingURL=process-exit-error.d.ts.map

package/dist/error/process-exit-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-exit-error.d.ts","sourceRoot":"","sources":["../../src/error/process-exit-error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAEzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO;IAHzB,YACU,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC5B,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,MAAM,EAAE,OAAO,EACxB,OAAO,CAAC,EAAE,YAAY,EAgBtB;CACD;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IA0B9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IA1BjC,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,0BAA0B,CAmB1E;IAED,YACC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC5B,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,MAAM,EAAE,OAAO,EACN,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EAChC,OAAO,CAAC,EAAE,YAAY,EAKtB;CACD"}
+{"version":3,"file":"process-exit-error.d.ts","sourceRoot":"","sources":["../../src/error/process-exit-error.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAuD3D;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAEzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO;IAHzB,YACU,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC5B,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,MAAM,EAAE,OAAO,EACxB,OAAO,CAAC,EAAE,YAAY,EAgBtB;CACD;AAED,MAAM,MAAM,iCAAiC,GAAG,YAAY,GAAG;IAC9D;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IA4B9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IA5BjC,MAAM,CAAC,iBAAiB,CACvB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,OAAO,CAAC,iCAAiC,EAAE,OAAO,CAAC,GAC3D,0BAA0B,CAkB5B;IAED,YACC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC5B,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,MAAM,EAAE,OAAO,EACN,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EAChC,OAAO,CAAC,EAAE,iCAAiC,EAgB3C;CACD"}

package/dist/error/process-exit-error.js

@@ -1,4 +1,39 @@
-import { joinNonEmpty } from "@ac-kit/core";
+import { isAsciiWhitespace, joinNonEmpty, nextUtf8Boundary, } from "@ac-kit/core";
+const DEFAULT_MAX_OUTPUT_LENGTH_ = 32 * 1024;
+function hasContent_(output) {
+    return typeof output === "string"
+        ? /\S/.test(output)
+        : output.some((byte) => !isAsciiWhitespace(byte));
+}
+function getOutputTail_(output, maxLength) {
+    const start = Math.max(0, output.length - maxLength);
+    if (typeof output === "string") {
+        return {
+            text: output.slice(start),
+            omittedLength: start,
+            unit: "characters",
+        };
+    }
+    const byteStart = nextUtf8Boundary(output, start);
+    return {
+        text: output.toString("utf8", byteStart),
+        omittedLength: byteStart,
+        unit: "bytes",
+    };
+}
+function getOutputMessage_(stdout, stderr, maxOutputLength) {
+    const [name, output] = hasContent_(stderr)
+        ? ["stderr", stderr]
+        : ["stdout", stdout];
+    if (!hasContent_(output)) {
+        return "";
+    }
+    const { text, omittedLength, unit } = getOutputTail_(output, maxOutputLength);
+    const truncation = omittedLength > 0
+        ? ` (last ${output.length - omittedLength} of ${output.length} ${unit})`
+        : "";
+    return `${name}${truncation}:\n${text}`;
+}
 /**
  * Error thrown when a shell command exits with a non-zero code or is terminated
  * by a signal.
@@ -23,16 +58,21 @@ export class ProcessExitError extends Error {
 /**
  * Error thrown when a shell command exits with a non-zero code or is terminated
  * by a signal, including its stdout and stderr output.
+ *
+ * The message appends the failing stream — `stderr` when it holds anything but
+ * whitespace, `stdout` otherwise — keeping its tail up to
+ * {@link ProcessExitWithOutputErrorOptions.maxOutputLength} and stating how much
+ * it dropped. {@link stdout} and {@link stderr} always carry the untruncated
+ * output.
  */
 export class ProcessExitWithOutputError extends ProcessExitError {
     stdout;
     stderr;
-    static fromNodeExecError(error) {
-        const result = new ProcessExitWithOutputError(error.code, error.signal, error.killed, error.stdout, error.stderr, error.cause
-            ? {
-                cause: error.cause,
-            }
-            : undefined);
+    static fromNodeExecError(error, options) {
+        const result = new ProcessExitWithOutputError(error.code, error.signal, error.killed, error.stdout, error.stderr, {
+            ...options,
+            cause: error.cause,
+        });
         Error.captureStackTrace(result, ProcessExitWithOutputError.fromNodeExecError);
         return result;
     }
@@ -41,6 +81,10 @@ export class ProcessExitWithOutputError extends ProcessExitError {
         this.stdout = stdout;
         this.stderr = stderr;
         this.name = "ProcessExitWithOutputError";
+        this.message = joinNonEmpty([
+            this.message,
+            getOutputMessage_(stdout, stderr, options?.maxOutputLength ?? DEFAULT_MAX_OUTPUT_LENGTH_),
+        ], "\n\n");
     }
 }
 //# sourceMappingURL=process-exit-error.js.map

package/dist/error/process-exit-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-exit-error.js","sourceRoot":"","sources":["../../src/error/process-exit-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEhC,IAAI;IACJ,MAAM;IACN,MAAM;IAHhB,YACU,IAA4B,EAC5B,MAA6B,EAC7B,MAAe,EACxB,OAAsB;QAEtB,KAAK,CACJ,YAAY,CACX;YACC,IAAI,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI;YACpE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;YAC1C,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;YAChD,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;SAC1B,EACD,GAAG,CACH,EACD,OAAO,CACP,CAAC;oBAhBO,IAAI;sBACJ,MAAM;sBACN,MAAM;QAgBf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAChC,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IA0BrD,MAAM;IACN,MAAM;IA1BhB,MAAM,CAAC,iBAAiB,CAAC,KAAqB;QAC7C,MAAM,MAAM,GAAG,IAAI,0BAA0B,CAC5C,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,KAAK;YACV,CAAC,CAAC;gBACA,KAAK,EAAE,KAAK,CAAC,KAAK;aAClB;YACF,CAAC,CAAC,SAAS,CACZ,CAAC;QAEF,KAAK,CAAC,iBAAiB,CACtB,MAAM,EACN,0BAA0B,CAAC,iBAAiB,CAC5C,CAAC;QACF,OAAO,MAAM,CAAC;IACf,CAAC;IAED,YACC,IAA4B,EAC5B,MAA6B,EAC7B,MAAe,EACN,MAAuB,EACvB,MAAuB,EAChC,OAAsB;QAEtB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;sBAJ5B,MAAM;sBACN,MAAM;QAKf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC1C,CAAC;CACD"}
+{"version":3,"file":"process-exit-error.js","sourceRoot":"","sources":["../../src/error/process-exit-error.ts"],"names":[],"mappings":"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"}

package/dist/fs/path-escape-error.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Error thrown when a path resolves outside the root directory it was required
+ * to stay inside.
+ *
+ * Carries the two resolved absolute paths rather than the caller's originals,
+ * because the originals are what looked innocent — `../../../etc/passwd` says
+ * nothing about where it landed.
+ */
+export declare class PathEscapeError extends Error {
+    /** The resolved root the path was required to stay inside. */
+    readonly root: string;
+    /** The resolved path that fell outside it. */
+    readonly path: string;
+    constructor(
+    /** The resolved root the path was required to stay inside. */
+    root: string, 
+    /** The resolved path that fell outside it. */
+    path: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=path-escape-error.d.ts.map

package/dist/fs/path-escape-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-escape-error.d.ts","sourceRoot":"","sources":["../../src/fs/path-escape-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAExC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM;IAJtB;IACC,8DAA8D;IACrD,IAAI,EAAE,MAAM;IACrB,8CAA8C;IACrC,IAAI,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,YAAY,EAKtB;CACD"}

package/dist/fs/path-escape-error.js

@@ -0,0 +1,23 @@
+/**
+ * Error thrown when a path resolves outside the root directory it was required
+ * to stay inside.
+ *
+ * Carries the two resolved absolute paths rather than the caller's originals,
+ * because the originals are what looked innocent — `../../../etc/passwd` says
+ * nothing about where it landed.
+ */
+export class PathEscapeError extends Error {
+    root;
+    path;
+    constructor(
+    /** The resolved root the path was required to stay inside. */
+    root, 
+    /** The resolved path that fell outside it. */
+    path, options) {
+        super(`Path "${path}" is outside "${root}"`, options);
+        this.root = root;
+        this.path = path;
+        this.name = "PathEscapeError";
+    }
+}
+//# sourceMappingURL=path-escape-error.js.map

package/dist/fs/path-escape-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-escape-error.js","sourceRoot":"","sources":["../../src/fs/path-escape-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAG/B,IAAI;IAEJ,IAAI;IAJd;IACC,8DAA8D;IACrD,IAAY;IACrB,8CAA8C;IACrC,IAAY,EACrB,OAAsB;QAEtB,KAAK,CAAC,SAAS,IAAI,iBAAiB,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC;oBAL7C,IAAI;oBAEJ,IAAI;QAKb,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD"}

package/dist/fs/path-within.d.ts

@@ -0,0 +1,121 @@
+export type PathWithinOptions = {
+    /**
+     * Directory a relative `root` or `path` resolves against. Default
+     * `process.cwd()`.
+     */
+    readonly from?: string | null;
+    /**
+     * Whether the path resolving to the root itself counts as within. Default
+     * `true`.
+     *
+     * Set it to `false` where the root is a container the path must be an entry
+     * of — a destination directory that must not be overwritten by the write it
+     * is receiving.
+     */
+    readonly allowRoot?: boolean | null;
+    /**
+     * Compares segments case-insensitively. Defaults to `true` on Windows and
+     * `false` everywhere else.
+     *
+     * That default follows the platform's _convention_, not the filesystem's
+     * actual behaviour, which Node cannot report: a macOS volume is usually
+     * case-insensitive, a case-sensitive one can be mounted anywhere, and NTFS
+     * can be made case-sensitive per directory. Where the answer is a security
+     * decision and the volume may be case-insensitive, pass `true` explicitly —
+     * comparing case-sensitively there lets `/Root/../etc` reached as
+     * `/ROOT/../etc` read as a different root.
+     */
+    readonly caseInsensitive?: boolean | null;
+};
+/**
+ * Whether `path` stays inside `root`, comparing the two as resolved sequences
+ * of path segments.
+ *
+ * Both are resolved first, so `..`, `.`, a trailing separator and a relative
+ * input all behave as the filesystem would read them. Containment is then
+ * decided segment by segment, which is why `/var/data-evil` is not inside
+ * `/var/data` — a `startsWith` test on the joined strings says it is. The path
+ * being the root itself counts as within unless
+ * {@link PathWithinOptions.allowRoot} says otherwise.
+ *
+ * **This answers a question about strings, not about the filesystem.** A
+ * symbolic link inside the root pointing out of it resolves within textually
+ * and reads outside it in practice; {@link isPathWithinAsync} is the variant
+ * that follows links.
+ *
+ * Time and memory are linear in the length of the two paths.
+ *
+ * @example
+ * 	```ts
+ * 	isPathWithin("/var/data", "/var/data/a/b"); // true
+ * 	isPathWithin("/var/data", "/var/data-evil/x"); // false
+ * 	isPathWithin("/var/data", "/var/data/a/../../etc/passwd"); // false
+ * 	isPathWithin("/var/data", "/var/data", { allowRoot: false }); // false
+ * 	```;
+ *
+ * @param root The directory the path must stay inside.
+ * @param path The path to check.
+ * @param options Resolution base, root-equality and case-folding policy.
+ * @returns True if the resolved path is inside the resolved root.
+ */
+export declare function isPathWithin(root: string, path: string, options?: PathWithinOptions): boolean;
+/**
+ * Whether `path` stays inside `root` once both are resolved through symbolic
+ * links.
+ *
+ * Resolves each with `realpath`, falling back to the longest existing prefix
+ * when the path does not exist yet, then applies the segment comparison
+ * {@link isPathWithin} describes. A link inside the root pointing out of it is
+ * therefore reported as outside.
+ *
+ * **Resolving is not opening, and the gap between them is exploitable.** A path
+ * that answers `true` here can be replaced by a symbolic link before the caller
+ * opens it — the check and the use are two syscalls, and nothing holds the
+ * filesystem still between them. Where that matters, open the file first and
+ * validate the handle (`fd`-relative operations, `O_NOFOLLOW`), or make the
+ * root a directory an attacker cannot write to. This function narrows the
+ * window; it does not close it.
+ *
+ * Costs one `realpath` per path, plus one per missing ancestor when the path
+ * does not exist.
+ *
+ * @param root The directory the path must stay inside.
+ * @param path The path to check.
+ * @param options Resolution base, root-equality and case-folding policy.
+ * @returns A promise for whether the real path is inside the real root.
+ * @throws Error Any filesystem error other than a missing path — a check that
+ *   could not look never answers "within".
+ */
+export declare function isPathWithinAsync(root: string, path: string, options?: PathWithinOptions): Promise<boolean>;
+/**
+ * Require that `path` stays inside `root`, and hand back the resolved path.
+ *
+ * Returning the resolved path is the point: a caller that resolves again to use
+ * it opens a second window in which the answer could change, and a caller that
+ * uses its original relative input has not used the thing that was checked.
+ *
+ * Same textual semantics as {@link isPathWithin}, symbolic links included.
+ *
+ * @param root The directory the path must stay inside.
+ * @param path The path to check.
+ * @param options Resolution base, root-equality and case-folding policy.
+ * @returns The resolved absolute path.
+ * @throws PathEscapeError If the resolved path is outside the resolved root.
+ */
+export declare function assertPathWithin(root: string, path: string, options?: PathWithinOptions): string;
+/**
+ * Require that `path` stays inside `root` once both are resolved through
+ * symbolic links, and hand back the real path.
+ *
+ * Same semantics and the same TOCTOU caveat as {@link isPathWithinAsync}; use
+ * the returned path rather than the argument, so the value opened is the value
+ * that was checked.
+ *
+ * @param root The directory the path must stay inside.
+ * @param path The path to check.
+ * @param options Resolution base, root-equality and case-folding policy.
+ * @returns A promise for the real absolute path.
+ * @throws PathEscapeError If the real path is outside the real root.
+ */
+export declare function assertPathWithinAsync(root: string, path: string, options?: PathWithinOptions): Promise<string>;
+//# sourceMappingURL=path-within.d.ts.map

package/dist/fs/path-within.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-within.d.ts","sourceRoot":"","sources":["../../src/fs/path-within.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C,CAAC;AA6HF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAET;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,iBAAiB,GACzB,MAAM,CAQR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAQjB"}

package/dist/fs/path-within.js

@@ -0,0 +1,196 @@
+import { realpath } from "node:fs/promises";
+import os from "node:os";
+import { basename, dirname, join, parse, resolve, sep } from "node:path";
+import { PathEscapeError } from "./path-escape-error.js";
+/** Absolute path to `[filesystemRoot, ...segments]`, with no empty segment. */
+function toSegments_(absolutePath) {
+    const { root } = parse(absolutePath);
+    const rest = absolutePath.slice(root.length);
+    return rest.length === 0 ? [root] : [root, ...rest.split(sep)];
+}
+function isSegmentEqual_(left, right, caseInsensitive) {
+    return caseInsensitive
+        ? // Not `toLocaleLowerCase`: a Turkish locale would fold the dotless i and
+            // make containment depend on the machine's language.
+            left.toLowerCase() === right.toLowerCase()
+        : left === right;
+}
+/**
+ * Segment-wise containment.
+ *
+ * A prefix test on the joined strings is the classic bug: `/var/data-evil`
+ * starts with `/var/data`. Comparing segments makes the separator implicit
+ * instead of something the caller has to remember to append.
+ */
+function isWithin_(resolved) {
+    const rootSegments = toSegments_(resolved.root);
+    const pathSegments = toSegments_(resolved.path);
+    if (pathSegments.length < rootSegments.length) {
+        return false;
+    }
+    for (let index = 0; index < rootSegments.length; index++) {
+        if (!isSegmentEqual_(rootSegments[index], pathSegments[index], resolved.caseInsensitive)) {
+            return false;
+        }
+    }
+    return pathSegments.length > rootSegments.length || resolved.allowRoot;
+}
+function resolveTextually_(root, path, options) {
+    const from = options?.from ?? ".";
+    return {
+        // `resolve` normalizes `.` and `..`, drops a trailing separator, and
+        // ignores `from` for an input that is already absolute.
+        root: resolve(from, root),
+        path: resolve(from, path),
+        allowRoot: options?.allowRoot ?? true,
+        caseInsensitive: options?.caseInsensitive ?? os.platform() === "win32",
+    };
+}
+/**
+ * `realpath` of the longest existing prefix, with the missing tail appended.
+ *
+ * A path being checked before it is created has nothing to resolve, and
+ * `realpath` reports that as `ENOENT` for the whole path rather than for the
+ * part that is missing. Anything else — a permission error, a symlink loop — is
+ * rethrown, so a check never answers "within" because it could not look.
+ */
+async function realpathPartial_(target) {
+    const missing = [];
+    let current = target;
+    for (;;) {
+        try {
+            const existing = await realpath(current);
+            return missing.length === 0
+                ? existing
+                : join(existing, ...missing.reverse());
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== "ENOENT" && code !== "ENOTDIR") {
+                throw error;
+            }
+            const parent = dirname(current);
+            if (parent === current) {
+                return target;
+            }
+            missing.push(basename(current));
+            current = parent;
+        }
+    }
+}
+async function resolveReally_(root, path, options) {
+    const textual = resolveTextually_(root, path, options);
+    const [realRoot, realPath] = await Promise.all([
+        realpathPartial_(textual.root),
+        realpathPartial_(textual.path),
+    ]);
+    return { ...textual, root: realRoot, path: realPath };
+}
+/**
+ * Whether `path` stays inside `root`, comparing the two as resolved sequences
+ * of path segments.
+ *
+ * Both are resolved first, so `..`, `.`, a trailing separator and a relative
+ * input all behave as the filesystem would read them. Containment is then
+ * decided segment by segment, which is why `/var/data-evil` is not inside
+ * `/var/data` — a `startsWith` test on the joined strings says it is. The path
+ * being the root itself counts as within unless
+ * {@link PathWithinOptions.allowRoot} says otherwise.
+ *
+ * **This answers a question about strings, not about the filesystem.** A
+ * symbolic link inside the root pointing out of it resolves within textually
+ * and reads outside it in practice; {@link isPathWithinAsync} is the variant
+ * that follows links.
+ *
+ * Time and memory are linear in the length of the two paths.
+ *
+ * @example
+ * 	```ts
+ * 	isPathWithin("/var/data", "/var/data/a/b"); // true
+ * 	isPathWithin("/var/data", "/var/data-evil/x"); // false
+ * 	isPathWithin("/var/data", "/var/data/a/../../etc/passwd"); // false
+ * 	isPathWithin("/var/data", "/var/data", { allowRoot: false }); // false
+ * 	```;
+ *
+ * @param root The directory the path must stay inside.
+ * @param path The path to check.
+ * @param options Resolution base, root-equality and case-folding policy.
+ * @returns True if the resolved path is inside the resolved root.
+ */
+export function isPathWithin(root, path, options) {
+    return isWithin_(resolveTextually_(root, path, options));
+}
+/**
+ * Whether `path` stays inside `root` once both are resolved through symbolic
+ * links.
+ *
+ * Resolves each with `realpath`, falling back to the longest existing prefix
+ * when the path does not exist yet, then applies the segment comparison
+ * {@link isPathWithin} describes. A link inside the root pointing out of it is
+ * therefore reported as outside.
+ *
+ * **Resolving is not opening, and the gap between them is exploitable.** A path
+ * that answers `true` here can be replaced by a symbolic link before the caller
+ * opens it — the check and the use are two syscalls, and nothing holds the
+ * filesystem still between them. Where that matters, open the file first and
+ * validate the handle (`fd`-relative operations, `O_NOFOLLOW`), or make the
+ * root a directory an attacker cannot write to. This function narrows the
+ * window; it does not close it.
+ *
+ * Costs one `realpath` per path, plus one per missing ancestor when the path
+ * does not exist.
+ *
+ * @param root The directory the path must stay inside.
+ * @param path The path to check.
+ * @param options Resolution base, root-equality and case-folding policy.
+ * @returns A promise for whether the real path is inside the real root.
+ * @throws Error Any filesystem error other than a missing path — a check that
+ *   could not look never answers "within".
+ */
+export async function isPathWithinAsync(root, path, options) {
+    return isWithin_(await resolveReally_(root, path, options));
+}
+/**
+ * Require that `path` stays inside `root`, and hand back the resolved path.
+ *
+ * Returning the resolved path is the point: a caller that resolves again to use
+ * it opens a second window in which the answer could change, and a caller that
+ * uses its original relative input has not used the thing that was checked.
+ *
+ * Same textual semantics as {@link isPathWithin}, symbolic links included.
+ *
+ * @param root The directory the path must stay inside.
+ * @param path The path to check.
+ * @param options Resolution base, root-equality and case-folding policy.
+ * @returns The resolved absolute path.
+ * @throws PathEscapeError If the resolved path is outside the resolved root.
+ */
+export function assertPathWithin(root, path, options) {
+    const resolved = resolveTextually_(root, path, options);
+    if (!isWithin_(resolved)) {
+        throw new PathEscapeError(resolved.root, resolved.path);
+    }
+    return resolved.path;
+}
+/**
+ * Require that `path` stays inside `root` once both are resolved through
+ * symbolic links, and hand back the real path.
+ *
+ * Same semantics and the same TOCTOU caveat as {@link isPathWithinAsync}; use
+ * the returned path rather than the argument, so the value opened is the value
+ * that was checked.
+ *
+ * @param root The directory the path must stay inside.
+ * @param path The path to check.
+ * @param options Resolution base, root-equality and case-folding policy.
+ * @returns A promise for the real absolute path.
+ * @throws PathEscapeError If the real path is outside the real root.
+ */
+export async function assertPathWithinAsync(root, path, options) {
+    const resolved = await resolveReally_(root, path, options);
+    if (!isWithin_(resolved)) {
+        throw new PathEscapeError(resolved.root, resolved.path);
+    }
+    return resolved.path;
+}
+//# sourceMappingURL=path-within.js.map

package/dist/fs/path-within.js.map

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

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export * from "./fs/escape-path.js";
 export * from "./fs/exists-async.js";
 export * from "./fs/file-content-equal.js";
 export * from "./fs/is-directory-async.js";
+export * from "./fs/path-escape-error.js";
+export * from "./fs/path-within.js";
 export * from "./fs/types.js";
 export * from "./fs/walk-paths.js";
 export * from "./fs/write-file-atomic.js";
@@ -18,6 +20,8 @@ export * from "./module/optional-import.js";
 export * from "./module/resolve-module.js";
 export * from "./net/connection-closed-error.js";
 export * from "./net/dgram-socket.js";
+export * from "./net/inet-address.js";
+export * from "./net/inet-endpoint.js";
 export * from "./net/inet-socket.js";
 export * from "./net/ipc-server.js";
 export * from "./net/ipc-socket.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -10,6 +10,8 @@ export * from "./fs/escape-path.js";
 export * from "./fs/exists-async.js";
 export * from "./fs/file-content-equal.js";
 export * from "./fs/is-directory-async.js";
+export * from "./fs/path-escape-error.js";
+export * from "./fs/path-within.js";
 export * from "./fs/types.js";
 export * from "./fs/walk-paths.js";
 export * from "./fs/write-file-atomic.js";
@@ -18,6 +20,8 @@ export * from "./module/optional-import.js";
 export * from "./module/resolve-module.js";
 export * from "./net/connection-closed-error.js";
 export * from "./net/dgram-socket.js";
+export * from "./net/inet-address.js";
+export * from "./net/inet-endpoint.js";
 export * from "./net/inet-socket.js";
 export * from "./net/ipc-server.js";
 export * from "./net/ipc-socket.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC"}

package/dist/net/dgram-socket.d.ts

@@ -1,7 +1,8 @@
 import * as dgram from "node:dgram";
 import { EventDispatcherMapBase, IEventDispatcherMap } from "@ac-kit/async";
-import { InetEndpoint, type IError } from "@ac-kit/core";
+import type { IError } from "@ac-kit/core";
 import type { Except, TypedArray } from "type-fest";
+import type { InetEndpoint } from "./inet-endpoint.js";
 /** Event map for DgramSocket socket-specific events. */
 export type DgramSocketEvents = {
     /** Emitted when the socket is closed. */

package/dist/net/dgram-socket.d.ts.map

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

package/dist/net/dgram-socket.js

@@ -1,7 +1,7 @@
 import * as dgram from "node:dgram";
 import { EventDispatcherMapBase } from "@ac-kit/async";
-import { composeInetAddress } from "@ac-kit/core";
 import { isNodeErrorWithCode } from "../error/node-error.js";
+import { toInetAddress } from "./inet-address.js";
 /**
  * High-level wrapper around Node.js
  * {@link dgram.Socket | UDP datagram sockets}.
@@ -206,7 +206,7 @@ export class DgramSocket extends EventDispatcherMapBase {
             throw error;
         }
         return {
-            ...composeInetAddress(addr.family, addr.address),
+            ...toInetAddress(addr.family, addr.address),
             port: addr.port,
         };
     }
@@ -331,7 +331,7 @@ export class DgramSocket extends EventDispatcherMapBase {
         });
         this.socket.on("message", (msg, rinfo) => {
             const from = {
-                ...composeInetAddress(rinfo.family, rinfo.address),
+                ...toInetAddress(rinfo.family, rinfo.address),
                 port: rinfo.port,
             };
             this.dispatch("message", [msg, rinfo.size, from]);

package/dist/net/dgram-socket.js.map

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

package/dist/net/inet-address.d.ts

@@ -0,0 +1,20 @@
+/** Represents an Internet address with IP family and address. */
+export type InetAddress = {
+    /** IP family: 4 for IPv4, 6 for IPv6, or null for unknown family. */
+    family: 4 | 6 | null;
+    /** IP address string. */
+    address: string;
+};
+/**
+ * Normalizes a family and address into an InetAddress. Validates and converts
+ * the family to ensure it is 4, 6, or null.
+ *
+ * @param family The IP family, either as a string ('IPv4', 'IPv6'), number (4,
+ *   6), or null for unknown.
+ * @param address The IP address string.
+ * @returns An InetAddress object.
+ * @throws {UnsupportedError} If the family is not valid (not 'IPv4'/'IPv6' or
+ *   4/6 or null).
+ */
+export declare function toInetAddress(family: string | number | null, address: string): InetAddress;
+//# sourceMappingURL=inet-address.d.ts.map

package/dist/net/inet-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inet-address.d.ts","sourceRoot":"","sources":["../../src/net/inet-address.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG;IACzB,qEAAqE;IACrE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACrB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC9B,OAAO,EAAE,MAAM,GACb,WAAW,CA6Bb"}

package/dist/net/inet-address.js

@@ -0,0 +1,42 @@
+import { UnsupportedError } from "@ac-kit/core";
+/**
+ * Normalizes a family and address into an InetAddress. Validates and converts
+ * the family to ensure it is 4, 6, or null.
+ *
+ * @param family The IP family, either as a string ('IPv4', 'IPv6'), number (4,
+ *   6), or null for unknown.
+ * @param address The IP address string.
+ * @returns An InetAddress object.
+ * @throws {UnsupportedError} If the family is not valid (not 'IPv4'/'IPv6' or
+ *   4/6 or null).
+ */
+export function toInetAddress(family, address) {
+    let validatedFamily;
+    if (typeof family === "string") {
+        if (family === "IPv4") {
+            validatedFamily = 4;
+        }
+        else if (family === "IPv6") {
+            validatedFamily = 6;
+        }
+        else {
+            throw new UnsupportedError(`Unsupported IP family: ${family}. Expected 'IPv4' or 'IPv6'.`);
+        }
+    }
+    else if (typeof family === "number") {
+        if (family === 4 || family === 6) {
+            validatedFamily = family;
+        }
+        else {
+            throw new UnsupportedError(`Unsupported IP family: ${family}. Expected 4 (IPv4) or 6 (IPv6).`);
+        }
+    }
+    else {
+        validatedFamily = null;
+    }
+    return {
+        family: validatedFamily,
+        address,
+    };
+}
+//# sourceMappingURL=inet-address.js.map

package/dist/net/inet-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inet-address.js","sourceRoot":"","sources":["../../src/net/inet-address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAUhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC5B,MAA8B,EAC9B,OAAe;IAEf,IAAI,eAA6B,CAAC;IAElC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACvB,eAAe,GAAG,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,eAAe,GAAG,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,gBAAgB,CACzB,0BAA0B,MAAM,8BAA8B,CAC9D,CAAC;QACH,CAAC;IACF,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,eAAe,GAAG,MAAM,CAAC;QAC1B,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,gBAAgB,CACzB,0BAA0B,MAAM,kCAAkC,CAClE,CAAC;QACH,CAAC;IACF,CAAC;SAAM,CAAC;QACP,eAAe,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,OAAO;QACN,MAAM,EAAE,eAAe;QACvB,OAAO;KACP,CAAC;AACH,CAAC"}

package/dist/net/inet-endpoint.d.ts

@@ -0,0 +1,7 @@
+import { InetAddress } from "./inet-address.js";
+/** Represents an Internet endpoint with IP family, address, and port. */
+export type InetEndpoint = InetAddress & {
+    /** Port number. */
+    port: number;
+};
+//# sourceMappingURL=inet-endpoint.d.ts.map

package/dist/net/inet-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inet-endpoint.d.ts","sourceRoot":"","sources":["../../src/net/inet-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACxC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CACb,CAAC"}

package/dist/net/inet-endpoint.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inet-endpoint.js.map

package/dist/net/inet-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inet-endpoint.js","sourceRoot":"","sources":["../../src/net/inet-endpoint.ts"],"names":[],"mappings":""}

package/dist/net/inet-socket.d.ts

@@ -1,5 +1,6 @@
 import * as net from "node:net";
-import { type InetAddress, type InetEndpoint } from "@ac-kit/core";
+import { type InetAddress } from "./inet-address.js";
+import type { InetEndpoint } from "./inet-endpoint.js";
 import { StreamSocket, type StreamSocketEvents } from "./stream-socket.js";
 /** Event map for sockets running over an IP transport. */
 export type InetSocketEvents = StreamSocketEvents & {

package/dist/net/inet-socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inet-socket.d.ts","sourceRoot":"","sources":["../../src/net/inet-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,EAEN,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG;IACnD;;;OAGG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE5C;;;OAGG;IACH,uBAAuB,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAEhE;;;OAGG;IACH,wBAAwB,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEnD,mEAAmE;IACnE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,UAAU,CACtB,OAAO,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EACvC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,CAClD,SAAQ,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;IACvC;;;;OAIG;IACH,IAAI,cAAc,IAAI,YAAY,GAAG,IAAI,CAaxC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,YAAY,GAAG,IAAI,CAavC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzD;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjC;IAED,UAAmB,oBAAoB,IAAI,IAAI,CAsC9C;CACD"}
+{"version":3,"file":"inet-socket.d.ts","sourceRoot":"","sources":["../../src/net/inet-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG;IACnD;;;OAGG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE5C;;;OAGG;IACH,uBAAuB,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAEhE;;;OAGG;IACH,wBAAwB,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEnD,mEAAmE;IACnE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,UAAU,CACtB,OAAO,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EACvC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,CAClD,SAAQ,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;IACvC;;;;OAIG;IACH,IAAI,cAAc,IAAI,YAAY,GAAG,IAAI,CAaxC;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,YAAY,GAAG,IAAI,CAavC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzD;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjC;IAED,UAAmB,oBAAoB,IAAI,IAAI,CAkC9C;CACD"}

package/dist/net/inet-socket.js

@@ -1,4 +1,4 @@
-import { composeInetAddress, } from "@ac-kit/core";
+import { toInetAddress } from "./inet-address.js";
 import { StreamSocket } from "./stream-socket.js";
 /**
  * Base class for sockets whose transport is an IP connection.
@@ -25,7 +25,7 @@ export class InetSocket extends StreamSocket {
             return null;
         }
         return {
-            ...composeInetAddress(family, address),
+            ...toInetAddress(family, address),
             port,
         };
     }
@@ -42,7 +42,7 @@ export class InetSocket extends StreamSocket {
             return null;
         }
         return {
-            ...composeInetAddress(family, address),
+            ...toInetAddress(family, address),
             port,
         };
     }
@@ -69,7 +69,7 @@ export class InetSocket extends StreamSocket {
         this.socket.on("connectionAttempt", (ip, port, family) => {
             this.dispatch("connectionAttempt", [
                 {
-                    ...composeInetAddress(family, ip),
+                    ...toInetAddress(family, ip),
                     port,
                 },
             ]);
@@ -77,7 +77,7 @@ export class InetSocket extends StreamSocket {
         this.socket.on("connectionAttemptFailed", (ip, port, family, error) => {
             this.dispatch("connectionAttemptFailed", [
                 {
-                    ...composeInetAddress(family, ip),
+                    ...toInetAddress(family, ip),
                     port,
                 },
                 error,
@@ -86,17 +86,13 @@ export class InetSocket extends StreamSocket {
         this.socket.on("connectionAttemptTimeout", (ip, port, family) => {
             this.dispatch("connectionAttemptTimeout", [
                 {
-                    ...composeInetAddress(family, ip),
+                    ...toInetAddress(family, ip),
                     port,
                 },
             ]);
         });
         this.socket.on("lookup", (error, address, family, host) => {
-            this.dispatch("lookup", [
-                error,
-                composeInetAddress(family, address),
-                host,
-            ]);
+            this.dispatch("lookup", [error, toInetAddress(family, address), host]);
         });
     }
 }

package/dist/net/inet-socket.js.map

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

package/dist/net/tcp-server.d.ts

@@ -1,6 +1,6 @@
 import * as net from "node:net";
-import { InetEndpoint } from "@ac-kit/core";
 import type { Except } from "type-fest";
+import type { InetEndpoint } from "./inet-endpoint.js";
 import { StreamServer, type StreamServerEvents } from "./stream-server.js";
 import { TcpSocket } from "./tcp-socket.js";
 /** Event map for {@link TcpServer}. */

package/dist/net/tcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tcp-server.d.ts","sourceRoot":"","sources":["../../src/net/tcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,EAEN,YAAY,EAEZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG;IAClD,iDAAiD;IACjD,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEhC;;;;OAIG;IACH,IAAI,EAAE;QACL,aAAa,EAAE,YAAY,GAAG,IAAI;QAClC,cAAc,EAAE,YAAY,GAAG,IAAI;KACnC,CAAC;CACF,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,UAAU,CAAC;AAE9C,oDAAoD;AACpD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAC1C,GAAG,CAAC,aAAa,EACjB,MAAM,GAAG,MAAM,GAAG,QAAQ,CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS,CACrB,OAAO,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EACvC,OAAO,SAAS,eAAe,GAAG,eAAe,CAChD,SAAQ,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAEjD;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;IAED;;;;;;OAMG;IACH,OAAO,IAAI,YAAY,GAAG,IAAI,CAiB7B;IAED,UAAmB,oBAAoB,IAAI,IAAI,CA8B9C;CACD"}
+{"version":3,"file":"tcp-server.d.ts","sourceRoot":"","sources":["../../src/net/tcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG;IAClD,iDAAiD;IACjD,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEhC;;;;OAIG;IACH,IAAI,EAAE;QACL,aAAa,EAAE,YAAY,GAAG,IAAI;QAClC,cAAc,EAAE,YAAY,GAAG,IAAI;KACnC,CAAC;CACF,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,UAAU,CAAC;AAE9C,oDAAoD;AACpD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAC1C,GAAG,CAAC,aAAa,EACjB,MAAM,GAAG,MAAM,GAAG,QAAQ,CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS,CACrB,OAAO,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EACvC,OAAO,SAAS,eAAe,GAAG,eAAe,CAChD,SAAQ,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAEjD;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;IAED;;;;;;OAMG;IACH,OAAO,IAAI,YAAY,GAAG,IAAI,CAiB7B;IAED,UAAmB,oBAAoB,IAAI,IAAI,CA8B9C;CACD"}

package/dist/net/tcp-server.js

@@ -1,5 +1,6 @@
 import * as net from "node:net";
-import { composeInetAddress, UnsupportedError, } from "@ac-kit/core";
+import { UnsupportedError } from "@ac-kit/core";
+import { toInetAddress } from "./inet-address.js";
 import { StreamServer } from "./stream-server.js";
 import { TcpSocket } from "./tcp-socket.js";
 /**
@@ -59,7 +60,7 @@ export class TcpServer extends StreamServer {
             throw new UnsupportedError(`Unsupported address type: string. Expected AddressInfo object.`);
         }
         return {
-            ...composeInetAddress(address.family, address.address),
+            ...toInetAddress(address.family, address.address),
             port: address.port,
         };
     }
@@ -73,7 +74,7 @@ export class TcpServer extends StreamServer {
                 data.localPort !== undefined &&
                 data.localFamily !== undefined
                 ? {
-                    ...composeInetAddress(data.localFamily, data.localAddress),
+                    ...toInetAddress(data.localFamily, data.localAddress),
                     port: data.localPort,
                 }
                 : null;
@@ -81,7 +82,7 @@ export class TcpServer extends StreamServer {
                 data.remotePort !== undefined &&
                 data.remoteFamily !== undefined
                 ? {
-                    ...composeInetAddress(data.remoteFamily, data.remoteAddress),
+                    ...toInetAddress(data.remoteFamily, data.remoteAddress),
                     port: data.remotePort,
                 }
                 : null;

package/dist/net/tcp-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"tcp-server.js","sourceRoot":"","sources":["../../src/net/tcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,EACN,kBAAkB,EAElB,gBAAgB,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,YAAY,EAA2B,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA2B5C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,SAGX,SAAQ,YAA8B;IACvC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAA0B;QACrC,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAY,EAAE,OAAgC;QACpD,OAAO,IAAI,CAAC,QAAQ,CAAC;YACpB,GAAG,OAAO;YACV,IAAI;SACJ,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACN,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAEtC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,IAAI,gBAAgB,CACzB,gEAAgE,CAChE,CAAC;QACH,CAAC;QAED,OAAO;YACN,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;YACtD,IAAI,EAAE,OAAO,CAAC,IAAI;SAClB,CAAC;IACH,CAAC;IAEkB,oBAAoB;QACtC,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAE7B,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,aAAa,GAClB,IAAI,EAAE,YAAY,KAAK,SAAS;gBAChC,IAAI,CAAC,SAAS,KAAK,SAAS;gBAC5B,IAAI,CAAC,WAAW,KAAK,SAAS;gBAC7B,CAAC,CAAC;oBACA,GAAG,kBAAkB,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC;oBAC1D,IAAI,EAAE,IAAI,CAAC,SAAS;iBACpB;gBACF,CAAC,CAAC,IAAI,CAAC;YAET,MAAM,cAAc,GACnB,IAAI,EAAE,aAAa,KAAK,SAAS;gBACjC,IAAI,CAAC,UAAU,KAAK,SAAS;gBAC7B,IAAI,CAAC,YAAY,KAAK,SAAS;gBAC9B,CAAC,CAAC;oBACA,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC;oBAC5D,IAAI,EAAE,IAAI,CAAC,UAAU;iBACrB;gBACF,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}
+{"version":3,"file":"tcp-server.js","sourceRoot":"","sources":["../../src/net/tcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,YAAY,EAA2B,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA2B5C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,SAGX,SAAQ,YAA8B;IACvC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,OAA0B;QACrC,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAY,EAAE,OAAgC;QACpD,OAAO,IAAI,CAAC,QAAQ,CAAC;YACpB,GAAG,OAAO;YACV,IAAI;SACJ,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,OAAO;QACN,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAEtC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,IAAI,gBAAgB,CACzB,gEAAgE,CAChE,CAAC;QACH,CAAC;QAED,OAAO;YACN,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;YACjD,IAAI,EAAE,OAAO,CAAC,IAAI;SAClB,CAAC;IACH,CAAC;IAEkB,oBAAoB;QACtC,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAE7B,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,aAAa,GAClB,IAAI,EAAE,YAAY,KAAK,SAAS;gBAChC,IAAI,CAAC,SAAS,KAAK,SAAS;gBAC5B,IAAI,CAAC,WAAW,KAAK,SAAS;gBAC7B,CAAC,CAAC;oBACA,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC;oBACrD,IAAI,EAAE,IAAI,CAAC,SAAS;iBACpB;gBACF,CAAC,CAAC,IAAI,CAAC;YAET,MAAM,cAAc,GACnB,IAAI,EAAE,aAAa,KAAK,SAAS;gBACjC,IAAI,CAAC,UAAU,KAAK,SAAS;gBAC7B,IAAI,CAAC,YAAY,KAAK,SAAS;gBAC9B,CAAC,CAAC;oBACA,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC;oBACvD,IAAI,EAAE,IAAI,CAAC,UAAU;iBACrB;gBACF,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ac-kit/node",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Node.js extensions and zero-dependency wrappers over node: built-ins — promise-based TCP, TLS, IPC and UDP sockets, file I/O helpers and process utilities.",
   "keywords": [
     "fs",
@@ -39,8 +39,8 @@
     "prepack": "yarn build"
   },
   "dependencies": {
-    "@ac-kit/async": "^0.1.1",
-    "@ac-kit/core": "^0.2.0",
+    "@ac-kit/async": "^0.1.2",
+    "@ac-kit/core": "^0.3.0",
     "@types/node": "^26.5.1",
     "type-fest": "^5.8.0"
   },