@serkonda7/ts-result 1.0.1 → 1.0.3

package/README.md

@@ -12,6 +12,44 @@ npm install @serkonda7/ts-result
 ```
 
 
+## 🚀 Usage
+```ts
+import { ok, err, unwrap, type Result } from '@serkonda7/ts-result'
+
+// To use, wrap a functions return type into `Result<>`
+function parsePort (input: string): Result<number> {
+    const port = Number.parseInt(input, 10)
+
+    if (!Number.isInteger(port)) {
+        // Return an error result by using the `err()` helper
+        return err('PORT must be an integer')
+    }
+
+    if (port < 1 || port > 65535) {
+        // It supports strings, Error classes or any custom object
+        return err(new Error('PORT must be between 1 and 65535'))
+    }
+
+    // Return an successful result using the `ok()` helper
+    return ok(port)
+}
+
+const portResult = parsePort(process.env.PORT)
+
+// Check the result for an error:
+if (portResult.error) {
+    console.error(portResult.error)
+    process.exit(1)
+}
+
+// Use the value afterwards
+let port = portResult.value
+
+// Use the `unwrap()` helper to throw any error or return the value
+const port = unwrap(portResult)
+```
+
+
 ## 📜 License
 This repo is licensed under the [MIT License](LICENSE.txt).
 

package/dist/{result.d.ts → src/result.d.ts}

@@ -29,5 +29,5 @@ export declare const err: <E>(error: E) => Err<E>;
  *
  * In case of an error, it is thrown.
  */
-export declare function unwrap<V, E extends Error>(result: Result<V, E>): V;
+export declare function unwrap<V, E>(result: Result<V, E>): V;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@serkonda7/ts-result",
   "description": "Minimalistic Result type for TypeScript.",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "license": "MIT",
   "author": "serkonda7",
   "homepage": "https://github.com/serkonda7/ts-result",
@@ -12,25 +12,28 @@
   "bugs": {
     "url": "https://github.com/serkonda7/ts-result/issues"
   },
-  "keywords": [],
+  "keywords": ["result", "typescript", "error-handling"],
   "type": "module",
   "main": "dist/result.js",
-  "types": "dist/result.d.ts",
-  "files": ["dist/"],
+  "types": "dist/src/result.d.ts",
+  "files": ["dist"],
   "scripts": {
-    "lint:fix": "biome check --write",
+    "lint": "biome check --write",
     "lint:ci": "biome ci",
-    "build": "bunx tsgo && bun run scripts/build.ts",
-    "prepack": "bun run build"
+    "check": "tsgo -p tsconfig.check.json",
+    "test": "bun test",
+    "build": "tsgo && bun run scripts/build.ts",
+    "prepack": "bun run build",
+    "pack": "bun pm pack --filename ts-result.tgz"
   },
   "engines": {
     "node": ">=22"
   },
-  "packageManager": "bun@1.3.5",
+  "packageManager": "bun@1.3.11",
   "dependencies": {},
   "devDependencies": {
-    "@biomejs/biome": "~2.3.11",
-    "@types/bun": "~1.3.5",
-    "@typescript/native-preview": "~7.0.0-dev.20260109.1"
+    "@biomejs/biome": "2.4.10",
+    "@types/bun": "~1.3.11",
+    "@typescript/native-preview": "~7.0.0-dev.20260325.1"
   }
 }