@keboola/api-client-react 27.0.0 → 31.0.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context.ts","../src/ApiClientProvider.tsx","../src/AuthProvider.tsx","../src/LegacyAuthProvider.tsx"],"names":["createContext","use","jsx","useState","useRef","useEffect"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, use } from 'react';\n\nimport type { BearerSession, KeboolaApi, LegacySession } from '@keboola/api-client';\n\nconst MISSING_API_CLIENT_ERROR = 'useApiClient must be used within <ApiClientProvider />';\nconst MISSING_PROJECT_ERROR = 'useProject must be used within <ApiClientProvider />';\nconst MISSING_STACK_ERROR = 'useStack must be used within <ApiClientProvider />';\nconst MISSING_AUTH_ERROR = 'useAuth must be used within <AuthProvider />';\nconst MISSING_LEGACY_AUTH_ERROR = 'useLegacyAuth must be used within <LegacyAuthProvider />';\n\n// The product API (`auth` + `management` + every product namespace), flow-agnostic. Both the\n// bearer and legacy flows produce the same `KeboolaApi` surface, so consumers never branch on flow.\nconst ApiContext = createContext<KeboolaApi | null>(null);\nexport const ApiProvider = ApiContext;\n\n// The lifecycle sessions live in their own, flow-specific contexts so the auth surface a component\n// reaches for is explicit. Only the matching provider is mounted per flow.\nconst AuthContext = createContext<BearerSession | null>(null);\nexport const AuthContextProvider = AuthContext;\n\nconst LegacyAuthContext = createContext<LegacySession | null>(null);\nexport const LegacyAuthContextProvider = LegacyAuthContext;\n\nexport const useApiClient = () => {\n  const api = use(ApiContext);\n  if (api === null) throw new Error(MISSING_API_CLIENT_ERROR);\n  return api;\n};\n\nexport const useProject = () => {\n  const api = use(ApiContext);\n  if (api === null) throw new Error(MISSING_PROJECT_ERROR);\n  return api.context.project;\n};\n\nexport const useStack = () => {\n  const api = use(ApiContext);\n  if (api === null) throw new Error(MISSING_STACK_ERROR);\n  return api.context.stack;\n};\n\n/** The bearer (OAuth) lifecycle session. Throws outside `<AuthProvider />`. */\nexport const useAuth = () => {\n  const session = use(AuthContext);\n  if (session === null) throw new Error(MISSING_AUTH_ERROR);\n  return session;\n};\n\n/** The legacy (SAPI) lifecycle session. Throws outside `<LegacyAuthProvider />`. */\nexport const useLegacyAuth = () => {\n  const session = use(LegacyAuthContext);\n  if (session === null) throw new Error(MISSING_LEGACY_AUTH_ERROR);\n  return session;\n};\n","import type { ReactNode } from 'react';\n\nimport type { KeboolaApi } from '@keboola/api-client';\n\nimport { ApiProvider } from './context';\n\ntype Props = {\n  /** The flow-agnostic product API — the `api` half of a keboola client. */\n  api: KeboolaApi;\n  children: ReactNode;\n};\n\n/**\n * Provides the product API to `useApiClient()`. A pure pass-through: the auth lifecycle (driving\n * to ready, gating on a fallback) belongs to `AuthProvider` / `LegacyAuthProvider`, which mount\n * this provider once their session is ready.\n */\nexport const ApiClientProvider = ({ api, children }: Props) => (\n  <ApiProvider value={api}>{children}</ApiProvider>\n);\n","import { useEffect, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\n\nimport type { BearerSession } from '@keboola/api-client';\n\nimport { AuthContextProvider } from './context';\n\ntype BearerCredential = Parameters<BearerSession['authenticate']>[0];\ntype Snapshot = ReturnType<BearerSession['debug']>;\ntype RestoreStatus = Awaited<ReturnType<BearerSession['restore']>>['status'];\n\n/** The session state guaranteed to exist once the storage build is ready. */\ntype ScopedState = { projectId: number; baseUrl: string };\n\ntype BaseProps = {\n  session: BearerSession;\n  onAccessTokenChange?: (accessToken: string) => void;\n  /** Rendered while a persisted session is being restored, or the bootstrap is in flight. */\n  loadingFallback?: ReactNode;\n  /** Rendered when the storage build fails. */\n  errorFallback?: ReactNode;\n  /**\n   * Rendered only once the session is scoped and the storage build is ready. Pass a function to\n   * receive the scoped state (the project the session settled on) without re-narrowing it yourself.\n   */\n  children: ReactNode | ((scoped: ScopedState) => ReactNode);\n};\n\n/**\n * Two mutually exclusive bootstrap modes, discriminated by whether a credential is supplied:\n * - **programmatic** — `credential` + `projectId` given, so `baseUrl` is **required**: a credential\n *   is bound to the stack that issued it and `authenticate` refuses an unconfigured session.\n * - **interactive** — none of the three given; the stack comes from the session instead — `restore()`\n *   adopts the persisted one, otherwise the login UI sets it. `anonymousFallback` is **required**\n *   here (a missing login UI would leave the app on a permanently blank screen).\n */\ntype Props = BaseProps &\n  (\n    | {\n        credential: BearerCredential;\n        projectId: number;\n        baseUrl: string;\n        anonymousFallback?: never;\n      }\n    | {\n        credential?: undefined;\n        projectId?: undefined;\n        baseUrl?: never;\n        anonymousFallback: ReactNode;\n      }\n  );\n\nexport const AuthProvider = ({\n  session,\n  baseUrl,\n  credential,\n  projectId,\n  onAccessTokenChange,\n  loadingFallback = null,\n  errorFallback = null,\n  anonymousFallback = null,\n  children,\n}: Props) => {\n  const [snapshot, setSnapshot] = useState<Snapshot>(() => session.debug());\n  const [isRestoring, setIsRestoring] = useState(() => session.hasPersistedValue());\n  const [restoreStatus, setRestoreStatus] = useState<RestoreStatus | null>(null);\n  const restoreStartedRef = useRef(false);\n\n  useEffect(() => session.subscribe(setSnapshot), [session]);\n\n  // Programmatic only. Interactive leaves the stack unset: `restore()` adopts the persisted one, and\n  // failing that the login UI picks it — so there is nothing to configure up front.\n  useEffect(() => {\n    if (baseUrl === undefined) return;\n    if (snapshot.config.baseUrl !== null) return;\n    session.setBaseUrl(baseUrl);\n  }, [session, baseUrl, snapshot.config.baseUrl]);\n\n  // Runs regardless of whether a stack is configured — with none, `restore()` adopts the stack the\n  // persisted session belongs to. (Declared after the effect above, so programmatic mode has already\n  // configured its stack by the time this runs.) The ref guards StrictMode's double-invoked effect:\n  // `restoreStatus` only lands asynchronously, so it cannot prevent a second synchronous call.\n  useEffect(() => {\n    if (restoreStartedRef.current) return;\n    restoreStartedRef.current = true;\n    session\n      .restore()\n      .then((result) => setRestoreStatus(result.status))\n      .catch((error) => {\n        console.error('Keboola bearer session restore failed', error);\n        setRestoreStatus('empty');\n      })\n      .finally(() => setIsRestoring(false));\n  }, [session]);\n\n  useEffect(() => {\n    if (restoreStatus === null || restoreStatus === 'restored') return;\n    if (credential === undefined) return;\n    if (snapshot.config.status !== 'anonymous') return;\n    session.authenticate(credential);\n  }, [session, restoreStatus, credential, snapshot.config.status]);\n\n  useEffect(() => {\n    if (restoreStatus === null || restoreStatus === 'restored') return;\n    if (projectId === undefined) return;\n    if (snapshot.config.status !== 'authenticated') return;\n    session.setProject(projectId);\n  }, [session, restoreStatus, projectId, snapshot.config.status]);\n\n  const accessToken =\n    snapshot.config.status === 'anonymous' ? undefined : snapshot.config.credential.accessToken;\n\n  useEffect(() => {\n    if (accessToken !== undefined) onAccessTokenChange?.(accessToken);\n  }, [accessToken, onAccessTokenChange]);\n\n  // Programmatic mode drives itself to ready, so it must never fall through to `anonymousFallback`.\n  const isProgrammatic = credential !== undefined && projectId !== undefined;\n\n  const content = (() => {\n    if (snapshot.storage === 'ready') {\n      if (typeof children !== 'function') return children;\n      // A ready storage build implies a scoped session; narrowing here is for the type checker.\n      if (snapshot.config.status !== 'scoped') return null;\n      const { projectId: scopedProjectId, baseUrl: scopedBaseUrl } = snapshot.config;\n      return children({ projectId: scopedProjectId, baseUrl: scopedBaseUrl });\n    }\n    if (snapshot.storage === 'errored') return errorFallback;\n    if (isRestoring || snapshot.storage === 'pending' || isProgrammatic) return loadingFallback;\n    return anonymousFallback;\n  })();\n\n  return <AuthContextProvider value={session}>{content}</AuthContextProvider>;\n};\n","import { useEffect, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\n\nimport type { LegacySession } from '@keboola/api-client';\n\nimport { LegacyAuthContextProvider } from './context';\n\ntype Props = {\n  session: LegacySession;\n  /** Stack base URL. */\n  baseUrl: string;\n  /** SAPI token — drives the storage build to ready. */\n  storageToken: string;\n  /** Optional manage-api token — unlocks `api.management`. */\n  managementToken?: string;\n  /** Rendered until the storage build reaches ready. */\n  fallback?: ReactNode;\n  /** Rendered when the storage build fails — e.g. the SAPI token is expired or revoked. */\n  errorFallback?: ReactNode;\n  children: ReactNode;\n};\n\n/**\n * Owns the legacy (SAPI) lifecycle: on mount it configures the stack and drives the session to\n * ready, rendering `fallback` until the storage build resolves. The backend-injected SAPI token is\n * known up front, so this drives itself (unlike the interactive bearer `AuthProvider`). Exposes the\n * session via `useLegacyAuth()` and gates `children` behind readiness.\n */\nexport const LegacyAuthProvider = ({\n  session,\n  baseUrl,\n  storageToken,\n  managementToken,\n  fallback = null,\n  errorFallback = fallback,\n  children,\n}: Props) => {\n  // The build state, not just readiness: `errored` and `pending` render differently.\n  const [storageState, setStorageState] = useState(() => session.debug().storage);\n  // Guards the once-only drive against React StrictMode's double-mounted effect.\n  const startedRef = useRef<boolean>(false);\n\n  useEffect(() => {\n    const unsubscribe = session.subscribe((snapshot) => setStorageState(snapshot.storage));\n\n    if (!startedRef.current) {\n      startedRef.current = true;\n      session.setBaseUrl(baseUrl);\n      if (managementToken) session.authenticateManagement(managementToken);\n      // Fire-and-forget: `subscribe` moves `storageState` once the build resolves. A failed build\n      // resolves rather than rejects, so this catch only covers a synchronous throw.\n      void session\n        .authenticateStorageAsync(storageToken)\n        .catch((error) => console.error('Keboola session bootstrap failed', error));\n    }\n\n    return unsubscribe;\n    // drive to ready only on initial mount\n    // oxlint-disable-next-line react/exhaustive-deps\n  }, []);\n\n  // The only place a failed build is observable — nothing rejects, so without this it is silent.\n  useEffect(() => {\n    if (storageState === 'errored') {\n      console.error('Keboola session bootstrap failed: the storage build errored.');\n    }\n  }, [storageState]);\n\n  const content = (() => {\n    if (storageState === 'ready') return children;\n    if (storageState === 'errored') return errorFallback;\n    return fallback;\n  })();\n\n  return <LegacyAuthContextProvider value={session}>{content}</LegacyAuthContextProvider>;\n};\n"]}
+{"version":3,"file":"index.cjs","names":["createContext","use","useState","useRef","useState","useRef"],"sources":["../src/context.ts","../src/ApiClientProvider.tsx","../src/AuthProvider.tsx","../src/LegacyAuthProvider.tsx"],"sourcesContent":["import { createContext, use } from 'react';\n\nimport type { BearerSession, KeboolaApi, LegacySession } from '@keboola/api-client';\n\nconst MISSING_API_CLIENT_ERROR = 'useApiClient must be used within <ApiClientProvider />';\nconst MISSING_PROJECT_ERROR = 'useProject must be used within <ApiClientProvider />';\nconst MISSING_STACK_ERROR = 'useStack must be used within <ApiClientProvider />';\nconst MISSING_AUTH_ERROR = 'useAuth must be used within <AuthProvider />';\nconst MISSING_LEGACY_AUTH_ERROR = 'useLegacyAuth must be used within <LegacyAuthProvider />';\n\n// The product API (`auth` + `management` + every product namespace), flow-agnostic. Both the\n// bearer and legacy flows produce the same `KeboolaApi` surface, so consumers never branch on flow.\nconst ApiContext = createContext<KeboolaApi | null>(null);\nexport const ApiProvider = ApiContext;\n\n// The lifecycle sessions live in their own, flow-specific contexts so the auth surface a component\n// reaches for is explicit. Only the matching provider is mounted per flow.\nconst AuthContext = createContext<BearerSession | null>(null);\nexport const AuthContextProvider = AuthContext;\n\nconst LegacyAuthContext = createContext<LegacySession | null>(null);\nexport const LegacyAuthContextProvider = LegacyAuthContext;\n\nexport const useApiClient = () => {\n  const api = use(ApiContext);\n  if (api === null) throw new Error(MISSING_API_CLIENT_ERROR);\n  return api;\n};\n\nexport const useProject = () => {\n  const api = use(ApiContext);\n  if (api === null) throw new Error(MISSING_PROJECT_ERROR);\n  return api.context.project;\n};\n\nexport const useStack = () => {\n  const api = use(ApiContext);\n  if (api === null) throw new Error(MISSING_STACK_ERROR);\n  return api.context.stack;\n};\n\n/** The bearer (OAuth) lifecycle session. Throws outside `<AuthProvider />`. */\nexport const useAuth = () => {\n  const session = use(AuthContext);\n  if (session === null) throw new Error(MISSING_AUTH_ERROR);\n  return session;\n};\n\n/** The legacy (SAPI) lifecycle session. Throws outside `<LegacyAuthProvider />`. */\nexport const useLegacyAuth = () => {\n  const session = use(LegacyAuthContext);\n  if (session === null) throw new Error(MISSING_LEGACY_AUTH_ERROR);\n  return session;\n};\n","import type { ReactNode } from 'react';\n\nimport type { KeboolaApi } from '@keboola/api-client';\n\nimport { ApiProvider } from './context';\n\ntype Props = {\n  /** The flow-agnostic product API — the `api` half of a keboola client. */\n  api: KeboolaApi;\n  children: ReactNode;\n};\n\n/**\n * Provides the product API to `useApiClient()`. A pure pass-through: the auth lifecycle (driving\n * to ready, gating on a fallback) belongs to `AuthProvider` / `LegacyAuthProvider`, which mount\n * this provider once their session is ready.\n */\nexport const ApiClientProvider = ({ api, children }: Props) => (\n  <ApiProvider value={api}>{children}</ApiProvider>\n);\n","import { useEffect, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\n\nimport type { BearerSession } from '@keboola/api-client';\n\nimport { AuthContextProvider } from './context';\n\ntype BearerCredential = Parameters<BearerSession['authenticate']>[0];\ntype Snapshot = ReturnType<BearerSession['debug']>;\ntype RestoreStatus = Awaited<ReturnType<BearerSession['restore']>>['status'];\n\n/** The session state guaranteed to exist once the storage build is ready. */\ntype ScopedState = { projectId: number; baseUrl: string };\n\ntype BaseProps = {\n  session: BearerSession;\n  onAccessTokenChange?: (accessToken: string) => void;\n  /** Rendered while a persisted session is being restored, or the bootstrap is in flight. */\n  loadingFallback?: ReactNode;\n  /** Rendered when the storage build fails. */\n  errorFallback?: ReactNode;\n  /**\n   * Rendered only once the session is scoped and the storage build is ready. Pass a function to\n   * receive the scoped state (the project the session settled on) without re-narrowing it yourself.\n   */\n  children: ReactNode | ((scoped: ScopedState) => ReactNode);\n};\n\n/**\n * Two mutually exclusive bootstrap modes, discriminated by whether a credential is supplied:\n * - **programmatic** — `credential` + `projectId` given, so `baseUrl` is **required**: a credential\n *   is bound to the stack that issued it and `authenticate` refuses an unconfigured session.\n * - **interactive** — none of the three given; the stack comes from the session instead — `restore()`\n *   adopts the persisted one, otherwise the login UI sets it. `anonymousFallback` is **required**\n *   here (a missing login UI would leave the app on a permanently blank screen).\n */\ntype Props = BaseProps &\n  (\n    | {\n        credential: BearerCredential;\n        projectId: number;\n        baseUrl: string;\n        anonymousFallback?: never;\n      }\n    | {\n        credential?: undefined;\n        projectId?: undefined;\n        baseUrl?: never;\n        anonymousFallback: ReactNode;\n      }\n  );\n\nexport const AuthProvider = ({\n  session,\n  baseUrl,\n  credential,\n  projectId,\n  onAccessTokenChange,\n  loadingFallback = null,\n  errorFallback = null,\n  anonymousFallback = null,\n  children,\n}: Props) => {\n  const [snapshot, setSnapshot] = useState<Snapshot>(() => session.debug());\n  const [isRestoring, setIsRestoring] = useState(() => session.hasPersistedValue());\n  const [restoreStatus, setRestoreStatus] = useState<RestoreStatus | null>(null);\n  const restoreStartedRef = useRef(false);\n\n  useEffect(() => session.subscribe(setSnapshot), [session]);\n\n  // Programmatic only. Interactive leaves the stack unset: `restore()` adopts the persisted one, and\n  // failing that the login UI picks it — so there is nothing to configure up front.\n  useEffect(() => {\n    if (baseUrl === undefined) return;\n    if (snapshot.config.baseUrl !== null) return;\n    session.setBaseUrl(baseUrl);\n  }, [session, baseUrl, snapshot.config.baseUrl]);\n\n  // Runs regardless of whether a stack is configured — with none, `restore()` adopts the stack the\n  // persisted session belongs to. (Declared after the effect above, so programmatic mode has already\n  // configured its stack by the time this runs.) The ref guards StrictMode's double-invoked effect:\n  // `restoreStatus` only lands asynchronously, so it cannot prevent a second synchronous call.\n  useEffect(() => {\n    if (restoreStartedRef.current) return;\n    restoreStartedRef.current = true;\n    session\n      .restore()\n      .then((result) => setRestoreStatus(result.status))\n      .catch((error) => {\n        console.error('Keboola bearer session restore failed', error);\n        setRestoreStatus('empty');\n      })\n      .finally(() => setIsRestoring(false));\n  }, [session]);\n\n  useEffect(() => {\n    if (restoreStatus === null || restoreStatus === 'restored') return;\n    if (credential === undefined) return;\n    if (snapshot.config.status !== 'anonymous') return;\n    session.authenticate(credential);\n  }, [session, restoreStatus, credential, snapshot.config.status]);\n\n  useEffect(() => {\n    if (restoreStatus === null || restoreStatus === 'restored') return;\n    if (projectId === undefined) return;\n    if (snapshot.config.status !== 'authenticated') return;\n    session.setProject(projectId);\n  }, [session, restoreStatus, projectId, snapshot.config.status]);\n\n  const accessToken =\n    snapshot.config.status === 'anonymous' ? undefined : snapshot.config.credential.accessToken;\n\n  useEffect(() => {\n    if (accessToken !== undefined) onAccessTokenChange?.(accessToken);\n  }, [accessToken, onAccessTokenChange]);\n\n  // Programmatic mode drives itself to ready, so it must never fall through to `anonymousFallback`.\n  const isProgrammatic = credential !== undefined && projectId !== undefined;\n\n  const content = (() => {\n    if (snapshot.storage === 'ready') {\n      if (typeof children !== 'function') return children;\n      // A ready storage build implies a scoped session; narrowing here is for the type checker.\n      if (snapshot.config.status !== 'scoped') return null;\n      const { projectId: scopedProjectId, baseUrl: scopedBaseUrl } = snapshot.config;\n      return children({ projectId: scopedProjectId, baseUrl: scopedBaseUrl });\n    }\n    if (snapshot.storage === 'errored') return errorFallback;\n    if (isRestoring || snapshot.storage === 'pending' || isProgrammatic) return loadingFallback;\n    return anonymousFallback;\n  })();\n\n  return <AuthContextProvider value={session}>{content}</AuthContextProvider>;\n};\n","import { useEffect, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\n\nimport type { LegacySession } from '@keboola/api-client';\n\nimport { LegacyAuthContextProvider } from './context';\n\ntype Props = {\n  session: LegacySession;\n  /** Stack base URL. */\n  baseUrl: string;\n  /** SAPI token — drives the storage build to ready. */\n  storageToken: string;\n  /** Optional manage-api token — unlocks `api.management`. */\n  managementToken?: string;\n  /** Rendered until the storage build reaches ready. */\n  fallback?: ReactNode;\n  /** Rendered when the storage build fails — e.g. the SAPI token is expired or revoked. */\n  errorFallback?: ReactNode;\n  children: ReactNode;\n};\n\n/**\n * Owns the legacy (SAPI) lifecycle: on mount it configures the stack and drives the session to\n * ready, rendering `fallback` until the storage build resolves. The backend-injected SAPI token is\n * known up front, so this drives itself (unlike the interactive bearer `AuthProvider`). Exposes the\n * session via `useLegacyAuth()` and gates `children` behind readiness.\n */\nexport const LegacyAuthProvider = ({\n  session,\n  baseUrl,\n  storageToken,\n  managementToken,\n  fallback = null,\n  errorFallback = fallback,\n  children,\n}: Props) => {\n  // The build state, not just readiness: `errored` and `pending` render differently.\n  const [storageState, setStorageState] = useState(() => session.debug().storage);\n  // Guards the once-only drive against React StrictMode's double-mounted effect.\n  const startedRef = useRef<boolean>(false);\n\n  useEffect(() => {\n    const unsubscribe = session.subscribe((snapshot) => setStorageState(snapshot.storage));\n\n    if (!startedRef.current) {\n      startedRef.current = true;\n      session.setBaseUrl(baseUrl);\n      if (managementToken) session.authenticateManagement(managementToken);\n      // Fire-and-forget: `subscribe` moves `storageState` once the build resolves. A failed build\n      // resolves rather than rejects, so this catch only covers a synchronous throw.\n      void session\n        .authenticateStorageAsync(storageToken)\n        .catch((error) => console.error('Keboola session bootstrap failed', error));\n    }\n\n    return unsubscribe;\n    // drive to ready only on initial mount\n    // oxlint-disable-next-line react/exhaustive-deps\n  }, []);\n\n  // The only place a failed build is observable — nothing rejects, so without this it is silent.\n  useEffect(() => {\n    if (storageState === 'errored') {\n      console.error('Keboola session bootstrap failed: the storage build errored.');\n    }\n  }, [storageState]);\n\n  const content = (() => {\n    if (storageState === 'ready') return children;\n    if (storageState === 'errored') return errorFallback;\n    return fallback;\n  })();\n\n  return <LegacyAuthContextProvider value={session}>{content}</LegacyAuthContextProvider>;\n};\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,177 +1,176 @@
-import * as _keboola_api_client_storage_types from '@keboola/api-client/storage/types';
-import * as _keboola_api_client from '@keboola/api-client';
-import { KeboolaApi, BearerSession, LegacySession } from '@keboola/api-client';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-
+import { BearerSession, KeboolaApi, LegacySession } from "@keboola/api-client";
+import { ReactNode } from "react";
+//#region src/context.d.ts
 declare const useApiClient: () => KeboolaApi;
 declare const useProject: () => {
-    hasFeature: (...feature: string[]) => boolean;
-    hasAdminFeature: (...feature: string[]) => boolean;
-    hasBackend: (backend: _keboola_api_client_storage_types.Backend) => boolean;
-    sapiToken: _keboola_api_client_storage_types.StorageToken;
+  hasFeature: (...feature: string[]) => boolean;
+  hasAdminFeature: (...feature: string[]) => boolean;
+  hasBackend: (backend: import("@keboola/api-client/storage/types").Backend) => boolean;
+  sapiToken: import("@keboola/api-client/storage/types").StorageToken;
 };
 declare const useStack: () => {
-    services: _keboola_api_client_storage_types.Service[];
-    features: string[];
-    components: _keboola_api_client_storage_types.StackComponent[];
-    hasFeature: (...feature: string[]) => boolean;
-    getServiceUrl: (serviceId: _keboola_api_client_storage_types.ServiceId) => string | null;
-    hasService: (serviceId: _keboola_api_client_storage_types.ServiceId) => boolean;
-    getComponent: (componentId: string) => _keboola_api_client_storage_types.StackComponent | null;
-    hasComponent: (...componentId: string[]) => boolean;
-    api: string;
-    documentation: string;
-    host: string;
-    revision: string;
-    stack: string;
-    urlTemplates: {
-        orchestrationJob: string;
-    };
-    version: string;
+  api: string;
+  documentation: string;
+  host: string;
+  revision: string;
+  stack: string;
+  urlTemplates: {
+    orchestrationJob: string;
+  };
+  version: string;
+  services: import("@keboola/api-client/storage/types").Service[];
+  features: string[];
+  components: import("@keboola/api-client/storage/types").StackComponent[];
+  hasFeature: (...feature: string[]) => boolean;
+  getServiceUrl: (serviceId: import("@keboola/api-client/storage/types").ServiceId) => string | null;
+  hasService: (serviceId: import("@keboola/api-client/storage/types").ServiceId) => boolean;
+  getComponent: (componentId: string) => import("@keboola/api-client/storage/types").StackComponent | null;
+  hasComponent: (...componentId: string[]) => boolean;
 };
 /** The bearer (OAuth) lifecycle session. Throws outside `<AuthProvider />`. */
 declare const useAuth: () => {
-    hasPersistedValue: () => boolean;
-    setBaseUrl: (baseUrl: string) => void;
-    isStorageReady: () => boolean;
-    authenticate: (tokens: {
+  hasPersistedValue: () => boolean;
+  setBaseUrl: (baseUrl: string) => void;
+  isStorageReady: () => boolean;
+  authenticate: (tokens: {
+    accessToken: string;
+    refreshToken: string;
+    expiresIn: number;
+  }) => void;
+  setProject: (projectId: number) => void;
+  setProjectAsync: (projectId: number) => Promise<void>;
+  clearProject: () => void;
+  reset: () => void;
+  debugForceRefresh: () => void;
+  restore: () => Promise<{
+    status: 'empty' | 'restored' | 'expired';
+  }>;
+  subscribe: (listener: (snapshot: {
+    type: 'Bearer';
+    config: {
+      status: 'anonymous';
+      baseUrl: string | null;
+    } | {
+      status: 'authenticated';
+      baseUrl: string;
+      credential: {
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+      } & {
+        issuedAt: number;
+      };
+    } | {
+      status: 'scoped';
+      baseUrl: string;
+      credential: {
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+      } & {
+        issuedAt: number;
+      };
+      projectId: number;
+    };
+    authReady: boolean;
+    managementReady: boolean;
+    storage: import("@keboola/api-client").AsyncState<unknown>['state'];
+  }) => void) => () => void;
+  debug: () => {
+    type: 'Bearer';
+    config: {
+      status: 'anonymous';
+      baseUrl: string | null;
+    } | {
+      status: 'authenticated';
+      baseUrl: string;
+      credential: {
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+      } & {
+        issuedAt: number;
+      };
+    } | {
+      status: 'scoped';
+      baseUrl: string;
+      credential: {
         accessToken: string;
         refreshToken: string;
         expiresIn: number;
-    }) => void;
-    setProject: (projectId: number) => void;
-    setProjectAsync: (projectId: number) => Promise<void>;
-    clearProject: () => void;
-    reset: () => void;
-    debugForceRefresh: () => void;
-    restore: () => Promise<{
-        status: "empty" | "restored" | "expired";
-    }>;
-    subscribe: (listener: (snapshot: {
-        type: "Bearer";
-        config: {
-            status: "anonymous";
-            baseUrl: string | null;
-        } | {
-            status: "authenticated";
-            baseUrl: string;
-            credential: {
-                accessToken: string;
-                refreshToken: string;
-                expiresIn: number;
-            } & {
-                issuedAt: number;
-            };
-        } | {
-            status: "scoped";
-            baseUrl: string;
-            credential: {
-                accessToken: string;
-                refreshToken: string;
-                expiresIn: number;
-            } & {
-                issuedAt: number;
-            };
-            projectId: number;
-        };
-        authReady: boolean;
-        managementReady: boolean;
-        storage: _keboola_api_client.AsyncState<unknown>["state"];
-    }) => void) => () => void;
-    debug: () => {
-        type: "Bearer";
-        config: {
-            status: "anonymous";
-            baseUrl: string | null;
-        } | {
-            status: "authenticated";
-            baseUrl: string;
-            credential: {
-                accessToken: string;
-                refreshToken: string;
-                expiresIn: number;
-            } & {
-                issuedAt: number;
-            };
-        } | {
-            status: "scoped";
-            baseUrl: string;
-            credential: {
-                accessToken: string;
-                refreshToken: string;
-                expiresIn: number;
-            } & {
-                issuedAt: number;
-            };
-            projectId: number;
-        };
-        authReady: boolean;
-        managementReady: boolean;
-        storage: _keboola_api_client.AsyncState<unknown>["state"];
+      } & {
+        issuedAt: number;
+      };
+      projectId: number;
     };
+    authReady: boolean;
+    managementReady: boolean;
+    storage: import("@keboola/api-client").AsyncState<unknown>['state'];
+  };
 };
 /** The legacy (SAPI) lifecycle session. Throws outside `<LegacyAuthProvider />`. */
 declare const useLegacyAuth: () => {
-    setBaseUrl: (baseUrl: string) => void;
-    isStorageReady: () => boolean;
-    authenticateStorage: (sapiToken: string) => void;
-    authenticateStorageAsync: (sapiToken: string) => Promise<void>;
-    authenticateManagement: (managementToken: string) => void;
-    subscribe: (listener: (snapshot: {
-        type: "Sapi";
-        config: {
-            baseUrl: string | null;
-            sapiToken: string | null;
-            managementToken: string | null;
-        };
-        authReady: boolean;
-        managementReady: boolean;
-        storage: _keboola_api_client.AsyncState<unknown>["state"];
-    }) => void) => () => void;
-    debug: () => {
-        type: "Sapi";
-        config: {
-            baseUrl: string | null;
-            sapiToken: string | null;
-            managementToken: string | null;
-        };
-        authReady: boolean;
-        managementReady: boolean;
-        storage: _keboola_api_client.AsyncState<unknown>["state"];
+  setBaseUrl: (baseUrl: string) => void;
+  isStorageReady: () => boolean;
+  authenticateStorage: (sapiToken: string) => void;
+  authenticateStorageAsync: (sapiToken: string) => Promise<void>;
+  authenticateManagement: (managementToken: string) => void;
+  subscribe: (listener: (snapshot: {
+    type: 'Sapi';
+    config: {
+      baseUrl: string | null;
+      sapiToken: string | null;
+      managementToken: string | null;
+    };
+    authReady: boolean;
+    managementReady: boolean;
+    storage: import("@keboola/api-client").AsyncState<unknown>['state'];
+  }) => void) => () => void;
+  debug: () => {
+    type: 'Sapi';
+    config: {
+      baseUrl: string | null;
+      sapiToken: string | null;
+      managementToken: string | null;
     };
+    authReady: boolean;
+    managementReady: boolean;
+    storage: import("@keboola/api-client").AsyncState<unknown>['state'];
+  };
 };
-
+//#endregion
+//#region src/ApiClientProvider.d.ts
 type Props$2 = {
-    /** The flow-agnostic product API — the `api` half of a keboola client. */
-    api: KeboolaApi;
-    children: ReactNode;
+  /** The flow-agnostic product API — the `api` half of a keboola client. */
+  api: KeboolaApi;
+  children: ReactNode;
 };
 /**
  * Provides the product API to `useApiClient()`. A pure pass-through: the auth lifecycle (driving
  * to ready, gating on a fallback) belongs to `AuthProvider` / `LegacyAuthProvider`, which mount
  * this provider once their session is ready.
  */
-declare const ApiClientProvider: ({ api, children }: Props$2) => react_jsx_runtime.JSX.Element;
-
+declare const ApiClientProvider: ({ api, children }: Props$2) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/AuthProvider.d.ts
 type BearerCredential = Parameters<BearerSession['authenticate']>[0];
 /** The session state guaranteed to exist once the storage build is ready. */
 type ScopedState = {
-    projectId: number;
-    baseUrl: string;
+  projectId: number;
+  baseUrl: string;
 };
 type BaseProps = {
-    session: BearerSession;
-    onAccessTokenChange?: (accessToken: string) => void;
-    /** Rendered while a persisted session is being restored, or the bootstrap is in flight. */
-    loadingFallback?: ReactNode;
-    /** Rendered when the storage build fails. */
-    errorFallback?: ReactNode;
-    /**
-     * Rendered only once the session is scoped and the storage build is ready. Pass a function to
-     * receive the scoped state (the project the session settled on) without re-narrowing it yourself.
-     */
-    children: ReactNode | ((scoped: ScopedState) => ReactNode);
+  session: BearerSession;
+  onAccessTokenChange?: (accessToken: string) => void;
+  /** Rendered while a persisted session is being restored, or the bootstrap is in flight. */
+  loadingFallback?: ReactNode;
+  /** Rendered when the storage build fails. */
+  errorFallback?: ReactNode;
+  /**
+   * Rendered only once the session is scoped and the storage build is ready. Pass a function to
+   * receive the scoped state (the project the session settled on) without re-narrowing it yourself.
+   */
+  children: ReactNode | ((scoped: ScopedState) => ReactNode);
 };
 /**
  * Two mutually exclusive bootstrap modes, discriminated by whether a credential is supplied:
@@ -182,31 +181,32 @@ type BaseProps = {
  *   here (a missing login UI would leave the app on a permanently blank screen).
  */
 type Props$1 = BaseProps & ({
-    credential: BearerCredential;
-    projectId: number;
-    baseUrl: string;
-    anonymousFallback?: never;
+  credential: BearerCredential;
+  projectId: number;
+  baseUrl: string;
+  anonymousFallback?: never;
 } | {
-    credential?: undefined;
-    projectId?: undefined;
-    baseUrl?: never;
-    anonymousFallback: ReactNode;
+  credential?: undefined;
+  projectId?: undefined;
+  baseUrl?: never;
+  anonymousFallback: ReactNode;
 });
-declare const AuthProvider: ({ session, baseUrl, credential, projectId, onAccessTokenChange, loadingFallback, errorFallback, anonymousFallback, children, }: Props$1) => react_jsx_runtime.JSX.Element;
-
+declare const AuthProvider: ({ session, baseUrl, credential, projectId, onAccessTokenChange, loadingFallback, errorFallback, anonymousFallback, children }: Props$1) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/LegacyAuthProvider.d.ts
 type Props = {
-    session: LegacySession;
-    /** Stack base URL. */
-    baseUrl: string;
-    /** SAPI token — drives the storage build to ready. */
-    storageToken: string;
-    /** Optional manage-api token — unlocks `api.management`. */
-    managementToken?: string;
-    /** Rendered until the storage build reaches ready. */
-    fallback?: ReactNode;
-    /** Rendered when the storage build fails — e.g. the SAPI token is expired or revoked. */
-    errorFallback?: ReactNode;
-    children: ReactNode;
+  session: LegacySession;
+  /** Stack base URL. */
+  baseUrl: string;
+  /** SAPI token — drives the storage build to ready. */
+  storageToken: string;
+  /** Optional manage-api token — unlocks `api.management`. */
+  managementToken?: string;
+  /** Rendered until the storage build reaches ready. */
+  fallback?: ReactNode;
+  /** Rendered when the storage build fails — e.g. the SAPI token is expired or revoked. */
+  errorFallback?: ReactNode;
+  children: ReactNode;
 };
 /**
  * Owns the legacy (SAPI) lifecycle: on mount it configures the stack and drives the session to
@@ -214,6 +214,7 @@ type Props = {
  * known up front, so this drives itself (unlike the interactive bearer `AuthProvider`). Exposes the
  * session via `useLegacyAuth()` and gates `children` behind readiness.
  */
-declare const LegacyAuthProvider: ({ session, baseUrl, storageToken, managementToken, fallback, errorFallback, children, }: Props) => react_jsx_runtime.JSX.Element;
-
+declare const LegacyAuthProvider: ({ session, baseUrl, storageToken, managementToken, fallback, errorFallback, children }: Props) => import("react/jsx-runtime").JSX.Element;
+//#endregion
 export { ApiClientProvider, AuthProvider, LegacyAuthProvider, useApiClient, useAuth, useLegacyAuth, useProject, useStack };
+//# sourceMappingURL=index.d.cts.map