digitaltwin-core 0.14.3 → 1.0.0

package/dist/validation/schemas.js.map

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

package/dist/validation/validate.d.ts

@@ -0,0 +1,49 @@
+import vine from '@vinejs/vine';
+type AnyValidator = {
+    validate: (data: unknown) => Promise<unknown>;
+};
+/**
+ * Validates data using a pre-compiled VineJS validator.
+ * @param validator - Compiled VineJS validator
+ * @param data - Data to validate
+ * @param context - Optional context for error messages
+ * @returns Validated and typed data
+ * @throws ValidationError if validation fails
+ */
+export declare function validateData<T>(validator: AnyValidator, data: unknown, context?: string): Promise<T>;
+/**
+ * Validates data and returns result without throwing.
+ * Useful for optional validation or when you want to handle errors manually.
+ * @param validator - Compiled VineJS validator
+ * @param data - Data to validate
+ * @returns Object with success status, data (if valid), or errors (if invalid)
+ */
+export declare function safeValidate<T>(validator: AnyValidator, data: unknown): Promise<{
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: Array<{
+        field: string;
+        message: string;
+    }>;
+}>;
+/**
+ * Validates query parameters, coercing string values to appropriate types.
+ * Query params from Express are always strings, so we need to convert them.
+ * @param validator - Compiled VineJS validator
+ * @param query - Query object from Express request
+ * @param context - Optional context for error messages
+ * @returns Validated and typed query parameters
+ */
+export declare function validateQuery<T>(validator: AnyValidator, query: Record<string, unknown>, context?: string): Promise<T>;
+/**
+ * Validates path parameters (e.g., :id in routes).
+ * @param validator - Compiled VineJS validator
+ * @param params - Params object from Express request
+ * @param context - Optional context for error messages
+ * @returns Validated and typed parameters
+ */
+export declare function validateParams<T>(validator: AnyValidator, params: Record<string, string>, context?: string): Promise<T>;
+export { vine };
+//# sourceMappingURL=validate.d.ts.map

package/dist/validation/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validation/validate.ts"],"names":[],"mappings":"AAAA,OAAO,IAAgB,MAAM,cAAc,CAAA;AAG3C,KAAK,YAAY,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAA;AAErE;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB1G;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAChC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAU7G;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CA6BZ;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAClC,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAGD,OAAO,EAAE,IAAI,EAAE,CAAA"}

package/dist/validation/validate.js

