@measureoneinc/savant 1.0.0

package/dist/lib/app-constants.d.ts

@@ -0,0 +1,231 @@
+/**
+ * @fileoverview Shared Application Constants
+ *
+ * Common constants used across all MeasureOne services.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+/**
+ * HTTP status codes
+ */
+export declare const HTTP_STATUS: {
+    readonly OK: 200;
+    readonly CREATED: 201;
+    readonly ACCEPTED: 202;
+    readonly NO_CONTENT: 204;
+    readonly BAD_REQUEST: 400;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly METHOD_NOT_ALLOWED: 405;
+    readonly CONFLICT: 409;
+    readonly UNPROCESSABLE_ENTITY: 422;
+    readonly TOO_MANY_REQUESTS: 429;
+    readonly INTERNAL_SERVER_ERROR: 500;
+    readonly NOT_IMPLEMENTED: 501;
+    readonly BAD_GATEWAY: 502;
+    readonly SERVICE_UNAVAILABLE: 503;
+    readonly GATEWAY_TIMEOUT: 504;
+};
+/**
+ * Error codes for consistent error handling
+ */
+export declare const ERROR_CODES: {
+    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    readonly MISSING_REQUIRED_FIELD: "MISSING_REQUIRED_FIELD";
+    readonly INVALID_FORMAT: "INVALID_FORMAT";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly INVALID_TOKEN: "INVALID_TOKEN";
+    readonly TOKEN_EXPIRED: "TOKEN_EXPIRED";
+    readonly RESOURCE_NOT_FOUND: "RESOURCE_NOT_FOUND";
+    readonly RESOURCE_ALREADY_EXISTS: "RESOURCE_ALREADY_EXISTS";
+    readonly RESOURCE_CONFLICT: "RESOURCE_CONFLICT";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+    readonly FILE_TOO_LARGE: "FILE_TOO_LARGE";
+    readonly INVALID_FILE_TYPE: "INVALID_FILE_TYPE";
+    readonly FILE_CORRUPTED: "FILE_CORRUPTED";
+    readonly DATABASE_ERROR: "DATABASE_ERROR";
+    readonly CONNECTION_FAILED: "CONNECTION_FAILED";
+    readonly QUERY_FAILED: "QUERY_FAILED";
+    readonly EXTERNAL_API_ERROR: "EXTERNAL_API_ERROR";
+    readonly API_RATE_LIMITED: "API_RATE_LIMITED";
+    readonly API_UNAVAILABLE: "API_UNAVAILABLE";
+};
+/**
+ * API Response definitions following pixie pattern
+ * Maps error types to error codes and HTTP status codes
+ */
+export declare const API_RESPONSES: {
+    readonly general: {
+        readonly success: {
+            readonly code: 1;
+            readonly status: 200;
+            readonly description: "Success";
+            readonly error_code: "SUCCESS";
+        };
+        readonly badRequest: {
+            readonly code: 2;
+            readonly status: 400;
+            readonly description: "Missing or invalid request";
+            readonly error_code: "BAD_REQUEST";
+        };
+        readonly unauthorized: {
+            readonly code: 3;
+            readonly status: 401;
+            readonly description: "Unauthorized access to requested resource";
+            readonly error_code: "UNAUTHORIZED";
+        };
+        readonly forbidden: {
+            readonly code: 4;
+            readonly status: 403;
+            readonly description: "Forbidden access to requested resource";
+            readonly error_code: "FORBIDDEN";
+        };
+        readonly notFound: {
+            readonly code: 5;
+            readonly status: 404;
+            readonly description: "Requested resource cannot be found";
+            readonly error_code: "NOT_FOUND";
+        };
+        readonly internalError: {
+            readonly code: 6;
+            readonly status: 500;
+            readonly description: "Internal Server Error";
+            readonly error_code: "INTERNAL_ERROR";
+        };
+        readonly notSupported: {
+            readonly code: 7;
+            readonly status: 501;
+            readonly description: "Not supported";
+            readonly error_code: "NOT_SUPPORTED";
+        };
+        readonly unprocessableEntity: {
+            readonly code: 8;
+            readonly status: 422;
+            readonly description: "Unprocessable Entity";
+            readonly error_code: "UNPROCESSABLE_ENTITY";
+        };
+        readonly domainNotIdentified: {
+            readonly code: 9;
+            readonly status: 422;
+            readonly description: "Could not identify domain from seed content. Domain identification is required for seed creation.";
+            readonly error_code: "DOMAIN_NOT_IDENTIFIED";
+        };
+    };
+};
+/**
+ * Default configuration values
+ */
+export declare const DEFAULTS: {
+    readonly PAGE_SIZE: 50;
+    readonly MAX_PAGE_SIZE: 1000;
+    readonly DEFAULT_PAGE: 1;
+    readonly HTTP_TIMEOUT: 30000;
+    readonly DATABASE_TIMEOUT: 10000;
+    readonly CACHE_TIMEOUT: 300000;
+    readonly MAX_RETRIES: 3;
+    readonly RETRY_DELAY: 1000;
+    readonly BACKOFF_MULTIPLIER: 2;
+    readonly MAX_FILE_SIZE_MB: 100;
+    readonly ALLOWED_FILE_TYPES: readonly ["pdf", "png", "jpg", "jpeg", "gif", "txt", "json"];
+    readonly LOG_LEVEL: "info";
+    readonly LOG_FORMAT: "json";
+};
+/**
+ * Environment types
+ */
+export declare const ENVIRONMENTS: {
+    readonly DEVELOPMENT: "development";
+    readonly STAGING: "staging";
+    readonly PRODUCTION: "production";
+    readonly TEST: "test";
+};
+/**
+ * Service names for consistent identification
+ */
+export declare const SERVICES: {
+    readonly KNOWLEDGE_ACQUISITION: "knowledge-acquisition";
+    readonly REGISTRY: "registry";
+    readonly PARSER: "parser";
+    readonly NAVIGATOR: "navigator";
+    readonly ORCHESTRATION: "orchestration";
+};
+/**
+ * API version constants
+ */
+export declare const API_VERSIONS: {
+    readonly V1: "v1";
+    readonly V2: "v2";
+    readonly CURRENT: "v1";
+};
+/**
+ * Content types
+ */
+export declare const CONTENT_TYPES: {
+    readonly JSON: "application/json";
+    readonly XML: "application/xml";
+    readonly PDF: "application/pdf";
+    readonly TEXT: "text/plain";
+    readonly HTML: "text/html";
+    readonly CSV: "text/csv";
+    readonly FORM_DATA: "multipart/form-data";
+    readonly URL_ENCODED: "application/x-www-form-urlencoded";
+};
+/**
+ * Cache keys for consistent caching
+ */
+export declare const CACHE_KEYS: {
+    readonly USER_SESSION: "user:session:";
+    readonly API_RESPONSE: "api:response:";
+    readonly FILE_METADATA: "file:metadata:";
+    readonly KNOWLEDGE_BASE: "kb:";
+    readonly DOCUMENT: "doc:";
+    readonly PARSER: "parser:";
+};
+/**
+ * Regular expressions for validation
+ */
+export declare const REGEX_PATTERNS: {
+    readonly UUID: RegExp;
+    readonly EMAIL: RegExp;
+    readonly URL: RegExp;
+    readonly PHONE: RegExp;
+    readonly ALPHANUMERIC: RegExp;
+    readonly SLUG: RegExp;
+};
+/**
+ * Date and time formats
+ */
+export declare const DATE_FORMATS: {
+    readonly ISO_8601: "YYYY-MM-DDTHH:mm:ss.SSSZ";
+    readonly DATE_ONLY: "YYYY-MM-DD";
+    readonly TIME_ONLY: "HH:mm:ss";
+    readonly HUMAN_READABLE: "MMMM Do YYYY, h:mm:ss a";
+    readonly FILE_TIMESTAMP: "YYYY-MM-DD_HH-mm-ss";
+};
+/**
+ * Application metadata
+ */
+export declare const APP_METADATA: {
+    readonly ORGANIZATION: "MeasureOne, Inc.";
+    readonly COPYRIGHT: "© 2025 MeasureOne, Inc. All rights reserved.";
+    readonly LICENSE: "MIT";
+    readonly REPOSITORY: "https://github.com/measureone/m1-shared-utils";
+};
+/**
+ * Type exports for constants
+ */
+export type HttpStatus = typeof HTTP_STATUS[keyof typeof HTTP_STATUS];
+export type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];
+export type Environment = typeof ENVIRONMENTS[keyof typeof ENVIRONMENTS];
+export type ServiceName = typeof SERVICES[keyof typeof SERVICES];
+export type ApiVersion = typeof API_VERSIONS[keyof typeof API_VERSIONS];
+export type ContentType = typeof CONTENT_TYPES[keyof typeof CONTENT_TYPES];
+//# sourceMappingURL=app-constants.d.ts.map

