@robot-admin/request-core 0.2.0 → 0.4.0

package/dist/types-CUyibJZX.d.ts

@@ -0,0 +1,197 @@
+import { Ref, ShallowRef, ComputedRef } from 'vue';
+import { f as RequestClient, j as RequestError } from './types-BVJhlSuh.js';
+
+type DataRecord = object;
+interface TableColumn<T = object> {
+    title?: string;
+    key?: string;
+    render?: (row: T, index: number) => unknown;
+    width?: number | string;
+    minWidth?: number | string;
+    maxWidth?: number | string;
+    fixed?: "left" | "right";
+    align?: "left" | "center" | "right";
+    ellipsis?: boolean | object;
+    sorter?: boolean | ((a: T, b: T) => number) | string;
+    filter?: boolean | ((value: string, row: T) => boolean);
+    [key: string]: unknown;
+}
+interface ApiEndpoints {
+    list: string;
+    get?: string;
+    create?: string;
+    update?: string;
+    remove?: string;
+    batchRemove?: string;
+}
+interface CrudMessageApi {
+    success(message: string): unknown;
+    error(message: string): unknown;
+    warning(message: string): unknown;
+    info?(message: string): unknown;
+}
+interface CrudDialogApi {
+    warning(options: unknown): unknown;
+    error(options: unknown): unknown;
+    success(options: unknown): unknown;
+    info(options: unknown): unknown;
+}
+interface CrudUiAdapter {
+    message: CrudMessageApi;
+    dialog?: CrudDialogApi;
+}
+interface TablePageState {
+    current: number;
+    size: number;
+}
+interface TableQueryContext<Filters, Sort> {
+    page: number;
+    pageSize: number;
+    paginationEnabled: boolean;
+    filters: Readonly<Filters>;
+    sort: Readonly<Sort> | null;
+    signal: AbortSignal;
+}
+interface TableQueryResult<T> {
+    items: T[];
+    total: number;
+}
+interface TableMutationContext {
+    signal: AbortSignal;
+}
+interface CrudMutations<T> {
+    create?: (row: T, context: TableMutationContext) => Promise<unknown>;
+    update?: (row: T, context: TableMutationContext) => Promise<unknown>;
+    remove?: (row: T, context: TableMutationContext) => Promise<unknown>;
+    batchRemove?: (rows: T[], context: TableMutationContext) => Promise<unknown>;
+    get?: (row: T, context: TableMutationContext) => Promise<T>;
+}
+interface ActionContext<T> {
+    data: T[];
+    index: number;
+    page: TablePageState;
+    paginationEnabled: boolean;
+    message: CrudMessageApi;
+    dialog: CrudDialogApi;
+    refresh: () => Promise<void>;
+}
+interface CustomAction<T> {
+    key: string;
+    label: string;
+    icon: string;
+    type?: "default" | "primary" | "info" | "success" | "warning" | "error";
+    handler: (row: T, context: ActionContext<T>) => void | Promise<void>;
+}
+interface DetailItem {
+    label: string;
+    key: string;
+    type?: string;
+    span?: number;
+    formatter?: (value: unknown) => string;
+    tagType?: string;
+    [key: string]: unknown;
+}
+interface DetailSection {
+    title: string;
+    columns: number;
+    items: DetailItem[];
+}
+interface DetailConfig {
+    sections: DetailSection[];
+}
+interface UseTableCrudConfig<T extends DataRecord, Filters extends object = Record<string, unknown>, Sort extends object = Record<string, unknown>> {
+    /** Legacy string endpoints. Prefer query/mutations for typed applications. */
+    api?: ApiEndpoints;
+    query?: (context: TableQueryContext<Filters, Sort>) => Promise<TableQueryResult<T> | unknown>;
+    mutations?: CrudMutations<T>;
+    client?: RequestClient;
+    columns?: TableColumn<T>[];
+    customActions?: CustomAction<T>[];
+    detail?: DetailConfig;
+    idKey?: keyof T;
+    defaultPageSize?: number;
+    defaultPaginationEnabled?: boolean;
+    initialFilters?: Filters;
+    initialSort?: Sort | null;
+    createNewRow?: () => T;
+    extractListData?: (response: unknown) => TableQueryResult<T>;
+    /** true keeps the historical immediate behavior; "mounted" is SSR-safe. */
+    autoLoad?: boolean | "mounted";
+    refreshAfterMutation?: boolean;
+    batchConcurrency?: number;
+    ui?: CrudUiAdapter;
+    detailTitle?: (row: T) => string;
+    onError?: (error: RequestError, operation: string) => void | Promise<void>;
+}
+interface DetailModal<T> {
+    visible: Ref<boolean>;
+    data: Ref<T | null>;
+    title: Ref<string>;
+    show: (row: T) => void;
+    close: () => void;
+}
+interface TableActionResult<T = unknown> {
+    data: T | null;
+    error: RequestError | null;
+}
+interface TableActions<T> {
+    edit?: (row: T) => Promise<TableActionResult<T>>;
+    delete?: (row: T) => Promise<TableActionResult<{
+        success: true;
+    }>>;
+    detail?: (row: T) => Promise<TableActionResult<T | null>>;
+    custom?: Array<{
+        key: string;
+        label: string;
+        icon: string;
+        type: CustomAction<T>["type"];
+        onClick: (row: T, index: number) => void | Promise<void>;
+    }>;
+}
+interface UseTableCrudReturn<T extends DataRecord, Filters extends object = Record<string, unknown>, Sort extends object = Record<string, unknown>> {
+    data: ShallowRef<T[]>;
+    /** Preferred semantic alias of data. */
+    rows: ShallowRef<T[]>;
+    loading: ComputedRef<boolean>;
+    isInitialLoading: ComputedRef<boolean>;
+    isRefreshing: ComputedRef<boolean>;
+    creating: ComputedRef<boolean>;
+    updating: ComputedRef<boolean>;
+    removing: ComputedRef<boolean>;
+    total: Ref<number>;
+    error: ShallowRef<RequestError | null>;
+    lastUpdated: Ref<number | null>;
+    columns: ComputedRef<TableColumn<T>[]>;
+    actions: ComputedRef<TableActions<T>>;
+    tableRef: Ref<unknown>;
+    page: TablePageState;
+    filters: Ref<Filters>;
+    sort: Ref<Sort | null>;
+    paginationEnabled: Ref<boolean>;
+    pagination: ComputedRef<false | {
+        enabled: true;
+        page: number;
+        pageSize: number;
+        itemCount: number;
+    }>;
+    refresh: () => Promise<void>;
+    reload: () => Promise<void>;
+    search: (next?: Partial<Filters>) => Promise<void>;
+    resetSearch: () => Promise<void>;
+    setSort: (next: Sort | null) => Promise<void>;
+    create: (row: T) => Promise<void>;
+    save: (row: T) => Promise<void>;
+    remove: (row: T) => Promise<void>;
+    batchRemove: (rows: T[]) => Promise<void>;
+    getDetail: (row: T) => Promise<T | null>;
+    createDraft: () => T;
+    cancel: () => void;
+    dispose: () => void;
+    handleCancel: () => Promise<void>;
+    handlePaginationChange: (page: number, pageSize: number) => void;
+    handleRowDelete: (row: T, index?: number) => void;
+    detail: DetailModal<T>;
+    detailConfig?: DetailConfig;
+}
+
+export type { ActionContext as A, CustomAction as C, DataRecord as D, TableColumn as T, UseTableCrudConfig as U, ApiEndpoints as a, DetailConfig as b, DetailItem as c, DetailModal as d, DetailSection as e, UseTableCrudReturn as f, CrudDialogApi as g, CrudMessageApi as h, CrudMutations as i, CrudUiAdapter as j, TableQueryContext as k, TableQueryResult as l };

