@zintrust/core 0.4.17 → 0.4.19

package/src/templates/TemplateRegistry.js

@@ -0,0 +1,78 @@
+/**
+ * Template Registry
+ * Maps base framework files to their .tpl template equivalents
+ * Sealed namespace pattern for immutability
+ */
+const MAPPINGS = [
+    {
+        basePath: 'src/orm/adapters/SQLiteAdapter.ts',
+        templatePath: 'src/templates/adapters/SQLiteAdapter.ts.tpl',
+        description: 'SQLite database adapter',
+    },
+    {
+        basePath: 'src/orm/adapters/PostgreSQLAdapter.ts',
+        templatePath: 'src/templates/adapters/PostgreSQLAdapter.ts.tpl',
+        description: 'PostgreSQL database adapter',
+    },
+    {
+        basePath: 'src/orm/adapters/MySQLAdapter.ts',
+        templatePath: 'src/templates/adapters/MySQLAdapter.ts.tpl',
+        description: 'MySQL database adapter',
+    },
+    {
+        basePath: 'src/orm/adapters/SQLServerAdapter.ts',
+        templatePath: 'src/templates/adapters/SQLServerAdapter.ts.tpl',
+        description: 'SQL Server database adapter',
+    },
+    {
+        basePath: 'src/auth/Auth.ts',
+        templatePath: 'src/templates/auth/Auth.ts.tpl',
+        description: 'Authentication feature with JWT & bcrypt',
+    },
+    {
+        basePath: 'src/features/Queue.ts',
+        templatePath: 'src/templates/features/Queue.ts.tpl',
+        description: 'Job queue feature',
+    },
+];
+/**
+ * Sealed namespace providing template registry access
+ */
+export const TemplateRegistry = Object.freeze({
+    /**
+     * Get all template mappings
+     */
+    getMappings() {
+        return [...MAPPINGS];
+    },
+    /**
+     * Get a specific mapping by base path
+     */
+    getMapping(basePath) {
+        return MAPPINGS.find((m) => m.basePath === basePath);
+    },
+    /**
+     * Get all base file paths
+     */
+    getBasePaths() {
+        return MAPPINGS.map((m) => m.basePath);
+    },
+    /**
+     * Get all template paths
+     */
+    getTemplatePaths() {
+        return MAPPINGS.map((m) => m.templatePath);
+    },
+    /**
+     * Validate if a base path is in the registry
+     */
+    isRegistered(basePath) {
+        return MAPPINGS.some((m) => m.basePath === basePath);
+    },
+    /**
+     * Get count of registered templates
+     */
+    count() {
+        return MAPPINGS.length;
+    },
+});

package/src/templates/project/basic/app/Middleware/AuthFailureResponder.ts.tpl

@@ -0,0 +1,10 @@
+import type { MiddlewareFailureResponder } from '@zintrust/core';
+
+export const authFailureResponder: MiddlewareFailureResponder = async (_req, res, context) => {
+  res.setStatus(context.statusCode).json({
+    error: {
+      code: context.reason,
+      message: context.message,
+    },
+  });
+};

package/src/templates/project/basic/config/middleware.ts.tpl

@@ -9,6 +9,12 @@ import type { MiddlewaresType } from '@zintrust/core';
  * 2. Import it below.
  * 3. Register route middleware under `route` or append global middleware under `global`.
  * 4. Use the route key in `routes/*.ts`.
+ * 5. Use `responders` when you only want to reshape built-in failure payloads.
+ *
+ * Built-in middleware keys are overrideable by reusing the same key under `route`.
+ * For example, `route.jwt = MyJwtMiddleware` replaces the framework `jwt` middleware
+ * anywhere that key is used, including shared global slots such as `log`, `error`,
+ * `security`, `rateLimit`, `csrf`, and `sanitizeBody`.
  *
  * For custom route keys, extend the framework type locally in your route file:
  * `type AppMiddlewareKey = MiddlewareKey | 'yourMiddleware';`
@@ -16,6 +22,8 @@ import type { MiddlewaresType } from '@zintrust/core';
 
 // Example custom middleware import:
 // import { AuthMiddleware } from '@app/Middleware/AuthMiddleware';
