tyforge 0.1.0

package/dist/schema/schema-build.js

@@ -0,0 +1,281 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaBuilder = void 0;
+const validation_exception_1 = require("../exceptions/validation.exception");
+const result_1 = require("../result");
+/** Campo no schema que define VO/Entity ou inline */
+function isFieldConfig(entry) {
+    return entry.type !== undefined;
+}
+const requiredError = (path) => validation_exception_1.ExceptionValidation.create(path, "Campo obrigatório ausente.");
+function compileFields(schema, basePath) {
+    const fields = [];
+    for (const key of Object.keys(schema)) {
+        let entry = schema[key];
+        const path = basePath ? `${basePath}.${key}` : key;
+        // Array syntax [{ type, required }]
+        if (Array.isArray(entry)) {
+            const cfg = entry[0];
+            entry = { type: cfg.type, required: cfg.required, isArray: true };
+        }
+        if (isFieldConfig(entry)) {
+            const t = entry.type;
+            const creatable = t;
+            const isCreatable = typeof creatable.create === "function";
+            const isArray = entry.isArray === true;
+            if (isArray) {
+                fields.push({
+                    key,
+                    path,
+                    required: entry.required !== false,
+                    kind: isCreatable ? 2 /* FieldKind.ArrayCreatable */ : 3 /* FieldKind.ArrayNestedSchema */,
+                    creatable: isCreatable ? creatable : null,
+                    hasAssign: isCreatable && typeof creatable.assign === "function",
+                    nestedValidator: !isCreatable ? { fields: compileFields(t, ""), run: createRunner(t) } : null,
+                });
+            }
+            else {
+                fields.push({
+                    key,
+                    path,
+                    required: entry.required !== false,
+                    kind: isCreatable ? 0 /* FieldKind.Creatable */ : 1 /* FieldKind.NestedSchema */,
+                    creatable: isCreatable ? creatable : null,
+                    hasAssign: isCreatable && typeof creatable.assign === "function",
+                    nestedValidator: !isCreatable ? { fields: compileFields(t, path), run: createRunner(t) } : null,
+                });
+            }
+        }
+        else {
+            // Inline nested object (no {type:...})
+            fields.push({
+                key,
+                path,
+                required: true,
+                kind: 1 /* FieldKind.NestedSchema */,
+                creatable: null,
+                hasAssign: false,
+                nestedValidator: { fields: compileFields(entry, path), run: createRunner(entry) },
+            });
+        }
+    }
+    return fields;
+}
+function createRunner(schema) {
+    let compiled = null;
+    return function run(data, basePath, mode) {
+        if (!compiled)
+            compiled = compileFields(schema, basePath);
+        if (!data || typeof data !== "object") {
+            return (0, result_1.err)(validation_exception_1.ExceptionValidation.create(basePath || "root", "Dados obrigatórios ausentes."));
+        }
+        const dataRecord = data;
+        const props = {};
+        for (let i = 0; i < compiled.length; i++) {
+            const field = compiled[i];
+            const value = dataRecord[field.key];
+            switch (field.kind) {
+                case 0 /* FieldKind.Creatable */: {
+                    if (value === undefined || value === null) {
+                        if (field.required)
+                            return (0, result_1.err)(requiredError(field.path));
+                        continue;
+                    }
+                    const res = mode === "create" || !field.hasAssign
+                        ? field.creatable.create(value, field.path)
+                        : field.creatable.assign(value);
+                    if (!res.success)
+                        return res;
+                    props[field.key] = res.value;
+                    break;
+                }
+                case 2 /* FieldKind.ArrayCreatable */: {
+                    if (value === undefined || value === null) {
+                        if (field.required)
+                            return (0, result_1.err)(requiredError(field.path));
+                        continue;
+                    }
+                    if (!Array.isArray(value)) {
+                        return (0, result_1.err)(validation_exception_1.ExceptionValidation.create(field.path, "Esperado array."));
+                    }
+                    const arr = [];
+                    for (let j = 0; j < value.length; j++) {
+                        const item = value[j];
+                        const idxPath = `${field.path}[${j}]`;
+                        if (field.required && (item === undefined || item === null)) {
+                            return (0, result_1.err)(requiredError(idxPath));
+                        }
+                        const res = mode === "create" || !field.hasAssign
+                            ? field.creatable.create(item, idxPath)
+                            : field.creatable.assign(item);
+                        if (!res.success)
+                            return res;
+                        arr.push(res.value);
+                    }
+                    props[field.key] = arr;
+                    break;
+                }
+                case 1 /* FieldKind.NestedSchema */: {
+                    if (value === undefined || value === null) {
+                        if (field.required)
+                            return (0, result_1.err)(requiredError(field.path));
+                        continue;
+                    }
+                    const nested = field.nestedValidator.run(value, field.path, mode);
+                    if (!nested.success)
+                        return nested;
+                    props[field.key] = nested.value;
+                    break;
+                }
+                case 3 /* FieldKind.ArrayNestedSchema */: {
+                    if (value === undefined || value === null) {
+                        if (field.required)
+                            return (0, result_1.err)(requiredError(field.path));
+                        continue;
+                    }
+                    if (!Array.isArray(value)) {
+                        return (0, result_1.err)(validation_exception_1.ExceptionValidation.create(field.path, "Esperado array."));
+                    }
+                    const arr = [];
+                    for (let j = 0; j < value.length; j++) {
+                        const item = value[j];
+                        const idxPath = `${field.path}[${j}]`;
+                        if (field.required && (item === undefined || item === null)) {
+                            return (0, result_1.err)(requiredError(idxPath));
+                        }
+                        const nested = field.nestedValidator.run(item, idxPath, mode);
+                        if (!nested.success)
+                            return nested;
+                        arr.push(nested.value);
+                    }
+                    props[field.key] = arr;
+                    break;
+                }
+            }
+        }
+        return (0, result_1.ok)(props);
+    };
+}
+class SchemaBuilder {
+    /**
+     * Compila o schema uma vez e retorna um validador otimizado.
+     * Uso: const validator = SchemaBuilder.compile(schema);
+     *      validator.create(data, "user");
+     */
+    static compile(schema) {
+        const runner = createRunner(schema);
+        return {
+            create(data, path = "") {
+                return runner(data, path, "create");
+            },
+            assign(data, path = "") {
+                return runner(data, path, "assign");
+            },
+        };
+    }
+    /**
+     * Constrói props validados a partir de schema e dados JSON (não-compilado, backward compatible)
+     */
+    static build(schema, data, path = "", mode) {
+        const schemaKeys = Object.keys(schema);
+        if (schemaKeys.length > 0) {
+            if (!data || typeof data !== "object") {
+                return (0, result_1.err)(validation_exception_1.ExceptionValidation.create(path || "root", "Dados obrigatórios ausentes."));
+            }
+        }
+        const props = {};
+        for (const key of schemaKeys) {
+            let entry = schema[key];
+            const fieldPath = path ? `${path}.${key}` : key;
+            const value = data[key];
+            // Suporte à sintaxe [ { type, required } ] → converte pra isArray:true
+            if (Array.isArray(entry)) {
+                const cfg = entry[0];
+                entry = {
+                    type: cfg.type,
+                    required: cfg.required,
+                    isArray: true,
+                };
+            }
+            // 1) Campo array (isArray: true)
+            if (isFieldConfig(entry) && entry.isArray) {
+                const arrayReq = entry.required !== false;
+                if (value === undefined || value === null) {
+                    if (arrayReq)
+                        return (0, result_1.err)(requiredError(fieldPath));
+                    continue;
+                }
+                if (!Array.isArray(value))
+                    return (0, result_1.err)(validation_exception_1.ExceptionValidation.create(fieldPath, "Esperado array."));
+                const itemReq = entry.required !== false;
+                const arr = [];
+                for (let i = 0; i < value.length; i++) {
+                    const item = value[i];
+                    const idxPath = `${fieldPath}[${i}]`;
+                    if (itemReq && (item === undefined || item === null)) {
+                        return (0, result_1.err)(requiredError(idxPath));
+                    }
+                    const t = entry.type;
+                    const creatable = t;
+                    if (typeof creatable.create === "function") {
+                        const res = mode === "create"
+                            ? creatable.create(item, idxPath)
+                            : typeof creatable.assign === "function"
+                                ? creatable.assign(item)
+                                : creatable.create(item, idxPath);
+                        if ((0, result_1.isFailure)(res))
+                            return res;
+                        arr.push(res.value);
+                    }
+                    else {
+                        const nested = SchemaBuilder.build(t, item, idxPath, mode);
+                        if ((0, result_1.isFailure)(nested))
+                            return nested;
+                        arr.push(nested.value);
+                    }
+                }
+                props[key] = arr;
+                continue;
+            }
+            // 2) Campo simples (VO/Entity ou inline objeto)
+            if (isFieldConfig(entry)) {
+                const isReq = entry.required !== false;
+                if (value === undefined || value === null) {
+                    if (isReq)
+                        return (0, result_1.err)(requiredError(fieldPath));
+                    continue;
+                }
+                const t = entry.type;
+                const creatableField = t;
+                if (typeof creatableField.create === "function") {
+                    const res = mode === "create"
+                        ? creatableField.create(value, fieldPath)
+                        : typeof creatableField.assign === "function"
+                            ? creatableField.assign(value)
+                            : creatableField.create(value, fieldPath);
+                    if ((0, result_1.isFailure)(res))
+                        return res;
+                    props[key] = res.value;
+                }
+                else {
+                    const nested = SchemaBuilder.build(t, value, fieldPath, mode);
+                    if ((0, result_1.isFailure)(nested))
+                        return nested;
+                    props[key] = nested.value;
+                }
+                continue;
+            }
+            // 3) Objeto aninhado pelo próprio schema (sem {type:...})
+            if (value === undefined || value === null) {
+                return (0, result_1.err)(requiredError(fieldPath));
+            }
+            const nested = SchemaBuilder.build(entry, value, fieldPath, mode);
+            if ((0, result_1.isFailure)(nested))
+                return nested;
+            props[key] = nested.value;
+        }
+        return (0, result_1.ok)(props);
+    }
+}
+exports.SchemaBuilder = SchemaBuilder;
+//# sourceMappingURL=schema-build.js.map

