@blac/core 2.0.0-rc-14 → 2.0.0-rc.0

package/dist/adapter/ProxyFactory.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProxyFactory = exports.createBlocProxy = exports.createStateProxy = void 0;
+// Minimal cache for backward compatibility
+const proxyCache = new WeakMap();
+// Minimal stats for backward compatibility
+const stats = {
+    stateProxiesCreated: 0,
+    classProxiesCreated: 0,
+    cacheHits: 0,
+    cacheMisses: 0,
+    totalProxiesCreated: 0,
+};
+/**
+ * Creates a proxy for state objects that tracks property access
+ */
+const createStateProxy = (target, consumerRef, consumerTracker, path = '') => {
+    if (!consumerRef ||
+        !consumerTracker ||
+        typeof target !== 'object' ||
+        target === null) {
+        return target;
+    }
+    // Check cache for backward compatibility with tests
+    if (!path) {
+        // Only cache root objects
+        let refCache = proxyCache.get(target);
+        if (!refCache) {
+            refCache = new WeakMap();
+            proxyCache.set(target, refCache);
+        }
+        const cached = refCache.get(consumerRef);
+        if (cached) {
+            stats.cacheHits++;
+            return cached;
+        }
+        stats.cacheMisses++;
+    }
+    const proxy = new Proxy(target, {
+        get(obj, prop) {
+            // Handle symbols and special properties
+            if (typeof prop === 'symbol' || prop === 'constructor') {
+                return Reflect.get(obj, prop);
+            }
+            const fullPath = path ? `${path}.${prop}` : prop;
+            const value = Reflect.get(obj, prop);
+            const isObject = value && typeof value === 'object';
+            // Track access with value for primitives
+            consumerTracker.trackAccess(consumerRef, 'state', fullPath, isObject ? undefined : value);
+            // Recursively proxy nested objects and arrays
+            if (isObject &&
+                (Array.isArray(value) ||
+                    Object.getPrototypeOf(value) === Object.prototype)) {
+                return (0, exports.createStateProxy)(value, consumerRef, consumerTracker, fullPath);
+            }
+            return value;
+        },
+        set: () => false, // State should be immutable
+        deleteProperty: () => false, // State properties should not be deleted
+    });
+    // Cache root proxies
+    if (!path) {
+        const refCache = proxyCache.get(target);
+        refCache.set(consumerRef, proxy);
+        stats.stateProxiesCreated++;
+        stats.totalProxiesCreated++;
+    }
+    return proxy;
+};
+exports.createStateProxy = createStateProxy;
+/**
+ * Creates a proxy for bloc instances that tracks getter access
+ */
+const createBlocProxy = (target, consumerRef, consumerTracker) => {
+    if (!consumerRef || !consumerTracker) {
+        return target;
+    }
+    // Check cache
+    let refCache = proxyCache.get(target);
+    if (!refCache) {
+        refCache = new WeakMap();
+        proxyCache.set(target, refCache);
+    }
+    const cached = refCache.get(consumerRef);
+    if (cached) {
+        stats.cacheHits++;
+        return cached;
+    }
+    stats.cacheMisses++;
+    const proxy = new Proxy(target, {
+        get(obj, prop) {
+            const value = Reflect.get(obj, prop);
+            // Only track getters, not methods or regular properties
+            const descriptor = findPropertyDescriptor(obj, prop);
+            if (descriptor?.get) {
+                // Track getter access with value for primitives
+                const isPrimitive = value !== null && typeof value !== 'object';
+                consumerTracker.trackAccess(consumerRef, 'class', String(prop), isPrimitive ? value : undefined);
+            }
+            return value;
+        },
+    });
+    // Cache proxy
+    refCache.set(consumerRef, proxy);
+    stats.classProxiesCreated++;
+    stats.totalProxiesCreated++;
+    return proxy;
+};
+exports.createBlocProxy = createBlocProxy;
+/**
+ * Helper to find property descriptor in prototype chain
+ */
+const findPropertyDescriptor = (obj, prop, maxDepth = 10) => {
+    let current = obj;
+    let depth = 0;
+    while (current && depth < maxDepth) {
+        const descriptor = Object.getOwnPropertyDescriptor(current, prop);
+        if (descriptor)
+            return descriptor;
+        current = Object.getPrototypeOf(current);
+        depth++;
+    }
+    return undefined;
+};
+// Export compatibility functions for easier migration
+exports.ProxyFactory = {
+    createStateProxy: (options) => (0, exports.createStateProxy)(options.target, options.consumerRef, options.consumerTracker, options.path),
+    createClassProxy: (options) => (0, exports.createBlocProxy)(options.target, options.consumerRef, options.consumerTracker),
+    getProxyState: (options) => (0, exports.createStateProxy)(options.state, options.consumerRef, options.consumerTracker),
+    getProxyBlocInstance: (options) => (0, exports.createBlocProxy)(options.blocInstance, options.consumerRef, options.consumerTracker),
+    // Compatibility functions that return expected structure
+    getStats: () => ({
+        ...stats,
+        propertyAccesses: 0,
+        nestedProxiesCreated: 0,
+        cacheEfficiency: stats.cacheHits + stats.cacheMisses > 0
+            ? `${((stats.cacheHits / (stats.cacheHits + stats.cacheMisses)) * 100).toFixed(1)}%`
+            : 'N/A',
+        lifetime: '0ms',
+        proxiesPerSecond: 'N/A',
+    }),
+    resetStats: () => {
+        stats.stateProxiesCreated = 0;
+        stats.classProxiesCreated = 0;
+        stats.cacheHits = 0;
+        stats.cacheMisses = 0;
+        stats.totalProxiesCreated = 0;
+    },
+};
+//# sourceMappingURL=ProxyFactory.js.map

package/dist/adapter/ProxyFactory.js.map

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

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

@@ -1,2 +1,3 @@
 export * from './BlacAdapter';
 export * from './ProxyFactory';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/adapter/index.js

@@ -0,0 +1,19 @@
+"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("./BlacAdapter"), exports);
+__exportStar(require("./ProxyFactory"), exports);
+//# sourceMappingURL=index.js.map

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