@snail-js/api 0.1.27 → 1.0.0

package/dist/utils/download.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Trigger a browser download from a URL, without ever holding the bytes.
+ *
+ * ## Why the library does not download for you
+ *
+ * The obvious design — `responseType: "blob"`, `await`, then an object URL — is
+ * wrong for anything but a small file. It forces the whole payload through
+ * JavaScript memory, so a 200 MB export becomes a 200 MB `Blob` plus a second copy
+ * when the object URL is created, with no progress reporting and no way to resume.
+ * On a slow connection the tab simply runs out of memory, and the user has no idea
+ * whether anything is happening.
+ *
+ * The design that scales is the one every large site already uses: the server
+ * mints a short-lived download URL, and the browser fetches it natively. That gives
+ * you a real progress bar in the browser's own download manager, resume support,
+ * streaming to disk instead of RAM, and a download that survives navigation. All
+ * this library does is ask for the URL and then click a link.
+ *
+ * ```ts
+ * @Api("/report")
+ * class ReportApi {
+ *   /** Ask the server to prepare the export; it answers with a temp URL. *\/
+ *   @Post("/export")
+ *   create(@Data() query: ReportQuery): Promise<{ url: string; filename: string }> {
+ *     return null!;
+ *   }
+ * }
+ *
+ * const { url, filename } = (await reportApi.create(query).send()).data;
+ * triggerDownload(url, { filename });
+ * ```
+ *
+ * ## When you genuinely need the blob
+ *
+ * If the response must be transformed, or the backend cannot issue a URL, request
+ * `responseType: "blob"` and use {@link triggerBlobDownload} instead — it accepts
+ * an already-materialised `Blob` and takes care of revoking the object URL.
+ */
+/** Options accepted by {@link triggerDownload}. */
+export interface TriggerDownloadOptions {
+    /**
+     * Filename to suggest to the browser.
+     *
+     * A cross-origin `href` ignores this — the browser honours the server's
+     * `Content-Disposition` instead, because letting a page rename a cross-origin
+     * download would be a security problem. For a cross-origin file, make the server
+     * send the name in that header.
+     */
+    filename?: string;
+    /** Open in a new tab instead of downloading. Defaults to `false`. */
+    openInNewTab?: boolean;
+    /**
+     * Where to attach the temporary anchor.
+     *
+     * Needed only for the old Firefox behaviour where an anchor that was never in the
+     * document ignores `click()`. Defaults to `document.body`.
+     */
+    container?: HTMLElement;
+    /** `referrerpolicy` for the navigation. */
+    referrerPolicy?: string;
+}
+/** Result of a successful {@link triggerDownload}. */
+export interface TriggerDownloadResult {
+    /** The URL that was navigated to. */
+    url: string;
+    /** The filename the browser was asked to use, when one was supplied. */
+    filename: string | undefined;
+}
+/**
+ * Navigate the browser to `url` as a download.
+ *
+ * Works for a same-origin path, a cross-origin absolute URL and a `blob:` object
+ * URL alike. Throws when there is no DOM, because silently doing nothing is the
+ * worst possible outcome for a function whose entire job is a side effect.
+ */
+export declare function triggerDownload(url: string, options?: TriggerDownloadOptions): TriggerDownloadResult;
+/**
+ * Download an in-memory `Blob` by handing the browser an object URL.
+ *
+ * Use this only when the bytes are already in hand. The object URL is revoked on
+ * the next macrotask rather than immediately: revoking it in the same tick races
+ * the navigation in Safari and Firefox, and the download silently never starts.
+ * The cost is a short-lived duplicate in memory, which is why {@link triggerDownload}
+ * remains the recommended path.
+ */
+export declare function triggerBlobDownload(blob: Blob, options?: TriggerDownloadOptions): TriggerDownloadResult;
+/**
+ * Build a filename from a `Content-Disposition` header.
+ *
+ * Servers send the header, not a JSON field, and parsing it is fiddlier than it
+ * looks: `filename*` (RFC 5987, percent-encoded UTF-8) wins over `filename`, which
+ * may itself be quoted. Returns `undefined` when the header is absent or names
+ * nothing, so a caller can fall back to its own default instead of writing a
+ * literal `"undefined"` to disk.
+ */
+export declare function filenameFromDisposition(header: string | undefined): string | undefined;
+//# sourceMappingURL=download.d.ts.map

