@codexsploitx/schemaapi 1.0.0 → 1.0.2

package/src/adapters/deno.ts

@@ -1,139 +0,0 @@
-import type { createContract } from "../core/contract";
-import { buildErrorPayload } from "../core/contract";
-
-type AnyContract = ReturnType<typeof createContract>;
-
-type MethodSchemaLike = {
-  media?: {
-    kind?: string;
-    contentTypes?: string[];
-    maxSize?: number;
-  };
-};
-
-type DownloadResult =
-  | {
-      data: unknown;
-      contentType?: string;
-      filename?: string;
-    }
-  | unknown;
-
-export function handleContract(
-  contract: AnyContract,
-  handlers: Record<
-    string,
-    (ctx: Record<string, unknown>) => unknown | Promise<unknown>
-  >
-) {
-  // Retorna una función (req: Request) => Promise<Response> compatible con Deno.serve
-  return async (req: Request): Promise<Response> => {
-    const url = new URL(req.url);
-    const path = url.pathname;
-    const method = req.method;
-
-    const schema = contract.schema as Record<string, Record<string, unknown>>;
-
-    for (const routePattern of Object.keys(schema)) {
-      // Regex simple para matching: /users/:id -> /users/([^/]+)
-      // Agregamos ^ y $ para match exacto
-      const regexPattern = routePattern.replace(/:[a-zA-Z0-9_]+/g, "([^/]+)");
-      const regex = new RegExp(`^${regexPattern}$`);
-
-      const match = path.match(regex);
-      if (match) {
-        const routeMethods = schema[routePattern] as Record<
-          string,
-          unknown
-        >;
-        if (routeMethods[method]) {
-          const endpoint = `${method} ${routePattern}`;
-          const implementation = handlers[endpoint];
-          const methodSchema =
-            (routeMethods as Record<string, unknown>)[method] as MethodSchemaLike | undefined;
-
-          if (!implementation) {
-            return new Response("Not Implemented", { status: 501 });
-          }
-
-          // Extraer params
-          // Necesitamos saber los nombres de los parámetros para mapearlos
-          // routePattern: /users/:id/posts/:postId
-          // match: [..., "123", "456"]
-          const paramNames = (routePattern.match(/:[a-zA-Z0-9_]+/g) || []).map(
-            (p) => p.substring(1)
-          );
-          const params: Record<string, string> = {};
-          paramNames.forEach((name, index) => {
-            params[name] = match[index + 1];
-          });
-
-          const wrapped = contract.handle(endpoint, implementation);
-
-          try {
-            let body = undefined;
-            if (method !== "GET" && method !== "HEAD") {
-              try {
-                body = await req.json();
-              } catch {}
-            }
-
-            const context = {
-              params,
-              query: Object.fromEntries(url.searchParams.entries()),
-              body,
-              headers: Object.fromEntries(req.headers.entries()),
-            };
-
-            const result = await wrapped(context);
-            const media = methodSchema?.media;
-            if (media && media.kind === "download") {
-              const download = result as DownloadResult;
-              const data =
-                download &&
-                typeof download === "object" &&
-                "data" in download
-                  ? (download as { data: unknown }).data
-                  : download;
-              const contentType =
-                download &&
-                typeof download === "object" &&
-                "contentType" in download
-                  ? (download as { contentType: string }).contentType
-                  : "application/octet-stream";
-              const filename =
-                download &&
-                typeof download === "object" &&
-                "filename" in download
-                  ? (download as { filename: string }).filename
-                  : undefined;
-
-              const headers: Record<string, string> = {
-                "Content-Type": String(contentType),
-              };
-              if (filename) {
-                headers["Content-Disposition"] = `attachment; filename="${filename}"`;
-              }
-
-              return new Response(data as BodyInit, {
-                headers,
-              });
-            }
-
-            return new Response(JSON.stringify(result), {
-              headers: { "Content-Type": "application/json" },
-            });
-          } catch (err: unknown) {
-            const payload = buildErrorPayload(err);
-            return new Response(JSON.stringify(payload), {
-              status: payload.status,
-              headers: { "Content-Type": "application/json" },
-            });
-          }
-        }
-      }
-    }
-
-    return new Response("Not Found", { status: 404 });
-  };
-}

package/src/adapters/express.ts

