@squadbase/vantage 0.6.2-dev1.b28a4df → 0.6.2-dev1.b40ce36

package/dist/chunk-ANZLVSEP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/query/api.ts","../src/query/hooks.ts"],"names":[],"mappings":"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","file":"chunk-ANZLVSEP.js","sourcesContent":["/**\n * The one seam for calling the API from client code. All `/api/*` requests go\n * through here so a split deployment (client on S3/CloudFront, server on Lambda)\n * can point the client at a different origin without touching page code.\n *\n * The base is read from `import.meta.env.PUBLIC_API_BASE_URL` — a `PUBLIC_`\n * prefixed var so it is inlined into the client bundle (see envPrefix in the\n * Vite plugin). It can be set in `.env` or injected at build time via\n * `vantage build --api-base-url <url>`. When unset it is empty, so requests stay\n * same-origin relative paths — identical to hand-written `fetch(\"/api/...\")`.\n */\nimport { isDraftActive } from \"../client/draft-state\"\n\n/** The configured API base URL (no trailing slash), or \"\" for same-origin. */\nexport function apiBaseUrl(): string {\n  // `import.meta.env` is typed in the generated .vantage/types, not here.\n  const env = (import.meta as { env?: Record<string, string | undefined> }).env\n  const raw = env?.PUBLIC_API_BASE_URL ?? \"\"\n  return raw.replace(/\\/+$/, \"\")\n}\n\n/**\n * Build a full API URL. Pass the path exactly as it maps to `server/api/**`,\n * including the `/api` prefix — e.g. `apiUrl(\"/api/customers\")`. With no base\n * configured this returns the relative path unchanged.\n */\nexport function apiUrl(path: string): string {\n  const rel = path.startsWith(\"/\") ? path : `/${path}`\n  return apiBaseUrl() + rel\n}\n\n/**\n * Thin `fetch` wrapper that resolves the path against the API base. Returns the\n * raw `Response` — parsing and error handling stay with the caller, matching the\n * existing `queryFn` style.\n */\nexport function apiFetch(path: string, init?: RequestInit): Promise<Response> {\n  return fetch(apiUrl(path), init)\n}\n\n/** Query-string values accepted by the API helpers. */\nexport type ApiSearch = Record<\n  string,\n  string | number | boolean | null | undefined | (string | number)[]\n>\n\n/**\n * Append a query string to an API path. `undefined`/`null` entries are dropped\n * so an unset filter leaves the URL — and the query key — unchanged. Array\n * values repeat the key, matching `URLSearchParams.getAll` on the server.\n */\nexport function apiPath(path: string, search?: ApiSearch): string {\n  if (!search) return path\n  const params = new URLSearchParams()\n  // Sorted so two calls with the same filters produce the same query key.\n  for (const key of Object.keys(search).sort()) {\n    const value = search[key]\n    if (value === undefined || value === null) continue\n    if (Array.isArray(value)) {\n      for (const item of value) params.append(key, String(item))\n    } else {\n      params.append(key, String(value))\n    }\n  }\n  const qs = params.toString()\n  if (!qs) return path\n  return path + (path.includes(\"?\") ? \"&\" : \"?\") + qs\n}\n\n/**\n * A non-2xx response from `server/api`. `message` is the server's `HttpError`\n * message when there was one; anything else surfaces as a generic status text,\n * mirroring what the server chose to disclose.\n */\nexport class ApiError extends Error {\n  /** HTTP status of the response. */\n  readonly status: number\n  /** Parsed response body, when there was one. */\n  readonly body: unknown\n  /** `x-vantage-request-id`, to correlate with the server's terminal log. */\n  readonly requestId: string | undefined\n\n  constructor(message: string, status: number, body: unknown, requestId?: string) {\n    super(message)\n    this.name = \"ApiError\"\n    this.status = status\n    this.body = body\n    this.requestId = requestId\n  }\n}\n\n/**\n * Fetch an API route and parse its JSON, throwing `ApiError` on a non-2xx.\n * This is what the API hooks call; use it directly in a loader or an event\n * handler where a hook doesn't fit.\n */\nexport async function apiJson<T = unknown>(path: string, init?: RequestInit): Promise<T> {\n  const res = await apiFetch(path, init)\n  const requestId = res.headers.get(\"x-vantage-request-id\") ?? undefined\n\n  // Read as text first: an error response may be HTML from a proxy, and a 204\n  // has no body at all — neither should throw a JSON parse error at the caller.\n  const text = await res.text()\n  let body: unknown\n  if (text) {\n    try {\n      body = JSON.parse(text)\n    } catch {\n      body = text\n    }\n  }\n\n  // While a draft is showing, an API the page calls may not exist yet. Without\n  // `server/` the dev server answers any GET with the app shell, a 200 that\n  // would otherwise pass for data; call it what it is (a missing route).\n  if (res.ok && isDraftActive() && (res.headers.get(\"content-type\") ?? \"\").includes(\"text/html\")) {\n    throw new ApiError(\"API route not found\", 404, body, requestId)\n  }\n\n  if (!res.ok) {\n    const serverMessage =\n      typeof body === \"object\" && body !== null && typeof (body as { error?: unknown }).error === \"string\"\n        ? (body as { error: string }).error\n        : undefined\n    throw new ApiError(\n      serverMessage ?? `${res.status} ${res.statusText || \"Request failed\"}`,\n      res.status,\n      body,\n      requestId,\n    )\n  }\n\n  return body as T\n}\n","/**\n * Hooks for the app's own `server/api` routes. They are `useQuery`/`useMutation`\n * with the parts every page was repeating — base URL, JSON parsing, non-2xx to\n * `ApiError`, a query key derived from the URL — moved into the framework.\n * Everything else about TanStack Query stays available through the options.\n */\nimport { useMutation, useQuery } from \"@tanstack/react-query\"\nimport type {\n  QueryKey,\n  UseMutationOptions,\n  UseMutationResult,\n  UseQueryOptions,\n  UseQueryResult,\n} from \"@tanstack/react-query\"\nimport { isDraftActive } from \"../client/draft-state\"\nimport { API_QUERY_KEY as API_KEY } from \"./client\"\nimport { apiJson, apiPath, ApiError as ApiErrorClass, type ApiError, type ApiSearch } from \"./api\"\n\n\n/** How often a query whose API route does not exist yet looks again, while a draft is showing. */\nconst MISSING_API_POLL_MS = 2000\n\n/** An API route that is not there (yet): a 404 from `server/api`, or the app shell standing in for it. */\nfunction isMissingApi(error: unknown): boolean {\n  return error instanceof ApiErrorClass && error.status === 404\n}\n\nexport interface ApiQueryOptions<TData>\n  extends Omit<UseQueryOptions<TData, ApiError>, \"queryKey\" | \"queryFn\"> {\n  /** Query-string values; `undefined` entries are omitted. */\n  search?: ApiSearch\n  /** Extra `fetch` init (headers, credentials, …). */\n  init?: RequestInit\n  /** Override the derived `[\"api\", url]` key. */\n  queryKey?: QueryKey\n}\n\n/**\n * GET an API route.\n *\n * ```tsx\n * const { data, isPending, error } = useApiQuery<Monthly>(\"/api/monthly-analysis\")\n * const filtered = useApiQuery<Row[]>(\"/api/customers\", { search: { segment } })\n * ```\n *\n * The key defaults to `[\"api\", <url with query string>]`, so changing `search`\n * refetches and `invalidateQueries({ queryKey: [\"api\"] })` clears everything.\n */\nexport function useApiQuery<TData = unknown>(\n  path: string,\n  options: ApiQueryOptions<TData> = {},\n): UseQueryResult<TData, ApiError> {\n  const { search, init, queryKey, refetchInterval, ...rest } = options\n  const url = apiPath(path, search)\n  const result = useQuery<TData, ApiError>({\n    queryKey: queryKey ?? [API_KEY, url],\n    // The signal comes from TanStack so an unmounted/refetched query aborts;\n    // a caller-supplied signal wins.\n    queryFn: ({ signal }) => apiJson<TData>(url, { ...init, signal: init?.signal ?? signal }),\n    // While a draft is showing, a route that does not exist yet is looked for\n    // again until it does; otherwise the caller's interval applies untouched.\n    refetchInterval: (query) =>\n      isDraftActive() && isMissingApi(query.state.error)\n        ? MISSING_API_POLL_MS\n        : typeof refetchInterval === \"function\"\n          ? refetchInterval(query)\n          : refetchInterval,\n    ...rest,\n  })\n  // A page written before its API is still loading as far as the page can tell:\n  // it keeps its loading state instead of drawing an error for a route the\n  // agent has not written yet.\n  if (isDraftActive() && isMissingApi(result.error)) {\n    return {\n      ...result,\n      status: \"pending\",\n      error: null,\n      isError: false,\n      isLoadingError: false,\n      isPending: true,\n      isLoading: true,\n    } as UseQueryResult<TData, ApiError>\n  }\n  return result\n}\n\nexport interface ApiMutationOptions<TData, TVariables>\n  extends Omit<UseMutationOptions<TData, ApiError, TVariables>, \"mutationFn\"> {\n  /** HTTP method (default `\"POST\"`). */\n  method?: \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\"\n  /** Extra `fetch` init (headers, credentials, …). */\n  init?: RequestInit\n}\n\n/**\n * Write to an API route. The mutation variables are sent as the JSON body.\n *\n * ```tsx\n * const save = useApiMutation<Customer, { id: string; name: string }>(\n *   (vars) => `/api/customers/${vars.id}`,\n *   { method: \"PUT\" },\n * )\n * save.mutate({ id: \"1\", name: \"Northwind\" })\n * ```\n */\nexport function useApiMutation<TData = unknown, TVariables = void>(\n  path: string | ((variables: TVariables) => string),\n  options: ApiMutationOptions<TData, TVariables> = {},\n): UseMutationResult<TData, ApiError, TVariables> {\n  const { method = \"POST\", init, ...rest } = options\n  return useMutation<TData, ApiError, TVariables>({\n    mutationFn: (variables: TVariables) => {\n      const url = typeof path === \"function\" ? path(variables) : path\n      const hasBody = variables !== undefined && variables !== null\n      return apiJson<TData>(url, {\n        method,\n        ...init,\n        headers: hasBody\n          ? { \"content-type\": \"application/json\", ...(init?.headers as Record<string, string>) }\n          : init?.headers,\n        ...(hasBody ? { body: JSON.stringify(variables) } : {}),\n      })\n    },\n    ...rest,\n  })\n}\n"]}