package/dist/utils/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/utils/download.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IAExB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IAEZ,wEAAwE;IACxE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAuCvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAcvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAqBtF"}

package/dist/utils/emitter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Minimal typed event emitter.
+ *
+ * Used for the `SnailMethod` event surface (`onSuccess`, `onError`, …). It is
+ * deliberately tiny: no wildcard events, no `once`, no async scheduling.
+ */
+export declare class Emitter<Events extends Record<string, unknown>> {
+    private readonly listeners;
+    /**
+     * Register a listener.
+     *
+     * @returns an unsubscribe function — the ergonomic alternative to keeping a
+     * reference around just to call {@link off}.
+     */
+    on<K extends keyof Events>(type: K, listener: (payload: Events[K]) => void): () => void;
+    /** Remove a previously registered listener. */
+    off<K extends keyof Events>(type: K, listener: (payload: Events[K]) => void): void;
+    /** Number of listeners registered for `type`. */
+    count<K extends keyof Events>(type: K): number;
+    /**
+     * Invoke every listener for `type`.
+     *
+     * A throwing listener must not derail the request lifecycle: the promise from
+     * `send()` has already settled correctly, and one broken UI callback has no
+     * business turning a successful request into a failure. The other listeners for
+     * the same event still run.
+     *
+     * The error is therefore *reported*, not rethrown. Rethrowing from a microtask
+     * was the obvious alternative and is wrong: in Node it becomes an uncaught
+     * exception, so a throwing toast handler could take the process down.
+     */
+    emit<K extends keyof Events>(type: K, payload: Events[K]): void;
+    /** Drop every listener, optionally only for one event type. */
+    clear<K extends keyof Events>(type?: K): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/utils/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/utils/emitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,OAAO,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwD;IAElF;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EACvB,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GACrC,MAAM,IAAI,CAQZ;IAED,+CAA+C;IAC/C,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAEjF;IAED,iDAAiD;IACjD,KAAK,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAE7C;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAW9D;IAED,+DAA+D;IAC/D,KAAK,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAM5C;CACF"}

package/dist/utils/index.d.ts

@@ -1 +1,6 @@
-export * from './function';
+export { Emitter } from "./emitter.js";
+export { filenameFromDisposition, triggerBlobDownload, triggerDownload, type TriggerDownloadOptions, type TriggerDownloadResult } from "./download.js";
+export { isBinaryBody, isBrowser, isDefined, isFunction, isObject, isPlainObject, isPromise } from "./is.js";
+export { deepMerge, deferred, noop, omit, omitUndefined, pick, resolveValue, tryCatch, type DeepPartial } from "./object.js";
+export { buildRequestURL, capitalize, isAbsoluteURL, joinURL, pathParamNames, replacePathParams, shortHash, stableStringify, stripQuery } from "./url.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,EACb,SAAS,EACV,MAAM,MAAM,CAAC;AACd,OAAO,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,aAAa,EACb,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,UAAU,EACX,MAAM,OAAO,CAAC"}

package/dist/utils/is.d.ts

@@ -0,0 +1,22 @@
+/** Runtime type predicates shared across the library. */
+/** `true` for a non-null object (including arrays, dates, class instances). */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * `true` for a plain object literal — not an array, `Date`, `Map`, `FormData`,
+ * `Blob`, class instance, and so on.
+ *
+ * Used to decide whether a `@Query()` / `@Data()` argument should be spread
+ * into the outgoing payload.
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, any>;
+/** `true` for a callable value. */
+export declare function isFunction(value: unknown): value is (...args: any[]) => any;
+/** `true` for a thenable. */
+export declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
+/** `true` when `value` is neither `null` nor `undefined`. */
+export declare function isDefined<T>(value: T | null | undefined): value is T;
+/** `true` when a `Response`-like body should be passed through untouched. */
+export declare function isBinaryBody(value: unknown): boolean;
+/** `true` when the code is executing in a DOM-capable browser. */
+export declare function isBrowser(): boolean;
+//# sourceMappingURL=is.d.ts.map

