[OPIK-558] Typescript SDK - basic client

apps/opik-frontend/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "opik",
+  "name": "opik-frontend",
   "description": "This is Front End part of Comet Opik",
   "version": "0.0.1",
   "private": true,

sdks/code_generation/fern/fern.config.json

@@ -1,4 +1,4 @@
 {
-    "organization": "Opik",
-    "version": "0.45.0"
-}
+  "organization": "Opik",
+  "version": "0.45.3"
+}

sdks/code_generation/fern/generators.yml

@@ -1,5 +1,6 @@
 api:
   path: openapi/openapi.yaml
+  overrides: openapi/overrides-global-headers.yaml
 default-group: local
 groups:
   local:
@@ -14,3 +15,6 @@ groups:
         output:
           location: local-file-system
           path: ../../typescript/src/opik/rest_api
+        config:
+          outputSourceFiles: true
+          includeCredentialsOnCrossOriginRequests: true

sdks/code_generation/fern/openapi/overrides-global-headers.yaml

@@ -0,0 +1,7 @@
+x-fern-global-headers:
+  - header: Authorization
+    name: apiKey
+    optional: true
+  - header: Comet-Workspace
+    name: workspaceName
+    optional: true

sdks/python/src/opik/rest_api/chat_completions/client.py

@@ -111,7 +111,10 @@ def create_chat_completions(
         --------
         from Opik import OpikApi
 
-        client = OpikApi()
+        client = OpikApi(
+            api_key="YOUR_API_KEY",
+            workspace_name="YOUR_WORKSPACE_NAME",
+        )
         client.chat_completions.create_chat_completions()
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -268,7 +271,10 @@ async def create_chat_completions(
 
         from Opik import AsyncOpikApi
 
-        client = AsyncOpikApi()
+        client = AsyncOpikApi(
+            api_key="YOUR_API_KEY",
+            workspace_name="YOUR_WORKSPACE_NAME",
+        )
 
 
         async def main() -> None:

sdks/python/src/opik/rest_api/check/client.py

@@ -44,7 +44,10 @@ def access(
         --------
         from Opik import OpikApi
 
-        client = OpikApi()
+        client = OpikApi(
+            api_key="YOUR_API_KEY",
+            workspace_name="YOUR_WORKSPACE_NAME",
+        )
         client.check.access(
             request={"key": "value"},
         )
@@ -115,7 +118,10 @@ async def access(
 
         from Opik import AsyncOpikApi
 
-        client = AsyncOpikApi()
+        client = AsyncOpikApi(
+            api_key="YOUR_API_KEY",
+            workspace_name="YOUR_WORKSPACE_NAME",
+        )
 
 
         async def main() -> None:

sdks/python/src/opik/rest_api/client.py

@@ -51,6 +51,8 @@ class OpikApi:
 
 
 
+    api_key : typing.Optional[str]
+    workspace_name : typing.Optional[str]
     timeout : typing.Optional[float]
         The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
 
@@ -64,14 +66,19 @@ class OpikApi:
     --------
     from Opik import OpikApi
 
-    client = OpikApi()
+    client = OpikApi(
+        api_key="YOUR_API_KEY",
+        workspace_name="YOUR_WORKSPACE_NAME",
+    )
     """
 
     def __init__(
         self,
         *,
         base_url: typing.Optional[str] = None,
         environment: OpikApiEnvironment = OpikApiEnvironment.DEFAULT,
+        api_key: typing.Optional[str] = None,
+        workspace_name: typing.Optional[str] = None,
         timeout: typing.Optional[float] = None,
         follow_redirects: typing.Optional[bool] = True,
         httpx_client: typing.Optional[httpx.Client] = None,
@@ -81,6 +88,8 @@ def __init__(
         )
         self._client_wrapper = SyncClientWrapper(
             base_url=_get_base_url(base_url=base_url, environment=environment),
+            api_key=api_key,
+            workspace_name=workspace_name,
             httpx_client=httpx_client
             if httpx_client is not None
             else httpx.Client(
@@ -126,7 +135,10 @@ def is_alive(
         --------
         from Opik import OpikApi
 
-        client = OpikApi()
+        client = OpikApi(
+            api_key="YOUR_API_KEY",
+            workspace_name="YOUR_WORKSPACE_NAME",
+        )
         client.is_alive()
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -166,7 +178,10 @@ def version(
         --------
         from Opik import OpikApi
 
-        client = OpikApi()
+        client = OpikApi(
+            api_key="YOUR_API_KEY",
+            workspace_name="YOUR_WORKSPACE_NAME",
+        )
         client.version()
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -207,6 +222,8 @@ class AsyncOpikApi:
 
 
 
+    api_key : typing.Optional[str]
+    workspace_name : typing.Optional[str]
     timeout : typing.Optional[float]
         The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
 
@@ -220,14 +237,19 @@ class AsyncOpikApi:
     --------
     from Opik import AsyncOpikApi
 
-    client = AsyncOpikApi()
+    client = AsyncOpikApi(
+        api_key="YOUR_API_KEY",
+        workspace_name="YOUR_WORKSPACE_NAME",
+    )
     """
 
     def __init__(
         self,
         *,
         base_url: typing.Optional[str] = None,
         environment: OpikApiEnvironment = OpikApiEnvironment.DEFAULT,
+        api_key: typing.Optional[str] = None,
+        workspace_name: typing.Optional[str] = None,
         timeout: typing.Optional[float] = None,
         follow_redirects: typing.Optional[bool] = True,
         httpx_client: typing.Optional[httpx.AsyncClient] = None,
@@ -237,6 +259,8 @@ def __init__(
         )
         self._client_wrapper = AsyncClientWrapper(
             base_url=_get_base_url(base_url=base_url, environment=environment),
+            api_key=api_key,
+            workspace_name=workspace_name,
             httpx_client=httpx_client
             if httpx_client is not None
             else httpx.AsyncClient(
@@ -284,7 +308,10 @@ async def is_alive(
 
         from Opik import AsyncOpikApi
 
-        client = AsyncOpikApi()
+        client = AsyncOpikApi(
+            api_key="YOUR_API_KEY",
+            workspace_name="YOUR_WORKSPACE_NAME",
+        )
 
 
         async def main() -> None:
@@ -332,7 +359,10 @@ async def version(
 
         from Opik import AsyncOpikApi
 
-        client = AsyncOpikApi()
+        client = AsyncOpikApi(
+            api_key="YOUR_API_KEY",
+            workspace_name="YOUR_WORKSPACE_NAME",
+        )
 
 
         async def main() -> None:

sdks/python/src/opik/rest_api/core/client_wrapper.py

@@ -7,14 +7,27 @@
 
 
 class BaseClientWrapper:
-    def __init__(self, *, base_url: str, timeout: typing.Optional[float] = None):
+    def __init__(
+        self,
+        *,
+        api_key: typing.Optional[str] = None,
+        workspace_name: typing.Optional[str] = None,
+        base_url: str,
+        timeout: typing.Optional[float] = None,
+    ):
+        self._api_key = api_key
+        self._workspace_name = workspace_name
         self._base_url = base_url
         self._timeout = timeout
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
         }
+        if self._api_key is not None:
+            headers["Authorization"] = self._api_key
+        if self._workspace_name is not None:
+            headers["Comet-Workspace"] = self._workspace_name
         return headers
 
     def get_base_url(self) -> str:
@@ -28,11 +41,18 @@ class SyncClientWrapper(BaseClientWrapper):
     def __init__(
         self,
         *,
+        api_key: typing.Optional[str] = None,
+        workspace_name: typing.Optional[str] = None,
         base_url: str,
         timeout: typing.Optional[float] = None,
         httpx_client: httpx.Client,
     ):
-        super().__init__(base_url=base_url, timeout=timeout)
+        super().__init__(
+            api_key=api_key,
+            workspace_name=workspace_name,
+            base_url=base_url,
+            timeout=timeout,
+        )
         self.httpx_client = HttpClient(
             httpx_client=httpx_client,
             base_headers=self.get_headers,
@@ -45,11 +65,18 @@ class AsyncClientWrapper(BaseClientWrapper):
     def __init__(
         self,
         *,
+        api_key: typing.Optional[str] = None,
+        workspace_name: typing.Optional[str] = None,
         base_url: str,
         timeout: typing.Optional[float] = None,
         httpx_client: httpx.AsyncClient,
     ):
-        super().__init__(base_url=base_url, timeout=timeout)
+        super().__init__(
+            api_key=api_key,
+            workspace_name=workspace_name,
+            base_url=base_url,
+            timeout=timeout,
+        )
         self.httpx_client = AsyncHttpClient(
             httpx_client=httpx_client,
             base_headers=self.get_headers,