@axman/remote 0.0.1

package/README.md

@@ -0,0 +1,78 @@
+## @axman/remote
+
+Typed helpers for remote data state: discriminated `Remote<T>` union with `pending`, `error`, `success`, plus `match`, `all` and `map` utilities.
+
+### Install
+
+```bash
+npm i @axman/remote
+# or
+pnpm add @axman/remote
+# or
+bun add @axman/remote
+```
+
+### Remote type
+
+`Remote<T>` is a discriminated union with `status` ∈ `"pending" | "error" | "success"` and convenient flags `isPending/isError/isSuccess`.
+
+```ts
+import { type Remote, error, pending, success } from "@axman/remote";
+
+const a: Remote<number> = pending();
+const b: Remote<number> = error(new Error("boom"));
+const c: Remote<number> = success(42);
+```
+
+### match(remote, cases)
+
+Pattern-match on `Remote<T>` in a type-safe way.
+
+```ts
+import { error, match, pending, success } from "@axman/remote";
+
+const out = match(success({ id: 1 }), {
+  pending: () => "loading",
+  error: (e) => `error: ${e.message}`,
+  success: (data) => `ok: ${data.id}`,
+});
+// => 'ok: 1'
+```
+
+### all(...remotes)
+
+Combine multiple `Remote`s into one. Precedence: any `error` → `error`; else if any `pending` → `pending`; otherwise `success` with a tuple of data.
+
+```ts
+import { all, error, pending, success } from "@axman/remote";
+
+all(error(new Error("x")), pending(), success(1));
+// => { status: 'error', ... }
+
+all(pending(), success(1));
+// => { status: 'pending', ... }
+
+const r = all(success(1), success("x" as const));
+// r.data has type [number, 'x']
+```
+
+### map(remote, fn)
+
+Map data of a successful `Remote<T>` to `Remote<R>`; passes through `pending` and `error` unchanged.
+
+```ts
+import { type Remote, error, map, pending, success } from "@axman/remote";
+
+map(success(2), (n) => n * 10);
+// => { status: 'success', data: 20, ... }
+
+map(pending() as Remote<number>, (n) => n * 10);
+// => { status: 'pending', ... }
+
+map(error(new Error("x")) as Remote<number>, (n) => n * 10);
+// => { status: 'error', ... }
+```
+
+### License
+
+MIT

package/dist/all.d.ts

@@ -0,0 +1,6 @@
+import { Remote } from './remote';
+type RemoteDataList<RemoteList extends readonly Remote<unknown>[]> = {
+    [K in keyof RemoteList]: RemoteList[K] extends Remote<infer D> ? D : never;
+};
+export declare function all<RemoteList extends readonly Remote<unknown>[]>(...values: RemoteList): Remote<RemoteDataList<RemoteList>>;
+export {};

package/dist/all.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function t(){return{status:"pending",isPending:!0,isError:!1,isSuccess:!1,error:void 0,data:void 0}}function i(r){return{status:"error",isPending:!1,isError:!0,isSuccess:!1,error:r,data:null}}function u(r){return{status:"success",isPending:!1,isError:!1,isSuccess:!0,error:null,data:r}}function c(...r){let e=!1;for(const n of r){if(n.isError)return i(n.error);n.isPending&&(e=!0)}if(e)return t();const s=r.map(n=>n.data);return u(s)}function o(r,e){switch(r.status){case"pending":return e.pending();case"error":return e.error(r.error);case"success":return e.success(r.data)}}function a(r,e){return o(r,{pending:()=>t(),error:s=>i(s),success:s=>u(e(s))})}const d=Object.freeze(Object.defineProperty({__proto__:null,all:c,error:i,map:a,match:o,pending:t,success:u},Symbol.toStringTag,{value:"Module"}));exports.all=c;exports.error=i;exports.map=a;exports.match=o;exports.pending=t;exports.remote=d;exports.success=u;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './index.exports';
+export * as remote from './index.exports';

package/dist/index.es.js

@@ -0,0 +1,77 @@
+function t() {
+  return {
+    status: "pending",
+    isPending: !0,
+    isError: !1,
+    isSuccess: !1,
+    error: void 0,
+    data: void 0
+  };
+}
+function i(r) {
+  return {
+    status: "error",
+    isPending: !1,
+    isError: !0,
+    isSuccess: !1,
+    error: r,
+    data: null
+  };
+}
+function u(r) {
+  return {
+    status: "success",
+    isPending: !1,
+    isError: !1,
+    isSuccess: !0,
+    error: null,
+    data: r
+  };
+}
+function c(...r) {
+  let e = !1;
+  for (const n of r) {
+    if (n.isError)
+      return i(n.error);
+    n.isPending && (e = !0);
+  }
+  if (e)
+    return t();
+  const s = r.map((n) => n.data);
+  return u(s);
+}
+function o(r, e) {
+  switch (r.status) {
+    case "pending":
+      return e.pending();
+    case "error":
+      return e.error(r.error);
+    case "success":
+      return e.success(r.data);
+  }
+}
+function a(r, e) {
+  return o(r, {
+    pending: () => t(),
+    error: (s) => i(s),
+    success: (s) => u(e(s))
+  });
+}
+const d = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  all: c,
+  error: i,
+  map: a,
+  match: o,
+  pending: t,
+  success: u
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  c as all,
+  i as error,
+  a as map,
+  o as match,
+  t as pending,
+  d as remote,
+  u as success
+};

package/dist/index.exports.d.ts

@@ -0,0 +1,4 @@
+export * from './all';
+export * from './map';
+export * from './match';
+export * from './remote';

package/dist/map.d.ts

@@ -0,0 +1,2 @@
+import { Remote } from './remote';
+export declare function map<T, R>(remote: Remote<T>, fn: (data: T) => R): Remote<R>;

package/dist/map.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/match.d.ts

@@ -0,0 +1,7 @@
+import { Remote } from './remote';
+export type MatchCases<T, R> = {
+    pending: () => R;
+    error: (error: Error) => R;
+    success: (data: T) => R;
+};
+export declare function match<T, R>(remote: Remote<T>, cases: MatchCases<T, R>): R;

package/dist/match.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/remote.d.ts

@@ -0,0 +1,25 @@
+export type Remote<T> = {
+    status: 'pending';
+    isPending: true;
+    isError: false;
+    isSuccess: false;
+    error: undefined;
+    data: undefined;
+} | {
+    status: 'error';
+    isPending: false;
+    isError: true;
+    isSuccess: false;
+    error: Error;
+    data: null;
+} | {
+    status: 'success';
+    isPending: false;
+    isError: false;
+    isSuccess: true;
+    error: null;
+    data: T;
+};
+export declare function pending(): Remote<never>;
+export declare function error(error: Error): Remote<never>;
+export declare function success<T>(data: T): Remote<T>;

package/dist/remote.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@axman/remote",
+  "author": "akhmanov",
+  "version": "0.0.1",
+  "description": "Remote data helper types and utilities for TypeScript",
+  "license": "MIT",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/akhmanov/remote-js.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs.js",
+      "default": "./dist/index.es.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "remote"
+  ],
+  "scripts": {
+    "build": "tsc -b && bunx --bun vite build -c vite.config.ts",
+    "fmt": "biome format --write .",
+    "lint": "biome check .",
+    "lint:fix": "biome check --fix ."
+  },
+  "devDependencies": {
+    "@tsconfig/strictest": "^2.0.8",
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.4",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.2.4"
+  }
+}