@automate.ax/client 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zach Sents
+
+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,27 @@
+# `@automate.ax/client`
+
+Type-safe client for the complete Automate.ax API contract.
+
+## Install
+
+```bash
+bun add @automate.ax/client
+```
+
+## API key
+
+```ts
+import { createClient } from "@automate.ax/client"
+
+const client = createClient({
+  apiKey: process.env.AUTOMATE_AX_API_KEY!,
+})
+
+const projects = await client.project.list()
+```
+
+The key is organization-owned and is sent in the `x-api-key` header. It does
+not represent a user session.
+
+The client targets `https://automate.ax/api/rpc` by default. Use `url`, `headers`,
+or `fetch` to customize its transport.

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import type { contract } from "@automate.ax/api-contract";
+import type { ContractRouterClient } from "@orpc/contract";
+export type Client = ContractRouterClient<typeof contract>;
+export type Credential = string | (() => Promise<string | null | undefined> | string | null | undefined);
+export type Fetch = (request: Request, init?: RequestInit) => Promise<Response>;
+type HeadersInit = ConstructorParameters<typeof Headers>[0];
+interface ClientBaseOptions {
+    /** Overrides the default `https://automate.ax/api/rpc` endpoint. */
+    url?: URL | string;
+    /** Adds request headers before the authentication header is applied. */
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    /** Overrides the global Fetch implementation used for requests. */
+    fetch?: Fetch;
+}
+export interface ClientOptions extends ClientBaseOptions {
+    /** Automate.ax API key sent through the `x-api-key` header. */
+    apiKey: Credential;
+}
+/**
+ * Creates a type-safe client for every procedure in the public API contract.
+ *
+ * Credential callbacks are evaluated for every request, allowing callers to
+ * rotate API keys without recreating the client.
+ *
+ * @param options - Authentication and transport configuration.
+ */
+export declare function createClient(options: ClientOptions): Client;
+export {};

package/dist/index.js

@@ -0,0 +1,33 @@
+import { createORPCClient } from "@orpc/client";
+import { RPCLink } from "@orpc/client/fetch";
+const DEFAULT_RPC_URL = "https://automate.ax/api/rpc";
+/**
+ * Creates a type-safe client for every procedure in the public API contract.
+ *
+ * Credential callbacks are evaluated for every request, allowing callers to
+ * rotate API keys without recreating the client.
+ *
+ * @param options - Authentication and transport configuration.
+ */
+export function createClient(options) {
+    const customFetch = options.fetch;
+    return createORPCClient(new RPCLink({
+        url: options.url ?? DEFAULT_RPC_URL,
+        headers: async () => {
+            const headers = new Headers(typeof options.headers === "function"
+                ? await options.headers()
+                : options.headers);
+            const credential = typeof options.apiKey === "function"
+                ? await options.apiKey()
+                : options.apiKey;
+            if (!credential) {
+                throw new Error("API credentials are unavailable.");
+            }
+            headers.set("x-api-key", credential);
+            return headers;
+        },
+        ...(customFetch && {
+            fetch: (request, init) => customFetch(request, init),
+        }),
+    }));
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@automate.ax/client",
+  "version": "0.1.3",
+  "description": "Type-safe client for the Automate.ax API.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zachsents/automate.ax.git",
+    "directory": "packages/client"
+  },
+  "homepage": "https://automate.ax",
+  "bugs": {
+    "url": "https://github.com/zachsents/automate.ax/issues"
+  },
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "zshy": {
+    "exports": {
+      ".": "./src/index.ts"
+    },
+    "cjs": false
+  },
+  "dependencies": {
+    "@automate.ax/api-contract": "0.1.3",
+    "@orpc/client": "1.13.14",
+    "@orpc/contract": "1.13.14"
+  },
+  "devDependencies": {
+    "@internal/config": "0.0.0",
+    "@types/bun": "latest",
+    "zshy": "^0.7.2"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint --type-aware",
+    "lint:fix": "oxlint --type-aware --fix-suggestions",
+    "check": "bun run typecheck && bun run lint",
+    "test": "bun test",
+    "build": "zshy -p tsconfig.build.json",
+    "prepublishOnly": "bun run check && bun run test && bun run build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}