@@ -1,134 +0,0 @@
-import type { createContract } from "../core/contract";
-
-type AnyContract = ReturnType<typeof createContract>;
-
-type MethodSchemaLike = {
-  media?: {
-    kind?: string;
-    contentTypes?: string[];
-    maxSize?: number;
-  };
-};
-
-type DownloadResult =
-  | {
-      data: unknown;
-      contentType?: string;
-      filename?: string;
-    }
-  | unknown;
-
-export interface ExpressLikeRequest {
-  params: Record<string, string>;
-  query: Record<string, string>;
-  body: unknown;
-  headers: Record<string, string>;
-  user?: unknown;
-  [key: string]: unknown;
-}
-
-export interface ExpressLikeResponse {
-  json: (body: unknown) => void;
-  send?: (body: unknown) => void;
-  setHeader?: (name: string, value: string) => void;
-}
-
-export type ExpressLikeHandler = (
-  req: ExpressLikeRequest,
-  res: ExpressLikeResponse,
-  next: (err?: unknown) => void
-) => void | Promise<void>;
-
-export type ExpressLikeApp = {
-  [method: string]: (path: string, handler: ExpressLikeHandler) => void;
-};
-
-export function handleContract(
-  app: ExpressLikeApp,
-  contract: AnyContract,
-  handlers: Record<
-    string,
-    (ctx: Record<string, unknown>) => unknown | Promise<unknown>
-  >
-) {
-  const schema = contract.schema as Record<string, Record<string, unknown>>;
-
-  Object.keys(schema).forEach((route) => {
-    const methods = schema[route] as Record<string, unknown>;
-
-    Object.keys(methods).forEach((method) => {
-      const endpoint = `${method} ${route}`;
-      const implementation = handlers[endpoint];
-      const methodSchema = (methods as Record<string, unknown>)[
-        method
-      ] as MethodSchemaLike | undefined;
-
-      if (!implementation) {
-        return;
-      }
-
-      const wrapped = contract.handle(endpoint, implementation);
-      const httpMethod = method.toLowerCase();
-      const register = (app as Record<string, unknown>)[
-        httpMethod
-      ] as ExpressLikeApp[keyof ExpressLikeApp] | undefined;
-
-      if (!register) {
-        return;
-      }
-
-      register(route, async (req, res, next) => {
-        try {
-          const context: Record<string, unknown> = {
-            params: req.params || {},
-            query: req.query || {},
-            body: req.body,
-            headers: req.headers || {},
-            user: req.user,
-          };
-
-          const result = await wrapped(context);
-          const media = methodSchema?.media;
-          if (media && media.kind === "download") {
-            const download = result as DownloadResult;
-            const data =
-              download &&
-              typeof download === "object" &&
-              "data" in download
-                ? (download as { data: unknown }).data
-                : download;
-            const contentType =
-              download &&
-              typeof download === "object" &&
-              "contentType" in download
-                ? (download as { contentType: string }).contentType
-                : "application/octet-stream";
-            const filename =
-              download &&
-              typeof download === "object" &&
-              "filename" in download
-                ? (download as { filename: string }).filename
-                : undefined;
-
-            if (typeof res.setHeader === "function") {
-              res.setHeader("Content-Type", contentType);
-              if (filename) {
-                res.setHeader(
-                  "Content-Disposition",
-                  `attachment; filename="${filename}"`
-                );
-              }
-            }
-            if (typeof res.send === "function") {
-              res.send(data);
-              return;
-            }
-          }
-          res.json(result);
-        } catch (error) {
-          next(error);
-        }
-      });
-    });
-  });
-}

package/src/adapters/fastify.ts

