tyforge 0.1.0

package/dist/type-fields/type-field.base.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeField = void 0;
+const result_1 = require("../result");
+const type_guard_1 = require("../tools/type_guard");
+const exceptions_1 = require("../exceptions");
+// Cache de Object.values() para evitar alocação repetida
+const enumValuesCache = new WeakMap();
+function getCachedEnumValues(enumObj) {
+    let cached = enumValuesCache.get(enumObj);
+    if (!cached) {
+        cached = Object.values(enumObj);
+        enumValuesCache.set(enumObj, cached);
+    }
+    return cached;
+}
+class TypeField {
+    _value;
+    fieldPath;
+    constructor(_value, fieldPath) {
+        this._value = _value;
+        this.fieldPath = fieldPath;
+    }
+    /**
+     * Resolve um valor de enum, validando por chave e/ou valor conforme config
+     */
+    static resolveEnum(enumObj, raw, fieldPath) {
+        const enumValues = getCachedEnumValues(enumObj);
+        if (enumValues.includes(raw)) {
+            return (0, result_1.ok)(raw);
+        }
+        return (0, result_1.err)(exceptions_1.ExceptionValidation.create(fieldPath, `Valor de enum inválido: ${typeof raw === "string" ? raw : JSON.stringify(raw)}`));
+    }
+    /**
+     * Valida o valor contra o schema configurado
+     */
+    validate(value, fieldPath) {
+        const { jsonSchemaType } = this.config;
+        // Validação de enum se configurado (com cache)
+        if ("validateEnum" in this.config && this.config.validateEnum) {
+            const enumValues = getCachedEnumValues(this.config.validateEnum);
+            if (!enumValues.includes(value)) {
+                return (0, result_1.err)(exceptions_1.ExceptionValidation.create(fieldPath, `Valor deve pertencer ao enum: ${enumValues.join(", ")}`));
+            }
+        }
+        switch (jsonSchemaType) {
+            case "string": {
+                const cfg = this.config;
+                return type_guard_1.TypeGuard.isString(value, fieldPath, cfg.minLength, cfg.maxLength);
+            }
+            case "number": {
+                const cfg = this.config;
+                return type_guard_1.TypeGuard.isNumber(value, fieldPath, cfg.min, cfg.max, cfg.decimalPrecision);
+            }
+            case "boolean":
+                return type_guard_1.TypeGuard.isBoolean(value, fieldPath);
+            case "object":
+                return type_guard_1.TypeGuard.isObject(value, fieldPath);
+            case "array": {
+                const cfg = this.config;
+                return type_guard_1.TypeGuard.isArray(value, fieldPath, cfg.minItems ?? 0, cfg.maxItems ?? Infinity);
+            }
+            case "Date":
+                return type_guard_1.TypeGuard.isDate(value, fieldPath);
+            default:
+                return (0, result_1.err)(exceptions_1.ExceptionValidation.create(fieldPath, `Tipo de valor não suportado: ${typeof jsonSchemaType === "string" ? jsonSchemaType : JSON.stringify(jsonSchemaType)}`));
+        }
+    }
+    /** Retorna o valor primitivo bruto */
+    getValue() {
+        return this._value;
+    }
+    equals(other) {
+        return (!!other &&
+            other.constructor === this.constructor &&
+            other._value === this._value);
+    }
+    toString() {
+        return String(this._value);
+    }
+    toInt() {
+        if (typeof this._value === "number")
+            return (0, result_1.ok)(this._value);
+        if (typeof this._value === "string") {
+            const parsed = parseInt(this._value, 10);
+            if (isNaN(parsed)) {
+                return (0, result_1.err)(exceptions_1.ExceptionValidation.create(this.fieldPath, "Valor não pode ser convertido para inteiro."));
+            }
+            return (0, result_1.ok)(parsed);
+        }
+        return (0, result_1.err)(exceptions_1.ExceptionValidation.create(this.fieldPath, "toInt só pode ser usado com strings ou números."));
+    }
+    getDocumentationAux() {
+        return {
+            value: this.getValue(),
+            formatted: this.formatted(),
+            description: this.getDescription(),
+        };
+    }
+    isEmpty() {
+        return type_guard_1.TypeGuard.isEmpty(this._value);
+    }
+    toJSON() {
+        return this.config.serializeAsString ? this.toString() : this.getValue();
+    }
+}
+exports.TypeField = TypeField;
+//# sourceMappingURL=type-field.base.js.map

