@ac-kit/app-system 0.1.0

package/dist/text/charset-decode-stream.js

@@ -0,0 +1,51 @@
+import { optionalImport } from "@ac-kit/node";
+const iconvLite = await optionalImport(() => import("iconv-lite"));
+/**
+ * Decodes byte chunks into strings using the given charset.
+ *
+ * Uses the platform {@link TextDecoder} where the charset is supported and
+ * iconv-lite for everything else. Split multi-byte sequences are carried across
+ * chunk boundaries.
+ */
+export class CharsetDecodeStream extends TransformStream {
+    #charset;
+    constructor(charset = "utf-8") {
+        let decoder;
+        try {
+            const textDecoder = new TextDecoder(charset);
+            decoder = {
+                write: (chunk) => textDecoder.decode(chunk, { stream: true }),
+                end: () => textDecoder.decode(),
+            };
+        }
+        catch {
+            if (!iconvLite?.encodingExists(charset)) {
+                throw new Error(`unsupported charset: ${charset}`);
+            }
+            const iconvDecoder = iconvLite.getDecoder(charset);
+            decoder = {
+                write: (chunk) => iconvDecoder.write(Buffer.from(chunk)),
+                end: () => iconvDecoder.end() ?? "",
+            };
+        }
+        super({
+            transform(chunk, controller) {
+                const text = decoder.write(chunk);
+                if (text) {
+                    controller.enqueue(text);
+                }
+            },
+            flush(controller) {
+                const text = decoder.end();
+                if (text) {
+                    controller.enqueue(text);
+                }
+            },
+        });
+        this.#charset = charset;
+    }
+    get charset() {
+        return this.#charset;
+    }
+}
+//# sourceMappingURL=charset-decode-stream.js.map

package/dist/text/charset-decode-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charset-decode-stream.js","sourceRoot":"","sources":["../../src/text/charset-decode-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAmC;IAClE,QAAQ,CAAS;IAE1B,YAAY,OAAO,GAAG,OAAO;QAC5B,IAAI,OAA4D,CAAC;QAEjE,IAAI,CAAC;YACJ,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,GAAG;gBACT,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBAC7D,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE;aAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,YAAY,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnD,OAAO,GAAG;gBACT,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxD,GAAG,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE;aACnC,CAAC;QACH,CAAC;QAED,KAAK,CAAC;YACL,SAAS,CAAC,KAAK,EAAE,UAAU;gBAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,IAAI,EAAE,CAAC;oBACV,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACF,CAAC;YACD,KAAK,CAAC,UAAU;gBACf,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC3B,IAAI,IAAI,EAAE,CAAC;oBACV,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACF,CAAC;SACD,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;CACD"}

package/dist/text/charset-encode-stream.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Encodes string chunks into bytes using the given charset.
+ *
+ * Uses the platform {@link TextEncoder} for UTF-8 and iconv-lite for everything
+ * else.
+ */
+export declare class CharsetEncodeStream extends TransformStream<string, Uint8Array> {
+    #private;
+    constructor(charset?: string);
+    get charset(): string;
+}
+//# sourceMappingURL=charset-encode-stream.d.ts.map

package/dist/text/charset-encode-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charset-encode-stream.d.ts","sourceRoot":"","sources":["../../src/text/charset-encode-stream.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC;;IAG3E,YAAY,OAAO,SAAU,EAgC5B;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;CACD"}

package/dist/text/charset-encode-stream.js

