@titus-system/syncdesk 0.5.1 → 0.5.2

package/dist/roles/hooks/useRoles.js

@@ -0,0 +1,138 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { apiClient } from "../../api";
+const PATH = "/roles";
+/**
+ * List all roles.
+ * @returns {UseQueryResult<Role[]>} The query result.
+ */
+export function useRoles() {
+    return useQuery({
+        queryKey: ["roles"],
+        queryFn: async () => {
+            const response = await apiClient.get(`${PATH}/`);
+            return response.data.data;
+        },
+    });
+}
+/**
+ * Get a role by ID.
+ * @param {number} id id parameter.
+ * @returns {UseQueryResult<Role>} The query result.
+ */
+export function useRole(id) {
+    return useQuery({
+        queryKey: ["roles", id],
+        queryFn: async () => {
+            const response = await apiClient.get(`${PATH}/${id}`);
+            return response.data.data;
+        },
+        enabled: !!id,
+    });
+}
+/**
+ * Create a new role.
+ * @param {CreateRoleDTO} dto DTO containing details.
+ * @returns {UseMutationResult<Role, Error, CreateRoleDTO>} The mutation result.
+ */
+export function useCreateRole() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (dto) => {
+            const response = await apiClient.post(`${PATH}/`, dto);
+            return response.data.data;
+        },
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: ["roles"] });
+        },
+    });
+}
+/**
+ * Replace a role by ID.
+ * @param {number} id ID.
+ * @param {ReplaceRoleDTO} dto DTO containing details.
+ * @returns {UseMutationResult<Role, Error, { id: number; dto: ReplaceRoleDTO }>} The mutation result.
+ */
+export function useReplaceRole() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ id, dto }) => {
+            const response = await apiClient.put(`${PATH}/${id}`, dto);
+            return response.data.data;
+        },
+        onSuccess: (_, { id }) => {
+            queryClient.invalidateQueries({ queryKey: ["roles"] });
+            queryClient.invalidateQueries({ queryKey: ["roles", id] });
+        },
+    });
+}
+/**
+ * Update a role by ID.
+ * @param {number} id ID.
+ * @param {UpdateRoleDTO} dto DTO containing details.
+ * @returns {UseMutationResult<Role, Error, { id: number; dto: UpdateRoleDTO }>} The mutation result.
+ */
+export function useUpdateRole() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ id, dto }) => {
+            const response = await apiClient.patch(`${PATH}/${id}`, dto);
+            return response.data.data;
+        },
+        onSuccess: (_, { id }) => {
+            queryClient.invalidateQueries({ queryKey: ["roles"] });
+            queryClient.invalidateQueries({ queryKey: ["roles", id] });
+        },
+    });
+}
+/**
+ * Delete a role by ID.
+ * @param {number} dto DTO containing details.
+ * @returns {UseMutationResult<Role, Error, number>} The mutation result.
+ */
+export function useDeleteRole() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (id) => {
+            const response = await apiClient.delete(`${PATH}/${id}`);
+            return response.data.data;
+        },
+        onSuccess: (_, id) => {
+            queryClient.invalidateQueries({ queryKey: ["roles"] });
+            queryClient.invalidateQueries({ queryKey: ["roles", id] });
+        },
+    });
+}
+/**
+ * Get the permissions for a role by ID.
+ * @param {number} id id parameter.
+ * @returns {UseQueryResult<Role>} The query result.
+ */
+export function useRolePermissions(id) {
+    return useQuery({
+        queryKey: ["roles", id, "permissions"],
+        queryFn: async () => {
+            const response = await apiClient.get(`${PATH}/${id}/permissions`);
+            return response.data.data;
+        },
+        enabled: !!id,
+    });
+}
+/**
+ * Add permissions to a role.
+ *
+ * @param {number} id ID.
+ * @param {AddRolePermissionsDTO} dto DTO containing details.
+ * @returns {UseMutationResult<Role, Error, { id: number; dto: AddRolePermissionsDTO }>} The mutation result.
+ */
+export function useAddRolePermissions() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ id, dto }) => {
+            const response = await apiClient.post(`${PATH}/${id}/permissions`, dto);
+            return response.data.data;
+        },
+        onSuccess: (_, { id }) => {
+            queryClient.invalidateQueries({ queryKey: ["roles", id, "permissions"] });
+        },
+    });
+}

package/dist/roles/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./hooks/useRoles";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/roles/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./role";
+//# sourceMappingURL=index.d.ts.map

package/dist/roles/types/index.d.ts.map

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

package/dist/roles/types/role.d.ts

