@blac/core 2.0.0-rc-16 → 2.0.0-rc.1

package/dist/adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,iDAA+B"}

package/dist/errors/BlacError.d.ts

@@ -0,0 +1,38 @@
+export declare enum ErrorCategory {
+    LIFECYCLE = "LIFECYCLE",
+    STATE = "STATE",
+    PLUGIN = "PLUGIN",
+    VALIDATION = "VALIDATION",
+    DISPOSAL = "DISPOSAL",
+    CONSUMER = "CONSUMER"
+}
+export declare enum ErrorSeverity {
+    FATAL = "FATAL",// System cannot continue
+    ERROR = "ERROR",// Operation failed but system continues
+    WARNING = "WARNING",// Potential issue but operation succeeded
+    INFO = "INFO"
+}
+export type BlacErrorContext = {
+    blocName?: string;
+    blocId?: string;
+    consumerId?: string;
+    pluginName?: string;
+    operation?: string;
+    metadata?: Record<string, unknown>;
+};
+export declare class BlacError extends Error {
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly context?: BlacErrorContext | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, category: ErrorCategory, severity: ErrorSeverity, context?: BlacErrorContext | undefined, cause?: unknown | undefined);
+    toString(): string;
+}
+export type ErrorHandler = (error: BlacError) => void;
+export type ErrorHandlingStrategy = {
+    shouldPropagate: (error: BlacError) => boolean;
+    shouldLog: (error: BlacError) => boolean;
+    handle: (error: BlacError) => void;
+};
+export declare const DefaultErrorStrategy: ErrorHandlingStrategy;
+//# sourceMappingURL=BlacError.d.ts.map

package/dist/errors/BlacError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlacError.d.ts","sourceRoot":"","sources":["../../src/errors/BlacError.ts"],"names":[],"mappings":"AAAA,oBAAY,aAAa;IACvB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAED,oBAAY,aAAa;IACvB,KAAK,UAAU,CAAE,yBAAyB;IAC1C,KAAK,UAAU,CAAE,wCAAwC;IACzD,OAAO,YAAY,CAAE,0CAA0C;IAC/D,IAAI,SAAS;CACd;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,qBAAa,SAAU,SAAQ,KAAK;aAGhB,QAAQ,EAAE,aAAa;aACvB,QAAQ,EAAE,aAAa;aACvB,OAAO,CAAC,EAAE,gBAAgB;aAC1B,KAAK,CAAC,EAAE,OAAO;gBAJ/B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,gBAAgB,YAAA,EAC1B,KAAK,CAAC,EAAE,OAAO,YAAA;IASjC,QAAQ,IAAI,MAAM;CAUnB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAEtD,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;IAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;IACzC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,qBAQlC,CAAC"}

package/dist/errors/BlacError.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultErrorStrategy = exports.BlacError = exports.ErrorSeverity = exports.ErrorCategory = void 0;
+var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["LIFECYCLE"] = "LIFECYCLE";
+    ErrorCategory["STATE"] = "STATE";
+    ErrorCategory["PLUGIN"] = "PLUGIN";
+    ErrorCategory["VALIDATION"] = "VALIDATION";
+    ErrorCategory["DISPOSAL"] = "DISPOSAL";
+    ErrorCategory["CONSUMER"] = "CONSUMER";
+})(ErrorCategory || (exports.ErrorCategory = ErrorCategory = {}));
+var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["FATAL"] = "FATAL";
+    ErrorSeverity["ERROR"] = "ERROR";
+    ErrorSeverity["WARNING"] = "WARNING";
+    ErrorSeverity["INFO"] = "INFO";
+})(ErrorSeverity || (exports.ErrorSeverity = ErrorSeverity = {}));
+class BlacError extends Error {
+    category;
+    severity;
+    context;
+    cause;
+    constructor(message, category, severity, context, cause) {
+        super(message);
+        this.category = category;
+        this.severity = severity;
+        this.context = context;
+        this.cause = cause;
+        this.name = 'BlacError';
+        // Ensure proper prototype chain
+        Object.setPrototypeOf(this, BlacError.prototype);
+    }
+    toString() {
+        const contextStr = this.context
+            ? ` [${Object.entries(this.context)
+                .filter(([_, v]) => v !== undefined)
+                .map(([k, v]) => `${k}: ${v}`)
+                .join(', ')}]`
+            : '';
+        return `${this.name} [${this.severity}/${this.category}]: ${this.message}${contextStr}`;
+    }
+}
+exports.BlacError = BlacError;
+exports.DefaultErrorStrategy = {
+    shouldPropagate: (error) => error.severity === ErrorSeverity.FATAL,
+    shouldLog: (error) => error.severity !== ErrorSeverity.INFO,
+    handle: (error) => {
+        if (exports.DefaultErrorStrategy.shouldLog(error)) {
+            console.error(error.toString(), error.cause);
+        }
+    },
+};
+//# sourceMappingURL=BlacError.js.map

