@blac/core 2.0.0-rc-2 → 2.0.0-rc-3

package/src/index.ts

@@ -1,8 +1,7 @@
 export * from './Blac';
 export * from './BlacObserver';
+export * from './Bloc';
 export * from './BlocBase';
 export * from './Cubit';
-export * from './Bloc';
 export * from './types';
-export * from './BlacPlugin';
-export * from './addons';
+

package/src/BlacObservable.ts

@@ -1,85 +0,0 @@
-import { Blac, BlacLifecycleEvent } from './Blac';
-import { BlocBase } from './BlocBase';
-import { BlocHookDependencyArrayFn } from './types';
-
-/**
- * Represents an observer that can subscribe to state changes in a Bloc
- * @template S - The type of state being observed
- */
-export type BlacObserver<S> = {
-  /** Function to be called when state changes */
-  fn: (newState: S, oldState: S, action?: unknown) => void | Promise<void>;
-  /** Optional function to determine if the observer should be notified of state changes */
-  dependencyArray?: BlocHookDependencyArrayFn<S>;
-  /** Cached state values used for dependency comparison */
-  lastState?: unknown[][];
-  /** Unique identifier for the observer */
-  id: string;
-};
-
-/**
- * A class that manages observers for a Bloc's state changes
- * @template S - The type of state being observed
- */
-export class BlacObservable<S = unknown> {
-  /** The Bloc instance this observable is associated with */
-  bloc: BlocBase<S>;
-
-  /**
-   * Creates a new BlacObservable instance
-   * @param bloc - The Bloc instance to observe
-   */
-  constructor(bloc: BlocBase<S>) {
-    this.bloc = bloc;
-  }
-
-  private _observers = new Set<BlacObserver<S>>();
-
-  /**
-   * Gets the number of active observers
-   * @returns The number of observers currently subscribed
-   */
-  get size(): number {
-    return this._observers.size;
-  }
-
-  /**
-   * Gets the set of all observers
-   * @returns The Set of all BlacObserver instances
-   */
-  get observers() {
-    return this._observers;
-  }
-
-  /**
-   * Subscribes an observer to state changes
-   * @param observer - The observer to subscribe
-   * @returns A function that can be called to unsubscribe the observer
-   */
-  subscribe(observer: BlacObserver<S>): () => void {
-    this._observers.add(observer);
-    Blac.instance.dispatchEvent(BlacLifecycleEvent.LISTENER_ADDED, this.bloc, { listenerId: observer.id });
-    
-    // Immediately notify the new observer with the current state
-    // Pass current state as both newState and oldState for initial notification context
-    void observer.fn(this.bloc.state, this.bloc.state, { initialSubscription: true });
-
-    if (!observer.lastState) {
-      observer.lastState = observer.dependencyArray
-        ? observer.dependencyArray(this.bloc.state)
-        : [];
-    }
-    return () => {
-      this.unsubscribe(observer);
-    }
-  }
-
-  /**
-   * Unsubscribes an observer from state changes
-   * @param observer - The observer to unsubscribe
-   */
-  unsubscribe(observer: BlacObserver<S>) {
-    this._observers.delete(observer);
-    Blac.instance.dispatchEvent(BlacLifecycleEvent.LISTENER_REMOVED, this.bloc, { listenerId: observer.id });
-  }
-}

package/src/BlacPlugin.ts

@@ -1,13 +0,0 @@
-import { BlacLifecycleEvent } from './Blac';
-import { BlocBase } from './BlocBase';
-
-export interface BlacPlugin {
-  name: string;
-
-  onEvent(
-    event: BlacLifecycleEvent,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    bloc: BlocBase<any>,
-    params?: unknown,
-  ): void;
-}

package/src/addons/BlacAddon.ts

@@ -1,17 +0,0 @@
-import { BlocBase } from '../BlocBase';
-
-export type BlacAddonInit = (bloc: BlocBase<any>) => void;
-
-export type BlacAddonEmit = (params: {
-  oldState: unknown;
-  newState: unknown;
-  cubit: BlocBase<any>;
-}) => void;
-
-type BlacAddon = {
-  name: string;
-  onInit?: BlacAddonInit;
-  onEmit?: BlacAddonEmit;
-};
-
-export default BlacAddon;

package/src/addons/Persist.ts

@@ -1,105 +0,0 @@
-import { BlocBase, BlocInstanceId } from '../BlocBase';
-import BlacAddon, { BlacAddonEmit, BlacAddonInit } from './BlacAddon';
-
-type StorageType = 'localStorage' | 'sessionStorage';
-
-function getStorage(type: StorageType): Storage {
-  switch (type) {
-    case 'localStorage':
-      return localStorage;
-    case 'sessionStorage':
-      return sessionStorage;
-    default:
-      return localStorage;
-  }
-}
-
-/**
- * Persist addon
- *
- * @param options
- * @returns BlacAddon
- */
-export function Persist(
-  options: {
-    /**
-     * @default 'blac'
-     */
-    keyPrefix?: string;
-    /**
-     * @default the bloc's id
-     */
-    keyName?: string;
-    /**
-     * Used when the value is not found in storage
-     */
-    defaultValue?: unknown;
-
-    /**
-     * @default 'localStorage'
-     * @see StorageType
-     */
-    storageType?: StorageType;
-
-    /**
-     * @default false
-     */
-    onError?: (e: unknown) => void;
-  } = {},
-): BlacAddon {
-  const {
-    keyPrefix = 'blac',
-    keyName,
-    defaultValue,
-    storageType = 'localStorage',
-  } = options;
-
-  const fullKey = (id: string | BlocInstanceId) => `${keyPrefix}:${String(id)}`;
-
-  const getFromLocalStorage = (id: string | BlocInstanceId): unknown => {
-    try {
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
-      const value = getStorage(storageType).getItem(fullKey(id));
-      if (typeof value !== 'string') {
-        return defaultValue;
-      }
-
-      const p = JSON.parse(value) as { v: unknown };
-      if (typeof p.v !== 'undefined') {
-        return p.v;
-      } else {
-        return defaultValue;
-      }
-    } catch (e) {
-      options.onError?.(e);
-      return defaultValue;
-    }
-  };
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  const onInit: BlacAddonInit = (e: BlocBase<any>) => {
-    const id = keyName ?? e._id;
-
-    const value = getFromLocalStorage(id);
-    e._pushState(value, null);
-  };
-
-  let currentCachedValue = '';
-  const onEmit: BlacAddonEmit = ({ newState, cubit }) => {
-    const id = keyName ?? cubit._id;
-
-    const newValue = JSON.stringify({ v: newState });
-
-    if (newValue !== currentCachedValue) {
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
-      getStorage(storageType).setItem(fullKey(id), newValue);
-      currentCachedValue = newValue;
-    }
-  };
-
-  return {
-    name: 'Persist',
-    onInit,
-    onEmit,
-  };
-}

package/src/addons/index.ts

@@ -1 +0,0 @@
-export * from './Persist';