@movk/nuxt 0.1.1 → 1.0.0

package/dist/runtime/utils/api-utils.d.ts

@@ -0,0 +1,64 @@
+import type { FetchContext, FetchHooks } from 'ofetch';
+import type { ApiResponse, ApiError, ApiSuccessConfig, ApiToastConfig, RequestToastOptions, ResolvedEndpointConfig } from '../types/api.js';
+/**
+ * 检查业务状态码是否成功
+ */
+export declare function isBusinessSuccess(response: ApiResponse, config?: Partial<ApiSuccessConfig>): boolean;
+/**
+ * 从响应中提取消息
+ */
+export declare function extractMessage(response: ApiResponse, config?: Partial<ApiSuccessConfig>): string | undefined;
+/**
+ * 从响应中提取数据
+ */
+export declare function extractData<T>(response: ApiResponse<T>, config?: Partial<ApiSuccessConfig>): T;
+/**
+ * 创建 API 业务错误
+ */
+export declare function createApiError(response: ApiResponse, message?: string): ApiError;
+/**
+ * 从请求选项中提取 Toast 消息
+ */
+export declare function extractToastMessage(toast: RequestToastOptions | false | undefined, type: 'success' | 'error', fallback: string): string;
+/**
+ * 显示 Toast 提示
+ */
+export declare function showToast(type: 'success' | 'error', message: string | undefined, requestOptions: RequestToastOptions | false | undefined, globalConfig: Partial<ApiToastConfig>): void;
+interface CreateTransformOptions<ResT, DataT = ResT> {
+    skipBusinessCheck: boolean;
+    userTransform?: (data: ResT) => DataT;
+    successConfig: Partial<ApiSuccessConfig>;
+}
+/**
+ * 创建 useFetch transform 函数
+ *
+ * 处理流程:
+ * 1. 业务状态码检查 → 失败时抛出 ApiError
+ * 2. 解包数据（提取 response.data）
+ * 3. 用户自定义 transform（接收解包后的数据）
+ */
+export declare function createTransform<ResT, DataT = ResT>(options: CreateTransformOptions<ResT, DataT>): (response: ApiResponse<ResT>) => DataT;
+type HookFunction = (context: FetchContext) => void | Promise<void>;
+/**
+ * 合并多个 hook 函数，确保所有 hooks 都会执行
+ */
+export declare function mergeHooks(...hooks: (HookFunction | undefined)[]): HookFunction;
+/**
+ * 合并 FetchHooks 对象，每个 hook 类型单独合并
+ */
+export declare function mergeFetchHooks(builtinHooks: Partial<FetchHooks>, userHooks: Partial<FetchHooks>): FetchHooks;
+/**
+ * 获取认证 Headers
+ *
+ * 根据端点配置获取认证相关的 headers（如 Authorization）
+ * 用于原生 fetch/XHR 请求（如带进度的上传下载）
+ *
+ * @example
+ * ```ts
+ * const config = $api.getConfig()
+ * const authHeaders = getAuthHeaders(config)
+ * fetch(url, { headers: { ...headers, ...authHeaders } })
+ * ```
+ */
+export declare function getAuthHeaders(config: ResolvedEndpointConfig): Record<string, string>;
+export {};

package/dist/runtime/utils/api-utils.js

