@quan-erp/base-frontend 1.0.0

package/LICENSE.md

@@ -0,0 +1,49 @@
+# QuarkERP License
+
+**Copyright (c) 2026 The Paradance. All rights reserved.**
+
+This software is owned by **The Paradance** and is actively maintained and developed by **Jian Shang Quan**.
+
+This QuarkERP License (the "License") governs use of this software and its associated source code, binaries, types, documentation, and assets (the "Software").
+
+By installing, importing, or otherwise using the Software, you agree to this License.
+
+---
+
+## 1. Permitted use — Quark ERP plugins only
+
+You may use the Software **only** to develop, build, test, and run **plugins for Quark ERP** (also known as Quan ERP), including:
+
+- Importing the published npm packages as dependencies of a Quark ERP plugin
+- Calling the public APIs, types, and UI components exposed by those packages
+- Shipping a plugin that runs on a licensed Quark ERP host
+
+Your plugin's own original code remains yours. This License does not transfer ownership of the Software.
+
+---
+
+## 2. Prohibited use
+
+You may **not**:
+
+- Copy, fork, or redistribute the Software (source or compiled) except as an npm dependency of a Quark ERP plugin
+- Use the Software as the core, framework, or design system of any product that is not a Quark ERP plugin
+- Reuse, rebrand, sublicense, or sell the Software for any other purpose
+- Create a competing ERP, plugin platform, UI kit, or backend framework from the Software
+- Remove or obscure copyright, license, or proprietary notices
+
+---
+
+## 3. No transfer of ownership
+
+The Software is licensed, not sold. Copyright, title, and all intellectual property rights remain with **The Paradance**. The Software is actively maintained and developed by **Jian Shang Quan**.
+
+---
+
+## 4. No warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE PARADANCE OR JIAN SHANG QUAN BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM USE OF THE SOFTWARE.
+
+---
+
+*QuarkERP License — The Paradance. For inquiries, contact Jian Shang Quan.*

package/README.md

@@ -0,0 +1,80 @@
+# Quan ERP Frontend Base (App Shell)
+
+The "Kernel Shell" of the Quan ERP user interface. This application acts as the master orchestrator, providing the foundational layout, security context, and the dynamic engine required to mount and integrate modular frontend plugins.
+
+---
+
+## 🚀 App Shell Lifecycle
+
+The application follows a strict bootstrapping sequence to ensure that the environment is secure and all plugins are ready before the user interacts with the UI.
+
+1.  **Bootstrapping**: Initializes the `shared-frontend-core` HAL and security layers (global object freezing).
+2.  **Initializing**: Fetches the list of installed plugins from the backend and initializes the `Plugin` metadata engine.
+3.  **Loading**: Executes `Plugin.initializePlugins()`, which dynamically imports plugin entry points and registers their routes and components into the global `AppRegistry`.
+4.  **Ready**: Transitions from the `Splash` screen to the protected `AppLayout`.
+
+---
+
+## 🛣️ Dynamic Routing Engine
+
+The shell uses a recursive routing engine (`RouteApp`) to build the final application tree at runtime.
+
+### Master Prefix: `/app/*`
+All protected content resides behind the `/app` prefix, which is gated by authentication checks.
+
+### Plugin Injection
+Plugins do not define their own routers. Instead, they register `incomingRoutes` into the shell's registry. The shell then:
+-   Iterates through registered routes.
+-   Recursively resolves nested children.
+-   Injects them into the main React Router Switch alongside core system pages.
+
+---
+
+## 📂 Core Feature Portfolio
+
+The shell provides several built-in modules that form the backbone of the ERP experience:
+
+-   **Plugin Marketplace**: Central interface for discovering, installing, and managing plugin lifecycles.
+-   **IAM (Identity & Access)**: Comprehensive UI for managing Users, Roles, and granular Permissions.
+-   **Asset Engine**: A centralized Media Manager for handling files and attachments across all plugins.
+-   **AI Hub**: The primary interface for the AI Chat Assistant and model configuration.
+-   **Audit & Tracking**: System-wide logs and user activity tracking interfaces.
+
+---
+
+## 🏛️ State & Registry Management
+
+### Global State (Zustand)
+Managed via the `app-state.store`, tracking the system readiness (`isReady`, `isLoading`) and synchronization status with the backend.
+
+### The App Registry
+The central clearinghouse for cross-feature integration:
+-   **Portals**: Allows plugins to inject UI elements (buttons, status indicators) into global zones like the Header or Sidebar.
+-   **Menus**: Harmonizes the sidebar navigation by merging core items with plugin-contributed navigation links.
+
+---
+
+## 📱 Cross-Platform Architecture
+
+The shell is designed to be platform-agnostic, detecting the runtime environment via the `Platforms` utility:
+-   **Web**: Standard browser-based execution.
+-   **Mobile**: Initialized with Capacitor bridges for native hardware access.
+-   **Desktop**: Integrated with Electron-specific IPC and window management.
+
+---
+
+## 🛠️ Development & Debugging
+
+When running in `DevMode`, the shell injects specialized tools:
+-   **API Browser**: Live Swagger/OpenAPI documentation.
+-   **Environment Inspector**: Real-time view of injected VITE environment variables.
+-   **Native API Tester**: Interface for exercising hardware bridges.
+
+---
+
+> [!IMPORTANT]
+> To maintain strict visual and logical isolation, all plugin content rendered within the shell MUST be wrapped in the `Page` component provided by `@quan-erp/shared-ui`.
+
+## License
+
+[QuarkERP License](./LICENSE.md) — owned by The Paradance, actively maintained and developed by Jian Shang Quan. You may use this package to build Quark ERP plugins. Copying or reuse for any other purpose is not permitted.

