@keboola/api-client-react 47.0.0 → 49.0.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @keboola/api-client-react
 
+## 49.0.0
+
+### Minor Changes
+
+- `useActiveStack(session)` returns the active stack's row as a re-rendering value, the subscribed form of `session.stack.getActive()` (UT-5890)
+
+### Patch Changes
+
+- Updated dependencies:
+  - @keboola/api-client@49.0.0
+
+## 48.0.0
+
+### Patch Changes
+
+- Updated dependencies:
+  - @keboola/api-client@48.0.0
+
 ## 47.0.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -43,6 +43,10 @@ const ApiClientProvider = ({ api, children }) => /* @__PURE__ */ (0, react_jsx_r
 	children
 });
 //#endregion
+//#region src/useActiveStack.ts
+/** The active stack's row as a re-rendering value; the default stack until something selects another. */
+const useActiveStack = (session) => (0, react.useSyncExternalStore)(session.subscribe, session.stack.getActive);
+//#endregion
 //#region src/useSessionState.ts
 /** The session table as a re-rendering value — the binding every gate and panel reads it through. */
 const useSessionState = (session) => (0, react.useSyncExternalStore)(session.subscribe, session.getState);
@@ -82,6 +86,7 @@ const LegacyAuthProvider = ({ session, baseUrl, storageToken, managementToken, f
 //#endregion
 exports.ApiClientProvider = ApiClientProvider;
 exports.LegacyAuthProvider = LegacyAuthProvider;
+exports.useActiveStack = useActiveStack;
 exports.useApiClient = useApiClient;
 exports.useLegacyAuth = useLegacyAuth;
 exports.useProject = useProject;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["createContext","use","useSyncExternalStore","useState","useRef"],"sources":["../src/context.ts","../src/ApiClientProvider.tsx","../src/useSessionState.ts","../src/LegacyAuthProvider.tsx"],"sourcesContent":["import { createContext, use } from 'react';\n\nimport type { 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_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 legacy lifecycle session lives in its own context; the bearer flows read their table through\n// `useSessionState` instead.\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 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 { useSyncExternalStore } from 'react';\n\nimport type { BearerSession } from '@keboola/api-client';\n\n/** The session table as a re-rendering value — the binding every gate and panel reads it through. */\nexport const useSessionState = (session: BearerSession) =>\n  useSyncExternalStore(session.subscribe, session.getState);\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":";;;;AAIA,MAAM,2BAA2B;AACjC,MAAM,wBAAwB;AAC9B,MAAM,sBAAsB;AAC5B,MAAM,4BAA4B;AAIlC,MAAM,cAAA,GAAaA,MAAAA,cAAAA,CAAiC,IAAI;AACxD,MAAa,cAAc;AAI3B,MAAM,qBAAA,GAAoBA,MAAAA,cAAAA,CAAoC,IAAI;AAClE,MAAa,4BAA4B;AAEzC,MAAa,qBAAqB;CAChC,MAAM,OAAA,GAAMC,MAAAA,IAAAA,CAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,wBAAwB;CAC1D,OAAO;AACT;AAEA,MAAa,mBAAmB;CAC9B,MAAM,OAAA,GAAMA,MAAAA,IAAAA,CAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,qBAAqB;CACvD,OAAO,IAAI,QAAQ;AACrB;AAEA,MAAa,iBAAiB;CAC5B,MAAM,OAAA,GAAMA,MAAAA,IAAAA,CAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,mBAAmB;CACrD,OAAO,IAAI,QAAQ;AACrB;;AAGA,MAAa,sBAAsB;CACjC,MAAM,WAAA,GAAUA,MAAAA,IAAAA,CAAI,iBAAiB;CACrC,IAAI,YAAY,MAAM,MAAM,IAAI,MAAM,yBAAyB;CAC/D,OAAO;AACT;;;;;;;;ACzBA,MAAa,qBAAqB,EAAE,KAAK,eACvC,iBAAA,GAAA,kBAAA,IAAA,CAAC,aAAD;CAAa,OAAO;CAAM;AAAsB,CAAA;;;;ACblD,MAAa,mBAAmB,aAAA,GAC9BC,MAAAA,qBAAAA,CAAqB,QAAQ,WAAW,QAAQ,QAAQ;;;;;;;;;ACsB1D,MAAa,sBAAsB,EACjC,SACA,SACA,cACA,iBACA,WAAW,MACX,gBAAgB,UAChB,eACW;CAEX,MAAM,CAAC,cAAc,oBAAA,GAAmBC,MAAAA,SAAAA,OAAe,QAAQ,MAAM,CAAC,CAAC,OAAO;CAE9E,MAAM,cAAA,GAAaC,MAAAA,OAAAA,CAAgB,KAAK;CAExC,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,MAAM,cAAc,QAAQ,WAAW,aAAa,gBAAgB,SAAS,OAAO,CAAC;EAErF,IAAI,CAAC,WAAW,SAAS;GACvB,WAAW,UAAU;GACrB,QAAQ,WAAW,OAAO;GAC1B,IAAI,iBAAiB,QAAQ,uBAAuB,eAAe;GAGnE,QACG,yBAAyB,YAAY,CAAC,CACtC,OAAO,UAAU,QAAQ,MAAM,oCAAoC,KAAK,CAAC;EAC9E;EAEA,OAAO;CAGT,GAAG,CAAC,CAAC;CAGL,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,IAAI,iBAAiB,WACnB,QAAQ,MAAM,8DAA8D;CAEhF,GAAG,CAAC,YAAY,CAAC;CAQjB,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAAC,2BAAD;EAA2B,OAAO;EANlB,iBAAA;GACrB,IAAI,iBAAiB,SAAS,OAAO;GACrC,IAAI,iBAAiB,WAAW,OAAO;GACvC,OAAO;EACT,EAAA,CAEyD;CAA6B,CAAA;AACxF"}
+{"version":3,"file":"index.cjs","names":["createContext","use","useSyncExternalStore","useSyncExternalStore","useState","useRef"],"sources":["../src/context.ts","../src/ApiClientProvider.tsx","../src/useActiveStack.ts","../src/useSessionState.ts","../src/LegacyAuthProvider.tsx"],"sourcesContent":["import { createContext, use } from 'react';\n\nimport type { 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_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 legacy lifecycle session lives in its own context; the bearer flows read their table through\n// `useSessionState` instead.\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 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 { useSyncExternalStore } from 'react';\n\nimport type { BearerSession } from '@keboola/api-client';\n\n/** The active stack's row as a re-rendering value; the default stack until something selects another. */\nexport const useActiveStack = (session: BearerSession) =>\n  useSyncExternalStore(session.subscribe, session.stack.getActive);\n","import { useSyncExternalStore } from 'react';\n\nimport type { BearerSession } from '@keboola/api-client';\n\n/** The session table as a re-rendering value — the binding every gate and panel reads it through. */\nexport const useSessionState = (session: BearerSession) =>\n  useSyncExternalStore(session.subscribe, session.getState);\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":";;;;AAIA,MAAM,2BAA2B;AACjC,MAAM,wBAAwB;AAC9B,MAAM,sBAAsB;AAC5B,MAAM,4BAA4B;AAIlC,MAAM,cAAA,GAAaA,MAAAA,cAAAA,CAAiC,IAAI;AACxD,MAAa,cAAc;AAI3B,MAAM,qBAAA,GAAoBA,MAAAA,cAAAA,CAAoC,IAAI;AAClE,MAAa,4BAA4B;AAEzC,MAAa,qBAAqB;CAChC,MAAM,OAAA,GAAMC,MAAAA,IAAAA,CAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,wBAAwB;CAC1D,OAAO;AACT;AAEA,MAAa,mBAAmB;CAC9B,MAAM,OAAA,GAAMA,MAAAA,IAAAA,CAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,qBAAqB;CACvD,OAAO,IAAI,QAAQ;AACrB;AAEA,MAAa,iBAAiB;CAC5B,MAAM,OAAA,GAAMA,MAAAA,IAAAA,CAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,mBAAmB;CACrD,OAAO,IAAI,QAAQ;AACrB;;AAGA,MAAa,sBAAsB;CACjC,MAAM,WAAA,GAAUA,MAAAA,IAAAA,CAAI,iBAAiB;CACrC,IAAI,YAAY,MAAM,MAAM,IAAI,MAAM,yBAAyB;CAC/D,OAAO;AACT;;;;;;;;ACzBA,MAAa,qBAAqB,EAAE,KAAK,eACvC,iBAAA,GAAA,kBAAA,IAAA,CAAC,aAAD;CAAa,OAAO;CAAM;AAAsB,CAAA;;;;ACblD,MAAa,kBAAkB,aAAA,GAC7BC,MAAAA,qBAAAA,CAAqB,QAAQ,WAAW,QAAQ,MAAM,SAAS;;;;ACDjE,MAAa,mBAAmB,aAAA,GAC9BC,MAAAA,qBAAAA,CAAqB,QAAQ,WAAW,QAAQ,QAAQ;;;;;;;;;ACsB1D,MAAa,sBAAsB,EACjC,SACA,SACA,cACA,iBACA,WAAW,MACX,gBAAgB,UAChB,eACW;CAEX,MAAM,CAAC,cAAc,oBAAA,GAAmBC,MAAAA,SAAAA,OAAe,QAAQ,MAAM,CAAC,CAAC,OAAO;CAE9E,MAAM,cAAA,GAAaC,MAAAA,OAAAA,CAAgB,KAAK;CAExC,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,MAAM,cAAc,QAAQ,WAAW,aAAa,gBAAgB,SAAS,OAAO,CAAC;EAErF,IAAI,CAAC,WAAW,SAAS;GACvB,WAAW,UAAU;GACrB,QAAQ,WAAW,OAAO;GAC1B,IAAI,iBAAiB,QAAQ,uBAAuB,eAAe;GAGnE,QACG,yBAAyB,YAAY,CAAC,CACtC,OAAO,UAAU,QAAQ,MAAM,oCAAoC,KAAK,CAAC;EAC9E;EAEA,OAAO;CAGT,GAAG,CAAC,CAAC;CAGL,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,IAAI,iBAAiB,WACnB,QAAQ,MAAM,8DAA8D;CAEhF,GAAG,CAAC,YAAY,CAAC;CAQjB,OAAO,iBAAA,GAAA,kBAAA,IAAA,CAAC,2BAAD;EAA2B,OAAO;EANlB,iBAAA;GACrB,IAAI,iBAAiB,SAAS,OAAO;GACrC,IAAI,iBAAiB,WAAW,OAAO;GACvC,OAAO;EACT,EAAA,CAEyD;CAA6B,CAAA;AACxF"}

package/dist/index.d.cts

@@ -6,6 +6,7 @@ declare const useProject: () => {
   hasFeature: (...feature: string[]) => boolean;
   hasAdminFeature: (...feature: string[]) => boolean;
   hasBackend: (backend: import("@keboola/api-client/constants").Backend) => boolean;
+  canListSharingTargets: boolean;
   sapiToken: import("@keboola/api-client/storage/types").StorageToken;
 };
 declare const useStack: () => {
@@ -74,6 +75,10 @@ type Props$1 = {
  */
 declare const ApiClientProvider: ({ api, children }: Props$1) => import("react").JSX.Element;
 //#endregion
+//#region src/useActiveStack.d.ts
+/** The active stack's row as a re-rendering value; the default stack until something selects another. */
+declare const useActiveStack: (session: BearerSession) => import("@keboola/api-client").StackEntry;
+//#endregion
 //#region src/useSessionState.d.ts
 /** The session table as a re-rendering value — the binding every gate and panel reads it through. */
 declare const useSessionState: (session: BearerSession) => import("@keboola/api-client").SessionState;
@@ -101,5 +106,5 @@ type Props = {
  */
 declare const LegacyAuthProvider: ({ session, baseUrl, storageToken, managementToken, fallback, errorFallback, children }: Props) => import("react").JSX.Element;
 //#endregion
-export { ApiClientProvider, LegacyAuthProvider, useApiClient, useLegacyAuth, useProject, useSessionState, useStack };
+export { ApiClientProvider, LegacyAuthProvider, useActiveStack, useApiClient, useLegacyAuth, useProject, useSessionState, useStack };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -6,6 +6,7 @@ declare const useProject: () => {
   hasFeature: (...feature: string[]) => boolean;
   hasAdminFeature: (...feature: string[]) => boolean;
   hasBackend: (backend: import("@keboola/api-client/constants").Backend) => boolean;
+  canListSharingTargets: boolean;
   sapiToken: import("@keboola/api-client/storage/types").StorageToken;
 };
 declare const useStack: () => {
@@ -74,6 +75,10 @@ type Props$1 = {
  */
 declare const ApiClientProvider: ({ api, children }: Props$1) => import("react").JSX.Element;
 //#endregion
+//#region src/useActiveStack.d.ts
+/** The active stack's row as a re-rendering value; the default stack until something selects another. */
+declare const useActiveStack: (session: BearerSession) => import("@keboola/api-client").StackEntry;
+//#endregion
 //#region src/useSessionState.d.ts
 /** The session table as a re-rendering value — the binding every gate and panel reads it through. */
 declare const useSessionState: (session: BearerSession) => import("@keboola/api-client").SessionState;
@@ -101,5 +106,5 @@ type Props = {
  */
 declare const LegacyAuthProvider: ({ session, baseUrl, storageToken, managementToken, fallback, errorFallback, children }: Props) => import("react").JSX.Element;
 //#endregion
-export { ApiClientProvider, LegacyAuthProvider, useApiClient, useLegacyAuth, useProject, useSessionState, useStack };
+export { ApiClientProvider, LegacyAuthProvider, useActiveStack, useApiClient, useLegacyAuth, useProject, useSessionState, useStack };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -42,6 +42,10 @@ const ApiClientProvider = ({ api, children }) => /* @__PURE__ */ jsx(ApiProvider
 	children
 });
 //#endregion
+//#region src/useActiveStack.ts
+/** The active stack's row as a re-rendering value; the default stack until something selects another. */
+const useActiveStack = (session) => useSyncExternalStore(session.subscribe, session.stack.getActive);
+//#endregion
 //#region src/useSessionState.ts
 /** The session table as a re-rendering value — the binding every gate and panel reads it through. */
 const useSessionState = (session) => useSyncExternalStore(session.subscribe, session.getState);
@@ -79,6 +83,6 @@ const LegacyAuthProvider = ({ session, baseUrl, storageToken, managementToken, f
 	});
 };
 //#endregion
-export { ApiClientProvider, LegacyAuthProvider, useApiClient, useLegacyAuth, useProject, useSessionState, useStack };
+export { ApiClientProvider, LegacyAuthProvider, useActiveStack, useApiClient, useLegacyAuth, useProject, useSessionState, useStack };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/context.ts","../src/ApiClientProvider.tsx","../src/useSessionState.ts","../src/LegacyAuthProvider.tsx"],"sourcesContent":["import { createContext, use } from 'react';\n\nimport type { 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_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 legacy lifecycle session lives in its own context; the bearer flows read their table through\n// `useSessionState` instead.\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 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 { useSyncExternalStore } from 'react';\n\nimport type { BearerSession } from '@keboola/api-client';\n\n/** The session table as a re-rendering value — the binding every gate and panel reads it through. */\nexport const useSessionState = (session: BearerSession) =>\n  useSyncExternalStore(session.subscribe, session.getState);\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":";;;AAIA,MAAM,2BAA2B;AACjC,MAAM,wBAAwB;AAC9B,MAAM,sBAAsB;AAC5B,MAAM,4BAA4B;AAIlC,MAAM,aAAa,cAAiC,IAAI;AACxD,MAAa,cAAc;AAI3B,MAAM,oBAAoB,cAAoC,IAAI;AAClE,MAAa,4BAA4B;AAEzC,MAAa,qBAAqB;CAChC,MAAM,MAAM,IAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,wBAAwB;CAC1D,OAAO;AACT;AAEA,MAAa,mBAAmB;CAC9B,MAAM,MAAM,IAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,qBAAqB;CACvD,OAAO,IAAI,QAAQ;AACrB;AAEA,MAAa,iBAAiB;CAC5B,MAAM,MAAM,IAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,mBAAmB;CACrD,OAAO,IAAI,QAAQ;AACrB;;AAGA,MAAa,sBAAsB;CACjC,MAAM,UAAU,IAAI,iBAAiB;CACrC,IAAI,YAAY,MAAM,MAAM,IAAI,MAAM,yBAAyB;CAC/D,OAAO;AACT;;;;;;;;ACzBA,MAAa,qBAAqB,EAAE,KAAK,eACvC,oBAAC,aAAD;CAAa,OAAO;CAAM;AAAsB,CAAA;;;;ACblD,MAAa,mBAAmB,YAC9B,qBAAqB,QAAQ,WAAW,QAAQ,QAAQ;;;;;;;;;ACsB1D,MAAa,sBAAsB,EACjC,SACA,SACA,cACA,iBACA,WAAW,MACX,gBAAgB,UAChB,eACW;CAEX,MAAM,CAAC,cAAc,mBAAmB,eAAe,QAAQ,MAAM,CAAC,CAAC,OAAO;CAE9E,MAAM,aAAa,OAAgB,KAAK;CAExC,gBAAgB;EACd,MAAM,cAAc,QAAQ,WAAW,aAAa,gBAAgB,SAAS,OAAO,CAAC;EAErF,IAAI,CAAC,WAAW,SAAS;GACvB,WAAW,UAAU;GACrB,QAAQ,WAAW,OAAO;GAC1B,IAAI,iBAAiB,QAAQ,uBAAuB,eAAe;GAGnE,QACG,yBAAyB,YAAY,CAAC,CACtC,OAAO,UAAU,QAAQ,MAAM,oCAAoC,KAAK,CAAC;EAC9E;EAEA,OAAO;CAGT,GAAG,CAAC,CAAC;CAGL,gBAAgB;EACd,IAAI,iBAAiB,WACnB,QAAQ,MAAM,8DAA8D;CAEhF,GAAG,CAAC,YAAY,CAAC;CAQjB,OAAO,oBAAC,2BAAD;EAA2B,OAAO;EANlB,iBAAA;GACrB,IAAI,iBAAiB,SAAS,OAAO;GACrC,IAAI,iBAAiB,WAAW,OAAO;GACvC,OAAO;EACT,EAAA,CAEyD;CAA6B,CAAA;AACxF"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/context.ts","../src/ApiClientProvider.tsx","../src/useActiveStack.ts","../src/useSessionState.ts","../src/LegacyAuthProvider.tsx"],"sourcesContent":["import { createContext, use } from 'react';\n\nimport type { 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_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 legacy lifecycle session lives in its own context; the bearer flows read their table through\n// `useSessionState` instead.\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 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 { useSyncExternalStore } from 'react';\n\nimport type { BearerSession } from '@keboola/api-client';\n\n/** The active stack's row as a re-rendering value; the default stack until something selects another. */\nexport const useActiveStack = (session: BearerSession) =>\n  useSyncExternalStore(session.subscribe, session.stack.getActive);\n","import { useSyncExternalStore } from 'react';\n\nimport type { BearerSession } from '@keboola/api-client';\n\n/** The session table as a re-rendering value — the binding every gate and panel reads it through. */\nexport const useSessionState = (session: BearerSession) =>\n  useSyncExternalStore(session.subscribe, session.getState);\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":";;;AAIA,MAAM,2BAA2B;AACjC,MAAM,wBAAwB;AAC9B,MAAM,sBAAsB;AAC5B,MAAM,4BAA4B;AAIlC,MAAM,aAAa,cAAiC,IAAI;AACxD,MAAa,cAAc;AAI3B,MAAM,oBAAoB,cAAoC,IAAI;AAClE,MAAa,4BAA4B;AAEzC,MAAa,qBAAqB;CAChC,MAAM,MAAM,IAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,wBAAwB;CAC1D,OAAO;AACT;AAEA,MAAa,mBAAmB;CAC9B,MAAM,MAAM,IAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,qBAAqB;CACvD,OAAO,IAAI,QAAQ;AACrB;AAEA,MAAa,iBAAiB;CAC5B,MAAM,MAAM,IAAI,UAAU;CAC1B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,mBAAmB;CACrD,OAAO,IAAI,QAAQ;AACrB;;AAGA,MAAa,sBAAsB;CACjC,MAAM,UAAU,IAAI,iBAAiB;CACrC,IAAI,YAAY,MAAM,MAAM,IAAI,MAAM,yBAAyB;CAC/D,OAAO;AACT;;;;;;;;ACzBA,MAAa,qBAAqB,EAAE,KAAK,eACvC,oBAAC,aAAD;CAAa,OAAO;CAAM;AAAsB,CAAA;;;;ACblD,MAAa,kBAAkB,YAC7B,qBAAqB,QAAQ,WAAW,QAAQ,MAAM,SAAS;;;;ACDjE,MAAa,mBAAmB,YAC9B,qBAAqB,QAAQ,WAAW,QAAQ,QAAQ;;;;;;;;;ACsB1D,MAAa,sBAAsB,EACjC,SACA,SACA,cACA,iBACA,WAAW,MACX,gBAAgB,UAChB,eACW;CAEX,MAAM,CAAC,cAAc,mBAAmB,eAAe,QAAQ,MAAM,CAAC,CAAC,OAAO;CAE9E,MAAM,aAAa,OAAgB,KAAK;CAExC,gBAAgB;EACd,MAAM,cAAc,QAAQ,WAAW,aAAa,gBAAgB,SAAS,OAAO,CAAC;EAErF,IAAI,CAAC,WAAW,SAAS;GACvB,WAAW,UAAU;GACrB,QAAQ,WAAW,OAAO;GAC1B,IAAI,iBAAiB,QAAQ,uBAAuB,eAAe;GAGnE,QACG,yBAAyB,YAAY,CAAC,CACtC,OAAO,UAAU,QAAQ,MAAM,oCAAoC,KAAK,CAAC;EAC9E;EAEA,OAAO;CAGT,GAAG,CAAC,CAAC;CAGL,gBAAgB;EACd,IAAI,iBAAiB,WACnB,QAAQ,MAAM,8DAA8D;CAEhF,GAAG,CAAC,YAAY,CAAC;CAQjB,OAAO,oBAAC,2BAAD;EAA2B,OAAO;EANlB,iBAAA;GACrB,IAAI,iBAAiB,SAAS,OAAO;GACrC,IAAI,iBAAiB,WAAW,OAAO;GACvC,OAAO;EACT,EAAA,CAEyD;CAA6B,CAAA;AACxF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keboola/api-client-react",
-  "version": "47.0.0",
+  "version": "49.0.0",
   "description": "React bindings for @keboola/api-client",
   "license": "MIT",
   "type": "module",
@@ -50,13 +50,13 @@
     }
   },
   "peerDependencies": {
-    "@keboola/api-client": "^47.0.0",
+    "@keboola/api-client": "^49.0.0",
     "react": "^19.0.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
-    "@keboola/api-client": "^47.0.0",
-    "@keboola/api-fixtures": "^42.0.0",
+    "@keboola/api-client": "^49.0.0",
+    "@keboola/api-fixtures": "^44.0.0",
     "@keboola/eslint-plugin-design": "^0.5.0",
     "@keboola/oxlint-config": "^10.2.0",
     "@keboola/tsconfig": "^0.2.1",