@@ -0,0 +1,127 @@
+import { getPath } from "@movk/core";
+import { useNuxtApp, useToast, useUserSession } from "#imports";
+export function isBusinessSuccess(response, config = {}) {
+  const codeKey = config.codeKey || "code";
+  const successCodes = config.successCodes || [200, 0];
+  const code = response[codeKey];
+  return successCodes.includes(code);
+}
+export function extractMessage(response, config = {}) {
+  const messageKey = config.messageKey || "message";
+  return response[messageKey] || response.message || response.msg;
+}
+export function extractData(response, config = {}) {
+  const dataKey = config.dataKey || "data";
+  return response[dataKey] ?? response.result ?? response;
+}
+export function createApiError(response, message) {
+  const error = new Error(message || "\u8BF7\u6C42\u5931\u8D25");
+  error.statusCode = Number(response.code || response.status || 500);
+  error.response = response;
+  error.isBusinessError = true;
+  return error;
+}
+function getToast() {
+  try {
+    const nuxtApp = useNuxtApp();
+    return nuxtApp.runWithContext(() => useToast());
+  } catch {
+    return null;
+  }
+}
+export function extractToastMessage(toast, type, fallback) {
+  if (toast === false) return fallback;
+  return (typeof toast === "object" ? toast?.[`${type}Message`] : void 0) || fallback;
+}
+export function showToast(type, message, requestOptions, globalConfig) {
+  if (globalConfig.enabled === false || requestOptions === false) return;
+  if (!message) return;
+  const typeConfig = globalConfig[type];
+  if (typeConfig?.show === false) return;
+  if (requestOptions?.[type] === false) return;
+  const toast = getToast();
+  if (!toast) return;
+  const requestTypeConfig = typeof requestOptions?.[type] === "object" ? requestOptions[type] : {};
+  toast.add({
+    icon: type === "success" ? "i-lucide-circle-check" : "i-lucide-circle-x",
+    title: message,
+    color: type === "success" ? "success" : "error",
+    duration: 3e3,
+    ...typeConfig && { ...typeConfig, show: void 0 },
+    ...requestTypeConfig
+  });
+}
+export function createTransform(options) {
+  const { skipBusinessCheck, userTransform, successConfig } = options;
+  return (response) => {
+    if (!skipBusinessCheck && !isBusinessSuccess(response, successConfig)) {
+      throw createApiError(response, extractMessage(response, successConfig));
+    }
+    const unwrappedData = extractData(response, successConfig);
+    if (userTransform) {
+      return userTransform(unwrappedData);
+    }
+    return unwrappedData;
+  };
+}
+export function mergeHooks(...hooks) {
+  const validHooks = hooks.filter((h) => typeof h === "function");
+  if (validHooks.length === 0) return () => {
+  };
+  if (validHooks.length === 1) return validHooks[0];
+  return async (context) => {
+    for (const hook of validHooks) {
+      await hook(context);
+    }
+  };
+}
+export function mergeFetchHooks(builtinHooks, userHooks) {
+  return {
+    onRequest: mergeHooks(
+      builtinHooks.onRequest,
+      userHooks.onRequest
+    ),
+    onRequestError: mergeHooks(
+      builtinHooks.onRequestError,
+      userHooks.onRequestError
+    ),
+    onResponse: mergeHooks(
+      builtinHooks.onResponse,
+      userHooks.onResponse
+    ),
+    onResponseError: mergeHooks(
+      builtinHooks.onResponseError,
+      userHooks.onResponseError
+    )
+  };
+}
+function getUserSession() {
+  try {
+    const nuxtApp = useNuxtApp();
+    return nuxtApp.runWithContext(() => useUserSession());
+  } catch {
+    return null;
+  }
+}
+function getTokenFromSession(tokenPath) {
+  const userSession = getUserSession();
+  if (!userSession?.session?.value) return null;
+  const sessionData = userSession.session.value;
+  return getPath(sessionData, tokenPath) || null;
+}
+function buildAuthHeaderValue(token, config) {
+  const tokenType = config.tokenType === "Custom" ? config.customTokenType || "" : config.tokenType || "Bearer";
+  return tokenType ? `${tokenType} ${token}` : token;
+}
+export function getAuthHeaders(config) {
+  const headers = {};
+  const authConfig = config.auth;
+  if (!authConfig.enabled) return headers;
+  const tokenPath = authConfig.sessionTokenPath || "token";
+  const token = getTokenFromSession(tokenPath);
+  if (token) {
+    const headerName = authConfig.headerName || "Authorization";
+    headers[headerName] = buildAuthHeaderValue(token, authConfig);
+  }
+  return headers;
+}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@movk/nuxt",
   "type": "module",