package/dist/vue.cjs

@@ -0,0 +1,93 @@
+'use strict';
+
+var chunkKHI6XQRN_cjs = require('./chunk-KHI6XQRN.cjs');
+var chunkJGFRUAZT_cjs = require('./chunk-JGFRUAZT.cjs');
+var vue = require('vue');
+
+function useRequest(executor, options = {}) {
+  const data = vue.shallowRef(options.initialData);
+  const error = vue.shallowRef(null);
+  const pending = vue.shallowRef(0);
+  const loading = vue.computed(() => pending.value > 0);
+  let active = null;
+  const controllers = /* @__PURE__ */ new Set();
+  let sequence = 0;
+  const cancel = (reason) => {
+    sequence += 1;
+    for (const controller of controllers) controller.abort(reason);
+    controllers.clear();
+    active = null;
+  };
+  const run = async (...args) => {
+    const concurrency = options.concurrency ?? "takeLatest";
+    if (active && concurrency === "takeFirst") return active.promise;
+    if (active && concurrency === "takeLatest") active.controller.abort();
+    const id = ++sequence;
+    const controller = new AbortController();
+    controllers.add(controller);
+    if (!options.keepPreviousData) data.value = void 0;
+    error.value = null;
+    pending.value += 1;
+    const promise = executor({ signal: controller.signal }, ...args);
+    active = { controller, promise, id };
+    try {
+      const result = await promise;
+      if (id === sequence || concurrency === "takeFirst") {
+        data.value = result;
+        try {
+          await options.onSuccess?.(result);
+        } catch {
+        }
+      }
+      return result;
+    } catch (cause) {
+      const normalized = chunkJGFRUAZT_cjs.normalizeRequestError(cause);
+      if (!chunkJGFRUAZT_cjs.isCanceledError(normalized) && id === sequence) {
+        error.value = normalized;
+        try {
+          await options.onError?.(normalized);
+        } catch {
+        }
+      }
+      throw normalized;
+    } finally {
+      pending.value = Math.max(0, pending.value - 1);
+      controllers.delete(controller);
+      if (active?.id === id) active = null;
+    }
+  };
+  const reset = () => {
+    cancel();
+    data.value = options.initialData;
+    error.value = null;
+  };
+  if (vue.getCurrentScope()) vue.onScopeDispose(() => cancel());
+  if (options.immediate) {
+    void run(...options.immediateArgs ?? []).catch(() => void 0);
+  }
+  return { data, error, loading, run, cancel, reset };
+}
+
+Object.defineProperty(exports, "REQUEST_CLIENT_KEY", {
+  enumerable: true,
+  get: function () { return chunkKHI6XQRN_cjs.REQUEST_CLIENT_KEY; }
+});
+Object.defineProperty(exports, "createRequestPlugin", {
+  enumerable: true,
+  get: function () { return chunkKHI6XQRN_cjs.createRequestPlugin; }
+});
+Object.defineProperty(exports, "provideRequestClient", {
+  enumerable: true,
+  get: function () { return chunkKHI6XQRN_cjs.provideRequestClient; }
+});
+Object.defineProperty(exports, "useRequestClient", {
+  enumerable: true,
+  get: function () { return chunkKHI6XQRN_cjs.useRequestClient; }
+});
+Object.defineProperty(exports, "useTableCrud", {
+  enumerable: true,
+  get: function () { return chunkKHI6XQRN_cjs.useTableCrud; }
+});
+exports.useRequest = useRequest;
+//# sourceMappingURL=vue.cjs.map
+//# sourceMappingURL=vue.cjs.map