@@ -0,0 +1,23 @@
+export interface Role {
+    id: number;
+    name: string;
+    description?: string | null;
+    permissions?: Permission[];
+}
+export interface CreateRoleDTO {
+    name: string;
+    description?: string | null;
+}
+export interface ReplaceRoleDTO {
+    name: string;
+    description?: string | null;
+}
+export interface UpdateRoleDTO {
+    name?: string | null;
+    description?: string | null;
+}
+export interface AddRolePermissionsDTO {
+    ids: number[];
+}
+import type { Permission } from "../../permissions/types/permission";
+//# sourceMappingURL=role.d.ts.map

package/dist/roles/types/role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../src/roles/types/role.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAGD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/roles/types/role.js

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

package/dist/ticket/hooks/useTickets.d.ts

@@ -0,0 +1,27 @@
+import { CreateTicketRequest, CreateTicketResponse, TicketResponse, TicketSearchFilters, UpdateTicketStatusRequest, UpdateTicketStatusResponse } from "../types/ticket";
+export declare const TICKET_KEYS: {
+    all: readonly ["tickets"];
+    list: (filters: TicketSearchFilters) => readonly ["tickets", "list", TicketSearchFilters];
+};
+/**
+ * Get all tickets.
+ * @param {TicketSearchFilters} filters filters parameter.
+ * @returns {UseQueryResult<TicketResponse[]>} The query result.
+ */
+export declare const useTickets: (filters?: TicketSearchFilters) => import("@tanstack/react-query").UseQueryResult<TicketResponse[], Error>;
+/**
+ * Create a new ticket.
+ * @param {CreateTicketRequest} payload The ticket creation details.
+ * @returns {UseMutationResult<CreateTicketResponse, Error, CreateTicketRequest>} The mutation result.
+ */
+export declare const useCreateTicket: () => import("@tanstack/react-query").UseMutationResult<CreateTicketResponse, Error, CreateTicketRequest, unknown>;
+/**
+ * Update a ticket's status.
+ * @param {{ ticketId: string; payload: UpdateTicketStatusRequest }} params The ticket ID and status update payload.
+ * @returns {UseMutationResult<UpdateTicketStatusResponse, Error, { ticketId: string; payload: UpdateTicketStatusRequest }>} The mutation result.
+ */
+export declare const useUpdateTicketStatus: () => import("@tanstack/react-query").UseMutationResult<UpdateTicketStatusResponse, Error, {
+    ticketId: string;
+    payload: UpdateTicketStatusRequest;
+}, unknown>;
+//# sourceMappingURL=useTickets.d.ts.map

package/dist/ticket/hooks/useTickets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTickets.d.ts","sourceRoot":"","sources":["../../../src/ticket/hooks/useTickets.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AAKzB,eAAO,MAAM,WAAW;;oBAEN,mBAAmB;CAEpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,UAAS,mBAAwB,4EAW3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,oHAkB3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;cAQlB,MAAM;aACP,yBAAyB;WAWvC,CAAC"}

package/dist/ticket/hooks/useTickets.js

@@ -0,0 +1,57 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { apiClient } from "../../api";
+const PATH = "/tickets";
+// Query keys
+export const TICKET_KEYS = {
+    all: ["tickets"],
+    list: (filters) => [...TICKET_KEYS.all, "list", filters],
+};
+/**
+ * Get all tickets.
+ * @param {TicketSearchFilters} filters filters parameter.
+ * @returns {UseQueryResult<TicketResponse[]>} The query result.
+ */
+export const useTickets = (filters = {}) => {
+    return useQuery({
+        queryKey: TICKET_KEYS.list(filters),
+        queryFn: async () => {
+            const response = await apiClient.get(`${PATH}/`, { params: filters });
+            return response.data.data;
+        },
+    });
+};
+/**
+ * Create a new ticket.
+ * @param {CreateTicketRequest} payload The ticket creation details.
+ * @returns {UseMutationResult<CreateTicketResponse, Error, CreateTicketRequest>} The mutation result.
+ */
+export const useCreateTicket = () => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (payload) => {
+            const response = await apiClient.post(`${PATH}/`, payload);
+            return response.data.data;
+        },
+        onSuccess: () => {
+            // Invalidate tickets list queries on success
+            queryClient.invalidateQueries({ queryKey: TICKET_KEYS.all });
+        },
+    });
+};
+/**
+ * Update a ticket's status.
+ * @param {{ ticketId: string; payload: UpdateTicketStatusRequest }} params The ticket ID and status update payload.
+ * @returns {UseMutationResult<UpdateTicketStatusResponse, Error, { ticketId: string; payload: UpdateTicketStatusRequest }>} The mutation result.
+ */
+export const useUpdateTicketStatus = () => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ ticketId, payload, }) => {
+            const response = await apiClient.patch(`${PATH}/${ticketId}/status`, payload);
+            return response.data.data;
+        },
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: TICKET_KEYS.all });
+        },
+    });
+};