package/dist-export/api/ai-assistant/ai-assistant.api.d.ts

@@ -0,0 +1,14 @@
+import { type UseQueryOptions } from "@tanstack/react-query";
+import { type RequestIndexPaginationDto } from "@quan-erp/shared-frontend-core";
+import type { AIAssistantDto, CreateAIAssistantDto } from "./ai-assistant.dto";
+export declare const getAvailableAIAssistantApi: import("@quan-erp/shared-types").WithApiMetadataFetchFn<(skip: number, limit: number, option?: {
+    search?: string;
+}) => Promise<AIAssistantDto[]>>;
+export declare function useAvailableAssistantQuery(query?: RequestIndexPaginationDto, option?: Omit<UseQueryOptions<AIAssistantDto[]>, 'queryFn' | 'queryKey'>): import("@tanstack/react-query").UseQueryResult<NoInfer<AIAssistantDto[]>, Error>;
+export declare const createAIAssistantApi: import("@quan-erp/shared-types").WithApiMetadataFetchFn<(payload: CreateAIAssistantDto) => Promise<void>>;
+export declare const updateAssistantApi: import("@quan-erp/shared-types").WithApiMetadataFetchFn<(payload: CreateAIAssistantDto) => Promise<void>>;
+export declare const deleteAIAssistantApi: import("@quan-erp/shared-types").WithApiMetadataFetchFn<(assistantId: string) => Promise<void>>;
+export declare function useCreateAIAssistantQuery(): import("@tanstack/react-query").UseMutationResult<void, Error, CreateAIAssistantDto, unknown>;
+export declare function useUpdateAIAssistantQuery(): import("@tanstack/react-query").UseMutationResult<void, Error, CreateAIAssistantDto, unknown>;
+export declare function useDeleteAIAssistantQuery(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+//# sourceMappingURL=ai-assistant.api.d.ts.map

package/dist-export/api/ai-assistant/ai-assistant.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assistant.api.d.ts","sourceRoot":"","sources":["../../../src/api/ai-assistant/ai-assistant.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAc,KAAK,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAoB/E,eAAO,MAAM,0BAA0B,iEAEb,MAAM,SAAS,MAAM,WAAW;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAUvG,CAAC;AAEH,wBAAgB,0BAA0B,CACtC,KAAK,GAAE,yBAA8B,EACrC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,oFAS3E;AA8CD,eAAO,MAAM,oBAAoB,oEAEJ,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC,CAG/D,CAAC;AACH,eAAO,MAAM,kBAAkB,oEAEF,oBAAoB,KAAG,OAAO,CAAC,IAAI,CAAC,CAG/D,CAAC;AACH,eAAO,MAAM,oBAAoB,wEAEA,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAGrD,CAAC;AAEH,wBAAgB,yBAAyB,kGAQxC;AAID,wBAAgB,yBAAyB,kGAQxC;AAGD,wBAAgB,yBAAyB,oFAQxC"}

package/dist-export/api/ai-assistant/ai-assistant.api.js

@@ -0,0 +1,93 @@
+import { useMutation, useQuery } from "@tanstack/react-query";
+import axiosClient from "../../utils/axios-client";
+import { RequestDto } from "@quan-erp/shared-frontend-core";
+import { queryClient } from "../../plugin/app-state";
+import { DEFAULT_STALE_TIME } from "../../utils/common";
+import { resolveIndexPagination } from "../../utils/pagination";
+import { withApiMetadataFetchFn } from "../permission/permission.lib";
+export const getAvailableAIAssistantApi = withApiMetadataFetchFn({
+    api: { method: 'GET', url: '/ai-assistant/available-assistants' },
+    fetchFn: async (skip, limit, option) => {
+        const response = await axiosClient.get('/ai-assistant/available-assistants', {
+            params: {
+                skip,
+                limit,
+                search: option?.search
+            }
+        });
+        return response.data.payload;
+    }
+});
+const AI_ASSISTANT_AVAILABLE_QUERY_KEY = 'ai-available-assistant';
+export function useAvailableAssistantQuery(query = {}, option) {
+    const { currentPage, pageSize, skip, query: search } = resolveIndexPagination(query);
+    return useQuery({
+        queryFn: () => getAvailableAIAssistantApi.fetchFn(skip, pageSize, { search: search ?? undefined }),
+        queryKey: [AI_ASSISTANT_AVAILABLE_QUERY_KEY, currentPage, pageSize, search],
+        staleTime: DEFAULT_STALE_TIME,
+        ...(option || {}),
+    });
+}
+// export const queryAssistant = withApiMetadataFetchFn({
+//     api: { method: 'POST', url: '/ai-assistant' },
+//     fetchFn: async (query: string): Promise<{ result: string }> => {
+//         const response = await axiosClient.post('/ai-assistant/', new RequestDto({ query }))
+//         return response.data.payload
+//     }
+// });
+// export function useAIQuery() {
+//     return useMutation({
+//         mutationFn: (query: string) => queryAssistant.fetchFn(query),
+//         onSuccess() {
+//         }
+//     })
+// }
+// =======================
+// Query Keys
+// =======================
+const AI_ASSISTANT_KEY = "ai-assistant";
+export const createAIAssistantApi = withApiMetadataFetchFn({
+    api: { method: 'POST', url: '/ai-assistant' },
+    fetchFn: async (payload) => {
+        await axiosClient.post(`/ai-assistant/`, new RequestDto(payload));
+    }
+});
+export const updateAssistantApi = withApiMetadataFetchFn({
+    api: { method: 'PUT', url: '/ai-assistant' },
+    fetchFn: async (payload) => {
+        await axiosClient.put(`/ai-assistant/`, new RequestDto(payload));
+    }
+});
+export const deleteAIAssistantApi = withApiMetadataFetchFn({
+    api: { method: 'DELETE', url: '/ai-assistant' },
+    fetchFn: async (assistantId) => {
+        await axiosClient.delete(`/ai-assistant/?assistantId=${assistantId}`);
+    }
+});
+export function useCreateAIAssistantQuery() {
+    return useMutation({
+        mutationFn: (payload) => createAIAssistantApi.fetchFn(payload),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: [AI_ASSISTANT_KEY] });
+            queryClient.invalidateQueries({ queryKey: [AI_ASSISTANT_AVAILABLE_QUERY_KEY] });
+        },
+    });
+}
+export function useUpdateAIAssistantQuery() {
+    return useMutation({
+        mutationFn: (payload) => updateAssistantApi.fetchFn(payload),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: [AI_ASSISTANT_KEY] });
+            queryClient.invalidateQueries({ queryKey: [AI_ASSISTANT_AVAILABLE_QUERY_KEY] });
+        },
+    });
+}
+export function useDeleteAIAssistantQuery() {
+    return useMutation({
+        mutationFn: (assistantId) => deleteAIAssistantApi.fetchFn(assistantId),
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: [AI_ASSISTANT_KEY] });
+            queryClient.invalidateQueries({ queryKey: [AI_ASSISTANT_AVAILABLE_QUERY_KEY] });
+        },
+    });
+}

