pinia-plugin-subscription 0.2.0 → 1.0.0-beta.0

package/dist/pinia-plugin-subscription.js.map

@@ -1 +1 @@
-{"version":3,"file":"pinia-plugin-subscription.js","sources":["../src/utils/deep-clone.ts","../src/factories/state-snapshot.ts","../src/core/RollbackStateSnapshotsHandler.ts","../src/core/PluginSubscription.ts"],"sourcesContent":["/**\n * Deeply clones the provided value, handling objects, arrays, maps, and sets. Uses `structuredClone` if available, otherwise falls back to a manual deep clone.\n * @template T The type of the value to deep clone.\n * @param value The value to deep clone.\n * @returns A deep clone of the provided value.\n */\nexport function deepClone<T>(value: T): T {\n    if (typeof structuredClone === 'function') {\n        try {\n            return structuredClone(value)\n        } catch {\n            // fall through to the safe manual clone below\n        }\n    }\n\n    if (value === null || typeof value !== 'object') {\n        return value\n    }\n\n    if (value instanceof Map) {\n        return new Map(\n            Array.from(value.entries(), ([key, entryValue]) => [deepClone(key), deepClone(entryValue)])\n        ) as T\n    }\n\n    if (value instanceof Set) {\n        return new Set(Array.from(value.values(), entryValue => deepClone(entryValue))) as T\n    }\n\n    if (Array.isArray(value)) {\n        return value.map(item => deepClone(item)) as T\n    }\n\n    if (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null) {\n        return Object.fromEntries(\n            Object.entries(value as Record<string, unknown>).map(([key, item]) => [key, deepClone(item)])\n        ) as T\n    }\n\n    const clonedObject = Object.create(Object.getPrototypeOf(value)) as Record<string, unknown>\n    for (const [key, item] of Object.entries(value as Record<string, unknown>)) {\n        clonedObject[key] = deepClone(item)\n    }\n\n    return clonedObject as T\n}","import { toRaw } from 'vue'\nimport { deepClone } from '../utils/deep-clone'\n\nimport type { StateTree } from 'pinia'\nimport type { CreateStateSnapshotKeys } from '../types/plugin'\n\n\nexport function createStateSnapshot(state: StateTree, keys: CreateStateSnapshotKeys = 'all') {\n    if (Array.isArray(keys)) {\n        const clonedState: Partial<StateTree> = {}\n        for (const key of keys) {\n            if (key in state) {\n                clonedState[key] = deepClone(toRaw(state[key]))\n            }\n        }\n        return clonedState\n    }\n\n    if (keys !== 'all') {\n        throw new Error(`Invalid keys parameter: ${keys}`)\n    }\n\n    return deepClone(toRaw(state))\n}","import { createStateSnapshot } from \"../factories/state-snapshot\"\nimport { getActionStoreKey, hasDeniedFirstChar } from '../utils/store'\n\nimport type { PiniaPluginContext, StateTree, Store } from 'pinia'\nimport type { AnyObject } from '../types'\nimport type { CreateStateSnapshotKeys } from '../types/plugin'\nimport type { RollbackActionParams } from '../types/store'\n\n\n/**\n * Handles rollback state snapshots for Pinia stores.\n * This class provides methods to add rollback actions to stores,\n * create rollback snapshots, and manage the state snapshots internally.\n */\nexport default class RollbackStateSnapshotsHandler {\n    private _stateSnapshots: Map<symbol, StateTree> = new Map()\n    private _storeHasRollbackSnapshots: Set<string> = new Set()\n    private _storeRollbackSnapshotsParams: Map<string, CreateStateSnapshotKeys> = new Map()\n\n\n    /**\n     * Adds a rollback action to the given store.\n     * This method extends the store with a $rollbackAfterFailure function that handles rollback logic for actions.\n     * The action arguments are forwarded through apply(), so they must be provided as a single array.\n     * @param {Store} store The store to which the rollback action will be added.\n     * @returns void\n     */\n    addRollbackAction(store: Store): void {\n        if (typeof store.$rollbackAfterFailure === 'function') {\n            return\n        }\n\n        store.$rollbackAfterFailure = async ({ action, stateKeys }: RollbackActionParams, args: any[] = []) => {\n            const actionFn = (store as AnyObject)[action]\n            if (typeof actionFn !== 'function' || hasDeniedFirstChar(action)) {\n                return\n            }\n\n            const keys: CreateStateSnapshotKeys = !stateKeys || stateKeys.length === 0 ? 'all' : stateKeys\n\n            const snapshotKey = this.saveStateSnapshot(store, action, keys)\n            try {\n                await actionFn.apply(store, args)\n            } catch (error) {\n                this.patchStore(snapshotKey, store)\n                throw error\n            } finally {\n                this.removeStateSnapshot(snapshotKey)\n            }\n        }\n    }\n\n    /**\n     * Creates a rollback snapshot for the specified action and store.\n     * This snapshot can be used to restore the store's state in case of an error during the action execution.\n     * @param {string} actionName The name of the action for which the rollback snapshot is created.\n     * @param {Store} store The Pinia store instance.\n     * @returns An object containing `after` and `onError` callbacks for handling the rollback, or `undefined` if no snapshot is created.\n     */\n    createOnActionCallbacks(\n        actionName: string,\n        store: Store\n    ): {\n        after: () => void,\n        onError: () => void\n    } | undefined {\n        const stateKeys = this._storeRollbackSnapshotsParams.get(\n            getActionStoreKey(actionName, store)\n        )\n\n        if (!stateKeys || stateKeys.length === 0) {\n            return\n        }\n\n        const snapshotKey = this.saveStateSnapshot(store, actionName, stateKeys)\n\n        return {\n            after: () => { this.removeStateSnapshot(snapshotKey) },\n            onError: () => {\n                this.patchStore(snapshotKey, store)\n                this.removeStateSnapshot(snapshotKey)\n            }\n        }\n    }\n\n    /**\n     * Initializes the rollback state snapshots handler from the given Pinia plugin context.\n     * This method extracts the rollback snapshot parameters from the store options and stores them internally.\n     * @param {PiniaPluginContext} param0 The Pinia plugin context containing the store and its options.\n     * @returns void\n     */\n    initFromPluginContext({ options, store }: PiniaPluginContext) {\n        const rollbackSnapshotParams = options?.storeOptions?.rollbackAfterFailure as Record<string, CreateStateSnapshotKeys>\n        if (rollbackSnapshotParams && !this._storeHasRollbackSnapshots.has(store.$id)) {\n            Object.keys(rollbackSnapshotParams).forEach(key => {\n                this._storeRollbackSnapshotsParams.set(\n                    getActionStoreKey(key, store),\n                    rollbackSnapshotParams[key]\n                )\n            })\n            this._storeHasRollbackSnapshots.add(store.$id)\n        }\n        this.addRollbackAction(store)\n    }\n\n    /**\n     * Clears all rollback tracking data for the given store.\n     * Must be called when the store is disposed to avoid memory leaks with dynamically created stores.\n     * @param {Store} store The disposed Pinia store instance.\n     * @returns void\n     */\n    clearStoreTracking(store: Store): void {\n        const suffix = `-${store.$id}`\n\n        for (const key of Array.from(this._storeRollbackSnapshotsParams.keys())) {\n            if (key.endsWith(suffix)) {\n                this._storeRollbackSnapshotsParams.delete(key)\n            }\n        }\n\n        this._storeHasRollbackSnapshots.delete(store.$id)\n\n        for (const snapshotKey of Array.from(this._stateSnapshots.keys())) {\n            if (snapshotKey.description?.startsWith(`${store.$id}:`)) {\n                this._stateSnapshots.delete(snapshotKey)\n            }\n        }\n    }\n\n    private patchStore(snapshotKey: symbol, store: Store): void {\n        const stateSnapshot = this._stateSnapshots.get(snapshotKey)\n        if (!stateSnapshot) {\n            return\n        }\n\n        try {\n            store.$patch(stateSnapshot)\n        } catch (error) {\n            console.error(`Failed to patch store with snapshot ${String(snapshotKey)}`, error)\n        }\n    }\n\n    /**\n     * Removes a state snapshot identified by the given snapshot key from the internal state snapshot tracking.\n     * @param snapshotKey The key of the state snapshot to be removed.\n     * @returns void\n     */\n    private removeStateSnapshot(snapshotKey?: symbol): void {\n        if (!snapshotKey) {\n            return\n        }\n\n        this._stateSnapshots.delete(snapshotKey)\n    }\n\n    /**\n     * Saves the current state snapshot for a given store and action.\n     * @param store The Pinia store instance.\n     * @param actionName The name of the action being executed.\n     * @param stateKeys The state keys to include in the snapshot, or 'all' for the full state.\n     * @returns A unique symbol key representing the saved snapshot.\n     */\n    private saveStateSnapshot(store: Store, actionName: string, stateKeys: CreateStateSnapshotKeys): symbol {\n        const stateSnapshot = createStateSnapshot(\n            store.$state,\n            stateKeys\n        )\n\n        const snapshotKey = Symbol(`${store.$id}:${actionName}`)\n        this._stateSnapshots.set(snapshotKey, stateSnapshot)\n        return snapshotKey\n    }\n\n    /**\n     * Checks if the given store has rollback snapshots.\n     * @param store The Pinia store instance.\n     * @returns True if the store has rollback snapshots, false otherwise.\n     */\n    storeHasRollbackSnapshots(store: Store): boolean {\n        return this._storeHasRollbackSnapshots.has(store.$id)\n    }\n}","import Debug from \"../system/Debug\"\nimport RollbackStateSnapshotsHandler from \"./RollbackStateSnapshotsHandler\"\nimport { deepClone } from '../utils/deep-clone'\nimport { getActionStoreKey } from '../utils/store'\nimport { PluginConsole } from \"../system/log\"\nimport { isEmpty } from \"../utils/validation\"\n\nimport type { PiniaPluginContext, StateTree, Store, SubscriptionCallbackMutation } from \"pinia\"\nimport type { AnyObject } from \"../types\"\nimport type {\n    PluginExecutionOptions,\n    PluginHydrationScheduler,\n    PluginRuntimeEnvironment,\n    PluginSubscriber,\n    PluginSubscription as PluginSubscriptionDefinition,\n    PluginSubscriptionOptions,\n    PluginSubscriptions,\n    StoreMutationSubscription,\n    StoreOnActionAfterCallbackParameter,\n    StoreOnActionSubscriptionCallback\n} from \"../types/plugin\"\n\n\nconst className = 'PluginSubscription'\nconst defaultPluginExecution: Required<PluginExecutionOptions> = {\n    environment: 'both',\n    hydration: 'immediate'\n}\n\nfunction defaultHydrationScheduler(callback: () => void): void {\n    if (typeof window !== 'undefined' && typeof window.requestAnimationFrame === 'function') {\n        window.requestAnimationFrame(() => globalThis.setTimeout(callback, 0))\n        return\n    }\n\n    globalThis.setTimeout(callback, 0)\n}\n\nfunction isPluginSubscriptionOptions(\n    value: PluginSubscriptionOptions | string[] | undefined\n): value is PluginSubscriptionOptions {\n    return value !== undefined && !Array.isArray(value)\n}\n\n\nexport default class PluginSubscription extends Debug {\n    protected _className: string = className\n    private _hydrationScheduler: PluginHydrationScheduler\n    private _onActionSubscriptions: StoreOnActionSubscriptionCallback[] = []\n    private _onActionAfterSubscriptions: Record<string, StoreOnActionAfterCallbackParameter[]> = {}\n    private _onActionOnErrorSubscriptions: Record<string, Array<(error: unknown) => void>> = {}\n    private _options?: PluginSubscriptionOptions\n    private _pluginDebug?: string[]\n    private _resetStoreCallback: Function[] = []\n    private _storeRollbackSnapshotsHandler: RollbackStateSnapshotsHandler = new RollbackStateSnapshotsHandler()\n    private _subscribers: PluginSubscriber[] = []\n    private _subscribersDelivered: Set<string> = new Set()\n    private _subscribersScheduled: Set<string> = new Set()\n    private _subscriptions: PluginSubscriptions[] = []\n    private _subscriptionsDelivered: Set<string> = new Set()\n    private _subscriptionsScheduled: Set<string> = new Set()\n\n    set subscribers(subscribers: PluginSubscriber[]) {\n        this._subscribers = subscribers\n    }\n\n    get subscriptions(): PluginSubscriptions[] | undefined {\n        if (!isEmpty(this._subscriptions)) {\n            return this._subscriptions\n        }\n    }\n\n    constructor(\n        subscribers: PluginSubscriber[],\n        debugOrOptions?: PluginSubscriptionOptions | string[],\n        pluginOptions?: PluginSubscriptionOptions\n    ) {\n        const debug = Array.isArray(debugOrOptions) ? debugOrOptions : undefined\n        const options = isPluginSubscriptionOptions(debugOrOptions) ? debugOrOptions : pluginOptions\n\n        super(Array.isArray(debug) && !!debug?.includes(className), PluginConsole)\n        this._hydrationScheduler = options?.hydrationScheduler ?? defaultHydrationScheduler\n        this._options = options\n        this._pluginDebug = Array.isArray(debug) ? debug : undefined\n        this._subscribers = subscribers\n    }\n\n\n    private addOnActionAfterCallback(actionName: string, store: Store, callback: StoreOnActionAfterCallbackParameter): void {\n        const key = getActionStoreKey(actionName, store)\n        if (!this._onActionAfterSubscriptions[key]) {\n            this._onActionAfterSubscriptions[key] = []\n        }\n        this._onActionAfterSubscriptions[key]?.push(callback)\n    }\n\n    private addOnActionOnErrorCallback(actionName: string, store: Store, callback: (error: unknown) => void): void {\n        const key = getActionStoreKey(actionName, store)\n        if (!this._onActionOnErrorSubscriptions[key]) {\n            this._onActionOnErrorSubscriptions[key] = []\n        }\n        this._onActionOnErrorSubscriptions[key]?.push(callback)\n    }\n\n    private addResetStoreCallback(callback: Function): void {\n        this._resetStoreCallback.push(callback)\n    }\n\n    private clearOnActionCallbacksSubscriptions(storageKey: string): void {\n        delete this._onActionAfterSubscriptions[storageKey]\n        delete this._onActionOnErrorSubscriptions[storageKey]\n    }\n\n    private clearStoreTracking(store: Store): void {\n        const suffix = `-${store.$id}`\n\n        for (const key of Array.from(this._subscribersDelivered)) {\n            if (key.endsWith(suffix)) {\n                this._subscribersDelivered.delete(key)\n            }\n        }\n\n        for (const key of Array.from(this._subscribersScheduled)) {\n            if (key.endsWith(suffix)) {\n                this._subscribersScheduled.delete(key)\n            }\n        }\n\n        for (const key of Array.from(this._subscriptionsDelivered)) {\n            if (key.endsWith(suffix)) {\n                this._subscriptionsDelivered.delete(key)\n            }\n        }\n\n        for (const key of Array.from(this._subscriptionsScheduled)) {\n            if (key.endsWith(suffix)) {\n                this._subscriptionsScheduled.delete(key)\n            }\n        }\n\n        for (const key of Object.keys(this._onActionAfterSubscriptions)) {\n            if (key.endsWith(suffix)) {\n                delete this._onActionAfterSubscriptions[key]\n            }\n        }\n\n        for (const key of Object.keys(this._onActionOnErrorSubscriptions)) {\n            if (key.endsWith(suffix)) {\n                delete this._onActionOnErrorSubscriptions[key]\n            }\n        }\n    }\n\n    /**\n     * Creates a callback collector for the specified action and store.\n     * @param actionName The name of the action to collect callbacks for.\n     * @param store The store instance associated with the action.\n     * @returns A function that collects callbacks for the specified action and store.\n     */\n    private createOnActionAfterCallbackCollector(actionName: string, store: Store) {\n        return (callback: StoreOnActionAfterCallbackParameter) => {\n            this.addOnActionAfterCallback(actionName, store, callback)\n        }\n    }\n\n    /**\n     * Creates a callback collector for the specified action and store that handles errors.\n     * @param actionName The name of the action to collect error callbacks for.\n     * @param store The store instance associated with the action.\n     * @returns A function that collects error callbacks for the specified action and store.\n     */\n    private createOnActionOnErrorCallbackCollector(actionName: string, store: Store) {\n        return (callback: (error: unknown) => void) => {\n            this.addOnActionOnErrorCallback(actionName, store, callback)\n        }\n    }\n\n    /**\n     * Rolls back the state snapshot for a given action if an error occurs, and removes the snapshot after the action completes or fails.\n     * @param actionName The name of the action being executed.\n     * @param store The Pinia store instance.\n     * @returns void\n     */\n    private createRollbackSnapshot(\n        actionName: string,\n        store: Store\n    ) {\n        const {\n            after,\n            onError\n        } = this._storeRollbackSnapshotsHandler.createOnActionCallbacks(\n            actionName,\n            store\n        ) ?? {}\n\n        if (!after || !onError) {\n            return\n        }\n\n        this.addOnActionAfterCallback(actionName, store, after)\n        this.addOnActionOnErrorCallback(actionName, store, onError)\n    }\n\n    private defineCurrentEnvironment(): PluginRuntimeEnvironment {\n        return this._options?.runtimeEnvironment\n            ?? (typeof window === 'undefined' ? 'server' : 'client')\n    }\n\n    private definePluginDebug(subscriber: PluginSubscriber): boolean {\n        return !!this._pluginDebug?.includes(subscriber.name)\n    }\n\n    private definePluginExecution(subscriber: PluginSubscriber): Required<PluginExecutionOptions> {\n        return {\n            ...defaultPluginExecution,\n            ...(this._options?.execution ?? {}),\n            ...(subscriber.execution ?? {}),\n            ...(this._options?.subscriberExecution?.[subscriber.name] ?? {}),\n        }\n    }\n\n    private defineHydrationScheduler(subscriber: PluginSubscriber | PluginSubscriptionDefinition['subscription']): PluginHydrationScheduler {\n        return subscriber.hydrationScheduler ?? this._hydrationScheduler\n    }\n\n    private defineSubscriberKey(subscriber: PluginSubscriber, store: Store): string {\n        return `${subscriber.name}-${store.$id}`\n    }\n\n    private defineSubscriptionKey(pluginName: string, store: Store): string {\n        return `${pluginName}-${store.$id}`\n    }\n\n    private executeResetStoreCallbacks(store: Store): void {\n        this._resetStoreCallback.forEach(callback => callback(store))\n    }\n\n    /**\n     * Executes the store's onAction subscription for the given plugin subscriber.\n     * @param store The Pinia store instance.\n     * @param subscriber The plugin subscriber.\n     * @returns void\n     */\n    private executeStoreOnActionSubscription(store: Store): void {\n        const onActionSubscriptions = this._onActionSubscriptions\n        const hasRollbackSnapshots = this._storeRollbackSnapshotsHandler.storeHasRollbackSnapshots(store)\n\n        if (!onActionSubscriptions?.length && !hasRollbackSnapshots) {\n            return\n        }\n\n        store.$onAction(({ after, args, name, onError }) => {\n            const storageKey = getActionStoreKey(name, store)\n            this.debugLog(`storeOnActionSubscription ${storageKey}`, { args, name, store })\n\n            if (hasRollbackSnapshots) {\n                this.createRollbackSnapshot(name, store)\n            }\n\n            if (onActionSubscriptions?.length) {\n                onActionSubscriptions.forEach(callback => callback({\n                    after: this.createOnActionAfterCallbackCollector(name, store),\n                    args,\n                    name,\n                    onError: this.createOnActionOnErrorCallbackCollector(name, store)\n                }))\n            }\n\n            const afterCallbacks = this._onActionAfterSubscriptions[storageKey]\n            const onErrorCallbacks = this._onActionOnErrorSubscriptions[storageKey]\n\n            this.clearOnActionCallbacksSubscriptions(storageKey)\n\n            if (afterCallbacks?.length) {\n                after((result) => {\n                    afterCallbacks.forEach(callback => callback(result))\n                })\n            }\n            if (onErrorCallbacks?.length) {\n                onError((error) => {\n                    onErrorCallbacks.forEach(callback => callback(error))\n                })\n            }\n        })\n    }\n\n    private executeSubscriber(context: PiniaPluginContext, subscriber: PluginSubscriber): void {\n        const subscriberKey = this.defineSubscriberKey(subscriber, context.store)\n        const debug = this.definePluginDebug(subscriber)\n\n        if (this._subscribersDelivered.has(subscriberKey)) {\n            return\n        }\n\n        if (\n            !subscriber.invoke(\n                context,\n                debug\n            )) {\n            return\n        }\n\n        this._subscribersDelivered.add(subscriberKey)\n\n        let hydrateResult: void | Promise<void>\n\n        try {\n            hydrateResult = subscriber.hydrate?.(context, debug)\n        } catch (error) {\n            this.logError(error, context.store, context.options)\n            return\n        }\n\n        const runAfterHydration = () => {\n            try {\n                const afterHydration = subscriber.afterHydration?.(context, debug)\n                if (afterHydration && typeof (afterHydration as Promise<void>).then === 'function') {\n                    ; (afterHydration as Promise<void>).catch(error => this.logError(error, context.store, context.options))\n                }\n            } catch (error) {\n                this.logError(error, context.store, context.options)\n            }\n        }\n\n        if (hydrateResult && typeof (hydrateResult as Promise<void>).then === 'function') {\n            ; (hydrateResult as Promise<void>)\n                .then(() => runAfterHydration())\n                .catch(error => this.logError(error, context.store, context.options))\n        } else {\n            runAfterHydration()\n        }\n\n        if (subscriber.subscriptions) {\n            this.subscriptionDelivery(context, subscriber.subscriptions)\n        }\n\n        if (subscriber.storeMutationSubscription) {\n            this.storeMutationSubscription(subscriber.storeMutationSubscription)\n        }\n\n        this.storeOnActionSubscription(subscriber)\n\n        if (subscriber.resetStoreCallback) {\n            this.addResetStoreCallback(subscriber.resetStoreCallback)\n        }\n    }\n\n    private executeSubscriberSafely(context: PiniaPluginContext, subscriber: PluginSubscriber): void {\n        try {\n            this.executeSubscriber(context, subscriber)\n        } catch (e) {\n            this.logError(e, context.store, context.options)\n        }\n    }\n\n    plugin({ store, options }: PiniaPluginContext) {\n        if (!this._subscribers.length) {\n            return\n        }\n\n        this.debugLog(`plugin() - ${store.$id}`, [\n            'subscriber:', this._subscribers,\n            'store:', store,\n            'options:', options\n        ])\n\n        try {\n            this._subscribers.forEach(\n                subscriber => {\n                    const subscriberKey = this.defineSubscriberKey(subscriber, store)\n                    const execution = this.definePluginExecution(subscriber)\n\n                    if (\n                        this._subscribersDelivered.has(subscriberKey)\n                        || this._subscribersScheduled.has(subscriberKey)\n                    ) {\n                        return\n                    }\n\n                    if (!this.shouldInvokePlugin(execution)) {\n                        return\n                    }\n\n                    if (this.shouldScheduleAfterHydration(execution)) {\n                        this.queueSubscriberExecution({ store, options } as PiniaPluginContext, subscriber, subscriberKey)\n                        return\n                    }\n\n                    this.executeSubscriber({ store, options } as PiniaPluginContext, subscriber)\n                }\n            )\n\n            this.rewriteResetStore({ store } as PiniaPluginContext, store.$state)\n            this._storeRollbackSnapshotsHandler.initFromPluginContext({ store, options } as PiniaPluginContext)\n            this.executeStoreOnActionSubscription(store)\n            this.registerStoreCleanup(store)\n        } catch (e) {\n            this.logError(e, store, options)\n        }\n    }\n\n    private queueSubscriberExecution(\n        context: PiniaPluginContext,\n        subscriber: PluginSubscriber,\n        subscriberKey: string\n    ): void {\n        const scheduler = this.defineHydrationScheduler(subscriber)\n\n        this._subscribersScheduled.add(subscriberKey)\n        scheduler(() => {\n            this._subscribersScheduled.delete(subscriberKey)\n            this.executeSubscriberSafely(context, subscriber)\n        })\n    }\n\n    private registerStoreCleanup(store: Store): void {\n        this._onActionSubscriptions = []\n        if (typeof store.$dispose !== 'function') {\n            return\n        }\n\n        const dispose = store.$dispose.bind(store)\n        const scopedStore = store as AnyObject\n\n        if (scopedStore.__piniaPluginSubscriptionDisposed) {\n            return\n        }\n\n        scopedStore.__piniaPluginSubscriptionDisposed = true\n        store.$dispose = () => {\n            this.clearStoreTracking(store)\n            this._storeRollbackSnapshotsHandler.clearStoreTracking(store)\n            return dispose()\n        }\n    }\n\n    private rewriteResetStore({ store }: PiniaPluginContext, initState: StateTree): void {\n        const safeState = deepClone(initState)\n\n        store.$reset = () => {\n            this.debugLog('rewriteResetStore()', { initState: safeState, store })\n\n            this.executeResetStoreCallbacks(store)\n\n            store.$patch(deepClone(safeState))\n        }\n    }\n\n    private shouldInvokePlugin(execution: Required<PluginExecutionOptions>): boolean {\n        const currentEnvironment = this.defineCurrentEnvironment()\n\n        return execution.environment === 'both' || execution.environment === currentEnvironment\n    }\n\n    private shouldScheduleAfterHydration(execution: Required<PluginExecutionOptions>): boolean {\n        return this.defineCurrentEnvironment() === 'client' && execution.hydration === 'defer'\n    }\n\n    private storeOnActionSubscription(subscriber: PluginSubscriber): void {\n        const { store, callback } = subscriber?.storeOnActionSubscription?.() ?? {}\n\n        if (!store || !callback) {\n            return\n        }\n\n        this._onActionSubscriptions.push(callback)\n    }\n\n    private storeMutationSubscription(subscription: StoreMutationSubscription): void {\n        const { store, callback } = subscription()\n\n        store.$subscribe((mutation: SubscriptionCallbackMutation<StateTree>) => {\n            this.debugLog(`$subscribe ${store.$id}`, { mutation, store })\n            callback(mutation)\n        })\n    }\n\n    private subscriptionDelivery(\n        context: PiniaPluginContext,\n        pluginSubscriptions: PluginSubscriptions\n    ): void {\n        Object.entries(pluginSubscriptions).forEach(([pluginName, pluginSubscription]) => {\n            const subscriptionKey = this.defineSubscriptionKey(pluginName, context.store)\n            const execution = this.definePluginExecution(pluginSubscription.subscription)\n\n            if (\n                this._subscriptionsDelivered.has(subscriptionKey)\n                || this._subscriptionsScheduled.has(subscriptionKey)\n            ) {\n                return\n            }\n\n            if (!this.shouldInvokePlugin(execution)) {\n                return\n            }\n\n            if (this.shouldScheduleAfterHydration(execution)) {\n                const scheduler = this.defineHydrationScheduler(pluginSubscription.subscription)\n\n                this._subscriptionsScheduled.add(subscriptionKey)\n                scheduler(() => {\n                    this._subscriptionsScheduled.delete(subscriptionKey)\n                    this.subscriptionDeliverySafely(context, pluginName, pluginSubscription)\n                })\n                return\n            }\n\n            this.subscriptionDeliverySafely(context, pluginName, pluginSubscription)\n        })\n    }\n\n    private subscriptionDeliverySafely(\n        { store, options }: PiniaPluginContext,\n        pluginName: string,\n        pluginSubscription: PluginSubscriptionDefinition\n    ): void {\n        try {\n            if (this._subscriptionsDelivered.has(this.defineSubscriptionKey(pluginName, store))) {\n                return\n            }\n\n            const { subscription, subscriptionOptions, stores } = pluginSubscription\n\n            this.debugLog(`subscriptionDelivery() - store: ${store.$id}`, [\n                'pluginName:', pluginName,\n                'subscription:', subscription,\n                'options:', pluginSubscription,\n                'stores:', stores\n            ])\n\n            const pluginOptions = {\n                storeOptions: { ...((options as AnyObject)?.storeOptions ?? {}), ...subscriptionOptions }\n            } as AnyObject\n\n            subscription.invoke(\n                { store, options: { ...options, ...pluginOptions } } as PiniaPluginContext,\n                this.debug\n            )\n            this._subscriptionsDelivered.add(this.defineSubscriptionKey(pluginName, store))\n\n            if (!isEmpty(stores)) {\n                stores?.forEach(\n                    store => subscription.invoke(\n                        {\n                            store,\n                            options: {\n                                ...options,\n                                ...pluginOptions,\n                                ...((store as AnyObject)?.storeOptions ?? {})\n                            }\n                        } as PiniaPluginContext,\n                        this.debug\n                    )\n                )\n            }\n        } catch (e) {\n            this.logError(`subscriptionDelivery()`, e, store, options)\n        }\n    }\n}"],"names":["deepClone","value","key","entryValue","item","clonedObject","createStateSnapshot","state","keys","clonedState","toRaw","RollbackStateSnapshotsHandler","__publicField","store","action","stateKeys","args","actionFn","hasDeniedFirstChar","snapshotKey","error","actionName","getActionStoreKey","options","rollbackSnapshotParams","suffix","stateSnapshot","className","defaultPluginExecution","defaultHydrationScheduler","callback","isPluginSubscriptionOptions","PluginSubscription","Debug","subscribers","debugOrOptions","pluginOptions","debug","PluginConsole","storageKey","after","onError","subscriber","pluginName","onActionSubscriptions","hasRollbackSnapshots","name","afterCallbacks","onErrorCallbacks","result","context","subscriberKey","hydrateResult","runAfterHydration","afterHydration","e","execution","scheduler","dispose","scopedStore","initState","safeState","currentEnvironment","subscription","mutation","pluginSubscriptions","pluginSubscription","subscriptionKey","subscriptionOptions","stores","isEmpty","store2","createPlugin","createHydrationPlugin","hydrationPlugin"],"mappings":"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"}
+{"version":3,"file":"pinia-plugin-subscription.js","sources":["../src/utils/deep-clone.ts","../src/factories/state-snapshot.ts","../src/core/RollbackStateSnapshotsHandler.ts","../src/core/PluginSubscription.ts"],"sourcesContent":["/**\n * Deeply clones the provided value, handling objects, arrays, maps, and sets. Uses `structuredClone` if available, otherwise falls back to a manual deep clone.\n * @template T The type of the value to deep clone.\n * @param value The value to deep clone.\n * @returns A deep clone of the provided value.\n */\nexport function deepClone<T>(value: T): T {\n    if (typeof structuredClone === 'function') {\n        try {\n            return structuredClone(value)\n        } catch {\n            // fall through to the safe manual clone below\n        }\n    }\n\n    if (value === null || typeof value !== 'object') {\n        return value\n    }\n\n    if (value instanceof Map) {\n        return new Map(\n            Array.from(value.entries(), ([key, entryValue]) => [deepClone(key), deepClone(entryValue)])\n        ) as T\n    }\n\n    if (value instanceof Set) {\n        return new Set(Array.from(value.values(), entryValue => deepClone(entryValue))) as T\n    }\n\n    if (Array.isArray(value)) {\n        return value.map(item => deepClone(item)) as T\n    }\n\n    if (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null) {\n        return Object.fromEntries(\n            Object.entries(value as Record<string, unknown>).map(([key, item]) => [key, deepClone(item)])\n        ) as T\n    }\n\n    const clonedObject = Object.create(Object.getPrototypeOf(value)) as Record<string, unknown>\n    for (const [key, item] of Object.entries(value as Record<string, unknown>)) {\n        clonedObject[key] = deepClone(item)\n    }\n\n    return clonedObject as T\n}","import { toRaw } from 'vue'\nimport { deepClone } from '../utils/deep-clone'\n\nimport type { StateTree } from 'pinia'\nimport type { CreateStateSnapshotKeys } from '../types/plugin'\n\n\nexport function createStateSnapshot(state: StateTree, keys: CreateStateSnapshotKeys = 'all') {\n    if (Array.isArray(keys)) {\n        const clonedState: Partial<StateTree> = {}\n        for (const key of keys) {\n            if (key in state) {\n                clonedState[key] = deepClone(toRaw(state[key]))\n            }\n        }\n        return clonedState\n    }\n\n    if (keys !== 'all') {\n        throw new Error(`Invalid keys parameter: ${keys}`)\n    }\n\n    return deepClone(toRaw(state))\n}","import { createStateSnapshot } from \"../factories/state-snapshot\"\nimport { getActionStoreKey, hasDeniedFirstChar } from '../utils/store'\n\nimport type { PiniaPluginContext, StateTree, Store } from 'pinia'\nimport type { AnyObject } from '../types'\nimport type { CreateStateSnapshotKeys } from '../types/plugin'\nimport type { RollbackActionParams } from '../types/store'\n\n\n/**\n * Handles rollback state snapshots for Pinia stores.\n * This class provides methods to add rollback actions to stores,\n * create rollback snapshots, and manage the state snapshots internally.\n */\nexport default class RollbackStateSnapshotsHandler {\n    private _stateSnapshots: Map<symbol, StateTree> = new Map()\n    private _storeHasRollbackSnapshots: Set<string> = new Set()\n    private _storeRollbackSnapshotsParams: Map<string, CreateStateSnapshotKeys> = new Map()\n\n\n    /**\n     * Adds a rollback action to the given store.\n     * This method extends the store with a $rollbackAfterFailure function that handles rollback logic for actions.\n     * The action arguments are forwarded through apply(), so they must be provided as a single array.\n     * @param {Store} store The store to which the rollback action will be added.\n     * @returns void\n     */\n    addRollbackAction(store: Store): void {\n        if (typeof store.$rollbackAfterFailure === 'function') {\n            return\n        }\n\n        store.$rollbackAfterFailure = async ({ action, stateKeys }: RollbackActionParams, args: any[] = []) => {\n            const actionFn = (store as AnyObject)[action]\n            if (typeof actionFn !== 'function' || hasDeniedFirstChar(action)) {\n                return\n            }\n\n            const keys: CreateStateSnapshotKeys = !stateKeys || stateKeys.length === 0 ? 'all' : stateKeys\n\n            const snapshotKey = this.saveStateSnapshot(store, action, keys)\n            try {\n                await actionFn.apply(store, args)\n            } catch (error) {\n                this.patchStore(snapshotKey, store)\n                throw error\n            } finally {\n                this.removeStateSnapshot(snapshotKey)\n            }\n        }\n    }\n\n    /**\n     * Creates a rollback snapshot for the specified action and store.\n     * This snapshot can be used to restore the store's state in case of an error during the action execution.\n     * @param {string} actionName The name of the action for which the rollback snapshot is created.\n     * @param {Store} store The Pinia store instance.\n     * @returns An object containing `after` and `onError` callbacks for handling the rollback, or `undefined` if no snapshot is created.\n     */\n    createOnActionCallbacks(\n        actionName: string,\n        store: Store\n    ): {\n        after: () => void,\n        onError: () => void\n    } | undefined {\n        const stateKeys = this._storeRollbackSnapshotsParams.get(\n            getActionStoreKey(actionName, store)\n        )\n\n        if (!stateKeys) {\n            return\n        }\n\n        const keys: CreateStateSnapshotKeys = stateKeys.length === 0 ? 'all' : stateKeys\n        const snapshotKey = this.saveStateSnapshot(store, actionName, keys)\n\n        return {\n            after: () => { this.removeStateSnapshot(snapshotKey) },\n            onError: () => {\n                this.patchStore(snapshotKey, store)\n                this.removeStateSnapshot(snapshotKey)\n            }\n        }\n    }\n\n    /**\n     * Initializes the rollback state snapshots handler from the given Pinia plugin context.\n     * This method extracts the rollback snapshot parameters from the store options and stores them internally.\n     * @param {PiniaPluginContext} param0 The Pinia plugin context containing the store and its options.\n     * @returns void\n     */\n    initFromPluginContext({ options, store }: PiniaPluginContext) {\n        const rollbackSnapshotParams = options?.storeOptions?.rollbackAfterFailure as Record<string, CreateStateSnapshotKeys>\n        if (rollbackSnapshotParams && !this._storeHasRollbackSnapshots.has(store.$id)) {\n            Object.keys(rollbackSnapshotParams).forEach(key => {\n                this._storeRollbackSnapshotsParams.set(\n                    getActionStoreKey(key, store),\n                    rollbackSnapshotParams[key]\n                )\n            })\n            this._storeHasRollbackSnapshots.add(store.$id)\n        }\n        this.addRollbackAction(store)\n    }\n\n    /**\n     * Clears all rollback tracking data for the given store.\n     * Must be called when the store is disposed to avoid memory leaks with dynamically created stores.\n     * @param {Store} store The disposed Pinia store instance.\n     * @returns void\n     */\n    clearStoreTracking(store: Store): void {\n        const suffix = `-${store.$id}`\n\n        for (const key of Array.from(this._storeRollbackSnapshotsParams.keys())) {\n            if (key.endsWith(suffix)) {\n                this._storeRollbackSnapshotsParams.delete(key)\n            }\n        }\n\n        this._storeHasRollbackSnapshots.delete(store.$id)\n\n        for (const snapshotKey of Array.from(this._stateSnapshots.keys())) {\n            if (snapshotKey.description?.startsWith(`${store.$id}:`)) {\n                this._stateSnapshots.delete(snapshotKey)\n            }\n        }\n    }\n\n    private patchStore(snapshotKey: symbol, store: Store): void {\n        const stateSnapshot = this._stateSnapshots.get(snapshotKey)\n        if (!stateSnapshot) {\n            return\n        }\n\n        try {\n            store.$patch(stateSnapshot)\n        } catch (error) {\n            console.error(`Failed to patch store with snapshot ${String(snapshotKey)}`, error)\n        }\n    }\n\n    /**\n     * Removes a state snapshot identified by the given snapshot key from the internal state snapshot tracking.\n     * @param snapshotKey The key of the state snapshot to be removed.\n     * @returns void\n     */\n    private removeStateSnapshot(snapshotKey?: symbol): void {\n        if (!snapshotKey) {\n            return\n        }\n\n        this._stateSnapshots.delete(snapshotKey)\n    }\n\n    /**\n     * Saves the current state snapshot for a given store and action.\n     * @param store The Pinia store instance.\n     * @param actionName The name of the action being executed.\n     * @param stateKeys The state keys to include in the snapshot, or 'all' for the full state.\n     * @returns A unique symbol key representing the saved snapshot.\n     */\n    private saveStateSnapshot(store: Store, actionName: string, stateKeys: CreateStateSnapshotKeys): symbol {\n        const stateSnapshot = createStateSnapshot(\n            store.$state,\n            stateKeys\n        )\n\n        const snapshotKey = Symbol(`${store.$id}:${actionName}`)\n        this._stateSnapshots.set(snapshotKey, stateSnapshot)\n        return snapshotKey\n    }\n\n    /**\n     * Checks if the given store has rollback snapshots.\n     * @param store The Pinia store instance.\n     * @returns True if the store has rollback snapshots, false otherwise.\n     */\n    storeHasRollbackSnapshots(store: Store): boolean {\n        return this._storeHasRollbackSnapshots.has(store.$id)\n    }\n}","import RollbackStateSnapshotsHandler from \"./RollbackStateSnapshotsHandler\"\nimport { deepClone } from '../utils/deep-clone'\nimport { getActionStoreKey } from '../utils/store'\nimport Tracer from \"../system/Tracer\"\nimport { isEmpty } from \"../utils/validation\"\n\nimport type { PiniaPluginContext, StateTree, Store, SubscriptionCallbackMutation } from \"pinia\"\nimport type { AnyObject } from \"../types\"\nimport type { TracePayload } from \"../types/trace\"\nimport type {\n    PluginExecutionOptions,\n    PluginHydrationScheduler,\n    PluginRuntimeEnvironment,\n    PluginSubscriber,\n    PluginSubscription as PluginSubscriptionDefinition,\n    PluginSubscriptionOptions,\n    PluginSubscriptions,\n    StoreMutationSubscription,\n    StoreOnActionAfterCallbackParameter,\n    StoreOnActionSubscriptionCallback\n} from \"../types/plugin\"\n\n\nconst className = 'PluginSubscription'\nconst defaultPluginExecution: Required<PluginExecutionOptions> = {\n    environment: 'both',\n    hydration: 'immediate'\n}\n\nfunction defaultHydrationScheduler(callback: () => void): void {\n    if (typeof window !== 'undefined' && typeof window.requestAnimationFrame === 'function') {\n        window.requestAnimationFrame(() => globalThis.setTimeout(callback, 0))\n        return\n    }\n\n    globalThis.setTimeout(callback, 0)\n}\n\nexport default class PluginSubscription {\n    protected _className: string = className\n    private _hydrationScheduler: PluginHydrationScheduler\n    private _onActionSubscriptions: Map<Store, Set<StoreOnActionSubscriptionCallback>> = new Map()\n    private _onActionStores: Set<Store> = new Set()\n    private _onActionAfterSubscriptions: Record<string, StoreOnActionAfterCallbackParameter[]> = {}\n    private _onActionOnErrorSubscriptions: Record<string, Array<(error: unknown) => void>> = {}\n    private _options?: PluginSubscriptionOptions\n    private _resetStoreCallback: Map<Store, Set<NonNullable<PluginSubscriber['resetStoreCallback']>>> = new Map()\n    private _disposedStores: WeakSet<Store> = new WeakSet()\n    private _storeRollbackSnapshotsHandler: RollbackStateSnapshotsHandler = new RollbackStateSnapshotsHandler()\n    private _subscribers: PluginSubscriber[] = []\n    private _subscribersDelivered: Set<string> = new Set()\n    private _subscribersScheduled: Set<string> = new Set()\n    private _subscriptions: PluginSubscriptions[] = []\n    private _subscriptionsDelivered: Set<string> = new Set()\n    private _subscriptionsScheduled: Set<string> = new Set()\n    private _tracer?: Tracer\n\n    set subscribers(subscribers: PluginSubscriber[]) {\n        this._subscribers = subscribers\n    }\n\n    get subscriptions(): PluginSubscriptions[] | undefined {\n        if (!isEmpty(this._subscriptions)) {\n            return this._subscriptions\n        }\n    }\n\n    constructor(\n        subscribers: PluginSubscriber[],\n        options?: PluginSubscriptionOptions\n    ) {\n        this._hydrationScheduler = options?.hydrationScheduler ?? defaultHydrationScheduler\n        this._options = options\n        this._subscribers = subscribers\n        this.initializeTracer()\n    }\n\n    private addOnActionAfterCallback(actionName: string, store: Store, callback: StoreOnActionAfterCallbackParameter): void {\n        const key = getActionStoreKey(actionName, store)\n        if (!this._onActionAfterSubscriptions[key]) {\n            this._onActionAfterSubscriptions[key] = []\n        }\n        this._onActionAfterSubscriptions[key]?.push(callback)\n    }\n\n    private addOnActionOnErrorCallback(actionName: string, store: Store, callback: (error: unknown) => void): void {\n        const key = getActionStoreKey(actionName, store)\n        if (!this._onActionOnErrorSubscriptions[key]) {\n            this._onActionOnErrorSubscriptions[key] = []\n        }\n        this._onActionOnErrorSubscriptions[key]?.push(callback)\n    }\n\n    private addResetStoreCallback(store: Store, callback: NonNullable<PluginSubscriber['resetStoreCallback']>): void {\n        if (!this._resetStoreCallback.has(store)) {\n            this._resetStoreCallback.set(store, new Set())\n        }\n        this._resetStoreCallback.get(store)!.add(callback)\n    }\n\n    private clearOnActionCallbacksSubscriptions(storageKey: string): void {\n        delete this._onActionAfterSubscriptions[storageKey]\n        delete this._onActionOnErrorSubscriptions[storageKey]\n    }\n\n    private clearStoreTracking(store: Store): void {\n        this._onActionSubscriptions.delete(store)\n        this._onActionStores.delete(store)\n        this._resetStoreCallback.delete(store)\n        const suffix = `-${store.$id}`\n\n        for (const key of Array.from(this._subscribersDelivered)) {\n            if (key.endsWith(suffix)) {\n                this._subscribersDelivered.delete(key)\n            }\n        }\n\n        for (const key of Array.from(this._subscribersScheduled)) {\n            if (key.endsWith(suffix)) {\n                this._subscribersScheduled.delete(key)\n            }\n        }\n\n        for (const key of Array.from(this._subscriptionsDelivered)) {\n            if (key.endsWith(suffix)) {\n                this._subscriptionsDelivered.delete(key)\n            }\n        }\n\n        for (const key of Array.from(this._subscriptionsScheduled)) {\n            if (key.endsWith(suffix)) {\n                this._subscriptionsScheduled.delete(key)\n            }\n        }\n\n        for (const key of Object.keys(this._onActionAfterSubscriptions)) {\n            if (key.endsWith(suffix)) {\n                delete this._onActionAfterSubscriptions[key]\n            }\n        }\n\n        for (const key of Object.keys(this._onActionOnErrorSubscriptions)) {\n            if (key.endsWith(suffix)) {\n                delete this._onActionOnErrorSubscriptions[key]\n            }\n        }\n    }\n\n    /**\n     * Creates a callback collector for the specified action and store.\n     * @param actionName The name of the action to collect callbacks for.\n     * @param store The store instance associated with the action.\n     * @returns A function that collects callbacks for the specified action and store.\n     */\n    private createOnActionAfterCallbackCollector(actionName: string, store: Store) {\n        return (callback: StoreOnActionAfterCallbackParameter) => {\n            this.addOnActionAfterCallback(actionName, store, callback)\n        }\n    }\n\n    /**\n     * Creates a callback collector for the specified action and store that handles errors.\n     * @param actionName The name of the action to collect error callbacks for.\n     * @param store The store instance associated with the action.\n     * @returns A function that collects error callbacks for the specified action and store.\n     */\n    private createOnActionOnErrorCallbackCollector(actionName: string, store: Store) {\n        return (callback: (error: unknown) => void) => {\n            this.addOnActionOnErrorCallback(actionName, store, callback)\n        }\n    }\n\n    /**\n     * Rolls back the state snapshot for a given action if an error occurs, and removes the snapshot after the action completes or fails.\n     * @param actionName The name of the action being executed.\n     * @param store The Pinia store instance.\n     * @returns void\n     */\n    private createRollbackSnapshot(\n        actionName: string,\n        store: Store\n    ) {\n        const {\n            after,\n            onError\n        } = this._storeRollbackSnapshotsHandler.createOnActionCallbacks(\n            actionName,\n            store\n        ) ?? {}\n\n        if (!after || !onError) {\n            return\n        }\n\n        this.addOnActionAfterCallback(actionName, store, after)\n        this.addOnActionOnErrorCallback(actionName, store, onError)\n    }\n\n    private defineCurrentEnvironment(): PluginRuntimeEnvironment {\n        return this._options?.runtimeEnvironment\n            ?? (typeof window === 'undefined' ? 'server' : 'client')\n    }\n\n    private definePluginExecution(subscriber: PluginSubscriber): Required<PluginExecutionOptions> {\n        return {\n            ...defaultPluginExecution,\n            ...(this._options?.execution ?? {}),\n            ...(subscriber.execution ?? {}),\n            ...(this._options?.subscriberExecution?.[subscriber.name] ?? {}),\n        }\n    }\n\n    private defineHydrationScheduler(subscriber: PluginSubscriber | PluginSubscriptionDefinition['subscription']): PluginHydrationScheduler {\n        return subscriber.hydrationScheduler ?? this._hydrationScheduler\n    }\n\n    private defineSubscriberKey(subscriber: PluginSubscriber, store: Store): string {\n        return `${subscriber.name}-${store.$id}`\n    }\n\n    private defineSubscriptionKey(pluginName: string, store: Store): string {\n        return `${pluginName}-${store.$id}`\n    }\n\n    private executeResetStoreCallbacks(store: Store): void {\n        this._resetStoreCallback.get(store)?.forEach(callback => callback(store))\n    }\n\n    /**\n     * Executes the store's onAction subscription for the given plugin subscriber.\n     * @param store The Pinia store instance.\n     * @param subscriber The plugin subscriber.\n     * @returns void\n     */\n    private executeStoreOnActionSubscription(store: Store): void {\n        if (this._onActionStores.has(store) || typeof store.$onAction !== 'function') {\n            return\n        }\n        const onActionSubscriptions = this._onActionSubscriptions.get(store)\n        const hasRollbackSnapshots = this._storeRollbackSnapshotsHandler.storeHasRollbackSnapshots(store)\n\n        if (!onActionSubscriptions?.size && !hasRollbackSnapshots) {\n            return\n        }\n\n        this._onActionStores.add(store)\n        store.$onAction(({ after, args, name, onError }) => {\n            const storageKey = getActionStoreKey(name, store)\n            this.trace('plugin:onAction', () => ({\n                args,\n                name,\n                store,\n            }), store.$id)\n\n            if (this._storeRollbackSnapshotsHandler.storeHasRollbackSnapshots(store)) {\n                this.createRollbackSnapshot(name, store)\n            }\n\n            const callbacks = this._onActionSubscriptions.get(store)\n            if (callbacks?.size) {\n                callbacks.forEach(callback => callback({\n                    after: this.createOnActionAfterCallbackCollector(name, store),\n                    args,\n                    name,\n                    onError: this.createOnActionOnErrorCallbackCollector(name, store)\n                }))\n            }\n\n            const afterCallbacks = this._onActionAfterSubscriptions[storageKey]\n            const onErrorCallbacks = this._onActionOnErrorSubscriptions[storageKey]\n\n            this.clearOnActionCallbacksSubscriptions(storageKey)\n\n            if (afterCallbacks?.length) {\n                after((result) => {\n                    afterCallbacks.forEach(callback => callback(result))\n                })\n            }\n            if (onErrorCallbacks?.length) {\n                onError((error) => {\n                    onErrorCallbacks.forEach(callback => callback(error))\n                })\n            }\n        })\n    }\n\n    private executeSubscriber(context: PiniaPluginContext, subscriber: PluginSubscriber): void {\n        const subscriberKey = this.defineSubscriberKey(subscriber, context.store)\n\n        if (this._subscribersDelivered.has(subscriberKey)) {\n            return\n        }\n\n        if (\n            !subscriber.invoke(context, this._options?.createTracer)) {\n            return\n        }\n\n        this._subscribersDelivered.add(subscriberKey)\n\n        let hydrateResult: void | Promise<void>\n\n        try {\n            hydrateResult = subscriber.hydrate?.(context)\n        } catch (error) {\n            this.traceError('subscriber:hydrate', error, () => ({ store: context.store, options: context.options }), context.store.$id)\n            return\n        }\n\n        const runAfterHydration = () => {\n            try {\n                const afterHydration = subscriber.afterHydration?.(context)\n                if (afterHydration && typeof (afterHydration as Promise<void>).then === 'function') {\n                    ; (afterHydration as Promise<void>).catch(error => this.traceError('subscriber:afterHydration', error, () => ({ store: context.store, options: context.options }), context.store.$id))\n                }\n            } catch (error) {\n                this.traceError('subscriber:afterHydration', error, () => ({ store: context.store, options: context.options }), context.store.$id)\n            }\n        }\n\n        if (hydrateResult && typeof (hydrateResult as Promise<void>).then === 'function') {\n            ; (hydrateResult as Promise<void>)\n                .then(() => runAfterHydration())\n                .catch(error => this.traceError('subscriber:hydrate', error, () => ({ store: context.store, options: context.options }), context.store.$id))\n        } else {\n            runAfterHydration()\n        }\n\n        if (subscriber.subscriptions) {\n            this.subscriptionDelivery(context, subscriber.subscriptions)\n        }\n\n        if (subscriber.storeMutationSubscription) {\n            this.storeMutationSubscription(subscriber.storeMutationSubscription)\n        }\n\n        this.storeOnActionSubscription(subscriber)\n\n        if (subscriber.resetStoreCallback) {\n            this.addResetStoreCallback(context.store, subscriber.resetStoreCallback)\n        }\n    }\n\n    private executeSubscriberSafely(context: PiniaPluginContext, subscriber: PluginSubscriber): void {\n        try {\n            this.executeSubscriber(context, subscriber)\n        } catch (e) {\n            this.traceError('subscriber:execute', e, () => ({ store: context.store, options: context.options }), context.store.$id)\n        }\n    }\n\n    private initializeTracer() {\n        if (this._options?.createTracer) {\n            this._tracer = this._options.createTracer('PluginSubscription')\n        }\n    }\n\n    /**\n     * Invokes the plugin with the given Pinia plugin context, executing all relevant subscribers safely.\n     * @param param0 The Pinia plugin context containing the store and options.\n     * @param param0.store The Pinia store instance.\n     * @param param0.options The options passed to the Pinia store.\n     * @returns void\n     */\n    plugin({ store, options }: PiniaPluginContext) {\n        if (!this._subscribers.length) {\n            return\n        }\n\n        this.trace('plugin:invoke', () => ({\n            subscribers: this._subscribers,\n            store,\n            options\n        }), store.$id)\n\n        try {\n            this._subscribers.forEach(\n                subscriber => {\n                    const subscriberKey = this.defineSubscriberKey(subscriber, store)\n                    const execution = this.definePluginExecution(subscriber)\n\n                    if (\n                        this._subscribersDelivered.has(subscriberKey)\n                        || this._subscribersScheduled.has(subscriberKey)\n                    ) {\n                        return\n                    }\n\n                    if (!this.shouldInvokePlugin(execution)) {\n                        return\n                    }\n\n                    if (this.shouldScheduleAfterHydration(execution)) {\n                        this.queueSubscriberExecution({ store, options } as PiniaPluginContext, subscriber, subscriberKey)\n                        return\n                    }\n\n                    this.executeSubscriber({ store, options } as PiniaPluginContext, subscriber)\n                }\n            )\n\n            this.rewriteResetStore({ store } as PiniaPluginContext, store.$state)\n            this._storeRollbackSnapshotsHandler.initFromPluginContext({ store, options } as PiniaPluginContext)\n            this.executeStoreOnActionSubscription(store)\n            this.registerStoreCleanup(store)\n        } catch (e) {\n            this.traceError('plugin:invoke', e, () => ({ store, options }), store.$id)\n        }\n    }\n\n    private queueSubscriberExecution(\n        context: PiniaPluginContext,\n        subscriber: PluginSubscriber,\n        subscriberKey: string\n    ): void {\n        const scheduler = this.defineHydrationScheduler(subscriber)\n\n        this._subscribersScheduled.add(subscriberKey)\n        scheduler(() => {\n            if (this._disposedStores.has(context.store)) {\n                return\n            }\n            this._subscribersScheduled.delete(subscriberKey)\n            this.executeSubscriberSafely(context, subscriber)\n        })\n    }\n\n    private registerStoreCleanup(store: Store): void {\n        if (typeof store.$dispose !== 'function') {\n            return\n        }\n\n        const dispose = store.$dispose.bind(store)\n        const scopedStore = store as AnyObject\n\n        if (scopedStore.__piniaPluginSubscriptionDisposed) {\n            return\n        }\n\n        scopedStore.__piniaPluginSubscriptionDisposed = true\n        store.$dispose = () => {\n            this._disposedStores.add(store)\n            this.clearStoreTracking(store)\n            this._storeRollbackSnapshotsHandler.clearStoreTracking(store)\n            return dispose()\n        }\n    }\n\n    private rewriteResetStore({ store }: PiniaPluginContext, initState: StateTree): void {\n        const safeState = deepClone(initState)\n\n        store.$reset = () => {\n            this.trace('plugin:reset', () => ({\n                initState: safeState,\n                store\n            }), store.$id)\n\n            this.executeResetStoreCallbacks(store)\n\n            store.$patch(deepClone(safeState))\n        }\n    }\n\n    private shouldInvokePlugin(execution: Required<PluginExecutionOptions>): boolean {\n        const currentEnvironment = this.defineCurrentEnvironment()\n\n        return execution.environment === 'both' || execution.environment === currentEnvironment\n    }\n\n    private shouldScheduleAfterHydration(execution: Required<PluginExecutionOptions>): boolean {\n        return this.defineCurrentEnvironment() === 'client' && execution.hydration === 'defer'\n    }\n\n    private storeOnActionSubscription(subscriber: PluginSubscriber): void {\n        const { store, callback } = subscriber?.storeOnActionSubscription?.() ?? {}\n\n        if (!store || !callback) {\n            return\n        }\n\n        if (!this._onActionSubscriptions.has(store)) {\n            this._onActionSubscriptions.set(store, new Set())\n        }\n        this._onActionSubscriptions.get(store)!.add(callback)\n        this.executeStoreOnActionSubscription(store)\n    }\n\n    private storeMutationSubscription(subscription: StoreMutationSubscription): void {\n        const { store, callback } = subscription()\n\n        store.$subscribe((mutation: SubscriptionCallbackMutation<StateTree>) => {\n            this.trace('store:mutation', () => ({ mutation, store }), store.$id)\n            callback(mutation)\n        })\n    }\n\n    private subscriptionDelivery(\n        context: PiniaPluginContext,\n        pluginSubscriptions: PluginSubscriptions\n    ): void {\n        Object.entries(pluginSubscriptions).forEach(([pluginName, pluginSubscription]) => {\n            const subscriptionKey = this.defineSubscriptionKey(pluginName, context.store)\n            const execution = this.definePluginExecution(pluginSubscription.subscription)\n\n            if (\n                this._subscriptionsDelivered.has(subscriptionKey)\n                || this._subscriptionsScheduled.has(subscriptionKey)\n            ) {\n                return\n            }\n\n            if (!this.shouldInvokePlugin(execution)) {\n                return\n            }\n\n            if (this.shouldScheduleAfterHydration(execution)) {\n                const scheduler = this.defineHydrationScheduler(pluginSubscription.subscription)\n\n                this._subscriptionsScheduled.add(subscriptionKey)\n                scheduler(() => {\n                    if (this._disposedStores.has(context.store)) {\n                        return\n                    }\n                    this._subscriptionsScheduled.delete(subscriptionKey)\n                    this.subscriptionDeliverySafely(context, pluginName, pluginSubscription)\n                })\n                return\n            }\n\n            this.subscriptionDeliverySafely(context, pluginName, pluginSubscription)\n        })\n    }\n\n    private subscriptionDeliverySafely(\n        { store, options }: PiniaPluginContext,\n        pluginName: string,\n        pluginSubscription: PluginSubscriptionDefinition\n    ): void {\n        try {\n            if (this._subscriptionsDelivered.has(this.defineSubscriptionKey(pluginName, store))) {\n                return\n            }\n\n            const { subscription, subscriptionOptions, stores } = pluginSubscription\n\n            this.trace('subscription:delivery', () => ({\n                pluginName,\n                subscription,\n                options: pluginSubscription,\n                stores\n            }), store.$id)\n\n            const pluginOptions = {\n                storeOptions: { ...((options as AnyObject)?.storeOptions ?? {}), ...subscriptionOptions }\n            } as AnyObject\n\n            subscription.invoke(\n                { store, options: { ...options, ...pluginOptions } } as PiniaPluginContext\n            )\n            this._subscriptionsDelivered.add(this.defineSubscriptionKey(pluginName, store))\n\n            if (!isEmpty(stores)) {\n                stores?.forEach(\n                    store => subscription.invoke({\n                        store,\n                        options: {\n                            ...options,\n                            ...pluginOptions,\n                            ...((store as AnyObject)?.storeOptions ?? {})\n                        }\n                    } as PiniaPluginContext)\n                )\n            }\n        } catch (e) {\n            this.traceError('subscription:delivery', e, () => ({ store, options }), store.$id)\n        }\n    }\n\n    /**\n     * Emits a structured trace event.\n     * Prefer the factory form for `payload`: it is only resolved when consumed.\n     */\n    private trace(namespace: string, payload?: TracePayload, scope?: string): void {\n        if (this._tracer) {\n            this._tracer.debug(namespace, payload, scope)\n        }\n    }\n\n    /**\n     * Emits a structured error event, or rethrows it when no listener matches.\n     */\n    private traceError(namespace: string, error: unknown, payload?: TracePayload, scope?: string): void {\n        if (this._tracer) {\n            this._tracer.error(namespace, error, payload, scope)\n        } else {\n            console.error(error)\n        }\n    }\n}"],"names":["deepClone","value","key","entryValue","item","clonedObject","createStateSnapshot","state","keys","clonedState","toRaw","RollbackStateSnapshotsHandler","__publicField","store","action","stateKeys","args","actionFn","hasDeniedFirstChar","snapshotKey","error","actionName","getActionStoreKey","options","rollbackSnapshotParams","suffix","stateSnapshot","className","defaultPluginExecution","defaultHydrationScheduler","callback","PluginSubscription","subscribers","isEmpty","storageKey","after","onError","subscriber","pluginName","onActionSubscriptions","hasRollbackSnapshots","name","callbacks","afterCallbacks","onErrorCallbacks","result","context","subscriberKey","hydrateResult","runAfterHydration","afterHydration","e","execution","scheduler","scopedStore","dispose","safeState","initState","currentEnvironment","subscription","mutation","pluginSubscriptions","pluginSubscription","subscriptionKey","subscriptionOptions","stores","pluginOptions","store2","namespace","payload","scope","createPlugin","createHydrationPlugin","hydrationPlugin"],"mappings":";;;;;;AAMO,SAASA,EAAaC,GAAa;AACtC,MAAI,OAAO,mBAAoB;AAC3B,QAAI;AACA,aAAO,gBAAgBA,CAAK;AAAA,IAChC,QAAQ;AAAA,IAER;AAGJ,MAAIA,MAAU,QAAQ,OAAOA,KAAU;AACnC,WAAOA;AAGX,MAAIA,aAAiB;AACjB,WAAO,IAAI;AAAA,MACP,MAAM,KAAKA,EAAM,QAAA,GAAW,CAAC,CAACC,GAAKC,CAAU,MAAM,CAACH,EAAUE,CAAG,GAAGF,EAAUG,CAAU,CAAC,CAAC;AAAA,IAAA;AAIlG,MAAIF,aAAiB;AACjB,WAAO,IAAI,IAAI,MAAM,KAAKA,EAAM,OAAA,GAAU,CAAAE,MAAcH,EAAUG,CAAU,CAAC,CAAC;AAGlF,MAAI,MAAM,QAAQF,CAAK;AACnB,WAAOA,EAAM,IAAI,CAAAG,MAAQJ,EAAUI,CAAI,CAAC;AAG5C,MAAI,OAAO,eAAeH,CAAK,MAAM,OAAO,aAAa,OAAO,eAAeA,CAAK,MAAM;AACtF,WAAO,OAAO;AAAA,MACV,OAAO,QAAQA,CAAgC,EAAE,IAAI,CAAC,CAACC,GAAKE,CAAI,MAAM,CAACF,GAAKF,EAAUI,CAAI,CAAC,CAAC;AAAA,IAAA;AAIpG,QAAMC,IAAe,OAAO,OAAO,OAAO,eAAeJ,CAAK,CAAC;AAC/D,aAAW,CAACC,GAAKE,CAAI,KAAK,OAAO,QAAQH,CAAgC;AACrE,IAAAI,EAAaH,CAAG,IAAIF,EAAUI,CAAI;AAGtC,SAAOC;AACX;ACtCO,SAASC,EAAoBC,GAAkBC,IAAgC,OAAO;AACzF,MAAI,MAAM,QAAQA,CAAI,GAAG;AACrB,UAAMC,IAAkC,CAAA;AACxC,eAAWP,KAAOM;AACd,MAAIN,KAAOK,MACPE,EAAYP,CAAG,IAAIF,EAAUU,EAAMH,EAAML,CAAG,CAAC,CAAC;AAGtD,WAAOO;AAAA,EACX;AAEA,MAAID,MAAS;AACT,UAAM,IAAI,MAAM,2BAA2BA,CAAI,EAAE;AAGrD,SAAOR,EAAUU,EAAMH,CAAK,CAAC;AACjC;ACTA,MAAqBI,EAA8B;AAAA,EAAnD;AACY,IAAAC,EAAA,6CAA8C,IAAA;AAC9C,IAAAA,EAAA,wDAA8C,IAAA;AAC9C,IAAAA,EAAA,2DAA0E,IAAA;AAAA;AAAA,EAAI,kBAAAC,GAAA;AAAA,IAAA,OAAAA,EAAA,yBAAA,eAAAA,EAAA,wBAAA,OAAA,EAAA,QAAAC,GAAA,WAAAC,EAAA,GAAAC,IAAA,CAAA,MAAA;AAAA,YAAAC,IAAAJ,EAAAC,CAAA;AAUtF,UAAA,OAAAG,KAAsC,cAAAC,EAAAJ,CAAA;AAC9B;AAEJ,YAAAN,IAAA,CAAAO,KAAAA,EAAA,WAAA,IAAA,QAAAA,GAEMI,IAAA,KAAA,kBAAiCN,GAAQC,GAAmCN,CAAA;AAC9E;AACA,cAAIS,EAAO,MAAAJ,GAAaG,CAAA;AAAA,MACpB,SAAAI,GAAA;AACJ,mBAAA,WAAAD,GAAAN,CAAA,GAEMO;AAAA,MAEN,UAAA;AACA,aAAI,oBAAAD,CAAA;AAAA,MACA;AAAA,IAAgC;AAAA,EAEhC;AAAA,EACM,wBACRE,GAAAR,GAAA;AACE,UAAAE,IAAK,KAAA,8BAA+B;AAAA,MACxCO,EAAAD,GAAAR,CAAA;AAAA,IACJ;AACJ,QAAA,CAAAE;AAAA;AAAA,UAAAP,IAAAO,EAAA,WAAA,IAAA,QAAAA,GAAAI,IAAA,KAAA,kBAAAN,GAAAQ,GAAAb,CAAA;AAAA,WAAA;AAAA,MAAA,OAAA,MAAA;AAAA,aAAA,oBAAAW,CAAA;AAAA,MASA;AAAA,eAOU,MAAA;AACF,aAAA,WAAkBA,GAAYN,CAAK,GACvC,KAAA,oBAAAM,CAAA;AAAA,MAEA;AAAA,IACI;AAAA,EAAA;AAAA,EAIJ,sBAAoB,EAAA,SAAAI,GAAK,OAAAV,EAAA,GAAA;AAEzB,UAAAW,IAAOD,GAAA,cAAA;AAAA,IACHC,KAAa,CAAA,KAAA,2BAAA,IAAAX,EAAA,GAAA,MAAE,OAAK,KAAAW,WAA+B,CAAAtB,MAAA;AAAE,WAAA,8BAAA;AAAA,QACrDoB,EAAepB,GAAAW,CAAA;AAAA,UACKX;MAChB;AAAA,IACJ,CAAA,GACJ,KAAA,2BAAA,IAAAW,EAAA,GAAA,IACJ,KAAA,kBAAAA,CAAA;AAAA,EAAA;AAAA,EAAA,mBAAAA,GAAA;AAAA,UAAAY,IAAA,IAAAZ,EAAA,GAAA;AAAA,eAAAX,KAAA,MAAA,KAAA,KAAA,8BAAA,KAAA,CAAA;iBAQAuB,WACU,qCAAkCvB,CAAA;AAGhC,SAAA,2BAAK,OAA8BW,EAAA,GAAA;AAAA,eAC/BM,KAAkB,WAAU,KAAA,gBAAA,KAAA,CAAA;AAAA,MAC5BA,EAAA,aAAuB,WAAG,GAAAN,EAAA,GAAA,GAAA,KAAA,KAC9B,gBAAA,OAAAM,CAAA;AAAA,EAEyC;AAAA,EAEjD,WAAKA,MAAuB;AAChC,UAAAO,IAAA,KAAA,gBAAA,IAAAP,CAAA;AAAA,QAAAO;AAAA,UAAA;AAAA,QAAAb,EAAA,OAAAa,CAAA;AAAA,MAAA,SAAAN,GAAA;AAQA,gBAAA,6CAAuC,OAAAD,CAAA,CAAA,IAAAC,CAAA;AAAA,MACnC;AAAA,EAEA;AAAA,EAEQ,oBAAKD,GAAA;AAAwC,IACjDA,KAKJ,KAAA,gBAAW,QAA0B;AAAA,EACjC;AAAA,EAC2C,kBAC3CN,GAAAQ,GAAAN,GAAA;AACJ,UAAAW,IAAApB;AAAA,MACJO,EAAA;AAAA,MAEQE;AAAA,IACJ,GACKI,IAAe,uBAAA,GAAAN,EAAA,GAAA,IAAAQ,CAAA,EAAA;AAChB,gBAAA,gBAAA,IAAAF,GAAAO,CAAA,GACJP;AAAA,EAEA;AAAA,EAC8B,0BACdN,GAAA;AACZ,WAAA,KAAQ,2BAAM,IAAAA,EAAA,GAAA;AAAA,EAAmE;AACrF;AACJ,MAAAc,IAAA,sBAAAC,IAAA;AAAA,EAAA,aAAA;AAAA,EAAA,WAAA;AAAA;AAQI,SAAKC,EAAaC,GAAA;AACd,MAAA,OAAA,SAAA,OAAA,OAAA,OAAA,yBAAA,YAAA;AACJ,WAAA,sBAAA,MAAA,WAAA,WAAAA,GAAA,CAAA,CAAA;AAEA;AAAA,EACJ;AAAA,aAAA,WAAAA,GAAA,CAAA;AAAA;AAAA,MAAAC,EAAA;AAAA,ECjIA,eAAaR,GAAA;ADiIb,IAAAX,EAAA,oBAAAe;AAAA,IAAAf,EAAA;AAAA,IAAAA,EAAA,gCAAA,oBAAA,IAAA;AAAA,IAAAA,EAAA,yBAAA,oBAAA,IAAA;AASQ,IAAAA,EAAA,qCAAgC,CAAA;AACpC,IAAAA,EAAA,uCAAsB,CAAA;AAAA,IAAAA,EAAA;AACZ,IAAAA,EAAA,6BACN,oBAAA,IAAA;AAAA,IAAAA,EAAA,yBACJ,oBAAA,QAAA;AAEA,IAAAA,EAAA,8CAA2C;AAC3C,IAAAA,EAAA,sBAAK,CAAA;AACL,IAAAA,EAAA,+BAAO,oBAAA,IAAA;AACX,IAAAA,EAAA,+BAAA,oBAAA,IAAA;AAAA,IAAAA,EAAA,wBAAA,CAAA;AAAA,IAAAA,EAAA,iCAAA,oBAAA,IAAA;AAAA,IAAAA,EAAA,iCAAA,oBAAA,IAAA;AAAA,IAAAA,EAAA;+BClJWW,GAAA,sBAAAM,GACf,KAAA,WAAAN,GAEA,KAAS,eAAAS,GACL,KAAI,iBAAkB;AAAA,EAClB;AAAA,ED6IJ,IAAA,YAAAA,GAAA;AAOA,SAAA,eAAAA;AAAA,EACI;AAAA,EACJ,IAAA,gBAAA;AACJ,QAAA,CAAAC,EAAA,KAAA,cAAA;;EC9JA;AAAA,EAQQ,yBAAAZ,GAAAR,GAAAiB,GAAA;AACJ,UAAA5B,IAAAoB,EAAAD,GAAAR,CAAA;SAEW,4BAAsBX,CAAA,MACrC,KAAA,4BAAAA,CAAA,IAAA,CAAA,IAGc,KAAA,4BAAqBA,CAAA,GAAA,KAAA4B,CAAA;AAAA,EACvB;AAAA,EACA,2BAAAT,GAAAR,GAAiFiB,GAAI;AACrF,UAAA5B,IAAAoB,EAAAD,GAAsCR,CAAA;AACtC,IAAA,KAAA,8BAAsFX,CAAA,MACtF,KAAA,8BAAkFA,CAAA,IAAA,CAAA,IAElF,KAAA,8BAAAA,IAAgG,KAAI4B,CAAA;AAAA,EACpG;AAAA,EACA,sBAAAjB,GAAAiB,GAAoE;AACpE,IAAA,yBAAoC,IAAAjB,CAAA,KACpC,KAAA,oBAAA,IAAAA,GAA6C,oBAAA,IAAA,CAAA,GAE7C,KAAA,oBAAyC,IAAAA,CAAA,EAAA,IAAAiB,CAAA;AAAA,EACzC;AAAA,EACA,oCAAAI,GAA2C;AAC3C,WAAA,KAAA,4BAAAA,CAAA,GAER,OAAI,KAAA,8BAA6CA,CAAA;AAAA,EAC7C;AAAA,EACJ,mBAAArB,GAAA;AAEA,gCAAuD,OAAAA,CAAA,GACnD,KAAK,gBAAa,OAAAA,CAAc,GAC5B,KAAA,oBAAY,OAAAA,CAAA;AAChB,UAAAY,IAAA,IAAAZ,EAAA,GAAA;AACJ,eAAAX,KAAA,MAAA,KAAA,KAAA,qBAAA;AAEA,MAAAA,EACI,SAAAuB,MAGA,KAAK,6BAA+BvB,CAAA;AAGpC,eAAKA,KAAA,MAAiB,KAAA,KAAA,qBAAA;AAC1B,MAAAA,EAAA,SAAAuB,CAAA,gCAEiC,OAAoBvB,CAAA;AAG7C,eAAKA,KAAA,MAAA,KAAA,KAAA,uBAAoC;AAC7C,MAAAA,EAAA,SAAAuB,CAAA,KACA,KAAK,wBAA4B,OAAMvB,CAAA;AAIvC,eAAMA,KAAM,MAAA,KAAA,KAAkB,uBAAiB;AAC/C,MAAKA,EAAK,oBACD,wBAAA,OAAiCA;AAG9C,eAAAA,KAAA,OAAA,KAAA,KAAA,2BAAA;AAEQ,MAAAA,EAAA,SAAAuB,MACA,OAAM,KAAA,4BAAgCvB,CAAA;AAG1C,eAAKA,KAAA,OAAoB,KAAI,KAAK,6BAAe;AACrD,MAAAA,EAAA,SAAAuB,CAAA,KAEQ,OAAA,KAAA,8BAA8DvB,CAAA;AAAA,EAGtE;AAAA,EAGI,qCAAmCmB,GAAKR,GAAA;AACxC,WAAK,CAAAiB,MAAgB;WAChB,yBAA2BT,GAAKR,GAAAiB,CAAA;AAAA,IACrC;AAAA,EAEA;AAAA,EAEQ,0CAAqCjB,GAAA;AAAA,WACzC,CAAAiB,MAAA;AACJ,WAAA,2BAAAT,GAAAR,GAAAiB,CAAA;AAAA,IAEA;AAAA,EACI;AAAA,EACyC,uBACzCT,GAAAR,GAAA;AACJ,UAAA;AAAA,MAEA,OAAAsB;AAAA,MACI,SAAAC;AAAA,IACI,IAAA,KAAK,+BAA+B;AAAA,MACxCf;AAAA,MACJR;AAAA,IAEA,KAAA,CAAA;AACI,iBAGJ,KAAA,yBAAAQ,GAAAR,GAAAsB,CAAA,GAEA,KAAA,2BAA8Bd,GAAKR,GAAAuB,CAAA;AAAA,EAC/B;AAAA,EACI,2BAAY;AAA+B,WAC/C,KAAA,UAAA,uBAAA,OAAA,SAAA,MAAA,WAAA;AAAA,EAAA;AAAA,EAGJ,sBAAkBC,GAAY;AAC1B,WAAI;AAAA,MACA;MACJ,GAAA,KAAA,UAAA,aAAA,CAAA;AAAA,MACJ,GAAAA,EAAA,aAAA,CAAA;AAAA,MACJ,GAAA,KAAA,UAAA,sBAAAA,EAAA,IAAA,KAAA,CAAA;AAAA,IAAA;AAAA,EAAA;AAAA,EAAA,yBAAAA,GAAA;AAAA,WAAAA,EAAA,sBAAA,KAAA;AAAA,EAAA;AAAA,EAAA,oBAAAA,GAAAxB,GAAA;AAQQ,WAAA,GAAAwB,EAAA,IAAA,IAAAxB,EAAqC,GAAA;AAAA,EACzC;AAAA,EACI,sBAAKyB,GAAyBzB;AAClC,WAAA,GAAAyB,CAAA,IAAAzB,EAAA,GAAA;AAAA,EACJ;AAAA,EAAA,2BAAAA,GAAA;AAAA,SAAA,oBAAA,IAAAA,CAAA,GAAA,QAAA,CAAAiB,MAAAA,EAAAjB,CAAA,CAAA;AAAA,EAAA;AAAA,EAAA,iCAAAA,GAAA;AAAA,QAAA,KAAA,gBAAA,IAAAA,CAAA,KAAA,OAAAA,EAAA,aAAA;AAQQ;AAEA,UAAA0B,IAAK,4BAA8C,IAAQ1B,CAAA,GAC/D2B,IAAA,KAAA,+BAAA,0BAAA3B,CAAA;AACJ,IAAA,CAAA0B,GAAA,QAAA,CAAAC,MAAA,KAAA,gBAAA,IAAA3B,CAAA,GAAAA,EAAA,UAAA,CAAA,EAAA,OAAAsB,GAAA,MAAAnB,GAAA,MAAAyB,GAAA,SAAAL,EAAA,MAAA;AAAA,YAAAF,IAAAZ,EAAAmB,GAAA5B,CAAA;AAAA,WAAA,MAAA,mBAAA,OAAA;AAAA,QAQQ,MAAAG;AAAA,QAIJ,MAAAyB;AAAA,QACI,OAAA5B;AAAA,MACA,IAAAA,EAAA,GAAA,GACA,KAAK,+BAA+B,0BAAAA,CAAA,KACpC,KAAA,uBAAA4B,GAAA5B,CAAA;YAEE6B,IAAA,KAAA,uBAAA,IAAA7B,CAAA;MAED6B,WACDA,EAAA,QAAA,CAAAZ,MAAAA,EAAA;AAAA,QACJ,OAAA,KAAA,qCAAAW,GAAA5B,CAAA;AAAA,QAEK,MAAAG;AAAA,QACA,MAAAyB;AAAA,QACT,SAAA,KAAA,uCAAAA,GAAA5B,CAAA;AAAA;AAKA,YAAA8B,IAAA,KAAA,4BAAAT,CAAA,GAEQU,IAAsB,KAAgE,8BAAAV,CAAA;AAC1F,WAAO,oCAAAA,CAAA,GACAS,GAAA,YACM,OAAU;AACf,QAAAA,EAAW,QAAa,CAAAb,MAACA,EAAAe,CAAA,CAAA;AAAA,MAC7B,CAAI,GAEZD,GAAA,UAEQR,EAAA,CAAAhB,MAAyB;yBACgBU,EAAAV,CAAA,CAAA;AAAA,MACjD,CAAA;AAAA,IAGI,CAAA;AAAA,EACJ;AAAA,EAEQ,kBAAA0B,GAAsBT,GAAoB;AAC9C,UAAAU,IAAoB,KAAI,oBAASV,GAAAS,EAAA,KAAA;AAKrC,QAJA,KAAA,sBAAA,IAAAC,CAAA,KAIA,CAAAV,EAAA,OAAAS,GAAA,KAAA,UAAA,YAAA;AAAA;AAAA,SAAA,sBAAA,IAAAC,CAAA;AAAA,QAAAC;AAAA,QAAA;AAAA,MAAAA,IAAAX,EAAA,UAAAS,CAAA;AAAA,IAQQ,SAAA1B,GAAA;WACA,WAAK,yBAAqC,OAAM,EAAA,gBAA0B,SAAA0B,EAAA,QAAA,IAAAA,EAAA,MAAA,GAAA;AAC1E;AAAA,IACJ;AACA,UAAMG,IAAA,MAAwB;AAC9B,UAAM;AAEF,cAACC,IAAAb,oBAAsD;AACvD,QAAAa,KAAA,OAAAA,EAAA,QAAA,cAGCA,EAAgB,aAAS,KAAA,WAAA,6BAAA9B,GAAA,OAAA,EAAA,OAAA0B,EAAA,OAAA,SAAAA,EAAA,QAAA,IAAAA,EAAA,MAAA,GAAA,CAAA;AAAA,MAE1B,YAAM;aACD,WAAM,6BAA0B1B,GAAA,OAAA,EAAA,OAAA0B,EAAA,OAAA,SAAAA,EAAA,QAAA,IAAAA,EAAA,MAAA,GAAA;AAAA,MAAA;AAAA,IACjC;AACA,IACAE,KAAA,OAAAA,EAAA,QAAA,aAAAA,EACS,KAAA,MAAAC,EAAA,CAAA,EAAA,MAAA,CAAA7B,MAAA,KAAA,WAAA,sBAAAA,GAAA,OAAA,EAAA,OAAA0B,EAAA,OAAA,SAAAA,EAAA,QAAA,IAAAA,EAAA,MAAA,GAAA,CAAA,IAGTG,EAAK,GAGTZ,EAAM,iBACN,KAAI,qBAAiBS,GAAAT,EAAA,aAAA,GACsBA,EAC5B,6BAAqD,KAC5D,0BAAAA,EAAA,yBAAA,GACA,KAAA,8BACgEA,EAClE,sBACN,KAAA,sBAAAS,EAAA,OAAAT,EAAA,kBAAA;AAAA,EAGA;AAAA,EAEA,wBAAKS,GAAAT,GAAoC;AAEzC,QAAA;AACI,WAAA,kBAAkBS,GAAAT,CAAA;AAAA,IACd,SAAAc,GAAA;AAAmD,WACtD,WAAA,sBAAAA,GAAA,OAAA,EAAA,OAAAL,EAAA,OAAA,SAAAA,EAAA,QAAA,IAAAA,EAAA,MAAA,GAAA;AAAA,IAAA;AAAA,EAEL;AAAA,EACI,mBAAS;AACL,IAAA,KAAA,UAAA,iBAAoD,KACvD,UAAA,KAAA,SAAA,aAAA,oBAAA;AAAA,EACL;AAAA,EAIA,OAAA,EAAA,OAAAjC,GAAA,SAAAU,EAAkB,GAA6B;AACnD,QAAA,KAAM,aAAgB,QAItB;AAAA,WAAA,MAAA,iBAAA,OAAA;AAAA,QAEA,aACK;QACD,OAAAV;AAAA,QACJ,SAAAU;AAAA,MAEA,IAAAV,EAAK,GAAA;AAEL,UAAI;AAEJ,aAAI,aAAA;AAAA,iBACgB;kBACXkC,IAAO,KAAA,oBAAAV,GAAAxB,CAAA,GACPuC,IAAW,KAAA,sBAA6Bf,CAAS;AACtD,gBAAA,OAAA,sBAAA,IAAAU,CAAA,KAAA,KAAA,sBAAA,IAAAA,CAAA,MAII,KAAA,mBAAAK,CAAA,GAGI;AAAA,kBAAA,KAAA,6BAAAA,CAAA,GAAA;8CAAmD,EAAA,OAAAvC,GAAK,SAAAU,EAAW,GAAAc,GAAAU,CAA6B;AACpG;AAAA;AAEA,mBAAK,kBAAW,EAAA,OAAAlC,GAAA,SAAAU,EAAA,GAA6Bc,CAAO;AAAA;AAAA,UACxD;AAAA,QACJ,GAEA,uBAAqB,EAAA,OAAAxB,OAAwC,MAAA,GACtD,KAAA,+BACa,sBACL,YAAS,SAAAU,MACxB,KAAO,iCAAAV,CAAA,GACH,0BAAkBA,CAAA;AAAA,MACtB,SAAAsC,GAAA;AAEA,aAAI,WAAW,iBAAeA,GAAA,OAAA,EAAA,OAAAtC,GAAA,SAAAU,EAAA,IAAAV,EAAA,GAAA;AAAA,MAC1B;AAAA;AAAA,EAA2D;AAAA,EAG/D,yBAAeiC,GAAAT,GAA2BU,GAAA;AACtC,UAAAM,IAAK,KAAA;AACT,SAAA,sBAAA,IAAAN,CAAA,GAEAM,EAAK,MAAA;AAEL,MAAI,KAAA,gBAAW,IAAAP,EAAoB,KAAA,MAGvC,KAAA,sBAAA,OAAAC,CAAA,GAEQ,KAAA,wBAAqDD,IAAoC;AAAA,IAC7F,CAAA;AAAA,EACI;AAAA,EAA0C,qBAClCjC,GAAA;AACR,QAAA,OAAKA,EAAA,YAAW;AACpB;cAGIA,EAAmB,SAAA,KAAAA,CAAA,GACnByC;AACA,IAAAA,EAAK,sCAEbA,EAAA,oCAAA,IAAAzC,EAAA,WAAA,OAAA,KAAA,gBAAA,IAAAA,CAAA,GAAA,KAAA,mBAAAA,CAAA,GAAA,KAAA,+BAAA,mBAAAA,CAAA,GAAA0C,EAAA;AAAA,EASA;AAAA,EACI,kBAAU,EAAA,OAAA1C,QAAqB;AAC3B,UAAA2C,IAAAxD,EAAAyD,CAAA;AACJ,IAAA5C,EAAA,SAAA,MAAA;WAEK,MAAM,gBAAiB,OAAO;AAAA,QAC/B,WAAa2C;AAAA,QACb,OAAA3C;AAAA,MACA,IAAAA,EAAA,GAAA,GACJ,KAAI,2BAASA,CAAA,GAEbA,EAAI,OAAAb,EAAAwD,CAAA,CAAA;AAAA,IACA;AAAA,EAAkB;AAAA,EAEV,mBAAMJ,GAAgB;AACtB,UAAAM,IAAkB,KAAK;AAEvB,uCACmCN,EAAA,gBACvBM;AAAA,EAER;AAAA,EAAA,6BACJN,GAAA;AAEA,WAAA,KAAK,yBAAwB,MAAA,YAAYA,EAAA,cAAA;AAAA,EACrC;AAAA,EAAA,0BACJf,GAAA;AAEA,UAAA,YAAS,UAAAP,qCAAyC,KAAA,CAAA;AAC9C,IAAA,CAAAjB,KAAK,CAAAiB,MAIT,KAAA,uBAAyB,IAAAjB,CAAO,KAA2C,KAC/E,uBAAA,IAAAA,GAAA,oBAAA,IAAA,CAAA,GAGJ,KAAA,uBAAyB,IAAAA,CAA+B,EAAA,IAAMiB,CAAM,GACpE,KAAA,iCAAoCjB,CAAA;AAAA,EACpC;AAAA,EACA,0BAAK8C,GAA0B;AACnC,sBAAY,UAAA7B,EAAA,IAAA6B,EAAA;AACR,IAAA9C,EAAA,WAAK,CAAW+C,MAAA;AACpB,WAAA,MAAA,kBAAA,OAAA,EAAA,UAAAA,GAAA,OAAA/C,EAAA,IAAAA,EAAA,GAAA,GACJiB,EAAA8B,CAAA;AAAA;EAOI;AAAA,EAEA,qBAAKd,GAAsBe,GAAiB;AAC5C,WAAA,QAAUA,CAAM,EAAA,QAAA,CAAA,CAAAvB,GAAAwB,CAAA,MAAA;AACZ,YAAIC,IAAK,KAAoB,sBAAgBzB,GAAAQ,EAAA,KAAA,GACzCM,IAAA,KAAA,sBAAAU,EAAA,YAAA;AACJ,UAAA,OAAA,wBAAA,IAAAC,CAAA,KAAA,KAAA,wBAAA,IAAAA,CAAA,MAGH,KAAA,mBAAAX,CAAA;YAIG,KAAO,6BAAmBA,CAAY,GAAA;AACtC,gBAAAC,IAAA,KAAA,yBAAAS,EAAA,YAAA;AACJ,eAAA,wBAAA,IAAAC,CAAA,GAEAV,EAAM,MAAU;AACV,YAAA,KAAA,gBAAc,IAAAP,EAAA,KAAA,MAIpB,KAAA,wBAAA,OAAAiB,CAAA,GAEA,KAAA,2BAAYjB,GAAAR,GAAoCwB,CAAA;AAAA,UAChD,CAAA;;QAEI;AACA,aAAK,2BAAAhB,GAA+BR,GAAAwB,CAAwB;AAAA;AAAA,IAC5D,CAAA;AAAA,EAAe;AAAA,EAEvB,2BAAA,EAAA,OAAAjD,GAAA,SAAAU,EAAA,GAAAe,GAAAwB,GAAA;;UAGU,KAAA,4BAA+B,KAAA,sBAAAxB,GAAAzB,CAAA,CAAA;AAErC;AACsC,YAC9B,EAAA,cAAA8C,GAAW,qBAAAK,GAAA,QAAAC,EAAA,IAAAH;AAAA,WACX,MAAA,yBAAA,OAAA;AAAA,QACJ,YAAAxB;AAAA,QAEA,cAAAqB;AAAA,QAEA,SAAMG;AAAA,QACV,QAAAG;AAAA,MACJ,IAAApD,EAAA,GAAA;AAEQ,YAAAqD,IAAmB;AAAA,sBACjB,EAAA,GAAA3C,GAA0B,yBAAyB;AAAA,MAEzD;AACJ,MAAAoC,EAAA;AAAA,QAEQ,EAAA,OAAA9C,GAAA,SAAA,EAAA,GAA6BU,GAAA,GAAsD2C,EAAA,EAAA;AAAA,MACvF,GACJ,KAAA,wBAAA,IAAA,KAAA,sBAAA5B,GAAAzB,CAAA,CAAA,GAEQoB,EAAAgC,CAAA,KACJA,GAAQ;AAAA,QAEH,CAAAE,QAAoB,OAAA;AAAA,UACrB,OAAAA;AAAA,UACJ,SAAA;AAAA,YAEU,GAAA5C;AAAA,YACD,GAAA2C;AAAA,YACT,GAAAC,GAAA,gBAAA,CAAA;AAAA,UACK;AAAA,QACA,CAAA;AAAA,MACT;AAAA,IAGI,SAAQhB,GAAA;WAEF,WAAY,yBAAsDA,GAAA,OAAA,EAAA,OAAAtC,GAAA,SAAAU,EAAA,IAAAV,EAAA,GAAA;AAAA,IACpE;AAAA,EACA;AAAA,EAER,MAAAuD,GAAAC,GAAAC,GAAA;AAEQ,IAAA,KAAA,WAIJ,KAAO,QAAQ,YAAqBA,CAAU;AAAA,EAE1C;AAAA,EAMI,WAAAF,GAAAhD,GAAAiD,GAAAC,GAAA;AAAA,IACJ,KAAA,UAEA,KAAK,iBAAwBlD,GAAAiD,GAAYC,CAAA,IAEzC,QAAA,MAAAlD,CAAA;AAAA,EAGI;AAEA;AAEI,SAAAmD,EAASvC,GAAgBT,GAAI;AACzB,QAAAuC,IAAA,IAAA/B,EAAAC,GAAAT,CAAA;AAAA,SAAAuC,EACJ,OAAA,KAAAA,CAAA;AACA;AACuE,SAC1EU,EAAAxC,GAAAT,GAAA;AACD,QAAAkD,IAAA,IAAA1C,EAAAC,GAAA;AAAA,IAAA,WACJT,GAAA;AAAA,IAEA,oBAAKA,GAAA;AAAA,IACT,oBAACA,GAAA;AAAA,IACL,qBAAAA,GAAA;AAAA,EAEQ,CAAA;AAKJ,SAAIkD,EAAA,OAAA,KAAAA,CAAA;AACA;"}