package/dist/vue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vue/useRequest.ts"],"names":["shallowRef","computed","normalizeRequestError","isCanceledError","getCurrentScope","onScopeDispose"],"mappings":"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","file":"vue.cjs","sourcesContent":["import {\n  computed,\n  getCurrentScope,\n  onScopeDispose,\n  shallowRef,\n  type ComputedRef,\n  type ShallowRef,\n} from \"vue\";\nimport type { ConcurrencyPolicy } from \"../axios/types\";\nimport {\n  isCanceledError,\n  normalizeRequestError,\n  type RequestError,\n} from \"../client/errors\";\n\nexport interface UseRequestContext {\n  signal: AbortSignal;\n}\n\nexport interface UseRequestOptions<T, Args extends unknown[]> {\n  initialData?: T;\n  immediate?: boolean;\n  immediateArgs?: Args;\n  concurrency?: Extract<ConcurrencyPolicy, \"allow\" | \"takeLatest\" | \"takeFirst\">;\n  keepPreviousData?: boolean;\n  onSuccess?: (data: T) => void | Promise<void>;\n  onError?: (error: RequestError) => void | Promise<void>;\n}\n\nexport interface UseRequestReturn<T, Args extends unknown[]> {\n  data: ShallowRef<T | undefined>;\n  error: ShallowRef<RequestError | null>;\n  loading: ComputedRef<boolean>;\n  run: (...args: Args) => Promise<T>;\n  cancel: (reason?: unknown) => void;\n  reset: () => void;\n}\n\nexport function useRequest<T, Args extends unknown[] = []>(\n  executor: (context: UseRequestContext, ...args: Args) => Promise<T>,\n  options: UseRequestOptions<T, Args> = {},\n): UseRequestReturn<T, Args> {\n  const data = shallowRef<T | undefined>(options.initialData);\n  const error = shallowRef<RequestError | null>(null);\n  const pending = shallowRef(0);\n  const loading = computed(() => pending.value > 0);\n  let active: { controller: AbortController; promise: Promise<T>; id: number } | null =\n    null;\n  const controllers = new Set<AbortController>();\n  let sequence = 0;\n\n  const cancel = (reason?: unknown): void => {\n    sequence += 1;\n    for (const controller of controllers) controller.abort(reason);\n    controllers.clear();\n    active = null;\n  };\n\n  const run = async (...args: Args): Promise<T> => {\n    const concurrency = options.concurrency ?? \"takeLatest\";\n    if (active && concurrency === \"takeFirst\") return active.promise;\n    if (active && concurrency === \"takeLatest\") active.controller.abort();\n\n    const id = ++sequence;\n    const controller = new AbortController();\n    controllers.add(controller);\n    if (!options.keepPreviousData) data.value = undefined;\n    error.value = null;\n    pending.value += 1;\n\n    const promise = executor({ signal: controller.signal }, ...args);\n    active = { controller, promise, id };\n    try {\n      const result = await promise;\n      if (id === sequence || concurrency === \"takeFirst\") {\n        data.value = result;\n        try {\n          await options.onSuccess?.(result);\n        } catch {\n          // Lifecycle callbacks must not turn a successful request into a failure.\n        }\n      }\n      return result;\n    } catch (cause) {\n      const normalized = normalizeRequestError(cause);\n      if (!isCanceledError(normalized) && id === sequence) {\n        error.value = normalized;\n        try {\n          await options.onError?.(normalized);\n        } catch {\n          // Preserve the original request error if an observer fails.\n        }\n      }\n      throw normalized;\n    } finally {\n      pending.value = Math.max(0, pending.value - 1);\n      controllers.delete(controller);\n      if (active?.id === id) active = null;\n    }\n  };\n\n  const reset = (): void => {\n    cancel();\n    data.value = options.initialData;\n    error.value = null;\n  };\n\n  if (getCurrentScope()) onScopeDispose(() => cancel());\n  if (options.immediate) {\n    void run(...(options.immediateArgs ?? ([] as unknown as Args))).catch(() => undefined);\n  }\n\n  return { data, error, loading, run, cancel, reset };\n}\n"]}

