valync 0.1.0

package/README.md

@@ -0,0 +1,122 @@
+# Valync
+
+**A lightweight, framework-agnostic async data handling library for React & Vue, inspired by Riverpod’s AsyncValue pattern and powered by ts-results-es.**
+
+---
+
+## Features
+
+- Unified async state with `AsyncLoading`, `AsyncError`, and `AsyncData` wrapping `Option<T>`
+- Built-in caching with auto revalidation & manual refresh
+- Supports React & Vue with idiomatic hooks/composables
+- Reactive `watch` dependencies to refetch on data change
+- `setData()` for manual or partial UI updates
+- Uses a strict API response shape for uniform error & data handling
+
+---
+
+## Installation
+
+#### React
+```bash
+pnpm add @epikoder/valync-react @epikoder/valync-core ts-results-es
+```
+
+#### Vue 3
+```bash
+pnpm add @epikoder/valync-vue @epikoder/valync-core ts-results-es
+```
+
+---
+
+## API Overview
+
+### `useValync<T>(key, options?)`
+
+A hook/composable to fetch and manage async data.
+
+- `key: string | Record<string, any>` — Unique cache key or URL.
+- `options?`:
+
+```ts
+{
+  cache?: boolean; // default true, enable/disable caching
+  fetchOnMount?: boolean; // default true, fetch automatically on mount
+  retryCount?: number; // retry count for failed requests
+  onData?: (data: T) => T; // transform data before setting
+  watch?: any[]; // reactive dependencies to trigger refetch
+  initialData?: ApiResponse<T>; // initial server-side data for hydration
+}
+```
+---
+
+### Return tuple
+
+```ts
+const [state, refetch, setData] = useValync<T>(key, options);
+```
+
+## AsyncValue States
+
+```ts
+AsyncLoading<T>;
+AsyncError<T>; // contains error { name, message, code? }
+AsyncData<T>; // contains Option<T>: Some(value) or None
+```
+---
+
+## Example usage
+
+### React
+
+```tsx
+import { useValync, AsyncValue } from "@epikoder/valync-react";
+
+function UserProfile({ userId }: { userId: string }) {
+    const [state, refetch] = useValync<{ name: string; age: number }>(
+        `/api/user/${userId}`,
+        {
+            fetchOnMount: true,
+            retryCount: 2,
+        },
+    );
+
+    return state.when({
+        loading: () => <div>Loading...</div>,
+        error: (err) => <div>Error: {err.message}</div>,
+        data: (opt) =>
+            opt.some ? (
+                <div>
+                    {opt.val.name} ({opt.val.age} years old)
+                </div>
+            ) : (
+                <div>No data available</div>
+            ),
+    });
+}
+```
+
+### Vue 3
+
+```tsx
+import { useValync, AsyncValue } from "@epikoder/valync-vue";
+import { computed } from "vue";
+
+export default {
+    setup() {
+        const [state, refetch] = useValync("/api/user/123", {
+            fetchOnMount: true,
+        });
+
+        const userDisplay = computed(() =>
+            state.value.when({
+                loading: () => "Loading...",
+                error: (e) => `Error: ${e.message}`,
+                data: (opt) => (opt.some ? `${opt.val.name}` : "No user"),
+            }),
+        );
+
+        return { userDisplay, refetch };
+    },
+};
+```

package/dist/core/index.d.ts