+// import { authFailureResponder } from '@app/Middleware/AuthFailureResponder';
+// import { JwtAuthOverrideMiddleware } from '@app/Middleware/JwtAuthOverrideMiddleware';
 
 export default {
   skipPaths: Env.get('CSRF_SKIP_PATHS', '')
@@ -37,10 +45,20 @@ export default {
     max: 20,
     message: 'Too many user mutation requests, please try again later.',
   },
+  responders: {
+    // auth: authFailureResponder,
+    // jwt: authFailureResponder,
+    // bulletproof: authFailureResponder,
+    // csrf: authFailureResponder,
+    // rateLimit: authFailureResponder,
+    // error: authFailureResponder,
+  },
   global: [
     // AuthMiddleware,
   ],
   route: {
     // authMiddleware: AuthMiddleware,
+    // Plug-and-play built-in override example:
+    // jwt: JwtAuthOverrideMiddleware,
   },
 } as MiddlewaresType;

package/src/testing/TestEnvironment.d.ts

@@ -0,0 +1,40 @@
+import { type IServiceContainer } from '../container/ServiceContainer';
+import { type IKernel } from '../http/Kernel';
+import { type IRouter } from '../routes/Router';
+export type TestHeaders = Record<string, string>;
+export type TestRequestInput = {
+    method: string;
+    path: string;
+    headers?: TestHeaders;
+    body?: unknown;
+    validated?: {
+        body?: unknown;
+        query?: unknown;
+        params?: unknown;
+        headers?: unknown;
+    };
+};
+export type TestResponse = {
+    status: number;
+    headers: Record<string, string | string[]>;
+    bodyText: string;
+    json: unknown;
+    cookies: Record<string, string>;
+};
+export type TestEnvironmentOptions = {
+    router?: IRouter;
+    container?: IServiceContainer;
+    registerRoutes?: (router: IRouter) => void;
+};
+export interface ITestEnvironment {
+    router: IRouter;
+    container: IServiceContainer;
+    kernel: IKernel;
+    request(input: TestRequestInput): Promise<TestResponse>;
+    swapSingleton<T>(key: string, instance: T): () => void;
+    swapFactory<T>(key: string, factory: () => T): () => void;
+}
+export declare const TestEnvironment: Readonly<{
+    create(options?: TestEnvironmentOptions): ITestEnvironment;
+}>;
+//# sourceMappingURL=TestEnvironment.d.ts.map

package/src/testing/TestEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestEnvironment.d.ts","sourceRoot":"","sources":["../../../src/testing/TestEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C,CAAC;AA2HF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxD,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;IACvD,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC;CAC3D;AAED,eAAO,MAAM,eAAe;qBACV,sBAAsB,GAAQ,gBAAgB;EA6C9D,CAAC"}

package/src/testing/TestEnvironment.js

