@xrystal/dto 26.6.27-v12

package/dist/dto/log/assemble.d.ts

@@ -0,0 +1,3 @@
+import type { LogBody, LogInput } from './types.js';
+/** Guarantees JSON key order: level → service → message? → payload? → code? → timestamp → id? → env */
+export declare function assembleLogBody(input: LogInput): LogBody;

package/dist/dto/log/builder.d.ts

@@ -0,0 +1,41 @@
+import type { NodeEnvEnum } from '../../enums/node-env.js';
+import type { LogBody, LogSchemaInput } from './types.js';
+import { BaseDTO } from '../shared/base-dto.js';
+/**
+ * Log DTO — static chain entry points mirror field order: level → service → … → env
+ *
+ * ```typescript
+ * DTO.Log.level('info').service('api').env(NodeEnvEnum.PROD).build()
+ * LogDTO.level('info').service('api').env(NodeEnvEnum.PROD).build()
+ * ```
+ */
+export declare class LogDTO extends BaseDTO<LogBody, LogSchemaInput> {
+    private _level?;
+    private _service?;
+    private _env?;
+    private _message?;
+    private _payload;
+    private _code?;
+    private _timestamp?;
+    private _id?;
+    static level(value: string): LogDTO;
+    static service(value: string): LogDTO;
+    static env(value: NodeEnvEnum): LogDTO;
+    static message(value: string): LogDTO;
+    static code(value: string | number): LogDTO;
+    static timestamp(value: string): LogDTO;
+    static id(value: string | number): LogDTO;
+    static payload(partial: Record<string, unknown>): LogDTO;
+    /** One-shot body input — same last-wins rules as the instance `.schema()`. */
+    static schema(input?: LogSchemaInput): LogDTO;
+    level(value: string): this;
+    service(value: string): this;
+    env(value: NodeEnvEnum): this;
+    message(value: string): this;
+    code(value: string | number): this;
+    timestamp(value: string): this;
+    id(value: string | number): this;
+    payload(partial: Record<string, unknown>): this;
+    schema(input?: LogSchemaInput): this;
+    build(): LogBody;
+}

package/dist/dto/log/index.cjs

@@ -0,0 +1,152 @@
+'use strict';
+
+// src/dto/log/assemble.ts
+function assembleLogBody(input) {
+  const ordered = {
+    level: input.level,
+    service: input.service
+  };
+  if (input.message !== void 0) {
+    ordered.message = input.message;
+  }
+  if (input.payload !== void 0 && Object.keys(input.payload).length > 0) {
+    ordered.payload = input.payload;
+  }
+  if (input.code !== void 0) {
+    ordered.code = input.code;
+  }
+  ordered.timestamp = input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
+  if (input.id !== void 0) {
+    ordered.id = input.id;
+  }
+  ordered.env = input.env;
+  return ordered;
+}
+
+// src/dto/shared/schema-utils.ts
+function assertRequiredFields(input, fields, label = "Missing required fields") {
+  const missing = fields.filter((field) => {
+    const value = input[field];
+    return value === void 0 || value === null || value === "";
+  });
+  if (missing.length > 0) {
+    throw new Error(`${label}: ${missing.join(", ")}`);
+  }
+}
+
+// src/dto/shared/base-dto.ts
+var BaseDTO = class {
+};
+
+// src/dto/log/builder.ts
+var LogDTO = class _LogDTO extends BaseDTO {
+  _level;
+  _service;
+  _env;
+  _message;
+  _payload = {};
+  _code;
+  _timestamp;
+  _id;
+  static level(value) {
+    return new _LogDTO().level(value);
+  }
+  static service(value) {
+    return new _LogDTO().service(value);
+  }
+  static env(value) {
+    return new _LogDTO().env(value);
+  }
+  static message(value) {
+    return new _LogDTO().message(value);
+  }
+  static code(value) {
+    return new _LogDTO().code(value);
+  }
+  static timestamp(value) {
+    return new _LogDTO().timestamp(value);
+  }
+  static id(value) {
+    return new _LogDTO().id(value);
+  }
+  static payload(partial) {
+    return new _LogDTO().payload(partial);
+  }
+  /** One-shot body input — same last-wins rules as the instance `.schema()`. */
+  static schema(input = {}) {
+    return new _LogDTO().schema(input);
+  }
+  level(value) {
+    this._level = value;
+    return this;
+  }
+  service(value) {
+    this._service = value;
+    return this;
+  }
+  env(value) {
+    this._env = value;
+    return this;
+  }
+  message(value) {
+    this._message = value;
+    return this;
+  }
+  code(value) {
+    this._code = value;
+    return this;
+  }
+  timestamp(value) {
+    this._timestamp = value;
+    return this;
+  }
+  id(value) {
+    this._id = value;
+    return this;
+  }
+  payload(partial) {
+    this._payload = { ...this._payload, ...partial };
+    return this;
+  }
+  schema(input = {}) {
+    const { level, service, message, env, code, timestamp, id, payload } = input;
+    if (level !== void 0) this.level(level);
+    if (service !== void 0) this.service(service);
+    if (env !== void 0) this.env(env);
+    if (message !== void 0) this.message(message);
+    if (code !== void 0) this.code(code);
+    if (timestamp !== void 0) this.timestamp(timestamp);
+    if (id !== void 0) this.id(id);
+    if (payload !== void 0) {
+      this._payload = { ...payload };
+    }
+    return this;
+  }
+  build() {
+    assertRequiredFields(
+      {
+        level: this._level,
+        service: this._service,
+        env: this._env
+      },
+      ["level", "service", "env"],
+      "Missing log fields"
+    );
+    const input = {
+      level: this._level,
+      service: this._service,
+      env: this._env,
+      message: this._message,
+      code: this._code,
+      timestamp: this._timestamp,
+      id: this._id
+    };
+    if (Object.keys(this._payload).length > 0) {
+      input.payload = this._payload;
+    }
+    return assembleLogBody(input);
+  }
+};
+
+exports.LogDTO = LogDTO;
+exports.assembleLogBody = assembleLogBody;

