@eecho/api-client 0.0.3 → 0.2.0

package/README.md

@@ -1,22 +1,42 @@
 # @eecho/api-client
 
-Type-safe API client library for the EEcho framework.
+Validated HTTP execution for API contracts created by `@eecho/definition`.
 
 ## Installation
 
 ```bash
-npm install @eecho/api-client @eecho/definition
+npm install @eecho/api-client @eecho/definition zod
 ```
 
-## Features
+## Usage
 
-- Generate type-safe API clients
-- Automatic API specification generation
-- Built-in request/response handling
-- TypeScript support with full type inference
-- Customizable HTTP client configuration
+```ts
+import { createAPI, createHttpClient, createRetryHandler } from '@eecho/api-client';
+import { PetAPI } from './pet-api.js';
 
-## Usage
+const httpClient = createHttpClient();
+httpClient.setHost('https://api.example.com');
+httpClient.addExceptionHandler(createRetryHandler({
+  retryCount: 2,
+  timeout: 250,
+}));
+
+const petAPI = createAPI({
+  apiSpec: PetAPI.ReadAPISpecification,
+  httpClient,
+});
 
-```typescript
+const response = await petAPI.getItems({
+  queryParams: {
+    filter: { species: 'Dog' },
+    sort: { name: 'asc' },
+  },
+});
 ```
+
+Requests are validated before they are sent. JSON responses are validated
+before they are returned to application code. HTTP failures can be handled by
+ordered exception handlers; retry behavior is opt-in.
+
+`genAPIDefinition` is re-exported for compatibility. New code should import the
+contract generator from `@eecho/definition`, which owns the shared contract.

package/dist/client.d.ts

@@ -1,38 +1,39 @@
-type SimpleInit = Omit<RequestInit, "headers"> & {
-    headers?: {
-        [key: string]: string;
-    };
+type RequestOptions = Omit<RequestInit, 'headers'> & {
+    headers?: Record<string, string>;
 };
 export interface FetchExceptionContext {
-    errorType: "FetchException";
+    errorType: 'FetchException';
     requestUrl: string;
     response?: Response;
     options: RequestInit;
     timestamp: Date;
+    cause?: unknown;
 }
-export type APIExceptionHandler = (ctx: FetchExceptionContext) => Promise<{
+export type APIExceptionHandler = (context: FetchExceptionContext) => Promise<{
     result?: Response;
     isNext: boolean;
 }>;
-export type RequestHandler = (p: {
+export type RequestHandler = (request: {
     url: string;
-    options: SimpleInit;
+    options: RequestOptions;
 }) => Promise<{
     url: string;
-    options: SimpleInit;
+    options: RequestOptions;
 }>;
 export declare function createHttpClient(): {
     setHost(url: string): void;
-    setHeader(header: Record<string, string>): void;
+    setHeader(nextHeaders: Record<string, string>): void;
     addRequestHandler(handler: RequestHandler): void;
     addExceptionHandler(handler: APIExceptionHandler): void;
     readonly host: string;
-    readonly headers: Record<string, string>;
+    readonly headers: {
+        [x: string]: string;
+    };
     readonly apiExceptionHandlers: APIExceptionHandler[];
-    fetch(p: {
+    fetch(input: {
         url: string;
-        options?: SimpleInit;
-    }): Promise<Response | undefined>;
+        options?: RequestOptions;
+    }): Promise<Response>;
 };
 export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG;IAC/C,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACrC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAC7B,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAC,KAAK,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAkBxH,wBAAgB,gBAAgB;iBAgBf,MAAM;sBACD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;+BACb,cAAc;iCAGZ,mBAAmB;;;;aAQjC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,UAAU,CAAA;KAAE;EAuDvD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;CACzB,KAAK,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC,CAAC;AA4DxD,wBAAgB,gBAAgB;iBAOf,MAAM;2BAGI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;+BAGlB,cAAc;iCAGZ,mBAAmB;;;;;;iBAc7B;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE;EAoC/D"}

package/dist/client.js

@@ -1,87 +1,93 @@
 class FetchException extends Error {
-    constructor(ctx) {
-        super(`Fetch error: ${ctx.errorType} at ${ctx.timestamp.toISOString()}`);
-        this.ctx = ctx;
-        this.errorType = "FetchException";
-        this.requestUrl = ctx.requestUrl;
-        this.response = ctx.response;
-        this.options = ctx.options;
-        this.timestamp = ctx.timestamp;
+    constructor(failure) {
+        const status = failure.response ? ` (${failure.response.status})` : '';
+        super(`Fetch failed for ${failure.requestUrl}${status}`);
+        this.name = 'FetchException';
+        this.errorType = 'FetchException';
+        this.timestamp = new Date();
+        this.requestUrl = failure.requestUrl;
+        this.options = failure.options;
+        this.response = failure.response;
+        this.cause = failure.cause;
     }
 }
-export function createHttpClient() {
-    let __host = "";
-    let __headers = {};
-    let __requestHandlers = [];
-    let __apiExceptionHandlers = [];
-    async function runHandlers(ctx) {
-        if (__apiExceptionHandlers.length === 0)
-            throw ctx;
-        for (const handler of __apiExceptionHandlers) {
-            const { result, isNext } = await handler(ctx);
-            if (!isNext)
+function resolveRequestUrl(host, url) {
+    if (/^https?:\/\//i.test(url)) {
+        return url;
+    }
+    if (!host) {
+        throw new Error(`Cannot resolve relative request URL without a host: ${url}`);
+    }
+    const normalizedHost = host.replace(/\/$/, '');
+    const normalizedPath = url.startsWith('/') ? url : `/${url}`;
+    return `${normalizedHost}${normalizedPath}`;
+}
+async function runExceptionHandlers(exception, handlers) {
+    for (const handler of handlers) {
+        const { result, isNext } = await handler(exception);
+        if (!isNext) {
+            if (result) {
                 return result;
+            }
+            break;
         }
-        throw ctx;
     }
+    throw exception;
+}
+export function createHttpClient() {
+    let host = '';
+    let headers = {};
+    const requestHandlers = [];
+    const exceptionHandlers = [];
     return {
-        setHost(url) { __host = url; },
-        setHeader(header) { __headers = header; },
+        setHost(url) {
+            host = url;
+        },
+        setHeader(nextHeaders) {
+            headers = { ...nextHeaders };
+        },
         addRequestHandler(handler) {
-            __requestHandlers.push(handler);
+            requestHandlers.push(handler);
         },
         addExceptionHandler(handler) {
-            __apiExceptionHandlers.push(handler);
+            exceptionHandlers.push(handler);
+        },
+        get host() {
+            return host;
         },
-        get host() { return __host; },
-        get headers() { return __headers; },
-        get apiExceptionHandlers() { return __apiExceptionHandlers; },
-        async fetch(p) {
-            let { url, options = {} } = p;
-            const combinedHeaders = {
-                ...__headers,
-                ...(options.headers ?? {}),
+        get headers() {
+            return { ...headers };
+        },
+        get apiExceptionHandlers() {
+            return [...exceptionHandlers];
+        },
+        async fetch(input) {
+            let request = {
+                url: input.url,
+                options: {
+                    ...input.options,
+                    headers: {
+                        ...headers,
+                        ...input.options?.headers,
+                    },
+                },
             };
-            options = { ...options, headers: combinedHeaders };
-            for (const handler of __requestHandlers) {
-                const next = await handler({ url, options });
-                url = next.url;
-                options = next.options;
+            for (const handler of requestHandlers) {
+                request = await handler(request);
             }
-            const fullUrl = (() => {
-                if (url.startsWith('http://') || url.startsWith('https://')) {
-                    return url;
-                }
-                if (url.startsWith('/')) {
-                    const hostUrl = new URL(__host);
-                    return `${hostUrl.origin}${hostUrl.pathname.replace(/\/$/, '')}${url}`;
-                }
-                const normalizedHost = __host.endsWith('/') ? __host.slice(0, -1) : __host;
-                const normalizedUrl = url.startsWith('/') ? url : `/${url}`;
-                return `${normalizedHost}${normalizedUrl}`;
-            })();
+            const requestUrl = resolveRequestUrl(host, request.url);
+            let response;
+            let cause;
             try {
-                const res = await fetch(fullUrl, options);
-                if (res.ok)
-                    return res;
-                const ctx = new FetchException({
-                    errorType: "FetchException",
-                    requestUrl: fullUrl,
-                    response: res,
-                    options,
-                    timestamp: new Date(),
-                });
-                return await runHandlers(ctx);
+                response = await fetch(requestUrl, request.options);
+            }
+            catch (error) {
+                cause = error;
             }
-            catch (err) {
-                const netCtx = new FetchException({
-                    errorType: "FetchException",
-                    requestUrl: fullUrl,
-                    options,
-                    timestamp: new Date(),
-                });
-                return await runHandlers(netCtx);
+            if (response?.ok) {
+                return response;
             }
+            return runExceptionHandlers(new FetchException({ requestUrl, options: request.options, response, cause }), exceptionHandlers);
         },
     };
 }

package/dist/client.js.map

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

package/dist/handlers.d.ts

@@ -1,5 +1,5 @@
-import { APIExceptionHandler } from "./client";
-export declare function createRetryHandler(p: {
+import type { APIExceptionHandler } from './client.js';
+export declare function createRetryHandler(options: {
     timeout?: number;
     retryCount: number;
 }): APIExceptionHandler;

package/dist/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAyB,MAAM,UAAU,CAAC;AAEtE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAuCnG"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAyB,MAAM,aAAa,CAAC;AAY9E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,mBAAmB,CAwCtB"}

package/dist/handlers.js

@@ -1,32 +1,41 @@
-export function createRetryHandler(p) {
-    return async (ctx) => {
-        const status = ctx.response?.status;
-        const shouldRetry = ctx.response == null ||
-            status === 429 ||
-            (status != null && status >= 500 && status <= 599);
-        if (!shouldRetry) {
-            return { isNext: true };
-        }
-        const retryUrl = ctx.requestUrl;
-        if (!retryUrl) {
+const wait = (delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs));
+function isRetryable(response) {
+    if (!response) {
+        return true;
+    }
+    return response.status === 429 || response.status >= 500;
+}
+export function createRetryHandler(options) {
+    const { retryCount, timeout: delayMs = 1000 } = options;
+    if (!Number.isInteger(retryCount) || retryCount < 0) {
+        throw new RangeError('retryCount must be a non-negative integer.');
+    }
+    if (delayMs < 0) {
+        throw new RangeError('timeout must be non-negative.');
+    }
+    return async (context) => {
+        if (!isRetryable(context.response) || context.options.signal?.aborted) {
             return { isNext: true };
         }
-        const delayMs = p.timeout ?? 1000;
-        for (let attempt = 1; attempt <= p.retryCount; attempt++) {
-            await new Promise((r) => setTimeout(r, delayMs));
-            const signal = ctx.options.signal?.aborted
-                ? undefined
-                : ctx.options.signal;
+        let latestResponse;
+        for (let attempt = 0; attempt < retryCount; attempt += 1) {
+            await wait(delayMs);
+            if (context.options.signal?.aborted) {
+                return { isNext: true };
+            }
             try {
-                const retryRes = await fetch(retryUrl, { ...ctx.options, signal });
-                if (retryRes.ok) {
-                    return { result: retryRes, isNext: false };
+                latestResponse = await fetch(context.requestUrl, context.options);
+                if (latestResponse.ok || !isRetryable(latestResponse)) {
+                    return { result: latestResponse, isNext: false };
                 }
             }
-            catch (err) {
+            catch {
+                latestResponse = undefined;
             }
         }
-        return { isNext: false };
+        return latestResponse
+            ? { result: latestResponse, isNext: false }
+            : { isNext: true };
     };
 }
 //# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,CAA2C;IAC5E,OAAO,KAAK,EAAE,GAA0B,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;QACpC,MAAM,WAAW,GACf,GAAG,CAAC,QAAQ,IAAI,IAAI;YACpB,MAAM,KAAK,GAAG;YACd,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC;QAErD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC;QAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;QAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACzD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YAEjD,MAAM,MAAM,GACT,GAAG,CAAC,OAAO,CAAC,MAAkC,EAAE,OAAO;gBACtD,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;YAEzB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBAEnE,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAChB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;gBAC7C,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzF,SAAS,WAAW,CAAC,QAAmB;IACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAGlC;IACC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,IAAK,EAAE,GAAG,OAAO,CAAC;IAEzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,UAAU,CAAC,4CAA4C,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,EAAE,OAA8B,EAAE,EAAE;QAC9C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACtE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,cAAoC,CAAC;QAEzC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YAEpB,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAC1B,CAAC;YAED,IAAI,CAAC;gBACH,cAAc,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBAElE,IAAI,cAAc,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;oBACtD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;gBACnD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc,GAAG,SAAS,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO,cAAc;YACnB,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE;YAC3C,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-export { createHttpClient } from './client';
-export { createRetryHandler } from './handlers';
-export { createAPI } from './spec';
-export { genAPIDefinition } from './spec.generator';
+export { createHttpClient } from './client.js';
+export type { APIExceptionHandler, FetchExceptionContext, RequestHandler } from './client.js';
+export { createRetryHandler } from './handlers.js';
+export { createAPI } from './spec.js';
+export type { APIMapOf } from './spec.js';
+export { genAPIDefinition } from '@eecho/definition';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
-export { createHttpClient } from './client';
-export { createRetryHandler } from './handlers';
-export { createAPI } from './spec';
-export { genAPIDefinition } from './spec.generator';
+export { createHttpClient } from './client.js';
+export { createRetryHandler } from './handlers.js';
+export { createAPI } from './spec.js';
+// Compatibility re-export: API contracts are owned by @eecho/definition.
+export { genAPIDefinition } from '@eecho/definition';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,yEAAyE;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/spec.d.ts

@@ -1,18 +1,19 @@
-import { z } from "zod";
-import { createHttpClient } from "./client";
-import { ClientAPISpecification } from '@eecho/definition';
-export type APIMapOf<S extends ClientAPISpecification> = {
-    [K in S["operationId"]]: (input?: {
-        queryParams?: InferIfSchema<S["Request"]["queryParams"]>;
-        body?: InferIfSchema<S["Request"]["body"]>;
-    }) => Promise<z.infer<S["Response"]["body"]>>;
+import { z } from 'zod';
+import type { ClientAPISpecification } from '@eecho/definition';
+import { createHttpClient } from './client.js';
+type InferInputIfSchema<T> = T extends z.ZodTypeAny ? z.input<T> : never;
+type InferOutputIfSchema<T> = T extends z.ZodTypeAny ? z.output<T> : never;
+export type APIMapOf<TSpec extends ClientAPISpecification> = {
+    [K in TSpec['operationId']]: (input?: {
+        queryParams?: InferInputIfSchema<TSpec['Request']['queryParams']>;
+        body?: InferInputIfSchema<TSpec['Request']['body']>;
+    }) => Promise<InferOutputIfSchema<TSpec['Response']['body']>>;
 };
-type InferIfSchema<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
-export declare function createAPI<S extends ClientAPISpecification>(p: {
-    apiSpec: S;
+export declare function createAPI<TSpec extends ClientAPISpecification>(options: {
+    apiSpec: TSpec;
     httpClient: ReturnType<typeof createHttpClient>;
     contentType?: 'application/json' | 'multipart/form-data';
     responseType?: 'json' | 'blob';
-}): APIMapOf<S>;
+}): APIMapOf<TSpec>;
 export {};
 //# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,sBAAsB,IAAI;KACtD,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAChC,WAAW,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;KAC5C,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;CAC9C,CAAC;AAEF,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAIpE,wBAAgB,SAAS,CAAC,CAAC,SAAS,sBAAsB,EAAE,CAAC,EAAE;IAC7D,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAChD,WAAW,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;IACvD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAElC,GAiGM,QAAQ,CAAC,CAAC,CAAC,CACjB"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACzE,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAE3E,MAAM,MAAM,QAAQ,CAAC,KAAK,SAAS,sBAAsB,IAAI;KAC1D,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACpC,WAAW,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;KACrD,KAAK,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;CAC9D,CAAC;AA0DF,wBAAgB,SAAS,CAAC,KAAK,SAAS,sBAAsB,EAAE,OAAO,EAAE;IACvE,OAAO,EAAE,KAAK,CAAC;IACf,UAAU,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAChD,WAAW,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;IACzD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC,GAsDM,QAAQ,CAAC,KAAK,CAAC,CACrB"}

package/dist/spec.js

@@ -1,86 +1,71 @@
 import { stringify } from 'qs';
-// Create API function
-// this return a function that can be called with queryParams and body the types are inferred from the APISpecification
-export function createAPI(p) {
-    const { apiSpec, httpClient, contentType = "application/json", responseType = "json" } = p;
+function createValidationError(label, error) {
+    const validationError = new Error(`${label}: ${error.message}`);
+    Object.assign(validationError, { cause: error });
+    return validationError;
+}
+function parseRequestPart(schema, value, label) {
+    if (!schema) {
+        return undefined;
+    }
+    const result = schema.safeParse(value);
+    if (!result.success) {
+        throw createValidationError(label, result.error);
+    }
+    return result.data;
+}
+function appendFormValue(formData, key, value) {
+    if (value === undefined || value === null) {
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((item) => appendFormValue(formData, key, item));
+        return;
+    }
+    formData.append(key, value instanceof Blob ? value : String(value));
+}
+function serializeBody(value, contentType) {
+    if (value === undefined) {
+        return {};
+    }
+    if (contentType === 'application/json') {
+        return {
+            body: JSON.stringify(value),
+            headers: { 'Content-Type': 'application/json' },
+        };
+    }
+    const formData = new FormData();
+    if (typeof value === 'object' && value !== null) {
+        Object.entries(value).forEach(([key, item]) => appendFormValue(formData, key, item));
+    }
+    return { body: formData };
+}
+export function createAPI(options) {
+    const { apiSpec, httpClient, contentType = 'application/json', responseType = 'json', } = options;
+    const operation = `${apiSpec.operationId} ${apiSpec.Method} ${apiSpec.APIEndpoint}`;
     const handler = async (input) => {
-        if (apiSpec.Request.queryParams && input?.queryParams) {
-            const queryParamsParsing = apiSpec.Request.queryParams.safeParse(input.queryParams);
-            if (!queryParamsParsing.success) {
-                console.error(`API Query Params Validation Error: ${apiSpec.operationId} ${apiSpec.Method} ${apiSpec.APIEndpoint}`, queryParamsParsing.error);
-                console.error(`Input Query Params:`, input?.queryParams);
-                throw new Error(`API Query Params Validation Error: ${queryParamsParsing.error.message}`);
-            }
-        }
-        if (apiSpec.Request.body && input?.body) {
-            const bodyParamsParsing = apiSpec.Request.body.safeParse(input.body);
-            if (!bodyParamsParsing.success) {
-                console.error(`API Body Params Validation Error: ${apiSpec.operationId} ${apiSpec.Method} ${apiSpec.APIEndpoint}`, bodyParamsParsing.error);
-                console.error(`Input Body Params:`, input?.body);
-                throw new Error(`API Body Params Validation Error: ${bodyParamsParsing.error.message}`);
-            }
-        }
-        let url = httpClient.host + apiSpec.APIEndpoint;
-        let queryString = "";
-        if (input?.queryParams) {
-            queryString = stringify(input.queryParams, { addQueryPrefix: true, arrayFormat: 'brackets' });
-        }
-        url += queryString;
-        // Content-Type에 따른 body 처리
-        let body;
-        let headers = {};
-        if (input?.body) {
-            if (contentType === 'application/json') {
-                body = JSON.stringify(input.body);
-                headers = { 'Content-Type': 'application/json' };
-            }
-            else if (contentType === 'multipart/form-data') {
-                // FormData로 변환
-                const formData = new FormData();
-                if (typeof input.body === 'object' && input.body !== null) {
-                    Object.entries(input.body).forEach(([key, value]) => {
-                        if (value instanceof File) {
-                            formData.append(key, value);
-                        }
-                        else if (value !== undefined && value !== null) {
-                            formData.append(key, String(value));
-                        }
-                    });
-                }
-                body = formData;
-                // multipart/form-data는 브라우저가 자동으로 Content-Type을 설정하므로 헤더를 설정하지 않음
-            }
-        }
-        // 3) fetch
-        const res = await httpClient.fetch({
-            url: url.toString(),
+        const queryParams = parseRequestPart(apiSpec.Request.queryParams, input?.queryParams ?? {}, `Invalid query parameters for ${operation}`);
+        const bodyParams = parseRequestPart(apiSpec.Request.body, input?.body, `Invalid request body for ${operation}`);
+        const queryString = queryParams
+            ? stringify(queryParams, { addQueryPrefix: true, arrayFormat: 'brackets' })
+            : '';
+        const requestBody = serializeBody(bodyParams, contentType);
+        const response = await httpClient.fetch({
+            url: `${apiSpec.APIEndpoint}${queryString}`,
             options: {
                 method: apiSpec.Method,
-                body,
-                headers: Object.keys(headers).length > 0 ? headers : undefined,
+                ...requestBody,
             },
         });
-        // 4) 응답 검증
-        let data;
-        if (responseType === 'json') {
-            data = await res?.json();
-        }
-        else if (responseType === 'blob') {
-            data = await res?.blob();
+        if (!response.ok) {
+            throw new Error(`API request failed for ${operation}: ${response.status} ${response.statusText}`);
         }
+        const data = responseType === 'json'
+            ? await response.json()
+            : await response.blob();
         const parsedResult = apiSpec.Response.body.safeParse(data);
-        if (res && !res.ok) {
-            console.error(`API Error: ${apiSpec.operationId} ${apiSpec.Method} ${apiSpec.APIEndpoint}`, {
-                status: res.status,
-                statusText: res.statusText,
-                data: parsedResult.error,
-            });
-            throw new Error(`API Error: ${res.status} ${res.statusText}`);
-        }
         if (!parsedResult.success) {
-            console.error(`API Response Validation Error: ${apiSpec.operationId} ${apiSpec.Method} ${apiSpec.APIEndpoint}`, parsedResult.error);
-            console.error(`Response Data:`, data);
-            throw new Error(`API Response Validation Error: ${parsedResult.error.message}`);
+            throw createValidationError(`Invalid API response for ${operation}`, parsedResult.error);
         }
         return parsedResult.data;
     };

package/dist/spec.js.map

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

package/package.json

@@ -1,9 +1,15 @@
 {
   "name": "@eecho/api-client",
-  "version": "0.0.3",
-  "description": "EEcho API client for declarative server applications",
+  "version": "0.2.0",
+  "description": "Validated HTTP client for shared EEcho API contracts",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "type": "module",
   "files": [
     "dist/**/*"
@@ -17,15 +23,17 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/eecho/eechojs.git"
+    "url": "git+https://github.com/eecho/eechojs.git"
   },
   "dependencies": {
-    "@eecho/definition": "^0.0.2",
-    "@types/qs": "^6.14.0",
+    "@eecho/definition": "^0.2.0",
     "qs": "^6.14.0"
   },
+  "peerDependencies": {
+    "zod": "^4.1.12"
+  },
   "devDependencies": {
-    "ts-node": "^10.9.2",
+    "@types/qs": "^6.14.0",
     "typescript": "^5.0.0"
   },
   "publishConfig": {

package/dist/spec.generator.d.ts

@@ -1,90 +0,0 @@
-import { z } from 'zod';
-import { Definition } from '@eecho/definition';
-export declare function genAPIDefinition<TDefinition extends Definition, const TPrefix extends string>(params: {
-    definition: TDefinition;
-    endpointPrefix: TPrefix;
-}): {
-    CreateAPISpecification: {
-        readonly APIEndpoint: `${TPrefix}/createItems`;
-        readonly Method: "POST";
-        readonly operationId: "createItems";
-        readonly Request: {
-            readonly body: z.ZodObject<{
-                data: z.ZodObject<({ [K_1 in keyof TDefinition]: TDefinition[K_1] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<any, any, infer TApi extends import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TApi["create"] extends readonly unknown[] ? Extract<"Optional", TApi["create"][number]> | Extract<"System", TApi["create"][number]> extends never ? K_1 : never : K_1 : never; }[keyof TDefinition] extends infer T_1 extends keyof TDefinition ? { [K in T_1 as TDefinition[K] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? K : never]: TDefinition[K] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<infer TSchema extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TSchema : never; } : never) extends infer T ? { -readonly [P in keyof T]: T[P]; } : never, z.core.$strip>;
-            }, z.core.$strip>;
-        };
-        readonly Response: {
-            readonly body: z.ZodObject<{
-                success: z.ZodLiteral<true>;
-                data: z.ZodObject<{}, z.core.$strip>;
-            }, z.core.$strip>;
-        };
-    };
-    ReadAPISpecification: {
-        readonly APIEndpoint: `${TPrefix}/getItems`;
-        readonly Method: "GET";
-        readonly operationId: "getItems";
-        readonly Request: {
-            readonly queryParams: z.ZodObject<{
-                page: z.ZodOptional<z.ZodDefault<z.ZodCoercedNumber<unknown>>>;
-                limit: z.ZodOptional<z.ZodDefault<z.ZodCoercedNumber<unknown>>>;
-                filter: z.ZodUnion<readonly [z.ZodOptional<z.ZodObject<(({ [K_4 in keyof TDefinition]: TDefinition[K_4] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<any, any, infer TApi extends import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TApi["read"] extends readonly unknown[] ? "Searchable" extends infer T_5 ? T_5 extends "Searchable" ? T_5 extends TApi["read"][number] ? K_4 : never : never : never : never : never; }[keyof TDefinition] extends infer T_4 extends keyof TDefinition ? { [K_3 in T_4 as TDefinition[K_3] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? K_3 : never]: TDefinition[K_3] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<infer TSchema extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TSchema : never; } : never) extends infer T_3 extends Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> ? { [K_2 in keyof T_3]: z.ZodOptional<T_3[K_2]>; } : never) extends infer T_2 ? { -readonly [P_1 in keyof T_2]: T_2[P_1]; } : never, z.core.$strip>>, z.ZodOptional<z.ZodObject<(({ [K_7 in keyof TDefinition]: TDefinition[K_7] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<any, any, infer TApi extends import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TApi["read"] extends readonly unknown[] ? "SearchableArray" extends infer T_8 ? T_8 extends "SearchableArray" ? T_8 extends TApi["read"][number] ? K_7 : never : never : never : never : never; }[keyof TDefinition] extends infer T_7 extends keyof TDefinition ? { [K_6 in T_7 as TDefinition[K_6] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? K_6 : never]: TDefinition[K_6] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<infer TSchema extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TSchema : never; } : never) extends infer T_6 extends Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> ? { [K_5 in keyof T_6]: z.ZodOptional<z.ZodArray<z.ZodOptional<T_6[K_5]>>>; } : never) extends infer T_5 ? { -readonly [P_2 in keyof T_5]: T_5[P_2]; } : never, z.core.$strip>>]>;
-                sort: z.ZodOptional<z.ZodObject<(({ [K_10 in keyof TDefinition]: TDefinition[K_10] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<any, any, infer TApi extends import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TApi["read"] extends readonly unknown[] ? "Sortable" extends infer T_11 ? T_11 extends "Sortable" ? T_11 extends TApi["read"][number] ? K_10 : never : never : never : never : never; }[keyof TDefinition] extends infer T_10 extends keyof TDefinition ? { [K_9 in T_10 as TDefinition[K_9] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? K_9 : never]: TDefinition[K_9] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<infer TSchema extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TSchema : never; } : never) extends infer T_9 extends Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> ? { [K_8 in keyof T_9]: z.ZodOptional<T_9[K_8]>; } : never) extends infer T_8 ? { -readonly [P_3 in keyof T_8]: T_8[P_3]; } : never, z.core.$strip>>;
-            }, z.core.$strip>;
-        };
-        readonly Response: {
-            readonly body: z.ZodObject<{
-                success: z.ZodLiteral<true>;
-                data: z.ZodArray<z.ZodObject<({ [K_12 in keyof TDefinition]: TDefinition[K_12] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<any, any, infer TApi extends import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TApi["read"] extends readonly unknown[] ? Extract<"Hidden", TApi["read"][number]> | Extract<"Detail", TApi["read"][number]> extends never ? K_12 : never : K_12 : never; }[keyof TDefinition] extends infer T_12 extends keyof TDefinition ? { [K_11 in T_12 as TDefinition[K_11] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? K_11 : never]: TDefinition[K_11] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<infer TSchema extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TSchema : never; } : never) extends infer T_11 ? { -readonly [P_4 in keyof T_11]: T_11[P_4]; } : never, z.core.$strip>>;
-            }, z.core.$strip>;
-        };
-    };
-    UpdateAPISpecification: {
-        readonly APIEndpoint: `${TPrefix}/updateItem`;
-        readonly Method: "POST";
-        readonly operationId: "updateItem";
-        readonly Request: {
-            readonly body: z.ZodObject<{
-                id: z.ZodAny;
-                data: z.ZodObject<(({ [K_15 in keyof TDefinition]: TDefinition[K_15] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<any, any, infer TApi extends import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TApi["update"] extends readonly unknown[] ? "Updatable" extends infer T_16 ? T_16 extends "Updatable" ? T_16 extends TApi["update"][number] ? K_15 : never : never : never : never : never; }[keyof TDefinition] extends infer T_15 extends keyof TDefinition ? { [K_14 in T_15 as TDefinition[K_14] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? K_14 : never]: TDefinition[K_14] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<infer TSchema extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TSchema : never; } : never) extends infer T_14 extends Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> ? { [K_13 in keyof T_14]: z.ZodOptional<T_14[K_13]>; } : never) extends infer T_13 ? { -readonly [P_5 in keyof T_13]: T_13[P_5]; } : never, z.core.$strip>;
-            }, z.core.$strip>;
-        };
-        readonly Response: {
-            readonly body: z.ZodObject<{
-                success: z.ZodLiteral<true>;
-            }, z.core.$strip>;
-        };
-    };
-    DeleteAPISpecification: {
-        readonly APIEndpoint: `${TPrefix}/deleteItems`;
-        readonly Method: "POST";
-        readonly operationId: "deleteItems";
-        readonly Request: {
-            readonly body: z.ZodObject<{
-                ids: z.ZodArray<z.ZodObject<{}, z.core.$strip>>;
-            }, z.core.$strip>;
-        };
-        readonly Response: {
-            readonly body: z.ZodObject<{
-                success: z.ZodLiteral<true>;
-            }, z.core.$strip>;
-        };
-    };
-    PutAPISpecification: {
-        readonly APIEndpoint: `${TPrefix}/putItem`;
-        readonly Method: "PUT";
-        readonly operationId: "putItem";
-        readonly Request: {
-            readonly body: z.ZodObject<{
-                data: z.ZodObject<({ [K_1 in keyof TDefinition]: TDefinition[K_1] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<any, any, infer TApi extends import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TApi["create"] extends readonly unknown[] ? Extract<"Optional", TApi["create"][number]> | Extract<"System", TApi["create"][number]> extends never ? K_1 : never : K_1 : never; }[keyof TDefinition] extends infer T_17 extends keyof TDefinition ? { [K in T_17 as TDefinition[K] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? K : never]: TDefinition[K] extends import("@eecho/definition/dist/model/model.define.type").PrimitiveDefinition<infer TSchema extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, readonly import("@eecho/definition/dist/model/model.define.type").PrimitiveIndex[], import("@eecho/definition/dist/model/model.define.type").APIIndex, string> ? TSchema : never; } : never) extends infer T_16 ? { -readonly [P in keyof T_16]: T_16[P]; } : never, z.core.$strip>;
-            }, z.core.$strip>;
-        };
-        readonly Response: {
-            readonly body: z.ZodObject<{
-                success: z.ZodLiteral<true>;
-                data: z.ZodObject<{}, z.core.$strip>;
-            }, z.core.$strip>;
-        };
-    };
-};
-//# sourceMappingURL=spec.generator.d.ts.map

package/dist/spec.generator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec.generator.d.ts","sourceRoot":"","sources":["../src/spec.generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAOL,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,gBAAgB,CAAC,WAAW,SAAS,UAAU,EAAE,KAAK,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,EAAE;IACrG,UAAU,EAAE,WAAW,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgGA"}

package/dist/spec.generator.js

@@ -1,92 +0,0 @@
-import { z } from 'zod';
-import { extractCreateRequiredField, extractReadbleField, extractSearchArrayOption, extractSearchOption, extractSortableOption, extractUpdateOption } from '@eecho/definition';
-export function genAPIDefinition(params) {
-    const { definition, endpointPrefix } = params;
-    const createRequiredField = extractCreateRequiredField({ definition });
-    const readableField = extractReadbleField({ definition });
-    const searchableOption = extractSearchOption({ definition });
-    const searchableArrayOption = extractSearchArrayOption({ definition });
-    const sortableOption = extractSortableOption({ definition });
-    const updatableOption = extractUpdateOption({ definition });
-    const CreateAPISpecification = {
-        APIEndpoint: `${endpointPrefix}/createItems`,
-        Method: 'POST',
-        operationId: 'createItems',
-        Request: {
-            body: z.object({ data: z.object(createRequiredField) }),
-        },
-        Response: {
-            body: z.object({
-                success: z.literal(true),
-                data: z.object({}),
-            }),
-        },
-    };
-    const ReadAPISpecification = {
-        APIEndpoint: `${endpointPrefix}/getItems`,
-        Method: 'GET',
-        operationId: 'getItems',
-        Request: {
-            queryParams: z.object({
-                page: z.coerce.number().default(1).optional(),
-                limit: z.coerce.number().default(15).optional(),
-                filter: z.union([
-                    z.object(searchableOption).optional(),
-                    z.object(searchableArrayOption).optional()
-                ]),
-                sort: z.object(sortableOption).optional(),
-            }),
-        },
-        Response: {
-            body: z.object({
-                success: z.literal(true),
-                data: z.array(z.object(readableField)),
-            })
-        },
-    };
-    const UpdateAPISpecification = {
-        APIEndpoint: `${endpointPrefix}/updateItem`,
-        Method: 'POST',
-        operationId: 'updateItem',
-        Request: {
-            body: z.object({
-                id: z.any(),
-                data: z.object(updatableOption),
-            })
-        },
-        Response: {
-            body: z.object({
-                success: z.literal(true),
-            }),
-        },
-    };
-    const DeleteAPISpecification = {
-        APIEndpoint: `${endpointPrefix}/deleteItems`,
-        Method: 'POST',
-        operationId: 'deleteItems',
-        Request: {
-            body: z.object({
-                ids: z.array(z.object({})),
-            }),
-        },
-        Response: {
-            body: z.object({
-                success: z.literal(true),
-            }),
-        },
-    };
-    const PutAPISpecification = {
-        ...CreateAPISpecification,
-        APIEndpoint: `${endpointPrefix}/putItem`,
-        Method: 'PUT',
-        operationId: 'putItem'
-    };
-    return {
-        CreateAPISpecification,
-        ReadAPISpecification,
-        UpdateAPISpecification,
-        DeleteAPISpecification,
-        PutAPISpecification
-    };
-}
-//# sourceMappingURL=spec.generator.js.map

package/dist/spec.generator.js.map

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