package/dist/schema/schema-build.js.map

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

package/dist/schema/schema-types.d.ts

@@ -0,0 +1,90 @@
+import { Result } from "../tools";
+import { TypeField } from "../type-fields/type-field.base";
+import { Entity, IEntityPropsBase } from "../domain-models/entity.base";
+import { Exceptions } from "../exceptions/base.exceptions";
+/**
+ * Interface para tipos TypeField com método estático `create`
+ */
+export interface ValueObjectStatic<TPrimitive, TInstance extends TypeField<TPrimitive>> {
+    create(value: TPrimitive, fieldPath?: string): Result<TInstance, Exceptions>;
+}
+/**
+ * Interface para entidades que implementam o método `create`
+ */
+export interface EntityStatic<TInstance extends Entity<IEntityPropsBase, unknown>> {
+    create(value: unknown, fieldPath?: string): Result<TInstance, Exceptions>;
+}
+/**
+ * Representa a configuração de um campo do schema.
+ * Se `isArray === true`, o valor de entrada deve ser um array,
+ * e a inferência resultará num array de primitivos/VOs/Entidades.
+ */
+export interface ISchemaFieldConfig {
+    type: ValueObjectStatic<unknown, TypeField<unknown>> | EntityStatic<Entity<IEntityPropsBase, unknown>> | ISchemaInlineObject;
+    required?: boolean;
+    isArray?: boolean;
+    expose?: "public" | "private" | "redacted";
+    label?: string;
+    description?: string;
+}
+/**
+ * Representa um objeto inline de schema, com campos aninhados.
+ */
+export interface ISchemaInlineObject {
+    [key: string]: ISchemaAllowedEntry;
+}
+/**
+ * Tudo que pode aparecer como valor em um schema:
+ * - um field config (com ou sem isArray)
+ * - um objeto inline (aninhado)
+ */
+export type ISchemaAllowedEntry = ISchemaFieldConfig | ISchemaInlineObject;
+/**
+ * EXTRAÇÃO DO PRIMITIVO A PARTIR DO TYPE (para JSON):
+ * - se for VO, pega TPrimitive da classe TypeField
+ * - se for Entity, usa `unknown` (o caller deve especializar)
+ * - se for objeto inline, usa recursão
+ */
+type InferPrimitive<T> = T extends ValueObjectStatic<infer TP, TypeField<infer TP>> ? TP : T extends EntityStatic<Entity<IEntityPropsBase, unknown>> ? unknown : T extends ISchemaInlineObject ? ISchemaInferJson<T> : never;
+/**
+ * MONTA O TIPO DE JSON DE ENTRADA:
+ * - para cada campo, se `isArray` então InferPrimitive[]; senão InferPrimitive
+ * - campos `required: false` viram opcionais (`?`)
+ */
+export type ISchemaInferJson<TSchema extends ISchemaInlineObject> = {
+    [K in keyof TSchema as TSchema[K] extends {
+        required: false;
+    } ? K : never]?: TSchema[K] extends ISchemaFieldConfig ? TSchema[K] extends {
+        isArray: true;
+    } ? InferPrimitive<TSchema[K]["type"]>[] : InferPrimitive<TSchema[K]["type"]> : TSchema[K] extends ISchemaInlineObject ? ISchemaInferJson<TSchema[K]> : never;
+} & {
+    [K in keyof TSchema as TSchema[K] extends {
+        required: false;
+    } ? never : K]: TSchema[K] extends ISchemaFieldConfig ? TSchema[K] extends {
+        isArray: true;
+    } ? InferPrimitive<TSchema[K]["type"]>[] : InferPrimitive<TSchema[K]["type"]> : TSchema[K] extends ISchemaInlineObject ? ISchemaInferJson<TSchema[K]> : never;
+};
+export type EnsureExtends<T extends U, U> = T;
+/**
+ * EXTRAÇÃO DA INSTÂNCIA (VO ou Entity) PARA PROPS:
+ */
+type InferInstance<T> = T extends ValueObjectStatic<unknown, infer TI> ? TI : T extends EntityStatic<infer TE> ? TE : T extends ISchemaInlineObject ? ISchemaInferProps<T> : never;
+/**
+ * MONTA O TIPO FINAL DE PROPS:
+ * - análogo ao ISchemaInferJson, mas usa InferInstance
+ */
+export type ISchemaInferProps<TSchema extends ISchemaInlineObject> = {
+    [K in keyof TSchema as TSchema[K] extends {
+        required: false;
+    } ? K : never]?: TSchema[K] extends ISchemaFieldConfig ? TSchema[K] extends {
+        isArray: true;
+    } ? InferInstance<TSchema[K]["type"]>[] : InferInstance<TSchema[K]["type"]> : TSchema[K] extends ISchemaInlineObject ? ISchemaInferProps<TSchema[K]> : never;
+} & {
+    [K in keyof TSchema as TSchema[K] extends {
+        required: false;
+    } ? never : K]: TSchema[K] extends ISchemaFieldConfig ? TSchema[K] extends {
+        isArray: true;
+    } ? InferInstance<TSchema[K]["type"]>[] : InferInstance<TSchema[K]["type"]> : TSchema[K] extends ISchemaInlineObject ? ISchemaInferProps<TSchema[K]> : never;
+};
+export {};
+//# sourceMappingURL=schema-types.d.ts.map