package/dist/vue.d.cts

@@ -0,0 +1,38 @@
+import { InjectionKey, App, ShallowRef, ComputedRef } from 'vue';
+import { f as RequestClient, d as ConcurrencyPolicy, j as RequestError } from './types-BVJhlSuh.cjs';
+import { D as DataRecord, U as UseTableCrudConfig, f as UseTableCrudReturn } from './types-BRDRqYFs.cjs';
+export { A as ActionContext, a as ApiEndpoints, g as CrudDialogApi, h as CrudMessageApi, i as CrudMutations, j as CrudUiAdapter, C as CustomAction, b as DetailConfig, c as DetailItem, d as DetailModal, e as DetailSection, T as TableColumn, k as TableQueryContext, l as TableQueryResult } from './types-BRDRqYFs.cjs';
+import 'axios';
+
+declare const REQUEST_CLIENT_KEY: InjectionKey<RequestClient>;
+declare function createRequestPlugin(client: RequestClient): {
+    install(app: App): void;
+};
+declare function provideRequestClient(client: RequestClient): RequestClient;
+declare function useRequestClient(optional?: boolean): RequestClient | undefined;
+
+interface UseRequestContext {
+    signal: AbortSignal;
+}
+interface UseRequestOptions<T, Args extends unknown[]> {
+    initialData?: T;
+    immediate?: boolean;
+    immediateArgs?: Args;
+    concurrency?: Extract<ConcurrencyPolicy, "allow" | "takeLatest" | "takeFirst">;
+    keepPreviousData?: boolean;
+    onSuccess?: (data: T) => void | Promise<void>;
+    onError?: (error: RequestError) => void | Promise<void>;
+}
+interface UseRequestReturn<T, Args extends unknown[]> {
+    data: ShallowRef<T | undefined>;
+    error: ShallowRef<RequestError | null>;
+    loading: ComputedRef<boolean>;
+    run: (...args: Args) => Promise<T>;
+    cancel: (reason?: unknown) => void;
+    reset: () => void;
+}
+declare function useRequest<T, Args extends unknown[] = []>(executor: (context: UseRequestContext, ...args: Args) => Promise<T>, options?: UseRequestOptions<T, Args>): UseRequestReturn<T, Args>;
+
+declare function useTableCrud<T extends DataRecord, Filters extends object = Record<string, unknown>, Sort extends object = Record<string, unknown>>(config: UseTableCrudConfig<T, Filters, Sort>): UseTableCrudReturn<T, Filters, Sort>;
+
+export { DataRecord, REQUEST_CLIENT_KEY, type UseRequestContext, type UseRequestOptions, type UseRequestReturn, UseTableCrudConfig, UseTableCrudReturn, createRequestPlugin, provideRequestClient, useRequest, useRequestClient, useTableCrud };