package/dist/errors/BlacError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlacError.js","sourceRoot":"","sources":["../../src/errors/BlacError.ts"],"names":[],"mappings":";;;AAAA,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,wCAAuB,CAAA;IACvB,gCAAe,CAAA;IACf,kCAAiB,CAAA;IACjB,0CAAyB,CAAA;IACzB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;AACvB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB;AAED,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,8BAAa,CAAA;AACf,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB;AAWD,MAAa,SAAU,SAAQ,KAAK;IAGhB;IACA;IACA;IACA;IALlB,YACE,OAAe,EACC,QAAuB,EACvB,QAAuB,EACvB,OAA0B,EAC1B,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,aAAQ,GAAR,QAAQ,CAAe;QACvB,aAAQ,GAAR,QAAQ,CAAe;QACvB,YAAO,GAAP,OAAO,CAAmB;QAC1B,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QAExB,gCAAgC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,QAAQ;QACN,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO;YAC7B,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;iBAC9B,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;iBACnC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;iBAC7B,IAAI,CAAC,IAAI,CAAC,GAAG;YAClB,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,OAAO,GAAG,UAAU,EAAE,CAAC;IAC1F,CAAC;CACF;AAzBD,8BAyBC;AAUY,QAAA,oBAAoB,GAA0B;IACzD,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,KAAK;IAClE,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,IAAI;IAC3D,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,4BAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/errors/ErrorManager.d.ts

@@ -0,0 +1,39 @@
+import { BlacError, ErrorHandler, ErrorHandlingStrategy } from './BlacError';
+/**
+ * Centralized error management system for BlaC framework.
+ * Handles error processing, logging, and propagation strategies.
+ */
+export declare class ErrorManager {
+    private static instance;
+    private handlers;
+    private strategy;
+    /**
+     * Get the singleton instance of ErrorManager
+     */
+    static getInstance(): ErrorManager;
+    /**
+     * Set a custom error handling strategy
+     */
+    setStrategy(strategy: ErrorHandlingStrategy): void;
+    /**
+     * Add a custom error handler that will be called for all errors
+     */
+    addHandler(handler: ErrorHandler): void;
+    /**
+     * Remove a previously added error handler
+     */
+    removeHandler(handler: ErrorHandler): void;
+    /**
+     * Process an error through all handlers and apply the configured strategy
+     */
+    handle(error: BlacError): void;
+    /**
+     * Convenience method for wrapping operations with error handling
+     */
+    wrap<T>(operation: () => T, errorFactory: (error: unknown) => BlacError): T;
+    /**
+     * Async version of wrap
+     */
+    wrapAsync<T>(operation: () => Promise<T>, errorFactory: (error: unknown) => BlacError): Promise<T>;
+}
+//# sourceMappingURL=ErrorManager.d.ts.map

package/dist/errors/ErrorManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorManager.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,QAAQ,CAA+C;IAE/D;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAIlD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIvC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI1C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAoB9B;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,GAAG,CAAC;IAW3E;;OAEG;IACG,SAAS,CAAC,CAAC,EACf,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,GAC1C,OAAO,CAAC,CAAC,CAAC;CAUd"}