package/dist/plugins/createHydrationPlugin.d.ts

@@ -1,3 +1,10 @@
 import type { PiniaPlugin } from 'pinia';
 import type { PluginSubscriber, PluginSubscriptionOptions } from '../types/plugin';
+/**
+ * Creates a Pinia plugin that manages hydration for the specified plugin subscribers.
+ * @param subscribers The list of plugin subscribers to be used by the hydration plugin.
+ * @param options The options for configuring the plugin subscription.
+ * @returns A Pinia plugin that handles hydration based on the provided subscribers and options.
+ * @deprecated use `createPlugin` with appropriate hydration options instead.
+ */
 export declare function createHydrationPlugin(subscribers: PluginSubscriber[], options?: PluginSubscriptionOptions): PiniaPlugin;

package/dist/plugins/createPlugin.d.ts

@@ -1,7 +1,14 @@
 import type { PiniaPlugin } from "pinia";
-import type { PluginSubscriber } from "../types/plugin";
+import type { PluginSubscriber, PluginSubscriptionOptions } from "../types/plugin";
 import type { RollbackActionParams, StoreOptions } from "../types/store";
-export declare function createPlugin(subscribers: PluginSubscriber[], debug?: string[]): PiniaPlugin;
+/**
+ * Creates a Pinia plugin that manages the specified plugin subscribers.
+ *
+ * @param subscribers The list of plugin subscribers to be used by the plugin.
+ * @param options The options for configuring the plugin subscription.
+ * @returns A Pinia plugin that handles the provided subscribers and options.
+ */
+export declare function createPlugin(subscribers: PluginSubscriber[], options?: PluginSubscriptionOptions): PiniaPlugin;
 declare module 'pinia' {
     interface PiniaCustomProperties {
         /**

package/dist/system/Tracer.d.ts

@@ -0,0 +1,20 @@
+import type { TraceListener, TracePayload, TracerOptions } from '../types/trace';
+/**
+ * Emits structured trace events.
+ *
+ * Nothing is allocated when no listener matches:
+ * the payload is a factory resolved only once a consumer is known.
+ */
+export default class Tracer {
+    private readonly _listeners;
+    private _scope?;
+    private readonly _source;
+    constructor(source: string, listeners: TraceListener[], options?: TracerOptions);
+    get scope(): string | undefined;
+    set scope(scope: string | undefined);
+    get source(): string;
+    debug(namespace: string, payload?: TracePayload, scope?: string): void;
+    /** Relays the error to matching listeners, or reports it when none match. */
+    error(namespace: string, error: unknown, payload?: TracePayload, scope?: string): void;
+    private emit;
+}

package/dist/system/createConsoleTraceListener.d.ts

@@ -0,0 +1,6 @@
+import type { Console } from '../types/log';
+import type { TraceListener } from '../types/trace';
+/**
+ * Creates an opt-in trace listener that reproduces the former console output.
+ */
+export declare function createConsoleTraceListener(target?: Console): TraceListener;

package/dist/types/index.d.ts

@@ -1,4 +1,15 @@
 import type { PiniaPluginContext, Store as PiniaStore } from 'pinia';
+/**
+ * Centralized extension point for per-store plugin options.
+ *
+ * Subscriber plugins MUST NOT redeclare pinia's `DefineStoreOptionsBase`:
+ * merging a `storeOptions` property with a different (even compatible) type
+ * raises TS2717 in consumer code. Instead, they augment this interface via
+ * `declare module 'pinia-plugin-subscription/types'`, which merges safely as
+ * long as each plugin declares its own optional keys.
+ */
+export interface StoreOptionsExtensions {
+}
 import type { PluginExecutionOptions, PluginHydrationScheduler, PluginSubscriptions, StoreMutationSubscription, StoreOnActionSubscription } from './plugin';
 import type { StoreOptions } from './store';
 export interface AnyObject {
@@ -19,20 +30,20 @@ export type ConsoleStyleDefinition = StyleDefinition;
 export type ConsoleStyleDefinitionKeys = StyleDefinitionKeys;
 export type ConsoleStyleDefinitions = StyleDefinitions;
 export type { List, ListTypes, ListTypesMap, PartialList } from './list';
-export type { CustomStore, DefineAStoreDefinition, DefineAStoreSetupContext, DefineAStoreSetupExtensions, EmptyExtensions, PluginStoreOptions, StatePropertyValue, StoreOptions, StoreOptionsExtensions, StoreOptionsPropertyValue } from './store';
+export type { TraceEvent, TraceEventMetadata, TraceFilter, TraceHandler, TraceLevel, TraceListener, TraceListenerRemover, TracePayload, TraceRegistry, TracerOptions } from './trace';
+export type { CustomStore, DefineAStoreSetupContext, DefineAStoreSetupExtensions, EmptyExtensions, PluginStoreOptions, StatePropertyValue, StoreOptions, StoreOptionsPropertyValue } from './store';
 export type { NativePiniaSubscription, NativePiniaSubscriptionReturn, PluginExecutionEnvironment, PluginExecutionOptions, PluginHydrationScheduler, PluginHydrationTiming, PluginRuntimeEnvironment, PluginSubscriber, PluginSubscription, PluginSubscriptionOptions, PluginSubscriptions, StoreMutationSubscription, StoreMutationSubscriptionCallback, StoreMutationSubscriptionReturn, StoreOnActionCallbackParameters, StoreOnActionSubscription, StoreOnActionSubscriptionCallback, StoreOnActionSubscriptionReturn, } from './plugin';
 export interface PluginSubscriberInterface {
-    console?: Console;
     execution?: PluginExecutionOptions;
-    hydrate?: (context: PiniaPluginContext, debug: boolean) => void | Promise<void>;
+    hydrate?: (context: PiniaPluginContext) => void | Promise<void>;
     hydrationScheduler?: PluginHydrationScheduler;
-    invoke: (context: PiniaPluginContext, debug: boolean) => boolean;
+    invoke: (context: PiniaPluginContext) => boolean;
     name: string;
     resetStoreCallback?: (store?: PiniaStore) => void;
     storeOnActionSubscription?: StoreOnActionSubscription;
     storeMutationSubscription?: StoreMutationSubscription;
     subscriptions?: PluginSubscriptions;
-    afterHydration?: (context: PiniaPluginContext, debug: boolean) => void | Promise<void>;
+    afterHydration?: (context: PiniaPluginContext) => void | Promise<void>;
 }
 export interface PluginSubscriptionDefinition {
     stores?: PiniaStore[];

package/dist/types/plugin.d.ts

@@ -1,6 +1,7 @@
 import type { PiniaPluginContext, StateTree, Store, SubscriptionCallbackMutation } from "pinia";
 import type { StoreOptions } from "./store";
-import type { Console, PluginSubscriberInterface } from ".";
+import type { PluginSubscriberInterface } from ".";
+import Tracer from "../system/Tracer";
 export type CreateStateSnapshotKeys = (keyof StateTree)[] | 'all';
 export type PluginHydrationScheduler = (callback: () => void) => void;
 export type PluginHydrationTiming = 'defer' | 'immediate';
@@ -11,24 +12,62 @@ export interface PluginExecutionOptions {
     hydration?: PluginHydrationTiming;
 }
 export interface PluginSubscriptionOptions {
-    debug?: string[];
+    createTracer?: (source: string) => Tracer;
     execution?: PluginExecutionOptions;
     hydrationScheduler?: PluginHydrationScheduler;
     runtimeEnvironment?: PluginRuntimeEnvironment;
     subscriberExecution?: Record<string, PluginExecutionOptions>;
 }
 export interface PluginSubscriber {
-    console?: Console;
+    /**
+     * Execution options for the plugin subscriber.
+     * This determines how and when the plugin subscriber should be executed.
+     */
     execution?: PluginExecutionOptions;
-    hydrate?: (context: PiniaPluginContext, debug: boolean) => void | Promise<void>;
+    /**
+     * Function to hydrate the plugin subscriber.
+     * This is typically called during the hydration phase of the application.
+     */
+    hydrate?: (context: PiniaPluginContext) => void | Promise<void>;
+    /**
+     * Scheduler for the hydration of the plugin subscriber.
+     * This allows controlling when the hydration should occur.
+     */
     hydrationScheduler?: PluginHydrationScheduler;
-    invoke: (context: PiniaPluginContext, debug: boolean) => boolean;
+    /**
+     * Function to invoke the plugin subscriber.
+     * Returns a boolean indicating whether the invocation was successful.
+     */
+    invoke: (context: PiniaPluginContext, createTracer?: (source: string) => Tracer) => boolean;
+    /**
+     * Name of the plugin subscriber.
+     */
     name: string;
+    /**
+     * Callback to reset the store associated with the plugin subscriber.
+     * This is typically used to clean up or reinitialize the store.
+     */
     resetStoreCallback?: (store?: Store) => void;
+    /**
+     * Subscription for store actions.
+     * This is typically used to listen for and respond to actions dispatched in the store.
+     */
     storeOnActionSubscription?: StoreOnActionSubscription;
+    /**
+     * Subscription for store mutations.
+     * This is typically used to listen for and respond to mutations committed in the store.
+     */
     storeMutationSubscription?: StoreMutationSubscription;
+    /**
+     * Subscriptions for the plugin subscriber.
+     * This is typically used to manage and respond to various plugin-specific events or changes.
+     */
     subscriptions?: PluginSubscriptions;
-    afterHydration?: (context: PiniaPluginContext, debug: boolean) => void | Promise<void>;
+    /**
+     * Callback to be executed after the hydration of the plugin subscriber.
+     * This is typically used to perform any post-hydration logic.
+     */
+    afterHydration?: (context: PiniaPluginContext) => void | Promise<void>;
 }
 export interface NativePiniaSubscriptionReturn<Callback> {
     store: Store;

package/dist/types/store.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from ".";
+import type { AnyObject, StoreOptionsExtensions } from ".";
 import type { CreateStateSnapshotKeys } from "./plugin";
 import type { Pinia, PiniaCustomProperties, StateTree, Store, StoreDefinition, StoreGeneric } from "pinia";
 import type { Ref } from "vue";
@@ -13,15 +13,22 @@ export type CustomStore<TStore, TState> = Store & TStore & TState & PiniaCustomP
  * prototypes. It extends pinia's `StoreDefinition` to stay assignable
  * wherever a standard store definition is expected.
  */
-export interface DefineAStoreDefinition<TStore, TState, Id extends string = string> extends StoreDefinition<Id, StateTree & TState> {
+export interface DefineAStoreDefinition<TStore, TState, Id extends string = string> extends StoreDefinition<Id, StrictStateTree<TState>> {
     /**
      * Returns a store, creates it if necessary.
      *
      * @param pinia - Pinia instance to retrieve the store
      * @param hot - dev only hot module replacement
      */
-    (pinia?: Pinia | null, hot?: StoreGeneric): Store<Id, StateTree & TState> & TStore;
+    (pinia?: Pinia | null, hot?: StoreGeneric): Store<Id, StrictStateTree<TState>> & TStore;
 }
+/**
+ * Maps a state interface to a pinia `StateTree` without intersecting it with
+ * `StateTree` itself, whose `any` index signature would widen every store member to `any`.
+ */
+export type StrictStateTree<TState> = {
+    [K in keyof TState]: TState[K];
+} extends infer S extends StateTree ? S : never;
 export type EmptyExtensions = Record<never, never>;
 export interface DefineAStoreSetupExtensions<TEnhancedStore> {
     /**
@@ -58,11 +65,9 @@ type StdStatePropertyValue = AnyObject | boolean | null | number | string | unde
  * `declare module 'pinia-plugin-subscription/types'`, which merges safely as
  * long as each plugin declares its own optional keys.
  */
-export interface StoreOptionsExtensions {
-}
-export interface StoreOptions extends StoreOptionsExtensions {
+export type StoreOptions = StoreOptionsExtensions & {
     [key: string]: StoreOptionsPropertyValue;
     rollbackAfterFailure?: RollbackAfterFailureParams;
-}
+};
 export type StoreOptionsPropertyValue = OptionBaseProperty | OptionBaseProperty[] | ObjectBaseProperty | ObjectBaseProperty[];
 export {};

package/dist/types/trace.d.ts

@@ -0,0 +1,80 @@
+import type { AnyObject } from './index';
+import type Tracer from '../system/Tracer';
+/**
+ * Severity of a trace event.
+ * `error` events are delivered to matching listeners, or reported with `console.error` when none match.
+ */
+export type TraceLevel = 'debug' | 'error';
+/**
+ * Cheap descriptor of an event, built before the payload is resolved.
+ * Filters receive this object so that discarded events never allocate a payload.
+ */
+export interface TraceEventMetadata {
+    level: TraceLevel;
+    /** Structured, colon separated identifier, e.g. `subscription:delivery`. */
+    namespace: string;
+    /** Instance the event belongs to, usually a Pinia `store.$id`. */
+    scope?: string;
+    /** Emitting class name, e.g. `PluginSubscription`. */
+    source: string;
+}
+/**
+ * A resolved trace event, handed over to listeners.
+ */
+export interface TraceEvent extends TraceEventMetadata {
+    error?: unknown;
+    payload?: AnyObject;
+    timestamp: number;
+}
+/**
+ * Event data. Prefer the function form: it is only invoked when a listener
+ * actually consumes the event, keeping unobserved tracing allocation free.
+ */
+export type TracePayload = AnyObject | (() => AnyObject);
+/**
+ * Determines whether a trace event should be delivered to a listener.
+ * @param event The metadata of the trace event.
+ * @returns `true` if the event should be delivered to the listener, otherwise `false`.
+ */
+export type TraceFilter = (event: TraceEventMetadata) => boolean;
+/**
+ * Handles a trace event.
+ * @param event The resolved trace event to handle.
+ */
+export type TraceHandler = (event: TraceEvent) => void;
+export interface TraceListener {
+    /** Evaluated on every event; return `true` to receive it. Omit to receive all. */
+    filter?: TraceFilter;
+    /** Handles the trace event when it passes the filter. */
+    handler: TraceHandler;
+}
+/** Removes a previously registered listener. */
+export type TraceListenerRemover = () => void;
+export type TraceRegistry = {
+    /**
+     * Registers a trace listener and returns its remover.
+     * Listeners are evaluated in registration order.
+     * @param listener The trace listener to register.
+     * @returns A function that removes the registered listener when called.
+     */
+    addTraceListener: (listener: TraceListener) => TraceListenerRemover;
+    /**
+     * Clears all registered trace listeners.
+     */
+    clearTraceListeners: () => void;
+    /**
+     * Creates a new tracer instance.
+     * @param source The source of the tracer, usually the class name.
+     * @param options Optional tracer options.
+     * @returns A new tracer instance.
+     */
+    createTracer: (source: string, options?: TracerOptions) => Tracer;
+    /**
+     * Checks if there are any registered trace listeners.
+     * @returns True if there are registered trace listeners, otherwise false.
+     */
+    hasTraceListeners: () => boolean;
+};
+export interface TracerOptions {
+    scope?: string;
+}