package/dist/vue.d.ts

@@ -0,0 +1,38 @@
+import { InjectionKey, App, ShallowRef, ComputedRef } from 'vue';
+import { f as RequestClient, d as ConcurrencyPolicy, j as RequestError } from './types-BVJhlSuh.js';
+import { D as DataRecord, U as UseTableCrudConfig, f as UseTableCrudReturn } from './types-CUyibJZX.js';
+export { A as ActionContext, a as ApiEndpoints, g as CrudDialogApi, h as CrudMessageApi, i as CrudMutations, j as CrudUiAdapter, C as CustomAction, b as DetailConfig, c as DetailItem, d as DetailModal, e as DetailSection, T as TableColumn, k as TableQueryContext, l as TableQueryResult } from './types-CUyibJZX.js';
+import 'axios';
+
+declare const REQUEST_CLIENT_KEY: InjectionKey<RequestClient>;
+declare function createRequestPlugin(client: RequestClient): {
+    install(app: App): void;
+};
+declare function provideRequestClient(client: RequestClient): RequestClient;
+declare function useRequestClient(optional?: boolean): RequestClient | undefined;
+
+interface UseRequestContext {
+    signal: AbortSignal;
+}
+interface UseRequestOptions<T, Args extends unknown[]> {
+    initialData?: T;
+    immediate?: boolean;
+    immediateArgs?: Args;
+    concurrency?: Extract<ConcurrencyPolicy, "allow" | "takeLatest" | "takeFirst">;
+    keepPreviousData?: boolean;
+    onSuccess?: (data: T) => void | Promise<void>;
+    onError?: (error: RequestError) => void | Promise<void>;
+}
+interface UseRequestReturn<T, Args extends unknown[]> {
+    data: ShallowRef<T | undefined>;
+    error: ShallowRef<RequestError | null>;
+    loading: ComputedRef<boolean>;
+    run: (...args: Args) => Promise<T>;
+    cancel: (reason?: unknown) => void;
+    reset: () => void;
+}
+declare function useRequest<T, Args extends unknown[] = []>(executor: (context: UseRequestContext, ...args: Args) => Promise<T>, options?: UseRequestOptions<T, Args>): UseRequestReturn<T, Args>;
+
+declare function useTableCrud<T extends DataRecord, Filters extends object = Record<string, unknown>, Sort extends object = Record<string, unknown>>(config: UseTableCrudConfig<T, Filters, Sort>): UseTableCrudReturn<T, Filters, Sort>;
+
+export { DataRecord, REQUEST_CLIENT_KEY, type UseRequestContext, type UseRequestOptions, type UseRequestReturn, UseTableCrudConfig, UseTableCrudReturn, createRequestPlugin, provideRequestClient, useRequest, useRequestClient, useTableCrud };

package/dist/vue.js