package/dist-export/api/ai-assistant/ai-assistant.dto.d.ts

@@ -0,0 +1,54 @@
+import type { AIModelDto } from "../ai-model/ai-model.api";
+import type { RoleDto } from "../role-permission/role-permission.dto";
+import type { UserDto } from "../user/user.type";
+export interface AIAssistantDto {
+    shortId: string;
+    name: string;
+    description: string;
+    icon: string;
+    model: AIModelDto;
+    tools: {
+        pluginName: string;
+        fnName: string;
+    }[];
+    allowedRoles: RoleDto[];
+    systemPrompt: string;
+    createdBy: UserDto;
+}
+export type AISystemPromptProps = {
+    identity: string;
+    role: string;
+    goals: string[];
+    coreMission: string;
+    scopeOfKnowledge: string;
+    scopeOfWork: string;
+    mandatoryRules: string;
+    languagePolicy: string;
+    responseStructure: string;
+    toolUsageGuidelines: string;
+    objective: string;
+    additionalInfo: string;
+};
+export type AISystemPromptType = string | Partial<AISystemPromptProps>;
+export interface AIAssistant {
+    shortId: string;
+    name: string;
+    description: string;
+    icon: string;
+    tools: {
+        pluginName: string;
+        fnName: string;
+    }[];
+    memoryContextLength?: number;
+    internalModelName: string;
+    systemPrompt: AISystemPromptType | (() => AISystemPromptType | Promise<AISystemPromptType>);
+}
+export type CreateAIAssistantDto = {
+    allowedRoleId: number[];
+} & AIAssistant;
+export declare const AISDKAPIType: {
+    readonly OpenAI: "OpenAISDK";
+    readonly Gemini: "GeminiSDK";
+};
+export type AISDKAPITypeValue = typeof AISDKAPIType[keyof typeof AISDKAPIType];
+//# sourceMappingURL=ai-assistant.dto.d.ts.map