@@ -0,0 +1,141 @@
+import { ServiceContainer } from '../container/ServiceContainer.js';
+import { Kernel } from '../http/Kernel.js';
+import { Request } from '../http/Request.js';
+import { Response } from '../http/Response.js';
+import { Router } from '../routes/Router.js';
+const lowerCaseHeaders = (headers) => {
+    if (!headers)
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(headers))
+        out[k.toLowerCase()] = v;
+    return out;
+};
+const createNodeResStub = () => {
+    const headers = {};
+    let body = '';
+    const raw = {
+        statusCode: 200,
+        writableEnded: false,
+        setHeader(name, value) {
+            headers[name] = value;
+        },
+        end(data) {
+            raw.writableEnded = true;
+            if (data === undefined)
+                return;
+            body += Buffer.isBuffer(data) ? data.toString('utf8') : String(data);
+        },
+    };
+    return { raw, headers, getBody: () => body };
+};
+const parseJsonBody = (raw) => {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+};
+const cookiesFromSetCookieHeader = (setCookie) => {
+    const values = [];
+    if (Array.isArray(setCookie)) {
+        values.push(...setCookie.map(String));
+    }
+    else if (setCookie !== undefined && setCookie !== null) {
+        values.push(String(setCookie));
+    }
+    const result = {};
+    for (const cookie of values) {
+        const firstPart = cookie.split(';')[0] ?? '';
+        const idx = firstPart.indexOf('=');
+        if (idx <= 0)
+            continue;
+        const name = firstPart.slice(0, idx).trim();
+        const value = firstPart.slice(idx + 1).trim();
+        if (name !== '')
+            result[name] = value;
+    }
+    return result;
+};
+const createOverridableContainer = (base) => {
+    const overrides = new Map();
+    const swapSingleton = (key, instance) => {
+        overrides.set(key, { kind: 'singleton', value: instance });
+        return () => {
+            overrides.delete(key);
+        };
+    };
+    const swapFactory = (key, factory) => {
+        overrides.set(key, { kind: 'factory', factory });
+        return () => {
+            overrides.delete(key);
+        };
+    };
+    return {
+        bind: (key, factory) => base.bind(key, factory),
+        singleton: (key, factoryOrInstance) => base.singleton(key, factoryOrInstance),
+        resolve: (key) => {
+            const override = overrides.get(key);
+            if (override) {
+                return (override.kind === 'singleton' ? override.value : override.factory());
+            }
+            return base.resolve(key);
+        },
+        has: (key) => overrides.has(key) || base.has(key),
+        get: (key) => {
+            const override = overrides.get(key);
+            if (override) {
+                return (override.kind === 'singleton' ? override.value : override.factory());
+            }
+            return base.get(key);
+        },
+        flush: () => {
+            overrides.clear();
+            base.flush();
+        },
+        swapSingleton,
+        swapFactory,
+    };
+};
+export const TestEnvironment = Object.freeze({
+    create(options = {}) {
+        const router = options.router ?? Router.createRouter();
+        if (typeof options.registerRoutes === 'function')
+            options.registerRoutes(router);
+        const baseContainer = options.container ?? ServiceContainer.create();
+        const container = createOverridableContainer(baseContainer);
+        const kernel = Kernel.create(router, container);
+        return {
+            router,
+            container,
+            kernel,
+            async request(input) {
+                const nodeReq = {
+                    method: input.method,
+                    url: input.path,
+                    headers: lowerCaseHeaders(input.headers),
+                };
+                const nodeRes = createNodeResStub();
+                const req = Request.create(nodeReq);
+                if (input.body !== undefined)
+                    req.setBody(input.body);
+                if (input.validated !== undefined)
+                    req.validated = input.validated;
+                const res = Response.create(nodeRes.raw);
+                await kernel.handleRequest(req, res);
+                const bodyText = nodeRes.getBody();
+                const headers = nodeRes.headers;
+                return {
+                    status: nodeRes.raw.statusCode,
+                    headers,
+                    bodyText,
+                    json: parseJsonBody(bodyText),
+                    cookies: cookiesFromSetCookieHeader(headers['Set-Cookie']),
+                };
+            },
+            swapSingleton: container.swapSingleton,
+            swapFactory: container.swapFactory,
+        };
+    },
+});

package/src/testing/TestHttp.d.ts

@@ -0,0 +1,29 @@
+import { type IRequest, type ValidatedRequest } from '../http/Request';
+import type { IResponse } from '../http/Response';
+export type TestHttpRequestInput = {
+    method?: string;
+    path?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    params?: Record<string, string>;
+    validated?: IRequest['validated'];
+    context?: Record<string, unknown>;
+};
+export type TestHttpResponseRecorder = IResponse & {
+    getBodyText: () => string;
+    getJson: () => unknown;
+    getHeaders: () => Record<string, string | string[]>;
+};
+export declare const TestHttp: Readonly<{
+    createRequest(input?: TestHttpRequestInput): IRequest;
+    createValidatedRequest<TBody = unknown, TQuery = unknown, TParams = unknown, THeaders = unknown>(input: Omit<TestHttpRequestInput, "validated"> & {
+        validated: {
+            body: TBody;
+            query: TQuery;
+            params: TParams;
+            headers: THeaders;
+        };
+    }): ValidatedRequest<TBody, TQuery, TParams, THeaders>;
+    createResponseRecorder(): TestHttpResponseRecorder;
+}>;
+//# sourceMappingURL=TestHttp.d.ts.map

package/src/testing/TestHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestHttp.d.ts","sourceRoot":"","sources":["../../../src/testing/TestHttp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG;IACjD,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CACrD,CAAC;AAWF,eAAO,MAAM,QAAQ;0BACE,oBAAoB,GAAQ,QAAQ;2BAoBlC,KAAK,YAAY,MAAM,YAAY,OAAO,YAAY,QAAQ,mBAC5E,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAAG;QAC/C,SAAS,EAAE;YACT,IAAI,EAAE,KAAK,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,OAAO,CAAC;YAChB,OAAO,EAAE,QAAQ,CAAC;SACnB,CAAC;KACH,GACA,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;8BAS3B,wBAAwB;EAiElD,CAAC"}