@@ -0,0 +1,71 @@
+export { REQUEST_CLIENT_KEY, createRequestPlugin, provideRequestClient, useRequestClient, useTableCrud } from './chunk-2JXH7SIL.js';
+import { normalizeRequestError, isCanceledError } from './chunk-OAZ5BUBU.js';
+import { shallowRef, computed, getCurrentScope, onScopeDispose } from 'vue';
+
+function useRequest(executor, options = {}) {
+  const data = shallowRef(options.initialData);
+  const error = shallowRef(null);
+  const pending = shallowRef(0);
+  const loading = computed(() => pending.value > 0);
+  let active = null;
+  const controllers = /* @__PURE__ */ new Set();
+  let sequence = 0;
+  const cancel = (reason) => {
+    sequence += 1;
+    for (const controller of controllers) controller.abort(reason);
+    controllers.clear();
+    active = null;
+  };
+  const run = async (...args) => {
+    const concurrency = options.concurrency ?? "takeLatest";
+    if (active && concurrency === "takeFirst") return active.promise;
+    if (active && concurrency === "takeLatest") active.controller.abort();
+    const id = ++sequence;
+    const controller = new AbortController();
+    controllers.add(controller);
+    if (!options.keepPreviousData) data.value = void 0;
+    error.value = null;
+    pending.value += 1;
+    const promise = executor({ signal: controller.signal }, ...args);
+    active = { controller, promise, id };
+    try {
+      const result = await promise;
+      if (id === sequence || concurrency === "takeFirst") {
+        data.value = result;
+        try {
+          await options.onSuccess?.(result);
+        } catch {
+        }
+      }
+      return result;
+    } catch (cause) {
+      const normalized = normalizeRequestError(cause);
+      if (!isCanceledError(normalized) && id === sequence) {
+        error.value = normalized;
+        try {
+          await options.onError?.(normalized);
+        } catch {
+        }
+      }
+      throw normalized;
+    } finally {
+      pending.value = Math.max(0, pending.value - 1);
+      controllers.delete(controller);
+      if (active?.id === id) active = null;
+    }
+  };
+  const reset = () => {
+    cancel();
+    data.value = options.initialData;
+    error.value = null;
+  };
+  if (getCurrentScope()) onScopeDispose(() => cancel());
+  if (options.immediate) {
+    void run(...options.immediateArgs ?? []).catch(() => void 0);
+  }
+  return { data, error, loading, run, cancel, reset };
+}
+
+export { useRequest };
+//# sourceMappingURL=vue.js.map
+//# sourceMappingURL=vue.js.map

package/dist/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vue/useRequest.ts"],"names":[],"mappings":"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","file":"vue.js","sourcesContent":["import {\n  computed,\n  getCurrentScope,\n  onScopeDispose,\n  shallowRef,\n  type ComputedRef,\n  type ShallowRef,\n} from \"vue\";\nimport type { ConcurrencyPolicy } from \"../axios/types\";\nimport {\n  isCanceledError,\n  normalizeRequestError,\n  type RequestError,\n} from \"../client/errors\";\n\nexport interface UseRequestContext {\n  signal: AbortSignal;\n}\n\nexport interface UseRequestOptions<T, Args extends unknown[]> {\n  initialData?: T;\n  immediate?: boolean;\n  immediateArgs?: Args;\n  concurrency?: Extract<ConcurrencyPolicy, \"allow\" | \"takeLatest\" | \"takeFirst\">;\n  keepPreviousData?: boolean;\n  onSuccess?: (data: T) => void | Promise<void>;\n  onError?: (error: RequestError) => void | Promise<void>;\n}\n\nexport interface UseRequestReturn<T, Args extends unknown[]> {\n  data: ShallowRef<T | undefined>;\n  error: ShallowRef<RequestError | null>;\n  loading: ComputedRef<boolean>;\n  run: (...args: Args) => Promise<T>;\n  cancel: (reason?: unknown) => void;\n  reset: () => void;\n}\n\nexport function useRequest<T, Args extends unknown[] = []>(\n  executor: (context: UseRequestContext, ...args: Args) => Promise<T>,\n  options: UseRequestOptions<T, Args> = {},\n): UseRequestReturn<T, Args> {\n  const data = shallowRef<T | undefined>(options.initialData);\n  const error = shallowRef<RequestError | null>(null);\n  const pending = shallowRef(0);\n  const loading = computed(() => pending.value > 0);\n  let active: { controller: AbortController; promise: Promise<T>; id: number } | null =\n    null;\n  const controllers = new Set<AbortController>();\n  let sequence = 0;\n\n  const cancel = (reason?: unknown): void => {\n    sequence += 1;\n    for (const controller of controllers) controller.abort(reason);\n    controllers.clear();\n    active = null;\n  };\n\n  const run = async (...args: Args): Promise<T> => {\n    const concurrency = options.concurrency ?? \"takeLatest\";\n    if (active && concurrency === \"takeFirst\") return active.promise;\n    if (active && concurrency === \"takeLatest\") active.controller.abort();\n\n    const id = ++sequence;\n    const controller = new AbortController();\n    controllers.add(controller);\n    if (!options.keepPreviousData) data.value = undefined;\n    error.value = null;\n    pending.value += 1;\n\n    const promise = executor({ signal: controller.signal }, ...args);\n    active = { controller, promise, id };\n    try {\n      const result = await promise;\n      if (id === sequence || concurrency === \"takeFirst\") {\n        data.value = result;\n        try {\n          await options.onSuccess?.(result);\n        } catch {\n          // Lifecycle callbacks must not turn a successful request into a failure.\n        }\n      }\n      return result;\n    } catch (cause) {\n      const normalized = normalizeRequestError(cause);\n      if (!isCanceledError(normalized) && id === sequence) {\n        error.value = normalized;\n        try {\n          await options.onError?.(normalized);\n        } catch {\n          // Preserve the original request error if an observer fails.\n        }\n      }\n      throw normalized;\n    } finally {\n      pending.value = Math.max(0, pending.value - 1);\n      controllers.delete(controller);\n      if (active?.id === id) active = null;\n    }\n  };\n\n  const reset = (): void => {\n    cancel();\n    data.value = options.initialData;\n    error.value = null;\n  };\n\n  if (getCurrentScope()) onScopeDispose(() => cancel());\n  if (options.immediate) {\n    void run(...(options.immediateArgs ?? ([] as unknown as Args))).catch(() => undefined);\n  }\n\n  return { data, error, loading, run, cancel, reset };\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@robot-admin/request-core",
-  "version": "0.2.0",
-  "description": "Axios request orchestration + CRUD composables for Vue 3",
+  "version": "0.4.0",
+  "description": "Instance-scoped Axios orchestration and headless CRUD composables for Vue 3",
   "type": "module",
   "keywords": [
     "vue",
@@ -12,9 +12,12 @@
   ],
   "author": "ChenYu <ycyplus@gmail.com>",
   "license": "MIT",
