@go-avro/avro-js 0.0.2-beta.35 → 0.0.2-beta.37

package/README.md

@@ -10,6 +10,7 @@ This SDK provides:
 - Typed API interfaces for Avro entities (users, jobs, teams, etc.)
 - Pluggable token storage (in-memory, localStorage, SecureStore, etc.)
 - XHR-based requests for compatibility with React Native WebViews and older environments
+- Mutation and Data Hooks for easy plug-in use in React and React Native projects.
 
 ## Installation
 

package/dist/client/QueryClient.d.ts

@@ -1,6 +1,8 @@
 import { AuthManager } from '../auth/AuthManager';
-import { LineItem } from '../types/api';
+import { _Event, Bill, Company, Job, LineItem, ServiceMonth, User } from '../types/api';
 import { CancelToken, RetryStrategy } from '../types/client';
+import { StandardError } from '../types/error';
+import { InfiniteData, UseInfiniteQueryResult, useMutation, useQuery, UseQueryResult } from '@tanstack/react-query';
 export interface AvroQueryClientConfig {
     baseUrl: string;
     authManager: AuthManager;
@@ -8,12 +10,75 @@ export interface AvroQueryClientConfig {
     retryStrategy?: RetryStrategy;
     timeout?: number;
 }
+declare module '../client/QueryClient' {
+    interface AvroQueryClient {
+        _xhr<T>(method: string, path: string, body: any, cancelToken?: CancelToken, headers?: Record<string, string>, isIdempotent?: boolean, retryCount?: number): Promise<T>;
+        _fetch<T>(method: string, path: string, body: any, cancelToken?: CancelToken, headers?: Record<string, string>, isIdempotent?: boolean, retryCount?: number): Promise<T>;
+        getDelay(strategy: RetryStrategy, attempt: number): number;
+        useGetRoot(): ReturnType<typeof useQuery>;
+        useGetJobs(companyGuid: string, body: {
+            amt?: number;
+            query?: string;
+        }, total: number, onProgress?: (fraction: number) => void, isMainLoad?: boolean): UseQueryResult<Job[], StandardError>;
+        useGetRoutes(companyGuid: string, body: {
+            amt?: number;
+            query?: string;
+        }, total: number, onProgress?: (fraction: number) => void): UseQueryResult<any[], StandardError>;
+        useGetEvents(companyGuid: string, body: {
+            amt?: number;
+            known_ids?: string[];
+            unknown_ids?: string[];
+            query?: string;
+            unbilled?: boolean;
+            billed?: boolean;
+            paid?: boolean;
+            jobId?: string;
+        }): UseInfiniteQueryResult<InfiniteData<_Event[], unknown>, Error>;
+        useGetMonths(companyGuid: string, body: {
+            amt?: number;
+            known_ids?: string[];
+            unknown_ids?: string[];
+            query?: string;
+            unbilled?: boolean;
+            billed?: boolean;
+            paid?: boolean;
+            jobId?: string;
+        }): UseInfiniteQueryResult<InfiniteData<ServiceMonth[], unknown>, Error>;
+        useGetBills(companyGuid: string, body: {
+            amt?: number;
+            known_ids?: string[];
+            unknown_ids?: string[];
+            query?: string;
+            paid?: boolean;
+        }): UseInfiniteQueryResult<InfiniteData<Bill[], unknown>, Error>;
+        useGetCompanies(options?: {}): UseQueryResult<{
+            name: string;
+            id: string;
+        }[], StandardError>;
+        useGetCompany(companyId: string): UseQueryResult<Company, StandardError>;
+        useGetJob(jobId: string): UseQueryResult<Job, StandardError>;
+        useGetEvent(eventId: string): UseQueryResult<_Event, StandardError>;
+        useGetUser(userId: string): UseQueryResult<User, StandardError>;
+        useGetSelf(): UseQueryResult<User, StandardError>;
+        useGetBill(billId: string): UseQueryResult<Bill, StandardError>;
+        useUpdateJob(): ReturnType<typeof useMutation<unknown, unknown, {
+            jobId: string;
+            updates: Partial<Job>;
+        }, unknown>>;
+        useDeleteJob(): ReturnType<typeof useMutation<unknown, unknown, {
+            jobId: string;
+        }, unknown>>;
+        useCreateJob(): ReturnType<typeof useMutation<{
+            id: string;
+        }, unknown, {
+            companyId: string;
+            jobData: Partial<Job>;
+        }, unknown>>;
+    }
+}
 export declare class AvroQueryClient {
-    private config;
+    protected config: Required<AvroQueryClientConfig>;
     constructor(config: AvroQueryClientConfig);
-    getDelay(strategy: RetryStrategy, attempt: number): number;
-    private _xhr;
-    private _fetch;
     get<T>(path: string, cancelToken?: CancelToken, headers?: Record<string, string>): Promise<T>;
     post<T>(path: string, data: any, cancelToken?: CancelToken, headers?: Record<string, string>): Promise<T>;
     put<T>(path: string, data: any, cancelToken?: CancelToken, headers?: Record<string, string>): Promise<T>;

package/dist/client/QueryClient.js

@@ -9,166 +9,6 @@ export class AvroQueryClient {
             timeout: config.timeout ?? 0,
         };
     }
-    getDelay(strategy, attempt) {
-        if (typeof strategy === 'function') {
-            return strategy(attempt);
-        }
-        else if (strategy === 'fixed') {
-            return 1000;
-        }
-        else if (strategy === 'exponential') {
-            return Math.pow(2, attempt) * 100;
-        }
-        throw new Error(`Invalid retry strategy: ${strategy}`);
-    }
-    _xhr(method, path, body, cancelToken, headers = {}, isIdempotent = false, retryCount = 0) {
-        const checkCancelled = () => {
-            if (cancelToken?.isCancelled()) {
-                return new StandardError(0, 'Request cancelled');
-            }
-            return null;
-        };
-        return new Promise((resolve, reject) => {
-            this.config.authManager.accessToken().then(token => {
-                const cancelErr = checkCancelled();
-                if (cancelErr)
-                    return reject(cancelErr);
-                const xhr = new XMLHttpRequest();
-                const url = this.config.baseUrl + path;
-                xhr.open(method, url, true);
-                if (token) {
-                    xhr.setRequestHeader('Authorization', `Bearer ${token}`);
-                }
-                Object.entries(headers).forEach(([key, value]) => {
-                    xhr.setRequestHeader(key, value);
-                });
-                xhr.onload = () => {
-                    const cancelErr = checkCancelled();
-                    if (cancelErr)
-                        return reject(cancelErr);
-                    if (xhr.status === 401 && this.config.authManager.refreshTokens && retryCount === 0) {
-                        this.config.authManager
-                            .refreshTokens()
-                            .then(() => {
-                            this._xhr(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1).then(resolve, reject);
-                        })
-                            .catch(() => {
-                            reject(new StandardError(401, 'Unauthorized (refresh failed)'));
-                        });
-                        return;
-                    }
-                    if (xhr.status >= 200 && xhr.status < 300) {
-                        try {
-                            resolve(JSON.parse(xhr.responseText));
-                        }
-                        catch {
-                            resolve(xhr.responseText);
-                        }
-                    }
-                    else {
-                        if (retryCount < this.config.maxRetries) {
-                            const delay = this.getDelay(this.config.retryStrategy, retryCount);
-                            setTimeout(() => {
-                                this._xhr(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1).then(resolve, reject);
-                            }, delay);
-                        }
-                        else {
-                            let msg = xhr.statusText;
-                            try {
-                                const parsed = JSON.parse(xhr.responseText);
-                                msg = parsed.msg || msg;
-                            }
-                            catch {
-                                console.warn('Failed to parse error response:', xhr.responseText);
-                            }
-                            reject(new StandardError(xhr.status, msg));
-                        }
-                    }
-                };
-                xhr.onerror = () => {
-                    if (retryCount < this.config.maxRetries) {
-                        const delay = this.getDelay(this.config.retryStrategy, retryCount);
-                        setTimeout(() => {
-                            this._xhr(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1).then(resolve, reject);
-                        }, delay);
-                    }
-                    else {
-                        reject(new StandardError(0, 'Network Error'));
-                    }
-                };
-                if (this.config.timeout) {
-                    xhr.timeout = this.config.timeout;
-                    xhr.ontimeout = () => reject(new StandardError(0, 'Request timed out'));
-                }
-                xhr.send(body);
-            });
-        });
-    }
-    _fetch(method, path, body, cancelToken, headers = {}, isIdempotent = false, retryCount = 0) {
-        const checkCancelled = () => {
-            try {
-                if (cancelToken?.isCancelled()) {
-                    return new StandardError(0, 'Request cancelled');
-                }
-            }
-            catch (error) {
-                throw new StandardError(0, `Error checking cancellation (${typeof cancelToken}): ${error}`);
-            }
-            return null;
-        };
-        return this.config.authManager.accessToken().then(token => {
-            const cancelErr = checkCancelled();
-            if (cancelErr)
-                return Promise.reject(cancelErr);
-            const url = this.config.baseUrl + path;
-            const requestHeaders = {
-                'Content-Type': 'application/json',
-                ...headers,
-            };
-            if (token) {
-                requestHeaders['Authorization'] = `Bearer ${token}`;
-            }
-            const options = {
-                method,
-                headers: requestHeaders,
-                body: body ? JSON.stringify(body) : null,
-            };
-            return fetch(url, options).then(response => {
-                if (response.status === 401 && this.config.authManager.refreshTokens && retryCount === 0) {
-                    return this.config.authManager
-                        .refreshTokens()
-                        .then(() => this._fetch(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1))
-                        .catch(() => Promise.reject(new StandardError(401, 'Unauthorized (refresh failed)')));
-                }
-                if (!response.ok) {
-                    if (retryCount < this.config.maxRetries) {
-                        const delay = this.getDelay(this.config.retryStrategy, retryCount);
-                        return new Promise((resolve, reject) => {
-                            setTimeout(() => {
-                                this._fetch(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1)
-                                    .then(resolve)
-                                    .catch(reject);
-                            }, delay);
-                        });
-                    }
-                    else {
-                        return response.text().then(text => {
-                            let msg = response.statusText;
-                            try {
-                                const parsed = JSON.parse(text);
-                                msg = parsed.message || msg;
-                            }
-                            catch {
-                                console.warn('Failed to parse error response:', text);
-                            }
-                            throw new StandardError(response.status, msg);
-                        });
-                    }
-                }
-                return response.json();
-            });
-        });
-    }
     get(path, cancelToken, headers = {}) {
         return this._xhr('GET', path, null, cancelToken, headers, true);
     }

package/dist/client/core/fetch.d.ts

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

package/dist/client/core/fetch.js

@@ -0,0 +1,67 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { StandardError } from '../../types/error';
+AvroQueryClient.prototype._fetch = function (method, path, body, cancelToken, headers = {}, isIdempotent = false, retryCount = 0) {
+    const checkCancelled = () => {
+        try {
+            if (cancelToken?.isCancelled()) {
+                return new StandardError(0, 'Request cancelled');
+            }
+        }
+        catch (error) {
+            throw new StandardError(0, `Error checking cancellation (${typeof cancelToken}): ${error}`);
+        }
+        return null;
+    };
+    return this.config.authManager.accessToken().then(token => {
+        const cancelErr = checkCancelled();
+        if (cancelErr)
+            return Promise.reject(cancelErr);
+        const url = this.config.baseUrl + path;
+        const requestHeaders = {
+            'Content-Type': 'application/json',
+            ...headers,
+        };
+        if (token) {
+            requestHeaders['Authorization'] = `Bearer ${token}`;
+        }
+        const options = {
+            method,
+            headers: requestHeaders,
+            body: body ? JSON.stringify(body) : null,
+        };
+        return fetch(url, options).then(response => {
+            if (response.status === 401 && this.config.authManager.refreshTokens && retryCount === 0) {
+                return this.config.authManager
+                    .refreshTokens()
+                    .then(() => this._fetch(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1))
+                    .catch(() => Promise.reject(new StandardError(401, 'Unauthorized (refresh failed)')));
+            }
+            if (!response.ok) {
+                if (retryCount < this.config.maxRetries) {
+                    const delay = this.getDelay(this.config.retryStrategy, retryCount);
+                    return new Promise((resolve, reject) => {
+                        setTimeout(() => {
+                            this._fetch(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1)
+                                .then(resolve)
+                                .catch(reject);
+                        }, delay);
+                    });
+                }
+                else {
+                    return response.text().then(text => {
+                        let msg = response.statusText;
+                        try {
+                            const parsed = JSON.parse(text);
+                            msg = parsed.message || msg;
+                        }
+                        catch {
+                            console.warn('Failed to parse error response:', text);
+                        }
+                        throw new StandardError(response.status, msg);
+                    });
+                }
+            }
+            return response.json();
+        });
+    });
+};

package/dist/client/core/utils.d.ts

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

package/dist/client/core/utils.js

@@ -0,0 +1,13 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+AvroQueryClient.prototype.getDelay = function (strategy, attempt) {
+    if (typeof strategy === 'function') {
+        return strategy(attempt);
+    }
+    else if (strategy === 'fixed') {
+        return 1000;
+    }
+    else if (strategy === 'exponential') {
+        return Math.pow(2, attempt) * 100;
+    }
+    throw new Error(`Invalid retry strategy: ${strategy}`);
+};

package/dist/client/core/xhr.d.ts

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

package/dist/client/core/xhr.js

@@ -0,0 +1,80 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { StandardError } from '../../types/error';
+AvroQueryClient.prototype._xhr = function (method, path, body, cancelToken, headers = {}, isIdempotent = false, retryCount = 0) {
+    const checkCancelled = () => {
+        if (cancelToken?.isCancelled()) {
+            return new StandardError(0, 'Request cancelled');
+        }
+        return null;
+    };
+    return new Promise((resolve, reject) => {
+        this.config.authManager.accessToken().then(token => {
+            const cancelErr = checkCancelled();
+            if (cancelErr)
+                return reject(cancelErr);
+            const xhr = new XMLHttpRequest();
+            const url = this.config.baseUrl + path;
+            xhr.open(method, url, true);
+            if (token)
+                xhr.setRequestHeader('Authorization', `Bearer ${token}`);
+            Object.entries(headers).forEach(([key, value]) => xhr.setRequestHeader(key, value));
+            xhr.onload = () => {
+                const cancelErr = checkCancelled();
+                if (cancelErr)
+                    return reject(cancelErr);
+                if (xhr.status === 401 && this.config.authManager.refreshTokens && retryCount === 0) {
+                    this.config.authManager
+                        .refreshTokens()
+                        .then(() => {
+                        this._xhr(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1).then(resolve, reject);
+                    })
+                        .catch(() => reject(new StandardError(401, 'Unauthorized (refresh failed)')));
+                    return;
+                }
+                if (xhr.status >= 200 && xhr.status < 300) {
+                    try {
+                        resolve(JSON.parse(xhr.responseText));
+                    }
+                    catch {
+                        resolve(xhr.responseText);
+                    }
+                }
+                else {
+                    if (retryCount < this.config.maxRetries) {
+                        const delay = this.getDelay(this.config.retryStrategy, retryCount);
+                        setTimeout(() => {
+                            this._xhr(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1).then(resolve, reject);
+                        }, delay);
+                    }
+                    else {
+                        let msg = xhr.statusText;
+                        try {
+                            const parsed = JSON.parse(xhr.responseText);
+                            msg = parsed.msg || msg;
+                        }
+                        catch {
+                            console.warn('Failed to parse error response:', xhr.responseText);
+                        }
+                        reject(new StandardError(xhr.status, msg));
+                    }
+                }
+            };
+            xhr.onerror = () => {
+                if (retryCount < this.config.maxRetries) {
+                    const delay = this.getDelay(this.config.retryStrategy, retryCount);
+                    setTimeout(() => {
+                        this._xhr(method, path, body, cancelToken, headers, isIdempotent, retryCount + 1).then(resolve, reject);
+                    }, delay);
+                }
+                else {
+                    reject(new StandardError(0, 'Network Error'));
+                }
+            };
+            if (this.config.timeout) {
+                xhr.timeout = this.config.timeout;
+                xhr.ontimeout = () => reject(new StandardError(0, 'Request timed out'));
+            }
+            xhr.send(body);
+        });
+    });
+};

package/dist/client/hooks/bills.d.ts

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

package/dist/client/hooks/bills.js

@@ -0,0 +1,37 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { useQueryClient, useInfiniteQuery, useQuery } from '@tanstack/react-query';
+AvroQueryClient.prototype.useGetBills = function (companyGuid, body) {
+    const queryClient = useQueryClient();
+    const result = useInfiniteQuery({
+        queryKey: [
+            'bills',
+            companyGuid,
+            body.query ?? "",
+            body.known_ids ?? [],
+            body.unknown_ids ?? [],
+            body.paid ?? false,
+        ],
+        initialPageParam: 0,
+        getNextPageParam: (lastPage, allPages) => {
+            if (lastPage.length < (body.amt ?? 50))
+                return undefined;
+            return allPages.flat().length; // next offset
+        },
+        queryFn: ({ pageParam = 0 }) => this.fetchBills(companyGuid, { ...body, offset: pageParam }),
+    });
+    if (result.data) {
+        result.data.pages.forEach((data_page) => {
+            data_page.forEach((bill) => {
+                queryClient.setQueryData(['bill', bill.id], bill);
+            });
+        });
+    }
+    return result;
+};
+AvroQueryClient.prototype.useGetBill = function (billId) {
+    return useQuery({
+        queryKey: ['bill', billId],
+        queryFn: () => this.get(`/bill/${billId}`),
+        enabled: Boolean(billId),
+    });
+};

package/dist/client/hooks/companies.d.ts

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

package/dist/client/hooks/companies.js

@@ -0,0 +1,16 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { useQuery } from '@tanstack/react-query';
+AvroQueryClient.prototype.useGetCompanies = function (options = {}) {
+    return useQuery({
+        queryKey: ['/company/list'],
+        queryFn: () => this.get('/company/list'),
+        ...options,
+    });
+};
+AvroQueryClient.prototype.useGetCompany = function (companyId) {
+    return useQuery({
+        queryKey: ['company', companyId],
+        queryFn: () => this.get(`/company/${companyId}`),
+        enabled: Boolean(companyId),
+    });
+};

package/dist/client/hooks/events.d.ts

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

package/dist/client/hooks/events.js

@@ -0,0 +1,41 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { useQueryClient, useInfiniteQuery, useQuery } from '@tanstack/react-query';
+AvroQueryClient.prototype.useGetEvents = function (companyGuid, body) {
+    const queryClient = useQueryClient();
+    const result = useInfiniteQuery({
+        queryKey: [
+            'events',
+            companyGuid,
+            body.amt ?? 50,
+            body.known_ids ?? [],
+            body.unknown_ids ?? [],
+            body.query ?? '',
+            body.unbilled ?? true,
+            body.billed ?? true,
+            body.paid ?? true,
+            body.jobId ?? '',
+        ],
+        initialPageParam: 0,
+        getNextPageParam: (lastPage, allPages) => {
+            if (lastPage.length < (body.amt ?? 50))
+                return undefined;
+            return allPages.flat().length; // next offset
+        },
+        queryFn: ({ pageParam = 0 }) => this.fetchEvents(companyGuid, { ...body, offset: pageParam }),
+    });
+    if (result.data) {
+        result.data.pages.forEach((data_page) => {
+            data_page.forEach((event) => {
+                queryClient.setQueryData(['event', event.id], event);
+            });
+        });
+    }
+    return result;
+};
+AvroQueryClient.prototype.useGetEvent = function (eventId) {
+    return useQuery({
+        queryKey: ['event', eventId],
+        queryFn: () => this.get(`/event/${eventId}`),
+        enabled: Boolean(eventId),
+    });
+};

package/dist/client/hooks/jobs.d.ts

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

package/dist/client/hooks/jobs.js

@@ -0,0 +1,184 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+AvroQueryClient.prototype.useGetJobs = function (companyGuid, body, total = 0, onProgress, isMainLoad = false) {
+    const queryClient = useQueryClient();
+    return useQuery({
+        queryKey: [isMainLoad ? 'main' : 'jobs', companyGuid, body.amt ?? 50, body.query ?? ""],
+        queryFn: async () => {
+            if (total === 0) {
+                onProgress?.(1);
+                return [];
+            }
+            onProgress?.(0);
+            const pageCount = body.amt ? Math.ceil(total / body.amt) : 0;
+            let completed = 0;
+            const promises = Array.from({ length: pageCount }, (_, i) => this.fetchJobs(companyGuid, {
+                ...body,
+                offset: i * (body.amt ?? 0),
+            }));
+            const trackedPromises = promises.map((promise) => promise.then((result) => {
+                completed++;
+                const fraction = completed / pageCount;
+                onProgress?.(fraction);
+                return result;
+            }));
+            const pages = await Promise.all(trackedPromises);
+            const jobs = pages.flat();
+            jobs.forEach((job) => {
+                job.last_event = job.tasks.reduce((latest, task) => {
+                    return task.last_event && (!latest || task.last_event.time_started > latest.time_started) ? task.last_event : latest;
+                }, null);
+                job.last_completed_event = job.tasks.reduce((latest, task) => {
+                    return task.last_completed_event && (!latest || task.last_completed_event.time_started > latest.time_started) ? task.last_completed_event : latest;
+                }, null);
+                job.overdue_time = job.tasks.reduce((maxOverdue, task) => {
+                    return task.overdue_time && task.overdue_time > maxOverdue ? task.overdue_time : maxOverdue;
+                }, 0);
+                queryClient.setQueryData(['job', job.id], job);
+            });
+            if (isMainLoad) {
+                queryClient.setQueryData(['jobs', companyGuid, body.amt ?? 50, body.query ?? ""], jobs);
+            }
+            return jobs;
+        },
+        enabled: Boolean(companyGuid) && companyGuid.length > 0 && Boolean(total) && total >= 0,
+        ...isMainLoad ? { staleTime: Infinity, cacheTime: Infinity } : {},
+    });
+};
+AvroQueryClient.prototype.useGetJob = function (jobId) {
+    return useQuery({
+        queryKey: ['job', jobId],
+        queryFn: () => this.get(`/job/${jobId}`),
+        enabled: Boolean(jobId),
+    });
+};
+AvroQueryClient.prototype.useCreateJob = function () {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: ({ companyId, jobData }) => {
+            return this.post(`/company/${companyId}/job`, JSON.stringify(jobData), undefined, {
+                "Content-Type": "application/json",
+            });
+        },
+        onMutate: async ({ companyId, jobData }) => {
+            await queryClient.cancelQueries({ queryKey: ['jobs'] });
+            const previousJobs = queryClient.getQueryData(['jobs']);
+            queryClient.setQueryData(['jobs'], (oldData) => {
+                if (!oldData)
+                    return [jobData];
+                if (oldData.pages) {
+                    const firstPage = oldData.pages[0] || [];
+                    return {
+                        ...oldData,
+                        pages: [[jobData, ...firstPage], ...oldData.pages.slice(1)],
+                    };
+                }
+                if (Array.isArray(oldData)) {
+                    return [jobData, ...oldData];
+                }
+                return oldData;
+            });
+            return { previousJobs };
+        },
+        onError: (err, variables, context) => {
+            if (context?.previousJobs) {
+                queryClient.setQueryData(['jobs'], context.previousJobs);
+            }
+        },
+        onSettled: (data, error, variables) => {
+            const { id: jobId } = data ?? {};
+            queryClient.invalidateQueries({ queryKey: ['jobs'] });
+            queryClient.invalidateQueries({ queryKey: ['job', jobId] });
+        },
+    });
+};
+AvroQueryClient.prototype.useUpdateJob = function () {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: ({ jobId, updates }) => {
+            return this.put(`/job/${jobId}`, JSON.stringify(updates), undefined, {
+                "Content-Type": "application/json",
+            });
+        },
+        onMutate: async ({ jobId, updates }) => {
+            await queryClient.cancelQueries({ queryKey: ['jobs'] });
+            await queryClient.cancelQueries({ queryKey: ['job', jobId] });
+            const previousJobs = queryClient.getQueryData(['jobs']);
+            const previousJob = queryClient.getQueryData(['job', jobId]);
+            queryClient.setQueryData(['job', jobId], (oldData) => oldData ? { ...oldData, ...updates } : undefined);
+            queryClient.setQueriesData({ queryKey: ['jobs'] }, (oldData) => {
+                if (!oldData)
+                    return oldData;
+                if (oldData.pages) {
+                    return {
+                        ...oldData,
+                        pages: oldData.pages.map((page) => page.map((job) => job.id === jobId ? { ...job, ...updates } : job)),
+                    };
+                }
+                if (Array.isArray(oldData)) {
+                    return oldData.map((job) => job.id === jobId ? { ...job, ...updates } : job);
+                }
+                return oldData;
+            });
+            return { previousJobs, previousJob };
+        },
+        onError: (err, variables, context) => {
+            const { jobId } = variables;
+            if (context?.previousJobs) {
+                queryClient.setQueryData(['jobs'], context.previousJobs);
+            }
+            if (context?.previousJob) {
+                queryClient.setQueryData(['job', jobId], context.previousJob);
+            }
+        },
+        onSettled: (data, error, variables) => {
+            const { jobId } = variables;
+            queryClient.invalidateQueries({ queryKey: ['jobs'] });
+            queryClient.invalidateQueries({ queryKey: ['job', jobId] });
+        },
+    });
+};
+AvroQueryClient.prototype.useDeleteJob = function () {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ jobId }) => {
+            return this.delete(`/job/${jobId}`, undefined, {
+                "Content-Type": "application/json",
+            });
+        },
+        onMutate: async ({ jobId }) => {
+            await queryClient.cancelQueries({ queryKey: ['jobs'] });
+            await queryClient.cancelQueries({ queryKey: ['job', jobId] });
+            const previousJobs = queryClient.getQueryData(['jobs']);
+            const previousJob = queryClient.getQueryData(['job', jobId]);
+            queryClient.setQueryData(['job', jobId], undefined);
+            queryClient.setQueriesData({ queryKey: ['jobs'] }, (oldData) => {
+                if (!oldData)
+                    return oldData;
+                if (oldData.pages) {
+                    const updatedPages = oldData.pages.map((page) => page.filter((job) => job.id !== jobId));
+                    return { ...oldData, pages: updatedPages };
+                }
+                if (Array.isArray(oldData)) {
+                    return oldData.filter((job) => job.id !== jobId);
+                }
+                return oldData;
+            });
+            return { previousJobs, previousJob };
+        },
+        onError: (_err, variables, context) => {
+            const { jobId } = variables;
+            if (context?.previousJobs) {
+                queryClient.setQueryData(['jobs'], context.previousJobs);
+            }
+            if (context?.previousJob) {
+                queryClient.setQueryData(['job', jobId], context.previousJob);
+            }
+        },
+        onSettled: (_data, _error, variables) => {
+            const { jobId } = variables;
+            queryClient.invalidateQueries({ queryKey: ['jobs'] });
+            queryClient.invalidateQueries({ queryKey: ['job', jobId] });
+        },
+    });
+};

