@xrystal/dto 26.6.27-v12

package/dist/dto/shared/base-dto.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared contract for every JSON DTO shape in the library.
+ * Each subclass owns field order, required fields at build, and `.schema()` last-wins rules.
+ */
+export declare abstract class BaseDTO<TBody, TSchemaInput> {
+    abstract build(): TBody;
+    /**
+     * Apply partial fields. Last call wins on the chain.
+     * When a nested `payload` key is present, it replaces the entire payload — no merge.
+     */
+    abstract schema(input: TSchemaInput): this;
+}

package/dist/dto/shared/schema-utils.d.ts

@@ -0,0 +1 @@
+export declare function assertRequiredFields(input: Record<string, unknown>, fields: string[], label?: string): void;

package/dist/enums/node-env.d.ts

@@ -0,0 +1,5 @@
+export declare enum NodeEnvEnum {
+    DEV = "dev",
+    TEST = "test",
+    PROD = "prod"
+}

package/dist/errors/codes.d.ts

@@ -0,0 +1,15 @@
+import type { CodeMap, CodeOverrides } from '../types/codes.js';
+export declare const DefaultCodes: {
+    readonly SUCCESS: 0;
+    readonly CLIENT: 1;
+    readonly SERVER: 2;
+    readonly VALIDATION: 3;
+};
+export type DefaultCodeKey = keyof typeof DefaultCodes;
+export declare function createCodeRegistry(overrides?: CodeOverrides): CodeMap;
+export declare function isSuccessCode(code: number, codes: CodeMap): boolean;
+export declare function resolveCodeFromHttpStatus(statusCode: number, codes: CodeMap): number;
+export declare function defaultMessageForCode(code: number, codes: CodeMap): string;
+export declare function resolveStatusFromCode(code: number, codes: CodeMap): boolean;
+export declare function lookupCode(codes: CodeMap, key: string, fallback: number): number;
+export declare function inferHttpStatusFromCode(code: number | undefined, codes: CodeMap): number;

package/dist/errors/error.d.ts

@@ -0,0 +1,32 @@
+import type { CodeOverrides } from '../types/codes.js';
+export interface ResponseErrorOptions {
+    message?: string;
+    code?: number;
+    httpStatus?: number;
+    payload?: Record<string, unknown>;
+    cause?: unknown;
+    codes?: CodeOverrides;
+}
+export declare class ResponseError extends Error {
+    readonly code: number;
+    readonly httpStatus: number;
+    readonly payload?: Record<string, unknown>;
+    constructor(options?: ResponseErrorOptions);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: number;
+        httpStatus: number;
+        payload: Record<string, unknown> | undefined;
+    };
+}
+export declare class ClientError extends ResponseError {
+    constructor(message?: string, options?: Omit<ResponseErrorOptions, 'code' | 'message'>);
+}
+export declare class ServerError extends ResponseError {
+    constructor(message?: string, options?: Omit<ResponseErrorOptions, 'code' | 'message'>);
+}
+export declare class ValidationError extends ResponseError {
+    constructor(message?: string, options?: Omit<ResponseErrorOptions, 'code' | 'message'>);
+}
+export declare function isResponseError(value: unknown): value is ResponseError;

package/dist/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { DefaultCodes, createCodeRegistry, isSuccessCode, resolveCodeFromHttpStatus, defaultMessageForCode, resolveStatusFromCode, inferHttpStatusFromCode, lookupCode, type DefaultCodeKey, } from './codes.js';
+export { ResponseError, ClientError, ServerError, ValidationError, isResponseError, type ResponseErrorOptions, } from './error.js';