-  "version": "0.1.1",
-  "packageManager": "pnpm@10.24.0",
-  "description": "Schema-driven form and table generation module for Nuxt 4",
+  "version": "1.0.0",
+  "packageManager": "pnpm@10.26.1",
+  "description": "Modular engineering suite for Nuxt 4 with schema-driven forms, API integration, UI components and composables",
   "author": "YiXuan <mhaibaraai@gmail.com>",
   "license": "MIT",
   "repository": {
@@ -23,10 +23,16 @@
     "nuxt4",
     "zod",
     "form",
-    "table",
     "auto-form",
     "schema-driven",
-    "validation"
+    "validation",
+    "api",
+    "fetch",
+    "auth",
+    "upload",
+    "download",
+    "composables",
+    "ui-components"
   ],
   "exports": {
     ".": {
@@ -40,18 +46,18 @@
     "dist"
   ],
   "peerDependencies": {
-    "zod": ">=4.1.13",
-    "@nuxt/ui": ">=4.2.1"
+    "@nuxt/ui": ">=4.2.1",
+    "zod": ">=4.1.13"
   },
   "scripts": {
-    "prepack": "nr build",
+    "prepack": "pnpm build",
     "build": "nuxt-module-build build",
     "dev": "nuxt dev playground",
     "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt prepare playground && nuxt prepare docs",
     "dev:build": "nuxt build playground",
     "docs": "nuxt dev docs",
     "docs:build": "nuxt build docs",
-    "release": "release-it && npm publish --access public",
+    "release": "release-it && npm publish",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "typecheck": "vue-tsc --noEmit && nuxt typecheck playground",
@@ -59,35 +65,36 @@
     "test": "vitest"
   },
   "dependencies": {
-    "@iconify-json/lucide": "^1.2.77",
-    "@internationalized/date": "^3.10.0",
+    "@iconify-json/lucide": "^1.2.82",
+    "@internationalized/date": "^3.10.1",
     "@movk/core": "^1.0.2",
     "@nuxt/image": "^2.0.0",
-    "@nuxt/ui": "^4.2.1",
+    "@nuxt/ui": "^4.3.0",
     "@vueuse/core": "^14.1.0",
     "@vueuse/nuxt": "^14.1.0",
     "defu": "^6.1.4",
-    "tailwindcss": "^4.1.17",
+    "nuxt-auth-utils": "^0.5.26",
+    "tailwindcss": "^4.1.18",
     "scule": "^1.3.0",
-    "zod": "^4.1.13"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
-    "@antfu/ni": "^27.0.1",
     "@nuxt/devtools": "^3.1.1",
-    "@nuxt/eslint": "^1.11.0",
-    "@nuxt/kit": "^4.2.1",
+    "@nuxt/eslint": "^1.12.1",
+    "@nuxt/kit": "^4.2.2",
     "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.2.1",
-    "@nuxt/test-utils": "^3.20.1",
+    "@nuxt/schema": "^4.2.2",
+    "@nuxt/test-utils": "^3.21.0",
     "@release-it/bumper": "^7.0.5",
-    "@release-it/conventional-changelog": "^10.0.2",
-    "@vitest/coverage-v8": "^4.0.14",
-    "eslint": "9.38.0",
+    "@release-it/conventional-changelog": "^10.0.4",
+    "@vitest/coverage-v8": "^4.0.16",
+    "jsdom": "^27.3.0",
+    "eslint": "9.39.2",
     "fast-glob": "^3.3.3",
-    "nuxt": "^4.2.1",
+    "nuxt": "^4.2.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.14",
-    "vue-tsc": "^3.1.5"
+    "vitest": "^4.0.16",
+    "vue-tsc": "^3.2.1"
   }
 }