package/dist/lib/app-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-constants.d.ts","sourceRoot":"","sources":["../../src/lib/app-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;CAuBd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCd,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;CAuBX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CAShB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AACrE,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AACzE,MAAM,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AACxE,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/dist/lib/app-constants.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * @fileoverview Shared Application Constants
+ *
+ * Common constants used across all MeasureOne services.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_METADATA = exports.DATE_FORMATS = exports.REGEX_PATTERNS = exports.CACHE_KEYS = exports.CONTENT_TYPES = exports.API_VERSIONS = exports.SERVICES = exports.ENVIRONMENTS = exports.DEFAULTS = exports.API_RESPONSES = exports.ERROR_CODES = exports.HTTP_STATUS = void 0;
+/**
+ * HTTP status codes
+ */
+exports.HTTP_STATUS = {
+    // Success
+    OK: 200,
+    CREATED: 201,
+    ACCEPTED: 202,
+    NO_CONTENT: 204,
+    // Client Errors
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    METHOD_NOT_ALLOWED: 405,
+    CONFLICT: 409,
+    UNPROCESSABLE_ENTITY: 422,
+    TOO_MANY_REQUESTS: 429,
+    // Server Errors
+    INTERNAL_SERVER_ERROR: 500,
+    NOT_IMPLEMENTED: 501,
+    BAD_GATEWAY: 502,
+    SERVICE_UNAVAILABLE: 503,
+    GATEWAY_TIMEOUT: 504
+};
+/**
+ * Error codes for consistent error handling
+ */
+exports.ERROR_CODES = {
+    // Validation Errors
+    VALIDATION_FAILED: 'VALIDATION_FAILED',
+    INVALID_INPUT: 'INVALID_INPUT',
+    MISSING_REQUIRED_FIELD: 'MISSING_REQUIRED_FIELD',
+    INVALID_FORMAT: 'INVALID_FORMAT',
+    // Authentication & Authorization
+    UNAUTHORIZED: 'UNAUTHORIZED',
+    FORBIDDEN: 'FORBIDDEN',
+    INVALID_TOKEN: 'INVALID_TOKEN',
+    TOKEN_EXPIRED: 'TOKEN_EXPIRED',
+    // Resource Errors
+    RESOURCE_NOT_FOUND: 'RESOURCE_NOT_FOUND',
+    RESOURCE_ALREADY_EXISTS: 'RESOURCE_ALREADY_EXISTS',
+    RESOURCE_CONFLICT: 'RESOURCE_CONFLICT',
+    // Service Errors
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
+    TIMEOUT: 'TIMEOUT',
+    RATE_LIMITED: 'RATE_LIMITED',
+    // File Errors
+    FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+    FILE_TOO_LARGE: 'FILE_TOO_LARGE',
+    INVALID_FILE_TYPE: 'INVALID_FILE_TYPE',
+    FILE_CORRUPTED: 'FILE_CORRUPTED',
+    // Database Errors
+    DATABASE_ERROR: 'DATABASE_ERROR',
+    CONNECTION_FAILED: 'CONNECTION_FAILED',
+    QUERY_FAILED: 'QUERY_FAILED',
+    // External API Errors
+    EXTERNAL_API_ERROR: 'EXTERNAL_API_ERROR',
+    API_RATE_LIMITED: 'API_RATE_LIMITED',
+    API_UNAVAILABLE: 'API_UNAVAILABLE'
+};
+/**
+ * API Response definitions following pixie pattern
+ * Maps error types to error codes and HTTP status codes
+ */
+exports.API_RESPONSES = {
+    general: {
+        success: {
+            code: 1,
+            status: exports.HTTP_STATUS.OK,
+            description: 'Success',
+            error_code: 'SUCCESS'
+        },
+        badRequest: {
+            code: 2,
+            status: exports.HTTP_STATUS.BAD_REQUEST,
+            description: 'Missing or invalid request',
+            error_code: 'BAD_REQUEST'
+        },
+        unauthorized: {
+            code: 3,
+            status: exports.HTTP_STATUS.UNAUTHORIZED,
+            description: 'Unauthorized access to requested resource',
+            error_code: 'UNAUTHORIZED'
+        },
+        forbidden: {
+            code: 4,
+            status: exports.HTTP_STATUS.FORBIDDEN,
+            description: 'Forbidden access to requested resource',
+            error_code: 'FORBIDDEN'
+        },
+        notFound: {
+            code: 5,
+            status: exports.HTTP_STATUS.NOT_FOUND,
+            description: 'Requested resource cannot be found',
+            error_code: 'NOT_FOUND'
+        },
+        internalError: {
+            code: 6,
+            status: exports.HTTP_STATUS.INTERNAL_SERVER_ERROR,
+            description: 'Internal Server Error',
+            error_code: 'INTERNAL_ERROR'
+        },
+        notSupported: {
+            code: 7,
+            status: exports.HTTP_STATUS.NOT_IMPLEMENTED,
+            description: 'Not supported',
+            error_code: 'NOT_SUPPORTED'
+        },
+        unprocessableEntity: {
+            code: 8,
+            status: exports.HTTP_STATUS.UNPROCESSABLE_ENTITY,
+            description: 'Unprocessable Entity',
+            error_code: 'UNPROCESSABLE_ENTITY'
+        },
+        domainNotIdentified: {
+            code: 9,
+            status: exports.HTTP_STATUS.UNPROCESSABLE_ENTITY,
+            description: 'Could not identify domain from seed content. Domain identification is required for seed creation.',
+            error_code: 'DOMAIN_NOT_IDENTIFIED'
+        }
+    }
+};
+/**
+ * Default configuration values
+ */
+exports.DEFAULTS = {
+    // Pagination
+    PAGE_SIZE: 50,
+    MAX_PAGE_SIZE: 1000,
+    DEFAULT_PAGE: 1,
+    // Timeouts (milliseconds)
+    HTTP_TIMEOUT: 30000,
+    DATABASE_TIMEOUT: 10000,
+    CACHE_TIMEOUT: 300000, // 5 minutes
+    // Retry configuration
+    MAX_RETRIES: 3,
+    RETRY_DELAY: 1000,
+    BACKOFF_MULTIPLIER: 2,
+    // File handling
+    MAX_FILE_SIZE_MB: 100,
+    ALLOWED_FILE_TYPES: ['pdf', 'png', 'jpg', 'jpeg', 'gif', 'txt', 'json'],
+    // Logging
+    LOG_LEVEL: 'info',
+    LOG_FORMAT: 'json'
+};
+/**
+ * Environment types
+ */
+exports.ENVIRONMENTS = {
+    DEVELOPMENT: 'development',
+    STAGING: 'staging',
+    PRODUCTION: 'production',
+    TEST: 'test'
+};
+/**
+ * Service names for consistent identification
+ */
+exports.SERVICES = {
+    KNOWLEDGE_ACQUISITION: 'knowledge-acquisition',
+    REGISTRY: 'registry',
+    PARSER: 'parser',
+    NAVIGATOR: 'navigator',
+    ORCHESTRATION: 'orchestration'
+};
+/**
+ * API version constants
+ */
+exports.API_VERSIONS = {
+    V1: 'v1',
+    V2: 'v2',
+    CURRENT: 'v1'
+};
+/**
+ * Content types
+ */
+exports.CONTENT_TYPES = {
+    JSON: 'application/json',
+    XML: 'application/xml',
+    PDF: 'application/pdf',
+    TEXT: 'text/plain',
+    HTML: 'text/html',
+    CSV: 'text/csv',
+    FORM_DATA: 'multipart/form-data',
+    URL_ENCODED: 'application/x-www-form-urlencoded'
+};
+/**
+ * Cache keys for consistent caching
+ */
+exports.CACHE_KEYS = {
+    USER_SESSION: 'user:session:',
+    API_RESPONSE: 'api:response:',
+    FILE_METADATA: 'file:metadata:',
+    KNOWLEDGE_BASE: 'kb:',
+    DOCUMENT: 'doc:',
+    PARSER: 'parser:'
+};
+/**
+ * Regular expressions for validation
+ */
+exports.REGEX_PATTERNS = {
+    UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+    EMAIL: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+    URL: /^https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_\+.~#?&//=]*)$/,
+    PHONE: /^\+?[1-9]\d{1,14}$/,
+    ALPHANUMERIC: /^[a-zA-Z0-9]+$/,
+    SLUG: /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+};
+/**
+ * Date and time formats
+ */
+exports.DATE_FORMATS = {
+    ISO_8601: 'YYYY-MM-DDTHH:mm:ss.SSSZ',
+    DATE_ONLY: 'YYYY-MM-DD',
+    TIME_ONLY: 'HH:mm:ss',
+    HUMAN_READABLE: 'MMMM Do YYYY, h:mm:ss a',
+    FILE_TIMESTAMP: 'YYYY-MM-DD_HH-mm-ss'
+};
+/**
+ * Application metadata
+ */
+exports.APP_METADATA = {
+    ORGANIZATION: 'MeasureOne, Inc.',
+    COPYRIGHT: '© 2025 MeasureOne, Inc. All rights reserved.',
+    LICENSE: 'MIT',
+    REPOSITORY: 'https://github.com/measureone/m1-shared-utils'
+};
+//# sourceMappingURL=app-constants.js.map

