react-shopwave-connect 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +258 -0
- package/dist/core/index.cjs +426 -0
- package/dist/core/index.cjs.map +1 -0
- package/dist/core/index.d.cts +481 -0
- package/dist/core/index.d.ts +481 -0
- package/dist/core/index.js +399 -0
- package/dist/core/index.js.map +1 -0
- package/dist/hooks/index.cjs +783 -0
- package/dist/hooks/index.cjs.map +1 -0
- package/dist/hooks/index.d.cts +424 -0
- package/dist/hooks/index.d.ts +424 -0
- package/dist/hooks/index.js +749 -0
- package/dist/hooks/index.js.map +1 -0
- package/dist/index.cjs +824 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +618 -0
- package/dist/index.d.ts +618 -0
- package/dist/index.js +763 -0
- package/dist/index.js.map +1 -0
- package/package.json +85 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.cjs","names":["merged: Extras","headers: Record<string, string>","extras: Record<string, unknown>","extras: Record<string, unknown>","extras: Record<string, unknown>","result: { [id: number]: Product }","extras: Record<string, unknown>","DEFAULT_BASKET_FILTERS: BasketFilters","DEFAULT_PAGINATION: BasketPagination","whereConditions: string[]","keyIndices: { [key: string]: number }","productSubKeys: { [key: string]: number }","products: BasketItem[]","combinedRows: BasketReportRow[]","productsWithNames: BasketItem[]","map: { [id: number]: Consumer }","useReport","useConsumer","rows: BasketReportRow[]","summary: BasketSummary"],"sources":["../../src/core/request.ts","../../src/core/category.ts","../../src/core/consumer.ts","../../src/core/employee.ts","../../src/core/product.ts","../../src/core/promotion.ts","../../src/core/store.ts","../../src/core/report.ts","../../src/core/session.ts","../../src/core/entity.ts","../../src/core/basket.ts","../../src/hooks/shared.ts","../../src/hooks/useCategory.ts","../../src/hooks/useConsumer.ts","../../src/hooks/useEmployee.ts","../../src/hooks/useProduct.ts","../../src/hooks/usePromotion.ts","../../src/hooks/useStore.ts","../../src/hooks/useReport.ts","../../src/hooks/useDelete.ts","../../src/hooks/useSubmit.ts","../../src/hooks/useLogout.ts","../../src/hooks/useBasketReport.ts"],"sourcesContent":["import type { apiResponse } from \"./types\";\n\n/**\n * Per-call configuration shared by every core API function.\n *\n * Nothing here is React-specific. By accepting these options per call, the\n * core layer works in the browser/Next (relative `/api/...` URLs, the default)\n * AND in Node / CLI / Vue / Angular by passing an absolute `baseUrl`, an auth\n * `token`, and/or a custom `fetch` implementation.\n */\nexport interface RequestOptions {\n /**\n * Prefixed in front of every request path. Leave undefined in the browser to\n * use relative URLs (e.g. `/api/products`). In Node/CLI pass something like\n * `https://api.shopwave.com`.\n */\n baseUrl?: string;\n\n /** OAuth/session token forwarded in the `extras.token` header. */\n token?: string;\n\n /**\n * Custom fetch implementation. Defaults to the global `fetch`. Useful for\n * Node < 18, testing, or injecting interceptors.\n */\n fetch?: typeof fetch;\n\n /** Optional abort signal for cancellation (used by the hooks layer). */\n signal?: AbortSignal;\n}\n\n/** The Shopwave API ships request metadata inside a single `extras` header. */\nexport type Extras = Record<string, unknown>;\n\nfunction resolveFetch(options: RequestOptions): typeof fetch {\n const f = options.fetch ?? (typeof fetch !== \"undefined\" ? fetch : undefined);\n if (!f) {\n throw new Error(\n \"No fetch implementation available. Pass `options.fetch` (e.g. node-fetch / undici) when running outside the browser.\"\n );\n }\n return f;\n}\n\nfunction buildExtras(extras: Extras, options: RequestOptions): Extras {\n const merged: Extras = { \"Content-Type\": \"application/json\", ...extras };\n if (options.token != null && merged.token == null) {\n merged.token = options.token;\n }\n return merged;\n}\n\n/**\n * Returns a JSON string of API errors if the response carries any, otherwise\n * `null`. Mirrors the original `!responseJson.api.message.errors` checks.\n */\nexport function getApiErrors(api?: apiResponse): string | null {\n const errors = api?.message?.errors;\n if (errors && Object.keys(errors).length > 0) {\n return JSON.stringify(errors);\n }\n return null;\n}\n\n/**\n * GET helper. Sends request metadata via the `extras` header exactly like the\n * original hooks did, parses JSON, and returns the typed payload.\n */\nexport async function apiGet<T>(\n path: string,\n extras: Extras,\n options: RequestOptions = {}\n): Promise<T> {\n const doFetch = resolveFetch(options);\n const url = (options.baseUrl ?? \"\") + path;\n\n const headers = { extras: JSON.stringify(buildExtras(extras, options)) };\n console.log('[API GET]', { url, headers });\n\n const response = await doFetch(url, {\n method: \"GET\",\n headers,\n signal: options.signal,\n });\n\n if (!response.ok) {\n throw new Error(`Network response was not ok (${response.status})`);\n }\n\n return (await response.json()) as T;\n}\n\n/**\n * JSON body helper for POST/PUT mutations.\n */\nexport async function apiSend<T>(\n path: string,\n method: \"POST\" | \"PUT\",\n payload: unknown,\n options: RequestOptions = {}\n): Promise<T> {\n const doFetch = resolveFetch(options);\n const url = (options.baseUrl ?? \"\") + path;\n\n const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n if (options.token != null) {\n headers.token = options.token;\n }\n\n console.log(`[API ${method}]`, { url, headers, payload });\n\n const response = await doFetch(url, {\n method,\n headers,\n body: JSON.stringify(payload),\n signal: options.signal,\n });\n\n if (!response.ok) {\n throw new Error(`Failed to ${method.toLowerCase()}: ${response.statusText}`);\n }\n\n return (await response.json()) as T;\n}\n\n/**\n * DELETE helper.\n */\nexport async function apiDelete(\n path: string,\n options: RequestOptions = {}\n): Promise<void> {\n const doFetch = resolveFetch(options);\n const url = (options.baseUrl ?? \"\") + path;\n\n const headers: Record<string, string> = {};\n if (options.token != null) {\n headers.token = options.token;\n }\n\n console.log('[API DELETE]', { url, headers });\n\n const response = await doFetch(url, {\n method: \"DELETE\",\n headers,\n signal: options.signal,\n });\n\n if (!response.ok) {\n throw new Error(`Failed to delete: ${response.statusText}`);\n }\n}\n","import { apiGet, getApiErrors, type RequestOptions } from \"./request\";\nimport type { apiResponse } from \"./types\";\n\nexport interface Category {\n id: number;\n title: string;\n parentId: number | null;\n deleteDate: string;\n activeDate: string;\n type: number;\n}\n\nexport interface CategoryResponse {\n categories: {\n [key: number]: Category;\n };\n api: apiResponse;\n}\n\nexport interface FetchCategoriesParams {\n categoryIds?: Array<number>;\n /** Whether to include soft-deleted records. Defaults to `false`. */\n deleted?: boolean;\n /** Token override (also accepted via `options.token`). */\n token?: string;\n}\n\n/**\n * Fetches categories. Framework-agnostic: returns the flattened `Category[]`\n * or throws on API errors.\n */\nexport async function fetchCategories(\n params: FetchCategoriesParams = {},\n options: RequestOptions = {}\n): Promise<Category[]> {\n const extras: Record<string, unknown> = { deleted: params.deleted ?? false };\n\n if (params.categoryIds) {\n extras.categoryIds = params.categoryIds;\n }\n if (params.token) {\n extras.token = params.token;\n }\n\n const json = await apiGet<CategoryResponse>(\"/api/categories\", extras, options);\n\n const error = getApiErrors(json.api);\n if (error) {\n throw new Error(error);\n }\n\n return Object.values(json.categories ?? {});\n}\n","import { apiGet, getApiErrors, type RequestOptions } from \"./request\";\nimport type { apiResponse } from \"./types\";\n\nexport interface Consumer {\n id: number;\n activeCount: number;\n firstName: string;\n lastName: string;\n email: string;\n}\n\nexport interface ConsumerResponse {\n consumers: {\n [key: number]: Consumer;\n };\n api: apiResponse;\n}\n\n/**\n * Fetches consumers by id. Returns an empty array when no ids are supplied\n * (the original hook short-circuited in that case).\n */\nexport async function fetchConsumers(\n consumerIds: number[] | null | undefined,\n options: RequestOptions = {}\n): Promise<Consumer[]> {\n if (!consumerIds || consumerIds.length === 0) {\n return [];\n }\n\n const extras: Record<string, unknown> = { ids: consumerIds.join(\",\") };\n\n const json = await apiGet<ConsumerResponse>(\"/api/consumer\", extras, options);\n\n const error = getApiErrors(json.api);\n if (error) {\n throw new Error(error);\n }\n\n return Object.values(json.consumers ?? {});\n}\n","import { apiGet, getApiErrors, type RequestOptions } from \"./request\";\nimport type { apiResponse } from \"./types\";\n\nexport const rolesById = {\n \"1\": \"Owner\",\n \"2\": \"Manager\",\n \"3\": \"Assistant\",\n \"4\": \"Guest\",\n \"5\": \"Assistant Manager\",\n} as const;\n\nexport interface Employee {\n id: number;\n firstName: string;\n lastName: string;\n email: string;\n roleId: number;\n joinedDate: string;\n exitDate: string;\n stores: {\n [key: number]: {\n id: number;\n roleId: number;\n };\n };\n}\n\nexport interface EmployeeResponse {\n employees: {\n [key: number]: Employee;\n };\n api: apiResponse;\n}\n\nexport interface FetchEmployeesParams {\n /** Optional id filter. Forwarded when provided. */\n employeeIds?: Array<number>;\n /** Whether to include soft-deleted records. Defaults to `false`. */\n deleted?: boolean;\n}\n\n/**\n * Fetches employees. Returns the flattened `Employee[]`.\n */\nexport async function fetchEmployees(\n params: FetchEmployeesParams = {},\n options: RequestOptions = {}\n): Promise<Employee[]> {\n const extras: Record<string, unknown> = { deleted: params.deleted ?? false };\n\n if (params.employeeIds) {\n extras.employeeIds = params.employeeIds;\n }\n\n const json = await apiGet<EmployeeResponse>(\"/api/employees\", extras, options);\n\n const error = getApiErrors(json.api);\n if (error) {\n throw new Error(error);\n }\n\n return Object.values(json.employees ?? {});\n}\n","import { apiGet, getApiErrors, type RequestOptions } from \"./request\";\nimport type { apiResponse } from \"./types\";\n\nexport interface ProductInstance {\n id: number;\n price: string;\n taxPercentage: string;\n timestamp: string;\n size: string;\n name: string;\n activeDate: string;\n tags: string;\n}\n\nexport interface Product {\n id: number;\n barcode: string;\n name: string;\n details: string;\n tags: string;\n unit: number;\n timestamp: string;\n activeDate: string;\n deleteDate: string;\n images: Array<string>;\n categories: Array<number>;\n instances: {\n [key: number]: ProductInstance;\n };\n}\n\nexport interface ProductResponse {\n products: {\n [key: number]: Product;\n };\n api: apiResponse;\n}\n\nexport interface FetchProductsParams {\n productIds?: Array<number>;\n storeId?: number;\n /** Whether to include soft-deleted records. Defaults to `false`. */\n deleted?: boolean;\n /** Token override (also accepted via `options.token`). */\n token?: string;\n}\n\n/**\n * Fetches products. Returns the flattened `Product[]`.\n */\nexport async function fetchProducts(\n params: FetchProductsParams = {},\n options: RequestOptions = {}\n): Promise<Product[]> {\n const extras: Record<string, unknown> = { deleted: params.deleted ?? false };\n\n if (params.productIds) {\n extras.productIds = params.productIds;\n }\n if (params.storeId) {\n extras.storeId = params.storeId;\n }\n if (params.token) {\n extras.token = params.token;\n }\n\n const json = await apiGet<ProductResponse>(\"/api/products\", extras, options);\n\n const error = getApiErrors(json.api);\n if (error) {\n throw new Error(error);\n }\n\n return Object.values(json.products ?? {});\n}\n\n/**\n * Fetches products by id and returns them keyed by id, transparently batching\n * the request (default 200 ids per call) to stay within API limits. Extracted\n * from the original `useBasketReport` inline batching loop so it can be reused\n * outside React.\n */\nexport async function fetchProductsMap(\n productIds: number[] | null | undefined,\n options: RequestOptions = {},\n batchSize = 200\n): Promise<{ [id: number]: Product }> {\n const result: { [id: number]: Product } = {};\n if (!productIds || productIds.length === 0) {\n return result;\n }\n\n for (let i = 0; i < productIds.length; i += batchSize) {\n const batch = productIds.slice(i, i + batchSize);\n const products = await fetchProducts({ productIds: batch }, options);\n for (const product of products) {\n result[product.id] = product;\n }\n }\n\n return result;\n}\n","import { apiGet, getApiErrors, type RequestOptions } from \"./request\";\nimport type { apiResponse } from \"./types\";\n\n/** Promotion rule identifiers as stored by the Shopwave API. */\nexport enum PromotionRuleSet {\n Percentage = \"|%^/\",\n Combo = \"&%</\",\n MealDeal = \"&=^/\",\n}\n\nexport interface Promotion {\n id: number;\n merchantId: number;\n storeIds: number[];\n categoryIds: { [key: string]: number };\n productIds: { [key: string]: any };\n title: string;\n details: string | null;\n terms: string | null;\n startDate: string;\n endDate: string;\n daysAvailable: number[];\n automatic: number;\n rule: PromotionRuleSet;\n x: number;\n y: number | null;\n}\n\nexport interface PromotionResponse {\n promotions: {\n [key: number]: Promotion;\n };\n api: apiResponse;\n}\n\nexport interface FetchPromotionsParams {\n /** Optional id filter. Forwarded when provided. */\n promotionIds?: Array<number>;\n /** Whether to include soft-deleted records. Defaults to `false`. */\n deleted?: boolean;\n /** Token override (also accepted via `options.token`). */\n token?: string;\n}\n\n/**\n * Fetches promotions. Returns the flattened `Promotion[]`.\n */\nexport async function fetchPromotions(\n params: FetchPromotionsParams = {},\n options: RequestOptions = {}\n): Promise<Promotion[]> {\n const extras: Record<string, unknown> = { deleted: params.deleted ?? false };\n\n if (params.promotionIds) {\n extras.promotionIds = params.promotionIds;\n }\n if (params.token) {\n extras.token = params.token;\n }\n\n const json = await apiGet<PromotionResponse>(\"/api/promotions\", extras, options);\n\n const error = getApiErrors(json.api);\n if (error) {\n throw new Error(error);\n }\n\n return Object.values(json.promotions ?? {});\n}\n","import { apiGet, getApiErrors, type RequestOptions } from \"./request\";\nimport type { apiResponse } from \"./types\";\n\nexport interface Store {\n id: number;\n lat: number;\n lng: number;\n addressLine1: string;\n addressLine2: string | null;\n addressLine3: string;\n phoneNumber: string;\n city: string;\n postcode: string;\n countryId: number | null;\n timezoneId: number | null;\n storeDeleteDate: string | null;\n email: string | null;\n sandbox: boolean | null;\n}\n\nexport interface StoreResponse {\n stores: {\n [key: number]: Store;\n };\n api: apiResponse;\n}\n\nexport interface FetchStoresParams {\n /** Whether to include soft-deleted records. Defaults to `false`. */\n deleted?: boolean;\n}\n\n/**\n * Fetches stores. Returns the flattened `Store[]`.\n */\nexport async function fetchStores(\n params: FetchStoresParams = {},\n options: RequestOptions = {}\n): Promise<Store[]> {\n const extras: Record<string, unknown> = { deleted: params.deleted ?? false };\n\n const json = await apiGet<StoreResponse>(\"/api/stores\", extras, options);\n\n const error = getApiErrors(json.api);\n if (error) {\n throw new Error(error);\n }\n\n return Object.values(json.stores ?? {});\n}\n","import { apiGet, getApiErrors, type RequestOptions } from \"./request\";\nimport type { apiResponse } from \"./types\";\n\nexport interface ReportKey {\n name: string;\n type: string;\n item?: ReportKey[];\n}\n\nexport interface ReportData {\n keys: ReportKey[];\n data: any[][];\n}\n\nexport interface ReportResponse {\n reports: {\n [key: string]: ReportData;\n };\n api: apiResponse;\n}\n\nexport interface ReportQuery {\n FROM: string;\n WHERE?: {\n AND?: string[];\n OR?: string[];\n };\n SELECT?: string[];\n LIMIT?: number;\n OFFSET?: number;\n}\n\nexport interface ReportQueryMap {\n [key: string]: ReportQuery;\n}\n\n/**\n * Runs one or more report queries and returns the `reports` map keyed by query\n * name. The query is JSON-encoded into the `extras.query` header, matching the\n * original endpoint contract.\n */\nexport async function fetchReport(\n query: ReportQueryMap,\n options: RequestOptions = {}\n): Promise<ReportResponse[\"reports\"]> {\n const extras: Record<string, unknown> = { query: JSON.stringify(query) };\n\n const json = await apiGet<ReportResponse>(\"/api/report\", extras, options);\n\n const error = getApiErrors(json.api);\n if (error) {\n throw new Error(error);\n }\n\n return json.reports ?? {};\n}\n","import { apiDelete, type RequestOptions } from \"./request\";\n\n/**\n * Ends the current server session.\n *\n * This is the framework-agnostic half of the original `useLogout` hook. The\n * Next.js-specific redirect logic (router.push to the auth server logout URL,\n * built from server actions) is intentionally NOT included here because it is\n * tied to `next/navigation` and `'use server'` actions — see the README.\n */\nexport async function logout(options: RequestOptions = {}): Promise<void> {\n await apiDelete(\"/api/session?action=logout\", options);\n}\n","import { apiDelete, apiSend, type RequestOptions } from \"./request\";\n\n/**\n * Generic CRUD-style mutations extracted from `useHandleDelete` /\n * `useHandleSubmit`. The original hooks also surfaced notistack snackbars; that\n * UI concern is deliberately left to the hooks/host layer so core stays\n * dependency-free.\n */\n\n/**\n * Deletes `/api/{resourcePath}/{entityId}`.\n */\nexport async function deleteEntity(\n resourcePath: string,\n entityId: number | string,\n options: RequestOptions = {}\n): Promise<void> {\n if (entityId == null || entityId === \"\") {\n throw new Error(\"entityId is missing\");\n }\n await apiDelete(`/api/${resourcePath}/${entityId}`, options);\n}\n\nexport interface SubmitEntityArgs {\n /** Fully-resolved endpoint, e.g. `/api/products` or `/api/products/42`. */\n endpoint: string;\n /** Defaults to PUT when an `entityId` exists, otherwise POST. */\n method?: \"POST\" | \"PUT\";\n /** The request payload (already transformed by the caller). */\n payload: unknown;\n}\n\nexport interface SubmitEntityResponse<R = any> {\n result?: R;\n [key: string]: unknown;\n}\n\n/**\n * Sends a create/update mutation and returns the parsed `result` field\n * (matching the original `result.result` access).\n */\nexport async function submitEntity<R = any>(\n { endpoint, method = \"POST\", payload }: SubmitEntityArgs,\n options: RequestOptions = {}\n): Promise<R | undefined> {\n const json = await apiSend<SubmitEntityResponse<R>>(\n endpoint,\n method,\n payload,\n options\n );\n return json.result;\n}\n","import type { Consumer } from \"./consumer\";\nimport type { Product } from \"./product\";\nimport type { ReportQueryMap, ReportResponse } from \"./report\";\n\n// ── Basket Report Types (preserved from the original `types/basket.ts`) ──────\n\nexport interface BasketItem {\n productId: number;\n productName: string;\n quantity: number;\n price: number;\n tax: number;\n}\n\nexport interface Basket {\n id: number;\n name: string;\n consumerId: number;\n products: BasketItem[];\n total: number;\n taxTotal: number;\n status: \"pending\" | \"completed\" | \"cancelled\";\n completeDate: string;\n}\n\nexport interface BasketReportRow {\n id: number;\n basketId: number;\n basketName: string;\n consumerId: number;\n consumerName: string;\n consumerEmail: string;\n products: BasketItem[];\n basketTotal: number;\n tax: number;\n dateTime: string;\n status: string;\n}\n\nexport interface BasketSummary {\n totalBaskets: number;\n totalRevenue: number;\n totalTax: number;\n uniqueConsumers: number;\n}\n\nexport interface BasketFilters {\n search: string;\n dateRange: {\n start: Date | null;\n end: Date | null;\n };\n consumerId: number | null;\n status: \"all\" | \"pending\" | \"completed\" | \"cancelled\";\n}\n\nexport interface BasketPagination {\n page: number;\n pageSize: number;\n total: number;\n}\n\nexport const DEFAULT_BASKET_FILTERS: BasketFilters = {\n search: \"\",\n dateRange: {\n start: null,\n end: null,\n },\n consumerId: null,\n status: \"all\",\n};\n\nexport const DEFAULT_PAGINATION: BasketPagination = {\n page: 0,\n pageSize: 25,\n total: 0,\n};\n\n/** Intermediate shape produced by {@link parseBasketReportData}. */\nexport interface ParsedBasket {\n id: number;\n name: string;\n consumerId: number;\n products: BasketItem[];\n total: number;\n taxTotal: number;\n status: \"completed\";\n completeDate: string;\n}\n\n// ── Pure transform helpers (extracted from the original `useBasketReport`) ────\n\n/** Formats a date as `YYYY-MM-DD HH:mm:ss` for the report query. */\nexport function formatDateForQuery(date: Date, isEndOfDay = false): string {\n const year = date.getFullYear();\n const month = String(date.getMonth() + 1).padStart(2, \"0\");\n const day = String(date.getDate()).padStart(2, \"0\");\n const time = isEndOfDay ? \"23:59:59\" : \"00:00:00\";\n return `${year}-${month}-${day} ${time}`;\n}\n\n/** Builds the `Basket` report query from a set of filters. */\nexport function buildBasketReportQuery(filters: BasketFilters): ReportQueryMap {\n const whereConditions: string[] = [];\n\n const today = new Date();\n const startDate = filters.dateRange.start ?? today;\n const endDate = filters.dateRange.end ?? today;\n\n whereConditions.push(\n `Basket.completeDate > '${formatDateForQuery(startDate, false)}'`\n );\n whereConditions.push(\n `Basket.completeDate < '${formatDateForQuery(endDate, true)}'`\n );\n\n if (filters.consumerId) {\n whereConditions.push(`Basket.consumerId = ${filters.consumerId}`);\n }\n\n if (filters.status !== \"all\") {\n whereConditions.push(`Basket.status = '${filters.status}'`);\n }\n\n return {\n baskets: {\n FROM: \"Basket\",\n WHERE: whereConditions.length > 0 ? { AND: whereConditions } : undefined,\n },\n };\n}\n\n/** Flattens the raw report rows/keys into structured baskets. */\nexport function parseBasketReportData(\n reports: ReportResponse[\"reports\"] | null | undefined\n): ParsedBasket[] {\n if (!reports?.baskets?.data || !reports?.baskets?.keys) {\n return [];\n }\n\n const { keys, data } = reports.baskets;\n\n const keyIndices: { [key: string]: number } = {};\n keys.forEach((key, index) => {\n keyIndices[key.name] = index;\n });\n\n const productKey = keys.find((k) => k.name === \"Basket.Product\");\n const productSubKeys: { [key: string]: number } = {};\n if (productKey?.item) {\n productKey.item.forEach((subKey, index) => {\n productSubKeys[subKey.name] = index;\n });\n }\n\n return data.map((row) => {\n const productsArray = (row[keyIndices[\"Basket.Product\"]] as any[][]) || [];\n const products: BasketItem[] = productsArray.map((productRow) => ({\n productId: productRow[productSubKeys[\"Basket.Product.productId\"]] as number,\n productName: `Product #${productRow[productSubKeys[\"Basket.Product.productId\"]]}`,\n quantity:\n (productRow[productSubKeys[\"Basket.Product.quantity\"]] as number) || 1,\n price:\n (productRow[productSubKeys[\"Basket.Product.productPrice\"]] as number) ||\n 0,\n tax:\n (productRow[\n productSubKeys[\"Basket.Product.productTaxPercentage\"]\n ] as number) || 0,\n }));\n\n const total = products.reduce((sum, p) => sum + p.price * p.quantity, 0);\n const taxTotal = products.reduce(\n (sum, p) => sum + p.price * p.quantity * p.tax,\n 0\n );\n\n const completeDateTimestamp = row[keyIndices[\"Basket.completeDate\"]] as number;\n const completeDate = completeDateTimestamp\n ? new Date(completeDateTimestamp).toISOString()\n : \"\";\n\n return {\n id: row[keyIndices[\"Basket.id\"]] as number,\n name: row[keyIndices[\"Basket.name\"]] as string,\n consumerId: row[keyIndices[\"Basket.consumerId\"]] as number,\n products,\n total,\n taxTotal,\n status: \"completed\" as const,\n completeDate,\n };\n });\n}\n\n/** Unique non-null consumer ids referenced by a set of baskets. */\nexport function collectConsumerIds(baskets: ParsedBasket[]): number[] | null {\n if (!baskets.length) return null;\n const ids = baskets\n .map((b) => b.consumerId)\n .filter((id): id is number => id != null);\n return ids.length > 0 ? [...new Set(ids)] : null;\n}\n\n/** Unique product ids referenced by a set of baskets. */\nexport function collectProductIds(baskets: ParsedBasket[]): number[] | null {\n if (!baskets.length) return null;\n const ids = new Set<number>();\n baskets.forEach((basket) => {\n basket.products.forEach((product) => {\n if (product.productId) {\n ids.add(product.productId);\n }\n });\n });\n return ids.size > 0 ? [...ids] : null;\n}\n\nexport interface CombineBasketRowsParams {\n baskets: ParsedBasket[];\n consumerMap: { [id: number]: Consumer };\n productMap: { [id: number]: Product };\n search?: string;\n}\n\n/** Joins baskets with consumer + product lookups, applies search, sorts. */\nexport function combineBasketRows({\n baskets,\n consumerMap,\n productMap,\n search,\n}: CombineBasketRowsParams): BasketReportRow[] {\n if (!baskets.length) return [];\n\n let combinedRows: BasketReportRow[] = baskets.map((basket) => {\n const consumer = basket.consumerId ? consumerMap[basket.consumerId] : null;\n\n const productsWithNames: BasketItem[] = basket.products.map((p) => {\n const product = productMap[p.productId];\n return {\n ...p,\n productName: product?.name || `Product #${p.productId}`,\n };\n });\n\n return {\n id: basket.id,\n basketId: basket.id,\n basketName: basket.name || `Basket #${basket.id}`,\n consumerId: basket.consumerId,\n consumerName: consumer\n ? `${consumer.firstName} ${consumer.lastName}`\n : \"Unknown\",\n consumerEmail: consumer?.email || \"-\",\n products: productsWithNames,\n basketTotal: (basket.total || 0) / 100,\n tax: basket.taxTotal || 0,\n dateTime: basket.completeDate,\n status: basket.status || \"pending\",\n };\n });\n\n if (search) {\n const searchLower = search.toLowerCase();\n combinedRows = combinedRows.filter(\n (row) =>\n row.basketId.toString().includes(searchLower) ||\n row.basketName.toLowerCase().includes(searchLower) ||\n row.consumerName.toLowerCase().includes(searchLower) ||\n row.consumerEmail.toLowerCase().includes(searchLower)\n );\n }\n\n combinedRows.sort((a, b) => {\n const dateA = new Date(a.dateTime).getTime();\n const dateB = new Date(b.dateTime).getTime();\n return dateB - dateA;\n });\n\n return combinedRows;\n}\n\n/** Aggregate totals for a set of report rows. */\nexport function computeBasketSummary(rows: BasketReportRow[]): BasketSummary {\n const uniqueConsumerIds = new Set(rows.map((row) => row.consumerId));\n return {\n totalBaskets: rows.length,\n totalRevenue: rows.reduce((sum, row) => sum + row.basketTotal, 0),\n totalTax: rows.reduce((sum, row) => sum + row.tax, 0),\n uniqueConsumers: uniqueConsumerIds.size,\n };\n}\n\n/** Builds a consumer id → consumer lookup. */\nexport function buildConsumerMap(consumers: Consumer[] | null | undefined): {\n [id: number]: Consumer;\n} {\n const map: { [id: number]: Consumer } = {};\n if (consumers) {\n consumers.forEach((consumer) => {\n map[consumer.id] = consumer;\n });\n }\n return map;\n}\n","import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * Consistent return shape for every auto-fetching (\"query\") hook.\n */\nexport interface QueryState<T> {\n data: T | null;\n loading: boolean;\n error: string | null;\n /** Re-runs the underlying fetch. */\n refetch: () => void;\n}\n\n/**\n * Consistent return shape for manually-triggered (\"mutation\") hooks.\n */\nexport interface MutationState<TData, TArgs extends any[]> {\n /** Triggers the request. Resolves to the result, or `null` on error. */\n mutate: (...args: TArgs) => Promise<TData | null>;\n data: TData | null;\n loading: boolean;\n error: string | null;\n}\n\nfunction toMessage(e: unknown): string {\n if (e instanceof Error) return e.message;\n return String(e);\n}\n\n/**\n * Internal primitive powering the auto-fetch hooks. Runs `fetcher` on mount and\n * whenever `deps` change, tracks loading/error/data, cancels in-flight requests\n * on unmount or dep change, and exposes `refetch`.\n *\n * When `enabled` is false the fetch is skipped (used for hooks that need\n * arguments before they can run, e.g. consumers-by-id).\n */\nexport function useQuery<T>(\n fetcher: (signal: AbortSignal) => Promise<T>,\n deps: ReadonlyArray<unknown>,\n enabled = true\n): QueryState<T> {\n const [data, setData] = useState<T | null>(null);\n const [loading, setLoading] = useState<boolean>(enabled);\n const [error, setError] = useState<string | null>(null);\n const [tick, setTick] = useState(0);\n\n const refetch = useCallback(() => setTick((t) => t + 1), []);\n\n useEffect(() => {\n if (!enabled) {\n setLoading(false);\n return;\n }\n\n const controller = new AbortController();\n let active = true;\n\n setData(null);\n setError(null);\n setLoading(true);\n\n fetcher(controller.signal)\n .then((result) => {\n if (active) setData(result);\n })\n .catch((e) => {\n if (active && (e as { name?: string })?.name !== \"AbortError\") {\n setError(toMessage(e));\n }\n })\n .finally(() => {\n if (active) setLoading(false);\n });\n\n return () => {\n active = false;\n controller.abort();\n };\n // `fetcher` is intentionally excluded; callers pass stable `deps`.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [...deps, tick, enabled]);\n\n return { data, loading, error, refetch };\n}\n\n/**\n * Internal primitive powering the manually-triggered hooks.\n */\nexport function useMutation<TData, TArgs extends any[]>(\n action: (...args: TArgs) => Promise<TData>,\n deps: ReadonlyArray<unknown>\n): MutationState<TData, TArgs> {\n const [data, setData] = useState<TData | null>(null);\n const [loading, setLoading] = useState(false);\n const [error, setError] = useState<string | null>(null);\n\n const mutate = useCallback(\n async (...args: TArgs): Promise<TData | null> => {\n setLoading(true);\n setError(null);\n try {\n const result = await action(...args);\n setData(result);\n return result;\n } catch (e) {\n setError(toMessage(e));\n return null;\n } finally {\n setLoading(false);\n }\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n deps\n );\n\n return { mutate, data, loading, error };\n}\n","import {\n fetchCategories,\n type Category,\n type FetchCategoriesParams,\n type RequestOptions,\n} from \"../core\";\nimport { useQuery, type QueryState } from \"./shared\";\n\n/**\n * Auto-fetches categories on mount and whenever the params change.\n * Manual reloads are available via `refetch` (replaces the old `reloadFlag`).\n */\nexport function useCategory(\n params: FetchCategoriesParams = {},\n options?: RequestOptions\n): QueryState<Category[]> {\n return useQuery<Category[]>(\n (signal) => fetchCategories(params, { ...options, signal }),\n [JSON.stringify(params), options?.baseUrl, options?.token]\n );\n}\n\nexport default useCategory;\n","import {\n fetchConsumers,\n type Consumer,\n type RequestOptions,\n} from \"../core\";\nimport { useQuery, type QueryState } from \"./shared\";\n\n/**\n * Auto-fetches consumers by id. Disabled (no request) until at least one id is\n * supplied, mirroring the original early-return behaviour.\n */\nexport function useConsumer(\n consumerIds: number[] | null,\n options?: RequestOptions\n): QueryState<Consumer[]> {\n const enabled = !!consumerIds && consumerIds.length > 0;\n return useQuery<Consumer[]>(\n (signal) => fetchConsumers(consumerIds, { ...options, signal }),\n [JSON.stringify(consumerIds), options?.baseUrl, options?.token],\n enabled\n );\n}\n\nexport default useConsumer;\n","import {\n fetchEmployees,\n type Employee,\n type FetchEmployeesParams,\n type RequestOptions,\n} from \"../core\";\nimport { useQuery, type QueryState } from \"./shared\";\n\n/**\n * Auto-fetches employees on mount and whenever the params change.\n */\nexport function useEmployee(\n params: FetchEmployeesParams = {},\n options?: RequestOptions\n): QueryState<Employee[]> {\n return useQuery<Employee[]>(\n (signal) => fetchEmployees(params, { ...options, signal }),\n [JSON.stringify(params), options?.baseUrl, options?.token]\n );\n}\n\nexport default useEmployee;\n","import {\n fetchProducts,\n type Product,\n type FetchProductsParams,\n type RequestOptions,\n} from \"../core\";\nimport { useQuery, type QueryState } from \"./shared\";\n\n/**\n * Auto-fetches products on mount and whenever the params change.\n */\nexport function useProduct(\n params: FetchProductsParams = {},\n options?: RequestOptions\n): QueryState<Product[]> {\n return useQuery<Product[]>(\n (signal) => fetchProducts(params, { ...options, signal }),\n [JSON.stringify(params), options?.baseUrl, options?.token]\n );\n}\n\nexport default useProduct;\n","import {\n fetchPromotions,\n type Promotion,\n type FetchPromotionsParams,\n type RequestOptions,\n} from \"../core\";\nimport { useQuery, type QueryState } from \"./shared\";\n\n/**\n * Auto-fetches promotions on mount and whenever the params change.\n * Manual reloads are available via `refetch`.\n */\nexport function usePromotion(\n params: FetchPromotionsParams = {},\n options?: RequestOptions\n): QueryState<Promotion[]> {\n return useQuery<Promotion[]>(\n (signal) => fetchPromotions(params, { ...options, signal }),\n [JSON.stringify(params), options?.baseUrl, options?.token]\n );\n}\n\nexport default usePromotion;\n","import {\n fetchStores,\n type Store,\n type FetchStoresParams,\n type RequestOptions,\n} from \"../core\";\nimport { useQuery, type QueryState } from \"./shared\";\n\n/**\n * Auto-fetches stores on mount. Manual reloads via `refetch`\n * (replaces the old `reloadFlag` argument).\n */\nexport function useStore(\n params: FetchStoresParams = {},\n options?: RequestOptions\n): QueryState<Store[]> {\n return useQuery<Store[]>(\n (signal) => fetchStores(params, { ...options, signal }),\n [JSON.stringify(params), options?.baseUrl, options?.token]\n );\n}\n\nexport default useStore;\n","import {\n fetchReport,\n type ReportQueryMap,\n type ReportResponse,\n type RequestOptions,\n} from \"../core\";\nimport { useQuery, type QueryState } from \"./shared\";\n\n/**\n * Auto-fetches one or more reports. Disabled (no request) until a non-null\n * query is supplied, mirroring the original early-return behaviour.\n */\nexport function useReport(\n query: ReportQueryMap | null,\n options?: RequestOptions\n): QueryState<ReportResponse[\"reports\"]> {\n const enabled = !!query;\n return useQuery<ReportResponse[\"reports\"]>(\n (signal) => fetchReport(query as ReportQueryMap, { ...options, signal }),\n [JSON.stringify(query), options?.baseUrl, options?.token],\n enabled\n );\n}\n\nexport default useReport;\n","import { deleteEntity, type RequestOptions } from \"../core\";\nimport { useMutation, type MutationState } from \"./shared\";\n\n/**\n * Manually-triggered delete. Returns `{ mutate, loading, error, data }`.\n *\n * Note: the original `useHandleDelete` surfaced notistack toasts. That UI\n * concern is left to the host app — handle success/error from the returned\n * state or the promise resolved by `mutate`.\n *\n * @example\n * const { mutate, loading } = useDelete();\n * await mutate(\"products\", 42);\n */\nexport function useDelete(\n options?: RequestOptions\n): MutationState<void, [resourcePath: string, entityId: number | string]> {\n return useMutation<void, [string, number | string]>(\n (resourcePath, entityId) => deleteEntity(resourcePath, entityId, options),\n [options?.baseUrl, options?.token]\n );\n}\n\nexport default useDelete;\n","import {\n submitEntity,\n type SubmitEntityArgs,\n type RequestOptions,\n} from \"../core\";\nimport { useMutation, type MutationState } from \"./shared\";\n\n/**\n * Manually-triggered create/update. Returns `{ mutate, loading, error, data }`,\n * where `data` is the API `result` payload.\n *\n * The original `useHandleSubmit` bundled validation, payload transformation and\n * notistack toasts. Those are app concerns: resolve the endpoint/method/payload\n * in your component and pass them in, then react to the returned state.\n *\n * @example\n * const { mutate, loading } = useSubmit<Product>();\n * const saved = await mutate({\n * endpoint: id ? `/api/products/${id}` : \"/api/products\",\n * method: id ? \"PUT\" : \"POST\",\n * payload,\n * });\n */\nexport function useSubmit<R = any>(\n options?: RequestOptions\n): MutationState<R | undefined, [args: SubmitEntityArgs]> {\n return useMutation<R | undefined, [SubmitEntityArgs]>(\n (args) => submitEntity<R>(args, options),\n [options?.baseUrl, options?.token]\n );\n}\n\nexport default useSubmit;\n","import { logout, type RequestOptions } from \"../core\";\nimport { useMutation, type MutationState } from \"./shared\";\n\n/**\n * Manually-triggered logout (ends the server session).\n *\n * This is framework-agnostic and does NOT redirect. The original `useLogout`\n * also pushed the browser to the auth-server logout URL via `next/navigation`\n * and `'use server'` actions; that part is Next-specific and stays in your app.\n *\n * @example\n * const { mutate: doLogout } = useLogout();\n * await doLogout();\n * router.push(logoutUrl); // app-specific redirect\n */\nexport function useLogout(\n options?: RequestOptions\n): MutationState<void, []> {\n return useMutation<void, []>(\n () => logout(options),\n [options?.baseUrl, options?.token]\n );\n}\n\nexport default useLogout;\n","import { useCallback, useEffect, useMemo, useState } from \"react\";\nimport {\n buildBasketReportQuery,\n buildConsumerMap,\n collectConsumerIds,\n collectProductIds,\n combineBasketRows,\n computeBasketSummary,\n fetchProductsMap,\n parseBasketReportData,\n DEFAULT_BASKET_FILTERS,\n DEFAULT_PAGINATION,\n type BasketFilters,\n type BasketPagination,\n type BasketReportRow,\n type BasketSummary,\n type Product,\n type RequestOptions,\n} from \"../core\";\nimport useReport from \"./useReport\";\nimport useConsumer from \"./useConsumer\";\n\nexport interface UseBasketReportReturn {\n rows: BasketReportRow[];\n summary: BasketSummary;\n loading: boolean;\n error: string | null;\n filters: BasketFilters;\n setFilters: (filters: Partial<BasketFilters>) => void;\n pagination: BasketPagination;\n setPagination: (page: number, pageSize: number) => void;\n refresh: () => void;\n}\n\n/**\n * Composite hook that orchestrates the report → consumers → products pipeline\n * for the basket report screen. All the data-shaping logic now lives in the\n * framework-agnostic `core/basket` helpers; this hook is the thin React glue\n * (state, memoisation, effects) on top of them.\n */\nexport function useBasketReport(\n options?: RequestOptions\n): UseBasketReportReturn {\n const [filters, setFiltersState] = useState<BasketFilters>(\n DEFAULT_BASKET_FILTERS\n );\n const [pagination, setPaginationState] = useState<BasketPagination>(\n DEFAULT_PAGINATION\n );\n const [refreshFlag, setRefreshFlag] = useState(0);\n\n // Build the report query from filters (core helper).\n const reportQuery = useMemo(\n () => buildBasketReportQuery(filters),\n // refreshFlag forces a new object identity to re-trigger the fetch.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [filters, refreshFlag]\n );\n\n const {\n data: reports,\n loading: basketLoading,\n error: basketError,\n } = useReport(reportQuery, options);\n\n // Flatten raw report rows into structured baskets (core helper).\n const basketData = useMemo(() => parseBasketReportData(reports), [reports]);\n\n // Derive id sets for the dependent fetches (core helpers).\n const consumerIds = useMemo(\n () => collectConsumerIds(basketData),\n [basketData]\n );\n const productIds = useMemo(\n () => collectProductIds(basketData),\n [basketData]\n );\n\n const {\n data: consumers,\n loading: consumerLoading,\n error: consumerError,\n } = useConsumer(consumerIds, options);\n\n // Batched product fetch (core helper handles the 200-per-request batching).\n const [productMap, setProductMap] = useState<{ [id: number]: Product }>({});\n const [productLoading, setProductLoading] = useState(false);\n const [productError, setProductError] = useState<string | null>(null);\n\n useEffect(() => {\n if (!productIds || productIds.length === 0) {\n setProductMap({});\n return;\n }\n\n let active = true;\n setProductLoading(true);\n setProductError(null);\n\n fetchProductsMap(productIds, options)\n .then((map) => {\n if (active) setProductMap(map);\n })\n .catch((e) => {\n if (active) {\n setProductError(\n e instanceof Error ? e.message : \"Failed to fetch products\"\n );\n }\n })\n .finally(() => {\n if (active) setProductLoading(false);\n });\n\n return () => {\n active = false;\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [JSON.stringify(productIds), options?.baseUrl, options?.token]);\n\n // Consumer lookup (core helper).\n const consumerMap = useMemo(() => buildConsumerMap(consumers), [consumers]);\n\n // Combine into final rows (core helper: join + search + sort).\n const rows: BasketReportRow[] = useMemo(\n () =>\n combineBasketRows({\n baskets: basketData,\n consumerMap,\n productMap,\n search: filters.search,\n }),\n [basketData, consumerMap, productMap, filters.search]\n );\n\n // Summary (core helper).\n const summary: BasketSummary = useMemo(\n () => computeBasketSummary(rows),\n [rows]\n );\n\n // Keep pagination total in sync with fetched data.\n useEffect(() => {\n if (rows.length > 0 && rows.length === pagination.pageSize) {\n setPaginationState((prev) => ({\n ...prev,\n total: (pagination.page + 2) * pagination.pageSize,\n }));\n } else if (rows.length > 0) {\n setPaginationState((prev) => ({\n ...prev,\n total: pagination.page * pagination.pageSize + rows.length,\n }));\n }\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [rows.length, pagination.page, pagination.pageSize]);\n\n const setFilters = useCallback((newFilters: Partial<BasketFilters>) => {\n setFiltersState((prev) => ({ ...prev, ...newFilters }));\n setPaginationState((prev) => ({ ...prev, page: 0 }));\n }, []);\n\n const setPagination = useCallback((page: number, pageSize: number) => {\n setPaginationState((prev) => ({ ...prev, page, pageSize }));\n }, []);\n\n const refresh = useCallback(() => {\n setRefreshFlag((prev) => prev + 1);\n }, []);\n\n const loading = basketLoading || consumerLoading || productLoading;\n const error = basketError || consumerError || productError;\n\n return {\n rows,\n summary,\n loading,\n error,\n filters,\n setFilters,\n pagination,\n setPagination,\n refresh,\n };\n}\n\nexport default useBasketReport;\n"],"mappings":"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"}
|
|
@@ -0,0 +1,424 @@
|
|
|
1
|
+
//#region src/hooks/shared.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* Consistent return shape for every auto-fetching ("query") hook.
|
|
4
|
+
*/
|
|
5
|
+
interface QueryState<T> {
|
|
6
|
+
data: T | null;
|
|
7
|
+
loading: boolean;
|
|
8
|
+
error: string | null;
|
|
9
|
+
/** Re-runs the underlying fetch. */
|
|
10
|
+
refetch: () => void;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Consistent return shape for manually-triggered ("mutation") hooks.
|
|
14
|
+
*/
|
|
15
|
+
interface MutationState<TData, TArgs extends any[]> {
|
|
16
|
+
/** Triggers the request. Resolves to the result, or `null` on error. */
|
|
17
|
+
mutate: (...args: TArgs) => Promise<TData | null>;
|
|
18
|
+
data: TData | null;
|
|
19
|
+
loading: boolean;
|
|
20
|
+
error: string | null;
|
|
21
|
+
}
|
|
22
|
+
//#endregion
|
|
23
|
+
//#region src/core/types.d.ts
|
|
24
|
+
/**
|
|
25
|
+
* Shared API envelope types.
|
|
26
|
+
*
|
|
27
|
+
* Preserved exactly from the original `model/message.ts` so existing
|
|
28
|
+
* response handling keeps working.
|
|
29
|
+
*/
|
|
30
|
+
interface ErrorMessage {
|
|
31
|
+
id: number;
|
|
32
|
+
title: string;
|
|
33
|
+
details: string;
|
|
34
|
+
moreInfo: string;
|
|
35
|
+
}
|
|
36
|
+
interface SuccessMessage {
|
|
37
|
+
id: number;
|
|
38
|
+
title: string;
|
|
39
|
+
details: string;
|
|
40
|
+
}
|
|
41
|
+
interface MessageInfo {
|
|
42
|
+
errors: {
|
|
43
|
+
[key: number]: ErrorMessage;
|
|
44
|
+
};
|
|
45
|
+
success: {
|
|
46
|
+
[key: number]: SuccessMessage;
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
interface apiResponse {
|
|
50
|
+
message: MessageInfo;
|
|
51
|
+
codeBaseVersion: number;
|
|
52
|
+
executionTime_milliSeconds: number;
|
|
53
|
+
}
|
|
54
|
+
//#endregion
|
|
55
|
+
//#region src/core/request.d.ts
|
|
56
|
+
/**
|
|
57
|
+
* Per-call configuration shared by every core API function.
|
|
58
|
+
*
|
|
59
|
+
* Nothing here is React-specific. By accepting these options per call, the
|
|
60
|
+
* core layer works in the browser/Next (relative `/api/...` URLs, the default)
|
|
61
|
+
* AND in Node / CLI / Vue / Angular by passing an absolute `baseUrl`, an auth
|
|
62
|
+
* `token`, and/or a custom `fetch` implementation.
|
|
63
|
+
*/
|
|
64
|
+
interface RequestOptions {
|
|
65
|
+
/**
|
|
66
|
+
* Prefixed in front of every request path. Leave undefined in the browser to
|
|
67
|
+
* use relative URLs (e.g. `/api/products`). In Node/CLI pass something like
|
|
68
|
+
* `https://api.shopwave.com`.
|
|
69
|
+
*/
|
|
70
|
+
baseUrl?: string;
|
|
71
|
+
/** OAuth/session token forwarded in the `extras.token` header. */
|
|
72
|
+
token?: string;
|
|
73
|
+
/**
|
|
74
|
+
* Custom fetch implementation. Defaults to the global `fetch`. Useful for
|
|
75
|
+
* Node < 18, testing, or injecting interceptors.
|
|
76
|
+
*/
|
|
77
|
+
fetch?: typeof fetch;
|
|
78
|
+
/** Optional abort signal for cancellation (used by the hooks layer). */
|
|
79
|
+
signal?: AbortSignal;
|
|
80
|
+
}
|
|
81
|
+
//#endregion
|
|
82
|
+
//#region src/core/category.d.ts
|
|
83
|
+
interface Category {
|
|
84
|
+
id: number;
|
|
85
|
+
title: string;
|
|
86
|
+
parentId: number | null;
|
|
87
|
+
deleteDate: string;
|
|
88
|
+
activeDate: string;
|
|
89
|
+
type: number;
|
|
90
|
+
}
|
|
91
|
+
interface FetchCategoriesParams {
|
|
92
|
+
categoryIds?: Array<number>;
|
|
93
|
+
/** Whether to include soft-deleted records. Defaults to `false`. */
|
|
94
|
+
deleted?: boolean;
|
|
95
|
+
/** Token override (also accepted via `options.token`). */
|
|
96
|
+
token?: string;
|
|
97
|
+
}
|
|
98
|
+
//#endregion
|
|
99
|
+
//#region src/core/consumer.d.ts
|
|
100
|
+
interface Consumer {
|
|
101
|
+
id: number;
|
|
102
|
+
activeCount: number;
|
|
103
|
+
firstName: string;
|
|
104
|
+
lastName: string;
|
|
105
|
+
email: string;
|
|
106
|
+
}
|
|
107
|
+
//#endregion
|
|
108
|
+
//#region src/core/employee.d.ts
|
|
109
|
+
interface Employee {
|
|
110
|
+
id: number;
|
|
111
|
+
firstName: string;
|
|
112
|
+
lastName: string;
|
|
113
|
+
email: string;
|
|
114
|
+
roleId: number;
|
|
115
|
+
joinedDate: string;
|
|
116
|
+
exitDate: string;
|
|
117
|
+
stores: {
|
|
118
|
+
[key: number]: {
|
|
119
|
+
id: number;
|
|
120
|
+
roleId: number;
|
|
121
|
+
};
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
interface FetchEmployeesParams {
|
|
125
|
+
/** Optional id filter. Forwarded when provided. */
|
|
126
|
+
employeeIds?: Array<number>;
|
|
127
|
+
/** Whether to include soft-deleted records. Defaults to `false`. */
|
|
128
|
+
deleted?: boolean;
|
|
129
|
+
}
|
|
130
|
+
//#endregion
|
|
131
|
+
//#region src/core/product.d.ts
|
|
132
|
+
interface ProductInstance {
|
|
133
|
+
id: number;
|
|
134
|
+
price: string;
|
|
135
|
+
taxPercentage: string;
|
|
136
|
+
timestamp: string;
|
|
137
|
+
size: string;
|
|
138
|
+
name: string;
|
|
139
|
+
activeDate: string;
|
|
140
|
+
tags: string;
|
|
141
|
+
}
|
|
142
|
+
interface Product {
|
|
143
|
+
id: number;
|
|
144
|
+
barcode: string;
|
|
145
|
+
name: string;
|
|
146
|
+
details: string;
|
|
147
|
+
tags: string;
|
|
148
|
+
unit: number;
|
|
149
|
+
timestamp: string;
|
|
150
|
+
activeDate: string;
|
|
151
|
+
deleteDate: string;
|
|
152
|
+
images: Array<string>;
|
|
153
|
+
categories: Array<number>;
|
|
154
|
+
instances: {
|
|
155
|
+
[key: number]: ProductInstance;
|
|
156
|
+
};
|
|
157
|
+
}
|
|
158
|
+
interface FetchProductsParams {
|
|
159
|
+
productIds?: Array<number>;
|
|
160
|
+
storeId?: number;
|
|
161
|
+
/** Whether to include soft-deleted records. Defaults to `false`. */
|
|
162
|
+
deleted?: boolean;
|
|
163
|
+
/** Token override (also accepted via `options.token`). */
|
|
164
|
+
token?: string;
|
|
165
|
+
}
|
|
166
|
+
//#endregion
|
|
167
|
+
//#region src/core/promotion.d.ts
|
|
168
|
+
/** Promotion rule identifiers as stored by the Shopwave API. */
|
|
169
|
+
declare enum PromotionRuleSet {
|
|
170
|
+
Percentage = "|%^/",
|
|
171
|
+
Combo = "&%</",
|
|
172
|
+
MealDeal = "&=^/",
|
|
173
|
+
}
|
|
174
|
+
interface Promotion {
|
|
175
|
+
id: number;
|
|
176
|
+
merchantId: number;
|
|
177
|
+
storeIds: number[];
|
|
178
|
+
categoryIds: {
|
|
179
|
+
[key: string]: number;
|
|
180
|
+
};
|
|
181
|
+
productIds: {
|
|
182
|
+
[key: string]: any;
|
|
183
|
+
};
|
|
184
|
+
title: string;
|
|
185
|
+
details: string | null;
|
|
186
|
+
terms: string | null;
|
|
187
|
+
startDate: string;
|
|
188
|
+
endDate: string;
|
|
189
|
+
daysAvailable: number[];
|
|
190
|
+
automatic: number;
|
|
191
|
+
rule: PromotionRuleSet;
|
|
192
|
+
x: number;
|
|
193
|
+
y: number | null;
|
|
194
|
+
}
|
|
195
|
+
interface FetchPromotionsParams {
|
|
196
|
+
/** Optional id filter. Forwarded when provided. */
|
|
197
|
+
promotionIds?: Array<number>;
|
|
198
|
+
/** Whether to include soft-deleted records. Defaults to `false`. */
|
|
199
|
+
deleted?: boolean;
|
|
200
|
+
/** Token override (also accepted via `options.token`). */
|
|
201
|
+
token?: string;
|
|
202
|
+
}
|
|
203
|
+
//#endregion
|
|
204
|
+
//#region src/core/store.d.ts
|
|
205
|
+
interface Store {
|
|
206
|
+
id: number;
|
|
207
|
+
lat: number;
|
|
208
|
+
lng: number;
|
|
209
|
+
addressLine1: string;
|
|
210
|
+
addressLine2: string | null;
|
|
211
|
+
addressLine3: string;
|
|
212
|
+
phoneNumber: string;
|
|
213
|
+
city: string;
|
|
214
|
+
postcode: string;
|
|
215
|
+
countryId: number | null;
|
|
216
|
+
timezoneId: number | null;
|
|
217
|
+
storeDeleteDate: string | null;
|
|
218
|
+
email: string | null;
|
|
219
|
+
sandbox: boolean | null;
|
|
220
|
+
}
|
|
221
|
+
interface FetchStoresParams {
|
|
222
|
+
/** Whether to include soft-deleted records. Defaults to `false`. */
|
|
223
|
+
deleted?: boolean;
|
|
224
|
+
}
|
|
225
|
+
//#endregion
|
|
226
|
+
//#region src/core/report.d.ts
|
|
227
|
+
interface ReportKey {
|
|
228
|
+
name: string;
|
|
229
|
+
type: string;
|
|
230
|
+
item?: ReportKey[];
|
|
231
|
+
}
|
|
232
|
+
interface ReportData {
|
|
233
|
+
keys: ReportKey[];
|
|
234
|
+
data: any[][];
|
|
235
|
+
}
|
|
236
|
+
interface ReportResponse {
|
|
237
|
+
reports: {
|
|
238
|
+
[key: string]: ReportData;
|
|
239
|
+
};
|
|
240
|
+
api: apiResponse;
|
|
241
|
+
}
|
|
242
|
+
interface ReportQuery {
|
|
243
|
+
FROM: string;
|
|
244
|
+
WHERE?: {
|
|
245
|
+
AND?: string[];
|
|
246
|
+
OR?: string[];
|
|
247
|
+
};
|
|
248
|
+
SELECT?: string[];
|
|
249
|
+
LIMIT?: number;
|
|
250
|
+
OFFSET?: number;
|
|
251
|
+
}
|
|
252
|
+
interface ReportQueryMap {
|
|
253
|
+
[key: string]: ReportQuery;
|
|
254
|
+
}
|
|
255
|
+
//#endregion
|
|
256
|
+
//#region src/core/entity.d.ts
|
|
257
|
+
interface SubmitEntityArgs {
|
|
258
|
+
/** Fully-resolved endpoint, e.g. `/api/products` or `/api/products/42`. */
|
|
259
|
+
endpoint: string;
|
|
260
|
+
/** Defaults to PUT when an `entityId` exists, otherwise POST. */
|
|
261
|
+
method?: "POST" | "PUT";
|
|
262
|
+
/** The request payload (already transformed by the caller). */
|
|
263
|
+
payload: unknown;
|
|
264
|
+
}
|
|
265
|
+
//#endregion
|
|
266
|
+
//#region src/core/basket.d.ts
|
|
267
|
+
interface BasketItem {
|
|
268
|
+
productId: number;
|
|
269
|
+
productName: string;
|
|
270
|
+
quantity: number;
|
|
271
|
+
price: number;
|
|
272
|
+
tax: number;
|
|
273
|
+
}
|
|
274
|
+
interface BasketReportRow {
|
|
275
|
+
id: number;
|
|
276
|
+
basketId: number;
|
|
277
|
+
basketName: string;
|
|
278
|
+
consumerId: number;
|
|
279
|
+
consumerName: string;
|
|
280
|
+
consumerEmail: string;
|
|
281
|
+
products: BasketItem[];
|
|
282
|
+
basketTotal: number;
|
|
283
|
+
tax: number;
|
|
284
|
+
dateTime: string;
|
|
285
|
+
status: string;
|
|
286
|
+
}
|
|
287
|
+
interface BasketSummary {
|
|
288
|
+
totalBaskets: number;
|
|
289
|
+
totalRevenue: number;
|
|
290
|
+
totalTax: number;
|
|
291
|
+
uniqueConsumers: number;
|
|
292
|
+
}
|
|
293
|
+
interface BasketFilters {
|
|
294
|
+
search: string;
|
|
295
|
+
dateRange: {
|
|
296
|
+
start: Date | null;
|
|
297
|
+
end: Date | null;
|
|
298
|
+
};
|
|
299
|
+
consumerId: number | null;
|
|
300
|
+
status: "all" | "pending" | "completed" | "cancelled";
|
|
301
|
+
}
|
|
302
|
+
interface BasketPagination {
|
|
303
|
+
page: number;
|
|
304
|
+
pageSize: number;
|
|
305
|
+
total: number;
|
|
306
|
+
}
|
|
307
|
+
//#endregion
|
|
308
|
+
//#region src/hooks/useCategory.d.ts
|
|
309
|
+
/**
|
|
310
|
+
* Auto-fetches categories on mount and whenever the params change.
|
|
311
|
+
* Manual reloads are available via `refetch` (replaces the old `reloadFlag`).
|
|
312
|
+
*/
|
|
313
|
+
declare function useCategory(params?: FetchCategoriesParams, options?: RequestOptions): QueryState<Category[]>;
|
|
314
|
+
//#endregion
|
|
315
|
+
//#region src/hooks/useConsumer.d.ts
|
|
316
|
+
/**
|
|
317
|
+
* Auto-fetches consumers by id. Disabled (no request) until at least one id is
|
|
318
|
+
* supplied, mirroring the original early-return behaviour.
|
|
319
|
+
*/
|
|
320
|
+
declare function useConsumer(consumerIds: number[] | null, options?: RequestOptions): QueryState<Consumer[]>;
|
|
321
|
+
//#endregion
|
|
322
|
+
//#region src/hooks/useEmployee.d.ts
|
|
323
|
+
/**
|
|
324
|
+
* Auto-fetches employees on mount and whenever the params change.
|
|
325
|
+
*/
|
|
326
|
+
declare function useEmployee(params?: FetchEmployeesParams, options?: RequestOptions): QueryState<Employee[]>;
|
|
327
|
+
//#endregion
|
|
328
|
+
//#region src/hooks/useProduct.d.ts
|
|
329
|
+
/**
|
|
330
|
+
* Auto-fetches products on mount and whenever the params change.
|
|
331
|
+
*/
|
|
332
|
+
declare function useProduct(params?: FetchProductsParams, options?: RequestOptions): QueryState<Product[]>;
|
|
333
|
+
//#endregion
|
|
334
|
+
//#region src/hooks/usePromotion.d.ts
|
|
335
|
+
/**
|
|
336
|
+
* Auto-fetches promotions on mount and whenever the params change.
|
|
337
|
+
* Manual reloads are available via `refetch`.
|
|
338
|
+
*/
|
|
339
|
+
declare function usePromotion(params?: FetchPromotionsParams, options?: RequestOptions): QueryState<Promotion[]>;
|
|
340
|
+
//#endregion
|
|
341
|
+
//#region src/hooks/useStore.d.ts
|
|
342
|
+
/**
|
|
343
|
+
* Auto-fetches stores on mount. Manual reloads via `refetch`
|
|
344
|
+
* (replaces the old `reloadFlag` argument).
|
|
345
|
+
*/
|
|
346
|
+
declare function useStore(params?: FetchStoresParams, options?: RequestOptions): QueryState<Store[]>;
|
|
347
|
+
//#endregion
|
|
348
|
+
//#region src/hooks/useReport.d.ts
|
|
349
|
+
/**
|
|
350
|
+
* Auto-fetches one or more reports. Disabled (no request) until a non-null
|
|
351
|
+
* query is supplied, mirroring the original early-return behaviour.
|
|
352
|
+
*/
|
|
353
|
+
declare function useReport(query: ReportQueryMap | null, options?: RequestOptions): QueryState<ReportResponse["reports"]>;
|
|
354
|
+
//#endregion
|
|
355
|
+
//#region src/hooks/useDelete.d.ts
|
|
356
|
+
/**
|
|
357
|
+
* Manually-triggered delete. Returns `{ mutate, loading, error, data }`.
|
|
358
|
+
*
|
|
359
|
+
* Note: the original `useHandleDelete` surfaced notistack toasts. That UI
|
|
360
|
+
* concern is left to the host app — handle success/error from the returned
|
|
361
|
+
* state or the promise resolved by `mutate`.
|
|
362
|
+
*
|
|
363
|
+
* @example
|
|
364
|
+
* const { mutate, loading } = useDelete();
|
|
365
|
+
* await mutate("products", 42);
|
|
366
|
+
*/
|
|
367
|
+
declare function useDelete(options?: RequestOptions): MutationState<void, [resourcePath: string, entityId: number | string]>;
|
|
368
|
+
//#endregion
|
|
369
|
+
//#region src/hooks/useSubmit.d.ts
|
|
370
|
+
/**
|
|
371
|
+
* Manually-triggered create/update. Returns `{ mutate, loading, error, data }`,
|
|
372
|
+
* where `data` is the API `result` payload.
|
|
373
|
+
*
|
|
374
|
+
* The original `useHandleSubmit` bundled validation, payload transformation and
|
|
375
|
+
* notistack toasts. Those are app concerns: resolve the endpoint/method/payload
|
|
376
|
+
* in your component and pass them in, then react to the returned state.
|
|
377
|
+
*
|
|
378
|
+
* @example
|
|
379
|
+
* const { mutate, loading } = useSubmit<Product>();
|
|
380
|
+
* const saved = await mutate({
|
|
381
|
+
* endpoint: id ? `/api/products/${id}` : "/api/products",
|
|
382
|
+
* method: id ? "PUT" : "POST",
|
|
383
|
+
* payload,
|
|
384
|
+
* });
|
|
385
|
+
*/
|
|
386
|
+
declare function useSubmit<R = any>(options?: RequestOptions): MutationState<R | undefined, [args: SubmitEntityArgs]>;
|
|
387
|
+
//#endregion
|
|
388
|
+
//#region src/hooks/useLogout.d.ts
|
|
389
|
+
/**
|
|
390
|
+
* Manually-triggered logout (ends the server session).
|
|
391
|
+
*
|
|
392
|
+
* This is framework-agnostic and does NOT redirect. The original `useLogout`
|
|
393
|
+
* also pushed the browser to the auth-server logout URL via `next/navigation`
|
|
394
|
+
* and `'use server'` actions; that part is Next-specific and stays in your app.
|
|
395
|
+
*
|
|
396
|
+
* @example
|
|
397
|
+
* const { mutate: doLogout } = useLogout();
|
|
398
|
+
* await doLogout();
|
|
399
|
+
* router.push(logoutUrl); // app-specific redirect
|
|
400
|
+
*/
|
|
401
|
+
declare function useLogout(options?: RequestOptions): MutationState<void, []>;
|
|
402
|
+
//#endregion
|
|
403
|
+
//#region src/hooks/useBasketReport.d.ts
|
|
404
|
+
interface UseBasketReportReturn {
|
|
405
|
+
rows: BasketReportRow[];
|
|
406
|
+
summary: BasketSummary;
|
|
407
|
+
loading: boolean;
|
|
408
|
+
error: string | null;
|
|
409
|
+
filters: BasketFilters;
|
|
410
|
+
setFilters: (filters: Partial<BasketFilters>) => void;
|
|
411
|
+
pagination: BasketPagination;
|
|
412
|
+
setPagination: (page: number, pageSize: number) => void;
|
|
413
|
+
refresh: () => void;
|
|
414
|
+
}
|
|
415
|
+
/**
|
|
416
|
+
* Composite hook that orchestrates the report → consumers → products pipeline
|
|
417
|
+
* for the basket report screen. All the data-shaping logic now lives in the
|
|
418
|
+
* framework-agnostic `core/basket` helpers; this hook is the thin React glue
|
|
419
|
+
* (state, memoisation, effects) on top of them.
|
|
420
|
+
*/
|
|
421
|
+
declare function useBasketReport(options?: RequestOptions): UseBasketReportReturn;
|
|
422
|
+
//#endregion
|
|
423
|
+
export { type MutationState, type QueryState, type UseBasketReportReturn, useBasketReport, useCategory, useConsumer, useDelete, useEmployee, useLogout, useProduct, usePromotion, useReport, useStore, useSubmit };
|
|
424
|
+
//# sourceMappingURL=index.d.cts.map
|