package/dist/utils/is.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is.d.ts","sourceRoot":"","sources":["../../src/utils/is.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAI1E;AAED,mCAAmC;AACnC,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAE3E;AAED,6BAA6B;AAC7B,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAI1E;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAEpE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOpD;AAED,kEAAkE;AAClE,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/utils/object.d.ts

@@ -0,0 +1,44 @@
+/** Return a copy of `source` without the listed keys. */
+export declare function omit<T extends Record<string, any>, K extends keyof T>(source: T, keys: readonly K[]): Omit<T, K>;
+/** Return a copy of `source` containing only the listed keys. */
+export declare function pick<T extends Record<string, any>, K extends keyof T>(source: T, keys: readonly K[]): Pick<T, K>;
+/** Drop keys whose value is `undefined`. `null` is preserved deliberately. */
+export declare function omitUndefined<T extends Record<string, any>>(source: T): T;
+/** A deeply optional version of `T`, for merge inputs. */
+export type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends readonly unknown[] ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/**
+ * Recursively merge plain objects.
+ *
+ * Accepts **deeply partial** sources, so
+ * `deepMerge({ a: { b: 1, c: 2 } }, { a: { c: 3 } })` type-checks without a cast —
+ * which is the whole point of overriding one nested default.
+ *
+ * Arrays are replaced, not concatenated: concatenating them would make it
+ * impossible for a method-level option to override a server-level list.
+ */
+export declare function deepMerge<T extends Record<string, any>>(...sources: Array<DeepPartial<T> | undefined | null>): T;
+/**
+ * Resolve a possibly-functional option value.
+ *
+ * Options such as `@Header(...)` often need values computed per request, so most
+ * option fields accept `T | ((ctx) => T)`.
+ */
+export declare function resolveValue<T, A>(value: T | ((arg: A) => T), arg: A): T;
+/** Run `fn`, returning `fallback` if it throws. */
+export declare function tryCatch<T>(fn: () => T, fallback: T): T;
+/**
+ * Create a promise together with its resolve/reject handles.
+ *
+ * Used by strategies to hand a "ready" promise out before the underlying
+ * request is actually started.
+ */
+export declare function deferred<T = void>(): {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: unknown) => void;
+};
+/** A function that does nothing — used as a default callback. */
+export declare function noop(): void;
+//# sourceMappingURL=object.d.ts.map

package/dist/utils/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/utils/object.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACnE,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,SAAS,CAAC,EAAE,GACjB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAIZ;AAED,iEAAiE;AACjE,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACnE,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,SAAS,CAAC,EAAE,GACjB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMZ;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAMzE;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAC5C,CAAC,CAAC,CAAC,CAAC,GACJ,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC;CACX,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,GAAG,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GACnD,CAAC,CAgBH;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAExE;AAED,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAMvD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,IAAI,KAAK;IACpC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC7C,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAQA;AAED,iEAAiE;AACjE,wBAAgB,IAAI,IAAI,IAAI,CAE3B"}

package/dist/utils/url.d.ts

