@aifabrix/miso-client 3.4.2 → 3.8.0

package/dist/utils/environment-token.js

@@ -27,37 +27,27 @@ async function getEnvironmentToken(misoClient, req) {
         // Log error and audit event before throwing (never call controller if origin invalid)
         const errorMessage = `Origin validation failed: ${validation.error}`;
         const origin = req.headers.origin || req.headers.referer || "unknown";
-        // Log error
-        await misoClient.log.error(errorMessage, {
-            origin,
-            allowedOrigins: allowedOrigins || [],
-            ipAddress: req.ip || req.socket.remoteAddress,
-            userAgent: req.headers["user-agent"],
-        }, undefined, {
-            requestId: req.headers["x-request-id"],
-            correlationId: req.headers["x-correlation-id"],
-        });
-        // Log audit event (ISO 27001 compliance)
-        await misoClient.log.audit("client.token.request.rejected", "environment-token", {
-            reason: "origin_validation_failed",
-            origin,
-            allowedOrigins: allowedOrigins || [],
-            ipAddress: req.ip || req.socket?.remoteAddress,
-            userAgent: req.headers["user-agent"],
-        }, {
-            requestId: req.headers["x-request-id"],
-            correlationId: req.headers["x-correlation-id"],
-        });
+        // Log error with full request context (automatic extraction via forRequest)
+        await misoClient.log
+            .forRequest(req) // Auto-extracts: IP, method, path, userAgent, correlationId, userId
+            .addContext("origin", origin)
+            .addContext("allowedOrigins", allowedOrigins || [])
+            .addContext("reason", "origin_validation_failed")
+            .error(errorMessage);
+        // Log audit event (ISO 27001 compliance) with full request context
+        await misoClient.log
+            .forRequest(req)
+            .addContext("reason", "origin_validation_failed")
+            .addContext("origin", origin)
+            .addContext("allowedOrigins", allowedOrigins || [])
+            .audit("client.token.request.rejected", "environment-token");
         throw new Error(errorMessage);
     }
     // Origin is valid, proceed with token fetch
     try {
         // Fetch token from controller
         // Use resolveControllerUrl to properly resolve URL (handles controllerPrivateUrl/controllerPublicUrl/controllerUrl)
-        const controllerUrl = (0, controller_url_resolver_1.resolveControllerUrl)(config);
-        const tokenUri = config.clientTokenUri || "/api/v1/auth/token";
-        const fullUrl = `${controllerUrl}${tokenUri}`;
-        console.log(`[getEnvironmentToken] Fetching token from controller: ${fullUrl}`);
+        (0, controller_url_resolver_1.resolveControllerUrl)(config); // Resolve URL for validation
         const token = await misoClient.getEnvironmentToken();
         // Log audit event with masked client credentials (ISO 27001 compliance)
         const maskedClientId = data_masker_1.DataMasker.maskSensitiveData({
@@ -68,16 +58,13 @@ async function getEnvironmentToken(misoClient, req) {
                 clientSecret: config.clientSecret,
             })
             : { clientSecret: undefined };
-        await misoClient.log.audit("client.token.request.success", "environment-token", {
-            clientId: maskedClientId.clientId,
-            clientSecret: maskedClientSecret.clientSecret,
-            origin: req.headers.origin || req.headers.referer || "unknown",
-            ipAddress: req.ip || req.socket?.remoteAddress,
-            userAgent: req.headers["user-agent"],
-        }, {
-            requestId: req.headers["x-request-id"],
-            correlationId: req.headers["x-correlation-id"],
-        });
+        // Log audit event with full request context (automatic extraction via forRequest)
+        await misoClient.log
+            .forRequest(req) // Auto-extracts: IP, method, path, userAgent, correlationId, userId
+            .addContext("clientId", maskedClientId.clientId)
+            .addContext("clientSecret", maskedClientSecret.clientSecret)
+            .addContext("origin", req.headers.origin || req.headers.referer || "unknown")
+            .audit("client.token.request.success", "environment-token");
         return token;
     }
     catch (error) {
@@ -86,28 +73,21 @@ async function getEnvironmentToken(misoClient, req) {
         const maskedClientId = data_masker_1.DataMasker.maskSensitiveData({
             clientId: config.clientId,
         });
-        // Log error
-        await misoClient.log.error(`Failed to get environment token: ${errorMessage}`, {
-            clientId: maskedClientId.clientId,
-            origin: req.headers.origin || req.headers.referer || "unknown",
-            ipAddress: req.ip || req.socket.remoteAddress,
-            userAgent: req.headers["user-agent"],
-        }, error instanceof Error ? error.stack : undefined, {
-            requestId: req.headers["x-request-id"],
-            correlationId: req.headers["x-correlation-id"],
-        });
-        // Log audit event (ISO 27001 compliance)
-        await misoClient.log.audit("client.token.request.failed", "environment-token", {
-            reason: "token_fetch_failed",
-            error: errorMessage,
-            clientId: maskedClientId.clientId,
-            origin: req.headers.origin || req.headers.referer || "unknown",
-            ipAddress: req.ip || req.socket?.remoteAddress,
-            userAgent: req.headers["user-agent"],
-        }, {
-            requestId: req.headers["x-request-id"],
-            correlationId: req.headers["x-correlation-id"],
-        });
+        // Log error with full request context (automatic extraction via forRequest)
+        await misoClient.log
+            .forRequest(req) // Auto-extracts: IP, method, path, userAgent, correlationId, userId
+            .addContext("clientId", maskedClientId.clientId)
+            .addContext("origin", req.headers.origin || req.headers.referer || "unknown")
+            .addContext("reason", "token_fetch_failed")
+            .error(`Failed to get environment token: ${errorMessage}`, error instanceof Error ? error.stack : undefined);
+        // Log audit event (ISO 27001 compliance) with full request context
+        await misoClient.log
+            .forRequest(req)
+            .addContext("reason", "token_fetch_failed")
+            .addContext("error", errorMessage)
+            .addContext("clientId", maskedClientId.clientId)
+            .addContext("origin", req.headers.origin || req.headers.referer || "unknown")
+            .audit("client.token.request.failed", "environment-token");
         throw error;
     }
 }

package/dist/utils/environment-token.js.map

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

package/dist/utils/error-extractor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Error extraction utility for structured error information
+ * Extracts error details from all error types for enhanced logging
+ */
+/**
+ * Structured error information extracted from any error type
+ */
+export interface StructuredErrorInfo {
+    errorType: string;
+    errorName: string;
+    message: string;
+    statusCode?: number;
+    correlationId?: string;
+    endpoint?: string;
+    method?: string;
+    responseBody?: Record<string, unknown>;
+    responseHeaders?: Record<string, string>;
+    stackTrace?: string;
+    originalError?: Error;
+}
+/**
+ * Options for error extraction
+ */
+export interface ErrorExtractionOptions {
+    endpoint?: string;
+    method?: string;
+    correlationId?: string;
+}
+/**
+ * Extract structured error information from any error type
+ * Supports: MisoClientError, ApiError, AuthenticationError, NetworkError, TimeoutError, and generic Error
+ *
+ * @param error - Error object of any type
+ * @param options - Optional extraction options (endpoint, method, correlationId)
+ * @returns Structured error information
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await apiCall();
+ * } catch (error) {
+ *   const errorInfo = extractErrorInfo(error, {
+ *     endpoint: '/api/users',
+ *     method: 'POST',
+ *     correlationId: 'req-123'
+ *   });
+ *   logErrorWithContext(errorInfo, '[ApiClass]');
+ * }
+ * ```
+ */
+export declare function extractErrorInfo(error: unknown, options?: ErrorExtractionOptions): StructuredErrorInfo;
+//# sourceMappingURL=error-extractor.d.ts.map

package/dist/utils/error-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/error-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,sBAAsB,GAC/B,mBAAmB,CA0GrB"}

package/dist/utils/error-extractor.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Error extraction utility for structured error information
+ * Extracts error details from all error types for enhanced logging
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractErrorInfo = extractErrorInfo;
+const errors_1 = require("./errors");
+const data_client_types_1 = require("../types/data-client.types");
+/**
+ * Extract structured error information from any error type
+ * Supports: MisoClientError, ApiError, AuthenticationError, NetworkError, TimeoutError, and generic Error
+ *
+ * @param error - Error object of any type
+ * @param options - Optional extraction options (endpoint, method, correlationId)
+ * @returns Structured error information
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await apiCall();
+ * } catch (error) {
+ *   const errorInfo = extractErrorInfo(error, {
+ *     endpoint: '/api/users',
+ *     method: 'POST',
+ *     correlationId: 'req-123'
+ *   });
+ *   logErrorWithContext(errorInfo, '[ApiClass]');
+ * }
+ * ```
+ */
+function extractErrorInfo(error, options) {
+    const errorInfo = {
+        errorType: "Unknown",
+        errorName: "Error",
+        message: "Unknown error",
+        endpoint: options?.endpoint,
+        method: options?.method,
+        correlationId: options?.correlationId,
+    };
+    // Handle MisoClientError
+    if (error instanceof errors_1.MisoClientError) {
+        errorInfo.errorType = "MisoClientError";
+        errorInfo.errorName = error.name;
+        errorInfo.message = error.message;
+        errorInfo.statusCode = error.statusCode;
+        errorInfo.stackTrace = error.stack;
+        // Extract correlation ID from error response if available
+        // Note: correlationId may be in errorResponse or errorBody
+        if (error.errorResponse && 'correlationId' in error.errorResponse) {
+            errorInfo.correlationId =
+                errorInfo.correlationId || error.errorResponse.correlationId;
+        }
+        // Extract response body if available
+        if (error.errorResponse) {
+            errorInfo.responseBody = {
+                errors: error.errorResponse.errors,
+                type: error.errorResponse.type,
+                title: error.errorResponse.title,
+                statusCode: error.errorResponse.statusCode,
+                instance: error.errorResponse.instance,
+                correlationId: error.errorResponse.correlationId,
+            };
+        }
+        else if (error.errorBody) {
+            errorInfo.responseBody = error.errorBody;
+        }
+    }
+    // Handle ApiError and subclasses
+    else if (error instanceof data_client_types_1.ApiError) {
+        errorInfo.errorType = error.name;
+        errorInfo.errorName = error.name;
+        errorInfo.message = error.message;
+        errorInfo.statusCode = error.statusCode;
+        errorInfo.stackTrace = error.stack;
+        errorInfo.originalError = error.originalError;
+        // Extract response body if available
+        if (error.response) {
+            try {
+                // Note: Response body extraction would need to clone response
+                // For now, we'll extract what we can from the error
+                errorInfo.responseBody = {
+                    status: error.statusCode,
+                    message: error.message,
+                };
+            }
+            catch (e) {
+                // Ignore extraction errors
+            }
+        }
+    }
+    // Handle AuthenticationError
+    else if (error instanceof data_client_types_1.AuthenticationError) {
+        errorInfo.errorType = "AuthenticationError";
+        errorInfo.errorName = error.name;
+        errorInfo.message = error.message;
+        errorInfo.statusCode = 401;
+        errorInfo.stackTrace = error.stack;
+    }
+    // Handle NetworkError
+    else if (error instanceof data_client_types_1.NetworkError) {
+        errorInfo.errorType = "NetworkError";
+        errorInfo.errorName = error.name;
+        errorInfo.message = error.message;
+        errorInfo.statusCode = 0;
+        errorInfo.stackTrace = error.stack;
+    }
+    // Handle TimeoutError
+    else if (error instanceof data_client_types_1.TimeoutError) {
+        errorInfo.errorType = "TimeoutError";
+        errorInfo.errorName = error.name;
+        errorInfo.message = error.message;
+        errorInfo.statusCode = 408;
+        errorInfo.stackTrace = error.stack;
+    }
+    // Handle generic Error
+    else if (error instanceof Error) {
+        errorInfo.errorType = "Error";
+        errorInfo.errorName = error.name;
+        errorInfo.message = error.message;
+        errorInfo.stackTrace = error.stack;
+    }
+    // Handle unknown error types
+    else {
+        errorInfo.errorType = "Unknown";
+        errorInfo.errorName = "UnknownError";
+        errorInfo.message =
+            typeof error === "string"
+                ? error
+                : error && typeof error === "object" && "message" in error
+                    ? String(error.message)
+                    : "Unknown error occurred";
+    }
+    return errorInfo;
+}
+//# sourceMappingURL=error-extractor.js.map

package/dist/utils/error-extractor.js.map

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

package/dist/utils/filter.utils.d.ts

@@ -5,23 +5,135 @@ import type { FilterOption, FilterQuery } from "../types/filter.types";
 import { FilterBuilder } from "../types/filter.types";
 /**
  * Parse filter query parameters into structured FilterOption array.
- * Supports format: `?filter=field:op:value` or `?filter[]=field:op:value&filter[]=...`
+ * Supports JSON format: object, JSON string, or URL-encoded JSON string.
+ *
  * @param query - Query parameters object (e.g., from URLSearchParams or request query)
  * @returns Array of parsed filter options
+ * @throws Error if filter format is invalid
+ *
+ * @example
+ * ```typescript
+ * // Direct object format
+ * parseFilterParams({ filter: { status: { eq: 'active' } } });
+ *
+ * // JSON string format
+ * parseFilterParams({ filter: '{"status": {"eq": "active"}}' });
+ *
+ * // URL-encoded JSON (from query string)
+ * parseFilterParams({ filter: '%7B%22status%22%3A%7B%22eq%22%3A%22active%22%7D%7D' });
+ *
+ * // Multiple filters with null checks
+ * parseFilterParams({
+ *   filter: {
+ *     status: { eq: 'active' },
+ *     deletedAt: { isNull: null },
+ *     region: { in: ['eu', 'us'] }
+ *   }
+ * });
+ * ```
  */
 export declare function parseFilterParams(query: Record<string, unknown>): FilterOption[];
 /**
- * Build query string from FilterQuery object.
+ * Build query string from FilterQuery object using JSON format for filters.
+ *
  * @param options - FilterQuery object with filters, sort, pagination, and field selection
- * @returns Query string (e.g., `?filter=status:eq:active&sort=-updated_at&page=1&page_size=25`)
+ * @returns Query string with URL-encoded JSON filter format
+ *
+ * @example
+ * ```typescript
+ * buildQueryString({
+ *   filters: [
+ *     { field: 'status', op: 'eq', value: 'active' },
+ *     { field: 'age', op: 'gte', value: 18 }
+ *   ],
+ *   sort: ['-updated_at'],
+ *   page: 1,
+ *   pageSize: 25
+ * });
+ * // Returns: "filter=%7B%22status%22%3A%7B%22eq%22%3A%22active%22%7D%2C%22age%22%3A%7B%22gte%22%3A18%7D%7D&sort=-updated_at&page=1&page_size=25"
+ * ```
  */
 export declare function buildQueryString(options: FilterQuery): string;
 /**
  * Apply filters locally to an array (used for mocks/tests).
+ * Supports all operators including isNull and isNotNull.
+ *
  * @param data - Array of items to filter
  * @param filters - Array of filter options to apply
  * @returns Filtered array
+ *
+ * @example
+ * ```typescript
+ * const items = [
+ *   { id: 1, status: 'active', deletedAt: null },
+ *   { id: 2, status: 'inactive', deletedAt: '2024-01-01' }
+ * ];
+ *
+ * applyFilters(items, [
+ *   { field: 'status', op: 'eq', value: 'active' },
+ *   { field: 'deletedAt', op: 'isNull', value: null }
+ * ]);
+ * ```
  */
 export declare function applyFilters<T extends Record<string, unknown>>(data: T[], filters: FilterOption[]): T[];
+/**
+ * Validate JSON filter structure.
+ *
+ * @param filter - Filter object to validate
+ * @throws Error if filter structure is invalid
+ *
+ * @example
+ * ```typescript
+ * // Valid filter
+ * validateJsonFilter({ status: { eq: 'active' } });
+ *
+ * // Invalid - throws error
+ * validateJsonFilter({ status: 'active' }); // Error: must have operator dictionary
+ * ```
+ */
+export declare function validateJsonFilter(filter: unknown): void;
+/**
+ * Convert FilterQuery to JSON filter format.
+ * Useful for serialization and debugging.
+ *
+ * @param filterQuery - FilterQuery object to convert
+ * @returns JSON filter object (e.g., {"status": {"eq": "active"}})
+ *
+ * @example
+ * ```typescript
+ * filterQueryToJson({
+ *   filters: [
+ *     { field: 'status', op: 'eq', value: 'active' },
+ *     { field: 'age', op: 'gte', value: 18 }
+ *   ]
+ * });
+ * // Returns: { status: { eq: 'active' }, age: { gte: 18 } }
+ * ```
+ */
+export declare function filterQueryToJson(filterQuery: FilterQuery): Record<string, Record<string, unknown>>;
+/**
+ * Convert JSON filter format to FilterQuery.
+ * Convenience wrapper around parseFilterParams().
+ *
+ * @param jsonFilter - JSON filter object (e.g., {"status": {"eq": "active"}})
+ * @returns FilterQuery object
+ *
+ * @example
+ * ```typescript
+ * jsonToFilterQuery({
+ *   status: { eq: 'active' },
+ *   age: { gte: 18 },
+ *   region: { in: ['eu', 'us'] }
+ * });
+ * // Returns: {
+ * //   filters: [
+ * //     { field: 'status', op: 'eq', value: 'active' },
+ * //     { field: 'age', op: 'gte', value: 18 },
+ * //     { field: 'region', op: 'in', value: ['eu', 'us'] }
+ * //   ]
+ * // }
+ * ```
+ */
+export declare function jsonToFilterQuery(jsonFilter: Record<string, Record<string, unknown>>): FilterQuery;
 export { FilterBuilder };
 //# sourceMappingURL=filter.utils.d.ts.map

package/dist/utils/filter.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.utils.d.ts","sourceRoot":"","sources":["../../src/utils/filter.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAKtD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,YAAY,EAAE,CAyBhB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAoB7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,YAAY,EAAE,GACtB,CAAC,EAAE,CAkCL;AAGD,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"filter.utils.d.ts","sourceRoot":"","sources":["../../src/utils/filter.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAkB,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAqGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,YAAY,EAAE,CA2DhB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA4B7D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,YAAY,EAAE,GACtB,CAAC,EAAE,CA0CL;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA2BxD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAanG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAClD,WAAW,CAGb;AAGD,OAAO,EAAE,aAAa,EAAE,CAAC"}