@@ -1,133 +0,0 @@
-import type { createContract } from "../core/contract";
-import { buildErrorPayload } from "../core/contract";
-
-type AnyContract = ReturnType<typeof createContract>;
-
-type MethodSchemaLike = {
-  media?: {
-    kind?: string;
-    contentTypes?: string[];
-    maxSize?: number;
-  };
-};
-
-type DownloadResult =
-  | {
-      data: unknown;
-      contentType?: string;
-      filename?: string;
-    }
-  | unknown;
-
-interface FastifyLikeRequest {
-  params: Record<string, string>;
-  query: Record<string, string>;
-  body: unknown;
-  headers: Record<string, string>;
-  user?: unknown;
-}
-
-interface FastifyLikeReply {
-  status: (code: number) => FastifyLikeReply;
-  send: (payload: unknown) => void;
-  header: (key: string, value: string) => FastifyLikeReply;
-}
-
-interface FastifyInstance {
-  route: (options: {
-    method: string | string[];
-    url: string;
-    handler: (
-      request: FastifyLikeRequest,
-      reply: FastifyLikeReply
-    ) => Promise<void> | void;
-  }) => void;
-}
-
-export function handleContract(
-  fastify: FastifyInstance,
-  contract: AnyContract,
-  handlers: Record<
-    string,
-    (ctx: Record<string, unknown>) => unknown | Promise<unknown>
-  >
-) {
-  const schema = contract.schema as Record<string, Record<string, unknown>>;
-
-  Object.keys(schema).forEach((route) => {
-    const methods = schema[route] as Record<string, unknown>;
-
-    Object.keys(methods).forEach((method) => {
-      const endpoint = `${method} ${route}`;
-      const implementation = handlers[endpoint];
-      const methodSchema = (methods as Record<string, unknown>)[
-        method
-      ] as MethodSchemaLike | undefined;
-
-      if (!implementation) {
-        return;
-      }
-
-      const wrapped = contract.handle(endpoint, implementation);
-
-      fastify.route({
-        method: method,
-        url: route, // Fastify soporta /:id sintaxis
-        handler: async (
-          request: FastifyLikeRequest,
-          reply: FastifyLikeReply
-        ) => {
-          try {
-            const context: Record<string, unknown> = {
-              params: request.params || {},
-              query: request.query || {},
-              body: request.body,
-              headers: request.headers || {},
-              user: request.user,
-            };
-
-            const result = await wrapped(context);
-            const media = methodSchema?.media;
-            if (media && media.kind === "download") {
-              const download = result as DownloadResult;
-              const data =
-                download &&
-                typeof download === "object" &&
-                "data" in download
-                  ? (download as { data: unknown }).data
-                  : download;
-              const contentType =
-                download &&
-                typeof download === "object" &&
-                "contentType" in download
-                  ? (download as { contentType: string }).contentType
-                  : "application/octet-stream";
-              const filename =
-                download &&
-                typeof download === "object" &&
-                "filename" in download
-                  ? (download as { filename: string }).filename
-                  : undefined;
-
-              if (typeof reply.header === "function") {
-                reply.header("Content-Type", contentType);
-                if (filename) {
-                  reply.header(
-                    "Content-Disposition",
-                    `attachment; filename="${filename}"`
-                  );
-                }
-              }
-              reply.send(data);
-              return;
-            }
-            reply.send(result);
-          } catch (error: unknown) {
-            const payload = buildErrorPayload(error);
-            reply.status(payload.status).send(payload);
-          }
-        },
-      });
-    });
-  });
-}

package/src/adapters/hapi.ts

@@ -1,140 +0,0 @@
-import type { createContract } from "../core/contract";
-import { buildErrorPayload } from "../core/contract";
-
-type AnyContract = ReturnType<typeof createContract>;
-
-type MethodSchemaLike = {
-  media?: {
-    kind?: string;
-    contentTypes?: string[];
-    maxSize?: number;
-  };
-};
-
-type DownloadResult =
-  | {
-      data: unknown;
-      contentType?: string;
-      filename?: string;
-    }
-  | unknown;
-
-interface HapiLikeRequest {
-  params: Record<string, string>;
-  query: Record<string, string>;
-  payload: unknown;
-  headers: Record<string, string>;
-  auth?: { credentials?: unknown };
-}
-
-interface HapiLikeResponseObject {
-  type: (contentType: string) => void;
-  header: (key: string, value: string) => void;
-  code: (statusCode: number) => void;
-}
-
-interface HapiLikeResponseToolkit {
-  response: (data: unknown) => HapiLikeResponseObject;
-}
-
-interface HapiServer {
-  route: (options: {
-    method: string;
-    path: string;
-    handler: (
-      request: HapiLikeRequest,
-      h: HapiLikeResponseToolkit
-    ) => Promise<unknown> | unknown;
-  }) => void;
-}
-
-export function handleContract(
-  server: HapiServer,
-  contract: AnyContract,
-  handlers: Record<
-    string,
-    (ctx: Record<string, unknown>) => unknown | Promise<unknown>
-  >
-) {
-  const schema = contract.schema as Record<string, Record<string, unknown>>;
-
-  Object.keys(schema).forEach((route) => {
-    const methods = schema[route] as Record<string, unknown>;
-
-    // Convertir ruta express-style :param a hapi-style {param}
-    const hapiRoute = route.replace(/:([a-zA-Z0-9_]+)/g, "{$1}");
-
-    Object.keys(methods).forEach((method) => {
-      const endpoint = `${method} ${route}`;
-      const implementation = handlers[endpoint];
-      const methodSchema = (methods as Record<string, unknown>)[
-        method
-      ] as MethodSchemaLike | undefined;
-
-      if (!implementation) {
-        return;
-      }
-
-      const wrapped = contract.handle(endpoint, implementation);
-
-      server.route({
-        method: method,
-        path: hapiRoute,
-        handler: async (
-          request: HapiLikeRequest,
-          h: HapiLikeResponseToolkit
-        ) => {
-          try {
-            const context: Record<string, unknown> = {
-              params: request.params || {},
-              query: request.query || {},
-              body: request.payload,
-              headers: request.headers || {},
-              user: request.auth?.credentials, // Common Hapi auth pattern
-            };
-
-            const result = await wrapped(context);
-            const media = methodSchema?.media;
-            if (media && media.kind === "download") {
-              const download = result as DownloadResult;
-              const data =
-                download &&
-                typeof download === "object" &&
-                "data" in download
-                  ? (download as { data: unknown }).data
-                  : download;
-              const contentType =
-                download &&
-                typeof download === "object" &&
-                "contentType" in download
-                  ? (download as { contentType: string }).contentType
-                  : "application/octet-stream";
-              const filename =
-                download &&
-                typeof download === "object" &&
-                "filename" in download
-                  ? (download as { filename: string }).filename
-                  : undefined;
-
-              const response = h.response(data);
-              response.type(contentType);
-              if (filename) {
-                response.header(
-                  "Content-Disposition",
-                  `attachment; filename="${filename}"`
-                );
-              }
-              return response;
-            }
-            return result;
-          } catch (error: unknown) {
-            const payload = buildErrorPayload(error);
-            const response = h.response(payload);
-            response.code(payload.status);
-            return response;
-          }
-        },
-      });
-    });
-  });
-}

