@xrystal/dto 26.6.27-v13 → 26.6.27-v15

package/dist/adapters/elysia.cjs

@@ -2,7 +2,7 @@
 
 var elysia = require('elysia');
 
-// src/adapters/elysia.ts
+// src/dto/adapters/http.ts
 
 // src/utils/constants/security-headers.ts
 var DEFAULT_SECURITY_HEADERS = {
@@ -16,88 +16,6 @@ var DEFAULT_SECURITY_HEADERS = {
   "X-DNS-Prefetch-Control": "off"
 };
 
-// src/utils/constants/http.ts
-var NO_BODY_STATUS_CODES = /* @__PURE__ */ new Set([204, 205, 304]);
-function shouldSendResponseBody(statusCode) {
-  return !NO_BODY_STATUS_CODES.has(statusCode);
-}
-
-// src/utils/helpers/uuid.ts
-function generateUUID() {
-  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-    return crypto.randomUUID();
-  }
-  const bytes = new Uint8Array(16);
-  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
-    crypto.getRandomValues(bytes);
-  } else {
-    for (let i = 0; i < bytes.length; i++) {
-      bytes[i] = Math.floor(Math.random() * 256);
-    }
-  }
-  bytes[6] = bytes[6] & 15 | 64;
-  bytes[8] = bytes[8] & 63 | 128;
-  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
-  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-}
-function isValidUUID(id) {
-  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id);
-}
-
-// src/utils/helpers/request-id.ts
-var DEFAULT_REQUEST_ID_HEADERS = [
-  "x-request-id",
-  "x-correlation-id",
-  "traceparent"
-];
-function readHeader(req, name) {
-  const fromGet = req.get?.(name);
-  if (fromGet) return fromGet;
-  const headers = req.headers;
-  if (!headers) return void 0;
-  const direct = headers[name] ?? headers[name.toLowerCase()];
-  if (direct === void 0) return void 0;
-  return Array.isArray(direct) ? direct[0] : direct;
-}
-function traceIdFromTraceparent(traceparent) {
-  const parts = traceparent.trim().split("-");
-  if (parts.length < 2) return void 0;
-  const traceId = parts[1];
-  if (!traceId || !/^[0-9a-f]{32}$/i.test(traceId)) return void 0;
-  return `${traceId.slice(0, 8)}-${traceId.slice(8, 12)}-${traceId.slice(12, 16)}-${traceId.slice(16, 20)}-${traceId.slice(20)}`;
-}
-function resolveRequestId(req, headerNames = DEFAULT_REQUEST_ID_HEADERS) {
-  for (const name of headerNames) {
-    const raw = readHeader(req, name);
-    if (!raw?.trim()) continue;
-    if (name === "traceparent") {
-      const traceId = traceIdFromTraceparent(raw);
-      if (traceId) return traceId;
-      continue;
-    }
-    const id = raw.trim();
-    if (isValidUUID(id)) return id;
-    return id;
-  }
-  return generateUUID();
-}
-
-// src/dto/runtime/context.ts
-var ContextFactory = class {
-  static create(req, options = {}) {
-    return {
-      requestId: resolveRequestId(req, options.requestIdHeaders),
-      startTime: Date.now()
-    };
-  }
-  static fromId(requestId) {
-    return {
-      requestId,
-      startTime: Date.now()
-    };
-  }
-};
-
 // src/utils/constants/status-codes.ts
 var StatusCodes = {
   SUCCESSFUL: {
@@ -154,7 +72,9 @@ function resolveStatusFromCode(code, codes) {
   return isSuccessCode(code, codes);
 }
 
-// src/dto/response/config.ts
+// src/dto/shared.ts
+var BaseDTO = class {
+};
 function resolveBuilderConfig(options = {}) {
   return {
     verbose: options.verbose === true,
@@ -166,61 +86,29 @@ function resolveBuilderConfig(options = {}) {
   };
 }
 
-// src/dto/runtime/metadata.ts
-var MetadataFactory = class {
-  static create(options = {}, context) {
-    return {
-      requestId: context?.requestId ?? generateUUID(),
-      serverTime: (/* @__PURE__ */ new Date()).toISOString(),
-      statusCode: 200,
-      ...options
-    };
+// src/utils/helpers/uuid.ts
+function generateUUID() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
   }
-};
-
-// src/errors/error.ts
-var ResponseError = class extends Error {
-  code;
-  httpStatus;
-  payload;
-  constructor(options = {}) {
-    const codes = createCodeRegistry(options.codes);
-    const code = options.code ?? codes.SERVER;
-    const message = options.message ?? defaultMessageForCode(code, codes);
-    super(message, { cause: options.cause });
-    this.name = "ResponseError";
-    this.code = code;
-    this.httpStatus = options.httpStatus ?? codeToDefaultHttpStatus(code, codes);
-    if (options.payload !== void 0) {
-      this.payload = options.payload;
+  const bytes = new Uint8Array(16);
+  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+    crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < bytes.length; i++) {
+      bytes[i] = Math.floor(Math.random() * 256);
     }
   }
-  toJSON() {
-    return {
-      name: this.name,
-      message: this.message,
-      code: this.code,
-      httpStatus: this.httpStatus,
-      payload: this.payload
-    };
-  }
-};
-function isResponseError(value) {
-  return value instanceof ResponseError;
+  bytes[6] = bytes[6] & 15 | 64;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
 }
-function codeToDefaultHttpStatus(code, codes) {
-  if (code === codes.SUCCESS) return 200;
-  if (code === codes.CLIENT) return 400;
-  if (code === codes.SERVER) return 500;
-  if (code === codes.VALIDATION) return 422;
-  return 500;
+function isValidUUID(id) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id);
 }
 
-// src/dto/shared/base-dto.ts
-var BaseDTO = class {
-};
-
-// src/dto/response/assemble.ts
+// src/dto/shapes/response.ts
 function assembleResponseBody(input) {
   const ordered = {
     status: input.status,
@@ -232,8 +120,6 @@ function assembleResponseBody(input) {
   ordered.code = input.code;
   return ordered;
 }
-
-// src/dto/response/dto.ts
 var ResponseDTO = class _ResponseDTO extends BaseDTO {
   _status;
   _message;
@@ -270,11 +156,8 @@ var ResponseDTO = class _ResponseDTO extends BaseDTO {
     return this;
   }
   data(data) {
-    if (data === void 0) {
-      delete this._payload.data;
-    } else {
-      this._payload.data = data;
-    }
+    if (data === void 0) delete this._payload.data;
+    else this._payload.data = data;
     return this;
   }
   payload(partial) {
@@ -286,9 +169,7 @@ var ResponseDTO = class _ResponseDTO extends BaseDTO {
     return this;
   }
   paginate(total, page, limit) {
-    if (limit <= 0) {
-      throw new Error("ResponseDTO.paginate: limit must be greater than 0");
-    }
+    if (limit <= 0) throw new Error("ResponseDTO.paginate: limit must be greater than 0");
     this._payload.pagination = {
       total,
       page,
@@ -300,20 +181,11 @@ var ResponseDTO = class _ResponseDTO extends BaseDTO {
   }
   schema(input = {}, codes = DefaultCodes) {
     const { status, message, code, payload } = input;
-    if (code !== void 0) {
-      this.code(code);
-    }
-    if (status !== void 0) {
-      this.status(status);
-    } else if (code !== void 0) {
-      this.status(resolveStatusFromCode(code, codes));
-    }
-    if (message !== void 0) {
-      this.message(message);
-    }
-    if (payload !== void 0) {
-      this._payload = { ...payload };
-    }
+    if (code !== void 0) this.code(code);
+    if (status !== void 0) this.status(status);
+    else if (code !== void 0) this.status(resolveStatusFromCode(code, codes));
+    if (message !== void 0) this.message(message);
+    if (payload !== void 0) this._payload = { ...payload };
     return this;
   }
   getCode() {
@@ -323,9 +195,7 @@ var ResponseDTO = class _ResponseDTO extends BaseDTO {
     return this._message;
   }
   setCodeFromHttpStatus(httpStatusCode, codes) {
-    if (this._code === void 0) {
-      this._code = resolveCodeFromHttpStatus(httpStatusCode, codes);
-    }
+    if (this._code === void 0) this._code = resolveCodeFromHttpStatus(httpStatusCode, codes);
     return this;
   }
   transformData(fn) {
@@ -348,12 +218,7 @@ var ResponseDTO = class _ResponseDTO extends BaseDTO {
       return assembleResponseBody({ status, message, code });
     }
     const payload = this.buildPayload();
-    return assembleResponseBody({
-      status,
-      message,
-      payload,
-      code
-    });
+    return assembleResponseBody({ status, message, payload, code });
   }
   buildPayload() {
     const entries = Object.entries(this._payload).filter(([, value]) => value !== void 0);
@@ -362,7 +227,106 @@ var ResponseDTO = class _ResponseDTO extends BaseDTO {
   }
 };
 
-// src/dto/response/plugins.ts
+// src/utils/helpers/request-id.ts
+var DEFAULT_REQUEST_ID_HEADERS = [
+  "x-request-id",
+  "x-correlation-id",
+  "traceparent"
+];
+function readHeader(req, name) {
+  const fromGet = req.get?.(name);
+  if (fromGet) return fromGet;
+  const headers = req.headers;
+  if (!headers) return void 0;
+  const direct = headers[name] ?? headers[name.toLowerCase()];
+  if (direct === void 0) return void 0;
+  return Array.isArray(direct) ? direct[0] : direct;
+}
+function traceIdFromTraceparent(traceparent) {
+  const parts = traceparent.trim().split("-");
+  if (parts.length < 2) return void 0;
+  const traceId = parts[1];
+  if (!traceId || !/^[0-9a-f]{32}$/i.test(traceId)) return void 0;
+  return `${traceId.slice(0, 8)}-${traceId.slice(8, 12)}-${traceId.slice(12, 16)}-${traceId.slice(16, 20)}-${traceId.slice(20)}`;
+}
+function resolveRequestId(req, headerNames = DEFAULT_REQUEST_ID_HEADERS) {
+  for (const name of headerNames) {
+    const raw = readHeader(req, name);
+    if (!raw?.trim()) continue;
+    if (name === "traceparent") {
+      const traceId = traceIdFromTraceparent(raw);
+      if (traceId) return traceId;
+      continue;
+    }
+    const id = raw.trim();
+    if (isValidUUID(id)) return id;
+    return id;
+  }
+  return generateUUID();
+}
+
+// src/dto/factories.ts
+var ContextFactory = class {
+  static create(req, options = {}) {
+    return {
+      requestId: resolveRequestId(req, options.requestIdHeaders),
+      startTime: Date.now()
+    };
+  }
+  static fromId(requestId) {
+    return { requestId, startTime: Date.now() };
+  }
+};
+var MetadataFactory = class {
+  static create(options = {}, context) {
+    return {
+      requestId: context?.requestId ?? generateUUID(),
+      serverTime: (/* @__PURE__ */ new Date()).toISOString(),
+      statusCode: 200,
+      ...options
+    };
+  }
+};
+
+// src/errors/error.ts
+var ResponseError = class extends Error {
+  code;
+  httpStatus;
+  payload;
+  constructor(options = {}) {
+    const codes = createCodeRegistry(options.codes);
+    const code = options.code ?? codes.SERVER;
+    const message = options.message ?? defaultMessageForCode(code, codes);
+    super(message, { cause: options.cause });
+    this.name = "ResponseError";
+    this.code = code;
+    this.httpStatus = options.httpStatus ?? codeToDefaultHttpStatus(code, codes);
+    if (options.payload !== void 0) {
+      this.payload = options.payload;
+    }
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      httpStatus: this.httpStatus,
+      payload: this.payload
+    };
+  }
+};
+function isResponseError(value) {
+  return value instanceof ResponseError;
+}
+function codeToDefaultHttpStatus(code, codes) {
+  if (code === codes.SUCCESS) return 200;
+  if (code === codes.CLIENT) return 400;
+  if (code === codes.SERVER) return 500;
+  if (code === codes.VALIDATION) return 422;
+  return 500;
+}
+
+// src/dto/send/plugins.ts
 function sortPlugins(plugins) {
   return [...plugins].sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
 }
@@ -399,7 +363,80 @@ var PluginRegistry = class {
   }
 };
 
-// src/dto/response/presets.ts
+// src/utils/constants/http.ts
+var NO_BODY_STATUS_CODES = /* @__PURE__ */ new Set([204, 205, 304]);
+function shouldSendResponseBody(statusCode) {
+  return !NO_BODY_STATUS_CODES.has(statusCode);
+}
+
+// src/dto/send/transport.ts
+var JSON_CONTENT_TYPE = "application/json; charset=utf-8";
+function normalizeHeaderValue(value) {
+  return Array.isArray(value) ? value.join(", ") : String(value);
+}
+function toHeaderRecord(headers) {
+  const record = {};
+  for (const [key, value] of Object.entries(headers)) {
+    record[key] = normalizeHeaderValue(value);
+  }
+  return record;
+}
+function serializeSetCookie(cookie) {
+  let header = `${cookie.name}=${cookie.value}`;
+  const options = cookie.options ?? {};
+  if (options.maxAge !== void 0) header += `; Max-Age=${options.maxAge}`;
+  if (typeof options.domain === "string") header += `; Domain=${options.domain}`;
+  if (typeof options.path === "string") header += `; Path=${options.path}`;
+  if (options.expires instanceof Date) header += `; Expires=${options.expires.toUTCString()}`;
+  if (options.httpOnly === true) header += "; HttpOnly";
+  if (options.secure === true) header += "; Secure";
+  if (typeof options.sameSite === "string") header += `; SameSite=${options.sameSite}`;
+  return header;
+}
+function buildSetCookieHeaders(cookies) {
+  return cookies.map(serializeSetCookie);
+}
+function applyElysiaTransport(result, sink) {
+  sink.status = result.statusCode;
+  sink.headers = {
+    ...sink.headers ?? {},
+    ...toHeaderRecord(result.headers)
+  };
+  for (const cookieHeader of buildSetCookieHeaders(result.cookies)) {
+    const existing = sink.headers["Set-Cookie"];
+    sink.headers["Set-Cookie"] = existing ? `${existing}, ${cookieHeader}` : cookieHeader;
+  }
+  if (shouldSendResponseBody(result.statusCode)) {
+    sink.headers["Content-Type"] = JSON_CONTENT_TYPE;
+    return result.body;
+  }
+  return null;
+}
+function dispatchResult(result, sink, plugins, pluginCtx, emitHook) {
+  if (!sink) {
+    return result;
+  }
+  let next = plugins.runBeforeDispatch(result, pluginCtx);
+  emitHook("before_dispatch", next);
+  const dispatched = sink.dispatch(next);
+  plugins.runAfterDispatch(next, pluginCtx);
+  emitHook("after_dispatch", next);
+  return dispatched ?? next;
+}
+
+// src/dto/send/presets.ts
+var PresetTerminal = class {
+  #builder;
+  constructor(builder) {
+    this.#builder = builder;
+  }
+  build() {
+    return this.#builder.build();
+  }
+  send() {
+    return this.#builder.send();
+  }
+};
 var ResponsePresets = class {
   builder;
   codes;
@@ -412,9 +449,6 @@ var ResponsePresets = class {
       this.builder.payload(extras);
     }
   }
-  dispatch() {
-    return this.builder.build();
-  }
   resolveFailureArgs(dataOrMessage, messageOrExtras, extras) {
     if (typeof dataOrMessage === "string") {
       return {
@@ -428,31 +462,34 @@ var ResponsePresets = class {
       extras: typeof messageOrExtras === "string" ? extras : messageOrExtras
     };
   }
+  terminal() {
+    return new PresetTerminal(this.builder);
+  }
   failure(httpStatus, code, dataOrMessage, messageOrExtras, extras) {
     const resolved = this.resolveFailureArgs(dataOrMessage, messageOrExtras, extras);
     this.builder.httpStatus(httpStatus).code(code).status(false).message(resolved.message ?? defaultMessageForCode(code, this.codes)).data(resolved.data);
     this.applyExtras(resolved.extras);
-    return this.dispatch();
+    return this.terminal();
   }
   ok(data, message, extras) {
     this.builder.httpStatus(StatusCodes.SUCCESSFUL.OK).code(this.codes.SUCCESS).status(true).message(message ?? defaultMessageForCode(this.codes.SUCCESS, this.codes)).data(data);
     this.applyExtras(extras);
-    return this.dispatch();
+    return this.terminal();
   }
   created(data, message, extras) {
     this.builder.httpStatus(StatusCodes.SUCCESSFUL.CREATED).code(this.codes.SUCCESS).status(true).message(message ?? defaultMessageForCode(this.codes.SUCCESS, this.codes)).data(data);
     this.applyExtras(extras);
-    return this.dispatch();
+    return this.terminal();
   }
   accepted(message, extras) {
     this.builder.httpStatus(StatusCodes.SUCCESSFUL.ACCEPTED).code(this.codes.SUCCESS).status(true).message(message ?? defaultMessageForCode(this.codes.SUCCESS, this.codes));
     this.applyExtras(extras);
-    return this.dispatch();
+    return this.terminal();
   }
   noContent(extras) {
     this.builder.httpStatus(StatusCodes.SUCCESSFUL.NO_CONTENT).code(this.codes.SUCCESS).status(true).message("").data(void 0);
     this.applyExtras(extras);
-    return this.dispatch();
+    return this.terminal();
   }
   fail(dataOrMessage, messageOrExtras, extras) {
     return this.failure(StatusCodes.CLIENT_ERROR.BAD_REQUEST, this.codes.CLIENT, dataOrMessage, messageOrExtras, extras);
@@ -522,9 +559,9 @@ var ResponsePresets = class {
   }
 };
 
-// src/dto/response/builder.ts
+// src/dto/send/builder.ts
 var Builder = class {
-  dispatcher;
+  sink;
   options;
   context;
   plugins;
@@ -533,8 +570,8 @@ var Builder = class {
   _headers = {};
   _cookies = [];
   _presets;
-  constructor(dispatcher, options = {}, context) {
-    this.dispatcher = dispatcher;
+  constructor(sink, options = {}, context) {
+    this.sink = sink;
     this.options = resolveBuilderConfig(options);
     this.context = context;
     this.plugins = new PluginRegistry(this.options.plugins);
@@ -666,16 +703,19 @@ var Builder = class {
     };
     result = this.plugins.runAfterBuild(result, pluginCtx);
     this.emitHook("after_build", result);
-    if (this.dispatcher) {
-      result = this.plugins.runBeforeDispatch(result, pluginCtx);
-      this.emitHook("before_dispatch", result);
-      const dispatched = this.dispatcher.dispatch(result);
-      this.plugins.runAfterDispatch(result, pluginCtx);
-      this.emitHook("after_dispatch", result);
-      return dispatched ?? result;
-    }
     return result;
   }
+  send() {
+    const pluginCtx = this.createPluginContext();
+    const result = this.build();
+    return dispatchResult(
+      result,
+      this.sink,
+      this.plugins,
+      pluginCtx,
+      (event, payload) => this.emitHook(event, payload)
+    );
+  }
   resolvePublicErrorMessage(error) {
     if (!this.options.verbose && !isResponseError(error)) {
       return defaultMessageForCode(this.options.codes.SERVER, this.options.codes);
@@ -701,8 +741,8 @@ var Builder = class {
     hooks.emit(event, structuredClone(result));
   }
 };
-function createBuilderProxy(dispatcher, options = {}, context) {
-  const instance = new Builder(dispatcher, options, context);
+function createBuilderProxy(sink, options = {}, context) {
+  const instance = new Builder(sink, options, context);
   return new Proxy(instance, {
     get(target, prop, receiver) {
       const value = Reflect.get(target, prop, receiver);
@@ -714,8 +754,8 @@ function createBuilderProxy(dispatcher, options = {}, context) {
   });
 }
 
-// src/adapters/shared.ts
-function createBuilderRuntime(dispatcher, options, context) {
+// src/dto/runtime/index.ts
+function createBuilderRuntime(sink, options, context) {
   const builderOptions = {
     verbose: options.verbose,
     includeStack: options.includeStack,
@@ -727,40 +767,25 @@ function createBuilderRuntime(dispatcher, options, context) {
   return {
     context,
     codes: resolveBuilderConfig(builderOptions).codes,
-    builder: createBuilderProxy(dispatcher, builderOptions, context)
+    builder: createBuilderProxy(sink, builderOptions, context)
   };
 }
 
-// src/adapters/elysia.ts
+// src/dto/adapters/http.ts
+function elysiaSink(set) {
+  return { dispatch: (result) => applyElysiaTransport(result, set) };
+}
 function createElysiaDerive(options = {}) {
   return ({ request, set }) => {
-    const context = ContextFactory.create({
-      headers: headersToRecord(request.headers)
-    }, {
-      requestIdHeaders: options.requestIdHeaders
-    });
+    const context = ContextFactory.create(
+      { headers: headersToRecord(request.headers) },
+      { requestIdHeaders: options.requestIdHeaders }
+    );
     if (options.withDefaultHeaders !== false) {
       const headers = options.defaultHeaders ?? DEFAULT_SECURITY_HEADERS;
       set.headers = { ...set.headers ?? {}, ...headers };
     }
-    const runtime = createBuilderRuntime(
-      {
-        dispatch(result) {
-          set.status = result.statusCode;
-          set.headers = {
-            ...set.headers ?? {},
-            ...normalizeHeaders(result.headers),
-            "Content-Type": "application/json; charset=utf-8"
-          };
-          if (!shouldSendResponseBody(result.statusCode)) {
-            return null;
-          }
-          return result.body;
-        }
-      },
-      options,
-      context
-    );
+    const runtime = createBuilderRuntime(elysiaSink(set), options, context);
     return {
       builder: runtime.builder,
       requestId: runtime.context.requestId,
@@ -769,11 +794,10 @@ function createElysiaDerive(options = {}) {
   };
 }
 var ElysiaAdapter = class {
-  options;
   constructor(options = {}) {
     this.options = options;
   }
-  /** Elysia plugin — adds `builder`, `requestId`, `startTime` to the handler context */
+  options;
   plugin() {
     const derive = createElysiaDerive(this.options);
     return new elysia.Elysia({ name: "x" }).derive(
@@ -784,12 +808,6 @@ var ElysiaAdapter = class {
       })
     );
   }
-  middleware() {
-    return this.plugin();
-  }
-  handler() {
-    return this.plugin();
-  }
 };
 function elysiaMiddleware(options = {}) {
   return new ElysiaAdapter(options).plugin();
@@ -801,18 +819,8 @@ function headersToRecord(headers) {
   });
   return record;
 }
-function normalizeHeaders(headers) {
-  const normalized = {};
-  for (const [key, value] of Object.entries(headers)) {
-    if (Array.isArray(value)) {
-      normalized[key] = value.join(", ");
-    } else {
-      normalized[key] = String(value);
-    }
-  }
-  return normalized;
-}
 
 exports.ElysiaAdapter = ElysiaAdapter;
 exports.createElysiaDerive = createElysiaDerive;
 exports.elysiaMiddleware = elysiaMiddleware;
+exports.elysiaSink = elysiaSink;