@shohaghinfo/aerojs 0.1.0

package/dist/storage/uploaded-file.js

@@ -0,0 +1,73 @@
+/**
+ * @file uploaded-file.ts
+ * @description UploadedFile class representing an HTTP multipart uploaded file.
+ * Provides validation (size, MIME, extension), saving to disk, and direct Storage integration.
+ */
+import { writeFile, mkdir } from 'node:fs/promises';
+import { dirname, extname, join } from 'node:path';
+import { Storage } from './storage-manager.js';
+export class UploadedFile {
+    fieldName;
+    originalName;
+    mimeType;
+    size;
+    buffer;
+    constructor(options) {
+        this.fieldName = options.fieldName;
+        this.originalName = options.originalName;
+        this.mimeType = options.mimeType;
+        this.buffer = options.buffer;
+        this.size = options.buffer.length;
+    }
+    get extension() {
+        const ext = extname(this.originalName).toLowerCase();
+        return ext.startsWith('.') ? ext : `.${ext}`;
+    }
+    /**
+     * Validates file size, MIME type, and file extension.
+     */
+    validate(rules) {
+        const errors = [];
+        if (rules.maxSize !== undefined && this.size > rules.maxSize) {
+            errors.push(`File size ${this.size} bytes exceeds maximum allowed limit of ${rules.maxSize} bytes`);
+        }
+        if (rules.mimes && rules.mimes.length > 0) {
+            const normalizedMimes = rules.mimes.map((m) => m.toLowerCase());
+            if (!normalizedMimes.includes(this.mimeType.toLowerCase())) {
+                errors.push(`Invalid file MIME type "${this.mimeType}". Allowed: ${rules.mimes.join(', ')}`);
+            }
+        }
+        if (rules.extensions && rules.extensions.length > 0) {
+            const normalizedExts = rules.extensions.map((e) => e.startsWith('.') ? e.toLowerCase() : `.${e.toLowerCase()}`);
+            if (!normalizedExts.includes(this.extension.toLowerCase())) {
+                errors.push(`Invalid file extension "${this.extension}". Allowed: ${rules.extensions.join(', ')}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Saves the file to a local destination filepath.
+     */
+    async saveAs(destinationPath) {
+        const dir = dirname(destinationPath);
+        await mkdir(dir, { recursive: true });
+        await writeFile(destinationPath, this.buffer);
+        return destinationPath;
+    }
+    /**
+     * Stores the file using Aero's Storage manager onto a designated disk.
+     */
+    async store(directory = 'uploads', diskName) {
+        const timestamp = Date.now();
+        const randomHex = Math.random().toString(36).substring(2, 8);
+        const sanitizedName = this.originalName.replace(/[^a-zA-Z0-9._-]/g, '_');
+        const finalFilename = `${timestamp}_${randomHex}_${sanitizedName}`;
+        const targetPath = directory ? join(directory, finalFilename).replace(/\\/g, '/') : finalFilename;
+        const disk = Storage.disk(diskName);
+        return await disk.put(targetPath, this.buffer);
+    }
+}
+//# sourceMappingURL=uploaded-file.js.map

package/dist/storage/uploaded-file.js.map

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

package/dist/swagger/generator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @file generator.ts
+ * @description OpenAPI 3.0 specification generator for AeroJS.
+ * Automatically scans registered routes, extracts path parameters, schemas, and security definitions.
+ */
+import type { Route } from '../core/router.js';
+export interface OpenAPISpec {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    paths: Record<string, Record<string, any>>;
+    components?: {
+        securitySchemes?: Record<string, any>;
+        schemas?: Record<string, any>;
+    };
+}
+export interface SwaggerOptions {
+    title?: string;
+    version?: string;
+    description?: string;
+    openapiVersion?: string;
+    route?: string;
+    specRoute?: string;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    security?: boolean | Record<string, any>;
+}
+export declare class SwaggerGenerator {
+    static generate(routes: Route[], options?: SwaggerOptions): OpenAPISpec;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/swagger/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/swagger/generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE;QACX,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1C;AAED,qBAAa,gBAAgB;WACb,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW;CA4HnF"}

package/dist/swagger/generator.js

@@ -0,0 +1,117 @@
+/**
+ * @file generator.ts
+ * @description OpenAPI 3.0 specification generator for AeroJS.
+ * Automatically scans registered routes, extracts path parameters, schemas, and security definitions.
+ */
+export class SwaggerGenerator {
+    static generate(routes, options = {}) {
+        const spec = {
+            openapi: options.openapiVersion || '3.0.3',
+            info: {
+                title: options.title || 'AeroJS Application API',
+                version: options.version || '1.0.0',
+                description: options.description || 'Interactive API documentation generated automatically by AeroJS.',
+            },
+            servers: options.servers || [{ url: '/', description: 'Current Server' }],
+            paths: {},
+            components: {
+                securitySchemes: {
+                    bearerAuth: {
+                        type: 'http',
+                        scheme: 'bearer',
+                        bearerFormat: 'JWT',
+                        description: 'Enter your JWT Bearer token',
+                    },
+                },
+            },
+        };
+        const tagsSet = new Set();
+        for (const route of routes) {
+            // Don't document Swagger UI / internal docs routes
+            if (route.path.startsWith('/docs') || route.path.startsWith('/openapi.json') || route.path.startsWith('/api-spec.json') || route.path.startsWith('/api-docs') || route.path.startsWith('/swagger')) {
+                continue;
+            }
+            // Convert Aero path '/users/:id/posts/:slug' -> OpenAPI path '/users/{id}/posts/{slug}'
+            const openApiPath = route.path.replace(/:([a-zA-Z0-9_]+)/g, '{$1}');
+            if (!spec.paths[openApiPath]) {
+                spec.paths[openApiPath] = {};
+            }
+            const method = route.method.toLowerCase();
+            if (method === 'all')
+                continue;
+            // Determine Tag
+            const segments = route.path.split('/').filter(Boolean);
+            const tagCandidate = segments[0] === 'api' ? segments[1] : segments[0];
+            const defaultTag = tagCandidate
+                ? tagCandidate.charAt(0).toUpperCase() + tagCandidate.slice(1)
+                : 'General';
+            // Extract Route OpenAPI Metadata
+            const openapiMeta = route.openapi || {};
+            const tags = openapiMeta.tags || [defaultTag];
+            for (const t of tags)
+                tagsSet.add(t);
+            // Extract Path Parameters
+            const parameters = [];
+            const paramMatches = [...route.path.matchAll(/:([a-zA-Z0-9_]+)/g)];
+            for (const m of paramMatches) {
+                parameters.push({
+                    name: m[1],
+                    in: 'path',
+                    required: true,
+                    schema: { type: 'string' },
+                    description: `Path parameter ${m[1]}`,
+                });
+            }
+            // Extract Query Parameters from Route Schema
+            const routeSchema = route.schema;
+            if (routeSchema?.query && typeof routeSchema.query === 'object') {
+                const props = routeSchema.query.properties || {};
+                const required = routeSchema.query.required || [];
+                for (const [key, propDef] of Object.entries(props)) {
+                    parameters.push({
+                        name: key,
+                        in: 'query',
+                        required: required.includes(key),
+                        schema: propDef,
+                    });
+                }
+            }
+            // Request Body
+            let requestBody = undefined;
+            if (routeSchema?.body) {
+                requestBody = {
+                    required: true,
+                    content: {
+                        'application/json': {
+                            schema: routeSchema.body,
+                        },
+                    },
+                };
+            }
+            // Responses
+            const responses = {
+                '200': {
+                    description: 'Successful Operation',
+                },
+            };
+            if (routeSchema?.body || routeSchema?.query || routeSchema?.params) {
+                responses['400'] = { description: 'Bad Request / Validation Failure' };
+                responses['422'] = { description: 'Unprocessable Entity' };
+            }
+            const mergedResponses = { ...responses, ...(openapiMeta.responses || {}) };
+            spec.paths[openApiPath][method] = {
+                tags,
+                summary: openapiMeta.summary || `${route.method} ${route.path}`,
+                description: openapiMeta.description,
+                deprecated: openapiMeta.deprecated,
+                parameters: parameters.length > 0 ? parameters : undefined,
+                requestBody,
+                responses: mergedResponses,
+                security: options.security ? [{ bearerAuth: [] }] : undefined,
+            };
+        }
+        spec.tags = Array.from(tagsSet).map((name) => ({ name }));
+        return spec;
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/swagger/generator.js.map

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

package/dist/swagger/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file index.ts
+ * @description AeroJS Swagger & OpenAPI 3.0 Documentation Module.
+ */
+export * from './generator.js';
+export * from './ui.js';
+export * from './swagger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swagger/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/swagger/index.js

@@ -0,0 +1,8 @@
+/**
+ * @file index.ts
+ * @description AeroJS Swagger & OpenAPI 3.0 Documentation Module.
+ */
+export * from './generator.js';
+export * from './ui.js';
+export * from './swagger.js';
+//# sourceMappingURL=index.js.map

package/dist/swagger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/swagger/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/swagger/swagger.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file swagger.ts
+ * @description Swagger middleware and plugin for AeroJS.
+ * Mounts interactive Swagger UI and OpenAPI 3.0 JSON specification endpoints.
+ */
+import type { Middleware } from '../core/types.js';
+import { type SwaggerOptions } from './generator.js';
+export declare function swaggerPlugin(options?: SwaggerOptions): Middleware;
+//# sourceMappingURL=swagger.d.ts.map

package/dist/swagger/swagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.d.ts","sourceRoot":"","sources":["../../src/swagger/swagger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAoB,KAAK,cAAc,EAAoB,MAAM,gBAAgB,CAAC;AAGzF,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,UAAU,CA2BtE"}

package/dist/swagger/swagger.js

@@ -0,0 +1,32 @@
+/**
+ * @file swagger.ts
+ * @description Swagger middleware and plugin for AeroJS.
+ * Mounts interactive Swagger UI and OpenAPI 3.0 JSON specification endpoints.
+ */
+import { SwaggerGenerator } from './generator.js';
+import { renderSwaggerUI } from './ui.js';
+export function swaggerPlugin(options = {}) {
+    const uiRoute = options.route || '/docs';
+    const specRoute = options.specRoute || '/openapi.json';
+    let cachedSpec = null;
+    return async (ctx, next) => {
+        // 1. Serve OpenAPI 3.0 JSON Specification
+        if (ctx.method === 'GET' && ctx.path === specRoute) {
+            const routes = ctx.req._app?.router?.routes || [];
+            cachedSpec = SwaggerGenerator.generate(routes, options);
+            ctx.status(200).json(cachedSpec);
+            return;
+        }
+        // 2. Serve Interactive Swagger UI HTML Page
+        if (ctx.method === 'GET' && (ctx.path === uiRoute || ctx.path === `${uiRoute}/`)) {
+            const html = renderSwaggerUI({
+                title: options.title || 'AeroJS API Docs',
+                specUrl: specRoute,
+            });
+            ctx.status(200).html(html);
+            return;
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=swagger.js.map

package/dist/swagger/swagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.js","sourceRoot":"","sources":["../../src/swagger/swagger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAyC,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,UAAU,aAAa,CAAC,UAA0B,EAAE;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC;IAEvD,IAAI,UAAU,GAAuB,IAAI,CAAC;IAE1C,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,0CAA0C;QAC1C,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnD,MAAM,MAAM,GAAI,GAAG,CAAC,GAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;YAC3D,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACxD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAED,4CAA4C;QAC5C,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,GAAG,eAAe,CAAC;gBAC3B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,iBAAiB;gBACzC,OAAO,EAAE,SAAS;aACnB,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/swagger/ui.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @file ui.ts
+ * @description Swagger UI interactive HTML template generator for AeroJS.
+ * Features responsive layout, dark theme accents, and live request execution.
+ */
+export interface SwaggerUIOptions {
+    title?: string;
+    specUrl: string;
+}
+export declare function renderSwaggerUI(options: SwaggerUIOptions): string;
+//# sourceMappingURL=ui.d.ts.map

package/dist/swagger/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/swagger/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAuFjE"}

package/dist/swagger/ui.js

@@ -0,0 +1,93 @@
+/**
+ * @file ui.ts
+ * @description Swagger UI interactive HTML template generator for AeroJS.
+ * Features responsive layout, dark theme accents, and live request execution.
+ */
+export function renderSwaggerUI(options) {
+    const { title = 'AeroJS API Documentation', specUrl } = options;
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${title}</title>
+  <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5.18.2/swagger-ui.css" />
+  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>⚡</text></svg>">
+  <style>
+    body {
+      margin: 0;
+      padding: 0;
+      background: #0f172a;
+      color: #f8fafc;
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    }
+    .topbar {
+      display: none !important;
+    }
+    .swagger-ui {
+      max-width: 1200px;
+      margin: 0 auto;
+      padding: 24px 16px;
+    }
+    .swagger-ui .info {
+      margin: 20px 0 30px;
+    }
+    .swagger-ui .info .title {
+      color: #38bdf8;
+      font-size: 32px;
+      font-weight: 700;
+      letter-spacing: -0.025em;
+    }
+    .swagger-ui .info p, .swagger-ui .info li {
+      color: #94a3b8;
+      font-size: 15px;
+    }
+    .swagger-ui .scheme-container {
+      background: #1e293b;
+      box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+      border-radius: 8px;
+      padding: 16px;
+      margin-bottom: 24px;
+    }
+    .swagger-ui .opblock {
+      border-radius: 8px;
+      box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.1);
+      margin-bottom: 14px;
+    }
+    .swagger-ui .btn.authorize {
+      background-color: #0284c7;
+      border-color: #0284c7;
+      color: #ffffff;
+      border-radius: 6px;
+    }
+    .swagger-ui .btn.authorize svg {
+      fill: #ffffff;
+    }
+  </style>
+</head>
+<body>
+  <div id="swagger-ui"></div>
+  <script src="https://unpkg.com/swagger-ui-dist@5.18.2/swagger-ui-bundle.js"></script>
+  <script src="https://unpkg.com/swagger-ui-dist@5.18.2/swagger-ui-standalone-preset.js"></script>
+  <script>
+    window.onload = function() {
+      window.ui = SwaggerUIBundle({
+        url: "${specUrl}",
+        dom_id: '#swagger-ui',
+        deepLinking: true,
+        presets: [
+          SwaggerUIBundle.presets.apis,
+          SwaggerUIStandalonePreset
+        ],
+        plugins: [
+          SwaggerUIBundle.plugins.DownloadUrl
+        ],
+        layout: "BaseLayout",
+        persistAuthorization: true,
+      });
+    };
+  </script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=ui.js.map

package/dist/swagger/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/swagger/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,EAAE,KAAK,GAAG,0BAA0B,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAEhE,OAAO;;;;;WAKE,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA8DA,OAAO;;;;;;;;;;;;;;;;QAgBf,CAAC;AACT,CAAC"}

package/dist/tcp/hl7.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @file hl7.ts
+ * @description Zero-dependency HL7 v2.x Message Parser for AeroJS.
+ */
+export interface ParsedHL7 {
+    messageType: string;
+    controlId: string;
+    sendingApp: string;
+    segments: Map<string, string[]>;
+    raw: string;
+    getSegment(name: string): string[] | undefined;
+}
+export declare class HL7 {
+    /**
+     * Parses raw HL7 string into structured segments and metadata.
+     */
+    static parse(rawMsg: string): ParsedHL7;
+}
+//# sourceMappingURL=hl7.d.ts.map

package/dist/tcp/hl7.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hl7.d.ts","sourceRoot":"","sources":["../../src/tcp/hl7.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAChD;AAED,qBAAa,GAAG;IACd;;OAEG;WACW,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;CAoC/C"}

package/dist/tcp/hl7.js

@@ -0,0 +1,42 @@
+/**
+ * @file hl7.ts
+ * @description Zero-dependency HL7 v2.x Message Parser for AeroJS.
+ */
+export class HL7 {
+    /**
+     * Parses raw HL7 string into structured segments and metadata.
+     */
+    static parse(rawMsg) {
+        const clean = rawMsg.trim();
+        const lines = clean.split(/[\r\n]+/).filter(Boolean);
+        const segments = new Map();
+        for (const line of lines) {
+            const parts = line.split('|');
+            const segName = parts[0];
+            if (segName) {
+                segments.set(segName, parts.slice(1));
+            }
+        }
+        const msh = segments.get('MSH') || [];
+        // MSH structure:
+        // parts[0]: MSH
+        // parts[1]: ^~\& (field separator encoding)
+        // parts[2]: Sending Application
+        // parts[8]: Message Type (e.g. ORU^R01 or ACK)
+        // parts[9]: Message Control ID
+        const sendingApp = msh[1] || '';
+        const messageType = msh[7] || '';
+        const controlId = msh[8] || '';
+        return {
+            messageType,
+            controlId,
+            sendingApp,
+            segments,
+            raw: rawMsg,
+            getSegment(name) {
+                return segments.get(name);
+            },
+        };
+    }
+}
+//# sourceMappingURL=hl7.js.map

package/dist/tcp/hl7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hl7.js","sourceRoot":"","sources":["../../src/tcp/hl7.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,OAAO,GAAG;IACd;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,MAAc;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;QAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,CAAC;QAEH,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACtC,iBAAiB;QACjB,gBAAgB;QAChB,4CAA4C;QAC5C,gCAAgC;QAChC,+CAA+C;QAC/C,+BAA+B;QAC/B,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE/B,OAAO;YACL,WAAW;YACX,SAAS;YACT,UAAU;YACV,QAAQ;YACR,GAAG,EAAE,MAAM;YACX,UAAU,CAAC,IAAY;gBACrB,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/tcp/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tcp-server.js';
+export * from './mllp.js';
+export * from './hl7.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/tcp/index.js

@@ -0,0 +1,4 @@
+export * from './tcp-server.js';
+export * from './mllp.js';
+export * from './hl7.js';
+//# sourceMappingURL=index.js.map

package/dist/tcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/tcp/mllp.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @file mllp.ts
+ * @description Minimal Lower Layer Protocol (MLLP) framing helper for HL7 clinical interfaces.
+ */
+export declare class MLLP {
+    static readonly START_BLOCK = 11;
+    static readonly END_BLOCK = 28;
+    static readonly CARRIAGE_RETURN = 13;
+    /**
+     * Wraps an HL7 message in standard MLLP framing (<VT> ... <FS><CR>).
+     */
+    static wrap(message: string | Buffer): Buffer;
+    /**
+     * Unwraps an MLLP buffer into an HL7 message string.
+     */
+    static unwrap(buffer: Buffer): string;
+    /**
+     * Generates a standard HL7 ACK message wrapped in MLLP.
+     */
+    static ack(controlId?: string, ackCode?: string): Buffer;
+}
+//# sourceMappingURL=mllp.d.ts.map

package/dist/tcp/mllp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mllp.d.ts","sourceRoot":"","sources":["../../src/tcp/mllp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,IAAI;IACf,gBAAuB,WAAW,MAAQ;IAC1C,gBAAuB,SAAS,MAAQ;IACxC,gBAAuB,eAAe,MAAQ;IAE9C;;OAEG;WACW,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAUpD;;OAEG;WACW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAY5C;;OAEG;WACW,GAAG,CAAC,SAAS,GAAE,MAAY,EAAE,OAAO,SAAO,GAAG,MAAM;CAKnE"}

package/dist/tcp/mllp.js

@@ -0,0 +1,44 @@
+/**
+ * @file mllp.ts
+ * @description Minimal Lower Layer Protocol (MLLP) framing helper for HL7 clinical interfaces.
+ */
+export class MLLP {
+    static START_BLOCK = 0x0b; // <VT> Vertical Tab
+    static END_BLOCK = 0x1c; // <FS> File Separator
+    static CARRIAGE_RETURN = 0x0d; // <CR> Carriage Return
+    /**
+     * Wraps an HL7 message in standard MLLP framing (<VT> ... <FS><CR>).
+     */
+    static wrap(message) {
+        const msgBuffer = typeof message === 'string' ? Buffer.from(message, 'utf-8') : message;
+        const buf = Buffer.alloc(1 + msgBuffer.length + 2);
+        buf[0] = MLLP.START_BLOCK;
+        msgBuffer.copy(buf, 1);
+        buf[buf.length - 2] = MLLP.END_BLOCK;
+        buf[buf.length - 1] = MLLP.CARRIAGE_RETURN;
+        return buf;
+    }
+    /**
+     * Unwraps an MLLP buffer into an HL7 message string.
+     */
+    static unwrap(buffer) {
+        let start = 0;
+        if (buffer[0] === MLLP.START_BLOCK) {
+            start = 1;
+        }
+        let end = buffer.length;
+        if (buffer[buffer.length - 1] === MLLP.CARRIAGE_RETURN && buffer[buffer.length - 2] === MLLP.END_BLOCK) {
+            end = buffer.length - 2;
+        }
+        return buffer.subarray(start, end).toString('utf-8');
+    }
+    /**
+     * Generates a standard HL7 ACK message wrapped in MLLP.
+     */
+    static ack(controlId = '1', ackCode = 'AA') {
+        const timestamp = new Date().toISOString().replace(/[-:T.Z]/g, '').slice(0, 14);
+        const ackMsg = `MSH|^~\\&|AERO_GATEWAY|AERO_HOSPITAL|LAB_ANALYZER|LAB|${timestamp}||ACK|${controlId}|P|2.3.1\rMSA|${ackCode}|${controlId}\r`;
+        return MLLP.wrap(ackMsg);
+    }
+}
+//# sourceMappingURL=mllp.js.map

package/dist/tcp/mllp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mllp.js","sourceRoot":"","sources":["../../src/tcp/mllp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,IAAI;IACR,MAAM,CAAU,WAAW,GAAG,IAAI,CAAC,CAAO,oBAAoB;IAC9D,MAAM,CAAU,SAAS,GAAG,IAAI,CAAC,CAAS,sBAAsB;IAChE,MAAM,CAAU,eAAe,GAAG,IAAI,CAAC,CAAG,uBAAuB;IAExE;;OAEG;IACI,MAAM,CAAC,IAAI,CAAC,OAAwB;QACzC,MAAM,SAAS,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACxF,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnD,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC1B,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACrC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;QAC3C,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,MAAM,CAAC,MAAc;QACjC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACnC,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;QACD,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACvG,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,GAAG,CAAC,YAAoB,GAAG,EAAE,OAAO,GAAG,IAAI;QACvD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,yDAAyD,SAAS,SAAS,SAAS,iBAAiB,OAAO,IAAI,SAAS,IAAI,CAAC;QAC7I,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC"}

package/dist/tcp/tcp-server.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file tcp-server.ts
+ * @description Raw TCP Gateway for AeroJS. Enables low-latency hardware integration (analyzers, IoT, POS).
+ */
+import { EventEmitter } from 'node:events';
+export interface TcpServerOptions {
+    port: number;
+    host?: string;
+}
+export declare class TcpServer extends EventEmitter {
+    private server;
+    readonly port: number;
+    readonly host: string;
+    private sockets;
+    constructor(options: TcpServerOptions);
+    listen(): Promise<void>;
+    broadcast(data: string | Buffer): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=tcp-server.d.ts.map

package/dist/tcp/tcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp-server.d.ts","sourceRoot":"","sources":["../../src/tcp/tcp-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAa;IAC3B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,gBAAgB;IA4BxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CASpC"}