@karbonjs/api 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KarbonJS
+
+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,71 @@
+# @karbonjs/api
+
+Type-safe API client for Karbon backends. Supports both **server-side** (SSR) and **client-side** with automatic token refresh.
+
+## Install
+
+```bash
+npm install @karbonjs/api @karbonjs/types
+```
+
+## Server-side (SSR)
+
+For SvelteKit `load` functions, Next.js `getServerSideProps`, or any Node.js server code.
+
+```typescript
+import { createServerApi } from '@karbonjs/api/server'
+
+const callApi = createServerApi('http://localhost:3005/api/v1')
+
+// In a SvelteKit load function
+export async function load() {
+  const articles = await callApi('/articles?per_page=10')
+  return { articles: articles.data }
+}
+
+// With authentication
+const user = await callApi('/account/profile', {
+  token: 'jwt-token-here'
+})
+```
+
+## Client-side
+
+For browser-side API calls with automatic 401 retry via refresh tokens.
+
+```typescript
+import { createClientApi } from '@karbonjs/api'
+
+const api = createClientApi({
+  baseUrl: '/api/v1',
+  getToken: () => localStorage.getItem('token'),
+  refreshToken: async () => {
+    const res = await fetch('/auth/refresh', { method: 'POST' })
+    const data = await res.json()
+    localStorage.setItem('token', data.token)
+    return data.token
+  },
+  onAuthFailure: () => {
+    window.location.href = '/login'
+  },
+})
+
+// Auto-refreshes token on 401
+const articles = await api('/articles')
+```
+
+## Options
+
+```typescript
+await callApi('/articles', {
+  method: 'POST',
+  body: { title: 'New article' },
+  token: 'bearer-token',
+  headers: { 'X-Custom': 'value' },
+  timeout: 5000,  // ms, default 15000
+})
+```
+
+## License
+
+MIT

package/dist/client/client.d.ts