package/dist/errors/ErrorManager.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorManager = void 0;
+const BlacError_1 = require("./BlacError");
+/**
+ * Centralized error management system for BlaC framework.
+ * Handles error processing, logging, and propagation strategies.
+ */
+class ErrorManager {
+    static instance;
+    handlers = new Set();
+    strategy = BlacError_1.DefaultErrorStrategy;
+    /**
+     * Get the singleton instance of ErrorManager
+     */
+    static getInstance() {
+        if (!ErrorManager.instance) {
+            ErrorManager.instance = new ErrorManager();
+        }
+        return ErrorManager.instance;
+    }
+    /**
+     * Set a custom error handling strategy
+     */
+    setStrategy(strategy) {
+        this.strategy = strategy;
+    }
+    /**
+     * Add a custom error handler that will be called for all errors
+     */
+    addHandler(handler) {
+        this.handlers.add(handler);
+    }
+    /**
+     * Remove a previously added error handler
+     */
+    removeHandler(handler) {
+        this.handlers.delete(handler);
+    }
+    /**
+     * Process an error through all handlers and apply the configured strategy
+     */
+    handle(error) {
+        // Always notify handlers first
+        this.handlers.forEach((handler) => {
+            try {
+                handler(error);
+            }
+            catch (handlerError) {
+                // Prevent handler errors from breaking error handling
+                console.error('Error in error handler:', handlerError);
+            }
+        });
+        // Apply strategy
+        this.strategy.handle(error);
+        // Propagate if needed
+        if (this.strategy.shouldPropagate(error)) {
+            throw error;
+        }
+    }
+    /**
+     * Convenience method for wrapping operations with error handling
+     */
+    wrap(operation, errorFactory) {
+        try {
+            return operation();
+        }
+        catch (error) {
+            const blacError = errorFactory(error);
+            this.handle(blacError);
+            // Will only reach here if strategy says not to propagate
+            return undefined;
+        }
+    }
+    /**
+     * Async version of wrap
+     */
+    async wrapAsync(operation, errorFactory) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            const blacError = errorFactory(error);
+            this.handle(blacError);
+            // Will only reach here if strategy says not to propagate
+            return undefined;
+        }
+    }
+}
+exports.ErrorManager = ErrorManager;
+//# sourceMappingURL=ErrorManager.js.map

package/dist/errors/ErrorManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorManager.js","sourceRoot":"","sources":["../../src/errors/ErrorManager.ts"],"names":[],"mappings":";;;AAAA,2CAKqB;AAErB;;;GAGG;AACH,MAAa,YAAY;IACf,MAAM,CAAC,QAAQ,CAAe;IAC9B,QAAQ,GAAsB,IAAI,GAAG,EAAE,CAAC;IACxC,QAAQ,GAA0B,gCAAoB,CAAC;IAE/D;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAA+B;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAqB;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAqB;QACjC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAgB;QACrB,+BAA+B;QAC/B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAChC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,YAAY,EAAE,CAAC;gBACtB,sDAAsD;gBACtD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,iBAAiB;QACjB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE5B,sBAAsB;QACtB,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAI,SAAkB,EAAE,YAA2C;QACrE,IAAI,CAAC;YACH,OAAO,SAAS,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACvB,yDAAyD;YACzD,OAAO,SAAc,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACb,SAA2B,EAC3B,YAA2C;QAE3C,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACvB,yDAAyD;YACzD,OAAO,SAAc,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAzFD,oCAyFC"}

package/dist/errors/handleError.d.ts

@@ -0,0 +1,24 @@
+import { ErrorCategory, ErrorSeverity, BlacErrorContext } from './BlacError';
+/**
+ * Standard error handling helper for BlaC
+ *
+ * Usage:
+ * - For fatal errors that should propagate: handleError.fatal(...)
+ * - For recoverable errors: handleError.error(...)
+ * - For warnings: handleError.warn(...)
+ */
+export declare const handleError: {
+    fatal: (message: string, category: ErrorCategory, context?: BlacErrorContext, cause?: unknown) => never;
+    error: (message: string, category: ErrorCategory, context?: BlacErrorContext, cause?: unknown) => void;
+    warn: (message: string, category: ErrorCategory, context?: BlacErrorContext, cause?: unknown) => void;
+    info: (message: string, category: ErrorCategory, context?: BlacErrorContext) => void;
+    /**
+     * Wraps a function to catch and handle errors
+     */
+    wrap: <T>(fn: () => T, category: ErrorCategory, context?: BlacErrorContext, severity?: ErrorSeverity) => T | undefined;
+    /**
+     * Wraps an async function to catch and handle errors
+     */
+    wrapAsync: <T>(fn: () => Promise<T>, category: ErrorCategory, context?: BlacErrorContext, severity?: ErrorSeverity) => Promise<T | undefined>;
+};
+//# sourceMappingURL=handleError.d.ts.map