package/dist/client/hooks/months.d.ts

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

package/dist/client/hooks/months.js

@@ -0,0 +1,34 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { useQueryClient, useInfiniteQuery } from '@tanstack/react-query';
+AvroQueryClient.prototype.useGetMonths = function (companyGuid, body) {
+    const queryClient = useQueryClient();
+    const result = useInfiniteQuery({
+        queryKey: [
+            'months',
+            companyGuid,
+            body.amt ?? 50,
+            body.known_ids ?? [],
+            body.unknown_ids ?? [],
+            body.query ?? '',
+            body.unbilled ?? true,
+            body.billed ?? true,
+            body.paid ?? true,
+            body.jobId ?? '',
+        ],
+        initialPageParam: 0,
+        getNextPageParam: (lastPage, allPages) => {
+            if (lastPage.length < (body.amt ?? 50))
+                return undefined;
+            return allPages.flat().length; // next offset
+        },
+        queryFn: ({ pageParam = 0 }) => this.fetchMonths(companyGuid, { ...body, offset: pageParam }),
+    });
+    if (result.data) {
+        result.data.pages.forEach((data_page) => {
+            data_page.forEach((month) => {
+                queryClient.setQueryData(['month', month.id], month);
+            });
+        });
+    }
+    return result;
+};