package/dist-export/api/ai-assistant/ai-assistant.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assistant.dto.d.ts","sourceRoot":"","sources":["../../../src/api/ai-assistant/ai-assistant.dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC/C,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAA;CACrB;AAID,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAA;CACzB,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;AACtE,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,kBAAkB,GAAG,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;CAC/F;AAGD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAA;CAC1B,GAAG,WAAW,CAAA;AAGf,eAAO,MAAM,YAAY;;;CAGf,CAAA;AACV,MAAM,MAAM,iBAAiB,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist-export/api/ai-assistant/ai-assistant.dto.js

@@ -0,0 +1,4 @@
+export const AISDKAPIType = {
+    OpenAI: 'OpenAISDK',
+    Gemini: 'GeminiSDK'
+};

package/dist-export/api/ai-assistant/ai-assistant.export.d.ts

@@ -0,0 +1,7 @@
+import { type RequestIndexPaginationDto } from '@quan-erp/shared-frontend-core';
+import type { AIAssistantDto } from './ai-assistant.dto';
+import type { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
+export * from './ai-assistant.dto';
+export type UseAvailableAssistantQuery = (query?: RequestIndexPaginationDto, option?: Omit<UseQueryOptions<AIAssistantDto[]>, 'queryFn' | 'queryKey'>) => UseQueryResult<AIAssistantDto[], Error>;
+export declare function useAvailableAssistantQuery(query?: RequestIndexPaginationDto, option?: Omit<UseQueryOptions<AIAssistantDto[]>, 'queryFn' | 'queryKey'>): UseQueryResult<AIAssistantDto[], Error>;
+//# sourceMappingURL=ai-assistant.export.d.ts.map

package/dist-export/api/ai-assistant/ai-assistant.export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-assistant.export.d.ts","sourceRoot":"","sources":["../../../src/api/ai-assistant/ai-assistant.export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAG1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE5E,cAAc,oBAAoB,CAAA;AAGlC,MAAM,MAAM,0BAA0B,GAAG,CACrC,KAAK,CAAC,EAAE,yBAAyB,EACjC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,KACvE,cAAc,CAAC,cAAc,EAAE,EAAE,KAAK,CAAC,CAAA;AAC5C,wBAAgB,0BAA0B,CACtC,KAAK,GAAE,yBAA8B,EACrC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,2CAG3E"}

package/dist-export/api/ai-assistant/ai-assistant.export.js

@@ -0,0 +1,7 @@
+import { PluginAPI } from '@quan-erp/shared-frontend-core';
+import { APINames } from '../../export';
+import { BUILTIN_PLUGIN } from '../../utils/common';
+export * from './ai-assistant.dto';
+export function useAvailableAssistantQuery(query = {}, option) {
+    return PluginAPI.use(BUILTIN_PLUGIN.name, APINames.useAvailableAssistantQuery)(query, option);
+}

package/dist-export/api/ai-model/ai-model.api.d.ts

@@ -0,0 +1,37 @@
+import { type UseQueryOptions } from "@tanstack/react-query";
+import { type RequestIndexPaginationDto } from "@quan-erp/shared-frontend-core";
+import type { AISDKAPITypeValue } from "../ai-assistant/ai-assistant.dto";
+import type { RoleDto } from "../role-permission/role-permission.dto";
+import type { UserDto } from "../user/user.type";
+export type CreateAIModelDto = {
+    sdkType: AISDKAPITypeValue | string;
+    name: string;
+    apiKey: string;
+    userId: number;
+    baseUrl?: string;
+    model: string;
+    allowedRoleId: number[];
+};
+export interface AIModelDto {
+    id: number;
+    name: string;
+    sdkType: string;
+    model: string;
+    baseUrl?: string;
+    isActive: boolean;
+    allowedRoles: RoleDto[];
+    createdBy: UserDto;
+}
+export declare const AI_MODELS_QUERY_KEY = "ai-models";
+export declare const getAIModelsApi: import("@quan-erp/shared-types").WithApiMetadataFetchFn<(skip: number, limit: number) => Promise<AIModelDto[]>>;
+export declare const createAIModelApi: import("@quan-erp/shared-types").WithApiMetadataFetchFn<(payload: CreateAIModelDto) => Promise<void>>;
+export declare const updateAIModelApi: import("@quan-erp/shared-types").WithApiMetadataFetchFn<(id: number, payload: CreateAIModelDto) => Promise<void>>;
+export declare const deleteAIModelApi: import("@quan-erp/shared-types").WithApiMetadataFetchFn<(id: number) => Promise<void>>;
+export declare function useAIModelsQuery(query?: RequestIndexPaginationDto, option?: Omit<UseQueryOptions<AIModelDto[]>, 'queryFn' | 'queryKey'>): import("@tanstack/react-query").UseQueryResult<NoInfer<AIModelDto[]>, Error>;
+export declare function useCreateAIModelQuery(): import("@tanstack/react-query").UseMutationResult<void, Error, CreateAIModelDto, unknown>;
+export declare function useUpdateAIModelQuery(): import("@tanstack/react-query").UseMutationResult<void, Error, {
+    id: number;
+    payload: CreateAIModelDto;
+}, unknown>;
+export declare function useDeleteAIModelQuery(): import("@tanstack/react-query").UseMutationResult<void, Error, number, unknown>;
+//# sourceMappingURL=ai-model.api.d.ts.map

package/dist-export/api/ai-model/ai-model.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model.api.d.ts","sourceRoot":"","sources":["../../../src/api/ai-model/ai-model.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGpF,OAAO,EAAc,KAAK,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAUjD,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAA;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAC;AAEF,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAA;CACrB;AAOD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,eAAO,MAAM,cAAc,iEAED,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAIrE,CAAC;AAEH,eAAO,MAAM,gBAAgB,oEAEA,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAAC,CAG3D,CAAC;AAEH,eAAO,MAAM,gBAAgB,+DAEL,MAAM,WAAW,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAAC,CAKvE,CAAC;AAEH,eAAO,MAAM,gBAAgB,+DAEL,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAG5C,CAAC;AAOH,wBAAgB,gBAAgB,CAC5B,KAAK,GAAE,yBAA8B,EACrC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,gFASvE;AAGD,wBAAgB,qBAAqB,8FASpC;AAGD,wBAAgB,qBAAqB;QAEH,MAAM;aAAW,gBAAgB;YAOlE;AAID,wBAAgB,qBAAqB,oFASpC"}

package/dist-export/api/ai-model/ai-model.api.js

@@ -0,0 +1,80 @@
+import { useMutation, useQuery } from "@tanstack/react-query";
+import axiosClient from "../../utils/axios-client";
+import { queryClient } from "../../plugin/app-state";
+import { RequestDto } from "@quan-erp/shared-frontend-core";
+import { DEFAULT_STALE_TIME } from "../../utils/common";
+import { resolveIndexPagination } from "../../utils/pagination";
+import { withApiMetadataFetchFn } from "../permission/permission.lib";
+// =======================
+// API Functions
+// =======================
+export const AI_MODELS_QUERY_KEY = "ai-models";
+export const getAIModelsApi = withApiMetadataFetchFn({
+    api: { method: 'GET', url: '/ai-models' },
+    fetchFn: async (skip, limit) => {
+        const response = await axiosClient.get(`/ai-models?skip=${skip}&limit=${limit}`);
+        return response.data.payload;
+    }
+});
+export const createAIModelApi = withApiMetadataFetchFn({
+    api: { method: 'POST', url: '/ai-models' },
+    fetchFn: async (payload) => {
+        await axiosClient.post(`/ai-models`, new RequestDto(payload));
+    }
+});
+export const updateAIModelApi = withApiMetadataFetchFn({
+    api: { method: 'PUT', url: '/ai-models' },
+    fetchFn: async (id, payload) => {
+        await axiosClient.put(`/ai-models`, new RequestDto(payload), {
+            params: { id }
+        });
+    }
+});
+export const deleteAIModelApi = withApiMetadataFetchFn({
+    api: { method: 'DELETE', url: '/ai-models' },
+    fetchFn: async (id) => {
+        await axiosClient.delete(`/ai-models?id=${id}`);
+    }
+});
+// =======================
+// Hooks
+// =======================
+export function useAIModelsQuery(query = {}, option) {
+    const { currentPage, pageSize, skip } = resolveIndexPagination(query);
+    return useQuery({
+        queryKey: [AI_MODELS_QUERY_KEY, currentPage, pageSize],
+        queryFn: () => getAIModelsApi.fetchFn(skip, pageSize),
+        staleTime: DEFAULT_STALE_TIME,
+        ...(option || {}),
+    });
+}
+export function useCreateAIModelQuery() {
+    return useMutation({
+        mutationFn: (payload) => createAIModelApi.fetchFn(payload),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: [AI_MODELS_QUERY_KEY],
+            });
+        },
+    });
+}
+export function useUpdateAIModelQuery() {
+    return useMutation({
+        mutationFn: (props) => updateAIModelApi.fetchFn(props.id, props.payload),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: [AI_MODELS_QUERY_KEY],
+            });
+        },
+    });
+}
+export function useDeleteAIModelQuery() {
+    return useMutation({
+        mutationFn: (id) => deleteAIModelApi.fetchFn(id),
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: [AI_MODELS_QUERY_KEY],
+            });
+        },
+    });
+}