package/dist/dto/log/index.d.ts

@@ -0,0 +1,3 @@
+export type { LogInput, LogBody, LogSchemaInput, ILogDTO, } from './types.js';
+export { assembleLogBody } from './assemble.js';
+export { LogDTO } from './builder.js';

package/dist/dto/log/index.js

@@ -0,0 +1,149 @@
+// src/dto/log/assemble.ts
+function assembleLogBody(input) {
+  const ordered = {
+    level: input.level,
+    service: input.service
+  };
+  if (input.message !== void 0) {
+    ordered.message = input.message;
+  }
+  if (input.payload !== void 0 && Object.keys(input.payload).length > 0) {
+    ordered.payload = input.payload;
+  }
+  if (input.code !== void 0) {
+    ordered.code = input.code;
+  }
+  ordered.timestamp = input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
+  if (input.id !== void 0) {
+    ordered.id = input.id;
+  }
+  ordered.env = input.env;
+  return ordered;
+}
+
+// src/dto/shared/schema-utils.ts
+function assertRequiredFields(input, fields, label = "Missing required fields") {
+  const missing = fields.filter((field) => {
+    const value = input[field];
+    return value === void 0 || value === null || value === "";
+  });
+  if (missing.length > 0) {
+    throw new Error(`${label}: ${missing.join(", ")}`);
+  }
+}
+
+// src/dto/shared/base-dto.ts
+var BaseDTO = class {
+};
+
+// src/dto/log/builder.ts
+var LogDTO = class _LogDTO extends BaseDTO {
+  _level;
+  _service;
+  _env;
+  _message;
+  _payload = {};
+  _code;
+  _timestamp;
+  _id;
+  static level(value) {
+    return new _LogDTO().level(value);
+  }
+  static service(value) {
+    return new _LogDTO().service(value);
+  }
+  static env(value) {
+    return new _LogDTO().env(value);
+  }
+  static message(value) {
+    return new _LogDTO().message(value);
+  }
+  static code(value) {
+    return new _LogDTO().code(value);
+  }
+  static timestamp(value) {
+    return new _LogDTO().timestamp(value);
+  }
+  static id(value) {
+    return new _LogDTO().id(value);
+  }
+  static payload(partial) {
+    return new _LogDTO().payload(partial);
+  }
+  /** One-shot body input — same last-wins rules as the instance `.schema()`. */
+  static schema(input = {}) {
+    return new _LogDTO().schema(input);
+  }
+  level(value) {
+    this._level = value;
+    return this;
+  }
+  service(value) {
+    this._service = value;
+    return this;
+  }
+  env(value) {
+    this._env = value;
+    return this;
+  }
+  message(value) {
+    this._message = value;
+    return this;
+  }
+  code(value) {
+    this._code = value;
+    return this;
+  }
+  timestamp(value) {
+    this._timestamp = value;
+    return this;
+  }
+  id(value) {
+    this._id = value;
+    return this;
+  }
+  payload(partial) {
+    this._payload = { ...this._payload, ...partial };
+    return this;
+  }
+  schema(input = {}) {
+    const { level, service, message, env, code, timestamp, id, payload } = input;
+    if (level !== void 0) this.level(level);
+    if (service !== void 0) this.service(service);
+    if (env !== void 0) this.env(env);
+    if (message !== void 0) this.message(message);
+    if (code !== void 0) this.code(code);
+    if (timestamp !== void 0) this.timestamp(timestamp);
+    if (id !== void 0) this.id(id);
+    if (payload !== void 0) {
+      this._payload = { ...payload };
+    }
+    return this;
+  }
+  build() {
+    assertRequiredFields(
+      {
+        level: this._level,
+        service: this._service,
+        env: this._env
+      },
+      ["level", "service", "env"],
+      "Missing log fields"
+    );
+    const input = {
+      level: this._level,
+      service: this._service,
+      env: this._env,
+      message: this._message,
+      code: this._code,
+      timestamp: this._timestamp,
+      id: this._id
+    };
+    if (Object.keys(this._payload).length > 0) {
+      input.payload = this._payload;
+    }
+    return assembleLogBody(input);
+  }
+};
+
+export { LogDTO, assembleLogBody };