package/dist/client/hooks/root.d.ts

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

package/dist/client/hooks/root.js

@@ -0,0 +1,8 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { useQuery } from '@tanstack/react-query';
+AvroQueryClient.prototype.useGetRoot = function () {
+    return useQuery({
+        queryKey: ['health'],
+        queryFn: () => this.get('/', undefined) // your async fetch function
+    });
+};

package/dist/client/hooks/routes.d.ts

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

package/dist/client/hooks/routes.js

@@ -0,0 +1,31 @@
+import { AvroQueryClient } from '../../client/QueryClient';
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+AvroQueryClient.prototype.useGetRoutes = function (companyGuid, body, total = 0, onProgress) {
+    const queryClient = useQueryClient();
+    return useQuery({
+        queryKey: ['routes', companyGuid, body.amt ?? 50, body.query ?? ""],
+        queryFn: async () => {
+            if (total === 0) {
+                onProgress?.(1);
+                return [];
+            }
+            onProgress?.(0);
+            const pageCount = body.amt ? Math.ceil(total / body.amt) : 0;
+            let completed = 0;
+            const promises = Array.from({ length: pageCount }, (_, i) => this.fetchRoutes(companyGuid, {
+                ...body,
+                offset: i * (body.amt ?? 0),
+            }));
+            const trackedPromises = promises.map((promise) => promise.then((result) => {
+                completed++;
+                const fraction = completed / pageCount;
+                onProgress?.(fraction);
+                return result;
+            }));
+            const pages = await Promise.all(trackedPromises);
+            const routes = pages.flat();
+            return routes;
+        },
+        enabled: Boolean(companyGuid) && companyGuid.length > 0 && Boolean(total) && total >= 0,
+    });
+};

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

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