package/dist-export/api/ai-tool/ai-tool.dto.d.ts

@@ -0,0 +1,26 @@
+export interface AIFunctionParameters {
+    type: "object";
+    properties: Record<string, {
+        type: string;
+        description?: string;
+    }>;
+    required?: string[];
+}
+export interface AIFunctionDefinition {
+    name: string;
+    description: string;
+    parameters: AIFunctionParameters;
+}
+export interface AIToolDetailDto {
+    type: "function";
+    function: AIFunctionDefinition;
+}
+export interface AIToolDto {
+    pluginName: string;
+    toolDetail: AIToolDetailDto;
+}
+export interface GetAIToolsResponseDto {
+    success: boolean;
+    data: AIToolDto[];
+}
+//# sourceMappingURL=ai-tool.dto.d.ts.map

package/dist-export/api/ai-tool/ai-tool.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool.dto.d.ts","sourceRoot":"","sources":["../../../src/api/ai-tool/ai-tool.dto.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QACE,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CACF,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB"}

package/dist-export/api/ai-tool/ai-tool.dto.js

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

package/dist-export/api/branch/branch.export.d.ts

@@ -0,0 +1,11 @@
+import { type RequestIndexPaginationDto } from "@quan-erp/shared-frontend-core";
+import type { UseMutationResult, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+import type { BranchDto, UpdateBranchDto } from "./branch.type";
+export * from './branch.type';
+export declare function useBranchQuery(query?: RequestIndexPaginationDto, option?: Omit<UseQueryOptions<BranchDto[]>, 'queryFn' | 'queryKey'>): UseQueryResult<BranchDto[], Error>;
+export declare function useCreateBranchQuery(): UseMutationResult<any, Error, any, unknown>;
+export declare function useUpdateBranchQuery(): UseMutationResult<any, Error, {
+    id: number;
+    branch: UpdateBranchDto;
+}, unknown>;
+//# sourceMappingURL=branch.export.d.ts.map

package/dist-export/api/branch/branch.export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.export.d.ts","sourceRoot":"","sources":["../../../src/api/branch/branch.export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChE,cAAc,eAAe,CAAA;AAO7B,wBAAgB,cAAc,CAC1B,KAAK,GAAE,yBAA8B,EACrC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC,sCAGtE;AAKD,wBAAgB,oBAAoB,gDAEnC;AAMD,wBAAgB,oBAAoB;QAD0B,MAAM;YAAU,eAAe;YAG5F"}

package/dist-export/api/branch/branch.export.js

@@ -0,0 +1,12 @@
+import { PluginAPI } from "@quan-erp/shared-frontend-core";
+import { APINames } from "../../export";
+export * from './branch.type';
+export function useBranchQuery(query = {}, option) {
+    return PluginAPI.use('builtin', APINames.useBranchQuery)(query, option);
+}
+export function useCreateBranchQuery() {
+    return PluginAPI.use('builtin', APINames.useCreateBranchQuery)();
+}
+export function useUpdateBranchQuery() {
+    return PluginAPI.use('builtin', APINames.useUpdateBranchQuery)();
+}

package/dist-export/api/branch/branch.type.d.ts

@@ -0,0 +1,46 @@
+import type { TagDto } from "../tag/tag.dto";
+export declare class BranchDto {
+    id: number;
+    name: string;
+    address?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+    phone?: string;
+    email?: string;
+    tags?: TagDto[];
+    isActive: boolean;
+    isDefault: boolean;
+    createDate: Date;
+    updateDate: Date;
+    deleteDate?: Date;
+    version: number;
+}
+export declare class CreateBranchDto {
+    name: string;
+    address?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+    phone?: string;
+    email?: string;
+    tags?: number[];
+    isActive: boolean;
+    isDefault: boolean;
+}
+export declare class UpdateBranchDto {
+    name: string;
+    address?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+    phone?: string;
+    email?: string;
+    tags?: number[];
+    isActive: boolean;
+    isDefault: boolean;
+}
+//# sourceMappingURL=branch.type.d.ts.map

package/dist-export/api/branch/branch.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.type.d.ts","sourceRoot":"","sources":["../../../src/api/branch/branch.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAa,SAAS;IACpB,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IAEnB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist-export/api/branch/branch.type.js

@@ -0,0 +1,44 @@
+export class BranchDto {
+    id;
+    name;
+    address;
+    city;
+    state;
+    postalCode;
+    country;
+    phone;
+    email;
+    tags;
+    isActive;
+    isDefault;
+    createDate;
+    updateDate;
+    deleteDate;
+    version;
+}
+export class CreateBranchDto {
+    name;
+    address;
+    city;
+    state;
+    postalCode;
+    country;
+    phone;
+    email;
+    tags;
+    isActive;
+    isDefault;
+}
+export class UpdateBranchDto {
+    name;
+    address;
+    city;
+    state;
+    postalCode;
+    country;
+    phone;
+    email;
+    tags;
+    isActive;
+    isDefault;
+}

package/dist-export/api/change-log/change-log.dto.d.ts

@@ -0,0 +1,41 @@
+import type { UserDto } from "../user/user.type";
+export interface ChangeLogDto {
+    id: number;
+    message: string;
+    createdBy: number;
+    metadata: any;
+    isCreatedBySystem?: boolean;
+    pluginName: string;
+    referencePrefix: string;
+    referenceNumber: string;
+    replyCount: number;
+}
+export type CreateChangeLogDto = Omit<ChangeLogDto, 'hasReply' | 'id' | 'replyCount'> & {
+    replyToId?: number;
+};
+export interface GetChangeLogDto {
+    id: number;
+    message: string;
+    createdBy: UserDto;
+    metadata: any;
+    isCreatedBySystem: boolean;
+    pluginName: string;
+    referencePrefix: string;
+    referenceNumber: string;
+    replyToId?: ChangeLogDto;
+    createDate: string;
+    replyCount: number;
+    reactions: ChangeLogReaction[];
+}
+export interface ChangeLogReaction {
+    id: number;
+    createDate: string;
+    reaction: string;
+    reactBy: UserDto;
+}
+export interface ChangeLogReactionDto {
+    reaction: string;
+    reactBy: number;
+    changeLogId: number;
+}
+//# sourceMappingURL=change-log.dto.d.ts.map