package/dist/errors/handleError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleError.d.ts","sourceRoot":"","sources":["../../src/errors/handleError.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAGrB;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;qBAEX,MAAM,YACL,aAAa,YACb,gBAAgB,UAClB,OAAO,KACd,KAAK;qBAcG,MAAM,YACL,aAAa,YACb,gBAAgB,UAClB,OAAO,KACd,IAAI;oBAYI,MAAM,YACL,aAAa,YACb,gBAAgB,UAClB,OAAO,KACd,IAAI;oBAYI,MAAM,YACL,aAAa,YACb,gBAAgB,KACzB,IAAI;IAKP;;OAEG;WACI,CAAC,MACF,MAAM,CAAC,YACD,aAAa,YACb,gBAAgB,aAChB,aAAa,KACtB,CAAC,GAAG,SAAS;IAWhB;;OAEG;gBACe,CAAC,MACb,MAAM,OAAO,CAAC,CAAC,CAAC,YACV,aAAa,YACb,gBAAgB,aAChB,aAAa,KACtB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAU1B,CAAC"}

package/dist/errors/handleError.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleError = void 0;
+const BlacError_1 = require("./BlacError");
+const ErrorManager_1 = require("./ErrorManager");
+/**
+ * Standard error handling helper for BlaC
+ *
+ * Usage:
+ * - For fatal errors that should propagate: handleError.fatal(...)
+ * - For recoverable errors: handleError.error(...)
+ * - For warnings: handleError.warn(...)
+ */
+exports.handleError = {
+    fatal: (message, category, context, cause) => {
+        const error = new BlacError_1.BlacError(message, category, BlacError_1.ErrorSeverity.FATAL, context, cause);
+        ErrorManager_1.ErrorManager.getInstance().handle(error);
+        // This will always throw due to FATAL severity
+        throw error;
+    },
+    error: (message, category, context, cause) => {
+        const error = new BlacError_1.BlacError(message, category, BlacError_1.ErrorSeverity.ERROR, context, cause);
+        ErrorManager_1.ErrorManager.getInstance().handle(error);
+    },
+    warn: (message, category, context, cause) => {
+        const error = new BlacError_1.BlacError(message, category, BlacError_1.ErrorSeverity.WARNING, context, cause);
+        ErrorManager_1.ErrorManager.getInstance().handle(error);
+    },
+    info: (message, category, context) => {
+        const error = new BlacError_1.BlacError(message, category, BlacError_1.ErrorSeverity.INFO, context);
+        ErrorManager_1.ErrorManager.getInstance().handle(error);
+    },
+    /**
+     * Wraps a function to catch and handle errors
+     */
+    wrap: (fn, category, context, severity = BlacError_1.ErrorSeverity.ERROR) => {
+        try {
+            return fn();
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            const error = new BlacError_1.BlacError(message, category, severity, context, cause);
+            ErrorManager_1.ErrorManager.getInstance().handle(error);
+            return undefined;
+        }
+    },
+    /**
+     * Wraps an async function to catch and handle errors
+     */
+    wrapAsync: async (fn, category, context, severity = BlacError_1.ErrorSeverity.ERROR) => {
+        try {
+            return await fn();
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            const error = new BlacError_1.BlacError(message, category, severity, context, cause);
+            ErrorManager_1.ErrorManager.getInstance().handle(error);
+            return undefined;
+        }
+    },
+};
+//# sourceMappingURL=handleError.js.map