package/dist/client/hooks/users.js

@@ -0,0 +1,16 @@
+import { AvroQueryClient } from "../../client/QueryClient";
+import { useQuery } from "@tanstack/react-query";
+AvroQueryClient.prototype.useGetUser = function (userId) {
+    return useQuery({
+        queryKey: ['user', userId],
+        queryFn: () => this.get(`/user/${userId}`),
+        enabled: Boolean(userId),
+    });
+};
+AvroQueryClient.prototype.useGetSelf = function () {
+    return useQuery({
+        queryKey: ['user'],
+        queryFn: () => this.get(`/user`),
+        enabled: Boolean(this),
+    });
+};

package/dist/index.d.ts

@@ -1,6 +1,16 @@
 export { AvroQueryClientConfig, AvroQueryClient } from './client/QueryClient';
 export { AuthManager } from './auth/AuthManager';
 export { MemoryStorage, LocalStorage } from './auth/storage';
+import './client/core/xhr';
+import './client/core/fetch';
+import './client/core/utils';
+import './client/hooks/root';
+import './client/hooks/jobs';
+import './client/hooks/routes';
+import './client/hooks/events';
+import './client/hooks/months';
+import './client/hooks/bills';
+import './client/hooks/companies';
 export * from './types/api';
 export * from './types/error';
 export * from './types/client';