package/dist/lib/app-constants.js.map

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

package/dist/lib/controller-utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Controller Utilities - Following Pixie Pattern
+ *
+ * Helper functions for controllers following the pixie validation pattern.
+ * Provides get_error method similar to pixie's Controller class.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+/**
+ * Error response object matching pixie format
+ */
+export interface ErrorResponseObject {
+    error_code: string;
+    error_message: string;
+    timestamp: number;
+    http_code: number;
+    sub_errors?: any[];
+}
+/**
+ * Get error object following pixie pattern
+ *
+ * @param category - Error category (e.g., 'general')
+ * @param type - Error type (e.g., 'badRequest')
+ * @param error_message - Custom error message (optional)
+ * @param data - Additional error data (optional, used for validation errors)
+ * @returns Error object with pixie-compatible structure
+ */
+export declare function get_error(category: string, type: string, error_message?: string, data?: any): {
+    error_code: string;
+    error_message: string;
+    status: number;
+    data?: any;
+};
+/**
+ * Handle error response following pixie pattern
+ *
+ * @param err - Error object from get_error
+ * @param res - Express response object
+ * @param next - Express next function
+ */
+export declare function handle_error_response(err: {
+    error_code: string;
+    error_message: string;
+    status: number;
+    data?: any;
+}, res: any, next: any): void;
+//# sourceMappingURL=controller-utils.d.ts.map

