@zilfu/sdk 0.0.1

package/README.md

@@ -0,0 +1,47 @@
+# @zilfu/sdk
+
+Official TypeScript SDK for the [Zilfu](https://zilfu.com) API. Type-safe client generated from the live OpenAPI spec — works in browser, Node 18+, and edge runtimes (Cloudflare Workers, Vercel Edge).
+
+## Install
+
+```bash
+pnpm add @zilfu/sdk
+# or
+npm install @zilfu/sdk
+```
+
+## Usage
+
+Get a personal access token from your Zilfu account settings, then:
+
+```ts
+import { createZilfuClient, getApiSpaces } from '@zilfu/sdk';
+
+createZilfuClient({
+  baseUrl: 'https://zilfu.com',
+  token: process.env.ZILFU_TOKEN!,
+});
+
+const { data, error } = await getApiSpaces();
+if (error) throw error;
+console.log(data);
+```
+
+### Custom fetch (edge runtimes)
+
+```ts
+createZilfuClient({
+  baseUrl: 'https://zilfu.com',
+  token,
+  fetch: globalThis.fetch.bind(globalThis),
+});
+```
+
+## Development
+
+```bash
+pnpm sync       # export openapi.json from the Laravel app
+pnpm generate   # regenerate src/generated/ from openapi.json
+pnpm build      # bundle dist/
+pnpm typecheck
+```