package/dist/ticket/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types/ticket";
+export * from "./hooks/useTickets";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ticket/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/ticket/types/ticket.d.ts

@@ -0,0 +1,74 @@
+export type TicketType = "issue" | "access" | "new_feature";
+export type TicketCriticality = "high" | "medium" | "low";
+export type TicketStatus = "open" | "in_progress" | "waiting_for_provider" | "waiting_for_validation" | "finished";
+export interface CreateTicketRequest {
+    triage_id: string;
+    type: TicketType;
+    criticality: TicketCriticality;
+    product: string;
+    description: string;
+    chat_ids: string[];
+    client_id: string;
+}
+export interface CreateTicketResponse {
+    id: string;
+    status: TicketStatus;
+    creation_date: string;
+}
+export interface TicketSearchFilters {
+    ticket_id?: string;
+    client_id?: string;
+    triage_id?: string;
+    status?: TicketStatus;
+    criticality?: TicketCriticality;
+    type?: TicketType;
+    product?: string;
+}
+export interface TicketCompanyResponse {
+    id: string;
+    name: string;
+}
+export interface TicketClientResponse {
+    id: string;
+    name: string;
+    email: string;
+    company: TicketCompanyResponse;
+}
+export interface TicketHistoryResponse {
+    agent_id: string;
+    name: string;
+    level: string;
+    assignment_date: string;
+    exit_date: string;
+    transfer_reason: string;
+}
+export interface TicketCommentResponse {
+    comment_id: string;
+    author: string;
+    text: string;
+    date: string;
+    internal: boolean;
+}
+export interface TicketResponse {
+    id: string;
+    triage_id: string;
+    type: TicketType;
+    criticality: TicketCriticality;
+    product: string;
+    status: TicketStatus;
+    creation_date: string;
+    description: string;
+    chat_ids: string[];
+    agent_history: TicketHistoryResponse[];
+    client: TicketClientResponse;
+    comments: TicketCommentResponse[];
+}
+export interface UpdateTicketStatusRequest {
+    status: TicketStatus;
+}
+export interface UpdateTicketStatusResponse {
+    id: string;
+    previous_status: TicketStatus;
+    current_status: TicketStatus;
+}
+//# sourceMappingURL=ticket.d.ts.map

package/dist/ticket/types/ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.d.ts","sourceRoot":"","sources":["../../../src/ticket/types/ticket.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAC1D,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,aAAa,GACb,sBAAsB,GACtB,wBAAwB,GACxB,UAAU,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,YAAY,CAAC;IAC9B,cAAc,EAAE,YAAY,CAAC;CAC9B"}

package/dist/ticket/types/ticket.js

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

package/dist/users/hooks/useUsers.d.ts

@@ -0,0 +1,46 @@
+import { User, CreateUserDTO, ReplaceUserDTO, UpdateUserDTO, AddUserRolesDTO } from "../types/user";
+/**
+ * Get all users.
+ * @returns {UseQueryResult<User[]>} The query result.
+ */
+export declare const useGetUsers: () => import("@tanstack/react-query").UseQueryResult<User[], Error>;
+/**
+ * Get one user.
+ * @param {string} id id parameter.
+ * @returns {UseQueryResult<User>} The query result.
+ */
+export declare const useGetUser: (id: string) => import("@tanstack/react-query").UseQueryResult<User, Error>;
+/**
+ * Create a user.
+ * @param {CreateUserDTO} user The user creation details.
+ * @returns {UseMutationResult<User, Error, CreateUserDTO>} The mutation result.
+ */
+export declare const useCreateUser: () => import("@tanstack/react-query").UseMutationResult<User, Error, CreateUserDTO, unknown>;
+/**
+ * Replace an entire user.
+ * @param {{ id: string; data: ReplaceUserDTO }} params The ID and user replacement data.
+ * @returns {UseMutationResult<User, Error, { id: string; data: ReplaceUserDTO }>} The mutation result.
+ */
+export declare const useUpdateUser: () => import("@tanstack/react-query").UseMutationResult<User, Error, {
+    id: string;
+    data: ReplaceUserDTO;
+}, unknown>;
+/**
+ * Update specific fields of a user.
+ * @param {{ id: string; data: UpdateUserDTO }} params The ID and user update data.
+ * @returns {UseMutationResult<User, Error, { id: string; data: UpdateUserDTO }>} The mutation result.
+ */
+export declare const usePatchUser: () => import("@tanstack/react-query").UseMutationResult<User, Error, {
+    id: string;
+    data: UpdateUserDTO;
+}, unknown>;
+/**
+ * Add roles to a user.
+ * @param {{ id: string; data: AddUserRolesDTO }} params The ID and user roles data.
+ * @returns {UseMutationResult<User, Error, { id: string; data: AddUserRolesDTO }>} The mutation result.
+ */
+export declare const useAddUserRoles: () => import("@tanstack/react-query").UseMutationResult<User, Error, {
+    id: string;
+    data: AddUserRolesDTO;
+}, unknown>;
+//# sourceMappingURL=useUsers.d.ts.map

