@farbenmeer/lacy 0.1.0 → 1.0.0

package/README.md

@@ -0,0 +1,30 @@
+# @farbenmeer/lacy
+
+Lightweight utility for lazy evaluation of JavaScript promises. Chain property access and method calls without awaiting intermediate values.
+
+**[Documentation](https://oss-docs.apps.farbenmeer.de/lacy/)** | **[GitHub](https://github.com/farbenmeer/tapi/tree/main/packages/1-lacy)** | **[npm](https://www.npmjs.com/package/@farbenmeer/lacy)** 
+
+```ts
+import { lacy } from "@farbenmeer/lacy";
+
+// Instead of this:
+const response = await fetch("/api/users");
+const data = await response.json();
+const name = data[0].name;
+
+// Write this:
+const name = await lacy(fetch("/api/users")).json()[0].name;
+```
+
+## Installation
+
+```bash
+npm install @farbenmeer/lacy
+yarn add @farbenmeer/lacy
+pnpm add @farbenmeer/lacy
+bun add @farbenmeer/lacy
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -1,6 +1,12 @@
-type LacyPromise<T, P = never> = T extends (...args: infer A) => infer R ? (...args: A) => LacyPromise<R> : {
-    [key in Exclude<keyof T, "then" | "catch" | "finally">]: LacyPromise<T[key]>;
-} & Promise<T | P>;
+type Thenable<T> = {
+    then<R = T>(onfulfilled?: (value: T) => R | PromiseLike<R>, onrejected?: (reason: any) => void): Promise<R>;
+    catch(onrejected: (reason: any) => void): Promise<T>;
+    finally(onfinally: () => void): Promise<T>;
+    $: Promise<T>;
+};
+export type LacyPromise<T, P = never> = T extends (...args: infer A) => infer R ? (...args: A) => LacyPromise<R> : {
+    [key in Exclude<keyof T, "then" | "catch" | "finally" | "$">]: LacyPromise<T[key]>;
+} & Thenable<T | P>;
 export declare function lacy<T>(data: Promise<T>): LacyPromise<T>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GACpE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,GAC9B;KACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,WAAW,CAClE,CAAC,CAAC,GAAG,CAAC,CACP;CACF,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAEvB,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAqBxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,CAAC,CAAC,IAAI;IACjB,IAAI,CAAC,CAAC,GAAG,CAAC,EACR,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAC9C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GACjC,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAC3E,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,GAC9B;KACG,GAAG,IAAI,OAAO,CACb,MAAM,CAAC,EACP,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,GAAG,CACnC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACxB,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAExB,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAwBxD"}

package/dist/index.js

@@ -4,6 +4,9 @@ export function lacy(data) {
             if (prop === "then" || prop === "catch" || prop === "finally") {
                 return (...args) => target()[prop](...args);
             }
+            if (prop === "$") {
+                return target();
+            }
             return lacy(target().then((data) => {
                 if (typeof data[prop] === "function") {
                     return (...args) => data[prop](...args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farbenmeer/lacy",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "author": {
     "name": "Michel Smola",
     "email": "michel.smola@farbenmeer.de"
@@ -10,18 +10,23 @@
   "main": "dist/index.js",
   "private": false,
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/farbenmeer/tapi.git"
+  },
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc --noEmit false",
-    "release": "bun run build && bun publish"
-  },
-  "dependencies": {},
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/node": "^25.0.3",
+    "vitest": "^4.0.16"
   },
   "peerDependencies": {
     "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsc --noEmit false",
+    "release": "pnpm run build && pnpm publish",
+    "test": "vitest"
   }
-}
+}