mvc-kit 2.7.1 → 2.9.0

package/dist/Resource.cjs

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const Collection = require("./Collection.cjs");
 const walkPrototypeChain = require("./walkPrototypeChain.cjs");
-const errors = require("./errors.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"];
@@ -43,16 +43,37 @@ class Resource extends Collection.Collection {
   init() {
     if (this._initialized || this.disposed) return;
     this._initialized = true;
-    this._wrapMethods();
+    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;
   }
@@ -149,160 +170,6 @@ class Resource extends Collection.Collection {
       }
     });
   }
-  _wrapMethods() {
-    for (const key of RESERVED_ASYNC_KEYS) {
-      if (Object.getOwnPropertyDescriptor(this, key)?.value !== void 0) {
-        throw new Error(
-          `[mvc-kit] "${key}" is a reserved property on Resource and cannot be overridden.`
-        );
-      }
-    }
-    const self = this;
-    const processed = /* @__PURE__ */ new Set();
-    const wrappedKeys = [];
-    if (__DEV__) {
-      this._activeOps = /* @__PURE__ */ new Map();
-    }
-    walkPrototypeChain.walkPrototypeChain(this, Resource.prototype, (key, desc) => {
-      if (desc.get || desc.set) return;
-      if (typeof desc.value !== "function") return;
-      if (key.startsWith("_")) return;
-      if (LIFECYCLE_HOOKS.has(key)) return;
-      if (processed.has(key)) return;
-      processed.add(key);
-      const original = desc.value;
-      let pruned = false;
-      const wrapper = function(...args) {
-        if (self.disposed) {
-          if (__DEV__) {
-            console.warn(`[mvc-kit] "${key}" called after dispose — ignored.`);
-          }
-          return void 0;
-        }
-        if (__DEV__ && !self._initialized) {
-          console.warn(
-            `[mvc-kit] "${key}" called before init(). Async tracking is active only after init().`
-          );
-        }
-        let result;
-        try {
-          result = original.apply(self, args);
-        } catch (e) {
-          throw e;
-        }
-        if (!result || typeof result.then !== "function") {
-          if (!pruned) {
-            pruned = true;
-            self._asyncStates.delete(key);
-            self._asyncSnapshots.delete(key);
-            self[key] = original.bind(self);
-          }
-          return result;
-        }
-        let internal = self._asyncStates.get(key);
-        if (!internal) {
-          internal = { loading: false, error: null, errorCode: null, count: 0 };
-          self._asyncStates.set(key, internal);
-        }
-        internal.count++;
-        internal.loading = true;
-        internal.error = null;
-        internal.errorCode = null;
-        self._asyncSnapshots.set(key, Object.freeze({ loading: true, error: null, errorCode: null }));
-        self._notifyAsync();
-        if (__DEV__ && self._activeOps) {
-          self._activeOps.set(key, (self._activeOps.get(key) ?? 0) + 1);
-        }
-        return result.then(
-          (value) => {
-            if (self.disposed) return value;
-            internal.count--;
-            internal.loading = internal.count > 0;
-            self._asyncSnapshots.set(
-              key,
-              Object.freeze({ loading: internal.loading, error: internal.error, errorCode: internal.errorCode })
-            );
-            self._notifyAsync();
-            if (__DEV__ && self._activeOps) {
-              const c = (self._activeOps.get(key) ?? 1) - 1;
-              if (c <= 0) self._activeOps.delete(key);
-              else self._activeOps.set(key, c);
-            }
-            return value;
-          },
-          (error) => {
-            if (errors.isAbortError(error)) {
-              if (!self.disposed) {
-                internal.count--;
-                internal.loading = internal.count > 0;
-                self._asyncSnapshots.set(
-                  key,
-                  Object.freeze({ loading: internal.loading, error: internal.error, errorCode: internal.errorCode })
-                );
-                self._notifyAsync();
-              }
-              if (__DEV__ && self._activeOps) {
-                const c = (self._activeOps.get(key) ?? 1) - 1;
-                if (c <= 0) self._activeOps.delete(key);
-                else self._activeOps.set(key, c);
-              }
-              return void 0;
-            }
-            if (self.disposed) return void 0;
-            internal.count--;
-            internal.loading = internal.count > 0;
-            const classified = errors.classifyError(error);
-            internal.error = classified.message;
-            internal.errorCode = classified.code;
-            self._asyncSnapshots.set(
-              key,
-              Object.freeze({ loading: internal.loading, error: classified.message, errorCode: classified.code })
-            );
-            self._notifyAsync();
-            if (__DEV__ && self._activeOps) {
-              const c = (self._activeOps.get(key) ?? 1) - 1;
-              if (c <= 0) self._activeOps.delete(key);
-              else self._activeOps.set(key, c);
-            }
-            throw error;
-          }
-        );
-      };
-      wrappedKeys.push(key);
-      self[key] = wrapper;
-    });
-    if (wrappedKeys.length > 0) {
-      this.addCleanup(() => {
-        const opsSnapshot = __DEV__ && self._activeOps ? new Map(self._activeOps) : null;
-        for (const k of wrappedKeys) {
-          if (__DEV__) {
-            self[k] = () => {
-              console.warn(`[mvc-kit] "${k}" called after dispose — ignored.`);
-              return void 0;
-            };
-          } else {
-            self[k] = () => void 0;
-          }
-        }
-        self._asyncListeners.clear();
-        self._asyncStates.clear();
-        self._asyncSnapshots.clear();
-        if (__DEV__ && opsSnapshot && opsSnapshot.size > 0) {
-          self._scheduleGhostCheck(opsSnapshot);
-        }
-      });
-    }
-  }
-  _scheduleGhostCheck(opsSnapshot) {
-    if (!__DEV__) return;
-    setTimeout(() => {
-      for (const [key, count] of opsSnapshot) {
-        console.warn(
-          `[mvc-kit] Ghost async operation detected: "${key}" had ${count} pending call(s) when the Resource was disposed. Consider using disposeSignal to cancel in-flight work.`
-        );
-      }
-    }, this.constructor.GHOST_TIMEOUT);
-  }
 }
 exports.Resource = Resource;
 //# 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 { isAbortError, classifyError } from './errors';\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\ninterface InternalTaskState {\n  loading: boolean;\n  error: string | null;\n  errorCode: TaskState['errorCode'];\n  count: number;\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    this._wrapMethods();\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  get state(): T[] {\n    return this._external ? this._external.state : super.state;\n  }\n\n  get items(): T[] {\n    return this._external ? this._external.items : super.items;\n  }\n\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  private _wrapMethods(): void {\n    // Instance property check (class fields assigned after super())\n    for (const key of RESERVED_ASYNC_KEYS) {\n      if (Object.getOwnPropertyDescriptor(this, key)?.value !== undefined) {\n        throw new Error(\n          `[mvc-kit] \"${key}\" is a reserved property on Resource and cannot be overridden.`\n        );\n      }\n    }\n\n    const self = this;\n    const processed = new Set<string>();\n    const wrappedKeys: string[] = [];\n\n    if (__DEV__) {\n      this._activeOps = new Map();\n    }\n\n    walkPrototypeChain(this, Resource.prototype, (key, desc) => {\n      // Skip getters/setters\n      if (desc.get || desc.set) return;\n      // Skip non-functions\n      if (typeof desc.value !== 'function') return;\n      // Skip _-prefixed (private convention)\n      if (key.startsWith('_')) return;\n      // Skip lifecycle hooks (managed by framework)\n      if (LIFECYCLE_HOOKS.has(key)) return;\n      // Most-derived wins\n      if (processed.has(key)) return;\n      processed.add(key);\n\n      const original = desc.value as (...args: unknown[]) => unknown;\n      let pruned = false;\n\n      const wrapper = function (this: any, ...args: unknown[]) {\n        // Disposed guard\n        if (self.disposed) {\n          if (__DEV__) {\n            console.warn(`[mvc-kit] \"${key}\" called after dispose — ignored.`);\n          }\n          return undefined;\n        }\n\n        // Pre-init guard (DEV only — method still executes)\n        if (__DEV__ && !self._initialized) {\n          console.warn(\n            `[mvc-kit] \"${key}\" called before init(). ` +\n            `Async tracking is active only after init().`\n          );\n        }\n\n        let result: unknown;\n        try {\n          result = original.apply(self, args);\n        } catch (e) {\n          // Sync throw — not tracked as async\n          throw e;\n        }\n\n        // Sync detection: if not thenable, prune from async tracking\n        if (!result || typeof (result as any).then !== 'function') {\n          if (!pruned) {\n            pruned = true;\n            // Remove from async maps\n            self._asyncStates.delete(key);\n            self._asyncSnapshots.delete(key);\n            // Replace wrapper with bound original for zero overhead\n            (self as any)[key] = original.bind(self);\n          }\n          return result;\n        }\n\n        // ── Async tracking ──────────────────────────────────────\n        let internal = self._asyncStates.get(key);\n        if (!internal) {\n          internal = { loading: false, error: null, errorCode: null, count: 0 };\n          self._asyncStates.set(key, internal);\n        }\n\n        internal.count++;\n        internal.loading = true;\n        internal.error = null;\n        internal.errorCode = null;\n        self._asyncSnapshots.set(key, Object.freeze({ loading: true, error: null, errorCode: null }));\n        self._notifyAsync();\n\n        if (__DEV__ && self._activeOps) {\n          self._activeOps.set(key, (self._activeOps.get(key) ?? 0) + 1);\n        }\n\n        return (result as Promise<unknown>).then(\n          (value) => {\n            if (self.disposed) return value;\n\n            internal!.count--;\n            internal!.loading = internal!.count > 0;\n            self._asyncSnapshots.set(\n              key,\n              Object.freeze({ loading: internal!.loading, error: internal!.error, errorCode: internal!.errorCode }),\n            );\n            self._notifyAsync();\n\n            if (__DEV__ && self._activeOps) {\n              const c = (self._activeOps.get(key) ?? 1) - 1;\n              if (c <= 0) self._activeOps.delete(key);\n              else self._activeOps.set(key, c);\n            }\n\n            return value;\n          },\n          (error) => {\n            // AbortError — silently swallow\n            if (isAbortError(error)) {\n              if (!self.disposed) {\n                internal!.count--;\n                internal!.loading = internal!.count > 0;\n                self._asyncSnapshots.set(\n                  key,\n                  Object.freeze({ loading: internal!.loading, error: internal!.error, errorCode: internal!.errorCode }),\n                );\n                self._notifyAsync();\n              }\n\n              if (__DEV__ && self._activeOps) {\n                const c = (self._activeOps.get(key) ?? 1) - 1;\n                if (c <= 0) self._activeOps.delete(key);\n                else self._activeOps.set(key, c);\n              }\n\n              return undefined;\n            }\n\n            // Disposed — fizzle silently\n            if (self.disposed) return undefined;\n\n            internal!.count--;\n            internal!.loading = internal!.count > 0;\n            const classified = classifyError(error);\n            internal!.error = classified.message;\n            internal!.errorCode = classified.code;\n            self._asyncSnapshots.set(\n              key,\n              Object.freeze({ loading: internal!.loading, error: classified.message, errorCode: classified.code }),\n            );\n            self._notifyAsync();\n\n            if (__DEV__ && self._activeOps) {\n              const c = (self._activeOps.get(key) ?? 1) - 1;\n              if (c <= 0) self._activeOps.delete(key);\n              else self._activeOps.set(key, c);\n            }\n\n            // Re-throw to preserve standard Promise rejection\n            throw error;\n          },\n        );\n      };\n\n      wrappedKeys.push(key);\n      (self as any)[key] = wrapper;\n    });\n\n    // Register cleanup for disposal\n    if (wrappedKeys.length > 0) {\n      this.addCleanup(() => {\n        // Snapshot active ops for ghost check before clearing\n        const opsSnapshot = __DEV__ && self._activeOps ? new Map(self._activeOps) : null;\n\n        // Swap all wrapped methods to no-ops (with DEV warning)\n        for (const k of wrappedKeys) {\n          if (__DEV__) {\n            (self as any)[k] = () => {\n              console.warn(`[mvc-kit] \"${k}\" called after dispose — ignored.`);\n              return undefined;\n            };\n          } else {\n            (self as any)[k] = () => undefined;\n          }\n        }\n\n        // Clear async state\n        self._asyncListeners.clear();\n        self._asyncStates.clear();\n        self._asyncSnapshots.clear();\n\n        // DEV: schedule ghost check\n        if (__DEV__ && opsSnapshot && opsSnapshot.size > 0) {\n          self._scheduleGhostCheck(opsSnapshot);\n        }\n      });\n    }\n  }\n\n  private _scheduleGhostCheck(opsSnapshot: Map<string, number>): void {\n    if (!__DEV__) return;\n    setTimeout(() => {\n      for (const [key, count] of opsSnapshot) {\n        console.warn(\n          `[mvc-kit] Ghost async operation detected: \"${key}\" had ${count} ` +\n          `pending call(s) when the Resource was disposed. ` +\n          `Consider using disposeSignal to cancel in-flight work.`\n        );\n      }\n    }, (this.constructor as typeof Resource).GHOST_TIMEOUT);\n  }\n}\n"],"names":["Collection","walkPrototypeChain","isAbortError","classifyError"],"mappings":"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"}