package/dist/users/hooks/useUsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUsers.d.ts","sourceRoot":"","sources":["../../../src/users/hooks/useUsers.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,IAAI,EACJ,aAAa,EACb,cAAc,EACd,aAAa,EACb,eAAe,EAChB,MAAM,eAAe,CAAC;AAIvB;;;GAGG;AACH,eAAO,MAAM,WAAW,qEAUvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,IAAI,MAAM,gEASpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,8FAazB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa;QAQhB,MAAM;UACJ,cAAc;WAazB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY;QAQf,MAAM;UACJ,aAAa;WAaxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe;QAQlB,MAAM;UACJ,eAAe;WAa1B,CAAC"}

package/dist/users/hooks/useUsers.js

@@ -0,0 +1,105 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { apiClient } from "../../api";
+const PATH = "/users";
+/**
+ * Get all users.
+ * @returns {UseQueryResult<User[]>} The query result.
+ */
+export const useGetUsers = () => {
+    return useQuery({
+        queryKey: ["users"],
+        queryFn: async () => {
+            const response = await apiClient.get(PATH);
+            return response.data.data;
+        },
+        // staleTime: // ms
+        // gcTime: ,  //
+    });
+};
+/**
+ * Get one user.
+ * @param {string} id id parameter.
+ * @returns {UseQueryResult<User>} The query result.
+ */
+export const useGetUser = (id) => {
+    return useQuery({
+        queryKey: ["users", id],
+        queryFn: async () => {
+            const response = await apiClient.get(`${PATH}/${id}`);
+            return response.data.data;
+        },
+        enabled: !!id, // Prevent the query from running if the ID is missing
+    });
+};
+/**
+ * Create a user.
+ * @param {CreateUserDTO} user The user creation details.
+ * @returns {UseMutationResult<User, Error, CreateUserDTO>} The mutation result.
+ */
+export const useCreateUser = () => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (user) => {
+            const response = await apiClient.post(PATH, user);
+            return response.data.data;
+        },
+        // Tell React Query to refresh the 'users' list after a successful creation.
+        onSuccess: () => {
+            queryClient.invalidateQueries({ queryKey: ["users"] });
+        },
+    });
+};
+/**
+ * Replace an entire user.
+ * @param {{ id: string; data: ReplaceUserDTO }} params The ID and user replacement data.
+ * @returns {UseMutationResult<User, Error, { id: string; data: ReplaceUserDTO }>} The mutation result.
+ */
+export const useUpdateUser = () => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ id, data, }) => {
+            const response = await apiClient.put(`${PATH}/${id}`, data);
+            return response.data.data;
+        },
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({ queryKey: ["users"] });
+            queryClient.invalidateQueries({ queryKey: ["users", variables.id] });
+        },
+    });
+};
+/**
+ * Update specific fields of a user.
+ * @param {{ id: string; data: UpdateUserDTO }} params The ID and user update data.
+ * @returns {UseMutationResult<User, Error, { id: string; data: UpdateUserDTO }>} The mutation result.
+ */
+export const usePatchUser = () => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ id, data, }) => {
+            const response = await apiClient.patch(`${PATH}/${id}`, data);
+            return response.data.data;
+        },
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({ queryKey: ["users"] });
+            queryClient.invalidateQueries({ queryKey: ["users", variables.id] });
+        },
+    });
+};
+/**
+ * Add roles to a user.
+ * @param {{ id: string; data: AddUserRolesDTO }} params The ID and user roles data.
+ * @returns {UseMutationResult<User, Error, { id: string; data: AddUserRolesDTO }>} The mutation result.
+ */
+export const useAddUserRoles = () => {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ id, data, }) => {
+            const response = await apiClient.post(`${PATH}/${id}/roles`, data);
+            return response.data.data;
+        },
+        onSuccess: (_, variables) => {
+            queryClient.invalidateQueries({ queryKey: ["users"] });
+            queryClient.invalidateQueries({ queryKey: ["users", variables.id] });
+        },
+    });
+};