@@ -0,0 +1,19 @@
+import type { ApiCallOptions, ApiResult } from '@karbonjs/types';
+export interface ClientApiConfig {
+    baseUrl: string;
+    /** Return current auth token */
+    getToken: () => string | null;
+    /** Called to refresh an expired token. Return new token or null. */
+    refreshToken?: () => Promise<string | null>;
+    /** Called when refresh fails (user should be logged out) */
+    onAuthFailure?: () => void;
+    /** Default timeout in ms (default: 15000) */
+    timeout?: number;
+    /** Default headers sent with every request */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * Client-side API helper with automatic token refresh on 401.
+ */
+export declare function createClientApi(config: ClientApiConfig): <T extends ApiResult = ApiResult>(endpoint: string, options?: ApiCallOptions) => Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAC7B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC3C,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,IAG3B,CAAC,SAAS,SAAS,GAAG,SAAS,EACvD,UAAU,MAAM,EAChB,UAAS,cAAmB,KAC3B,OAAO,CAAC,CAAC,CAAC,CA6Ed"}

package/dist/client/client.js

@@ -0,0 +1,80 @@
+/**
+ * Client-side API helper with automatic token refresh on 401.
+ */
+export function createClientApi(config) {
+    let refreshPromise = null;
+    return async function api(endpoint, options = {}) {
+        const { method = 'GET', body, headers: extraHeaders, timeout } = options;
+        const token = options.token ?? config.getToken();
+        const headers = {
+            'Content-Type': 'application/json',
+            ...config.defaultHeaders,
+            ...extraHeaders,
+        };
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        const doFetch = async (authToken) => {
+            const h = { ...headers };
+            if (authToken)
+                h['Authorization'] = `Bearer ${authToken}`;
+            const controller = new AbortController();
+            const ms = timeout ?? config.timeout ?? 15_000;
+            const timer = setTimeout(() => controller.abort(), ms);
+            try {
+                return await fetch(`${config.baseUrl}${endpoint}`, {
+                    method,
+                    headers: h,
+                    body: body ? JSON.stringify(body) : undefined,
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        };
+        try {
+            let res = await doFetch(token);
+            // Auto-refresh on 401
+            if (res.status === 401 && config.refreshToken) {
+                if (!refreshPromise) {
+                    refreshPromise = Promise.race([
+                        config.refreshToken(),
+                        new Promise((resolve) => setTimeout(() => resolve(null), 10_000)),
+                    ]).finally(() => { refreshPromise = null; });
+                }
+                const newToken = await refreshPromise;
+                if (newToken) {
+                    res = await doFetch(newToken);
+                }
+                else {
+                    config.onAuthFailure?.();
+                    return { ok: false, status: 401, message: 'Authentication failed' };
+                }
+            }
+            if (!res.ok) {
+                const text = await res.text();
+                let message;
+                try {
+                    const parsed = JSON.parse(text);
+                    message = typeof parsed.message === 'string' ? parsed.message.slice(0, 500) : text.slice(0, 500);
+                }
+                catch {
+                    message = text.slice(0, 500);
+                }
+                return { ok: false, status: res.status, message };
+            }
+            if (res.status === 204)
+                return { ok: true };
+            const data = await res.json();
+            return { ...data, ok: true };
+        }
+        catch (err) {
+            const message = err instanceof DOMException && err.name === 'AbortError'
+                ? 'Request timeout'
+                : 'Network error';
+            return { ok: false, status: 0, message };
+        }
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,27 @@
+import type { ApiCallOptions, ApiResult } from '@karbonjs/types';
+export interface ClientApiConfig {
+    baseUrl: string;
+    /** Return current auth token */
+    getToken: () => string | null;
+    /** Called to refresh an expired token. Return new token or null. */
+    refreshToken?: () => Promise<string | null>;
+    /** Called when refresh fails (user should be logged out) */
+    onAuthFailure?: () => void;
+    timeout?: number;
+}
+/**
+ * Client-side API helper with automatic token refresh on 401.
+ *
+ * ```ts
+ * const api = createClientApi({
+ *   baseUrl: '/api/v1',
+ *   getToken: () => authStore.token,
+ *   refreshToken: () => authStore.refresh(),
+ *   onAuthFailure: () => goto('/login'),
+ * })
+ *
+ * const data = await api<{ data: Article[] }>('/articles')
+ * ```
+ */
+export declare function createClientApi(config: ClientApiConfig): <T extends ApiResult = ApiResult>(endpoint: string, options?: ApiCallOptions) => Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAC7B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC3C,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,IAG3B,CAAC,SAAS,SAAS,GAAG,SAAS,EACvD,UAAU,MAAM,EAChB,UAAS,cAAmB,KAC3B,OAAO,CAAC,CAAC,CAAC,CAmEd"}

package/dist/client.js

@@ -0,0 +1,80 @@
+/**
+ * Client-side API helper with automatic token refresh on 401.
+ *
+ * ```ts
+ * const api = createClientApi({
+ *   baseUrl: '/api/v1',
+ *   getToken: () => authStore.token,
+ *   refreshToken: () => authStore.refresh(),
+ *   onAuthFailure: () => goto('/login'),
+ * })
+ *
+ * const data = await api<{ data: Article[] }>('/articles')
+ * ```
+ */
+export function createClientApi(config) {
+    let refreshPromise = null;
+    return async function api(endpoint, options = {}) {
+        const { method = 'GET', body, headers: extraHeaders, timeout } = options;
+        const token = options.token ?? config.getToken();
+        const headers = {
+            'Content-Type': 'application/json',
+            ...extraHeaders,
+        };
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        const doFetch = async (authToken) => {
+            const h = { ...headers };
+            if (authToken)
+                h['Authorization'] = `Bearer ${authToken}`;
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeout ?? config.timeout ?? 15_000);
+            const res = await fetch(`${config.baseUrl}${endpoint}`, {
+                method,
+                headers: h,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            return res;
+        };
+        try {
+            let res = await doFetch(token);
+            // Auto-refresh on 401
+            if (res.status === 401 && config.refreshToken) {
+                if (!refreshPromise) {
+                    refreshPromise = config.refreshToken().finally(() => { refreshPromise = null; });
+                }
+                const newToken = await refreshPromise;
+                if (newToken) {
+                    res = await doFetch(newToken);
+                }
+                else {
+                    config.onAuthFailure?.();
+                    return { ok: false, status: 401, message: 'Authentication failed' };
+                }
+            }
+            if (!res.ok) {
+                const text = await res.text();
+                let message;
+                try {
+                    const parsed = JSON.parse(text);
+                    message = parsed.message || text;
+                }
+                catch {
+                    message = text;
+                }
+                return { ok: false, status: res.status, message };
+            }
+            if (res.status === 204)
+                return { ok: true };
+            const data = await res.json();
+            return { ok: true, ...data };
+        }
+        catch (err) {
+            return { ok: false, status: 0, message: 'Network error' };
+        }
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createClientApi } from './client/client';
+export type { ClientApiConfig } from './client/client';
+export { createServerApi } from './server/server';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createClientApi } from './client/client';
+export { createServerApi } from './server/server';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/server/server.d.ts

@@ -0,0 +1,6 @@
+import type { ApiCallOptions, ApiResult } from '@karbonjs/types';
+/**
+ * Server-side API client (for SSR / SvelteKit load functions / Next.js getServerSideProps).
+ */
+export declare function createServerApi(baseUrl: string, defaultTimeout?: number): <T extends ApiResult = ApiResult>(endpoint: string, options?: ApiCallOptions) => Promise<T>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhE;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,SAAS,IACxC,CAAC,SAAS,SAAS,GAAG,SAAS,EAC3D,UAAU,MAAM,EAChB,UAAS,cAAmB,KAC3B,OAAO,CAAC,CAAC,CAAC,CAiDd"}

package/dist/server/server.js

@@ -0,0 +1,53 @@
+/**
+ * Server-side API client (for SSR / SvelteKit load functions / Next.js getServerSideProps).
+ */
+export function createServerApi(baseUrl, defaultTimeout = 15_000) {
+    return async function callApi(endpoint, options = {}) {
+        const { method = 'GET', body, token, headers: extraHeaders, timeout } = options;
+        const headers = {
+            'Content-Type': 'application/json',
+            ...extraHeaders,
+        };
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        const controller = new AbortController();
+        const ms = timeout ?? defaultTimeout;
+        const timer = setTimeout(() => controller.abort(), ms);
+        let res;
+        try {
+            res = await fetch(`${baseUrl}${endpoint}`, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            const message = err instanceof DOMException && err.name === 'AbortError'
+                ? 'Request timeout'
+                : 'Service temporarily unavailable';
+            return { ok: false, status: 503, message };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            let message;
+            try {
+                const parsed = JSON.parse(text);
+                message = typeof parsed.message === 'string' ? parsed.message.slice(0, 500) : text.slice(0, 500);
+            }
+            catch {
+                message = text.slice(0, 500);
+            }
+            return { ok: false, status: res.status, message };
+        }
+        if (res.status === 204)
+            return { ok: true };
+        const data = await res.json();
+        return { ...data, ok: true };
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,cAAc,GAAG,MAAM;IACtE,OAAO,KAAK,UAAU,OAAO,CAC3B,QAAgB,EAChB,UAA0B,EAAE;QAE5B,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;QAE/E,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,GAAG,YAAY;SAChB,CAAA;QAED,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAA;QAC9C,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,EAAE,GAAG,OAAO,IAAI,cAAc,CAAA;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QAEtD,IAAI,GAAa,CAAA;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,GAAG,QAAQ,EAAE,EAAE;gBACzC,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC7C,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;gBACtE,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,iCAAiC,CAAA;YACrC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAO,CAAA;QACjD,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YAC7B,IAAI,OAAe,CAAA;YACnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAC/B,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAClG,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAC9B,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAO,CAAA;QACxD,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAO,CAAA;QAChD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,IAAI,EAAO,CAAA;IACnC,CAAC,CAAA;AACH,CAAC"}

package/dist/server/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/server/server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.d.ts","sourceRoot":"","sources":["../../src/server/server.test.ts"],"names":[],"mappings":""}

package/dist/server/server.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createServerApi } from './server';
+describe('createServerApi', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('makes GET request with correct URL', async () => {
+        const mockResponse = { ok: true, status: 200, json: () => Promise.resolve({ data: [] }), text: () => Promise.resolve('') };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(mockResponse));
+        const api = createServerApi('http://localhost:3005/api/v1');
+        const result = await api('/articles');
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3005/api/v1/articles', expect.objectContaining({ method: 'GET' }));
+        expect(result.ok).toBe(true);
+    });
+    it('sends Authorization header when token provided', async () => {
+        const mockResponse = { ok: true, status: 200, json: () => Promise.resolve({}), text: () => Promise.resolve('') };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(mockResponse));
+        const api = createServerApi('http://localhost:3005/api/v1');
+        await api('/protected', { token: 'abc123' });
+        expect(fetch).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({
+            headers: expect.objectContaining({ Authorization: 'Bearer abc123' })
+        }));
+    });
+    it('handles 204 No Content', async () => {
+        const mockResponse = { ok: true, status: 204 };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(mockResponse));
+        const api = createServerApi('http://localhost:3005/api/v1');
+        const result = await api('/delete-something', { method: 'DELETE' });
+        expect(result.ok).toBe(true);
+    });
+    it('returns 503 on network error', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('ECONNREFUSED')));
+        const api = createServerApi('http://localhost:3005/api/v1');
+        const result = await api('/articles');
+        expect(result.ok).toBe(false);
+        expect(result.status).toBe(503);
+    });
+    it('handles error responses with JSON body', async () => {
+        const mockResponse = {
+            ok: false,
+            status: 404,
+            text: () => Promise.resolve(JSON.stringify({ message: 'Not found' }))
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(mockResponse));
+        const api = createServerApi('http://localhost:3005/api/v1');
+        const result = await api('/missing');
+        expect(result.ok).toBe(false);
+        expect(result.status).toBe(404);
+        expect(result.message).toBe('Not found');
+    });
+    it('sends POST body as JSON', async () => {
+        const mockResponse = { ok: true, status: 200, json: () => Promise.resolve({ id: 1 }) };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(mockResponse));
+        const api = createServerApi('http://localhost:3005/api/v1');
+        await api('/articles', { method: 'POST', body: { title: 'Test' } });
+        expect(fetch).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ title: 'Test' })
+        }));
+    });
+});
+//# sourceMappingURL=server.test.js.map