@@ -0,0 +1,50 @@
+import { Option } from "ts-results-es";
+export type CacheKey = string | Record<string, any>;
+export declare function normalizeKey(key: CacheKey): string;
+export type ApiResponse<T> = {
+    status: "success";
+    data: T;
+} | {
+    status: "failed";
+    error: {
+        name: string;
+        message: string;
+        code?: number | string;
+    };
+};
+export declare abstract class AsyncValue<T> {
+    abstract when<R>(handlers: {
+        loading: () => R;
+        error: (err: {
+            name: string;
+            message: string;
+            code?: number;
+        }) => R;
+        data: (value: Option<T>) => R;
+    }): R;
+    isLoading(): boolean;
+    isData(): boolean;
+    isError(): boolean;
+}
+export declare class AsyncLoading<T> extends AsyncValue<T> {
+    when<R>(h: any): R;
+}
+export declare class AsyncError<T> extends AsyncValue<T> {
+    error: {
+        name: string;
+        message: string;
+        code?: string | number;
+    };
+    constructor(error: {
+        name: string;
+        message: string;
+        code?: string | number;
+    });
+    when<R>(h: any): R;
+}
+export declare class AsyncData<T> extends AsyncValue<T> {
+    value: Option<T>;
+    constructor(value: Option<T>);
+    when<R>(h: any): R;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAc,MAAM,eAAe,CAAC;AAGnD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAGpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAElD;AAGD,MAAM,MAAM,WAAW,CAAC,CAAC,IACnB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC9B;IACI,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACpE,CAAC;AAGR,8BAAsB,UAAU,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC,CAAC;QACjB,KAAK,EAAE,CAAC,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,CAAC,CAAC;QACpE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;KACjC,GAAG,CAAC;IAEL,SAAS;IAIT,MAAM;IAIN,OAAO;CAGV;AAGD,qBAAa,YAAY,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC;CAGrB;AAGD,qBAAa,UAAU,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAEjC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;gBAAhE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;IAI3E,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC;CAGrB;AAGD,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;gBAAhB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAGnC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC;CAGrB"}

package/dist/core/index.js

@@ -0,0 +1,43 @@
+// Normalize cache key (convert object to stable string)
+export function normalizeKey(key) {
+    return typeof key === "string" ? key : JSON.stringify(key);
+}
+// Base abstract class for async state
+export class AsyncValue {
+    isLoading() {
+        return this instanceof AsyncLoading;
+    }
+    isData() {
+        return this instanceof AsyncData;
+    }
+    isError() {
+        return this instanceof AsyncError;
+    }
+}
+// Represents loading state
+export class AsyncLoading extends AsyncValue {
+    when(h) {
+        return h.loading();
+    }
+}
+// Represents failed state with error
+export class AsyncError extends AsyncValue {
+    constructor(error) {
+        super();
+        this.error = error;
+    }
+    when(h) {
+        return h.error(this.error);
+    }
+}
+// Represents data state—with Some(T) or None
+export class AsyncData extends AsyncValue {
+    constructor(value) {
+        super();
+        this.value = value;
+    }
+    when(h) {
+        return h.data(this.value);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAMA,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,GAAa;IACtC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC/D,CAAC;AAUD,sCAAsC;AACtC,MAAM,OAAgB,UAAU;IAO5B,SAAS;QACL,OAAO,IAAI,YAAY,YAAY,CAAC;IACxC,CAAC;IAED,MAAM;QACF,OAAO,IAAI,YAAY,SAAS,CAAC;IACrC,CAAC;IAED,OAAO;QACH,OAAO,IAAI,YAAY,UAAU,CAAC;IACtC,CAAC;CACJ;AAED,2BAA2B;AAC3B,MAAM,OAAO,YAAgB,SAAQ,UAAa;IAC9C,IAAI,CAAI,CAAM;QACV,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;CACJ;AAED,qCAAqC;AACrC,MAAM,OAAO,UAAc,SAAQ,UAAa;IAC5C,YACW,KAAgE;QAEvE,KAAK,EAAE,CAAC;QAFD,UAAK,GAAL,KAAK,CAA2D;IAG3E,CAAC;IACD,IAAI,CAAI,CAAM;QACV,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACJ;AAED,6CAA6C;AAC7C,MAAM,OAAO,SAAa,SAAQ,UAAa;IAC3C,YAAmB,KAAgB;QAC/B,KAAK,EAAE,CAAC;QADO,UAAK,GAAL,KAAK,CAAW;IAEnC,CAAC;IACD,IAAI,CAAI,CAAM;QACV,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./core";
+export * from "./react";
+export * from "./vue";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./core";
+export * from "./react";
+export * from "./vue";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,12 @@
+import { ApiResponse, AsyncValue } from "../core";
+type UseAsyncOptions<T> = {
+    cache?: boolean;
+    fetchOnMount?: boolean;
+    retryCount?: number;
+    onData?: (data: T) => T;
+    watch?: any[];
+    initialData?: ApiResponse<T>;
+};
+export declare function useValync<T>(key: string | Record<string, any>, options?: UseAsyncOptions<T>): [AsyncValue<T>, () => void, (updater: (prev: T | null) => T) => void];
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEH,WAAW,EACX,UAAU,EAIb,MAAM,SAAS,CAAC;AAEjB,KAAK,eAAe,CAAC,CAAC,IAAI;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IACxB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CAChC,CAAC;AAIF,wBAAgB,SAAS,CAAC,CAAC,EACvB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GACjC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,CAoHvE"}

package/dist/react/index.js

@@ -0,0 +1,118 @@
+import { useEffect, useRef, useState } from "react";
+import { Some, None } from "ts-results-es";
+import { normalizeKey, AsyncLoading, AsyncError, AsyncData, } from "../core";
+const cache = new Map();
+export function useValync(key, options = {}) {
+    const keyStr = normalizeKey(key);
+    const controllerRef = useRef(null);
+    const [state, setState] = useState(() => {
+        if (options.initialData) {
+            return options.initialData.status === "success"
+                ? new AsyncData(Some(options.initialData.data))
+                : new AsyncError(options.initialData.error);
+        }
+        if (options.cache !== false && cache.has(keyStr)) {
+            return cache.get(keyStr);
+        }
+        return new AsyncData(None);
+    });
+    const isClient = typeof window !== "undefined" && typeof AbortController !== "undefined";
+    const doFetch = () => {
+        controllerRef.current?.abort();
+        const ctrl = new AbortController();
+        controllerRef.current = ctrl;
+        if (options.cache !== false && cache.has(keyStr)) {
+            setState(cache.get(keyStr));
+            return;
+        }
+        setState(new AsyncLoading());
+        const attempt = (tries) => {
+            fetch(typeof key === "string" ? key : keyStr, {
+                signal: ctrl.signal,
+            })
+                .then(async (resp) => {
+                let json;
+                try {
+                    json = await resp.json();
+                }
+                catch {
+                    return {
+                        status: "failed",
+                        error: {
+                            name: "ParseError",
+                            message: "Invalid JSON",
+                        },
+                    };
+                }
+                if (!resp.ok || json.status === "failed") {
+                    return {
+                        status: "failed",
+                        error: json.error ?? {
+                            name: "HttpError",
+                            message: resp.statusText,
+                            code: resp.status,
+                        },
+                    };
+                }
+                return json;
+            })
+                .then((res) => {
+                if (ctrl.signal.aborted)
+                    return;
+                if (res.status === "failed")
+                    setState(new AsyncError(res.error));
+                else {
+                    const data = options.onData
+                        ? options.onData(res.data)
+                        : res.data;
+                    const sd = new AsyncData(Some(data));
+                    if (options.cache !== false)
+                        cache.set(keyStr, sd);
+                    setState(sd);
+                }
+            })
+                .catch((err) => {
+                if (ctrl.signal.aborted)
+                    return;
+                if (tries > 0)
+                    return attempt(tries - 1);
+                setState(new AsyncError({
+                    name: "NetworkError",
+                    message: err.message,
+                }));
+            });
+        };
+        attempt(options.retryCount ?? 0);
+    };
+    useEffect(() => {
+        if (!isClient || options.initialData)
+            return;
+        if (options.fetchOnMount !== false)
+            doFetch();
+        return () => controllerRef.current?.abort();
+    }, [keyStr]);
+    if (options.watch) {
+        useEffect(() => {
+            if (isClient)
+                doFetch();
+        }, options.watch);
+    }
+    const refetch = () => {
+        if (isClient)
+            doFetch();
+    };
+    const setData = (updater) => {
+        setState((prev) => {
+            if (!(prev instanceof AsyncData))
+                return prev;
+            const current = prev.value.isSome() ? prev.value.unwrap() : null;
+            const updated = updater(current);
+            const newData = new AsyncData(Some(updated));
+            if (options.cache !== false)
+                cache.set(keyStr, newData);
+            return newData;
+        });
+    };
+    return [state, refetch, setData];
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/dist/vue/index.d.ts

@@ -0,0 +1,36 @@
+import { ApiResponse, AsyncValue } from "../core";
+export declare function useValync<T>(key: string | Record<string, any>, options?: {
+    cache?: boolean;
+    fetchOnMount?: boolean;
+    retryCount?: number;
+    onData?: (data: T) => T;
+    watch?: any[];
+    initialData?: ApiResponse<T>;
+}): readonly [import("vue").Ref<{
+    when: <R>(handlers: {
+        loading: () => R;
+        error: (err: {
+            name: string;
+            message: string;
+            code?: number;
+        }) => R;
+        data: (value: import("ts-results-es").Option<T>) => R;
+    }) => R;
+    isLoading: () => boolean;
+    isData: () => boolean;
+    isError: () => boolean;
+}, AsyncValue<T> | {
+    when: <R>(handlers: {
+        loading: () => R;
+        error: (err: {
+            name: string;
+            message: string;
+            code?: number;
+        }) => R;
+        data: (value: import("ts-results-es").Option<T>) => R;
+    }) => R;
+    isLoading: () => boolean;
+    isData: () => boolean;
+    isError: () => boolean;
+}>, () => void, (updater: (prev: T | null) => T) => void];
+//# sourceMappingURL=index.d.ts.map

package/dist/vue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEH,WAAW,EACX,UAAU,EAIb,MAAM,SAAS,CAAC;AAIjB,wBAAgB,SAAS,CAAC,CAAC,EACvB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,OAAO,GAAE;IACL,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IACxB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CAC3B;;;;;;gBASM,CAAf;;;;;;;;;;;;;gBAAe,CAAf;;;;;;;0BA2F6B,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,WAalD"}

package/dist/vue/index.js

@@ -0,0 +1,112 @@
+import { ref, onMounted, watch } from "vue";
+import { Some, None } from "ts-results-es";
+import { normalizeKey, AsyncLoading, AsyncError, AsyncData, } from "../core";
+const cache = new Map();
+export function useValync(key, options = {}) {
+    const keyStr = normalizeKey(key);
+    const controller = ref();
+    let initialValue;
+    if (options.initialData) {
+        initialValue =
+            options.initialData.status === "success"
+                ? new AsyncData(Some(options.initialData.data))
+                : new AsyncError(options.initialData.error);
+    }
+    else if (options.cache !== false && cache.has(keyStr)) {
+        initialValue = cache.get(keyStr);
+    }
+    else {
+        initialValue = new AsyncData(None);
+    }
+    const state = ref(initialValue);
+    const isClient = typeof window !== "undefined" && typeof AbortController !== "undefined";
+    const doFetch = () => {
+        controller.value?.abort();
+        controller.value = new AbortController();
+        if (options.cache !== false && cache.has(keyStr)) {
+            state.value = cache.get(keyStr);
+            return;
+        }
+        state.value = new AsyncLoading();
+        const attempt = (tries) => {
+            fetch(typeof key === "string" ? key : keyStr, {
+                signal: controller.value.signal,
+            })
+                .then(async (resp) => {
+                let json;
+                try {
+                    json = await resp.json();
+                }
+                catch {
+                    return {
+                        status: "failed",
+                        error: {
+                            name: "ParseError",
+                            message: "Invalid JSON",
+                        },
+                    };
+                }
+                if (!resp.ok || json.status === "failed") {
+                    return {
+                        status: "failed",
+                        error: json.error ?? {
+                            name: "HttpError",
+                            message: resp.statusText,
+                            code: resp.status,
+                        },
+                    };
+                }
+                return json;
+            })
+                .then((res) => {
+                if (controller.value.signal.aborted)
+                    return;
+                if (res.status === "failed")
+                    state.value = new AsyncError(res.error);
+                else {
+                    const data = options.onData
+                        ? options.onData(res.data)
+                        : res.data;
+                    const sd = new AsyncData(Some(data));
+                    if (options.cache !== false)
+                        cache.set(keyStr, sd);
+                    state.value = sd;
+                }
+            })
+                .catch((err) => {
+                if (controller.value.signal.aborted)
+                    return;
+                if (tries > 0)
+                    return attempt(tries - 1);
+                state.value = new AsyncError({
+                    name: "NetworkError",
+                    message: err.message,
+                });
+            });
+        };
+        attempt(options.retryCount ?? 0);
+    };
+    if (isClient && options.fetchOnMount !== false && !options.initialData) {
+        onMounted(doFetch);
+    }
+    if (isClient && options.watch && options.watch.length > 0) {
+        watch(options.watch, doFetch);
+    }
+    const refetch = () => {
+        if (isClient)
+            doFetch();
+    };
+    const setData = (updater) => {
+        const currentVal = state.value instanceof AsyncData
+            ? state.value.value.isSome()
+                ? state.value.value.unwrap()
+                : null
+            : null;
+        const newVal = new AsyncData(Some(updater(currentVal)));
+        if (options.cache !== false)
+            cache.set(keyStr, newVal);
+        state.value = newVal;
+    };
+    return [state, refetch, setData];
+}
+//# sourceMappingURL=index.js.map

package/dist/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "valync",
+  "version": "0.1.0",
+  "main": "dist/core/index.js",
+  "types": "dist/core/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/core/index.js",
+      "types": "./dist/core/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    },
+    "./vue": {
+      "import": "./dist/vue/index.js",
+      "types": "./dist/vue/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ts-results-es": "^5.0.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.1.8",
+    "jest": "^30.0.2",
+    "ts-jest": "^29.4.0"
+  },
+  "peerDependencies": {
+    "vue": "^3.0.0",
+    "react": "^18.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "jest"
+  }
+}