package/dist/errors/handleError.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,5 @@
+export { BlacError, ErrorCategory, ErrorSeverity, DefaultErrorStrategy, } from './BlacError';
+export type { BlacErrorContext, ErrorHandler, ErrorHandlingStrategy, } from './BlacError';
+export { ErrorManager } from './ErrorManager';
+export { handleError } from './handleError';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleError = exports.ErrorManager = exports.DefaultErrorStrategy = exports.ErrorSeverity = exports.ErrorCategory = exports.BlacError = void 0;
+var BlacError_1 = require("./BlacError");
+Object.defineProperty(exports, "BlacError", { enumerable: true, get: function () { return BlacError_1.BlacError; } });
+Object.defineProperty(exports, "ErrorCategory", { enumerable: true, get: function () { return BlacError_1.ErrorCategory; } });
+Object.defineProperty(exports, "ErrorSeverity", { enumerable: true, get: function () { return BlacError_1.ErrorSeverity; } });
+Object.defineProperty(exports, "DefaultErrorStrategy", { enumerable: true, get: function () { return BlacError_1.DefaultErrorStrategy; } });
+var ErrorManager_1 = require("./ErrorManager");
+Object.defineProperty(exports, "ErrorManager", { enumerable: true, get: function () { return ErrorManager_1.ErrorManager; } });
+var handleError_1 = require("./handleError");
+Object.defineProperty(exports, "handleError", { enumerable: true, get: function () { return handleError_1.handleError; } });
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,yCAKqB;AAJnB,sGAAA,SAAS,OAAA;AACT,0GAAA,aAAa,OAAA;AACb,0GAAA,aAAa,OAAA;AACb,iHAAA,oBAAoB,OAAA;AAOtB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA"}

package/{src/events.ts → dist/events.d.ts}

@@ -4,6 +4,8 @@
  * about prop changes in React components.
  * @template P - The type of props being updated
  */