@@ -0,0 +1,44 @@
+/** Uppercase the first character, leaving the rest untouched. */
+export declare function capitalize(value: string): string;
+/** `true` when the url carries its own scheme or protocol-relative prefix. */
+export declare function isAbsoluteURL(url: string): boolean;
+/**
+ * Join url segments into one path, normalising the slashes between them.
+ *
+ * An absolute `segment` wins outright, matching axios' `baseURL` semantics.
+ *
+ * ```ts
+ * joinURL("/api/", "/user/", "/list") // "/api/user/list"
+ * joinURL("/api", "https://cdn.x/y")  // "https://cdn.x/y"
+ * ```
+ */
+export declare function joinURL(...segments: Array<string | undefined | null>): string;
+/** Names of every `:placeholder` present in a route template. */
+export declare function pathParamNames(route: string): string[];
+/**
+ * Substitute `:placeholder` segments with values.
+ *
+ * Values are URL-encoded. A placeholder with no value throws, because silently
+ * leaving `:id` in a request path produces a confusing 404 far from the cause —
+ * the pre-rewrite code logged to `console.error` and then threw anyway.
+ */
+export declare function replacePathParams(route: string, values: Record<string, unknown>, onMissing?: (name: string) => never): string;
+/** Build a full url, appending absolute urls verbatim. */
+export declare function buildRequestURL(baseURL: string, url: string): string;
+/** Strip the query string and hash, for logging. */
+export declare function stripQuery(url: string): string;
+/**
+ * Deterministic, recursively stable JSON serialisation.
+ *
+ * Object keys are sorted so two logically identical payloads always produce the
+ * same string — essential for cache keys and for request de-duplication.
+ */
+export declare function stableStringify(value: unknown): string;
+/**
+ * 32-bit FNV-1a hash rendered as base36.
+ *
+ * Cheap, allocation-light and stable across runs — used to turn a long request
+ * signature into a compact in-memory cache key. It is *not* a security hash.
+ */
+export declare function shortHash(input: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAYD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,MAAM,CAqB7E;AAKD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,GAClC,MAAM,CASR;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAqCtD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C"}

package/package.json

@@ -1,39 +1,102 @@
 {
   "name": "@snail-js/api",
-  "version": "0.1.27",
-  "description": "Http Request with Decorators Api, build on axios",
-  "type": "module",
-  "main": "./src/index.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/snail-api.js",
-      "require": "./dist/snail-api.umd.cjs",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "clean:dist": "rimraf ./dist",
-    "build": "pnpm run clean:dist && vite build && pnpm run build:type",
-    "build:type": "vue-tsc -p tsconfig.build.json --composite false --declaration --emitDeclarationOnly",
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
+  "version": "1.0.0",
+  "description": "Decorator-driven, plugin-first HTTP client built on axios. Nest.js-style decorators, an everything-is-a-plugin core and alova-style request strategies.",
   "keywords": [
-    "Decorators",
+    "axios",
+    "decorators",
+    "request",
     "api",
-    "Request",
-    "axios"
+    "http",
+    "sse",
+    "websocket",
+    "typescript",
+    "vue",
+    "react"
   ],
-  "author": "",
   "license": "MIT",
-  "peerDependencies": {
-    "axios": "^1.8.3"
+  "type": "module",
+  "sideEffects": [
+    "./dist/strategies/index.js",
+    "./dist/strategies/plain.js",
+    "./dist/strategies/react.js"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "import": "./dist/plugins/index.js"
+    },
+    "./plugins/vue": {
+      "types": "./dist/plugins/vue/index.d.ts",
+      "import": "./dist/plugins/vue/index.js"
+    },
+    "./plugins/react": {
+      "types": "./dist/plugins/react/index.d.ts",
+      "import": "./dist/plugins/react/index.js"
+    },
+    "./strategies": {
+      "types": "./dist/strategies/index.d.ts",
+      "import": "./dist/strategies/index.js"
+    },
+    "./strategies/plain": {
+      "types": "./dist/strategies/plain.d.ts",
+      "import": "./dist/strategies/plain.js"
+    },
+    "./strategies/react": {
+      "types": "./dist/strategies/react.d.ts",
+      "import": "./dist/strategies/react.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
+    "dist",
     "README.md",
-    "README_EN.md",
-    "dist"
+    "LICENSE"
   ],
-  "dependencies": {
-    "reflect-metadata": "^0.2.2"
+  "scripts": {
+    "build": "node ./scripts/build.mjs",
+    "build:types": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node ./scripts/vitest-runner.mjs run",
+    "test:watch": "node ./scripts/vitest-runner.mjs",
+    "test:cov": "node ./scripts/vitest-runner.mjs run --coverage",
+    "verify": "node ./scripts/verify-dist.mjs"
+  },
+  "peerDependencies": {
+    "axios": "^1.20.0",
+    "react": ">=18.0.0",
+    "vue": ">=3.4.0",
+    "zod": ">=3.23.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "@types/react": "19.2.6",
+    "@vitest/coverage-v8": "5.0.1",
+    "axios": "1.20.0",
+    "axios-mock-adapter": "2.1.0",
+    "react": "19.2.0",
+    "typescript": "7.0.2",
+    "vite": "8.3.0",
+    "vitest": "5.0.1",
+    "vue": "3.5.24",
+    "zod": "4.6.5"
   }
 }