@hugoalh/adler32 0.5.1 → 0.6.1

package/README.md

@@ -22,28 +22,15 @@ Any runtime which support ECMAScript should able to use this; These runtimes are
 
 This does not request any runtime permission.
 
-## #️⃣ Sources & Entrypoints
+## #️⃣ Entrypoints
 
-- GitHub Raw
-  ```
-  https://raw.githubusercontent.com/hugoalh/adler32-es/{Tag}/mod.ts
-  ```
-- JSR
-  ```
-  jsr:@hugoalh/adler32[@{Tag}]
-  ```
-- NPM
-  ```
-  npm:@hugoalh/adler32[@{Tag}]
-  ```
-
-| **Name** | **Path** | **Description** |
-|:--|:--|:--|
-| `.` | `./mod.ts` | Default. |
+| **Type** | **Name** | **Path** | **Description** |
+|:--|:--|:--|:--|
+| API | `.` | `./mod.ts` | Default. |
+| CLI | `./cli` | `./cli.ts` | Default. |
 
 > [!NOTE]
-> - Different runtimes have vary support for the sources and entrypoints, visit the runtime documentation for more information.
-> - It is recommended to include tag for immutability.
+> - Different runtimes have vary support for the entrypoints, visit the runtime documentation for more information.
 > - These are not part of the public APIs hence should not be used:
 >   - Benchmark/Test file (e.g.: `example.bench.ts`, `example.test.ts`).
 >   - Entrypoint name or path include any underscore prefix (e.g.: `_example.ts`, `foo/_example.ts`).
@@ -73,12 +60,34 @@ This does not request any runtime permission.
 
 > [!NOTE]
 > - For the full or prettier documentation, can visit via:
->   - [Deno CLI `deno doc`](https://docs.deno.com/runtime/reference/cli/doc/)
+>   - [Deno CLI `deno doc`](https://docs.deno.com/runtime/reference/cli/doc)
 >   - [JSR](https://jsr.io/@hugoalh/adler32)
 
+## 🧩 CLIs
+
+- ```powershell
+  adler32 $Context
+  ```
+- ```powershell
+  adler32 --file $FilePath
+  <# 🔀 Unordered Positions: `--file`, `$FilePath` #>
+  ```
+  | **Argument** | **Type** | **Description** |
+  |:--|:--|:--|
+  | `file` | `switch` | Whether the resource is from file. |
+- ```powershell
+  adler32 --stdin
+  ```
+  | **Argument** | **Type** | **Description** |
+  |:--|:--|:--|
+  | `stdin` | `switch` | Whether the resource is from standard stream input. |
+
 ## ✍️ Examples
 
 - ```ts
   new Adler32("Wikipedia").hashHex();
   //=> "11E60398"
   ```
+- ```powershell
+  adler32 'Wikipedia'
+  ```

package/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["src/cli.ts"],"names":[],"mappings":""}

package/cli.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { constants as fsConstants, open as openFile } from "node:fs/promises";
+import { exit, stdin } from "node:process";
+import { parseArgs, styleText } from "node:util";
+import { Adler32 } from "./mod.js";
+if (!import.meta.main) {
+    throw new Error(`This entrypoint is for command line only!`);
+}
+addEventListener("unhandledrejection", (event) => {
+    event.preventDefault();
+    let message;
+    if (event.reason instanceof Error) {
+        message = event.reason.message;
+        if ((event.reason.stack ?? "").length > 0) {
+            message += `\n${event.reason.stack}`;
+        }
+    }
+    else {
+        message = String(event.reason);
+    }
+    console.error(`${styleText(["red"], "ERROR", { validateStream: false })}\t${message}`);
+    exit(1);
+}, { capture: true });
+const { positionals, values: { file: fromFile = false, stdin: fromStdin = false } } = parseArgs({
+    allowPositionals: true,
+    options: {
+        file: {
+            type: "boolean"
+        },
+        stdin: {
+            type: "boolean"
+        }
+    }
+});
+if (fromFile && fromStdin) {
+    throw new SyntaxError(`Unable to request resource from file and stdin together!`);
+}
+const expectArgumentsLength = fromStdin ? 0 : 1;
+if (positionals.length !== expectArgumentsLength) {
+    throw new SyntaxError(`Invalid arguments length! Expect: ${expectArgumentsLength}, Current: ${positionals.length}.`);
+}
+const instance = new Adler32();
+if (fromFile) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const file = __addDisposableResource(env_1, await openFile(positionals[0], fsConstants.O_RDONLY), true);
+        await instance.updateFromStream(file.readableWebStream());
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        const result_1 = __disposeResources(env_1);
+        if (result_1)
+            await result_1;
+    }
+}
+else if (fromStdin) {
+    await instance.updateFromStream(stdin);
+}
+else {
+    instance.update(positionals[0]);
+}
+console.log(instance.hashHex());