package/dist/lib/controller-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-utils.d.ts","sourceRoot":"","sources":["../../src/lib/controller-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,GAAG,GACX;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAA;CAAE,CA2B3E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,GAAG,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAA;CAAE,EAC9E,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,GAAG,GACV,IAAI,CAaN"}

package/dist/lib/controller-utils.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * @fileoverview Controller Utilities - Following Pixie Pattern
+ *
+ * Helper functions for controllers following the pixie validation pattern.
+ * Provides get_error method similar to pixie's Controller class.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_error = get_error;
+exports.handle_error_response = handle_error_response;
+const app_constants_1 = require("./app-constants");
+/**
+ * Get error object following pixie pattern
+ *
+ * @param category - Error category (e.g., 'general')
+ * @param type - Error type (e.g., 'badRequest')
+ * @param error_message - Custom error message (optional)
+ * @param data - Additional error data (optional, used for validation errors)
+ * @returns Error object with pixie-compatible structure
+ */
+function get_error(category, type, error_message, data) {
+    // Get error config from API_RESPONSES constants (pixie pattern)
+    const category_responses = app_constants_1.API_RESPONSES[category];
+    const error_config = category_responses?.[type] || {
+        error_code: app_constants_1.ERROR_CODES.INTERNAL_ERROR,
+        status: app_constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR,
+        description: 'Internal Server Error'
+    };
+    // Format error message from validation errors if data is provided
+    let formatted_message = error_message;
+    if (data && Array.isArray(data) && data.length > 0) {
+        // Extract the first validation error message
+        const first_error = data[0];
+        if (first_error.msg) {
+            formatted_message = first_error.msg;
+        }
+        else if (first_error.message) {
+            formatted_message = first_error.message;
+        }
+    }
+    return {
+        error_code: error_config.error_code,
+        error_message: formatted_message || error_config.description || `Request ${type}`,
+        status: error_config.status,
+        data: data || undefined
+    };
+}
+/**
+ * Handle error response following pixie pattern
+ *
+ * @param err - Error object from get_error
+ * @param res - Express response object
+ * @param next - Express next function
+ */
+function handle_error_response(err, res, next) {
+    const response_obj = {
+        error_code: err.error_code,
+        error_message: err.error_message,
+        timestamp: Date.now(),
+        http_code: err.status
+    };
+    if (err.data) {
+        response_obj.sub_errors = err.data;
+    }
+    res.status(err.status).json(response_obj);
+}
+//# sourceMappingURL=controller-utils.js.map