package/src/testing/TestHttp.js

@@ -0,0 +1,96 @@
+import { Request } from '../http/Request.js';
+const lowerCaseHeaders = (headers) => {
+    if (!headers)
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(headers))
+        out[k.toLowerCase()] = v;
+    return out;
+};
+const isError = (v) => v instanceof Error;
+export const TestHttp = Object.freeze({
+    createRequest(input = {}) {
+        const nodeReq = {
+            method: input.method ?? 'GET',
+            url: input.path ?? '/',
+            headers: lowerCaseHeaders(input.headers),
+        };
+        const req = Request.create(nodeReq);
+        if (input.body !== undefined)
+            req.setBody(input.body);
+        if (input.params !== undefined)
+            req.setParams(input.params);
+        const validated = input.validated;
+        if (validated !== undefined && validated !== null && !isError(validated)) {
+            req.validated = validated;
+        }
+        if (input.context !== undefined)
+            req.context = input.context;
+        return req;
+    },
+    createValidatedRequest(input) {
+        const req = this.createRequest({
+            ...input,
+            validated: input.validated,
+        });
+        return req;
+    },
+    createResponseRecorder() {
+        let statusCodeValue = 200;
+        let bodyText = '';
+        let jsonBody;
+        const headers = {};
+        const raw = {
+            statusCode: statusCodeValue,
+            writableEnded: false,
+            setHeader: (name, value) => {
+                headers[name] = value;
+            },
+            end: (data) => {
+                raw.writableEnded = true;
+                if (data === undefined)
+                    return;
+                bodyText += Buffer.isBuffer(data) ? data.toString('utf8') : String(data);
+            },
+        };
+        const res = {
+            locals: {},
+            status: (code) => res.setStatus(code),
+            setStatus: (code) => {
+                statusCodeValue = code;
+                raw.statusCode = code;
+                return res;
+            },
+            getStatus: () => statusCodeValue,
+            get statusCode() {
+                return statusCodeValue;
+            },
+            setHeader: (name, value) => {
+                headers[name] = value;
+                return res;
+            },
+            getHeader: (name) => headers[name],
+            json: (data) => {
+                jsonBody = data;
+                bodyText = JSON.stringify(data);
+            },
+            text: (text) => {
+                bodyText = text;
+            },
+            html: (html) => {
+                bodyText = html;
+            },
+            send: (data) => {
+                bodyText = Buffer.isBuffer(data) ? data.toString('utf8') : String(data);
+            },
+            redirect: (_url, code = 302) => {
+                statusCodeValue = code;
+            },
+            getRaw: () => raw,
+            getBodyText: () => bodyText,
+            getJson: () => jsonBody,
+            getHeaders: () => ({ ...headers }),
+        };
+        return res;
+    },
+});

package/src/testing/index.d.ts

@@ -0,0 +1,5 @@
+export { TestEnvironment } from '../testing/TestEnvironment';
+export type { ITestEnvironment, TestEnvironmentOptions, TestHeaders, TestRequestInput, TestResponse, } from '../testing/TestEnvironment';
+export { TestHttp } from '../testing/TestHttp';
+export type { TestHttpRequestInput, TestHttpResponseRecorder } from '../testing/TestHttp';
+//# sourceMappingURL=index.d.ts.map

package/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,YAAY,GACb,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC"}

package/src/testing/index.js

@@ -0,0 +1,2 @@
+export { TestEnvironment } from '../testing/TestEnvironment.js';
+export { TestHttp } from '../testing/TestHttp.js';

package/src/time/DateTime.d.ts

