@keboola/api-client-react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Keboola s.r.o.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @keboola/api-client-react
+
+React bindings for [@keboola/api-client](https://www.npmjs.com/package/@keboola/api-client) — provider + hooks for accessing the Keboola SDK in a React tree.
+
+[![npm version](https://img.shields.io/npm/v/@keboola/api-client-react.svg)](https://www.npmjs.com/package/@keboola/api-client-react)
+
+## Installation
+
+```bash
+npm install @keboola/api-client @keboola/api-client-react react
+```
+
+Peer dependencies: `react ^18.3.1 || ^19.0.0`, `@keboola/api-client`.
+
+## Quick Start
+
+Wrap your tree with `ApiClientProvider`, then read the client with `useApiClient` anywhere below it. The provider initialises the SDK once on mount and renders `fallback` until init resolves.
+
+```tsx
+import { createApiClient } from '@keboola/api-client';
+import { ApiClientProvider, useApiClient } from '@keboola/api-client-react';
+
+const client = createApiClient();
+
+export const App = () => (
+  <ApiClientProvider
+    client={client}
+    baseUrl="https://connection.keboola.com"
+    token={{ storageApi: 'your-storage-token' }}
+    assetsBaseUrl="https://assets.keboola.com"
+    statusBaseUrl="https://status.keboola.com"
+    metastoreBaseUrl="https://metastore.keboola.com"
+    onError={(error) => console.error('API Error:', error)}
+    fallback={<div>Loading…</div>}
+  >
+    <Tables />
+  </ApiClientProvider>
+);
+
+const Tables = () => {
+  const api = useApiClient();
+  // api.storage.tables.list(), api.queue.searchJobs(), etc.
+  return null;
+};
+```
+
+## Exported hooks
+
+- `useApiClient()` — returns the initialised `ApiClient`.
+- `useProject()` — returns `client.project` (project features + backend availability).
+- `useStack()` — returns `client.stack` (service discovery + feature flags).
+- `useDevApiClient()` — companion hook for `DevApiClientProvider`, used by tooling that needs the dev/raw client.
+
+## Ownership
+
+Owned by the **Keboola UI team**. Source of truth is the [`keboola/ui`](https://github.com/keboola/ui) monorepo.
+
+Versioning follows semver via [Changesets](https://github.com/changesets/changesets); the package is linked to `@keboola/api-client` so a bump on either releases both together.

package/dist/index.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/context.ts
+var MISSING_API_CLIENT_ERROR = "useApiClient must be used within <ApiClientProvider />";
+var MISSING_PROJECT_ERROR = "useProject must be used within <ApiClientProvider />";
+var MISSING_STACK_ERROR = "useStack must be used within <ApiClientProvider />";
+var Context = react.createContext(null);
+var Provider = Context.Provider;
+var useApiClient = () => {
+  const client = react.useContext(Context);
+  if (client === null) throw new Error(MISSING_API_CLIENT_ERROR);
+  return client;
+};
+var useProject = () => {
+  const client = react.useContext(Context);
+  if (client === null) throw new Error(MISSING_PROJECT_ERROR);
+  return client.project;
+};
+var useStack = () => {
+  const client = react.useContext(Context);
+  if (client === null) throw new Error(MISSING_STACK_ERROR);
+  return client.stack;
+};
+var ApiClientProvider = ({
+  client,
+  children,
+  fallback = null,
+  onError,
+  onSuccess,
+  onSettled,
+  ...rest
+}) => {
+  const [isInitializing, setIsInitializing] = react.useState(true);
+  react.useEffect(() => {
+    client.init({
+      ...rest,
+      callbacks: { onSuccess, onError, onSettled }
+    }).finally(() => {
+      setIsInitializing(false);
+    });
+  }, []);
+  return isInitializing ? fallback : /* @__PURE__ */ jsxRuntime.jsx(Provider, { value: client, children });
+};
+var MISSING_DEV_PROVIDER_ERROR = "useDevApiClient must be used within <DevApiClientProvider />";
+var Context2 = react.createContext(null);
+var Provider2 = Context2.Provider;
+var useDevApiClient = () => {
+  const devApiClient = react.useContext(Context2);
+  if (devApiClient === null) throw new Error(MISSING_DEV_PROVIDER_ERROR);
+  return devApiClient;
+};
+var DevApiClientProvider = ({ client, children }) => /* @__PURE__ */ jsxRuntime.jsx(Provider2, { value: client, children });
+
+exports.ApiClientProvider = ApiClientProvider;
+exports.DevApiClientProvider = DevApiClientProvider;
+exports.useApiClient = useApiClient;
+exports.useDevApiClient = useDevApiClient;
+exports.useProject = useProject;
+exports.useStack = useStack;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/ApiClientProvider.tsx","../src/devContext.ts","../src/DevApiClientProvider.tsx"],"names":["createContext","useContext","useState","useEffect","jsx","Context","Provider"],"mappings":";;;;;;AAIA,IAAM,wBAAA,GAA2B,wDAAA;AACjC,IAAM,qBAAA,GAAwB,sDAAA;AAC9B,IAAM,mBAAA,GAAsB,oDAAA;AAE5B,IAAM,OAAA,GAAUA,oBAAgC,IAAI,CAAA;AAE7C,IAAM,WAAW,OAAA,CAAQ,QAAA;AAEzB,IAAM,eAAe,MAAM;AAChC,EAAA,MAAM,MAAA,GAASC,iBAAW,OAAO,CAAA;AACjC,EAAA,IAAI,MAAA,KAAW,IAAA,EAAM,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAC7D,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,aAAa,MAAM;AAC9B,EAAA,MAAM,MAAA,GAASA,iBAAW,OAAO,CAAA;AACjC,EAAA,IAAI,MAAA,KAAW,IAAA,EAAM,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAC1D,EAAA,OAAO,MAAA,CAAO,OAAA;AAChB;AAEO,IAAM,WAAW,MAAM;AAC5B,EAAA,MAAM,MAAA,GAASA,iBAAW,OAAO,CAAA;AACjC,EAAA,IAAI,MAAA,KAAW,IAAA,EAAM,MAAM,IAAI,MAAM,mBAAmB,CAAA;AACxD,EAAA,OAAO,MAAA,CAAO,KAAA;AAChB;ACVO,IAAM,oBAAoB,CAAC;AAAA,EAChC,MAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA,GAAW,IAAA;AAAA,EAEX,OAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,GAAG;AACL,CAAA,KAAa;AACX,EAAA,MAAM,CAAC,cAAA,EAAgB,iBAAiB,CAAA,GAAIC,eAAkB,IAAI,CAAA;AAElE,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,MAAA,CACG,IAAA,CAAK;AAAA,MACJ,GAAG,IAAA;AAAA,MACH,SAAA,EAAW,EAAE,SAAA,EAAW,OAAA,EAAS,SAAA;AAAU,KAC5C,CAAA,CACA,OAAA,CAAQ,MAAM;AACb,MAAA,iBAAA,CAAkB,KAAK,CAAA;AAAA,IACzB,CAAC,CAAA;AAAA,EAGL,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,iBAAiB,QAAA,mBAAWC,cAAA,CAAC,QAAA,EAAA,EAAS,KAAA,EAAO,QAAS,QAAA,EAAS,CAAA;AACxE;ACxCA,IAAM,0BAAA,GAA6B,8DAAA;AAEnC,IAAMC,QAAAA,GAAUL,oBAA4D,IAAI,CAAA;AAEzE,IAAMM,YAAWD,QAAAA,CAAQ,QAAA;AAEzB,IAAM,kBAAkB,MAAM;AACnC,EAAA,MAAM,YAAA,GAAeJ,iBAAWI,QAAO,CAAA;AACvC,EAAA,IAAI,YAAA,KAAiB,IAAA,EAAM,MAAM,IAAI,MAAM,0BAA0B,CAAA;AACrE,EAAA,OAAO,YAAA;AACT;ACDO,IAAM,oBAAA,GAAuB,CAAC,EAAE,MAAA,EAAQ,QAAA,EAAS,qBACtDD,cAAAA,CAACE,SAAAA,EAAA,EAAS,KAAA,EAAO,MAAA,EAAS,QAAA,EAAS","file":"index.cjs","sourcesContent":["import { createContext, useContext } from 'react';\n\nimport type { ApiClient } 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 />';\n\nconst Context = createContext<ApiClient | null>(null);\n\nexport const Provider = Context.Provider;\n\nexport const useApiClient = () => {\n  const client = useContext(Context);\n  if (client === null) throw new Error(MISSING_API_CLIENT_ERROR);\n  return client;\n};\n\nexport const useProject = () => {\n  const client = useContext(Context);\n  if (client === null) throw new Error(MISSING_PROJECT_ERROR);\n  return client.project;\n};\n\nexport const useStack = () => {\n  const client = useContext(Context);\n  if (client === null) throw new Error(MISSING_STACK_ERROR);\n  return client.stack;\n};\n","import { useEffect, useState } from 'react';\nimport type { ReactNode } from 'react';\n\nimport type {\n  ApiClient,\n  ApiClientOptions,\n  CreateCallbackMiddlewareOptions,\n} from '@keboola/api-client';\n\nimport { Provider } from './context';\n\ntype Props = {\n  client: ApiClient;\n  children: ReactNode;\n  fallback?: ReactNode;\n} & Omit<ApiClientOptions, 'callbacks'> &\n  CreateCallbackMiddlewareOptions;\n\nexport const ApiClientProvider = ({\n  client,\n  children,\n  fallback = null,\n\n  onError,\n  onSuccess,\n  onSettled,\n  ...rest\n}: Props) => {\n  const [isInitializing, setIsInitializing] = useState<boolean>(true);\n\n  useEffect(() => {\n    client\n      .init({\n        ...rest,\n        callbacks: { onSuccess, onError, onSettled },\n      })\n      .finally(() => {\n        setIsInitializing(false);\n      });\n    // we want to init only on initial mount\n    // oxlint-disable-next-line react/exhaustive-deps\n  }, []);\n\n  return isInitializing ? fallback : <Provider value={client}>{children}</Provider>;\n};\n","import { createContext, useContext } from 'react';\n\nimport type { createDevApiClient } from '@keboola/api-client';\n\nconst MISSING_DEV_PROVIDER_ERROR = 'useDevApiClient must be used within <DevApiClientProvider />';\n\nconst Context = createContext<ReturnType<typeof createDevApiClient> | null>(null);\n\nexport const Provider = Context.Provider;\n\nexport const useDevApiClient = () => {\n  const devApiClient = useContext(Context);\n  if (devApiClient === null) throw new Error(MISSING_DEV_PROVIDER_ERROR);\n  return devApiClient;\n};\n","import type { ReactNode } from 'react';\n\nimport type { createDevApiClient } from '@keboola/api-client';\n\nimport { Provider } from './devContext';\n\ntype DevClient = ReturnType<typeof createDevApiClient>;\n\ntype Props = {\n  client: DevClient;\n  children: ReactNode;\n};\n\nexport const DevApiClientProvider = ({ client, children }: Props) => (\n  <Provider value={client}>{children}</Provider>\n);\n"]}

package/dist/index.d.cts

@@ -0,0 +1,55 @@
+import * as _keboola_api_client_storage_types from '@keboola/api-client/storage/types';
+import { ApiClient, ApiClientOptions, CreateCallbackMiddlewareOptions, createDevApiClient } from '@keboola/api-client';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import * as _keboola_api_client_verify_types from '@keboola/api-client/verify/types';
+
+declare const useApiClient: () => ApiClient;
+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;
+};
+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;
+};
+
+type Props$1 = {
+    client: ApiClient;
+    children: ReactNode;
+    fallback?: ReactNode;
+} & Omit<ApiClientOptions, 'callbacks'> & CreateCallbackMiddlewareOptions;
+declare const ApiClientProvider: ({ client, children, fallback, onError, onSuccess, onSettled, ...rest }: Props$1) => string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element | null;
+
+type DevClient = ReturnType<typeof createDevApiClient>;
+type Props = {
+    client: DevClient;
+    children: ReactNode;
+};
+declare const DevApiClientProvider: ({ client, children }: Props) => react_jsx_runtime.JSX.Element;
+
+declare const useDevApiClient: () => {
+    verify: {
+        storageApiToken: (host: string, token: string, signal?: AbortSignal) => Promise<_keboola_api_client_storage_types.StorageToken>;
+        managementApiToken: (host: string, token: string, signal?: AbortSignal) => Promise<_keboola_api_client_verify_types.ManagementToken>;
+    };
+};
+
+export { ApiClientProvider, DevApiClientProvider, useApiClient, useDevApiClient, useProject, useStack };

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import * as _keboola_api_client_storage_types from '@keboola/api-client/storage/types';
+import { ApiClient, ApiClientOptions, CreateCallbackMiddlewareOptions, createDevApiClient } from '@keboola/api-client';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import * as _keboola_api_client_verify_types from '@keboola/api-client/verify/types';
+
+declare const useApiClient: () => ApiClient;
+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;
+};
+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;
+};
+
+type Props$1 = {
+    client: ApiClient;
+    children: ReactNode;
+    fallback?: ReactNode;
+} & Omit<ApiClientOptions, 'callbacks'> & CreateCallbackMiddlewareOptions;
+declare const ApiClientProvider: ({ client, children, fallback, onError, onSuccess, onSettled, ...rest }: Props$1) => string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element | null;
+
+type DevClient = ReturnType<typeof createDevApiClient>;
+type Props = {
+    client: DevClient;
+    children: ReactNode;
+};
+declare const DevApiClientProvider: ({ client, children }: Props) => react_jsx_runtime.JSX.Element;
+
+declare const useDevApiClient: () => {
+    verify: {
+        storageApiToken: (host: string, token: string, signal?: AbortSignal) => Promise<_keboola_api_client_storage_types.StorageToken>;
+        managementApiToken: (host: string, token: string, signal?: AbortSignal) => Promise<_keboola_api_client_verify_types.ManagementToken>;
+    };
+};
+
+export { ApiClientProvider, DevApiClientProvider, useApiClient, useDevApiClient, useProject, useStack };

package/dist/index.js

@@ -0,0 +1,57 @@
+import { createContext, useContext, useState, useEffect } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/context.ts
+var MISSING_API_CLIENT_ERROR = "useApiClient must be used within <ApiClientProvider />";
+var MISSING_PROJECT_ERROR = "useProject must be used within <ApiClientProvider />";
+var MISSING_STACK_ERROR = "useStack must be used within <ApiClientProvider />";
+var Context = createContext(null);
+var Provider = Context.Provider;
+var useApiClient = () => {
+  const client = useContext(Context);
+  if (client === null) throw new Error(MISSING_API_CLIENT_ERROR);
+  return client;
+};
+var useProject = () => {
+  const client = useContext(Context);
+  if (client === null) throw new Error(MISSING_PROJECT_ERROR);
+  return client.project;
+};
+var useStack = () => {
+  const client = useContext(Context);
+  if (client === null) throw new Error(MISSING_STACK_ERROR);
+  return client.stack;
+};
+var ApiClientProvider = ({
+  client,
+  children,
+  fallback = null,
+  onError,
+  onSuccess,
+  onSettled,
+  ...rest
+}) => {
+  const [isInitializing, setIsInitializing] = useState(true);
+  useEffect(() => {
+    client.init({
+      ...rest,
+      callbacks: { onSuccess, onError, onSettled }
+    }).finally(() => {
+      setIsInitializing(false);
+    });
+  }, []);
+  return isInitializing ? fallback : /* @__PURE__ */ jsx(Provider, { value: client, children });
+};
+var MISSING_DEV_PROVIDER_ERROR = "useDevApiClient must be used within <DevApiClientProvider />";
+var Context2 = createContext(null);
+var Provider2 = Context2.Provider;
+var useDevApiClient = () => {
+  const devApiClient = useContext(Context2);
+  if (devApiClient === null) throw new Error(MISSING_DEV_PROVIDER_ERROR);
+  return devApiClient;
+};
+var DevApiClientProvider = ({ client, children }) => /* @__PURE__ */ jsx(Provider2, { value: client, children });
+
+export { ApiClientProvider, DevApiClientProvider, useApiClient, useDevApiClient, useProject, useStack };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/ApiClientProvider.tsx","../src/devContext.ts","../src/DevApiClientProvider.tsx"],"names":["Context","createContext","Provider","useContext","jsx"],"mappings":";;;;AAIA,IAAM,wBAAA,GAA2B,wDAAA;AACjC,IAAM,qBAAA,GAAwB,sDAAA;AAC9B,IAAM,mBAAA,GAAsB,oDAAA;AAE5B,IAAM,OAAA,GAAU,cAAgC,IAAI,CAAA;AAE7C,IAAM,WAAW,OAAA,CAAQ,QAAA;AAEzB,IAAM,eAAe,MAAM;AAChC,EAAA,MAAM,MAAA,GAAS,WAAW,OAAO,CAAA;AACjC,EAAA,IAAI,MAAA,KAAW,IAAA,EAAM,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAC7D,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,aAAa,MAAM;AAC9B,EAAA,MAAM,MAAA,GAAS,WAAW,OAAO,CAAA;AACjC,EAAA,IAAI,MAAA,KAAW,IAAA,EAAM,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAC1D,EAAA,OAAO,MAAA,CAAO,OAAA;AAChB;AAEO,IAAM,WAAW,MAAM;AAC5B,EAAA,MAAM,MAAA,GAAS,WAAW,OAAO,CAAA;AACjC,EAAA,IAAI,MAAA,KAAW,IAAA,EAAM,MAAM,IAAI,MAAM,mBAAmB,CAAA;AACxD,EAAA,OAAO,MAAA,CAAO,KAAA;AAChB;ACVO,IAAM,oBAAoB,CAAC;AAAA,EAChC,MAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA,GAAW,IAAA;AAAA,EAEX,OAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,GAAG;AACL,CAAA,KAAa;AACX,EAAA,MAAM,CAAC,cAAA,EAAgB,iBAAiB,CAAA,GAAI,SAAkB,IAAI,CAAA;AAElE,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAA,CACG,IAAA,CAAK;AAAA,MACJ,GAAG,IAAA;AAAA,MACH,SAAA,EAAW,EAAE,SAAA,EAAW,OAAA,EAAS,SAAA;AAAU,KAC5C,CAAA,CACA,OAAA,CAAQ,MAAM;AACb,MAAA,iBAAA,CAAkB,KAAK,CAAA;AAAA,IACzB,CAAC,CAAA;AAAA,EAGL,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,iBAAiB,QAAA,mBAAW,GAAA,CAAC,QAAA,EAAA,EAAS,KAAA,EAAO,QAAS,QAAA,EAAS,CAAA;AACxE;ACxCA,IAAM,0BAAA,GAA6B,8DAAA;AAEnC,IAAMA,QAAAA,GAAUC,cAA4D,IAAI,CAAA;AAEzE,IAAMC,YAAWF,QAAAA,CAAQ,QAAA;AAEzB,IAAM,kBAAkB,MAAM;AACnC,EAAA,MAAM,YAAA,GAAeG,WAAWH,QAAO,CAAA;AACvC,EAAA,IAAI,YAAA,KAAiB,IAAA,EAAM,MAAM,IAAI,MAAM,0BAA0B,CAAA;AACrE,EAAA,OAAO,YAAA;AACT;ACDO,IAAM,oBAAA,GAAuB,CAAC,EAAE,MAAA,EAAQ,QAAA,EAAS,qBACtDI,GAAAA,CAACF,SAAAA,EAAA,EAAS,KAAA,EAAO,MAAA,EAAS,QAAA,EAAS","file":"index.js","sourcesContent":["import { createContext, useContext } from 'react';\n\nimport type { ApiClient } 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 />';\n\nconst Context = createContext<ApiClient | null>(null);\n\nexport const Provider = Context.Provider;\n\nexport const useApiClient = () => {\n  const client = useContext(Context);\n  if (client === null) throw new Error(MISSING_API_CLIENT_ERROR);\n  return client;\n};\n\nexport const useProject = () => {\n  const client = useContext(Context);\n  if (client === null) throw new Error(MISSING_PROJECT_ERROR);\n  return client.project;\n};\n\nexport const useStack = () => {\n  const client = useContext(Context);\n  if (client === null) throw new Error(MISSING_STACK_ERROR);\n  return client.stack;\n};\n","import { useEffect, useState } from 'react';\nimport type { ReactNode } from 'react';\n\nimport type {\n  ApiClient,\n  ApiClientOptions,\n  CreateCallbackMiddlewareOptions,\n} from '@keboola/api-client';\n\nimport { Provider } from './context';\n\ntype Props = {\n  client: ApiClient;\n  children: ReactNode;\n  fallback?: ReactNode;\n} & Omit<ApiClientOptions, 'callbacks'> &\n  CreateCallbackMiddlewareOptions;\n\nexport const ApiClientProvider = ({\n  client,\n  children,\n  fallback = null,\n\n  onError,\n  onSuccess,\n  onSettled,\n  ...rest\n}: Props) => {\n  const [isInitializing, setIsInitializing] = useState<boolean>(true);\n\n  useEffect(() => {\n    client\n      .init({\n        ...rest,\n        callbacks: { onSuccess, onError, onSettled },\n      })\n      .finally(() => {\n        setIsInitializing(false);\n      });\n    // we want to init only on initial mount\n    // oxlint-disable-next-line react/exhaustive-deps\n  }, []);\n\n  return isInitializing ? fallback : <Provider value={client}>{children}</Provider>;\n};\n","import { createContext, useContext } from 'react';\n\nimport type { createDevApiClient } from '@keboola/api-client';\n\nconst MISSING_DEV_PROVIDER_ERROR = 'useDevApiClient must be used within <DevApiClientProvider />';\n\nconst Context = createContext<ReturnType<typeof createDevApiClient> | null>(null);\n\nexport const Provider = Context.Provider;\n\nexport const useDevApiClient = () => {\n  const devApiClient = useContext(Context);\n  if (devApiClient === null) throw new Error(MISSING_DEV_PROVIDER_ERROR);\n  return devApiClient;\n};\n","import type { ReactNode } from 'react';\n\nimport type { createDevApiClient } from '@keboola/api-client';\n\nimport { Provider } from './devContext';\n\ntype DevClient = ReturnType<typeof createDevApiClient>;\n\ntype Props = {\n  client: DevClient;\n  children: ReactNode;\n};\n\nexport const DevApiClientProvider = ({ client, children }: Props) => (\n  <Provider value={client}>{children}</Provider>\n);\n"]}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@keboola/api-client-react",
+  "version": "0.1.0",
+  "description": "React bindings for @keboola/api-client",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "type-check": "tsc",
+    "lint": "yarn lint:format && yarn lint:oxlint",
+    "lint:fix": "oxlint --fix . && oxfmt",
+    "knip:check": "yarn --cwd ../.. exec knip --workspace packages/api-client-react",
+    "knip:fix": "yarn --cwd ../.. exec knip --workspace packages/api-client-react --fix-type types,exports,files",
+    "lint:oxlint": "oxlint . --quiet",
+    "lint:format": "oxfmt --check",
+    "transit": "yarn build",
+    "build": "tsup",
+    "build:check": "attw --pack .",
+    "prepublishOnly": "yarn build && yarn build:check",
+    "test": "vitest run --passWithNoTests --reporter=dot"
+  },
+  "engines": {
+    "node": "24.x"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keboola/ui.git",
+    "directory": "packages/api-client-react"
+  },
+  "homepage": "https://github.com/keboola/ui/tree/main/packages/api-client-react#readme",
+  "bugs": {
+    "url": "https://github.com/keboola/ui/issues"
+  },
+  "keywords": [
+    "keboola",
+    "api",
+    "sdk",
+    "react",
+    "hooks",
+    "data-platform"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "peerDependencies": {
+    "@keboola/api-client": "workspace:^",
+    "react": "^18.3.1 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@keboola/oxlint-config": "workspace:^",
+    "@keboola/tsconfig": "workspace:^",
+    "@types/node": "24.12.0",
+    "@types/react": "^18.3.24",
+    "esbuild": "^0.28.0",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.56.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.8",
+    "vitest": "^4.1.2"
+  }
+}