package/dist/schema/schema-types.d.ts.map

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

package/dist/schema/schema-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema-types.js.map

package/dist/schema/schema-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-types.js","sourceRoot":"","sources":["../../src/schema/schema-types.ts"],"names":[],"mappings":""}

package/dist/tools/formatting/date/date-formatting.tool.d.ts

@@ -0,0 +1,45 @@
+export declare class ToolFormattingDateISO8601 {
+    private static pad;
+    /**
+     * Converte uma data para UTC-3 (Brasília).
+     * Para datas que já estão em UTC (como as vindas de parseDateCompact),
+     * apenas subtrai 3 horas para converter para UTC-3.
+     */
+    private static toUTCMinus3;
+    /**
+     * ISO 8601 com milissegundos e sufixo Z (UTC real).
+     * Exemplo: "2024-04-09T18:00:00.123Z"
+     */
+    static formatDateTimeUTC(value: Date): string;
+    /**
+     * Data e hora no formato ISO 8601 em UTC-3.
+     * Exemplo: "2024-04-09T15:00:00"
+     */
+    static formatDateTime(value: Date): string;
+    /**
+     * Apenas data (YYYY-MM-DD) em UTC-3.
+     * Exemplo: "2024-04-09"
+     */
+    static formatDate(value: Date): string;
+    /**
+     * Data compacta (YYYYMMDD) em UTC.
+     * Exemplo: "20240409"
+     */
+    static formatDateCompact(value: Date): string;
+    /**
+     * Data e hora compacta com separador T em UTC-3.
+     * Exemplo: "20240409T153000"
+     */
+    static formatDateTimeCompactWithT(value: Date): string;
+    /**
+     * Data e hora compacta sem separadores em UTC-3.
+     * Exemplo: "20240409153000"
+     */
+    static formatDateTimeCompact(value: Date): string;
+    /**
+     * Data e hora com milissegundos (ISO8601 Zulu com .sssZ).
+     * Exemplo: "2024-04-09T18:00:00.123Z"
+     */
+    static formatDateTimeZuluWithMillis(value: Date): string;
+}
+//# sourceMappingURL=date-formatting.tool.d.ts.map