package/dist/{chunk-XQUSGIDG.js → chunk-CKWPK4RO.js}

@@ -2,6 +2,13 @@ import { QueryClient } from '@tanstack/react-query';
 
 // @squadbase/vantage — generated build. Do not edit.
 
+var API_QUERY_KEY = "api";
+var API_REFRESH_DEBOUNCE_MS = 300;
+function refreshApiQueries(client) {
+  return client.invalidateQueries({
+    predicate: (query) => query.queryKey[0] === API_QUERY_KEY || query.state.status === "error"
+  });
+}
 function createQueryClient() {
   return new QueryClient({
     defaultOptions: {
@@ -38,6 +45,6 @@ function setDraftActive(active) {
   window.__VANTAGE_DRAFT__ = { active };
 }
 
-export { SETTLING_MS, createQueryClient, isDraftActive, isDraftSettling, setDraftActive };
-//# sourceMappingURL=chunk-XQUSGIDG.js.map
-//# sourceMappingURL=chunk-XQUSGIDG.js.map
+export { API_QUERY_KEY, API_REFRESH_DEBOUNCE_MS, SETTLING_MS, createQueryClient, isDraftActive, isDraftSettling, refreshApiQueries, setDraftActive };
+//# sourceMappingURL=chunk-CKWPK4RO.js.map
+//# sourceMappingURL=chunk-CKWPK4RO.js.map

package/dist/chunk-CKWPK4RO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/query/client.ts","../src/client/draft-state.ts"],"names":[],"mappings":";;;;AAGO,IAAM,aAAA,GAAgB;AAOtB,IAAM,uBAAA,GAA0B;AAOhC,SAAS,kBAAkB,MAAA,EAAoC;AACpE,EAAA,OAAO,OAAO,iBAAA,CAAkB;AAAA,IAC9B,SAAA,EAAW,CAAC,KAAA,KAAU,KAAA,CAAM,QAAA,CAAS,CAAC,CAAA,KAAM,aAAA,IAAiB,KAAA,CAAM,KAAA,CAAM,MAAA,KAAW;AAAA,GACrF,CAAA;AACH;AAOO,SAAS,iBAAA,GAAiC;AAC/C,EAAA,OAAO,IAAI,WAAA,CAAY;AAAA,IACrB,cAAA,EAAgB;AAAA,MACd,OAAA,EAAS;AAAA,QACP,SAAA,EAAW,GAAA;AAAA,QACX,KAAA,EAAO,CAAA;AAAA,QACP,oBAAA,EAAsB,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAOtB,WAAA,EAAa;AAAA,OACf;AAAA,MACA,SAAA,EAAW;AAAA,QACT,WAAA,EAAa;AAAA;AACf;AACF,GACD,CAAA;AACH;;;AC3BO,IAAM,WAAA,GAAc;AAEpB,SAAS,aAAA,GAAyB;AACvC,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,mBAAmB,MAAA,KAAW,IAAA;AAC/E;AAOO,SAAS,eAAA,GAA2B;AACzC,EAAA,IAAI,aAAA,IAAiB,OAAO,IAAA;AAC5B,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAAe,KAAK,GAAA,EAAI,IAAK,OAAO,gCAAA,IAAoC,CAAA,CAAA;AACnG;AAEO,SAAS,eAAe,MAAA,EAAuB;AACpD,EAAA,IAAI,CAAC,UAAU,aAAA,EAAc,SAAU,gCAAA,GAAmC,IAAA,CAAK,KAAI,GAAI,WAAA;AACvF,EAAA,MAAA,CAAO,iBAAA,GAAoB,EAAE,MAAA,EAAO;AACtC","file":"chunk-CKWPK4RO.js","sourcesContent":["import { QueryClient } from \"@tanstack/react-query\"\n\n/** Query-key namespace of `useApiQuery`, so `invalidateQueries({ queryKey: [\"api\"] })` works. */\nexport const API_QUERY_KEY = \"api\"\n\n/**\n * Debounce for the api-change refetch. The changed `paths` cannot be mapped to\n * query keys reliably (custom `queryKey`s, dynamic segments), so every burst of\n * changes is coalesced into a single refetch of all API/errored queries.\n */\nexport const API_REFRESH_DEBOUNCE_MS = 300\n\n/**\n * An API module came, went or changed on the dev server: refetch the active API\n * queries, plus any query that is in an error state (a custom `queryKey` that\n * failed because the route did not exist yet still recovers).\n */\nexport function refreshApiQueries(client: QueryClient): Promise<void> {\n  return client.invalidateQueries({\n    predicate: (query) => query.queryKey[0] === API_QUERY_KEY || query.state.status === \"error\",\n  })\n}\n\n/**\n * Create the QueryClient with Vantage defaults. Individual queries may override\n * these, but replacing the QueryClient wholesale is intentionally not exposed —\n * Squadbase relies on a single managed client for auth, logging and telemetry.\n */\nexport function createQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        staleTime: 30_000,\n        retry: 1,\n        refetchOnWindowFocus: false,\n        // A dashboard talks to its own origin (or the configured API base), so\n        // the browser's offline heuristic says nothing useful about whether a\n        // request can succeed. Under the default \"online\" mode a failed request\n        // is *paused* rather than retried whenever that heuristic reads\n        // offline, and the page sits on its loading state forever instead of\n        // showing the error.\n        networkMode: \"always\",\n      },\n      mutations: {\n        networkMode: \"always\",\n      },\n    },\n  })\n}\n","/**\n * Whether the preview is currently showing a draft. The server announces it\n * (`vantage:draft-state`); until the first announcement `window.__VANTAGE_DRAFT__`\n * does not exist at all, which is how an app without the draft layer behaves.\n *\n * Kept free of React and of module state: `client/` and `query/` are separate\n * published entries, so the one thing they share is this global.\n */\nexport interface DraftWindowState {\n  active: boolean\n}\n\ndeclare global {\n  interface Window {\n    __VANTAGE_DRAFT__?: DraftWindowState\n    /** Until when (ms epoch) a draft that just ended still counts for failures (see `isDraftSettling`). */\n    __VANTAGE_DRAFT_SETTLING_UNTIL__?: number\n  }\n}\n\n/** How long after a draft ends a failure is still taken to be the draft's. */\nexport const SETTLING_MS = 1500\n\nexport function isDraftActive(): boolean {\n  return typeof window !== \"undefined\" && window.__VANTAGE_DRAFT__?.active === true\n}\n\n/**\n * A draft is showing, or ended a moment ago. The server announces the end before\n * the version it fell back to reaches the page, and a failing draft drawn once\n * more in that gap must still be held back, not shown as an error page.\n */\nexport function isDraftSettling(): boolean {\n  if (isDraftActive()) return true\n  return typeof window !== \"undefined\" && Date.now() < (window.__VANTAGE_DRAFT_SETTLING_UNTIL__ ?? 0)\n}\n\nexport function setDraftActive(active: boolean): void {\n  if (!active && isDraftActive()) window.__VANTAGE_DRAFT_SETTLING_UNTIL__ = Date.now() + SETTLING_MS\n  window.__VANTAGE_DRAFT__ = { active }\n}\n"]}