@@ -0,0 +1,181 @@
+/**
+ * DateTime - Immutable Date/Time Utilities
+ * Provides chainable, type-safe date/time operations with multiple format support
+ */
+/**
+ * DateTime interface defining all available operations
+ */
+export interface IDateTime {
+    /**
+     * Get the underlying Date object
+     */
+    toDate(): Date;
+    /**
+     * Format the date using pattern tokens
+     * Supported tokens: YYYY, YY, MMMM, MMM, MM, M, DD, D, HH, H, mm, ss, SSS
+     */
+    format(pattern: string): string;
+    /**
+     * Convert to ISO 8601 string (YYYY-MM-DDTHH:mm:ss.sssZ)
+     */
+    toISO(): string;
+    /**
+     * Convert to RFC 3339 string (same as ISO 8601)
+     */
+    toRFC3339(): string;
+    /**
+     * Get human-readable relative time (e.g., "2 hours ago", "in 3 days")
+     */
+    ago(): string;
+    /**
+     * Get relative time from a specific date
+     */
+    relative(other: Date | IDateTime): string;
+    /**
+     * Add days to the date (returns new IDateTime)
+     */
+    addDays(days: number): IDateTime;
+    /**
+     * Add hours to the date (returns new IDateTime)
+     */
+    addHours(hours: number): IDateTime;
+    /**
+     * Add minutes to the date (returns new IDateTime)
+     */
+    addMinutes(minutes: number): IDateTime;
+    /**
+     * Add seconds to the date (returns new IDateTime)
+     */
+    addSeconds(seconds: number): IDateTime;
+    /**
+     * Add months to the date (returns new IDateTime)
+     */
+    addMonths(months: number): IDateTime;
+    /**
+     * Add years to the date (returns new IDateTime)
+     */
+    addYears(years: number): IDateTime;
+    /**
+     * Check if this date is before another date
+     */
+    isBefore(other: Date | IDateTime): boolean;
+    /**
+     * Check if this date is after another date
+     */
+    isAfter(other: Date | IDateTime): boolean;
+    /**
+     * Check if this date is the same as another date (ignoring time)
+     */
+    isSame(other: Date | IDateTime): boolean;
+    /**
+     * Check if this date is between two dates (inclusive)
+     */
+    isBetween(start: Date | IDateTime, end: Date | IDateTime): boolean;
+    /**
+     * Get difference in milliseconds from another date
+     */
+    diffMs(other: Date | IDateTime): number;
+    /**
+     * Get difference in seconds from another date
+     */
+    diffSeconds(other: Date | IDateTime): number;
+    /**
+     * Get difference in minutes from another date
+     */
+    diffMinutes(other: Date | IDateTime): number;
+    /**
+     * Get difference in hours from another date
+     */
+    diffHours(other: Date | IDateTime): number;
+    /**
+     * Get difference in days from another date
+     */
+    diffDays(other: Date | IDateTime): number;
+    /**
+     * Start of day (00:00:00)
+     */
+    startOfDay(): IDateTime;
+    /**
+     * End of day (23:59:59)
+     */
+    endOfDay(): IDateTime;
+    /**
+     * Start of month
+     */
+    startOfMonth(): IDateTime;
+    /**
+     * End of month
+     */
+    endOfMonth(): IDateTime;
+    /**
+     * Clone this datetime
+     */
+    clone(): IDateTime;
+    /**
+     * Get Unix timestamp (milliseconds since epoch)
+     */
+    getTime(): number;
+    /**
+     * Get year
+     */
+    getYear(): number;
+    /**
+     * Get month (0-11)
+     */
+    getMonth(): number;
+    /**
+     * Get day of month (1-31)
+     */
+    getDate(): number;
+    /**
+     * Get hours (0-23)
+     */
+    getHours(): number;
+    /**
+     * Get minutes (0-59)
+     */
+    getMinutes(): number;
+    /**
+     * Get seconds (0-59)
+     */
+    getSeconds(): number;
+    /**
+     * Get milliseconds (0-999)
+     */
+    getMilliseconds(): number;
+    /**
+     * Get day of week (0=Sunday, 6=Saturday)
+     */
+    getDayOfWeek(): number;
+    /**
+     * Get day of year (1-366)
+     */
+    getDayOfYear(): number;
+}
+/**
+ * DateTime namespace - sealed namespace object grouping all DateTime operations
+ * Immutable by design - all operations return new IDateTime instances
+ */
+export declare const DateTime: Readonly<{
+    /**
+     * Create a DateTime from a Date object
+     */
+    create(date?: Date): IDateTime;
+    /**
+     * Get current DateTime
+     */
+    now(): IDateTime;
+    /**
+     * Parse a date string
+     */
+    parse(dateString: string): IDateTime;
+    /**
+     * Create DateTime from timestamp (milliseconds since epoch)
+     */
+    fromTimestamp(timestamp: number): IDateTime;
+    /**
+     * Create DateTime from components
+     */
+    fromComponents(year: number, month: number, day?: number, hours?: number, minutes?: number, seconds?: number): IDateTime;
+}>;
+//# sourceMappingURL=DateTime.d.ts.map

package/src/time/DateTime.d.ts.map

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