package/dist/dto/log/types.d.ts

@@ -0,0 +1,26 @@
+import type { NodeEnvEnum } from '../../enums/node-env.js';
+export interface LogInput {
+    level: string;
+    service: string;
+    message?: string;
+    payload?: Record<string, unknown>;
+    code?: string | number;
+    timestamp?: string;
+    id?: string | number;
+    env: NodeEnvEnum;
+}
+export type LogSchemaInput = Partial<Pick<LogInput, 'level' | 'service' | 'message' | 'env' | 'code' | 'timestamp' | 'id'>> & {
+    payload?: Record<string, unknown>;
+};
+export type ILogDTO = LogInput;
+/** Fixed field order: level → service → message? → payload? → code? → timestamp → id? → env */
+export interface LogBody {
+    level: string;
+    service: string;
+    message?: string;
+    payload?: Record<string, unknown>;
+    code?: string | number;
+    timestamp: string;
+    id?: string | number;
+    env: NodeEnvEnum;
+}

package/dist/dto/queue/assemble.d.ts

@@ -0,0 +1,2 @@
+import type { QueueMessage, QueueMetadata } from './types.js';
+export declare function assembleQueueMessage<P, E>(metadata: QueueMetadata<E>, payload: P): QueueMessage<P, E>;

package/dist/dto/queue/builder.d.ts

@@ -0,0 +1,35 @@
+import type { QueueMessage, QueueSchemaInput } from './types.js';
+import { BaseDTO } from '../shared/base-dto.js';
+/**
+ * Queue DTO — static chain entry points mirror metadata field order.
+ *
+ * ```typescript
+ * DTO.Queue.source('users-api').eventType('user.created').build()
+ * ```
+ */
+export declare class QueueDTO<P = unknown, E = unknown> extends BaseDTO<QueueMessage<P, E>, QueueSchemaInput<P, E>> {
+    private _source?;
+    private _eventType?;
+    private _userId?;
+    private _correlationId?;
+    private _extraData?;
+    private _payload?;
+    private _timestamp?;
+    static source<P = unknown, E = unknown>(value: string): QueueDTO<P, E>;
+    static eventType<P = unknown, E = unknown>(value: string): QueueDTO<P, E>;
+    static userId<P = unknown, E = unknown>(value: string): QueueDTO<P, E>;
+    static correlationId<P = unknown, E = unknown>(value: string): QueueDTO<P, E>;
+    static extraData<P = unknown, E = unknown>(value: E): QueueDTO<P, E>;
+    static timestamp<P = unknown, E = unknown>(value: number): QueueDTO<P, E>;
+    static payload<P = unknown, E = unknown>(value: P): QueueDTO<P, E>;
+    static schema<P = unknown, E = unknown>(input?: QueueSchemaInput<P, E>): QueueDTO<P, E>;
+    source(value: string): this;
+    eventType(value: string): this;
+    userId(value: string): this;
+    correlationId(value: string): this;
+    extraData(value: E): this;
+    timestamp(value: number): this;
+    payload(value: P): this;
+    schema(input?: QueueSchemaInput<P, E>): this;
+    build(): QueueMessage<P, E>;
+}

