proseva-sdk 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# ProSeVA SDK
+
+Type-safe TypeScript client generated from `server/openapi.json` for interacting with the ProSeVA API.
+
+## Install
+
+```bash
+# From repository root after building
+bun install             # ensure workspace deps
+cd proseva-sdk
+bun install             # installs sdk-specific dev deps
+bun pack                # optional: create tarball for local install
+```
+
+To consume locally without publishing:
+
+```bash
+# from another project
+npm install /path/to/pro-se-va-copy/proseva-sdk
+```
+
+## Usage
+
+```ts
+import { createProsevaClientWithToken } from "proseva-sdk";
+
+const api = createProsevaClientWithToken("<jwt>", {
+  baseUrl: "https://proseva.example.com/api",
+});
+
+const { data } = await api.GET("/cases");
+```
+
+### Auth tokens
+Pass `getAuthToken` (sync or async) to attach `Authorization: Bearer <token>` automatically:
+
+```ts
+import { createProsevaClient } from "proseva-sdk";
+
+const api = createProsevaClient({
+  getAuthToken: async () => process.env.PROSEVA_TOKEN ?? null,
+});
+```
+
+## Regenerate types
+
+```bash
+cd proseva-sdk
+bun x openapi-typescript ../server/openapi.json --output src/types.ts
+bun x tsc -p tsconfig.json
+```
+
+## Exports
+
+- `createProsevaClient`
+- `createProsevaClientWithToken`
+- OpenAPI types: `paths`, `components`, `operations`

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import type { Client } from "openapi-fetch";
+import type { paths } from "./types.js";
+export type { paths, components, operations } from "./types.js";
+/**
+ * Configuration for the generated ProSeVA API client.
+ */
+export interface ProsevaClientOptions {
+    /**
+     * Base URL used for all requests. Defaults to `"/api"` which matches the app server.
+     * Provide an absolute URL when consuming the SDK from another host.
+     */
+    baseUrl?: string;
+    /**
+     * Token (string), sync function, or async function that returns a bearer token.
+     * If provided, the client injects it into the `Authorization` header on every request.
+     */
+    getAuthToken?: (() => Promise<string | null>) | (() => string | null) | string | null;
+    /**
+     * Optional custom fetch implementation (e.g. `undici` or `node-fetch`) for non-browser environments.
+     * Defaults to `globalThis.fetch`.
+     */
+    fetch?: typeof fetch;
+}
+/** Typed OpenAPI client instance for the ProSeVA API. */
+export type ProsevaClient = Client<paths>;
+/**
+ * Create a typed ProSeVA API client. Pass `getAuthToken` to auto-attach a bearer token.
+ */
+export declare function createProsevaClient(options?: ProsevaClientOptions): ProsevaClient;
+/**
+ * Convenience wrapper that builds a client with a fixed bearer token.
+ */
+export declare function createProsevaClientWithToken(token: string, options?: Omit<ProsevaClientOptions, "getAuthToken">): ProsevaClient;

package/dist/index.js

@@ -0,0 +1,29 @@
+import createClient from "openapi-fetch";
+/**
+ * Create a typed ProSeVA API client. Pass `getAuthToken` to auto-attach a bearer token.
+ */
+export function createProsevaClient(options = {}) {
+    const client = createClient({
+        baseUrl: options.baseUrl ?? "/api",
+        fetch: options.fetch ?? globalThis.fetch,
+    });
+    const getAuth = options.getAuthToken;
+    if (getAuth) {
+        client.use({
+            async onRequest({ request }) {
+                const token = typeof getAuth === "function" ? await getAuth() : (getAuth ?? null);
+                if (token) {
+                    request.headers.set("Authorization", `Bearer ${token}`);
+                }
+                return request;
+            },
+        });
+    }
+    return client;
+}
+/**
+ * Convenience wrapper that builds a client with a fixed bearer token.
+ */
+export function createProsevaClientWithToken(token, options = {}) {
+    return createProsevaClient({ ...options, getAuthToken: () => token });
+}