@automate.ax/client 0.7.1 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/client",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Type-safe client for the Automate.ax API.",
   "license": "MIT",
   "repository": {
@@ -20,10 +20,13 @@
     "exports": {
       ".": "./src/index.ts"
     },
-    "cjs": false
+    "cjs": false,
+    "conditions": {
+      "bun": "src"
+    }
   },
   "dependencies": {
-    "@automate.ax/api-contract": "0.7.1",
+    "@automate.ax/api-contract": "0.8.0",
     "@orpc/client": "1.13.14",
     "@orpc/contract": "1.13.14"
   },
@@ -49,6 +52,7 @@
   },
   "files": [
     "dist",
+    "src",
     "README.md",
     "LICENSE"
   ],
@@ -60,6 +64,7 @@
   },
   "exports": {
     ".": {
+      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }

package/src/index.ts

@@ -0,0 +1,45 @@
+import type { publicContract } from "@automate.ax/api-contract"
+import { createORPCClient } from "@orpc/client"
+import { RPCLink } from "@orpc/client/fetch"
+import type { ContractRouterClient } from "@orpc/contract"
+
+const RPC_URL = "https://automate.ax/api/rpc"
+
+// this is an exception to the "no branding in code" rule
+export type AutomateClient = ContractRouterClient<typeof publicContract>
+
+export interface AutomateClientOptions {
+  /** Automate.ax API key sent through the `x-api-key` header. */
+  apiKey:
+    | string
+    | (() => Promise<string | null | undefined> | string | null | undefined)
+}
+
+/**
+ * Creates a type-safe client for the public management API.
+ *
+ * Credential callbacks are evaluated for every request, allowing callers to
+ * rotate API keys without recreating the client.
+ *
+ * @param options - API authentication options.
+ */
+export function createAutomateClient(
+  options: AutomateClientOptions,
+): AutomateClient {
+  return createORPCClient(
+    new RPCLink({
+      url: RPC_URL,
+      headers: async () => {
+        const headers = new Headers()
+        const apiKey =
+          typeof options.apiKey === "function"
+            ? await options.apiKey()
+            : options.apiKey
+
+        if (apiKey) headers.set("x-api-key", apiKey)
+
+        return headers
+      },
+    }),
+  )
+}