@@ -0,0 +1,47 @@
+import { optionalImport } from "@ac-kit/node";
+const iconvLite = await optionalImport(() => import("iconv-lite"));
+/**
+ * Encodes string chunks into bytes using the given charset.
+ *
+ * Uses the platform {@link TextEncoder} for UTF-8 and iconv-lite for everything
+ * else.
+ */
+export class CharsetEncodeStream extends TransformStream {
+    #charset;
+    constructor(charset = "utf-8") {
+        let encoder;
+        if (charset === "utf-8" || charset === "utf8") {
+            const textEncoder = new TextEncoder();
+            encoder = { write: (text) => textEncoder.encode(text), end: () => null };
+        }
+        else if (iconvLite?.encodingExists(charset)) {
+            const iconvEncoder = iconvLite.getEncoder(charset);
+            encoder = {
+                write: (text) => new Uint8Array(iconvEncoder.write(text)),
+                end: () => {
+                    const tail = iconvEncoder.end();
+                    return tail?.length ? new Uint8Array(tail) : null;
+                },
+            };
+        }
+        else {
+            throw new Error(`unsupported charset: ${charset}`);
+        }
+        super({
+            transform(chunk, controller) {
+                controller.enqueue(encoder.write(chunk));
+            },
+            flush(controller) {
+                const tail = encoder.end();
+                if (tail) {
+                    controller.enqueue(tail);
+                }
+            },
+        });
+        this.#charset = charset;
+    }
+    get charset() {
+        return this.#charset;
+    }
+}
+//# sourceMappingURL=charset-encode-stream.js.map

package/dist/text/charset-encode-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charset-encode-stream.js","sourceRoot":"","sources":["../../src/text/charset-encode-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAmC;IAClE,QAAQ,CAAS;IAE1B,YAAY,OAAO,GAAG,OAAO;QAC5B,IAAI,OAAsE,CAAC;QAE3E,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;YACtC,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1E,CAAC;aAAM,IAAI,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,MAAM,YAAY,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnD,OAAO,GAAG;gBACT,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzD,GAAG,EAAE,GAAG,EAAE;oBACT,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC;oBAChC,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnD,CAAC;aACD,CAAC;QACH,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,KAAK,CAAC;YACL,SAAS,CAAC,KAAK,EAAE,UAAU;gBAC1B,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,CAAC;YACD,KAAK,CAAC,UAAU;gBACf,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC3B,IAAI,IAAI,EAAE,CAAC;oBACV,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACF,CAAC;SACD,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;CACD"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@ac-kit/app-system",
+  "version": "0.1.0",
+  "description": "Process lifecycle helpers: PID files, process inspection, log rotation and command execution.",
+  "keywords": [
+    "log-rotation",
+    "nodejs",
+    "pidfile",
+    "process",
+    "system"
+  ],
+  "homepage": "https://anthochamp.github.io/node-essentials/api/app-system/",
+  "bugs": {
+    "url": "https://github.com/anthochamp/node-essentials/issues"
+  },
+  "license": "BSD-3-Clause",
+  "author": "Anthony Champagne <dev@anthonychampagne.fr>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthochamp/node-essentials.git",
+    "directory": "packages/app-system"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "access": "public"
+  },
+  "scripts": {
+    "compile": "tsc -p ./tsconfig.build.json -outDir dist",
+    "compile:check": "tsc -noEmit -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "build": "yarn clean && yarn compile",
+    "test": "yarn run -T vitest run",
+    "prepack": "yarn build"
+  },
+  "dependencies": {
+    "@ac-kit/app-report": "^0.1.0",
+    "@ac-kit/app-terminal": "^0.1.0",
+    "@ac-kit/async": "^0.1.0",
+    "@ac-kit/core": "0.1.0",
+    "@ac-kit/crypto-hash": "^0.1.0",
+    "@ac-kit/data": "^0.1.0",
+    "@ac-kit/format-ansi": "^0.1.0",
+    "@ac-kit/node": "0.1.0",
+    "@types/node": "^26.5.1",
+    "type-fest": "^5.8.0"
+  },
+  "devDependencies": {
+    "@ac-kit/tsconfig": "0.1.0",
+    "@ac-kit/typedoc-config": "0.1.0",
+    "@ac-kit/vitest-config": "0.1.0",
+    "@typescript/native": "typescript@7.0.2",
+    "iconv-lite": "0.7.3",
+    "rimraf": "6.1.3",
+    "tsx": "4.23.12",
+    "typedoc": "0.28.20",
+    "typescript": "@typescript/typescript6@6.0.2"
+  },
+  "peerDependencies": {
+    "iconv-lite": "*"
+  },
+  "peerDependenciesMeta": {
+    "iconv-lite": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}