package/dist/dto/queue/index.cjs

@@ -0,0 +1,154 @@
+'use strict';
+
+// src/dto/queue/assemble.ts
+function assembleQueueMessage(metadata, payload) {
+  const orderedMetadata = {
+    source: metadata.source,
+    eventType: metadata.eventType,
+    timestamp: metadata.timestamp,
+    correlationId: metadata.correlationId
+  };
+  if (metadata.userId !== void 0) {
+    orderedMetadata.userId = metadata.userId;
+  }
+  if (metadata.extraData !== void 0) {
+    orderedMetadata.extraData = metadata.extraData;
+  }
+  return {
+    metadata: orderedMetadata,
+    payload
+  };
+}
+
+// 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)}`;
+}
+
+// src/dto/shared/schema-utils.ts
+function assertRequiredFields(input, fields, label = "Missing required fields") {
+  const missing = fields.filter((field) => {
+    const value = input[field];
+    return value === void 0 || value === null || value === "";
+  });
+  if (missing.length > 0) {
+    throw new Error(`${label}: ${missing.join(", ")}`);
+  }
+}
+
+// src/dto/shared/base-dto.ts
+var BaseDTO = class {
+};
+
+// src/dto/queue/builder.ts
+var QueueDTO = class _QueueDTO extends BaseDTO {
+  _source;
+  _eventType;
+  _userId;
+  _correlationId;
+  _extraData;
+  _payload;
+  _timestamp;
+  static source(value) {
+    return new _QueueDTO().source(value);
+  }
+  static eventType(value) {
+    return new _QueueDTO().eventType(value);
+  }
+  static userId(value) {
+    return new _QueueDTO().userId(value);
+  }
+  static correlationId(value) {
+    return new _QueueDTO().correlationId(value);
+  }
+  static extraData(value) {
+    return new _QueueDTO().extraData(value);
+  }
+  static timestamp(value) {
+    return new _QueueDTO().timestamp(value);
+  }
+  static payload(value) {
+    return new _QueueDTO().payload(value);
+  }
+  static schema(input = {}) {
+    return new _QueueDTO().schema(input);
+  }
+  source(value) {
+    this._source = value;
+    return this;
+  }
+  eventType(value) {
+    this._eventType = value;
+    return this;
+  }
+  userId(value) {
+    this._userId = value;
+    return this;
+  }
+  correlationId(value) {
+    this._correlationId = value;
+    return this;
+  }
+  extraData(value) {
+    this._extraData = value;
+    return this;
+  }
+  timestamp(value) {
+    this._timestamp = value;
+    return this;
+  }
+  payload(value) {
+    this._payload = value;
+    return this;
+  }
+  schema(input = {}) {
+    const { metadata, payload } = input;
+    if (metadata?.source !== void 0) this.source(metadata.source);
+    if (metadata?.eventType !== void 0) this.eventType(metadata.eventType);
+    if (metadata?.userId !== void 0) this.userId(metadata.userId);
+    if (metadata?.correlationId !== void 0) this.correlationId(metadata.correlationId);
+    if (metadata?.extraData !== void 0) this.extraData(metadata.extraData);
+    if (payload !== void 0) {
+      this._payload = payload;
+    }
+    return this;
+  }
+  build() {
+    assertRequiredFields(
+      {
+        source: this._source,
+        eventType: this._eventType
+      },
+      ["source", "eventType"],
+      "Missing queue metadata fields"
+    );
+    return assembleQueueMessage(
+      {
+        source: this._source,
+        eventType: this._eventType,
+        timestamp: this._timestamp ?? Date.now(),
+        correlationId: this._correlationId ?? generateUUID(),
+        userId: this._userId,
+        extraData: this._extraData
+      },
+      this._payload
+    );
+  }
+};
+
+exports.QueueDTO = QueueDTO;
+exports.assembleQueueMessage = assembleQueueMessage;

package/dist/dto/queue/index.d.ts

@@ -0,0 +1,3 @@
+export type { QueueMetadata, QueueMessageInput, QueueMessage, QueueSchemaInput, IMetadata, IMessageInput, } from './types.js';
+export { assembleQueueMessage } from './assemble.js';
+export { QueueDTO } from './builder.js';