package/dist/server/server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../../src/server/server.test.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+import type { ApiCallOptions, ApiResult } from '@karbonjs/types';
+/**
+ * Server-side API client (for SSR / SvelteKit load functions / Next.js getServerSideProps).
+ * Uses fetch with AbortController timeout.
+ *
+ * ```ts
+ * const data = await callApi<{ data: Article[] }>('/articles?per_page=10')
+ * ```
+ */
+export declare function createServerApi(baseUrl: string, defaultTimeout?: number): <T extends ApiResult = ApiResult>(endpoint: string, options?: ApiCallOptions) => Promise<T>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,SAAS,IACxC,CAAC,SAAS,SAAS,GAAG,SAAS,EAC3D,UAAU,MAAM,EAChB,UAAS,cAAmB,KAC3B,OAAO,CAAC,CAAC,CAAC,CA4Cd"}

package/dist/server.js

@@ -0,0 +1,53 @@
+/**
+ * Server-side API client (for SSR / SvelteKit load functions / Next.js getServerSideProps).
+ * Uses fetch with AbortController timeout.
+ *
+ * ```ts
+ * const data = await callApi<{ data: Article[] }>('/articles?per_page=10')
+ * ```
+ */
+export function createServerApi(baseUrl, defaultTimeout = 15_000) {
+    return async function callApi(endpoint, options = {}) {
+        const { method = 'GET', body, token, headers: extraHeaders, timeout } = options;
+        const headers = {
+            'Content-Type': 'application/json',
+            ...extraHeaders,
+        };
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        let res;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeout ?? defaultTimeout);
+            res = await fetch(`${baseUrl}${endpoint}`, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+        }
+        catch (err) {
+            console.error(`[karbon-api] Connection failed to ${baseUrl}:`, err);
+            return { ok: false, status: 503, message: 'Service temporarily unavailable' };
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            let message;
+            try {
+                const parsed = JSON.parse(text);
+                message = parsed.message || text;
+            }
+            catch {
+                message = text;
+            }
+            return { ok: false, status: res.status, message };
+        }
+        if (res.status === 204)
+            return { ok: true };
+        const data = await res.json();
+        return { ok: true, ...data };
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,cAAc,GAAG,MAAM;IACtE,OAAO,KAAK,UAAU,OAAO,CAC3B,QAAgB,EAChB,UAA0B,EAAE;QAE5B,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;QAE/E,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,GAAG,YAAY;SAChB,CAAA;QAED,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAA;QAC9C,CAAC;QAED,IAAI,GAAa,CAAA;QACjB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;YACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,IAAI,cAAc,CAAC,CAAA;YAC7E,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,GAAG,QAAQ,EAAE,EAAE;gBACzC,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC7C,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAA;YACF,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,qCAAqC,OAAO,GAAG,EAAE,GAAG,CAAC,CAAA;YACnE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,iCAAiC,EAAO,CAAA;QACpF,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YAC7B,IAAI,OAAe,CAAA;YACnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAC/B,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAA;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAO,CAAA;QACxD,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAO,CAAA;QAChD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,EAAO,CAAA;IACnC,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@karbonjs/api",
+  "version": "0.1.0",
+  "description": "Type-safe API client for Karbon backends with SSR and client support",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@karbonjs/types": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}