+  "engines": {
+    "node": ">=18.18.0"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/ChenyCHENYU/robot-admin-packages",
+    "url": "git+https://github.com/ChenyCHENYU/robot-admin-packages.git",
     "directory": "packages/request-core"
   },
   "main": "./dist/index.cjs",
@@ -22,24 +25,62 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./axios": {
-      "types": "./dist/axios.d.ts",
-      "import": "./dist/axios.js",
-      "require": "./dist/axios.cjs"
+      "import": {
+        "types": "./dist/axios.d.ts",
+        "default": "./dist/axios.js"
+      },
+      "require": {
+        "types": "./dist/axios.d.cts",
+        "default": "./dist/axios.cjs"
+      }
     },
     "./crud": {
-      "types": "./dist/crud.d.ts",
-      "import": "./dist/crud.js",
-      "require": "./dist/crud.cjs"
+      "import": {
+        "types": "./dist/crud.d.ts",
+        "default": "./dist/crud.js"
+      },
+      "require": {
+        "types": "./dist/crud.d.cts",
+        "default": "./dist/crud.cjs"
+      }
+    },
+    "./vue": {
+      "import": {
+        "types": "./dist/vue.d.ts",
+        "default": "./dist/vue.js"
+      },
+      "require": {
+        "types": "./dist/vue.d.cts",
+        "default": "./dist/vue.cjs"
+      }
+    },
+    "./naive": {
+      "import": {
+        "types": "./dist/naive.d.ts",
+        "default": "./dist/naive.js"
+      },
+      "require": {
+        "types": "./dist/naive.d.cts",
+        "default": "./dist/naive.cjs"
+      }
     }
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "SECURITY.md"
   ],
   "sideEffects": false,
   "publishConfig": {
@@ -51,8 +92,10 @@
     "build": "tsup",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "test": "vitest run tests",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "bun run build"
+    "type-check": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "check:package": "node ./node_modules/publint/src/cli.js && node ./scripts/verify-package.mjs",
+    "verify": "bun run type-check && bun run test && bun run build && bun run check:package",
+    "prepublishOnly": "bun run verify"
   },
   "peerDependencies": {
     "vue": "^3.4.0",
@@ -73,6 +116,7 @@
     "tsup": "^8.1.0",
     "vue": "^3.4.0",
     "naive-ui": "^2.38.0",
-    "axios": "^1.7.0"
+    "axios": "^1.7.0",
+    "publint": "0.3.24"
   }
 }