mvc-kit 2.7.1 → 2.9.0

package/dist/web/idb.js.map

@@ -1 +1 @@
-{"version":3,"file":"idb.js","sources":["../../src/web/idb.ts"],"sourcesContent":["/**\n * Shared IndexedDB connection manager.\n * Deduplicates indexedDB.open() calls and handles dynamic object store creation\n * by bumping the DB version when a new storageKey is encountered.\n */\n\nconst _connections = new Map<string, IDBDatabase>();\nconst _stores = new Map<string, Set<string>>(); // dbName → known store names\nlet _openQueue: Promise<void> = Promise.resolve(); // Sequential open queue\n\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n  // If we already have a connection with the required store, reuse it\n  const existing = _connections.get(dbName);\n  if (existing) {\n    if (existing.objectStoreNames.contains(storeName)) {\n      return Promise.resolve(existing);\n    }\n    // Need to add a new store — close and reopen with bumped version\n    existing.close();\n    _connections.delete(dbName);\n  }\n\n  // Track known stores\n  let stores = _stores.get(dbName);\n  if (!stores) {\n    stores = new Set();\n    _stores.set(dbName, stores);\n  }\n  stores.add(storeName);\n\n  // Serialize opens to prevent version conflicts\n  const result = _openQueue.then(() => doOpen(dbName, stores!));\n  _openQueue = result.then(() => {}, () => {}); // Absorb errors for the queue\n  return result;\n}\n\nfunction doOpen(dbName: string, stores: Set<string>): Promise<IDBDatabase> {\n  // Close existing cached connection if any (may have been opened by queued op)\n  const existingDb = _connections.get(dbName);\n  existingDb?.close();\n  _connections.delete(dbName);\n\n  // Probe current DB version (version-less open never triggers upgrade)\n  return new Promise<IDBDatabase>((resolve, reject) => {\n    const probe = indexedDB.open(dbName);\n    probe.onsuccess = () => {\n      const db = probe.result;\n      const version = db.version;\n\n      // Check if all required stores already exist\n      let needsUpgrade = false;\n      for (const name of stores) {\n        if (!db.objectStoreNames.contains(name)) {\n          needsUpgrade = true;\n          break;\n        }\n      }\n\n      if (!needsUpgrade) {\n        _connections.set(dbName, db);\n        resolve(db);\n        return;\n      }\n\n      // Need new stores — close and reopen with bumped version\n      db.close();\n      const upgrade = indexedDB.open(dbName, version + 1);\n      upgrade.onupgradeneeded = () => {\n        const udb = upgrade.result;\n        for (const name of stores) {\n          if (!udb.objectStoreNames.contains(name)) {\n            udb.createObjectStore(name, { keyPath: 'id' });\n          }\n        }\n      };\n      upgrade.onsuccess = () => {\n        _connections.set(dbName, upgrade.result);\n        resolve(upgrade.result);\n      };\n      upgrade.onerror = () => reject(upgrade.error);\n    };\n    probe.onerror = () => reject(probe.error);\n  });\n}\n\nexport function getStore(\n  dbName: string,\n  storeName: string,\n  mode: IDBTransactionMode,\n): Promise<IDBObjectStore> {\n  return openDB(dbName, storeName).then((db) => {\n    const tx = db.transaction(storeName, mode);\n    return tx.objectStore(storeName);\n  });\n}\n\nexport function idbGetAll<T>(store: IDBObjectStore): Promise<T[]> {\n  return new Promise((resolve, reject) => {\n    const request = store.getAll();\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nexport function idbGet<T>(store: IDBObjectStore, id: IDBValidKey): Promise<T | null> {\n  return new Promise((resolve, reject) => {\n    const request = store.get(id);\n    request.onsuccess = () => resolve(request.result ?? null);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nexport function idbPut<T>(store: IDBObjectStore, items: T[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const item of items) {\n      store.put(item);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\nexport function idbDelete(store: IDBObjectStore, ids: IDBValidKey[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const id of ids) {\n      store.delete(id);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\nexport function idbClear(store: IDBObjectStore): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    store.clear();\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\n/** Close all cached connections and delete all known databases. Used in test cleanup. */\nexport function closeAllConnections(): void {\n  for (const db of _connections.values()) {\n    db.close();\n  }\n  _connections.clear();\n  _stores.clear();\n  _openQueue = Promise.resolve();\n}\n\n/** Delete a database by name. Returns a promise that resolves when deleted. */\nexport function deleteDatabase(dbName: string): Promise<void> {\n  const existing = _connections.get(dbName);\n  existing?.close();\n  _connections.delete(dbName);\n  _stores.delete(dbName);\n\n  return new Promise((resolve, reject) => {\n    const request = indexedDB.deleteDatabase(dbName);\n    request.onsuccess = () => resolve();\n    request.onerror = () => reject(request.error);\n  });\n}\n"],"names":[],"mappings":"AAMA,MAAM,mCAAmB,IAAA;AACzB,MAAM,8BAAc,IAAA;AACpB,IAAI,aAA4B,QAAQ,QAAA;AAExC,SAAS,OAAO,QAAgB,WAAyC;AAEvE,QAAM,WAAW,aAAa,IAAI,MAAM;AACxC,MAAI,UAAU;AACZ,QAAI,SAAS,iBAAiB,SAAS,SAAS,GAAG;AACjD,aAAO,QAAQ,QAAQ,QAAQ;AAAA,IACjC;AAEA,aAAS,MAAA;AACT,iBAAa,OAAO,MAAM;AAAA,EAC5B;AAGA,MAAI,SAAS,QAAQ,IAAI,MAAM;AAC/B,MAAI,CAAC,QAAQ;AACX,iCAAa,IAAA;AACb,YAAQ,IAAI,QAAQ,MAAM;AAAA,EAC5B;AACA,SAAO,IAAI,SAAS;AAGpB,QAAM,SAAS,WAAW,KAAK,MAAM,OAAO,QAAQ,MAAO,CAAC;AAC5D,eAAa,OAAO,KAAK,MAAM;AAAA,EAAC,GAAG,MAAM;AAAA,EAAC,CAAC;AAC3C,SAAO;AACT;AAEA,SAAS,OAAO,QAAgB,QAA2C;AAEzE,QAAM,aAAa,aAAa,IAAI,MAAM;AAC1C,cAAY,MAAA;AACZ,eAAa,OAAO,MAAM;AAG1B,SAAO,IAAI,QAAqB,CAAC,SAAS,WAAW;AACnD,UAAM,QAAQ,UAAU,KAAK,MAAM;AACnC,UAAM,YAAY,MAAM;AACtB,YAAM,KAAK,MAAM;AACjB,YAAM,UAAU,GAAG;AAGnB,UAAI,eAAe;AACnB,iBAAW,QAAQ,QAAQ;AACzB,YAAI,CAAC,GAAG,iBAAiB,SAAS,IAAI,GAAG;AACvC,yBAAe;AACf;AAAA,QACF;AAAA,MACF;AAEA,UAAI,CAAC,cAAc;AACjB,qBAAa,IAAI,QAAQ,EAAE;AAC3B,gBAAQ,EAAE;AACV;AAAA,MACF;AAGA,SAAG,MAAA;AACH,YAAM,UAAU,UAAU,KAAK,QAAQ,UAAU,CAAC;AAClD,cAAQ,kBAAkB,MAAM;AAC9B,cAAM,MAAM,QAAQ;AACpB,mBAAW,QAAQ,QAAQ;AACzB,cAAI,CAAC,IAAI,iBAAiB,SAAS,IAAI,GAAG;AACxC,gBAAI,kBAAkB,MAAM,EAAE,SAAS,MAAM;AAAA,UAC/C;AAAA,QACF;AAAA,MACF;AACA,cAAQ,YAAY,MAAM;AACxB,qBAAa,IAAI,QAAQ,QAAQ,MAAM;AACvC,gBAAQ,QAAQ,MAAM;AAAA,MACxB;AACA,cAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,IAC9C;AACA,UAAM,UAAU,MAAM,OAAO,MAAM,KAAK;AAAA,EAC1C,CAAC;AACH;AAEO,SAAS,SACd,QACA,WACA,MACyB;AACzB,SAAO,OAAO,QAAQ,SAAS,EAAE,KAAK,CAAC,OAAO;AAC5C,UAAM,KAAK,GAAG,YAAY,WAAW,IAAI;AACzC,WAAO,GAAG,YAAY,SAAS;AAAA,EACjC,CAAC;AACH;AAEO,SAAS,UAAa,OAAqC;AAChE,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,UAAU,MAAM,OAAA;AACtB,YAAQ,YAAY,MAAM,QAAQ,QAAQ,MAAM;AAChD,YAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,EAC9C,CAAC;AACH;AAEO,SAAS,OAAU,OAAuB,IAAoC;AACnF,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,UAAU,MAAM,IAAI,EAAE;AAC5B,YAAQ,YAAY,MAAM,QAAQ,QAAQ,UAAU,IAAI;AACxD,YAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,EAC9C,CAAC;AACH;AAEO,SAAS,OAAU,OAAuB,OAA2B;AAC1E,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,KAAK,MAAM;AACjB,eAAW,QAAQ,OAAO;AACxB,YAAM,IAAI,IAAI;AAAA,IAChB;AACA,OAAG,aAAa,MAAM,QAAA;AACtB,OAAG,UAAU,MAAM,OAAO,GAAG,KAAK;AAAA,EACpC,CAAC;AACH;AAEO,SAAS,UAAU,OAAuB,KAAmC;AAClF,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,KAAK,MAAM;AACjB,eAAW,MAAM,KAAK;AACpB,YAAM,OAAO,EAAE;AAAA,IACjB;AACA,OAAG,aAAa,MAAM,QAAA;AACtB,OAAG,UAAU,MAAM,OAAO,GAAG,KAAK;AAAA,EACpC,CAAC;AACH;AAEO,SAAS,SAAS,OAAsC;AAC7D,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,KAAK,MAAM;AACjB,UAAM,MAAA;AACN,OAAG,aAAa,MAAM,QAAA;AACtB,OAAG,UAAU,MAAM,OAAO,GAAG,KAAK;AAAA,EACpC,CAAC;AACH;"}
+{"version":3,"file":"idb.js","sources":["../../src/web/idb.ts"],"sourcesContent":["/**\n * Shared IndexedDB connection manager.\n * Deduplicates indexedDB.open() calls and handles dynamic object store creation\n * by bumping the DB version when a new storageKey is encountered.\n */\n\nconst _connections = new Map<string, IDBDatabase>();\nconst _stores = new Map<string, Set<string>>(); // dbName → known store names\nlet _openQueue: Promise<void> = Promise.resolve(); // Sequential open queue\n\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n  // If we already have a connection with the required store, reuse it\n  const existing = _connections.get(dbName);\n  if (existing) {\n    if (existing.objectStoreNames.contains(storeName)) {\n      return Promise.resolve(existing);\n    }\n    // Need to add a new store — close and reopen with bumped version\n    existing.close();\n    _connections.delete(dbName);\n  }\n\n  // Track known stores\n  let stores = _stores.get(dbName);\n  if (!stores) {\n    stores = new Set();\n    _stores.set(dbName, stores);\n  }\n  stores.add(storeName);\n\n  // Serialize opens to prevent version conflicts\n  const result = _openQueue.then(() => doOpen(dbName, stores!));\n  _openQueue = result.then(() => {}, () => {}); // Absorb errors for the queue\n  return result;\n}\n\nfunction doOpen(dbName: string, stores: Set<string>): Promise<IDBDatabase> {\n  // Close existing cached connection if any (may have been opened by queued op)\n  const existingDb = _connections.get(dbName);\n  existingDb?.close();\n  _connections.delete(dbName);\n\n  // Probe current DB version (version-less open never triggers upgrade)\n  return new Promise<IDBDatabase>((resolve, reject) => {\n    const probe = indexedDB.open(dbName);\n    probe.onsuccess = () => {\n      const db = probe.result;\n      const version = db.version;\n\n      // Check if all required stores already exist\n      let needsUpgrade = false;\n      for (const name of stores) {\n        if (!db.objectStoreNames.contains(name)) {\n          needsUpgrade = true;\n          break;\n        }\n      }\n\n      if (!needsUpgrade) {\n        _connections.set(dbName, db);\n        resolve(db);\n        return;\n      }\n\n      // Need new stores — close and reopen with bumped version\n      db.close();\n      const upgrade = indexedDB.open(dbName, version + 1);\n      upgrade.onupgradeneeded = () => {\n        const udb = upgrade.result;\n        for (const name of stores) {\n          if (!udb.objectStoreNames.contains(name)) {\n            udb.createObjectStore(name, { keyPath: 'id' });\n          }\n        }\n      };\n      upgrade.onsuccess = () => {\n        _connections.set(dbName, upgrade.result);\n        resolve(upgrade.result);\n      };\n      upgrade.onerror = () => reject(upgrade.error);\n    };\n    probe.onerror = () => reject(probe.error);\n  });\n}\n\n/**\n * Open a transaction and return the object store for the given database and store name.\n */\nexport function getStore(\n  dbName: string,\n  storeName: string,\n  mode: IDBTransactionMode,\n): Promise<IDBObjectStore> {\n  return openDB(dbName, storeName).then((db) => {\n    const tx = db.transaction(storeName, mode);\n    return tx.objectStore(storeName);\n  });\n}\n\n/**\n * Retrieve all items from an IndexedDB object store.\n */\nexport function idbGetAll<T>(store: IDBObjectStore): Promise<T[]> {\n  return new Promise((resolve, reject) => {\n    const request = store.getAll();\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error);\n  });\n}\n\n/**\n * Retrieve a single item by key from an IndexedDB object store.\n */\nexport function idbGet<T>(store: IDBObjectStore, id: IDBValidKey): Promise<T | null> {\n  return new Promise((resolve, reject) => {\n    const request = store.get(id);\n    request.onsuccess = () => resolve(request.result ?? null);\n    request.onerror = () => reject(request.error);\n  });\n}\n\n/**\n * Write (put) multiple items into an IndexedDB object store.\n */\nexport function idbPut<T>(store: IDBObjectStore, items: T[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const item of items) {\n      store.put(item);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\n/**\n * Delete multiple items by key from an IndexedDB object store.\n */\nexport function idbDelete(store: IDBObjectStore, ids: IDBValidKey[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const id of ids) {\n      store.delete(id);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\n/**\n * Clear all items from an IndexedDB object store.\n */\nexport function idbClear(store: IDBObjectStore): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    store.clear();\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\n/** Close all cached connections and delete all known databases. Used in test cleanup. */\nexport function closeAllConnections(): void {\n  for (const db of _connections.values()) {\n    db.close();\n  }\n  _connections.clear();\n  _stores.clear();\n  _openQueue = Promise.resolve();\n}\n\n/** Delete a database by name. Returns a promise that resolves when deleted. */\nexport function deleteDatabase(dbName: string): Promise<void> {\n  const existing = _connections.get(dbName);\n  existing?.close();\n  _connections.delete(dbName);\n  _stores.delete(dbName);\n\n  return new Promise((resolve, reject) => {\n    const request = indexedDB.deleteDatabase(dbName);\n    request.onsuccess = () => resolve();\n    request.onerror = () => reject(request.error);\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/wrapAsyncMethods.cjs

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const errors = require("./errors.cjs");
+const walkPrototypeChain = require("./walkPrototypeChain.cjs");
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+const LOADING_TASK_STATE = Object.freeze({ loading: true, error: null, errorCode: null });
+function wrapAsyncMethods(ctx) {
+  const {
+    instance,
+    stopPrototype,
+    reservedKeys,
+    lifecycleHooks,
+    isDisposed,
+    isInitialized,
+    asyncStates,
+    asyncSnapshots,
+    asyncListeners,
+    notifyAsync,
+    addCleanup,
+    ghostTimeout,
+    className,
+    activeOps
+  } = ctx;
+  if (__DEV__) {
+    for (const key of reservedKeys) {
+      if (Object.getOwnPropertyDescriptor(instance, key)?.value !== void 0) {
+        throw new Error(
+          `[mvc-kit] "${key}" is a reserved property on ${className} and cannot be overridden.`
+        );
+      }
+    }
+  }
+  const methodEntries = ctx.methods ?? (() => {
+    const result = [];
+    const processed = /* @__PURE__ */ new Set();
+    walkPrototypeChain.walkPrototypeChain(instance, stopPrototype, (key, desc) => {
+      if (desc.get || desc.set) return;
+      if (typeof desc.value !== "function") return;
+      if (key.startsWith("_")) return;
+      if (lifecycleHooks.has(key)) return;
+      if (processed.has(key)) return;
+      processed.add(key);
+      result.push({ key, fn: desc.value });
+    });
+    return result;
+  })();
+  const wrappedKeys = [];
+  for (const { key, fn: original } of methodEntries) {
+    let pruned = false;
+    const wrapper = function(...args) {
+      if (isDisposed()) {
+        if (__DEV__) {
+          console.warn(`[mvc-kit] "${key}" called after dispose — ignored.`);
+        }
+        return void 0;
+      }
+      if (__DEV__ && !isInitialized()) {
+        console.warn(
+          `[mvc-kit] "${key}" called before init(). Async tracking is active only after init().`
+        );
+      }
+      let result;
+      try {
+        result = original.apply(instance, args);
+      } catch (e) {
+        throw e;
+      }
+      if (!result || typeof result.then !== "function") {
+        if (!pruned) {
+          pruned = true;
+          asyncStates.delete(key);
+          asyncSnapshots.delete(key);
+          instance[key] = original.bind(instance);
+        }
+        return result;
+      }
+      let internal = asyncStates.get(key);
+      if (!internal) {
+        internal = { loading: false, error: null, errorCode: null, count: 0 };
+        asyncStates.set(key, internal);
+      }
+      internal.count++;
+      internal.loading = true;
+      internal.error = null;
+      internal.errorCode = null;
+      asyncSnapshots.set(key, LOADING_TASK_STATE);
+      notifyAsync();
+      if (__DEV__ && activeOps) {
+        activeOps.set(key, (activeOps.get(key) ?? 0) + 1);
+      }
+      const finalizeOp = (errorMsg, errorCode) => {
+        internal.count--;
+        internal.loading = internal.count > 0;
+        if (errorMsg !== void 0) {
+          internal.error = errorMsg;
+          internal.errorCode = errorCode ?? null;
+        }
+        asyncSnapshots.set(
+          key,
+          Object.freeze({ loading: internal.loading, error: internal.error, errorCode: internal.errorCode })
+        );
+        notifyAsync();
+        if (__DEV__ && activeOps) {
+          const c = (activeOps.get(key) ?? 1) - 1;
+          if (c <= 0) activeOps.delete(key);
+          else activeOps.set(key, c);
+        }
+      };
+      return result.then(
+        (value) => {
+          if (!isDisposed()) finalizeOp();
+          return value;
+        },
+        (error) => {
+          if (errors.isAbortError(error)) {
+            if (!isDisposed()) finalizeOp();
+            return void 0;
+          }
+          if (isDisposed()) return void 0;
+          const classified = errors.classifyError(error);
+          finalizeOp(classified.message, classified.code);
+          throw error;
+        }
+      );
+    };
+    wrappedKeys.push(key);
+    instance[key] = wrapper;
+  }
+  if (wrappedKeys.length > 0) {
+    addCleanup(() => {
+      const opsSnapshot = __DEV__ && activeOps ? new Map(activeOps) : null;
+      for (const k of wrappedKeys) {
+        if (__DEV__) {
+          instance[k] = () => {
+            console.warn(`[mvc-kit] "${k}" called after dispose — ignored.`);
+            return void 0;
+          };
+        } else {
+          instance[k] = () => void 0;
+        }
+      }
+      asyncListeners.clear();
+      asyncStates.clear();
+      asyncSnapshots.clear();
+      if (__DEV__ && opsSnapshot && opsSnapshot.size > 0) {
+        setTimeout(() => {
+          for (const [key, count] of opsSnapshot) {
+            console.warn(
+              `[mvc-kit] Ghost async operation detected: "${key}" had ${count} pending call(s) when the ${className} was disposed. Consider using disposeSignal to cancel in-flight work.`
+            );
+          }
+        }, ghostTimeout);
+      }
+    });
+  }
+  return wrappedKeys;
+}
+exports.wrapAsyncMethods = wrapAsyncMethods;
+//# sourceMappingURL=wrapAsyncMethods.cjs.map

package/dist/wrapAsyncMethods.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapAsyncMethods.cjs","sources":["../src/wrapAsyncMethods.ts"],"sourcesContent":["import { isAbortError, classifyError } from './errors';\nimport { walkPrototypeChain } from './walkPrototypeChain';\nimport type { TaskState } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\nconst LOADING_TASK_STATE: TaskState = Object.freeze({ loading: true, error: null, errorCode: null });\n\n/** @internal Mutable internal async tracking state per method. */\nexport interface InternalTaskState {\n  loading: boolean;\n  error: string | null;\n  errorCode: TaskState['errorCode'];\n  count: number;\n}\n\n/** @internal Configuration for the shared async method wrapping logic. */\nexport interface AsyncTrackingContext {\n  instance: object;\n  stopPrototype: object;\n  reservedKeys: readonly string[];\n  lifecycleHooks: Set<string>;\n  isDisposed: () => boolean;\n  isInitialized: () => boolean;\n  asyncStates: Map<string, InternalTaskState>;\n  asyncSnapshots: Map<string, TaskState>;\n  asyncListeners: Set<() => void>;\n  notifyAsync: () => void;\n  addCleanup: (fn: () => void) => void;\n  ghostTimeout: number;\n  className: string;\n  activeOps: Map<string, number> | null;\n  /** Pre-scanned methods from class metadata cache. When provided, skips prototype walk. */\n  methods?: Array<{ key: string; fn: Function }>;\n}\n\n/**\n * Shared async method wrapping logic used by both ViewModel and Resource.\n * Walks the prototype chain, wraps methods with async tracking, and registers cleanup.\n * Returns the list of wrapped method keys.\n */\nexport function wrapAsyncMethods(ctx: AsyncTrackingContext): string[] {\n  const {\n    instance,\n    stopPrototype,\n    reservedKeys,\n    lifecycleHooks,\n    isDisposed,\n    isInitialized,\n    asyncStates,\n    asyncSnapshots,\n    asyncListeners,\n    notifyAsync,\n    addCleanup,\n    ghostTimeout,\n    className,\n    activeOps,\n  } = ctx;\n\n  // Instance property reserved key check (DEV-only — prototype check in constructor catches most cases)\n  if (__DEV__) {\n    for (const key of reservedKeys) {\n      if (Object.getOwnPropertyDescriptor(instance, key)?.value !== undefined) {\n        throw new Error(\n          `[mvc-kit] \"${key}\" is a reserved property on ${className} and cannot be overridden.`\n        );\n      }\n    }\n  }\n\n  // Use pre-scanned methods from class metadata cache, or walk prototype chain\n  const methodEntries: Array<{ key: string; fn: Function }> = ctx.methods ?? (() => {\n    const result: Array<{ key: string; fn: Function }> = [];\n    const processed = new Set<string>();\n    walkPrototypeChain(instance, stopPrototype, (key, desc) => {\n      if (desc.get || desc.set) return;\n      if (typeof desc.value !== 'function') return;\n      if (key.startsWith('_')) return;\n      if (lifecycleHooks.has(key)) return;\n      if (processed.has(key)) return;\n      processed.add(key);\n      result.push({ key, fn: desc.value });\n    });\n    return result;\n  })();\n\n  const wrappedKeys: string[] = [];\n\n  for (const { key, fn: original } of methodEntries) {\n    let pruned = false;\n\n    const wrapper = function (this: any, ...args: unknown[]) {\n      // Disposed guard\n      if (isDisposed()) {\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__ && !isInitialized()) {\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(instance, 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          asyncStates.delete(key);\n          asyncSnapshots.delete(key);\n          // Replace wrapper with bound original for zero overhead\n          (instance as any)[key] = original.bind(instance);\n        }\n        return result;\n      }\n\n      // ── Async tracking ──────────────────────────────────────\n      let internal = asyncStates.get(key);\n      if (!internal) {\n        internal = { loading: false, error: null, errorCode: null, count: 0 };\n        asyncStates.set(key, internal);\n      }\n\n      internal.count++;\n      internal.loading = true;\n      internal.error = null;\n      internal.errorCode = null;\n      asyncSnapshots.set(key, LOADING_TASK_STATE);\n      notifyAsync();\n\n      if (__DEV__ && activeOps) {\n        activeOps.set(key, (activeOps.get(key) ?? 0) + 1);\n      }\n\n      // Shared bookkeeping: decrement count, snapshot state, update DEV active ops\n      const finalizeOp = (errorMsg?: string | null, errorCode?: TaskState['errorCode']) => {\n        internal!.count--;\n        internal!.loading = internal!.count > 0;\n        if (errorMsg !== undefined) {\n          internal!.error = errorMsg;\n          internal!.errorCode = errorCode ?? null;\n        }\n        asyncSnapshots.set(\n          key,\n          Object.freeze({ loading: internal!.loading, error: internal!.error, errorCode: internal!.errorCode }),\n        );\n        notifyAsync();\n\n        if (__DEV__ && activeOps) {\n          const c = (activeOps.get(key) ?? 1) - 1;\n          if (c <= 0) activeOps.delete(key);\n          else activeOps.set(key, c);\n        }\n      };\n\n      return (result as Promise<unknown>).then(\n        (value) => {\n          if (!isDisposed()) finalizeOp();\n          return value;\n        },\n        (error) => {\n          // AbortError — silently swallow\n          if (isAbortError(error)) {\n            if (!isDisposed()) finalizeOp();\n            return undefined;\n          }\n\n          // Disposed — fizzle silently\n          if (isDisposed()) return undefined;\n\n          const classified = classifyError(error);\n          finalizeOp(classified.message, classified.code);\n\n          // Re-throw to preserve standard Promise rejection\n          throw error;\n        },\n      );\n    };\n\n    wrappedKeys.push(key);\n    (instance as any)[key] = wrapper;\n  }\n\n  // Register cleanup for disposal\n  if (wrappedKeys.length > 0) {\n    addCleanup(() => {\n      // Snapshot active ops for ghost check before clearing\n      const opsSnapshot = __DEV__ && activeOps ? new Map(activeOps) : null;\n\n      // Swap all wrapped methods to no-ops (with DEV warning)\n      for (const k of wrappedKeys) {\n        if (__DEV__) {\n          (instance as any)[k] = () => {\n            console.warn(`[mvc-kit] \"${k}\" called after dispose — ignored.`);\n            return undefined;\n          };\n        } else {\n          (instance as any)[k] = () => undefined;\n        }\n      }\n\n      // Clear async state\n      asyncListeners.clear();\n      asyncStates.clear();\n      asyncSnapshots.clear();\n\n      // DEV: schedule ghost check\n      if (__DEV__ && opsSnapshot && opsSnapshot.size > 0) {\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 ${className} was disposed. ` +\n              `Consider using disposeSignal to cancel in-flight work.`\n            );\n          }\n        }, ghostTimeout);\n      }\n    });\n  }\n\n  return wrappedKeys;\n}\n"],"names":["walkPrototypeChain","isAbortError","classifyError"],"mappings":"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"}

package/dist/wrapAsyncMethods.d.ts

@@ -0,0 +1,37 @@
+import type { TaskState } from './types';
+/** @internal Mutable internal async tracking state per method. */
+export interface InternalTaskState {
+    loading: boolean;
+    error: string | null;
+    errorCode: TaskState['errorCode'];
+    count: number;
+}
+/** @internal Configuration for the shared async method wrapping logic. */
+export interface AsyncTrackingContext {
+    instance: object;
+    stopPrototype: object;
+    reservedKeys: readonly string[];
+    lifecycleHooks: Set<string>;
+    isDisposed: () => boolean;
+    isInitialized: () => boolean;
+    asyncStates: Map<string, InternalTaskState>;
+    asyncSnapshots: Map<string, TaskState>;
+    asyncListeners: Set<() => void>;
+    notifyAsync: () => void;
+    addCleanup: (fn: () => void) => void;
+    ghostTimeout: number;
+    className: string;
+    activeOps: Map<string, number> | null;
+    /** Pre-scanned methods from class metadata cache. When provided, skips prototype walk. */
+    methods?: Array<{
+        key: string;
+        fn: Function;
+    }>;
+}
+/**
+ * Shared async method wrapping logic used by both ViewModel and Resource.
+ * Walks the prototype chain, wraps methods with async tracking, and registers cleanup.
+ * Returns the list of wrapped method keys.
+ */
+export declare function wrapAsyncMethods(ctx: AsyncTrackingContext): string[];
+//# sourceMappingURL=wrapAsyncMethods.d.ts.map

package/dist/wrapAsyncMethods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapAsyncMethods.d.ts","sourceRoot":"","sources":["../src/wrapAsyncMethods.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMzC,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5C,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,cAAc,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACtC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAkMpE"}

package/dist/wrapAsyncMethods.js

@@ -0,0 +1,159 @@
+import { isAbortError, classifyError } from "./errors.js";
+import { walkPrototypeChain } from "./walkPrototypeChain.js";
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+const LOADING_TASK_STATE = Object.freeze({ loading: true, error: null, errorCode: null });
+function wrapAsyncMethods(ctx) {
+  const {
+    instance,
+    stopPrototype,
+    reservedKeys,
+    lifecycleHooks,
+    isDisposed,
+    isInitialized,
+    asyncStates,
+    asyncSnapshots,
+    asyncListeners,
+    notifyAsync,
+    addCleanup,
+    ghostTimeout,
+    className,
+    activeOps
+  } = ctx;
+  if (__DEV__) {
+    for (const key of reservedKeys) {
+      if (Object.getOwnPropertyDescriptor(instance, key)?.value !== void 0) {
+        throw new Error(
+          `[mvc-kit] "${key}" is a reserved property on ${className} and cannot be overridden.`
+        );
+      }
+    }
+  }
+  const methodEntries = ctx.methods ?? (() => {
+    const result = [];
+    const processed = /* @__PURE__ */ new Set();
+    walkPrototypeChain(instance, stopPrototype, (key, desc) => {
+      if (desc.get || desc.set) return;
+      if (typeof desc.value !== "function") return;
+      if (key.startsWith("_")) return;
+      if (lifecycleHooks.has(key)) return;
+      if (processed.has(key)) return;
+      processed.add(key);
+      result.push({ key, fn: desc.value });
+    });
+    return result;
+  })();
+  const wrappedKeys = [];
+  for (const { key, fn: original } of methodEntries) {
+    let pruned = false;
+    const wrapper = function(...args) {
+      if (isDisposed()) {
+        if (__DEV__) {
+          console.warn(`[mvc-kit] "${key}" called after dispose — ignored.`);
+        }
+        return void 0;
+      }
+      if (__DEV__ && !isInitialized()) {
+        console.warn(
+          `[mvc-kit] "${key}" called before init(). Async tracking is active only after init().`
+        );
+      }
+      let result;
+      try {
+        result = original.apply(instance, args);
+      } catch (e) {
+        throw e;
+      }
+      if (!result || typeof result.then !== "function") {
+        if (!pruned) {
+          pruned = true;
+          asyncStates.delete(key);
+          asyncSnapshots.delete(key);
+          instance[key] = original.bind(instance);
+        }
+        return result;
+      }
+      let internal = asyncStates.get(key);
+      if (!internal) {
+        internal = { loading: false, error: null, errorCode: null, count: 0 };
+        asyncStates.set(key, internal);
+      }
+      internal.count++;
+      internal.loading = true;
+      internal.error = null;
+      internal.errorCode = null;
+      asyncSnapshots.set(key, LOADING_TASK_STATE);
+      notifyAsync();
+      if (__DEV__ && activeOps) {
+        activeOps.set(key, (activeOps.get(key) ?? 0) + 1);
+      }
+      const finalizeOp = (errorMsg, errorCode) => {
+        internal.count--;
+        internal.loading = internal.count > 0;
+        if (errorMsg !== void 0) {
+          internal.error = errorMsg;
+          internal.errorCode = errorCode ?? null;
+        }
+        asyncSnapshots.set(
+          key,
+          Object.freeze({ loading: internal.loading, error: internal.error, errorCode: internal.errorCode })
+        );
+        notifyAsync();
+        if (__DEV__ && activeOps) {
+          const c = (activeOps.get(key) ?? 1) - 1;
+          if (c <= 0) activeOps.delete(key);
+          else activeOps.set(key, c);
+        }
+      };
+      return result.then(
+        (value) => {
+          if (!isDisposed()) finalizeOp();
+          return value;
+        },
+        (error) => {
+          if (isAbortError(error)) {
+            if (!isDisposed()) finalizeOp();
+            return void 0;
+          }
+          if (isDisposed()) return void 0;
+          const classified = classifyError(error);
+          finalizeOp(classified.message, classified.code);
+          throw error;
+        }
+      );
+    };
+    wrappedKeys.push(key);
+    instance[key] = wrapper;
+  }
+  if (wrappedKeys.length > 0) {
+    addCleanup(() => {
+      const opsSnapshot = __DEV__ && activeOps ? new Map(activeOps) : null;
+      for (const k of wrappedKeys) {
+        if (__DEV__) {
+          instance[k] = () => {
+            console.warn(`[mvc-kit] "${k}" called after dispose — ignored.`);
+            return void 0;
+          };
+        } else {
+          instance[k] = () => void 0;
+        }
+      }
+      asyncListeners.clear();
+      asyncStates.clear();
+      asyncSnapshots.clear();
+      if (__DEV__ && opsSnapshot && opsSnapshot.size > 0) {
+        setTimeout(() => {
+          for (const [key, count] of opsSnapshot) {
+            console.warn(
+              `[mvc-kit] Ghost async operation detected: "${key}" had ${count} pending call(s) when the ${className} was disposed. Consider using disposeSignal to cancel in-flight work.`
+            );
+          }
+        }, ghostTimeout);
+      }
+    });
+  }
+  return wrappedKeys;
+}
+export {
+  wrapAsyncMethods
+};
+//# sourceMappingURL=wrapAsyncMethods.js.map

package/dist/wrapAsyncMethods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapAsyncMethods.js","sources":["../src/wrapAsyncMethods.ts"],"sourcesContent":["import { isAbortError, classifyError } from './errors';\nimport { walkPrototypeChain } from './walkPrototypeChain';\nimport type { TaskState } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\nconst LOADING_TASK_STATE: TaskState = Object.freeze({ loading: true, error: null, errorCode: null });\n\n/** @internal Mutable internal async tracking state per method. */\nexport interface InternalTaskState {\n  loading: boolean;\n  error: string | null;\n  errorCode: TaskState['errorCode'];\n  count: number;\n}\n\n/** @internal Configuration for the shared async method wrapping logic. */\nexport interface AsyncTrackingContext {\n  instance: object;\n  stopPrototype: object;\n  reservedKeys: readonly string[];\n  lifecycleHooks: Set<string>;\n  isDisposed: () => boolean;\n  isInitialized: () => boolean;\n  asyncStates: Map<string, InternalTaskState>;\n  asyncSnapshots: Map<string, TaskState>;\n  asyncListeners: Set<() => void>;\n  notifyAsync: () => void;\n  addCleanup: (fn: () => void) => void;\n  ghostTimeout: number;\n  className: string;\n  activeOps: Map<string, number> | null;\n  /** Pre-scanned methods from class metadata cache. When provided, skips prototype walk. */\n  methods?: Array<{ key: string; fn: Function }>;\n}\n\n/**\n * Shared async method wrapping logic used by both ViewModel and Resource.\n * Walks the prototype chain, wraps methods with async tracking, and registers cleanup.\n * Returns the list of wrapped method keys.\n */\nexport function wrapAsyncMethods(ctx: AsyncTrackingContext): string[] {\n  const {\n    instance,\n    stopPrototype,\n    reservedKeys,\n    lifecycleHooks,\n    isDisposed,\n    isInitialized,\n    asyncStates,\n    asyncSnapshots,\n    asyncListeners,\n    notifyAsync,\n    addCleanup,\n    ghostTimeout,\n    className,\n    activeOps,\n  } = ctx;\n\n  // Instance property reserved key check (DEV-only — prototype check in constructor catches most cases)\n  if (__DEV__) {\n    for (const key of reservedKeys) {\n      if (Object.getOwnPropertyDescriptor(instance, key)?.value !== undefined) {\n        throw new Error(\n          `[mvc-kit] \"${key}\" is a reserved property on ${className} and cannot be overridden.`\n        );\n      }\n    }\n  }\n\n  // Use pre-scanned methods from class metadata cache, or walk prototype chain\n  const methodEntries: Array<{ key: string; fn: Function }> = ctx.methods ?? (() => {\n    const result: Array<{ key: string; fn: Function }> = [];\n    const processed = new Set<string>();\n    walkPrototypeChain(instance, stopPrototype, (key, desc) => {\n      if (desc.get || desc.set) return;\n      if (typeof desc.value !== 'function') return;\n      if (key.startsWith('_')) return;\n      if (lifecycleHooks.has(key)) return;\n      if (processed.has(key)) return;\n      processed.add(key);\n      result.push({ key, fn: desc.value });\n    });\n    return result;\n  })();\n\n  const wrappedKeys: string[] = [];\n\n  for (const { key, fn: original } of methodEntries) {\n    let pruned = false;\n\n    const wrapper = function (this: any, ...args: unknown[]) {\n      // Disposed guard\n      if (isDisposed()) {\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__ && !isInitialized()) {\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(instance, 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          asyncStates.delete(key);\n          asyncSnapshots.delete(key);\n          // Replace wrapper with bound original for zero overhead\n          (instance as any)[key] = original.bind(instance);\n        }\n        return result;\n      }\n\n      // ── Async tracking ──────────────────────────────────────\n      let internal = asyncStates.get(key);\n      if (!internal) {\n        internal = { loading: false, error: null, errorCode: null, count: 0 };\n        asyncStates.set(key, internal);\n      }\n\n      internal.count++;\n      internal.loading = true;\n      internal.error = null;\n      internal.errorCode = null;\n      asyncSnapshots.set(key, LOADING_TASK_STATE);\n      notifyAsync();\n\n      if (__DEV__ && activeOps) {\n        activeOps.set(key, (activeOps.get(key) ?? 0) + 1);\n      }\n\n      // Shared bookkeeping: decrement count, snapshot state, update DEV active ops\n      const finalizeOp = (errorMsg?: string | null, errorCode?: TaskState['errorCode']) => {\n        internal!.count--;\n        internal!.loading = internal!.count > 0;\n        if (errorMsg !== undefined) {\n          internal!.error = errorMsg;\n          internal!.errorCode = errorCode ?? null;\n        }\n        asyncSnapshots.set(\n          key,\n          Object.freeze({ loading: internal!.loading, error: internal!.error, errorCode: internal!.errorCode }),\n        );\n        notifyAsync();\n\n        if (__DEV__ && activeOps) {\n          const c = (activeOps.get(key) ?? 1) - 1;\n          if (c <= 0) activeOps.delete(key);\n          else activeOps.set(key, c);\n        }\n      };\n\n      return (result as Promise<unknown>).then(\n        (value) => {\n          if (!isDisposed()) finalizeOp();\n          return value;\n        },\n        (error) => {\n          // AbortError — silently swallow\n          if (isAbortError(error)) {\n            if (!isDisposed()) finalizeOp();\n            return undefined;\n          }\n\n          // Disposed — fizzle silently\n          if (isDisposed()) return undefined;\n\n          const classified = classifyError(error);\n          finalizeOp(classified.message, classified.code);\n\n          // Re-throw to preserve standard Promise rejection\n          throw error;\n        },\n      );\n    };\n\n    wrappedKeys.push(key);\n    (instance as any)[key] = wrapper;\n  }\n\n  // Register cleanup for disposal\n  if (wrappedKeys.length > 0) {\n    addCleanup(() => {\n      // Snapshot active ops for ghost check before clearing\n      const opsSnapshot = __DEV__ && activeOps ? new Map(activeOps) : null;\n\n      // Swap all wrapped methods to no-ops (with DEV warning)\n      for (const k of wrappedKeys) {\n        if (__DEV__) {\n          (instance as any)[k] = () => {\n            console.warn(`[mvc-kit] \"${k}\" called after dispose — ignored.`);\n            return undefined;\n          };\n        } else {\n          (instance as any)[k] = () => undefined;\n        }\n      }\n\n      // Clear async state\n      asyncListeners.clear();\n      asyncStates.clear();\n      asyncSnapshots.clear();\n\n      // DEV: schedule ghost check\n      if (__DEV__ && opsSnapshot && opsSnapshot.size > 0) {\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 ${className} was disposed. ` +\n              `Consider using disposeSignal to cancel in-flight work.`\n            );\n          }\n        }, ghostTimeout);\n      }\n    });\n  }\n\n  return wrappedKeys;\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mvc-kit",
-  "version": "2.7.1",
+  "version": "2.9.0",
   "description": "Zero-magic, class-based reactive ViewModel library",
   "type": "module",
   "main": "./dist/mvc-kit.cjs",