@@ -0,0 +1,110 @@
+import vine, { errors } from '@vinejs/vine';
+import { ValidationError } from '../errors/index.js';
+/**
+ * Validates data using a pre-compiled VineJS validator.
+ * @param validator - Compiled VineJS validator
+ * @param data - Data to validate
+ * @param context - Optional context for error messages
+ * @returns Validated and typed data
+ * @throws ValidationError if validation fails
+ */
+export async function validateData(validator, data, context) {
+    try {
+        const result = await validator.validate(data);
+        return result;
+    }
+    catch (error) {
+        if (error instanceof errors.E_VALIDATION_ERROR) {
+            const messages = error.messages
+                .map((e) => `${e.field}: ${e.message}`)
+                .join(', ');
+            throw new ValidationError(context ? `${context}: ${messages}` : messages, {
+                errors: error.messages
+            });
+        }
+        throw error;
+    }
+}
+/**
+ * Validates data and returns result without throwing.
+ * Useful for optional validation or when you want to handle errors manually.
+ * @param validator - Compiled VineJS validator
+ * @param data - Data to validate
+ * @returns Object with success status, data (if valid), or errors (if invalid)
+ */
+export async function safeValidate(validator, data) {
+    try {
+        const validated = await validator.validate(data);
+        return { success: true, data: validated };
+    }
+    catch (error) {
+        if (error instanceof errors.E_VALIDATION_ERROR) {
+            return { success: false, errors: error.messages };
+        }
+        throw error;
+    }
+}
+/**
+ * Validates query parameters, coercing string values to appropriate types.
+ * Query params from Express are always strings, so we need to convert them.
+ * @param validator - Compiled VineJS validator
+ * @param query - Query object from Express request
+ * @param context - Optional context for error messages
+ * @returns Validated and typed query parameters
+ */
+export async function validateQuery(validator, query, context) {
+    // Coerce query string values to appropriate types
+    const coerced = {};
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === '') {
+            continue; // Skip empty values
+        }
+        if (typeof value === 'string') {
+            // Try to coerce to number
+            const num = Number(value);
+            if (!isNaN(num) && value.trim() !== '') {
+                coerced[key] = num;
+            }
+            // Try to coerce to boolean
+            else if (value.toLowerCase() === 'true') {
+                coerced[key] = true;
+            }
+            else if (value.toLowerCase() === 'false') {
+                coerced[key] = false;
+            }
+            else {
+                coerced[key] = value;
+            }
+        }
+        else {
+            coerced[key] = value;
+        }
+    }
+    return validateData(validator, coerced, context);
+}
+/**
+ * Validates path parameters (e.g., :id in routes).
+ * @param validator - Compiled VineJS validator
+ * @param params - Params object from Express request
+ * @param context - Optional context for error messages
+ * @returns Validated and typed parameters
+ */
+export async function validateParams(validator, params, context) {
+    // Coerce param values (always strings from Express)
+    const coerced = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined)
+            continue;
+        const num = Number(value);
+        if (!isNaN(num) && value.trim() !== '') {
+            coerced[key] = num;
+        }
+        else {
+            coerced[key] = value;
+        }
+    }
+    return validateData(validator, coerced, context);
+}
+// Re-export vine for custom schema creation
+export { vine };
+//# sourceMappingURL=validate.js.map

package/dist/validation/validate.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "digitaltwin-core",
-  "version": "0.14.3",
+  "version": "1.0.0",
   "description": "Minimalist framework to collect and handle data in a Digital Twin project",
   "license": "MIT",
   "author": "Axel Hoffmann",
@@ -23,6 +23,8 @@
     "dev": "tsc --watch",
     "clean": "rimraf dist tsconfig.tsbuildinfo",
     "test": "node -r ./bin/set-test-env.cjs --import ts-node-maintained/register/esm --enable-source-maps bin/test.ts",
+    "test:coverage": "c8 node -r ./bin/set-test-env.cjs --import ts-node-maintained/register/esm --enable-source-maps bin/test.ts",
+    "test:coverage:html": "c8 --reporter=html node -r ./bin/set-test-env.cjs --import ts-node-maintained/register/esm --enable-source-maps bin/test.ts",
     "lint": "eslint src/**/*.ts",
     "lint:fix": "eslint src/**/*.ts --fix",
     "format": "prettier --write \"src/**/*.ts\"",
@@ -56,12 +58,16 @@
     "@japa/assert": "^4.1.0",
     "@japa/runner": "^4.3.0",
     "@testcontainers/redis": "^11.3.1",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/cors": "^2.8.19",
     "@types/ioredis-mock": "^8.2.6",
+    "@types/jsonwebtoken": "^9.0.10",
     "@types/jszip": "^3.4.0",
     "@types/lodash": "^4.17.20",
     "@types/multer": "^2.0.0",
     "@types/uuid": "^10.0.0",
+    "better-sqlite3": "^12.6.0",
+    "c8": "^10.1.3",
     "eslint": "^9.0.0",
     "globals": "^15.0.0",
     "prettier": "^3.0.0",
@@ -92,9 +98,11 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.850.0",
+    "@vinejs/vine": "^4.2.0",
     "bullmq": "^5.56.5",
     "cors": "^2.8.5",
     "ioredis": "^5.6.1",
+    "jsonwebtoken": "^9.0.3",
     "jszip": "^3.10.1",
     "lodash": "^4.17.21",
     "multer": "^2.0.2",