-export class PropsUpdated<P = any> {
-  constructor(public readonly props: P) {}
+export declare class PropsUpdated<P = any> {
+    readonly props: P;
+    constructor(props: P);
 }
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,GAAG;aACH,KAAK,EAAE,CAAC;gBAAR,KAAK,EAAE,CAAC;CACrC"}

package/dist/events.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropsUpdated = void 0;
+/**
+ * Event fired when props are updated on a Bloc or Cubit instance.
+ * This is primarily used internally by the framework to notify
+ * about prop changes in React components.
+ * @template P - The type of props being updated
+ */
+class PropsUpdated {
+    props;
+    constructor(props) {
+        this.props = props;
+    }
+}
+exports.PropsUpdated = PropsUpdated;
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,YAAY;IACK;IAA5B,YAA4B,KAAQ;QAAR,UAAK,GAAL,KAAK,CAAG;IAAG,CAAC;CACzC;AAFD,oCAEC"}

package/dist/index.cjs

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Blac"), exports);
+__exportStar(require("./Bloc"), exports);
+__exportStar(require("./BlocBase"), exports);
+__exportStar(require("./Cubit"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./events"), exports);
+__exportStar(require("./subscription"), exports);
+__exportStar(require("./lifecycle"), exports);
+// Utilities
+__exportStar(require("./utils/uuid"), exports);
+__exportStar(require("./utils/shallowEqual"), exports);
+__exportStar(require("./utils/generateInstanceId"), exports);
+__exportStar(require("./utils/RerenderLogger"), exports);
+// Test utilities
+__exportStar(require("./testing"), exports);
+// Adapter
+__exportStar(require("./adapter"), exports);
+// Plugins
+__exportStar(require("./plugins"), exports);
+// Error handling
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/{src/index.ts → dist/index.d.ts}

@@ -6,21 +6,12 @@ export * from './types';
 export * from './events';
 export * from './subscription';
 export * from './lifecycle';
-
-// Utilities
 export * from './utils/uuid';
 export * from './utils/shallowEqual';
 export * from './utils/generateInstanceId';
 export * from './utils/RerenderLogger';
-
-// Test utilities
 export * from './testing';
-
-// Adapter
 export * from './adapter';
-
-// Plugins
 export * from './plugins';
-
-// Error handling
 export * from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAG5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Blac"), exports);
+__exportStar(require("./Bloc"), exports);
+__exportStar(require("./BlocBase"), exports);
+__exportStar(require("./Cubit"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./events"), exports);
+__exportStar(require("./subscription"), exports);
+__exportStar(require("./lifecycle"), exports);
+// Utilities
+__exportStar(require("./utils/uuid"), exports);
+__exportStar(require("./utils/shallowEqual"), exports);
+__exportStar(require("./utils/generateInstanceId"), exports);
+__exportStar(require("./utils/RerenderLogger"), exports);
+// Test utilities
+__exportStar(require("./testing"), exports);
+// Adapter
+__exportStar(require("./adapter"), exports);
+// Plugins
+__exportStar(require("./plugins"), exports);
+// Error handling
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,yCAAuB;AACvB,6CAA2B;AAC3B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,iDAA+B;AAC/B,8CAA4B;AAE5B,YAAY;AACZ,+CAA6B;AAC7B,uDAAqC;AACrC,6DAA2C;AAC3C,yDAAuC;AAEvC,iBAAiB;AACjB,4CAA0B;AAE1B,UAAU;AACV,4CAA0B;AAE1B,UAAU;AACV,4CAA0B;AAE1B,iBAAiB;AACjB,2CAAyB"}

package/dist/lifecycle/BlocLifecycle.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Enum representing the lifecycle states of a Bloc instance
+ */
+export declare enum BlocLifecycleState {
+    ACTIVE = "active",
+    DISPOSAL_REQUESTED = "disposal_requested",
+    DISPOSING = "disposing",
+    DISPOSED = "disposed"
+}
+export interface StateTransitionResult {
+    success: boolean;
+    currentState: BlocLifecycleState;
+    previousState: BlocLifecycleState;
+}
+/**
+ * Manages the lifecycle state transitions for Bloc instances.
+ * Ensures atomic state transitions to prevent race conditions during disposal.
+ */
+export declare class BlocLifecycleManager {
+    private disposalState;
+    private disposalLock;
+    private disposalTimer?;
+    private disposalHandler?;
+    get currentState(): BlocLifecycleState;
+    get isDisposed(): boolean;
+    /**
+     * Atomic state transition for disposal
+     */
+    atomicStateTransition(expectedState: BlocLifecycleState, newState: BlocLifecycleState): StateTransitionResult;
+    /**
+     * Schedule disposal after a delay
+     */
+    scheduleDisposal(delay: number, canDispose: () => boolean, onDispose: () => void): void;
+    /**
+     * Cancel disposal if in disposal requested state
+     */
+    cancelDisposal(): boolean;
+    /**
+     * Set disposal handler
+     */
+    setDisposalHandler(handler: (bloc: unknown) => void): void;
+    /**
+     * Get disposal handler
+     */
+    getDisposalHandler(): ((bloc: unknown) => void) | undefined;
+    /**
+     * Clear disposal timer
+     */
+    clearDisposalTimer(): void;
+}
+//# sourceMappingURL=BlocLifecycle.d.ts.map

package/dist/lifecycle/BlocLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlocLifecycle.d.ts","sourceRoot":"","sources":["../../src/lifecycle/BlocLifecycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,kBAAkB,uBAAuB;IACzC,SAAS,cAAc;IACvB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,kBAAkB,CAAC;IACjC,aAAa,EAAE,kBAAkB,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAC,CAA0B;IAChD,OAAO,CAAC,eAAe,CAAC,CAA0B;IAElD,IAAI,YAAY,IAAI,kBAAkB,CAErC;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,qBAAqB,CACnB,aAAa,EAAE,kBAAkB,EACjC,QAAQ,EAAE,kBAAkB,GAC3B,qBAAqB;IAgCxB;;OAEG;IACH,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,OAAO,EACzB,SAAS,EAAE,MAAM,IAAI,GACpB,IAAI;IA+BP;;OAEG;IACH,cAAc,IAAI,OAAO;IAmBzB;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,kBAAkB,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS;IAI3D;;OAEG;IACH,kBAAkB,IAAI,IAAI;CAM3B"}