mvc-kit 2.12.4 → 2.13.0

package/dist/Resource.cjs

@@ -1,175 +1,167 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const Collection = require("./Collection.cjs");
-const walkPrototypeChain = require("./walkPrototypeChain.cjs");
-const wrapAsyncMethods = require("./wrapAsyncMethods.cjs");
-const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
-const DEFAULT_TASK_STATE = Object.freeze({ loading: false, error: null, errorCode: null });
-const RESERVED_ASYNC_KEYS = ["async", "subscribeAsync"];
-const LIFECYCLE_HOOKS = /* @__PURE__ */ new Set(["onInit", "onDispose"]);
-class Resource extends Collection.Collection {
-  _external = null;
-  _initialized = false;
-  // ── Async tracking fields ──
-  _asyncStates = /* @__PURE__ */ new Map();
-  _asyncSnapshots = /* @__PURE__ */ new Map();
-  _asyncListeners = /* @__PURE__ */ new Set();
-  _asyncProxy = null;
-  _activeOps = null;
-  /** DEV-only timeout (ms) for detecting ghost async operations after dispose. */
-  static GHOST_TIMEOUT = 3e3;
-  constructor(collectionOrItems) {
-    const isExternal = collectionOrItems != null && !Array.isArray(collectionOrItems);
-    super(isExternal ? [] : collectionOrItems ?? []);
-    if (isExternal) {
-      this._external = collectionOrItems;
-      if (__DEV__) {
-        const Ctor = this.constructor;
-        if (Ctor.MAX_SIZE > 0 || Ctor.TTL > 0) {
-          console.warn(
-            `[mvc-kit] Resource "${Ctor.name}" has MAX_SIZE or TTL set but uses an injected Collection. Configure these on the Collection instead.`
-          );
-        }
-      }
-    }
-    this._guardReservedKeys();
-  }
-  // ── Lifecycle ─────────────────────────────────────────────────
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (this._initialized || this.disposed) return;
-    this._initialized = true;
-    if (__DEV__) {
-      this._activeOps = /* @__PURE__ */ new Map();
-    }
-    wrapAsyncMethods.wrapAsyncMethods({
-      instance: this,
-      stopPrototype: Resource.prototype,
-      reservedKeys: RESERVED_ASYNC_KEYS,
-      lifecycleHooks: LIFECYCLE_HOOKS,
-      isDisposed: () => this.disposed,
-      isInitialized: () => this._initialized,
-      asyncStates: this._asyncStates,
-      asyncSnapshots: this._asyncSnapshots,
-      asyncListeners: this._asyncListeners,
-      notifyAsync: () => this._notifyAsync(),
-      addCleanup: (fn) => this.addCleanup(fn),
-      ghostTimeout: this.constructor.GHOST_TIMEOUT,
-      className: "Resource",
-      activeOps: this._activeOps
-    });
-    return this.onInit?.();
-  }
-  // ── Collection delegation ─────────────────────────────────────
-  /** Current items array. Delegates to external Collection when injected. */
-  get state() {
-    return this._external ? this._external.state : super.state;
-  }
-  /** The raw array of items. Delegates to external Collection when injected. */
-  get items() {
-    return this._external ? this._external.items : super.items;
-  }
-  /** Number of items. Delegates to external Collection when injected. */
-  get length() {
-    return this._external ? this._external.length : super.length;
-  }
-  add(...items) {
-    this._external ? this._external.add(...items) : super.add(...items);
-  }
-  upsert(...items) {
-    this._external ? this._external.upsert(...items) : super.upsert(...items);
-  }
-  update(id, changes) {
-    this._external ? this._external.update(id, changes) : super.update(id, changes);
-  }
-  remove(...ids) {
-    this._external ? this._external.remove(...ids) : super.remove(...ids);
-  }
-  reset(items) {
-    this._external ? this._external.reset(items) : super.reset(items);
-  }
-  clear() {
-    this._external ? this._external.clear() : super.clear();
-  }
-  optimistic(callback) {
-    return this._external ? this._external.optimistic(callback) : super.optimistic(callback);
-  }
-  get(id) {
-    return this._external ? this._external.get(id) : super.get(id);
-  }
-  has(id) {
-    return this._external ? this._external.has(id) : super.has(id);
-  }
-  find(predicate) {
-    return this._external ? this._external.find(predicate) : super.find(predicate);
-  }
-  filter(predicate) {
-    return this._external ? this._external.filter(predicate) : super.filter(predicate);
-  }
-  sorted(compareFn) {
-    return this._external ? this._external.sorted(compareFn) : super.sorted(compareFn);
-  }
-  map(fn) {
-    return this._external ? this._external.map(fn) : super.map(fn);
-  }
-  subscribe(listener) {
-    if (this.disposed) return () => {
-    };
-    return this._external ? this._external.subscribe(listener) : super.subscribe(listener);
-  }
-  // ── Async tracking API ────────────────────────────────────────
-  /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */
-  get async() {
-    if (!this._asyncProxy) {
-      const self = this;
-      this._asyncProxy = new Proxy({}, {
-        get(_, prop) {
-          return self._asyncSnapshots.get(prop) ?? DEFAULT_TASK_STATE;
-        },
-        has(_, prop) {
-          return self._asyncSnapshots.has(prop);
-        },
-        ownKeys() {
-          return Array.from(self._asyncSnapshots.keys());
-        },
-        getOwnPropertyDescriptor(_, prop) {
-          if (self._asyncSnapshots.has(prop)) {
-            return { configurable: true, enumerable: true, value: self._asyncSnapshots.get(prop) };
-          }
-          return void 0;
-        }
-      });
-    }
-    return this._asyncProxy;
-  }
-  /** Subscribes to async state changes. Used by `useInstance` for React integration. */
-  subscribeAsync(listener) {
-    if (this.disposed) return () => {
-    };
-    this._asyncListeners.add(listener);
-    return () => {
-      this._asyncListeners.delete(listener);
-    };
-  }
-  // ── Private: async tracking internals ─────────────────────────
-  _notifyAsync() {
-    for (const listener of this._asyncListeners) {
-      listener();
-    }
-  }
-  _guardReservedKeys() {
-    walkPrototypeChain.walkPrototypeChain(this, Resource.prototype, (key) => {
-      if (RESERVED_ASYNC_KEYS.includes(key)) {
-        throw new Error(
-          `[mvc-kit] "${key}" is a reserved property on Resource and cannot be overridden.`
-        );
-      }
-    });
-  }
-}
+const require_walkPrototypeChain = require("./walkPrototypeChain.cjs");
+const require_wrapAsyncMethods = require("./wrapAsyncMethods.cjs");
+const require_Collection = require("./Collection.cjs");
+//#region src/Resource.ts
+var __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+var DEFAULT_TASK_STATE = Object.freeze({
+	loading: false,
+	error: null,
+	errorCode: null
+});
+var RESERVED_ASYNC_KEYS = ["async", "subscribeAsync"];
+var LIFECYCLE_HOOKS = new Set(["onInit", "onDispose"]);
+/**
+* Collection + async tracking toolkit. Extends Collection with lifecycle
+* (init/dispose) and automatic async method tracking. Optionally delegates
+* to an external Collection for shared data scenarios.
+*/
+var Resource = class Resource extends require_Collection.Collection {
+	_external = null;
+	_initialized = false;
+	_asyncStates = /* @__PURE__ */ new Map();
+	_asyncSnapshots = /* @__PURE__ */ new Map();
+	_asyncListeners = /* @__PURE__ */ new Set();
+	_asyncProxy = null;
+	_activeOps = null;
+	/** DEV-only timeout (ms) for detecting ghost async operations after dispose. */
+	static GHOST_TIMEOUT = 3e3;
+	constructor(collectionOrItems) {
+		const isExternal = collectionOrItems != null && !Array.isArray(collectionOrItems);
+		super(isExternal ? [] : collectionOrItems ?? []);
+		if (isExternal) {
+			this._external = collectionOrItems;
+			if (__DEV__) {
+				const Ctor = this.constructor;
+				if (Ctor.MAX_SIZE > 0 || Ctor.TTL > 0) console.warn(`[mvc-kit] Resource "${Ctor.name}" has MAX_SIZE or TTL set but uses an injected Collection. Configure these on the Collection instead.`);
+			}
+		}
+		this._guardReservedKeys();
+	}
+	/** Whether init() has been called. */
+	get initialized() {
+		return this._initialized;
+	}
+	/** Initializes the instance. Called automatically by React hooks after mount. */
+	init() {
+		if (this._initialized || this.disposed) return;
+		this._initialized = true;
+		if (__DEV__) this._activeOps = /* @__PURE__ */ new Map();
+		require_wrapAsyncMethods.wrapAsyncMethods({
+			instance: this,
+			stopPrototype: Resource.prototype,
+			reservedKeys: RESERVED_ASYNC_KEYS,
+			lifecycleHooks: LIFECYCLE_HOOKS,
+			isDisposed: () => this.disposed,
+			isInitialized: () => this._initialized,
+			asyncStates: this._asyncStates,
+			asyncSnapshots: this._asyncSnapshots,
+			asyncListeners: this._asyncListeners,
+			notifyAsync: () => this._notifyAsync(),
+			addCleanup: (fn) => this.addCleanup(fn),
+			ghostTimeout: this.constructor.GHOST_TIMEOUT,
+			className: "Resource",
+			activeOps: this._activeOps
+		});
+		return this.onInit?.();
+	}
+	/** Current items array. Delegates to external Collection when injected. */
+	get state() {
+		return this._external ? this._external.state : super.state;
+	}
+	/** The raw array of items. Delegates to external Collection when injected. */
+	get items() {
+		return this._external ? this._external.items : super.items;
+	}
+	/** Number of items. Delegates to external Collection when injected. */
+	get length() {
+		return this._external ? this._external.length : super.length;
+	}
+	add(...items) {
+		this._external ? this._external.add(...items) : super.add(...items);
+	}
+	upsert(...items) {
+		this._external ? this._external.upsert(...items) : super.upsert(...items);
+	}
+	update(id, changes) {
+		this._external ? this._external.update(id, changes) : super.update(id, changes);
+	}
+	remove(...ids) {
+		this._external ? this._external.remove(...ids) : super.remove(...ids);
+	}
+	reset(items) {
+		this._external ? this._external.reset(items) : super.reset(items);
+	}
+	clear() {
+		this._external ? this._external.clear() : super.clear();
+	}
+	optimistic(callback) {
+		return this._external ? this._external.optimistic(callback) : super.optimistic(callback);
+	}
+	get(id) {
+		return this._external ? this._external.get(id) : super.get(id);
+	}
+	has(id) {
+		return this._external ? this._external.has(id) : super.has(id);
+	}
+	find(predicate) {
+		return this._external ? this._external.find(predicate) : super.find(predicate);
+	}
+	filter(predicate) {
+		return this._external ? this._external.filter(predicate) : super.filter(predicate);
+	}
+	sorted(compareFn) {
+		return this._external ? this._external.sorted(compareFn) : super.sorted(compareFn);
+	}
+	map(fn) {
+		return this._external ? this._external.map(fn) : super.map(fn);
+	}
+	subscribe(listener) {
+		if (this.disposed) return () => {};
+		return this._external ? this._external.subscribe(listener) : super.subscribe(listener);
+	}
+	/** Proxy providing `TaskState` (loading, error, errorCode) per async method. */
+	get async() {
+		if (!this._asyncProxy) {
+			const self = this;
+			this._asyncProxy = new Proxy({}, {
+				get(_, prop) {
+					return self._asyncSnapshots.get(prop) ?? DEFAULT_TASK_STATE;
+				},
+				has(_, prop) {
+					return self._asyncSnapshots.has(prop);
+				},
+				ownKeys() {
+					return Array.from(self._asyncSnapshots.keys());
+				},
+				getOwnPropertyDescriptor(_, prop) {
+					if (self._asyncSnapshots.has(prop)) return {
+						configurable: true,
+						enumerable: true,
+						value: self._asyncSnapshots.get(prop)
+					};
+				}
+			});
+		}
+		return this._asyncProxy;
+	}
+	/** Subscribes to async state changes. Used by `useInstance` for React integration. */
+	subscribeAsync(listener) {
+		if (this.disposed) return () => {};
+		this._asyncListeners.add(listener);
+		return () => {
+			this._asyncListeners.delete(listener);
+		};
+	}
+	_notifyAsync() {
+		for (const listener of this._asyncListeners) listener();
+	}
+	_guardReservedKeys() {
+		require_walkPrototypeChain.walkPrototypeChain(this, Resource.prototype, (key) => {
+			if (RESERVED_ASYNC_KEYS.includes(key)) throw new Error(`[mvc-kit] "${key}" is a reserved property on Resource and cannot be overridden.`);
+		});
+	}
+};
+//#endregion
 exports.Resource = Resource;