package/src/adapters/index.ts

@@ -1,9 +0,0 @@
-export * as express from "./express";
-export * as next from "./next";
-export * as fastify from "./fastify";
-export * as nest from "./nest";
-export * as koa from "./koa";
-export * as hapi from "./hapi";
-export * as remix from "./remix";
-export * as deno from "./deno";
-export * as ws from "./ws";

package/src/adapters/koa.ts

@@ -1,128 +0,0 @@
-import type { createContract } from "../core/contract";
-import { buildErrorPayload } from "../core/contract";
-
-type AnyContract = ReturnType<typeof createContract>;
-
-type MethodSchemaLike = {
-  media?: {
-    kind?: string;
-    contentTypes?: string[];
-    maxSize?: number;
-  };
-};
-
-type DownloadResult =
-  | {
-      data: unknown;
-      contentType?: string;
-      filename?: string;
-    }
-  | unknown;
-
-interface KoaLikeContext {
-  params: Record<string, string>;
-  query: Record<string, string>;
-  request: { body?: unknown };
-  headers: Record<string, string>;
-  state?: { user?: unknown };
-  body?: unknown;
-  type?: string;
-  set: (key: string, value: string) => void;
-  status?: number;
-}
-
-interface KoaRouter {
-  register: (
-    path: string,
-    methods: string[],
-    middleware: (
-      ctx: KoaLikeContext,
-      next: () => Promise<unknown>
-    ) => Promise<unknown>
-  ) => void;
-}
-
-export function handleContract(
-  router: KoaRouter,
-  contract: AnyContract,
-  handlers: Record<
-    string,
-    (ctx: Record<string, unknown>) => unknown | Promise<unknown>
-  >
-) {
-  const schema = contract.schema as Record<string, Record<string, unknown>>;
-
-  Object.keys(schema).forEach((route) => {
-    const methods = schema[route] as Record<string, unknown>;
-
-    Object.keys(methods).forEach((method) => {
-      const endpoint = `${method} ${route}`;
-      const implementation = handlers[endpoint];
-      const methodSchema = (methods as Record<string, unknown>)[
-        method
-      ] as MethodSchemaLike | undefined;
-
-      if (!implementation) {
-        return;
-      }
-
-      const wrapped = contract.handle(endpoint, implementation);
-
-      // Koa Router register
-      router.register(
-        route,
-        [method],
-        async (ctx: KoaLikeContext, _next: () => Promise<unknown>) => {
-          try {
-            const context: Record<string, unknown> = {
-              params: ctx.params || {},
-              query: ctx.query || {},
-              body: ctx.request.body, // requires koa-bodyparser or koa-body
-              headers: ctx.headers || {},
-              user: ctx.state?.user, // common pattern
-            };
-
-            const result = await wrapped(context);
-            const media = methodSchema?.media;
-            if (media && media.kind === "download") {
-              const download = result as DownloadResult;
-              const data =
-                download &&
-                typeof download === "object" &&
-                "data" in download
-                  ? (download as { data: unknown }).data
-                  : download;
-              const contentType =
-                download &&
-                typeof download === "object" &&
-                "contentType" in download
-                  ? (download as { contentType: string }).contentType
-                  : "application/octet-stream";
-              const filename =
-                download &&
-                typeof download === "object" &&
-                "filename" in download
-                  ? (download as { filename: string }).filename
-                  : undefined;
-
-              ctx.body = data;
-              ctx.type = contentType;
-              if (filename) {
-                ctx.set(
-                  "Content-Disposition",
-                  `attachment; filename="${filename}"`
-                );
-              }
-            } else {
-              ctx.body = result;
-            }
-          } catch (error: unknown) {
-            const payload = buildErrorPayload(error);
-            ctx.status = payload.status;
-            ctx.body = payload;
-          }
-        }
-      );
-    });
-  });
-}