package/dist/lib/controller-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-utils.js","sourceRoot":"","sources":["../../src/lib/controller-utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAwBH,8BAgCC;AASD,sDAiBC;AAhFD,mDAA0E;AAa1E;;;;;;;;GAQG;AACH,SAAgB,SAAS,CACrB,QAAgB,EAChB,IAAY,EACZ,aAAsB,EACtB,IAAU;IAEV,gEAAgE;IAChE,MAAM,kBAAkB,GAAI,6BAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC,IAAI,CAAC,IAAI;QAC/C,UAAU,EAAE,2BAAW,CAAC,cAAc;QACtC,MAAM,EAAE,2BAAW,CAAC,qBAAqB;QACzC,WAAW,EAAE,uBAAuB;KACvC,CAAC;IAEF,kEAAkE;IAClE,IAAI,iBAAiB,GAAG,aAAa,CAAC;IACtC,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,6CAA6C;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC;YAClB,iBAAiB,GAAG,WAAW,CAAC,GAAG,CAAC;QACxC,CAAC;aAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YAC7B,iBAAiB,GAAG,WAAW,CAAC,OAAO,CAAC;QAC5C,CAAC;IACL,CAAC;IAED,OAAO;QACH,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,aAAa,EAAE,iBAAiB,IAAI,YAAY,CAAC,WAAW,IAAI,WAAW,IAAI,EAAE;QACjF,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,IAAI,EAAE,IAAI,IAAI,SAAS;KAC1B,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACjC,GAA8E,EAC9E,GAAQ,EACR,IAAS;IAET,MAAM,YAAY,GAAwB;QACtC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS,EAAE,GAAG,CAAC,MAAM;KACxB,CAAC;IAEF,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,YAAY,CAAC,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC9C,CAAC"}