+{"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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"}

package/dist/Resource.d.ts

@@ -30,8 +30,11 @@ export declare class Resource<T extends {
     init(): void | Promise<void>;
     /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */
     protected onInit?(): void | Promise<void>;
+    /** Current items array. Delegates to external Collection when injected. */
     get state(): T[];
+    /** The raw array of items. Delegates to external Collection when injected. */
     get items(): T[];
+    /** Number of items. Delegates to external Collection when injected. */
     get length(): number;
     add(...items: T[]): void;
     upsert(...items: T[]): void;
@@ -53,8 +56,6 @@ export declare class Resource<T extends {
     subscribeAsync(listener: () => void): () => void;
     private _notifyAsync;
     private _guardReservedKeys;
-    private _wrapMethods;
-    private _scheduleGhostCheck;
 }
 export {};
 //# sourceMappingURL=Resource.d.ts.map

package/dist/Resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../src/Resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQnD,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI;KACtC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK;CACxG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEzC,KAAK,gBAAgB,CAAC,CAAC,IAAI;IACzB,QAAQ,EAAE,CAAC,IAAI,uBAAuB,CAAC,CAAC,CAAC,GAAG,SAAS;CACtD,CAAC;AAcF;;;;GAIG;AACH,qBAAa,QAAQ,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,UAAU,CAAoC;IAEtD,gFAAgF;IAChF,MAAM,CAAC,aAAa,SAAQ;gBAEhB,iBAAiB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;IAuBnD,sCAAsC;IACtC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,iFAAiF;IACjF,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5B,4FAA4F;IAC5F,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,IAAI,KAAK,IAAI,CAAC,EAAE,CAEf;IAED,IAAI,KAAK,IAAI,CAAC,EAAE,CAEf;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAIxB,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAI3B,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAI9C,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI;IAI/B,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAIvB,KAAK,IAAI,IAAI;IAIb,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI5C,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;IAI/B,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO;IAIzB,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,SAAS;IAIpD,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,EAAE;IAI5C,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,CAAC,EAAE;IAI9C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IAI/B,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI;IAO9C,gFAAgF;IAChF,IAAI,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAsBlC;IAED,sFAAsF;IACtF,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQhD,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,YAAY;IAiMpB,OAAO,CAAC,mBAAmB;CAY5B"}
+{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../src/Resource.ts"],"names":[],"mappings":"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"}

package/dist/Resource.js

@@ -1,6 +1,6 @@
 import { Collection } from "./Collection.js";
 import { walkPrototypeChain } from "./walkPrototypeChain.js";
-import { isAbortError, classifyError } from "./errors.js";
+import { wrapAsyncMethods } from "./wrapAsyncMethods.js";
 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"];
@@ -41,16 +41,37 @@ class Resource extends Collection {
   init() {
     if (this._initialized || this.disposed) return;
     this._initialized = true;
-    this._wrapMethods();
+    if (__DEV__) {
+      this._activeOps = /* @__PURE__ */ new Map();
+    }
+    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;
   }
@@ -147,160 +168,6 @@ class Resource extends Collection {
       }
     });
   }