package/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["src/mod.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAC9B,MAAM,GACN,cAAc,GACd,UAAU,GACV,WAAW,GACX,WAAW,CAAC;AACf;;GAEG;AACH,qBAAa,OAAO;;IACnB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAMD;;;OAGG;gBACS,IAAI,CAAC,EAAE,qBAAqB;IAKxC;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IACD;;;OAGG;IACH,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,IAAI,IAAI,UAAU;IAIlB;;;OAGG;IACH,OAAO,IAAI,MAAM;IASjB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;IAazC;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAMpF;AACD,eAAe,OAAO,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["src/mod.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAC9B,MAAM,GACN,cAAc,GACd,UAAU,GACV,WAAW,GACX,WAAW,CAAC;AACf;;GAEG;AACH,qBAAa,OAAO;;IACnB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAMD;;;OAGG;gBACS,IAAI,CAAC,EAAE,qBAAqB;IAKxC;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IACD;;;OAGG;IACH,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,IAAI,IAAI,UAAU;IAIlB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAUjB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;IAazC;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAMpF;AACD,eAAe,OAAO,CAAC"}

package/mod.js

@@ -52,10 +52,11 @@ export class Adler32 {
      */
     hashHex() {
         if (this.#hashHex === null) {
-            this.#hashHex = (this.#b * 65536n + this.#a).toString(16).toUpperCase().padStart(8, "0");
-            if (this.#hashHex.length !== 8) {
-                throw new Error(`Unexpected hash hex result \`${this.#hashHex}\`! Please submit a bug report.`);
+            const result = (this.#b * 65536n + this.#a).toString(16).toUpperCase().padStart(8, "0");
+            if (result.length !== 8) {
+                throw new Error(`Unexpected hash hex result \`${result}\`! Please submit a bug report.`);
             }
+            this.#hashHex = result;
         }
         return this.#hashHex;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hugoalh/adler32",
-	"version": "0.5.1",
+	"version": "0.6.1",
 	"description": "A module to get the checksum of the data with algorithm Adler32.",
 	"keywords": [
 		"adler32",
@@ -13,9 +13,18 @@
 	"license": "MIT",
 	"author": "hugoalh",
 	"type": "module",
+	"bin": {
+		"adler32": "./cli.js"
+	},
 	"main": "./mod.js",
 	"module": "./mod.js",
 	"exports": {
+		"./cli": {
+			"import": {
+				"types": "./cli.d.ts",
+				"default": "./cli.js"
+			}
+		},
 		".": {
 			"import": {
 				"types": "./mod.d.ts",
@@ -31,12 +40,8 @@
 	"dependencies": {
 		"es-arraybuffer-base64": "^1.1.2"
 	},
-	"devDependencies": {
-		"@types/node": "^24.5.0"
-	},
 	"private": false,
 	"publishConfig": {
 		"access": "public"
-	},
-	"_generatedBy": "dnt@dev"
+	}
 }