react-shopwave-connect 0.1.1

package/dist/core/index.cjs.map

@@ -0,0 +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 }"],"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"],"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"],"mappings":"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"}

package/dist/core/index.d.cts

@@ -0,0 +1,481 @@
+//#region src/core/types.d.ts
+/**
+ * Shared API envelope types.
+ *
+ * Preserved exactly from the original `model/message.ts` so existing
+ * response handling keeps working.
+ */
+interface ErrorMessage {
+  id: number;
+  title: string;
+  details: string;
+  moreInfo: string;
+}
+interface SuccessMessage {
+  id: number;
+  title: string;
+  details: string;
+}
+interface MessageInfo {
+  errors: {
+    [key: number]: ErrorMessage;
+  };
+  success: {
+    [key: number]: SuccessMessage;
+  };
+}
+interface apiResponse {
+  message: MessageInfo;
+  codeBaseVersion: number;
+  executionTime_milliSeconds: number;
+}
+//#endregion
+//#region src/core/request.d.ts
+/**
+ * Per-call configuration shared by every core API function.
+ *
+ * Nothing here is React-specific. By accepting these options per call, the
+ * core layer works in the browser/Next (relative `/api/...` URLs, the default)
+ * AND in Node / CLI / Vue / Angular by passing an absolute `baseUrl`, an auth
+ * `token`, and/or a custom `fetch` implementation.
+ */
+interface RequestOptions {
+  /**
+   * Prefixed in front of every request path. Leave undefined in the browser to
+   * use relative URLs (e.g. `/api/products`). In Node/CLI pass something like
+   * `https://api.shopwave.com`.
+   */
+  baseUrl?: string;
+  /** OAuth/session token forwarded in the `extras.token` header. */
+  token?: string;
+  /**
+   * Custom fetch implementation. Defaults to the global `fetch`. Useful for
+   * Node < 18, testing, or injecting interceptors.
+   */
+  fetch?: typeof fetch;
+  /** Optional abort signal for cancellation (used by the hooks layer). */
+  signal?: AbortSignal;
+}
+/** The Shopwave API ships request metadata inside a single `extras` header. */
+type Extras = Record<string, unknown>;
+/**
+ * Returns a JSON string of API errors if the response carries any, otherwise
+ * `null`. Mirrors the original `!responseJson.api.message.errors` checks.
+ */
+declare function getApiErrors(api?: apiResponse): string | null;
+/**
+ * GET helper. Sends request metadata via the `extras` header exactly like the
+ * original hooks did, parses JSON, and returns the typed payload.
+ */
+declare function apiGet<T>(path: string, extras: Extras, options?: RequestOptions): Promise<T>;
+/**
+ * JSON body helper for POST/PUT mutations.
+ */
+declare function apiSend<T>(path: string, method: "POST" | "PUT", payload: unknown, options?: RequestOptions): Promise<T>;
+/**
+ * DELETE helper.
+ */
+declare function apiDelete(path: string, options?: RequestOptions): Promise<void>;
+//#endregion
+//#region src/core/category.d.ts
+interface Category {
+  id: number;
+  title: string;
+  parentId: number | null;
+  deleteDate: string;
+  activeDate: string;
+  type: number;
+}
+interface CategoryResponse {
+  categories: {
+    [key: number]: Category;
+  };
+  api: apiResponse;
+}
+interface FetchCategoriesParams {
+  categoryIds?: Array<number>;
+  /** Whether to include soft-deleted records. Defaults to `false`. */
+  deleted?: boolean;
+  /** Token override (also accepted via `options.token`). */
+  token?: string;
+}
+/**
+ * Fetches categories. Framework-agnostic: returns the flattened `Category[]`
+ * or throws on API errors.
+ */
+declare function fetchCategories(params?: FetchCategoriesParams, options?: RequestOptions): Promise<Category[]>;
+//#endregion
+//#region src/core/consumer.d.ts
+interface Consumer {
+  id: number;
+  activeCount: number;
+  firstName: string;
+  lastName: string;
+  email: string;
+}
+interface ConsumerResponse {
+  consumers: {
+    [key: number]: Consumer;
+  };
+  api: apiResponse;
+}
+/**
+ * Fetches consumers by id. Returns an empty array when no ids are supplied
+ * (the original hook short-circuited in that case).
+ */
+declare function fetchConsumers(consumerIds: number[] | null | undefined, options?: RequestOptions): Promise<Consumer[]>;
+//#endregion
+//#region src/core/employee.d.ts
+declare const rolesById: {
+  readonly "1": "Owner";
+  readonly "2": "Manager";
+  readonly "3": "Assistant";
+  readonly "4": "Guest";
+  readonly "5": "Assistant Manager";
+};
+interface Employee {
+  id: number;
+  firstName: string;
+  lastName: string;
+  email: string;
+  roleId: number;
+  joinedDate: string;
+  exitDate: string;
+  stores: {
+    [key: number]: {
+      id: number;
+      roleId: number;
+    };
+  };
+}
+interface EmployeeResponse {
+  employees: {
+    [key: number]: Employee;
+  };
+  api: apiResponse;
+}
+interface FetchEmployeesParams {
+  /** Optional id filter. Forwarded when provided. */
+  employeeIds?: Array<number>;
+  /** Whether to include soft-deleted records. Defaults to `false`. */
+  deleted?: boolean;
+}
+/**
+ * Fetches employees. Returns the flattened `Employee[]`.
+ */
+declare function fetchEmployees(params?: FetchEmployeesParams, options?: RequestOptions): Promise<Employee[]>;
+//#endregion
+//#region src/core/product.d.ts
+interface ProductInstance {
+  id: number;
+  price: string;
+  taxPercentage: string;
+  timestamp: string;
+  size: string;
+  name: string;
+  activeDate: string;
+  tags: string;
+}
+interface Product {
+  id: number;
+  barcode: string;
+  name: string;
+  details: string;
+  tags: string;
+  unit: number;
+  timestamp: string;
+  activeDate: string;
+  deleteDate: string;
+  images: Array<string>;
+  categories: Array<number>;
+  instances: {
+    [key: number]: ProductInstance;
+  };
+}
+interface ProductResponse {
+  products: {
+    [key: number]: Product;
+  };
+  api: apiResponse;
+}
+interface FetchProductsParams {
+  productIds?: Array<number>;
+  storeId?: number;
+  /** Whether to include soft-deleted records. Defaults to `false`. */
+  deleted?: boolean;
+  /** Token override (also accepted via `options.token`). */
+  token?: string;
+}
+/**
+ * Fetches products. Returns the flattened `Product[]`.
+ */
+declare function fetchProducts(params?: FetchProductsParams, options?: RequestOptions): Promise<Product[]>;
+/**
+ * Fetches products by id and returns them keyed by id, transparently batching
+ * the request (default 200 ids per call) to stay within API limits. Extracted
+ * from the original `useBasketReport` inline batching loop so it can be reused
+ * outside React.
+ */
+declare function fetchProductsMap(productIds: number[] | null | undefined, options?: RequestOptions, batchSize?: number): Promise<{
+  [id: number]: Product;
+}>;
+//#endregion
+//#region src/core/promotion.d.ts
+/** Promotion rule identifiers as stored by the Shopwave API. */
+declare enum PromotionRuleSet {
+  Percentage = "|%^/",
+  Combo = "&%</",
+  MealDeal = "&=^/",
+}
+interface Promotion {
+  id: number;
+  merchantId: number;
+  storeIds: number[];
+  categoryIds: {
+    [key: string]: number;
+  };
+  productIds: {
+    [key: string]: any;
+  };
+  title: string;
+  details: string | null;
+  terms: string | null;
+  startDate: string;
+  endDate: string;
+  daysAvailable: number[];
+  automatic: number;
+  rule: PromotionRuleSet;
+  x: number;
+  y: number | null;
+}
+interface PromotionResponse {
+  promotions: {
+    [key: number]: Promotion;
+  };
+  api: apiResponse;
+}
+interface FetchPromotionsParams {
+  /** Optional id filter. Forwarded when provided. */
+  promotionIds?: Array<number>;
+  /** Whether to include soft-deleted records. Defaults to `false`. */
+  deleted?: boolean;
+  /** Token override (also accepted via `options.token`). */
+  token?: string;
+}
+/**
+ * Fetches promotions. Returns the flattened `Promotion[]`.
+ */
+declare function fetchPromotions(params?: FetchPromotionsParams, options?: RequestOptions): Promise<Promotion[]>;
+//#endregion
+//#region src/core/store.d.ts
+interface Store {
+  id: number;
+  lat: number;
+  lng: number;
+  addressLine1: string;
+  addressLine2: string | null;
+  addressLine3: string;
+  phoneNumber: string;
+  city: string;
+  postcode: string;
+  countryId: number | null;
+  timezoneId: number | null;
+  storeDeleteDate: string | null;
+  email: string | null;
+  sandbox: boolean | null;
+}
+interface StoreResponse {
+  stores: {
+    [key: number]: Store;
+  };
+  api: apiResponse;
+}
+interface FetchStoresParams {
+  /** Whether to include soft-deleted records. Defaults to `false`. */
+  deleted?: boolean;
+}
+/**
+ * Fetches stores. Returns the flattened `Store[]`.
+ */
+declare function fetchStores(params?: FetchStoresParams, options?: RequestOptions): Promise<Store[]>;
+//#endregion
+//#region src/core/report.d.ts
+interface ReportKey {
+  name: string;
+  type: string;
+  item?: ReportKey[];
+}
+interface ReportData {
+  keys: ReportKey[];
+  data: any[][];
+}
+interface ReportResponse {
+  reports: {
+    [key: string]: ReportData;
+  };
+  api: apiResponse;
+}
+interface ReportQuery {
+  FROM: string;
+  WHERE?: {
+    AND?: string[];
+    OR?: string[];
+  };
+  SELECT?: string[];
+  LIMIT?: number;
+  OFFSET?: number;
+}
+interface ReportQueryMap {
+  [key: string]: ReportQuery;
+}
+/**
+ * Runs one or more report queries and returns the `reports` map keyed by query
+ * name. The query is JSON-encoded into the `extras.query` header, matching the
+ * original endpoint contract.
+ */
+declare function fetchReport(query: ReportQueryMap, options?: RequestOptions): Promise<ReportResponse["reports"]>;
+//#endregion
+//#region src/core/session.d.ts
+/**
+ * Ends the current server session.
+ *
+ * This is the framework-agnostic half of the original `useLogout` hook. The
+ * Next.js-specific redirect logic (router.push to the auth server logout URL,
+ * built from server actions) is intentionally NOT included here because it is
+ * tied to `next/navigation` and `'use server'` actions — see the README.
+ */
+declare function logout(options?: RequestOptions): Promise<void>;
+//#endregion
+//#region src/core/entity.d.ts
+/**
+ * Generic CRUD-style mutations extracted from `useHandleDelete` /
+ * `useHandleSubmit`. The original hooks also surfaced notistack snackbars; that
+ * UI concern is deliberately left to the hooks/host layer so core stays
+ * dependency-free.
+ */
+/**
+ * Deletes `/api/{resourcePath}/{entityId}`.
+ */
+declare function deleteEntity(resourcePath: string, entityId: number | string, options?: RequestOptions): Promise<void>;
+interface SubmitEntityArgs {
+  /** Fully-resolved endpoint, e.g. `/api/products` or `/api/products/42`. */
+  endpoint: string;
+  /** Defaults to PUT when an `entityId` exists, otherwise POST. */
+  method?: "POST" | "PUT";
+  /** The request payload (already transformed by the caller). */
+  payload: unknown;
+}
+interface SubmitEntityResponse<R = any> {
+  result?: R;
+  [key: string]: unknown;
+}
+/**
+ * Sends a create/update mutation and returns the parsed `result` field
+ * (matching the original `result.result` access).
+ */
+declare function submitEntity<R = any>({
+  endpoint,
+  method,
+  payload
+}: SubmitEntityArgs, options?: RequestOptions): Promise<R | undefined>;
+//#endregion
+//#region src/core/basket.d.ts
+interface BasketItem {
+  productId: number;
+  productName: string;
+  quantity: number;
+  price: number;
+  tax: number;
+}
+interface Basket {
+  id: number;
+  name: string;
+  consumerId: number;
+  products: BasketItem[];
+  total: number;
+  taxTotal: number;
+  status: "pending" | "completed" | "cancelled";
+  completeDate: string;
+}
+interface BasketReportRow {
+  id: number;
+  basketId: number;
+  basketName: string;
+  consumerId: number;
+  consumerName: string;
+  consumerEmail: string;
+  products: BasketItem[];
+  basketTotal: number;
+  tax: number;
+  dateTime: string;
+  status: string;
+}
+interface BasketSummary {
+  totalBaskets: number;
+  totalRevenue: number;
+  totalTax: number;
+  uniqueConsumers: number;
+}
+interface BasketFilters {
+  search: string;
+  dateRange: {
+    start: Date | null;
+    end: Date | null;
+  };
+  consumerId: number | null;
+  status: "all" | "pending" | "completed" | "cancelled";
+}
+interface BasketPagination {
+  page: number;
+  pageSize: number;
+  total: number;
+}
+declare const DEFAULT_BASKET_FILTERS: BasketFilters;
+declare const DEFAULT_PAGINATION: BasketPagination;
+/** Intermediate shape produced by {@link parseBasketReportData}. */
+interface ParsedBasket {
+  id: number;
+  name: string;
+  consumerId: number;
+  products: BasketItem[];
+  total: number;
+  taxTotal: number;
+  status: "completed";
+  completeDate: string;
+}
+/** Formats a date as `YYYY-MM-DD HH:mm:ss` for the report query. */
+declare function formatDateForQuery(date: Date, isEndOfDay?: boolean): string;
+/** Builds the `Basket` report query from a set of filters. */
+declare function buildBasketReportQuery(filters: BasketFilters): ReportQueryMap;
+/** Flattens the raw report rows/keys into structured baskets. */
+declare function parseBasketReportData(reports: ReportResponse["reports"] | null | undefined): ParsedBasket[];
+/** Unique non-null consumer ids referenced by a set of baskets. */
+declare function collectConsumerIds(baskets: ParsedBasket[]): number[] | null;
+/** Unique product ids referenced by a set of baskets. */
+declare function collectProductIds(baskets: ParsedBasket[]): number[] | null;
+interface CombineBasketRowsParams {
+  baskets: ParsedBasket[];
+  consumerMap: {
+    [id: number]: Consumer;
+  };
+  productMap: {
+    [id: number]: Product;
+  };
+  search?: string;
+}
+/** Joins baskets with consumer + product lookups, applies search, sorts. */
+declare function combineBasketRows({
+  baskets,
+  consumerMap,
+  productMap,
+  search
+}: CombineBasketRowsParams): BasketReportRow[];
+/** Aggregate totals for a set of report rows. */
+declare function computeBasketSummary(rows: BasketReportRow[]): BasketSummary;
+/** Builds a consumer id → consumer lookup. */
+declare function buildConsumerMap(consumers: Consumer[] | null | undefined): {
+  [id: number]: Consumer;
+};
+//#endregion
+export { Basket, BasketFilters, BasketItem, BasketPagination, BasketReportRow, BasketSummary, Category, CategoryResponse, CombineBasketRowsParams, Consumer, ConsumerResponse, DEFAULT_BASKET_FILTERS, DEFAULT_PAGINATION, Employee, EmployeeResponse, ErrorMessage, Extras, FetchCategoriesParams, FetchEmployeesParams, FetchProductsParams, FetchPromotionsParams, FetchStoresParams, MessageInfo, ParsedBasket, Product, ProductInstance, ProductResponse, Promotion, PromotionResponse, PromotionRuleSet, ReportData, ReportKey, ReportQuery, ReportQueryMap, ReportResponse, RequestOptions, Store, StoreResponse, SubmitEntityArgs, SubmitEntityResponse, SuccessMessage, apiDelete, apiGet, apiResponse, apiSend, buildBasketReportQuery, buildConsumerMap, collectConsumerIds, collectProductIds, combineBasketRows, computeBasketSummary, deleteEntity, fetchCategories, fetchConsumers, fetchEmployees, fetchProducts, fetchProductsMap, fetchPromotions, fetchReport, fetchStores, formatDateForQuery, getApiErrors, logout, parseBasketReportData, rolesById, submitEntity };
+//# sourceMappingURL=index.d.cts.map