@eecho/api-client 0.0.2

package/README.md

@@ -0,0 +1,22 @@
+# @eecho/api-client
+
+Type-safe API client library for the EEcho framework.
+
+## Installation
+
+```bash
+npm install @eecho/api-client @eecho/definition
+```
+
+## Features
+
+- Generate type-safe API clients
+- Automatic API specification generation
+- Built-in request/response handling
+- TypeScript support with full type inference
+- Customizable HTTP client configuration
+
+## Usage
+
+```typescript
+```

package/dist/client.d.ts

@@ -0,0 +1,38 @@
+type SimpleInit = Omit<RequestInit, "headers"> & {
+    headers?: {
+        [key: string]: string;
+    };
+};
+export interface FetchExceptionContext {
+    errorType: "FetchException";
+    requestUrl: string;
+    response?: Response;
+    options: RequestInit;
+    timestamp: Date;
+}
+export type APIExceptionHandler = (ctx: FetchExceptionContext) => Promise<{
+    result?: Response;
+    isNext: boolean;
+}>;
+export type RequestHandler = (p: {
+    url: string;
+    options: SimpleInit;
+}) => Promise<{
+    url: string;
+    options: SimpleInit;
+}>;
+export declare function createHttpClient(): {
+    setHost(url: string): void;
+    setHeader(header: Record<string, string>): void;
+    addRequestHandler(handler: RequestHandler): void;
+    addExceptionHandler(handler: APIExceptionHandler): void;
+    readonly host: string;
+    readonly headers: Record<string, string>;
+    readonly apiExceptionHandlers: APIExceptionHandler[];
+    fetch(p: {
+        url: string;
+        options?: SimpleInit;
+    }): Promise<Response | undefined>;
+};
+export {};
+//# 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,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"}

package/dist/client.js

@@ -0,0 +1,88 @@
+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;
+    }
+}
+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)
+                return result;
+        }
+        throw ctx;
+    }
+    return {
+        setHost(url) { __host = url; },
+        setHeader(header) { __headers = header; },
+        addRequestHandler(handler) {
+            __requestHandlers.push(handler);
+        },
+        addExceptionHandler(handler) {
+            __apiExceptionHandlers.push(handler);
+        },
+        get host() { return __host; },
+        get headers() { return __headers; },
+        get apiExceptionHandlers() { return __apiExceptionHandlers; },
+        async fetch(p) {
+            let { url, options = {} } = p;
+            const combinedHeaders = {
+                ...__headers,
+                ...(options.headers ?? {}),
+            };
+            options = { ...options, headers: combinedHeaders };
+            for (const handler of __requestHandlers) {
+                const next = await handler({ url, options });
+                url = next.url;
+                options = next.options;
+            }
+            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}`;
+            })();
+            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);
+            }
+            catch (err) {
+                const netCtx = new FetchException({
+                    errorType: "FetchException",
+                    requestUrl: fullUrl,
+                    options,
+                    timestamp: new Date(),
+                });
+                return await runHandlers(netCtx);
+            }
+        },
+    };
+}
+//# 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/handlers.d.ts

@@ -0,0 +1,6 @@
+import { APIExceptionHandler } from "./client";
+export declare function createRetryHandler(p: {
+    timeout?: number;
+    retryCount: number;
+}): APIExceptionHandler;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -0,0 +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"}

package/dist/handlers.js

@@ -0,0 +1,32 @@
+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) {
+            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;
+            try {
+                const retryRes = await fetch(retryUrl, { ...ctx.options, signal });
+                if (retryRes.ok) {
+                    return { result: retryRes, isNext: false };
+                }
+            }
+            catch (err) {
+            }
+        }
+        return { isNext: false };
+    };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createHttpClient } from './client';
+export { createRetryHandler } from './handlers';
+export { createAPI } from './spec';
+export { genAPIDefinition } from './spec.generator';
+//# 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,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"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createHttpClient } from './client';
+export { createRetryHandler } from './handlers';
+export { createAPI } from './spec';
+export { genAPIDefinition } from './spec.generator';
+//# 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,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"}

package/dist/spec.d.ts

@@ -0,0 +1,18 @@
+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"]>>;
+};
+type InferIfSchema<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
+export declare function createAPI<S extends ClientAPISpecification>(p: {
+    apiSpec: S;
+    httpClient: ReturnType<typeof createHttpClient>;
+    contentType?: 'application/json' | 'multipart/form-data';
+    responseType?: 'json' | 'blob';
+}): APIMapOf<S>;
+export {};
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -0,0 +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"}

package/dist/spec.generator.d.ts

@@ -0,0 +1,90 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,92 @@
+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

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

package/dist/spec.js

@@ -0,0 +1,91 @@
+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;
+    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(),
+            options: {
+                method: apiSpec.Method,
+                body,
+                headers: Object.keys(headers).length > 0 ? headers : undefined,
+            },
+        });
+        // 4) 응답 검증
+        let data;
+        if (responseType === 'json') {
+            data = await res?.json();
+        }
+        else if (responseType === 'blob') {
+            data = await res?.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}`);
+        }
+        return parsedResult.data;
+    };
+    return {
+        [apiSpec.operationId]: handler,
+    };
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@eecho/api-client",
+  "version": "0.0.2",
+  "description": "EEcho API client for declarative server applications",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "author": "Cogi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eecho/eechojs.git"
+  },
+  "dependencies": {
+    "@eecho/definition": "^0.0.2",
+    "@types/qs": "^6.14.0",
+    "qs": "^6.14.0"
+  },
+  "devDependencies": {
+    "ts-node": "^10.9.2",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}