@shohaghinfo/aerojs 0.1.0

package/dist/errors.js

@@ -0,0 +1,173 @@
+/**
+ * @file errors.ts
+ * @description Standard error classes for the Aero framework.
+ */
+/**
+ * Base HTTP and framework error class in Aero.
+ */
+export class AeroError extends Error {
+    /**
+     * HTTP status code associated with the error.
+     */
+    status;
+    /**
+     * Optional machine-readable error code.
+     */
+    code;
+    /**
+     * Optional contextual details or validation errors.
+     */
+    details;
+    /**
+     * Creates an instance of AeroError.
+     *
+     * @param message - Human-readable error message.
+     * @param status - HTTP status code (defaults to 500).
+     * @param code - Optional machine-readable error code.
+     * @param details - Optional additional error details.
+     */
+    constructor(message, status = 500, code, details) {
+        super(message);
+        this.name = 'AeroError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * HTTP 400 Bad Request error.
+ */
+export class BadRequestError extends AeroError {
+    /**
+     * Creates a BadRequestError.
+     *
+     * @param message - Error message (defaults to 'Bad Request').
+     * @param code - Error code (defaults to 'BAD_REQUEST').
+     * @param details - Optional details.
+     */
+    constructor(message = 'Bad Request', code = 'BAD_REQUEST', details) {
+        super(message, 400, code, details);
+        this.name = 'BadRequestError';
+    }
+}
+/**
+ * HTTP 401 Unauthorized error.
+ */
+export class UnauthorizedError extends AeroError {
+    /**
+     * Creates an UnauthorizedError.
+     *
+     * @param message - Error message (defaults to 'Unauthorized').
+     * @param code - Error code (defaults to 'UNAUTHORIZED').
+     * @param details - Optional details.
+     */
+    constructor(message = 'Unauthorized', code = 'UNAUTHORIZED', details) {
+        super(message, 401, code, details);
+        this.name = 'UnauthorizedError';
+    }
+}
+/**
+ * HTTP 403 Forbidden error.
+ */
+export class ForbiddenError extends AeroError {
+    /**
+     * Creates a ForbiddenError.
+     *
+     * @param message - Error message (defaults to 'Forbidden').
+     * @param code - Error code (defaults to 'FORBIDDEN').
+     * @param details - Optional details.
+     */
+    constructor(message = 'Forbidden', code = 'FORBIDDEN', details) {
+        super(message, 403, code, details);
+        this.name = 'ForbiddenError';
+    }
+}
+/**
+ * HTTP 404 Not Found error.
+ */
+export class NotFoundError extends AeroError {
+    /**
+     * Creates a NotFoundError.
+     *
+     * @param message - Error message (defaults to 'Not Found').
+     * @param code - Error code (defaults to 'NOT_FOUND').
+     * @param details - Optional details.
+     */
+    constructor(message = 'Not Found', code = 'NOT_FOUND', details) {
+        super(message, 404, code, details);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * HTTP 405 Method Not Allowed error.
+ */
+export class MethodNotAllowedError extends AeroError {
+    /**
+     * Array of allowed HTTP methods for the requested path.
+     */
+    allowedMethods;
+    /**
+     * Creates a MethodNotAllowedError.
+     *
+     * @param message - Error message (defaults to 'Method Not Allowed').
+     * @param allowedMethods - List of allowed HTTP methods.
+     * @param code - Error code (defaults to 'METHOD_NOT_ALLOWED').
+     */
+    constructor(message = 'Method Not Allowed', allowedMethods = [], code = 'METHOD_NOT_ALLOWED') {
+        super(message, 405, code, { allowed: allowedMethods });
+        this.name = 'MethodNotAllowedError';
+        this.allowedMethods = allowedMethods;
+    }
+}
+/**
+ * HTTP 413 Payload Too Large error.
+ */
+export class PayloadTooLargeError extends AeroError {
+    /**
+     * Creates a PayloadTooLargeError.
+     *
+     * @param message - Error message (defaults to 'Payload Too Large').
+     * @param code - Error code (defaults to 'PAYLOAD_TOO_LARGE').
+     * @param details - Optional details.
+     */
+    constructor(message = 'Payload Too Large', code = 'PAYLOAD_TOO_LARGE', details) {
+        super(message, 413, code, details);
+        this.name = 'PayloadTooLargeError';
+    }
+}
+/**
+ * HTTP 415 Unsupported Media Type error.
+ */
+export class UnsupportedMediaTypeError extends AeroError {
+    /**
+     * Creates an UnsupportedMediaTypeError.
+     *
+     * @param message - Error message (defaults to 'Unsupported Media Type').
+     * @param code - Error code (defaults to 'UNSUPPORTED_MEDIA_TYPE').
+     * @param details - Optional details.
+     */
+    constructor(message = 'Unsupported Media Type', code = 'UNSUPPORTED_MEDIA_TYPE', details) {
+        super(message, 415, code, details);
+        this.name = 'UnsupportedMediaTypeError';
+    }
+}
+/**
+ * HTTP 500 Internal Server Error.
+ */
+export class InternalError extends AeroError {
+    /**
+     * Creates an InternalError.
+     *
+     * @param message - Error message (defaults to 'Internal Server Error').
+     * @param code - Error code (defaults to 'INTERNAL_SERVER_ERROR').
+     * @param details - Optional details.
+     */
+    constructor(message = 'Internal Server Error', code = 'INTERNAL_SERVER_ERROR', details) {
+        super(message, 500, code, details);
+        this.name = 'InternalError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/events/event-bus.d.ts

@@ -0,0 +1,178 @@
+/**
+ * @file event-bus.ts
+ * @description Domain Event Bus for AeroJS.
+ * Implements the Reactive Event Bus pattern from Architecture Section 2.
+ *
+ * Hospital domain events flow:
+ *   PaymentReceived     → PostToGeneralLedgerListener, PrintReceiptListener
+ *   LabResultReady      → SendLabResultSmsListener, NotifyDoctorListener
+ *   PatientAdmitted     → AllocateBedListener, CreateEncounterListener
+ *   CodeBlueTriggered   → BroadcastSosListener, LogResponseTimeListener
+ *   ShiftClosed         → ReconcileCashDrawerListener, GenerateShiftReportListener
+ */
+export declare abstract class DomainEvent {
+    readonly occurredAt: Date;
+    readonly eventId: string;
+    constructor();
+    /**
+     * Override to return the event name used for listener registration.
+     * Default: class name, e.g. "LabResultReadyEvent"
+     */
+    eventName(): string;
+}
+export interface EventListener<T extends DomainEvent = DomainEvent> {
+    handle(event: T): Promise<void> | void;
+}
+export type EventListenerFn<T extends DomainEvent = DomainEvent> = (event: T) => Promise<void> | void;
+export type ListenerOrFn<T extends DomainEvent> = EventListener<T> | EventListenerFn<T>;
+export declare class EventBus {
+    private listeners;
+    private onceListeners;
+    /**
+     * Register a permanent listener for an event.
+     *
+     * @example
+     * EventBus.on('LabResultReadyEvent', SendLabResultSmsListener);
+     * EventBus.on('PaymentReceivedEvent', async (event) => { ... });
+     */
+    on<T extends DomainEvent>(eventNameOrClass: string | (new (...args: any[]) => T), listener: ListenerOrFn<T>): this;
+    /**
+     * Register a one-time listener (removed after first dispatch).
+     */
+    once<T extends DomainEvent>(eventNameOrClass: string | (new (...args: any[]) => T), listener: ListenerOrFn<T>): this;
+    /**
+     * Remove a listener.
+     */
+    off<T extends DomainEvent>(eventNameOrClass: string | (new (...args: any[]) => T), listener: ListenerOrFn<T>): this;
+    /**
+     * Dispatches an event to all registered listeners.
+     * Listeners run in registration order. Errors are caught per-listener.
+     *
+     * @example
+     * await EventBus.emit(new LabResultReadyEvent({ encounterId, testId, isPanic: true }));
+     */
+    emit<T extends DomainEvent>(event: T): Promise<void>;
+    /**
+     * Dispatches an event asynchronously in the background (fire-and-forget).
+     * The current request does not wait for listeners to complete.
+     *
+     * Hospital use: After saving a payment, fire PostToGeneralLedgerEvent in background.
+     */
+    emitAsync<T extends DomainEvent>(event: T): void;
+    /**
+     * Remove all listeners for a specific event (useful in tests).
+     */
+    removeAllListeners(eventName?: string): this;
+    /**
+     * Returns the count of registered listeners for an event.
+     */
+    listenerCount(eventName: string): number;
+}
+export declare const Events: EventBus;
+/** Fired when a patient is registered or re-admitted. */
+export declare class PatientAdmittedEvent extends DomainEvent {
+    readonly data: {
+        patientId: string | number;
+        encounterId: string | number;
+        bedId?: string | number;
+        wardId?: string | number;
+        admittedBy: string | number;
+    };
+    constructor(data: {
+        patientId: string | number;
+        encounterId: string | number;
+        bedId?: string | number;
+        wardId?: string | number;
+        admittedBy: string | number;
+    });
+}
+/** Fired when a lab result is finalized and signed by pathologist. */
+export declare class LabResultReadyEvent extends DomainEvent {
+    readonly data: {
+        encounterId: string | number;
+        testId: string | number;
+        patientPhone?: string;
+        isPanic: boolean;
+        doctorId?: string | number;
+    };
+    constructor(data: {
+        encounterId: string | number;
+        testId: string | number;
+        patientPhone?: string;
+        isPanic: boolean;
+        doctorId?: string | number;
+    });
+}
+/** Fired when a cash payment is received at any counter. */
+export declare class PaymentReceivedEvent extends DomainEvent {
+    readonly data: {
+        invoiceId: string | number;
+        amount: number;
+        cashierId: string | number;
+        terminalId: string | number;
+        shiftSessionId: string | number;
+        paymentMethod: 'cash' | 'card' | 'mobile_banking' | 'corporate';
+    };
+    constructor(data: {
+        invoiceId: string | number;
+        amount: number;
+        cashierId: string | number;
+        terminalId: string | number;
+        shiftSessionId: string | number;
+        paymentMethod: 'cash' | 'card' | 'mobile_banking' | 'corporate';
+    });
+}
+/** Fired when a Code Blue emergency is triggered at any bed/floor. */
+export declare class CodeBlueTriggeredEvent extends DomainEvent {
+    readonly data: {
+        bedId: string | number;
+        floorId: string | number;
+        wardId: string | number;
+        triggeredBy: string | number;
+        patientId?: string | number;
+    };
+    constructor(data: {
+        bedId: string | number;
+        floorId: string | number;
+        wardId: string | number;
+        triggeredBy: string | number;
+        patientId?: string | number;
+    });
+}
+/** Fired when a cashier closes their shift. */
+export declare class ShiftClosedEvent extends DomainEvent {
+    readonly data: {
+        shiftSessionId: string | number;
+        cashierId: string | number;
+        terminalId: string | number;
+        physicalCash: number;
+        systemExpected: number;
+        discrepancy: number;
+    };
+    constructor(data: {
+        shiftSessionId: string | number;
+        cashierId: string | number;
+        terminalId: string | number;
+        physicalCash: number;
+        systemExpected: number;
+        discrepancy: number;
+    });
+}
+/** Fired when a stock item falls below reorder level. */
+export declare class LowStockAlertEvent extends DomainEvent {
+    readonly data: {
+        itemId: string | number;
+        itemName: string;
+        storeId: string | number;
+        currentQty: number;
+        reorderLevel: number;
+    };
+    constructor(data: {
+        itemId: string | number;
+        itemName: string;
+        storeId: string | number;
+        currentQty: number;
+        reorderLevel: number;
+    });
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/events/event-bus.d.ts.map

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

package/dist/events/event-bus.js

@@ -0,0 +1,182 @@
+/**
+ * @file event-bus.ts
+ * @description Domain Event Bus for AeroJS.
+ * Implements the Reactive Event Bus pattern from Architecture Section 2.
+ *
+ * Hospital domain events flow:
+ *   PaymentReceived     → PostToGeneralLedgerListener, PrintReceiptListener
+ *   LabResultReady      → SendLabResultSmsListener, NotifyDoctorListener
+ *   PatientAdmitted     → AllocateBedListener, CreateEncounterListener
+ *   CodeBlueTriggered   → BroadcastSosListener, LogResponseTimeListener
+ *   ShiftClosed         → ReconcileCashDrawerListener, GenerateShiftReportListener
+ */
+// ─── Base Event ───────────────────────────────────────────────────────────────
+export class DomainEvent {
+    occurredAt = new Date();
+    eventId;
+    constructor() {
+        this.eventId = `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    }
+    /**
+     * Override to return the event name used for listener registration.
+     * Default: class name, e.g. "LabResultReadyEvent"
+     */
+    eventName() {
+        return this.constructor.name;
+    }
+}
+// ─── Event Bus ────────────────────────────────────────────────────────────────
+export class EventBus {
+    listeners = new Map();
+    onceListeners = new Map();
+    /**
+     * Register a permanent listener for an event.
+     *
+     * @example
+     * EventBus.on('LabResultReadyEvent', SendLabResultSmsListener);
+     * EventBus.on('PaymentReceivedEvent', async (event) => { ... });
+     */
+    on(eventNameOrClass, listener) {
+        const name = typeof eventNameOrClass === 'string' ? eventNameOrClass : eventNameOrClass.name;
+        if (!this.listeners.has(name))
+            this.listeners.set(name, []);
+        this.listeners.get(name).push(listener);
+        return this;
+    }
+    /**
+     * Register a one-time listener (removed after first dispatch).
+     */
+    once(eventNameOrClass, listener) {
+        const name = typeof eventNameOrClass === 'string' ? eventNameOrClass : eventNameOrClass.name;
+        if (!this.onceListeners.has(name))
+            this.onceListeners.set(name, []);
+        this.onceListeners.get(name).push(listener);
+        return this;
+    }
+    /**
+     * Remove a listener.
+     */
+    off(eventNameOrClass, listener) {
+        const name = typeof eventNameOrClass === 'string' ? eventNameOrClass : eventNameOrClass.name;
+        const list = this.listeners.get(name);
+        if (list) {
+            this.listeners.set(name, list.filter((l) => l !== listener));
+        }
+        return this;
+    }
+    /**
+     * Dispatches an event to all registered listeners.
+     * Listeners run in registration order. Errors are caught per-listener.
+     *
+     * @example
+     * await EventBus.emit(new LabResultReadyEvent({ encounterId, testId, isPanic: true }));
+     */
+    async emit(event) {
+        const name = event.eventName();
+        const allListeners = [
+            ...(this.listeners.get(name) ?? []),
+        ];
+        // Fire-and-forget once listeners
+        const onceList = this.onceListeners.get(name) ?? [];
+        this.onceListeners.delete(name);
+        allListeners.push(...onceList);
+        for (const listener of allListeners) {
+            try {
+                if (typeof listener === 'function') {
+                    await listener(event);
+                }
+                else {
+                    await listener.handle(event);
+                }
+            }
+            catch (err) {
+                console.error(`[AeroJS EventBus] Listener for "${name}" threw an error:`, err);
+            }
+        }
+    }
+    /**
+     * Dispatches an event asynchronously in the background (fire-and-forget).
+     * The current request does not wait for listeners to complete.
+     *
+     * Hospital use: After saving a payment, fire PostToGeneralLedgerEvent in background.
+     */
+    emitAsync(event) {
+        setImmediate(() => {
+            this.emit(event).catch((err) => {
+                console.error(`[AeroJS EventBus] Async emit error for "${event.eventName()}":`, err);
+            });
+        });
+    }
+    /**
+     * Remove all listeners for a specific event (useful in tests).
+     */
+    removeAllListeners(eventName) {
+        if (eventName) {
+            this.listeners.delete(eventName);
+            this.onceListeners.delete(eventName);
+        }
+        else {
+            this.listeners.clear();
+            this.onceListeners.clear();
+        }
+        return this;
+    }
+    /**
+     * Returns the count of registered listeners for an event.
+     */
+    listenerCount(eventName) {
+        return (this.listeners.get(eventName) ?? []).length;
+    }
+}
+// ─── Singleton EventBus ───────────────────────────────────────────────────────
+export const Events = new EventBus();
+// ─── Hospital Domain Events ───────────────────────────────────────────────────
+/** Fired when a patient is registered or re-admitted. */
+export class PatientAdmittedEvent extends DomainEvent {
+    data;
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+/** Fired when a lab result is finalized and signed by pathologist. */
+export class LabResultReadyEvent extends DomainEvent {
+    data;
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+/** Fired when a cash payment is received at any counter. */
+export class PaymentReceivedEvent extends DomainEvent {
+    data;
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+/** Fired when a Code Blue emergency is triggered at any bed/floor. */
+export class CodeBlueTriggeredEvent extends DomainEvent {
+    data;
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+/** Fired when a cashier closes their shift. */
+export class ShiftClosedEvent extends DomainEvent {
+    data;
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+/** Fired when a stock item falls below reorder level. */
+export class LowStockAlertEvent extends DomainEvent {
+    data;
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/events/event-bus.js.map

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

package/dist/graphql/adapter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file adapter.ts
+ * @description Active Record Model to GraphQL Schema Adapter.
+ */
+import { GraphQLObjectType, GraphQLList, GraphQLNonNull } from './types.js';
+export declare function createModelGraphQLType(ModelClass: any): GraphQLObjectType;
+/**
+ * Generates standard CRUD Query and Mutation fields for a given Model.
+ */
+export declare function generateCRUDFields(ModelClass: any, type: GraphQLObjectType): {
+    queries: {
+        [x: string]: {
+            type: GraphQLList;
+            resolve: () => Promise<any>;
+        };
+        [x: number]: {
+            type: GraphQLObjectType;
+            args: {
+                id: {
+                    type: GraphQLNonNull;
+                };
+            };
+            resolve: (_: any, args: any) => Promise<any>;
+        };
+    };
+    mutations: {
+        [x: string]: {
+            type: GraphQLObjectType;
+            args: {
+                data: {
+                    type: import("./types.js").GraphQLScalarType;
+                };
+                id?: undefined;
+            };
+            resolve: (_: any, args: any) => Promise<any>;
+        } | {
+            type: import("./types.js").GraphQLScalarType;
+            args: {
+                id: {
+                    type: GraphQLNonNull;
+                };
+                data?: undefined;
+            };
+            resolve: (_: any, args: any) => Promise<boolean>;
+        };
+    };
+};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/graphql/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/graphql/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iBAAiB,EAMjB,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,GAAG,GAAG,iBAAiB,CAiDzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;yBAgBhD,GAAG,QAAQ,GAAG;;;;;;;;;;;;yBAYd,GAAG,QAAQ,GAAG;;;;;;;;;yBAWd,GAAG,QAAQ,GAAG;;;EAWxC"}