package/dist/index.js

@@ -1,6 +1,16 @@
 export { AvroQueryClient } from './client/QueryClient';
 export { AuthManager } from './auth/AuthManager';
 export { MemoryStorage, LocalStorage } from './auth/storage';
+import './client/core/xhr';
+import './client/core/fetch';
+import './client/core/utils';
+import './client/hooks/root';
+import './client/hooks/jobs';
+import './client/hooks/routes';
+import './client/hooks/events';
+import './client/hooks/months';
+import './client/hooks/bills';
+import './client/hooks/companies';
 export * from './types/api';
 export * from './types/error';
 export * from './types/client';

package/dist/types/api.d.ts

@@ -421,6 +421,7 @@ export interface Job {
     routes: RouteJob[];
     subscribers: Subscription[];
     manual_emails: string[][];
+    overdue_time: number;
     last_completed_event: _Event | null;
     last_event: _Event | null;
     labels: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-avro/avro-js",
-  "version": "0.0.2-beta.35",
+  "version": "0.0.2-beta.37",
   "description": "JS client for Avro backend integration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,6 +33,7 @@
   "license": "CC-BY-SA-4.0",
   "devDependencies": {
     "@types/jest": "^29.0.0",
+    "@types/react": "^19.2.2",
     "@typescript-eslint/eslint-plugin": "^8.38.0",
     "@typescript-eslint/parser": "^8.38.0",
     "eslint": "^8.57.1",
@@ -50,5 +51,8 @@
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@tanstack/react-query": "^5.90.2"
   }
 }