-  _wrapMethods() {
-    for (const key of RESERVED_ASYNC_KEYS) {
-      if (Object.getOwnPropertyDescriptor(this, key)?.value !== void 0) {
-        throw new Error(
-          `[mvc-kit] "${key}" is a reserved property on Resource and cannot be overridden.`
-        );
-      }
-    }
-    const self = this;
-    const processed = /* @__PURE__ */ new Set();
-    const wrappedKeys = [];
-    if (__DEV__) {
-      this._activeOps = /* @__PURE__ */ new Map();
-    }
-    walkPrototypeChain(this, Resource.prototype, (key, desc) => {
-      if (desc.get || desc.set) return;
-      if (typeof desc.value !== "function") return;
-      if (key.startsWith("_")) return;
-      if (LIFECYCLE_HOOKS.has(key)) return;
-      if (processed.has(key)) return;
-      processed.add(key);
-      const original = desc.value;
-      let pruned = false;
-      const wrapper = function(...args) {
-        if (self.disposed) {
-          if (__DEV__) {
-            console.warn(`[mvc-kit] "${key}" called after dispose — ignored.`);
-          }
-          return void 0;
-        }
-        if (__DEV__ && !self._initialized) {
-          console.warn(
-            `[mvc-kit] "${key}" called before init(). Async tracking is active only after init().`
-          );
-        }
-        let result;
-        try {
-          result = original.apply(self, args);
-        } catch (e) {
-          throw e;
-        }
-        if (!result || typeof result.then !== "function") {
-          if (!pruned) {
-            pruned = true;
-            self._asyncStates.delete(key);
-            self._asyncSnapshots.delete(key);
-            self[key] = original.bind(self);
-          }
-          return result;
-        }
-        let internal = self._asyncStates.get(key);
-        if (!internal) {
-          internal = { loading: false, error: null, errorCode: null, count: 0 };
-          self._asyncStates.set(key, internal);
-        }
-        internal.count++;
-        internal.loading = true;
-        internal.error = null;
-        internal.errorCode = null;
-        self._asyncSnapshots.set(key, Object.freeze({ loading: true, error: null, errorCode: null }));
-        self._notifyAsync();
-        if (__DEV__ && self._activeOps) {
-          self._activeOps.set(key, (self._activeOps.get(key) ?? 0) + 1);
-        }
-        return result.then(
-          (value) => {
-            if (self.disposed) return value;
-            internal.count--;
-            internal.loading = internal.count > 0;
-            self._asyncSnapshots.set(
-              key,
-              Object.freeze({ loading: internal.loading, error: internal.error, errorCode: internal.errorCode })
-            );
-            self._notifyAsync();
-            if (__DEV__ && self._activeOps) {
-              const c = (self._activeOps.get(key) ?? 1) - 1;
-              if (c <= 0) self._activeOps.delete(key);
-              else self._activeOps.set(key, c);
-            }
-            return value;
-          },
-          (error) => {
-            if (isAbortError(error)) {
-              if (!self.disposed) {
-                internal.count--;
-                internal.loading = internal.count > 0;
-                self._asyncSnapshots.set(
-                  key,
-                  Object.freeze({ loading: internal.loading, error: internal.error, errorCode: internal.errorCode })
-                );
-                self._notifyAsync();
-              }
-              if (__DEV__ && self._activeOps) {
-                const c = (self._activeOps.get(key) ?? 1) - 1;
-                if (c <= 0) self._activeOps.delete(key);
-                else self._activeOps.set(key, c);
-              }
-              return void 0;
-            }
-            if (self.disposed) return void 0;
-            internal.count--;
-            internal.loading = internal.count > 0;
-            const classified = classifyError(error);
-            internal.error = classified.message;
-            internal.errorCode = classified.code;
-            self._asyncSnapshots.set(
-              key,
-              Object.freeze({ loading: internal.loading, error: classified.message, errorCode: classified.code })
-            );
-            self._notifyAsync();
-            if (__DEV__ && self._activeOps) {
-              const c = (self._activeOps.get(key) ?? 1) - 1;
-              if (c <= 0) self._activeOps.delete(key);
-              else self._activeOps.set(key, c);
-            }
-            throw error;
-          }
-        );
-      };
-      wrappedKeys.push(key);
-      self[key] = wrapper;
-    });
-    if (wrappedKeys.length > 0) {
-      this.addCleanup(() => {
-        const opsSnapshot = __DEV__ && self._activeOps ? new Map(self._activeOps) : null;
-        for (const k of wrappedKeys) {
-          if (__DEV__) {
-            self[k] = () => {
-              console.warn(`[mvc-kit] "${k}" called after dispose — ignored.`);
-              return void 0;
-            };
-          } else {
-            self[k] = () => void 0;
-          }
-        }
-        self._asyncListeners.clear();
-        self._asyncStates.clear();
-        self._asyncSnapshots.clear();
-        if (__DEV__ && opsSnapshot && opsSnapshot.size > 0) {
-          self._scheduleGhostCheck(opsSnapshot);
-        }
-      });
-    }
-  }
-  _scheduleGhostCheck(opsSnapshot) {
-    if (!__DEV__) return;
-    setTimeout(() => {
-      for (const [key, count] of opsSnapshot) {
-        console.warn(
-          `[mvc-kit] Ghost async operation detected: "${key}" had ${count} pending call(s) when the Resource was disposed. Consider using disposeSignal to cancel in-flight work.`
-        );
-      }
-    }, this.constructor.GHOST_TIMEOUT);
-  }
 }
 export {
   Resource

package/dist/Resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.js","sources":["../src/Resource.ts"],"sourcesContent":["import { Collection } from './Collection';\nimport { walkPrototypeChain } from './walkPrototypeChain';\nimport { isAbortError, classifyError } from './errors';\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\ninterface InternalTaskState {\n  loading: boolean;\n  error: string | null;\n  errorCode: TaskState['errorCode'];\n  count: number;\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    this._wrapMethods();\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  get state(): T[] {\n    return this._external ? this._external.state : super.state;\n  }\n\n  get items(): T[] {\n    return this._external ? this._external.items : super.items;\n  }\n\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  private _wrapMethods(): void {\n    // Instance property check (class fields assigned after super())\n    for (const key of RESERVED_ASYNC_KEYS) {\n      if (Object.getOwnPropertyDescriptor(this, key)?.value !== undefined) {\n        throw new Error(\n          `[mvc-kit] \"${key}\" is a reserved property on Resource and cannot be overridden.`\n        );\n      }\n    }\n\n    const self = this;\n    const processed = new Set<string>();\n    const wrappedKeys: string[] = [];\n\n    if (__DEV__) {\n      this._activeOps = new Map();\n    }\n\n    walkPrototypeChain(this, Resource.prototype, (key, desc) => {\n      // Skip getters/setters\n      if (desc.get || desc.set) return;\n      // Skip non-functions\n      if (typeof desc.value !== 'function') return;\n      // Skip _-prefixed (private convention)\n      if (key.startsWith('_')) return;\n      // Skip lifecycle hooks (managed by framework)\n      if (LIFECYCLE_HOOKS.has(key)) return;\n      // Most-derived wins\n      if (processed.has(key)) return;\n      processed.add(key);\n\n      const original = desc.value as (...args: unknown[]) => unknown;\n      let pruned = false;\n\n      const wrapper = function (this: any, ...args: unknown[]) {\n        // Disposed guard\n        if (self.disposed) {\n          if (__DEV__) {\n            console.warn(`[mvc-kit] \"${key}\" called after dispose — ignored.`);\n          }\n          return undefined;\n        }\n\n        // Pre-init guard (DEV only — method still executes)\n        if (__DEV__ && !self._initialized) {\n          console.warn(\n            `[mvc-kit] \"${key}\" called before init(). ` +\n            `Async tracking is active only after init().`\n          );\n        }\n\n        let result: unknown;\n        try {\n          result = original.apply(self, args);\n        } catch (e) {\n          // Sync throw — not tracked as async\n          throw e;\n        }\n\n        // Sync detection: if not thenable, prune from async tracking\n        if (!result || typeof (result as any).then !== 'function') {\n          if (!pruned) {\n            pruned = true;\n            // Remove from async maps\n            self._asyncStates.delete(key);\n            self._asyncSnapshots.delete(key);\n            // Replace wrapper with bound original for zero overhead\n            (self as any)[key] = original.bind(self);\n          }\n          return result;\n        }\n\n        // ── Async tracking ──────────────────────────────────────\n        let internal = self._asyncStates.get(key);\n        if (!internal) {\n          internal = { loading: false, error: null, errorCode: null, count: 0 };\n          self._asyncStates.set(key, internal);\n        }\n\n        internal.count++;\n        internal.loading = true;\n        internal.error = null;\n        internal.errorCode = null;\n        self._asyncSnapshots.set(key, Object.freeze({ loading: true, error: null, errorCode: null }));\n        self._notifyAsync();\n\n        if (__DEV__ && self._activeOps) {\n          self._activeOps.set(key, (self._activeOps.get(key) ?? 0) + 1);\n        }\n\n        return (result as Promise<unknown>).then(\n          (value) => {\n            if (self.disposed) return value;\n\n            internal!.count--;\n            internal!.loading = internal!.count > 0;\n            self._asyncSnapshots.set(\n              key,\n              Object.freeze({ loading: internal!.loading, error: internal!.error, errorCode: internal!.errorCode }),\n            );\n            self._notifyAsync();\n\n            if (__DEV__ && self._activeOps) {\n              const c = (self._activeOps.get(key) ?? 1) - 1;\n              if (c <= 0) self._activeOps.delete(key);\n              else self._activeOps.set(key, c);\n            }\n\n            return value;\n          },\n          (error) => {\n            // AbortError — silently swallow\n            if (isAbortError(error)) {\n              if (!self.disposed) {\n                internal!.count--;\n                internal!.loading = internal!.count > 0;\n                self._asyncSnapshots.set(\n                  key,\n                  Object.freeze({ loading: internal!.loading, error: internal!.error, errorCode: internal!.errorCode }),\n                );\n                self._notifyAsync();\n              }\n\n              if (__DEV__ && self._activeOps) {\n                const c = (self._activeOps.get(key) ?? 1) - 1;\n                if (c <= 0) self._activeOps.delete(key);\n                else self._activeOps.set(key, c);\n              }\n\n              return undefined;\n            }\n\n            // Disposed — fizzle silently\n            if (self.disposed) return undefined;\n\n            internal!.count--;\n            internal!.loading = internal!.count > 0;\n            const classified = classifyError(error);\n            internal!.error = classified.message;\n            internal!.errorCode = classified.code;\n            self._asyncSnapshots.set(\n              key,\n              Object.freeze({ loading: internal!.loading, error: classified.message, errorCode: classified.code }),\n            );\n            self._notifyAsync();\n\n            if (__DEV__ && self._activeOps) {\n              const c = (self._activeOps.get(key) ?? 1) - 1;\n              if (c <= 0) self._activeOps.delete(key);\n              else self._activeOps.set(key, c);\n            }\n\n            // Re-throw to preserve standard Promise rejection\n            throw error;\n          },\n        );\n      };\n\n      wrappedKeys.push(key);\n      (self as any)[key] = wrapper;\n    });\n\n    // Register cleanup for disposal\n    if (wrappedKeys.length > 0) {\n      this.addCleanup(() => {\n        // Snapshot active ops for ghost check before clearing\n        const opsSnapshot = __DEV__ && self._activeOps ? new Map(self._activeOps) : null;\n\n        // Swap all wrapped methods to no-ops (with DEV warning)\n        for (const k of wrappedKeys) {\n          if (__DEV__) {\n            (self as any)[k] = () => {\n              console.warn(`[mvc-kit] \"${k}\" called after dispose — ignored.`);\n              return undefined;\n            };\n          } else {\n            (self as any)[k] = () => undefined;\n          }\n        }\n\n        // Clear async state\n        self._asyncListeners.clear();\n        self._asyncStates.clear();\n        self._asyncSnapshots.clear();\n\n        // DEV: schedule ghost check\n        if (__DEV__ && opsSnapshot && opsSnapshot.size > 0) {\n          self._scheduleGhostCheck(opsSnapshot);\n        }\n      });\n    }\n  }\n\n  private _scheduleGhostCheck(opsSnapshot: Map<string, number>): void {\n    if (!__DEV__) return;\n    setTimeout(() => {\n      for (const [key, count] of opsSnapshot) {\n        console.warn(\n          `[mvc-kit] Ghost async operation detected: \"${key}\" had ${count} ` +\n          `pending call(s) when the Resource was disposed. ` +\n          `Consider using disposeSignal to cancel in-flight work.`\n        );\n      }\n    }, (this.constructor as typeof Resource).GHOST_TIMEOUT);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Resource.js","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":[],"mappings":"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"}