package/dist/users/index.d.ts

@@ -0,0 +1,3 @@
+export { useGetUsers, useGetUser, useCreateUser, useUpdateUser, usePatchUser, useAddUserRoles, } from "./hooks/useUsers";
+export type { User, CreateUserDTO, UpdateUserDTO, ReplaceUserDTO, AddUserRolesDTO, } from "./types/user";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/users/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,IAAI,EACJ,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/users/index.js

@@ -0,0 +1 @@
+export { useGetUsers, useGetUser, useCreateUser, useUpdateUser, usePatchUser, useAddUserRoles, } from "./hooks/useUsers";

package/dist/users/types/user.d.ts

@@ -0,0 +1,30 @@
+import { OAuthProvider } from "../../auth/types/auth";
+export interface User {
+    id: string;
+    email: string;
+    username?: string | null;
+    name?: string | null;
+    oauth_provider?: OAuthProvider | null;
+    oauth_provider_id?: string | null;
+    is_active: boolean;
+    is_verified: boolean;
+    roles?: Role[];
+}
+import type { Role } from "../../roles/types/role";
+export interface CreateUserDTO {
+    email: string;
+    password_hash?: string | null;
+    username?: string | null;
+    name?: string | null;
+    oauth_provider?: OAuthProvider | null;
+    oauth_provider_id?: string | null;
+    is_active?: boolean;
+    is_verified?: boolean;
+    role_ids?: number[];
+}
+export type UpdateUserDTO = Partial<CreateUserDTO>;
+export type ReplaceUserDTO = CreateUserDTO;
+export interface AddUserRolesDTO {
+    role_ids: number[];
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/users/types/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/users/types/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAGnD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/users/types/user.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titus-system/syncdesk",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "",
   "keywords": [],
   "author": "",
@@ -41,5 +41,8 @@
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "typescript": "^6.0.2"
-  }
+  },
+  "files": [
+    "dist"
+  ]
 }

package/.editorconfig

@@ -1,53 +0,0 @@
-# EditorConfig is awesome: http://EditorConfig.org
-# 1st version comes from a Gist by @avandrevitor [here](https://gist.github.com/avandrevitor/b917770334af3a43cf8c489f93287a84)
-#
-# Extended version is available in [WesleyGoncalves' GitHub Gist](https://gist.githubusercontent.com/WesleyGoncalves/ae64d95f663a15d8df455d1f0e5f7687)
-#
-# Be aware that:
-# > Comments should go in individual lines, **we are not sure whether appending comments may cause issues**.
-# Emphasis added. [link](https://github.com/editorconfig/editorconfig/wiki/Syntax)
-#
-#
-# You can download this file
-# directly to your project from the command-line
-# curl -O https://gist.githubusercontent.com/WesleyGoncalves/ae64d95f663a15d8df455d1f0e5f7687/raw/.editorconfig
-
-# top-most EditorConfig file
-root = true
-
-# All PHP files MUST use the Unix LF (linefeed) line ending.
-# Code MUST use an indent of 4 spaces, and MUST NOT use tabs for indenting.
-# All PHP files MUST end with a single blank line.
-# There MUST NOT be trailing whitespace at the end of non-blank lines.
-[*]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-# PHP-Files | Python | Java
-[*.{php,py,java}]
-indent_style = space
-indent_size = 4
-
-[composer.json,docker-compose.yml]
-indent_style = space
-indent_size = 4
-
-# **NOT IMPLEMENTED BY editorConfig** PHP-Files. See [this for further information](https://github.com/editorconfig/editorconfig/wiki/EditorConfig-Properties#ideas-for-domain-specific-properties)
-[*.php]
-curly_bracket_next_line = true
-indent_brace_style = K&R
-spaces_around_operators = true
-# block_comment_start = '/*'
-# block_comment_end = '*/'
-# line_comment = '//'
-
-# BLADE-Files | MD | HTML | LESS | SASS | CSS | JS | JSX | TS | TSX | JSON | ReST | YAML | TXT
-[*.{blade.php,md,html,less,sass,scss,css,js{x,},ts{x,},json,rst,y{a,}ml,txt}]
-indent_style = space
-indent_size = 2
-
-[{package.json}]
-indent_style = space
-indent_size = 2

package/.github/workflows/notify-main.yml

@@ -1,17 +0,0 @@
-name: Notify Main Repo
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  dispatch:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Repository Dispatch
-        uses: peter-evans/repository-dispatch@v3
-        with:
-          token: ${{ secrets.PAT_TOKEN }}
-          repository: Titus-System/SyncDesk
-          event-type: submodule_update