package/dist/tools/formatting/date/date-formatting.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-formatting.tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/formatting/date/date-formatting.tool.ts"],"names":[],"mappings":"AAAA,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAC,GAAG;IAIlB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAM1B;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;IAI7C;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;IAY1C;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;IAgBtC;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;IAQ7C;;;OAGG;IACH,MAAM,CAAC,0BAA0B,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;IAYtD;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;IAWjD;;;OAGG;IACH,MAAM,CAAC,4BAA4B,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;CAGzD"}

package/dist/tools/formatting/date/date-formatting.tool.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolFormattingDateISO8601 = void 0;
+class ToolFormattingDateISO8601 {
+    static pad(num) {
+        return num.toString().padStart(2, "0");
+    }
+    /**
+     * Converte uma data para UTC-3 (Brasília).
+     * Para datas que já estão em UTC (como as vindas de parseDateCompact),
+     * apenas subtrai 3 horas para converter para UTC-3.
+     */
+    static toUTCMinus3(date) {
+        // Para datas que vêm de parseDateCompact (que já estão em UTC),
+        // apenas subtraímos 3 horas para converter para UTC-3
+        return new Date(date.getTime() - 3 * 60 * 60 * 1000);
+    }
+    /**
+     * ISO 8601 com milissegundos e sufixo Z (UTC real).
+     * Exemplo: "2024-04-09T18:00:00.123Z"
+     */
+    static formatDateTimeUTC(value) {
+        return value.toISOString();
+    }
+    /**
+     * Data e hora no formato ISO 8601 em UTC-3.
+     * Exemplo: "2024-04-09T15:00:00"
+     */
+    static formatDateTime(value) {
+        const d = ToolFormattingDateISO8601.toUTCMinus3(value);
+        const year = d.getUTCFullYear();
+        const month = ToolFormattingDateISO8601.pad(d.getUTCMonth() + 1);
+        const day = ToolFormattingDateISO8601.pad(d.getUTCDate());
+        const hours = ToolFormattingDateISO8601.pad(d.getUTCHours());
+        const minutes = ToolFormattingDateISO8601.pad(d.getUTCMinutes());
+        const seconds = ToolFormattingDateISO8601.pad(d.getUTCSeconds());
+        return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}`;
+    }
+    /**
+     * Apenas data (YYYY-MM-DD) em UTC-3.
+     * Exemplo: "2024-04-09"
+     */
+    static formatDate(value) {
+        if (!(value instanceof Date) || isNaN(value.getTime())) {
+            throw new Error("Invalid Date input");
+        }
+        // Adjust to UTC-3 by subtracting 3 hours (3 * 60 * 60 * 1000 milliseconds)
+        const utcMinus3 = new Date(value.getTime() - 3 * 60 * 60 * 1000);
+        // Extract year, month, day in UTC
+        const year = utcMinus3.getUTCFullYear();
+        const month = String(utcMinus3.getUTCMonth() + 1).padStart(2, "0");
+        const day = String(utcMinus3.getUTCDate()).padStart(2, "0");
+        return `${year}-${month}-${day}`;
+    }
+    /**
+     * Data compacta (YYYYMMDD) em UTC.
+     * Exemplo: "20240409"
+     */
+    static formatDateCompact(value) {
+        const year = value.getUTCFullYear();
+        const month = ToolFormattingDateISO8601.pad(value.getUTCMonth() + 1);
+        const day = ToolFormattingDateISO8601.pad(value.getUTCDate());
+        return `${year}${month}${day}`;
+    }
+    /**
+     * Data e hora compacta com separador T em UTC-3.
+     * Exemplo: "20240409T153000"
+     */
+    static formatDateTimeCompactWithT(value) {
+        const d = ToolFormattingDateISO8601.toUTCMinus3(value);
+        const year = d.getUTCFullYear();
+        const month = ToolFormattingDateISO8601.pad(d.getUTCMonth() + 1);
+        const day = ToolFormattingDateISO8601.pad(d.getUTCDate());
+        const hours = ToolFormattingDateISO8601.pad(d.getUTCHours());
+        const minutes = ToolFormattingDateISO8601.pad(d.getUTCMinutes());
+        const seconds = ToolFormattingDateISO8601.pad(d.getUTCSeconds());
+        return `${year}${month}${day}T${hours}${minutes}${seconds}`;
+    }
+    /**
+     * Data e hora compacta sem separadores em UTC-3.
+     * Exemplo: "20240409153000"
+     */
+    static formatDateTimeCompact(value) {
+        const d = ToolFormattingDateISO8601.toUTCMinus3(value);
+        const year = d.getUTCFullYear();
+        const month = ToolFormattingDateISO8601.pad(d.getUTCMonth() + 1);
+        const day = ToolFormattingDateISO8601.pad(d.getUTCDate());
+        const hours = ToolFormattingDateISO8601.pad(d.getUTCHours());
+        const minutes = ToolFormattingDateISO8601.pad(d.getUTCMinutes());
+        const seconds = ToolFormattingDateISO8601.pad(d.getUTCSeconds());
+        return `${year}${month}${day}${hours}${minutes}${seconds}`;
+    }
+    /**
+     * Data e hora com milissegundos (ISO8601 Zulu com .sssZ).
+     * Exemplo: "2024-04-09T18:00:00.123Z"
+     */
+    static formatDateTimeZuluWithMillis(value) {
+        return value.toISOString(); // já inclui milissegundos e sufixo Z
+    }
+}
+exports.ToolFormattingDateISO8601 = ToolFormattingDateISO8601;
+//# sourceMappingURL=date-formatting.tool.js.map

package/dist/tools/formatting/date/date-formatting.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-formatting.tool.js","sourceRoot":"","sources":["../../../../src/tools/formatting/date/date-formatting.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+export { TypeGuard } from "./type_guard";
+export { ToolParse } from "./parse/parse.tool";
+export { ToolFormattingDateISO8601 } from "./formatting/date/date-formatting.tool";
+export * from "../result/result";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,cAAc,kBAAkB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolFormattingDateISO8601 = exports.ToolParse = exports.TypeGuard = void 0;
+var type_guard_1 = require("./type_guard");
+Object.defineProperty(exports, "TypeGuard", { enumerable: true, get: function () { return type_guard_1.TypeGuard; } });
+var parse_tool_1 = require("./parse/parse.tool");
+Object.defineProperty(exports, "ToolParse", { enumerable: true, get: function () { return parse_tool_1.ToolParse; } });
+var date_formatting_tool_1 = require("./formatting/date/date-formatting.tool");
+Object.defineProperty(exports, "ToolFormattingDateISO8601", { enumerable: true, get: function () { return date_formatting_tool_1.ToolFormattingDateISO8601; } });
+__exportStar(require("../result/result"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,iDAA+C;AAAtC,uGAAA,SAAS,OAAA;AAClB,+EAAmF;AAA1E,iIAAA,yBAAyB,OAAA;AAClC,mDAAiC"}