-//# sourceMappingURL=Resource.cjs.map
+
+//# sourceMappingURL=Resource.cjs.map

package/dist/Resource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.cjs","sources":["../src/Resource.ts"],"sourcesContent":["import { Collection } from './Collection';\nimport { walkPrototypeChain } from './walkPrototypeChain';\nimport { wrapAsyncMethods } from './wrapAsyncMethods';\nimport type { InternalTaskState } from './wrapAsyncMethods';\nimport type { Listener, TaskState } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Async tracking types ────────────────────────────────────────\n\nconst DEFAULT_TASK_STATE: TaskState = Object.freeze({ loading: false, error: null, errorCode: null });\n\nexport type ResourceAsyncMethodKeys<T> = {\n  [K in Exclude<keyof T, keyof Resource<any>>]: T[K] extends (...args: any[]) => Promise<any> ? K : never;\n}[Exclude<keyof T, keyof Resource<any>>];\n\ntype ResourceAsyncMap<T> = {\n  readonly [K in ResourceAsyncMethodKeys<T>]: TaskState;\n};\n\nconst RESERVED_ASYNC_KEYS = ['async', 'subscribeAsync'] as const;\nconst LIFECYCLE_HOOKS = new Set(['onInit', 'onDispose']);\n\n// ── Resource ────────────────────────────────────────────────────\n\n/**\n * Collection + async tracking toolkit. Extends Collection with lifecycle\n * (init/dispose) and automatic async method tracking. Optionally delegates\n * to an external Collection for shared data scenarios.\n */\nexport class Resource<T extends { id: string | number }> extends Collection<T> {\n  private _external: Collection<T> | null = null;\n  private _initialized = false;\n\n  // ── Async tracking fields ──\n  private _asyncStates = new Map<string, InternalTaskState>();\n  private _asyncSnapshots = new Map<string, TaskState>();\n  private _asyncListeners = new Set<() => void>();\n  private _asyncProxy: ResourceAsyncMap<this> | null = null;\n  private _activeOps: Map<string, number> | null = null;\n\n  /** DEV-only timeout (ms) for detecting ghost async operations after dispose. */\n  static GHOST_TIMEOUT = 3000;\n\n  constructor(collectionOrItems?: Collection<T> | T[]) {\n    const isExternal = collectionOrItems != null && !Array.isArray(collectionOrItems);\n    super(isExternal ? [] : (collectionOrItems as T[]) ?? []);\n\n    if (isExternal) {\n      this._external = collectionOrItems as Collection<T>;\n\n      if (__DEV__) {\n        const Ctor = this.constructor as typeof Resource;\n        if (Ctor.MAX_SIZE > 0 || Ctor.TTL > 0) {\n          console.warn(\n            `[mvc-kit] Resource \"${Ctor.name}\" has MAX_SIZE or TTL set but uses an ` +\n            `injected Collection. Configure these on the Collection instead.`\n          );\n        }\n      }\n    }\n\n    this._guardReservedKeys();\n  }\n\n  // ── Lifecycle ─────────────────────────────────────────────────\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this.disposed) return;\n    this._initialized = true;\n\n    if (__DEV__) {\n      this._activeOps = new Map();\n    }\n\n    wrapAsyncMethods({\n      instance: this,\n      stopPrototype: Resource.prototype,\n      reservedKeys: RESERVED_ASYNC_KEYS,\n      lifecycleHooks: LIFECYCLE_HOOKS,\n      isDisposed: () => this.disposed,\n      isInitialized: () => this._initialized,\n      asyncStates: this._asyncStates,\n      asyncSnapshots: this._asyncSnapshots,\n      asyncListeners: this._asyncListeners,\n      notifyAsync: () => this._notifyAsync(),\n      addCleanup: (fn) => this.addCleanup(fn),\n      ghostTimeout: (this.constructor as typeof Resource).GHOST_TIMEOUT,\n      className: 'Resource',\n      activeOps: this._activeOps,\n    });\n\n    return this.onInit?.();\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n\n  // ── Collection delegation ─────────────────────────────────────\n\n  /** Current items array. Delegates to external Collection when injected. */\n  get state(): T[] {\n    return this._external ? this._external.state : super.state;\n  }\n\n  /** The raw array of items. Delegates to external Collection when injected. */\n  get items(): T[] {\n    return this._external ? this._external.items : super.items;\n  }\n\n  /** Number of items. Delegates to external Collection when injected. */\n  get length(): number {\n    return this._external ? this._external.length : super.length;\n  }\n\n  add(...items: T[]): void {\n    this._external ? this._external.add(...items) : super.add(...items);\n  }\n\n  upsert(...items: T[]): void {\n    this._external ? this._external.upsert(...items) : super.upsert(...items);\n  }\n\n  update(id: T['id'], changes: Partial<T>): void {\n    this._external ? this._external.update(id, changes) : super.update(id, changes);\n  }\n\n  remove(...ids: T['id'][]): void {\n    this._external ? this._external.remove(...ids) : super.remove(...ids);\n  }\n\n  reset(items: T[]): void {\n    this._external ? this._external.reset(items) : super.reset(items);\n  }\n\n  clear(): void {\n    this._external ? this._external.clear() : super.clear();\n  }\n\n  optimistic(callback: () => void): () => void {\n    return this._external ? this._external.optimistic(callback) : super.optimistic(callback);\n  }\n\n  get(id: T['id']): T | undefined {\n    return this._external ? this._external.get(id) : super.get(id);\n  }\n\n  has(id: T['id']): boolean {\n    return this._external ? this._external.has(id) : super.has(id);\n  }\n\n  find(predicate: (item: T) => boolean): T | undefined {\n    return this._external ? this._external.find(predicate) : super.find(predicate);\n  }\n\n  filter(predicate: (item: T) => boolean): T[] {\n    return this._external ? this._external.filter(predicate) : super.filter(predicate);\n  }\n\n  sorted(compareFn: (a: T, b: T) => number): T[] {\n    return this._external ? this._external.sorted(compareFn) : super.sorted(compareFn);\n  }\n\n  map<U>(fn: (item: T) => U): U[] {\n    return this._external ? this._external.map(fn) : super.map(fn);\n  }\n\n  subscribe(listener: Listener<T[]>): () => void {\n    if (this.disposed) return () => {};\n    return this._external ? this._external.subscribe(listener) : super.subscribe(listener);\n  }\n\n  // ── Async tracking API ────────────────────────────────────────\n\n  /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */\n  get async(): ResourceAsyncMap<this> {\n    if (!this._asyncProxy) {\n      const self = this;\n      this._asyncProxy = new Proxy({} as ResourceAsyncMap<this>, {\n        get(_, prop: string) {\n          return self._asyncSnapshots.get(prop) ?? DEFAULT_TASK_STATE;\n        },\n        has(_, prop: string) {\n          return self._asyncSnapshots.has(prop);\n        },\n        ownKeys() {\n          return Array.from(self._asyncSnapshots.keys());\n        },\n        getOwnPropertyDescriptor(_, prop: string) {\n          if (self._asyncSnapshots.has(prop)) {\n            return { configurable: true, enumerable: true, value: self._asyncSnapshots.get(prop) };\n          }\n          return undefined;\n        },\n      });\n    }\n    return this._asyncProxy;\n  }\n\n  /** Subscribes to async state changes. Used by `useInstance` for React integration. */\n  subscribeAsync(listener: () => void): () => void {\n    if (this.disposed) return () => {};\n    this._asyncListeners.add(listener);\n    return () => { this._asyncListeners.delete(listener); };\n  }\n\n  // ── Private: async tracking internals ─────────────────────────\n\n  private _notifyAsync(): void {\n    for (const listener of this._asyncListeners) {\n      listener();\n    }\n  }\n\n  private _guardReservedKeys(): void {\n    walkPrototypeChain(this, Resource.prototype, (key) => {\n      if (RESERVED_ASYNC_KEYS.includes(key as any)) {\n        throw new Error(\n          `[mvc-kit] \"${key}\" is a reserved property on Resource and cannot be overridden.`\n        );\n      }\n    });\n  }\n\n}\n"],"names":["Collection","wrapAsyncMethods","walkPrototypeChain"],"mappings":"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"}
+{"version":3,"file":"Resource.cjs","names":[],"sources":["../src/Resource.ts"],"sourcesContent":["import { Collection } from './Collection';\nimport { walkPrototypeChain } from './walkPrototypeChain';\nimport { wrapAsyncMethods } from './wrapAsyncMethods';\nimport type { InternalTaskState } from './wrapAsyncMethods';\nimport type { Listener, TaskState } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Async tracking types ────────────────────────────────────────\n\nconst DEFAULT_TASK_STATE: TaskState = Object.freeze({ loading: false, error: null, errorCode: null });\n\nexport type ResourceAsyncMethodKeys<T> = {\n  [K in Exclude<keyof T, keyof Resource<any>>]: T[K] extends (...args: any[]) => Promise<any> ? K : never;\n}[Exclude<keyof T, keyof Resource<any>>];\n\ntype ResourceAsyncMap<T> = {\n  readonly [K in ResourceAsyncMethodKeys<T>]: TaskState;\n};\n\nconst RESERVED_ASYNC_KEYS = ['async', 'subscribeAsync'] as const;\nconst LIFECYCLE_HOOKS = new Set(['onInit', 'onDispose']);\n\n// ── Resource ────────────────────────────────────────────────────\n\n/**\n * Collection + async tracking toolkit. Extends Collection with lifecycle\n * (init/dispose) and automatic async method tracking. Optionally delegates\n * to an external Collection for shared data scenarios.\n */\nexport class Resource<T extends { id: string | number }> extends Collection<T> {\n  private _external: Collection<T> | null = null;\n  private _initialized = false;\n\n  // ── Async tracking fields ──\n  private _asyncStates = new Map<string, InternalTaskState>();\n  private _asyncSnapshots = new Map<string, TaskState>();\n  private _asyncListeners = new Set<() => void>();\n  private _asyncProxy: ResourceAsyncMap<this> | null = null;\n  private _activeOps: Map<string, number> | null = null;\n\n  /** DEV-only timeout (ms) for detecting ghost async operations after dispose. */\n  static GHOST_TIMEOUT = 3000;\n\n  constructor(collectionOrItems?: Collection<T> | T[]) {\n    const isExternal = collectionOrItems != null && !Array.isArray(collectionOrItems);\n    super(isExternal ? [] : (collectionOrItems as T[]) ?? []);\n\n    if (isExternal) {\n      this._external = collectionOrItems as Collection<T>;\n\n      if (__DEV__) {\n        const Ctor = this.constructor as typeof Resource;\n        if (Ctor.MAX_SIZE > 0 || Ctor.TTL > 0) {\n          console.warn(\n            `[mvc-kit] Resource \"${Ctor.name}\" has MAX_SIZE or TTL set but uses an ` +\n            `injected Collection. Configure these on the Collection instead.`\n          );\n        }\n      }\n    }\n\n    this._guardReservedKeys();\n  }\n\n  // ── Lifecycle ─────────────────────────────────────────────────\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this.disposed) return;\n    this._initialized = true;\n\n    if (__DEV__) {\n      this._activeOps = new Map();\n    }\n\n    wrapAsyncMethods({\n      instance: this,\n      stopPrototype: Resource.prototype,\n      reservedKeys: RESERVED_ASYNC_KEYS,\n      lifecycleHooks: LIFECYCLE_HOOKS,\n      isDisposed: () => this.disposed,\n      isInitialized: () => this._initialized,\n      asyncStates: this._asyncStates,\n      asyncSnapshots: this._asyncSnapshots,\n      asyncListeners: this._asyncListeners,\n      notifyAsync: () => this._notifyAsync(),\n      addCleanup: (fn) => this.addCleanup(fn),\n      ghostTimeout: (this.constructor as typeof Resource).GHOST_TIMEOUT,\n      className: 'Resource',\n      activeOps: this._activeOps,\n    });\n\n    return this.onInit?.();\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n\n  // ── Collection delegation ─────────────────────────────────────\n\n  /** Current items array. Delegates to external Collection when injected. */\n  get state(): T[] {\n    return this._external ? this._external.state : super.state;\n  }\n\n  /** The raw array of items. Delegates to external Collection when injected. */\n  get items(): T[] {\n    return this._external ? this._external.items : super.items;\n  }\n\n  /** Number of items. Delegates to external Collection when injected. */\n  get length(): number {\n    return this._external ? this._external.length : super.length;\n  }\n\n  add(...items: T[]): void {\n    this._external ? this._external.add(...items) : super.add(...items);\n  }\n\n  upsert(...items: T[]): void {\n    this._external ? this._external.upsert(...items) : super.upsert(...items);\n  }\n\n  update(id: T['id'], changes: Partial<T>): void {\n    this._external ? this._external.update(id, changes) : super.update(id, changes);\n  }\n\n  remove(...ids: T['id'][]): void {\n    this._external ? this._external.remove(...ids) : super.remove(...ids);\n  }\n\n  reset(items: T[]): void {\n    this._external ? this._external.reset(items) : super.reset(items);\n  }\n\n  clear(): void {\n    this._external ? this._external.clear() : super.clear();\n  }\n\n  optimistic(callback: () => void): () => void {\n    return this._external ? this._external.optimistic(callback) : super.optimistic(callback);\n  }\n\n  get(id: T['id']): T | undefined {\n    return this._external ? this._external.get(id) : super.get(id);\n  }\n\n  has(id: T['id']): boolean {\n    return this._external ? this._external.has(id) : super.has(id);\n  }\n\n  find(predicate: (item: T) => boolean): T | undefined {\n    return this._external ? this._external.find(predicate) : super.find(predicate);\n  }\n\n  filter(predicate: (item: T) => boolean): T[] {\n    return this._external ? this._external.filter(predicate) : super.filter(predicate);\n  }\n\n  sorted(compareFn: (a: T, b: T) => number): T[] {\n    return this._external ? this._external.sorted(compareFn) : super.sorted(compareFn);\n  }\n\n  map<U>(fn: (item: T) => U): U[] {\n    return this._external ? this._external.map(fn) : super.map(fn);\n  }\n\n  subscribe(listener: Listener<T[]>): () => void {\n    if (this.disposed) return () => {};\n    return this._external ? this._external.subscribe(listener) : super.subscribe(listener);\n  }\n\n  // ── Async tracking API ────────────────────────────────────────\n\n  /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */\n  get async(): ResourceAsyncMap<this> {\n    if (!this._asyncProxy) {\n      const self = this;\n      this._asyncProxy = new Proxy({} as ResourceAsyncMap<this>, {\n        get(_, prop: string) {\n          return self._asyncSnapshots.get(prop) ?? DEFAULT_TASK_STATE;\n        },\n        has(_, prop: string) {\n          return self._asyncSnapshots.has(prop);\n        },\n        ownKeys() {\n          return Array.from(self._asyncSnapshots.keys());\n        },\n        getOwnPropertyDescriptor(_, prop: string) {\n          if (self._asyncSnapshots.has(prop)) {\n            return { configurable: true, enumerable: true, value: self._asyncSnapshots.get(prop) };\n          }\n          return undefined;\n        },\n      });\n    }\n    return this._asyncProxy;\n  }\n\n  /** Subscribes to async state changes. Used by `useInstance` for React integration. */\n  subscribeAsync(listener: () => void): () => void {\n    if (this.disposed) return () => {};\n    this._asyncListeners.add(listener);\n    return () => { this._asyncListeners.delete(listener); };\n  }\n\n  // ── Private: async tracking internals ─────────────────────────\n\n  private _notifyAsync(): void {\n    for (const listener of this._asyncListeners) {\n      listener();\n    }\n  }\n\n  private _guardReservedKeys(): void {\n    walkPrototypeChain(this, Resource.prototype, (key) => {\n      if (RESERVED_ASYNC_KEYS.includes(key as any)) {\n        throw new Error(\n          `[mvc-kit] \"${key}\" is a reserved property on Resource and cannot be overridden.`\n        );\n      }\n    });\n  }\n\n}\n"],"mappings":"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"}