package/dist/type-fields/type-field.base.js.map

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

package/dist/type-fields/type-field.config.d.ts

@@ -0,0 +1,44 @@
+export type TJsonSchemaType = "string" | "number" | "boolean" | "object" | "array" | "Date";
+/**
+ * Configurações comuns a todos os TypeField
+ * (interno)
+ */
+interface BaseConfig {
+    jsonSchemaType: TJsonSchemaType;
+    serializeAsString?: boolean;
+}
+interface StringConfig extends BaseConfig {
+    jsonSchemaType: "string";
+    minLength: number;
+    maxLength: number;
+    validateEnum?: Record<string, string>;
+}
+interface NumberConfig extends BaseConfig {
+    jsonSchemaType: "number";
+    min: number;
+    max: number;
+    decimalPrecision: number;
+    validateEnum?: Record<string, number>;
+}
+interface ArrayConfig extends BaseConfig {
+    jsonSchemaType: "array";
+    minItems?: number;
+    maxItems?: number;
+}
+interface BooleanConfig extends BaseConfig {
+    jsonSchemaType: "boolean";
+    validateEnum?: Record<string, boolean>;
+}
+interface ObjectConfig extends BaseConfig {
+    jsonSchemaType: "object";
+}
+interface DateConfig extends BaseConfig {
+    jsonSchemaType: "Date";
+}
+/**
+ * Configuração de validação para TypeField,
+ * exigindo campos conforme o tipo primitivo TPrimitive
+ */
+export type ITypeFieldConfig<TPrimitive> = TPrimitive extends string ? StringConfig : TPrimitive extends number ? NumberConfig : TPrimitive extends unknown[] ? ArrayConfig : TPrimitive extends boolean ? BooleanConfig : TPrimitive extends Date ? DateConfig : TPrimitive extends object ? ObjectConfig : BaseConfig;
+export {};
+//# sourceMappingURL=type-field.config.d.ts.map

package/dist/type-fields/type-field.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-field.config.d.ts","sourceRoot":"","sources":["../../src/type-fields/type-field.config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEX;;;GAGG;AACH,UAAU,UAAU;IAClB,cAAc,EAAE,eAAe,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,YAAa,SAAQ,UAAU;IACvC,cAAc,EAAE,QAAQ,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,UAAU,YAAa,SAAQ,UAAU;IACvC,cAAc,EAAE,QAAQ,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,UAAU,WAAY,SAAQ,UAAU;IACtC,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,aAAc,SAAQ,UAAU;IACxC,cAAc,EAAE,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,UAAU,YAAa,SAAQ,UAAU;IACvC,cAAc,EAAE,QAAQ,CAAC;CAC1B;AAED,UAAU,UAAW,SAAQ,UAAU;IACrC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,CAAC,UAAU,IACrC,UAAU,SAAS,MAAM,GAAG,YAAY,GACxC,UAAU,SAAS,MAAM,GAAG,YAAY,GACxC,UAAU,SAAS,OAAO,EAAE,GAAG,WAAW,GAC1C,UAAU,SAAS,OAAO,GAAG,aAAa,GAC1C,UAAU,SAAS,IAAI,GAAG,UAAU,GACpC,UAAU,SAAS,MAAM,GAAG,YAAY,GACxC,UAAU,CAAC"}

package/dist/type-fields/type-field.config.js

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

package/dist/type-fields/type-field.config.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "tyforge",
+  "version": "0.1.0",
+  "description": "Type-safe schema validation, Result pattern, and DDD building blocks for TypeScript",
+  "keywords": [
+    "typescript",
+    "validation",
+    "schema",
+    "ddd",
+    "result-pattern",
+    "type-fields",
+    "domain-driven-design"
+  ],
+  "author": "Navegar Sistemas",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/navegarsistemas/tyforge"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "uuid": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/uuid": "^10.0.0",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.7.3",
+    "zod": "^4.3.6"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}