mvc-kit 2.12.4 → 2.13.0

package/dist/Pending.js

@@ -1,288 +1,256 @@
 import { classifyError, isAbortError } from "./errors.js";
 import { Trackable } from "./Trackable.js";
-const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
-class Pending extends Trackable {
-  // ── Static config (Channel pattern — override via subclass) ──
-  /** Maximum number of retry attempts before marking as failed. */
-  static MAX_RETRIES = 5;
-  /** Base delay (ms) for retry backoff. */
-  static RETRY_BASE = 1e3;
-  /** Maximum delay cap (ms) for retry backoff. */
-  static RETRY_MAX = 3e4;
-  /** Exponential backoff multiplier for retry delay. */
-  static RETRY_FACTOR = 2;
-  // ── Private state ──
-  _operations = /* @__PURE__ */ new Map();
-  _snapshots = /* @__PURE__ */ new Map();
-  _entriesCache = null;
-  constructor() {
-    super();
-  }
-  // ── Readable state (reactive — auto-tracked by ViewModel getters) ──
-  /** Get the frozen status snapshot for an operation by ID, or null if not found. */
-  getStatus(id) {
-    return this._snapshots.get(id) ?? null;
-  }
-  /** Whether an operation exists for the given ID. */
-  has(id) {
-    return this._operations.has(id);
-  }
-  /** Number of operations (all statuses). */
-  get count() {
-    return this._operations.size;
-  }
-  /** Whether any operations are in-flight (active or retrying). */
-  get hasPending() {
-    for (const op of this._operations.values()) {
-      if (op.status !== "failed") return true;
-    }
-    return false;
-  }
-  /** Whether any operations are in a failed state. */
-  get hasFailed() {
-    for (const op of this._operations.values()) {
-      if (op.status === "failed") return true;
-    }
-    return false;
-  }
-  /** Number of operations in a failed state. */
-  get failedCount() {
-    let n = 0;
-    for (const op of this._operations.values()) {
-      if (op.status === "failed") n++;
-    }
-    return n;
-  }
-  /** All operations as a frozen array of entries (id + snapshot). Cached until next mutation. */
-  get entries() {
-    if (this._entriesCache === null) {
-      const result = [];
-      for (const [id, snapshot] of this._snapshots) {
-        result.push(Object.freeze({ ...snapshot, id }));
-      }
-      this._entriesCache = Object.freeze(result);
-    }
-    return this._entriesCache;
-  }
-  // ── Core API ──
-  /**
-   * Enqueue an operation for the given ID. Fire-and-forget (synchronous return).
-   * If the same ID already has a pending operation, it is superseded (aborted).
-   */
-  enqueue(id, operation, execute, meta) {
-    if (this.disposed) {
-      if (__DEV__) {
-        console.warn("[mvc-kit] Pending.enqueue() called after dispose — ignored.");
-      }
-      return;
-    }
-    const existing = this._operations.get(id);
-    if (existing) {
-      existing.abortController.abort();
-      if (existing.retryTimer !== null) {
-        clearTimeout(existing.retryTimer);
-      }
-    }
-    const op = {
-      id,
-      operation,
-      execute,
-      status: "active",
-      attempts: 0,
-      error: null,
-      errorCode: null,
-      nextRetryAt: null,
-      createdAt: Date.now(),
-      abortController: new AbortController(),
-      retryTimer: null,
-      meta: meta ?? null
-    };
-    this._operations.set(id, op);
-    this._snapshot(op);
-    this.notify();
-    queueMicrotask(() => this._process(id));
-  }
-  // ── Controls ──
-  /** Retry a failed operation. No-op if the operation is not in 'failed' status. */
-  retry(id) {
-    if (this.disposed) {
-      if (__DEV__) {
-        console.warn("[mvc-kit] Pending.retry() called after dispose — ignored.");
-      }
-      return;
-    }
-    const op = this._operations.get(id);
-    if (!op || op.status !== "failed") return;
-    op.attempts = 0;
-    op.error = null;
-    op.errorCode = null;
-    op.nextRetryAt = null;
-    op.abortController = new AbortController();
-    this._process(id);
-  }
-  /** Retry all failed operations. */
-  retryAll() {
-    if (this.disposed) {
-      if (__DEV__) {
-        console.warn("[mvc-kit] Pending.retryAll() called after dispose — ignored.");
-      }
-      return;
-    }
-    const failedIds = [];
-    for (const op of this._operations.values()) {
-      if (op.status === "failed") failedIds.push(op.id);
-    }
-    for (const id of failedIds) {
-      this.retry(id);
-    }
-  }
-  /** Cancel an in-flight operation by ID. Aborts the signal, clears timers, and removes it. */
-  cancel(id) {
-    const op = this._operations.get(id);
-    if (!op) return;
-    op.abortController.abort();
-    if (op.retryTimer !== null) {
-      clearTimeout(op.retryTimer);
-    }
-    this._operations.delete(id);
-    this._snapshots.delete(id);
-    this.notify();
-  }
-  /** Cancel all operations. */
-  cancelAll() {
-    for (const op of this._operations.values()) {
-      op.abortController.abort();
-      if (op.retryTimer !== null) {
-        clearTimeout(op.retryTimer);
-      }
-    }
-    this._operations.clear();
-    this._snapshots.clear();
-    this.notify();
-  }
-  /** Remove a failed operation without retrying. No-op if the operation is not in 'failed' status. */
-  dismiss(id) {
-    const op = this._operations.get(id);
-    if (!op || op.status !== "failed") return;
-    this._operations.delete(id);
-    this._snapshots.delete(id);
-    this.notify();
-  }
-  /** Remove all failed operations without retrying. */
-  dismissAll() {
-    const failedIds = [];
-    for (const op of this._operations.values()) {
-      if (op.status === "failed") failedIds.push(op.id);
-    }
-    if (failedIds.length === 0) return;
-    for (const id of failedIds) {
-      this._operations.delete(id);
-      this._snapshots.delete(id);
-    }
-    this.notify();
-  }
-  // ── Hooks (overridable in subclass) ──
-  /**
-   * Determines whether an error is retryable. Override in a subclass to customize.
-   * Default: retries on network, timeout, and server_error codes.
-   * @protected
-   */
-  isRetryable(error) {
-    const code = classifyError(error).code;
-    return code === "network" || code === "timeout" || code === "server_error";
-  }
-  // ── Lifecycle ──
-  /** Dispose: cancels all operations, then runs Trackable cleanup. */
-  dispose() {
-    if (this.disposed) return;
-    this.cancelAll();
-    super.dispose();
-  }
-  // ── Notification override ──
-  /** @internal Invalidates entries cache before notifying subscribers. */
-  notify() {
-    this._entriesCache = null;
-    super.notify();
-  }
-  // ── Internals ──
-  _snapshot(op) {
-    const ctor = this.constructor;
-    this._snapshots.set(op.id, Object.freeze({
-      status: op.status,
-      operation: op.operation,
-      attempts: op.attempts,
-      maxRetries: ctor.MAX_RETRIES,
-      error: op.error,
-      errorCode: op.errorCode,
-      nextRetryAt: op.nextRetryAt,
-      createdAt: op.createdAt,
-      meta: op.meta
-    }));
-  }
-  _process(id) {
-    const op = this._operations.get(id);
-    if (!op || this.disposed) return;
-    op.status = "active";
-    op.attempts++;
-    op.error = null;
-    op.errorCode = null;
-    op.nextRetryAt = null;
-    this._snapshot(op);
-    this.notify();
-    op.execute(op.abortController.signal).then(
-      () => {
-        if (this._operations.get(id) !== op) return;
-        const operation = op.operation;
-        this._operations.delete(id);
-        this._snapshots.delete(id);
-        this.notify();
-        this.onConfirmed?.(id, operation);
-      },
-      (error) => {
-        if (this._operations.get(id) !== op) return;
-        if (isAbortError(error)) {
-          this._operations.delete(id);
-          this._snapshots.delete(id);
-          this.notify();
-          return;
-        }
-        const ctor = this.constructor;
-        const classified = classifyError(error);
-        if (this.isRetryable(error) && op.attempts < ctor.MAX_RETRIES) {
-          op.status = "retrying";
-          const delay = this._calculateDelay(op.attempts - 1);
-          op.nextRetryAt = Date.now() + delay;
-          op.error = classified.message;
-          op.errorCode = classified.code;
-          this._snapshot(op);
-          this.notify();
-          op.retryTimer = setTimeout(() => {
-            op.retryTimer = null;
-            this._process(id);
-          }, delay);
-        } else {
-          op.status = "failed";
-          op.error = classified.message;
-          op.errorCode = classified.code;
-          op.nextRetryAt = null;
-          this._snapshot(op);
-          this.notify();
-          this.onFailed?.(id, op.operation, error);
-        }
-      }
-    );
-  }
-  /** Computes retry backoff delay with jitter (Channel formula). @private */
-  _calculateDelay(attempt) {
-    const ctor = this.constructor;
-    const capped = Math.min(
-      ctor.RETRY_BASE * Math.pow(ctor.RETRY_FACTOR, attempt),
-      ctor.RETRY_MAX
-    );
-    return Math.random() * capped;
-  }
-}
-export {
-  Pending
+//#region src/Pending.ts
+var __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+/**
+* Per-item operation queue with retry and status tracking.
+* Tracks operations by key with exponential backoff retry on transient errors.
+* Subscribable — auto-tracked when used as a ViewModel/Resource property.
+*/
+var Pending = class extends Trackable {
+	/** Maximum number of retry attempts before marking as failed. */
+	static MAX_RETRIES = 5;
+	/** Base delay (ms) for retry backoff. */
+	static RETRY_BASE = 1e3;
+	/** Maximum delay cap (ms) for retry backoff. */
+	static RETRY_MAX = 3e4;
+	/** Exponential backoff multiplier for retry delay. */
+	static RETRY_FACTOR = 2;
+	_operations = /* @__PURE__ */ new Map();
+	_snapshots = /* @__PURE__ */ new Map();
+	_entriesCache = null;
+	constructor() {
+		super();
+	}
+	/** Get the frozen status snapshot for an operation by ID, or null if not found. */
+	getStatus(id) {
+		return this._snapshots.get(id) ?? null;
+	}
+	/** Whether an operation exists for the given ID. */
+	has(id) {
+		return this._operations.has(id);
+	}
+	/** Number of operations (all statuses). */
+	get count() {
+		return this._operations.size;
+	}
+	/** Whether any operations are in-flight (active or retrying). */
+	get hasPending() {
+		for (const op of this._operations.values()) if (op.status !== "failed") return true;
+		return false;
+	}
+	/** Whether any operations are in a failed state. */
+	get hasFailed() {
+		for (const op of this._operations.values()) if (op.status === "failed") return true;
+		return false;
+	}
+	/** Number of operations in a failed state. */
+	get failedCount() {
+		let n = 0;
+		for (const op of this._operations.values()) if (op.status === "failed") n++;
+		return n;
+	}
+	/** All operations as a frozen array of entries (id + snapshot). Cached until next mutation. */
+	get entries() {
+		if (this._entriesCache === null) {
+			const result = [];
+			for (const [id, snapshot] of this._snapshots) result.push(Object.freeze({
+				...snapshot,
+				id
+			}));
+			this._entriesCache = Object.freeze(result);
+		}
+		return this._entriesCache;
+	}
+	/**
+	* Enqueue an operation for the given ID. Fire-and-forget (synchronous return).
+	* If the same ID already has a pending operation, it is superseded (aborted).
+	*/
+	enqueue(id, operation, execute, meta) {
+		if (this.disposed) {
+			if (__DEV__) console.warn("[mvc-kit] Pending.enqueue() called after dispose — ignored.");
+			return;
+		}
+		const existing = this._operations.get(id);
+		if (existing) {
+			existing.abortController.abort();
+			if (existing.retryTimer !== null) clearTimeout(existing.retryTimer);
+		}
+		const op = {
+			id,
+			operation,
+			execute,
+			status: "active",
+			attempts: 0,
+			error: null,
+			errorCode: null,
+			nextRetryAt: null,
+			createdAt: Date.now(),
+			abortController: new AbortController(),
+			retryTimer: null,
+			meta: meta ?? null
+		};
+		this._operations.set(id, op);
+		this._snapshot(op);
+		this.notify();
+		queueMicrotask(() => this._process(id));
+	}
+	/** Retry a failed operation. No-op if the operation is not in 'failed' status. */
+	retry(id) {
+		if (this.disposed) {
+			if (__DEV__) console.warn("[mvc-kit] Pending.retry() called after dispose — ignored.");
+			return;
+		}
+		const op = this._operations.get(id);
+		if (!op || op.status !== "failed") return;
+		op.attempts = 0;
+		op.error = null;
+		op.errorCode = null;
+		op.nextRetryAt = null;
+		op.abortController = new AbortController();
+		this._process(id);
+	}
+	/** Retry all failed operations. */
+	retryAll() {
+		if (this.disposed) {
+			if (__DEV__) console.warn("[mvc-kit] Pending.retryAll() called after dispose — ignored.");
+			return;
+		}
+		const failedIds = [];
+		for (const op of this._operations.values()) if (op.status === "failed") failedIds.push(op.id);
+		for (const id of failedIds) this.retry(id);
+	}
+	/** Cancel an in-flight operation by ID. Aborts the signal, clears timers, and removes it. */
+	cancel(id) {
+		const op = this._operations.get(id);
+		if (!op) return;
+		op.abortController.abort();
+		if (op.retryTimer !== null) clearTimeout(op.retryTimer);
+		this._operations.delete(id);
+		this._snapshots.delete(id);
+		this.notify();
+	}
+	/** Cancel all operations. */
+	cancelAll() {
+		for (const op of this._operations.values()) {
+			op.abortController.abort();
+			if (op.retryTimer !== null) clearTimeout(op.retryTimer);
+		}
+		this._operations.clear();
+		this._snapshots.clear();
+		this.notify();
+	}
+	/** Remove a failed operation without retrying. No-op if the operation is not in 'failed' status. */
+	dismiss(id) {
+		const op = this._operations.get(id);
+		if (!op || op.status !== "failed") return;
+		this._operations.delete(id);
+		this._snapshots.delete(id);
+		this.notify();
+	}
+	/** Remove all failed operations without retrying. */
+	dismissAll() {
+		const failedIds = [];
+		for (const op of this._operations.values()) if (op.status === "failed") failedIds.push(op.id);
+		if (failedIds.length === 0) return;
+		for (const id of failedIds) {
+			this._operations.delete(id);
+			this._snapshots.delete(id);
+		}
+		this.notify();
+	}
+	/**
+	* Determines whether an error is retryable. Override in a subclass to customize.
+	* Default: retries on network, timeout, and server_error codes.
+	* @protected
+	*/
+	isRetryable(error) {
+		const code = classifyError(error).code;
+		return code === "network" || code === "timeout" || code === "server_error";
+	}
+	/** Dispose: cancels all operations, then runs Trackable cleanup. */
+	dispose() {
+		if (this.disposed) return;
+		this.cancelAll();
+		super.dispose();
+	}
+	/** @internal Invalidates entries cache before notifying subscribers. */
+	notify() {
+		this._entriesCache = null;
+		super.notify();
+	}
+	_snapshot(op) {
+		const ctor = this.constructor;
+		this._snapshots.set(op.id, Object.freeze({
+			status: op.status,
+			operation: op.operation,
+			attempts: op.attempts,
+			maxRetries: ctor.MAX_RETRIES,
+			error: op.error,
+			errorCode: op.errorCode,
+			nextRetryAt: op.nextRetryAt,
+			createdAt: op.createdAt,
+			meta: op.meta
+		}));
+	}
+	_process(id) {
+		const op = this._operations.get(id);
+		if (!op || this.disposed) return;
+		op.status = "active";
+		op.attempts++;
+		op.error = null;
+		op.errorCode = null;
+		op.nextRetryAt = null;
+		this._snapshot(op);
+		this.notify();
+		op.execute(op.abortController.signal).then(() => {
+			if (this._operations.get(id) !== op) return;
+			const operation = op.operation;
+			this._operations.delete(id);
+			this._snapshots.delete(id);
+			this.notify();
+			this.onConfirmed?.(id, operation);
+		}, (error) => {
+			if (this._operations.get(id) !== op) return;
+			if (isAbortError(error)) {
+				this._operations.delete(id);
+				this._snapshots.delete(id);
+				this.notify();
+				return;
+			}
+			const ctor = this.constructor;
+			const classified = classifyError(error);
+			if (this.isRetryable(error) && op.attempts < ctor.MAX_RETRIES) {
+				op.status = "retrying";
+				const delay = this._calculateDelay(op.attempts - 1);
+				op.nextRetryAt = Date.now() + delay;
+				op.error = classified.message;
+				op.errorCode = classified.code;
+				this._snapshot(op);
+				this.notify();
+				op.retryTimer = setTimeout(() => {
+					op.retryTimer = null;
+					this._process(id);
+				}, delay);
+			} else {
+				op.status = "failed";
+				op.error = classified.message;
+				op.errorCode = classified.code;
+				op.nextRetryAt = null;
+				this._snapshot(op);
+				this.notify();
+				this.onFailed?.(id, op.operation, error);
+			}
+		});
+	}
+	/** Computes retry backoff delay with jitter (Channel formula). @private */
+	_calculateDelay(attempt) {
+		const ctor = this.constructor;
+		const capped = Math.min(ctor.RETRY_BASE * Math.pow(ctor.RETRY_FACTOR, attempt), ctor.RETRY_MAX);
+		return Math.random() * capped;
+	}
 };
-//# sourceMappingURL=Pending.js.map
+//#endregion
+export { Pending };
+
+//# sourceMappingURL=Pending.js.map

package/dist/Pending.js.map

@@ -1 +1 @@
-{"version":3,"file":"Pending.js","sources":["../src/Pending.ts"],"sourcesContent":["import { classifyError, isAbortError } from './errors';\nimport type { AppError } from './errors';\nimport { Trackable } from './Trackable';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Types ─────────────────────────────────────────────────────────\n\n/** Frozen snapshot of a single pending operation's state. */\nexport interface PendingOperation<Meta = unknown> {\n  readonly status: 'active' | 'retrying' | 'failed';\n  readonly operation: string;\n  readonly attempts: number;\n  readonly maxRetries: number;\n  readonly error: string | null;\n  readonly errorCode: AppError['code'] | null;\n  readonly nextRetryAt: number | null;\n  readonly createdAt: number;\n  readonly meta: Meta | null;\n}\n\n/** A PendingOperation snapshot paired with its key, for iteration. */\nexport interface PendingEntry<K extends string | number, Meta = unknown>\n  extends PendingOperation<Meta> {\n  readonly id: K;\n}\n\n/** Mutable internal state for a pending operation. */\ninterface InternalOp<K, Meta> {\n  id: K;\n  operation: string;\n  execute: (signal: AbortSignal) => Promise<void>;\n  status: PendingOperation['status'];\n  attempts: number;\n  error: string | null;\n  errorCode: AppError['code'] | null;\n  nextRetryAt: number | null;\n  createdAt: number;\n  abortController: AbortController;\n  retryTimer: ReturnType<typeof setTimeout> | null;\n  meta: Meta | null;\n}\n\n// ── Pending ───────────────────────────────────────────────────────\n\n/**\n * Per-item operation queue with retry and status tracking.\n * Tracks operations by key with exponential backoff retry on transient errors.\n * Subscribable — auto-tracked when used as a ViewModel/Resource property.\n */\nexport class Pending<K extends string | number = string | number, Meta = unknown> extends Trackable {\n  // ── Static config (Channel pattern — override via subclass) ──\n\n  /** Maximum number of retry attempts before marking as failed. */\n  static MAX_RETRIES = 5;\n  /** Base delay (ms) for retry backoff. */\n  static RETRY_BASE = 1000;\n  /** Maximum delay cap (ms) for retry backoff. */\n  static RETRY_MAX = 30000;\n  /** Exponential backoff multiplier for retry delay. */\n  static RETRY_FACTOR = 2;\n\n  // ── Private state ──\n\n  private _operations = new Map<K, InternalOp<K, Meta>>();\n  private _snapshots = new Map<K, PendingOperation<Meta>>();\n  private _entriesCache: readonly PendingEntry<K, Meta>[] | null = null;\n\n  constructor() {\n    super();\n  }\n\n  // ── Readable state (reactive — auto-tracked by ViewModel getters) ──\n\n  /** Get the frozen status snapshot for an operation by ID, or null if not found. */\n  getStatus(id: K): PendingOperation<Meta> | null {\n    return this._snapshots.get(id) ?? null;\n  }\n\n  /** Whether an operation exists for the given ID. */\n  has(id: K): boolean {\n    return this._operations.has(id);\n  }\n\n  /** Number of operations (all statuses). */\n  get count(): number {\n    return this._operations.size;\n  }\n\n  /** Whether any operations are in-flight (active or retrying). */\n  get hasPending(): boolean {\n    for (const op of this._operations.values()) {\n      if (op.status !== 'failed') return true;\n    }\n    return false;\n  }\n\n  /** Whether any operations are in a failed state. */\n  get hasFailed(): boolean {\n    for (const op of this._operations.values()) {\n      if (op.status === 'failed') return true;\n    }\n    return false;\n  }\n\n  /** Number of operations in a failed state. */\n  get failedCount(): number {\n    let n = 0;\n    for (const op of this._operations.values()) {\n      if (op.status === 'failed') n++;\n    }\n    return n;\n  }\n\n  /** All operations as a frozen array of entries (id + snapshot). Cached until next mutation. */\n  get entries(): readonly PendingEntry<K, Meta>[] {\n    if (this._entriesCache === null) {\n      const result: PendingEntry<K, Meta>[] = [];\n      for (const [id, snapshot] of this._snapshots) {\n        result.push(Object.freeze({ ...snapshot, id }));\n      }\n      this._entriesCache = Object.freeze(result) as readonly PendingEntry<K, Meta>[];\n    }\n    return this._entriesCache;\n  }\n\n  // ── Core API ──\n\n  /**\n   * Enqueue an operation for the given ID. Fire-and-forget (synchronous return).\n   * If the same ID already has a pending operation, it is superseded (aborted).\n   */\n  enqueue(id: K, operation: string, execute: (signal: AbortSignal) => Promise<void>, meta?: Meta): void {\n    if (this.disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] Pending.enqueue() called after dispose — ignored.');\n      }\n      return;\n    }\n\n    // Supersede existing operation for this ID\n    const existing = this._operations.get(id);\n    if (existing) {\n      existing.abortController.abort();\n      if (existing.retryTimer !== null) {\n        clearTimeout(existing.retryTimer);\n      }\n    }\n\n    const op: InternalOp<K, Meta> = {\n      id,\n      operation,\n      execute,\n      status: 'active',\n      attempts: 0,\n      error: null,\n      errorCode: null,\n      nextRetryAt: null,\n      createdAt: Date.now(),\n      abortController: new AbortController(),\n      retryTimer: null,\n      meta: meta ?? null,\n    };\n\n    this._operations.set(id, op);\n    this._snapshot(op);\n    this.notify();\n\n    // Schedule processing via microtask (allows batching multiple enqueues)\n    queueMicrotask(() => this._process(id));\n  }\n\n  // ── Controls ──\n\n  /** Retry a failed operation. No-op if the operation is not in 'failed' status. */\n  retry(id: K): void {\n    if (this.disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] Pending.retry() called after dispose — ignored.');\n      }\n      return;\n    }\n\n    const op = this._operations.get(id);\n    if (!op || op.status !== 'failed') return;\n\n    op.attempts = 0;\n    op.error = null;\n    op.errorCode = null;\n    op.nextRetryAt = null;\n    op.abortController = new AbortController();\n    this._process(id);\n  }\n\n  /** Retry all failed operations. */\n  retryAll(): void {\n    if (this.disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] Pending.retryAll() called after dispose — ignored.');\n      }\n      return;\n    }\n\n    const failedIds: K[] = [];\n    for (const op of this._operations.values()) {\n      if (op.status === 'failed') failedIds.push(op.id);\n    }\n    for (const id of failedIds) {\n      this.retry(id);\n    }\n  }\n\n  /** Cancel an in-flight operation by ID. Aborts the signal, clears timers, and removes it. */\n  cancel(id: K): void {\n    const op = this._operations.get(id);\n    if (!op) return;\n\n    op.abortController.abort();\n    if (op.retryTimer !== null) {\n      clearTimeout(op.retryTimer);\n    }\n    this._operations.delete(id);\n    this._snapshots.delete(id);\n    this.notify();\n  }\n\n  /** Cancel all operations. */\n  cancelAll(): void {\n    for (const op of this._operations.values()) {\n      op.abortController.abort();\n      if (op.retryTimer !== null) {\n        clearTimeout(op.retryTimer);\n      }\n    }\n    this._operations.clear();\n    this._snapshots.clear();\n    this.notify();\n  }\n\n  /** Remove a failed operation without retrying. No-op if the operation is not in 'failed' status. */\n  dismiss(id: K): void {\n    const op = this._operations.get(id);\n    if (!op || op.status !== 'failed') return;\n\n    this._operations.delete(id);\n    this._snapshots.delete(id);\n    this.notify();\n  }\n\n  /** Remove all failed operations without retrying. */\n  dismissAll(): void {\n    const failedIds: K[] = [];\n    for (const op of this._operations.values()) {\n      if (op.status === 'failed') failedIds.push(op.id);\n    }\n    if (failedIds.length === 0) return;\n    for (const id of failedIds) {\n      this._operations.delete(id);\n      this._snapshots.delete(id);\n    }\n    this.notify();\n  }\n\n  // ── Hooks (overridable in subclass) ──\n\n  /**\n   * Determines whether an error is retryable. Override in a subclass to customize.\n   * Default: retries on network, timeout, and server_error codes.\n   * @protected\n   */\n  protected isRetryable(error: unknown): boolean {\n    const code = classifyError(error).code;\n    return code === 'network' || code === 'timeout' || code === 'server_error';\n  }\n\n  /** Called when an operation succeeds. Override in a subclass for side effects. @protected */\n  protected onConfirmed?(id: K, operation: string): void;\n  /** Called when an operation fails permanently. Override in a subclass for side effects. @protected */\n  protected onFailed?(id: K, operation: string, error: unknown): void;\n\n  // ── Lifecycle ──\n\n  /** Dispose: cancels all operations, then runs Trackable cleanup. */\n  dispose(): void {\n    if (this.disposed) return;\n    this.cancelAll();\n    super.dispose();\n  }\n\n  // ── Notification override ──\n\n  /** @internal Invalidates entries cache before notifying subscribers. */\n  protected notify(): void {\n    this._entriesCache = null;\n    super.notify();\n  }\n\n  // ── Internals ──\n\n  private _snapshot(op: InternalOp<K, Meta>): void {\n    const ctor = this.constructor as typeof Pending;\n    this._snapshots.set(op.id, Object.freeze({\n      status: op.status,\n      operation: op.operation,\n      attempts: op.attempts,\n      maxRetries: ctor.MAX_RETRIES,\n      error: op.error,\n      errorCode: op.errorCode,\n      nextRetryAt: op.nextRetryAt,\n      createdAt: op.createdAt,\n      meta: op.meta,\n    }));\n  }\n\n  private _process(id: K): void {\n    const op = this._operations.get(id);\n    if (!op || this.disposed) return;\n\n    // Set active status\n    op.status = 'active';\n    op.attempts++;\n    op.error = null;\n    op.errorCode = null;\n    op.nextRetryAt = null;\n    this._snapshot(op);\n    this.notify();\n\n    op.execute(op.abortController.signal).then(\n      () => {\n        // Identity check: ignore if this op was superseded or cancelled\n        if (this._operations.get(id) !== op) return;\n        const operation = op.operation;\n        this._operations.delete(id);\n        this._snapshots.delete(id);\n        this.notify();\n        this.onConfirmed?.(id, operation);\n      },\n      (error: unknown) => {\n        // Identity check: ignore if this op was superseded or cancelled\n        if (this._operations.get(id) !== op) return;\n\n        // AbortError — remove silently (cancel or supersede)\n        if (isAbortError(error)) {\n          this._operations.delete(id);\n          this._snapshots.delete(id);\n          this.notify();\n          return;\n        }\n\n        const ctor = this.constructor as typeof Pending;\n        const classified = classifyError(error);\n\n        // Check if retryable and under max retries\n        if (this.isRetryable(error) && op.attempts < ctor.MAX_RETRIES) {\n          op.status = 'retrying';\n          const delay = this._calculateDelay(op.attempts - 1);\n          op.nextRetryAt = Date.now() + delay;\n          op.error = classified.message;\n          op.errorCode = classified.code;\n          this._snapshot(op);\n          this.notify();\n\n          op.retryTimer = setTimeout(() => {\n            op.retryTimer = null;\n            this._process(id);\n          }, delay);\n        } else {\n          // Non-retryable or max retries exceeded\n          op.status = 'failed';\n          op.error = classified.message;\n          op.errorCode = classified.code;\n          op.nextRetryAt = null;\n          this._snapshot(op);\n          this.notify();\n          this.onFailed?.(id, op.operation, error);\n        }\n      },\n    );\n  }\n\n  /** Computes retry backoff delay with jitter (Channel formula). @private */\n  private _calculateDelay(attempt: number): number {\n    const ctor = this.constructor as typeof Pending;\n    const capped = Math.min(\n      ctor.RETRY_BASE * Math.pow(ctor.RETRY_FACTOR, attempt),\n      ctor.RETRY_MAX,\n    );\n    return Math.random() * capped;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Pending.js","names":[],"sources":["../src/Pending.ts"],"sourcesContent":["import { classifyError, isAbortError } from './errors';\nimport type { AppError } from './errors';\nimport { Trackable } from './Trackable';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Types ─────────────────────────────────────────────────────────\n\n/** Frozen snapshot of a single pending operation's state. */\nexport interface PendingOperation<Meta = unknown> {\n  readonly status: 'active' | 'retrying' | 'failed';\n  readonly operation: string;\n  readonly attempts: number;\n  readonly maxRetries: number;\n  readonly error: string | null;\n  readonly errorCode: AppError['code'] | null;\n  readonly nextRetryAt: number | null;\n  readonly createdAt: number;\n  readonly meta: Meta | null;\n}\n\n/** A PendingOperation snapshot paired with its key, for iteration. */\nexport interface PendingEntry<K extends string | number, Meta = unknown>\n  extends PendingOperation<Meta> {\n  readonly id: K;\n}\n\n/** Mutable internal state for a pending operation. */\ninterface InternalOp<K, Meta> {\n  id: K;\n  operation: string;\n  execute: (signal: AbortSignal) => Promise<void>;\n  status: PendingOperation['status'];\n  attempts: number;\n  error: string | null;\n  errorCode: AppError['code'] | null;\n  nextRetryAt: number | null;\n  createdAt: number;\n  abortController: AbortController;\n  retryTimer: ReturnType<typeof setTimeout> | null;\n  meta: Meta | null;\n}\n\n// ── Pending ───────────────────────────────────────────────────────\n\n/**\n * Per-item operation queue with retry and status tracking.\n * Tracks operations by key with exponential backoff retry on transient errors.\n * Subscribable — auto-tracked when used as a ViewModel/Resource property.\n */\nexport class Pending<K extends string | number = string | number, Meta = unknown> extends Trackable {\n  // ── Static config (Channel pattern — override via subclass) ──\n\n  /** Maximum number of retry attempts before marking as failed. */\n  static MAX_RETRIES = 5;\n  /** Base delay (ms) for retry backoff. */\n  static RETRY_BASE = 1000;\n  /** Maximum delay cap (ms) for retry backoff. */\n  static RETRY_MAX = 30000;\n  /** Exponential backoff multiplier for retry delay. */\n  static RETRY_FACTOR = 2;\n\n  // ── Private state ──\n\n  private _operations = new Map<K, InternalOp<K, Meta>>();\n  private _snapshots = new Map<K, PendingOperation<Meta>>();\n  private _entriesCache: readonly PendingEntry<K, Meta>[] | null = null;\n\n  constructor() {\n    super();\n  }\n\n  // ── Readable state (reactive — auto-tracked by ViewModel getters) ──\n\n  /** Get the frozen status snapshot for an operation by ID, or null if not found. */\n  getStatus(id: K): PendingOperation<Meta> | null {\n    return this._snapshots.get(id) ?? null;\n  }\n\n  /** Whether an operation exists for the given ID. */\n  has(id: K): boolean {\n    return this._operations.has(id);\n  }\n\n  /** Number of operations (all statuses). */\n  get count(): number {\n    return this._operations.size;\n  }\n\n  /** Whether any operations are in-flight (active or retrying). */\n  get hasPending(): boolean {\n    for (const op of this._operations.values()) {\n      if (op.status !== 'failed') return true;\n    }\n    return false;\n  }\n\n  /** Whether any operations are in a failed state. */\n  get hasFailed(): boolean {\n    for (const op of this._operations.values()) {\n      if (op.status === 'failed') return true;\n    }\n    return false;\n  }\n\n  /** Number of operations in a failed state. */\n  get failedCount(): number {\n    let n = 0;\n    for (const op of this._operations.values()) {\n      if (op.status === 'failed') n++;\n    }\n    return n;\n  }\n\n  /** All operations as a frozen array of entries (id + snapshot). Cached until next mutation. */\n  get entries(): readonly PendingEntry<K, Meta>[] {\n    if (this._entriesCache === null) {\n      const result: PendingEntry<K, Meta>[] = [];\n      for (const [id, snapshot] of this._snapshots) {\n        result.push(Object.freeze({ ...snapshot, id }));\n      }\n      this._entriesCache = Object.freeze(result) as readonly PendingEntry<K, Meta>[];\n    }\n    return this._entriesCache;\n  }\n\n  // ── Core API ──\n\n  /**\n   * Enqueue an operation for the given ID. Fire-and-forget (synchronous return).\n   * If the same ID already has a pending operation, it is superseded (aborted).\n   */\n  enqueue(id: K, operation: string, execute: (signal: AbortSignal) => Promise<void>, meta?: Meta): void {\n    if (this.disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] Pending.enqueue() called after dispose — ignored.');\n      }\n      return;\n    }\n\n    // Supersede existing operation for this ID\n    const existing = this._operations.get(id);\n    if (existing) {\n      existing.abortController.abort();\n      if (existing.retryTimer !== null) {\n        clearTimeout(existing.retryTimer);\n      }\n    }\n\n    const op: InternalOp<K, Meta> = {\n      id,\n      operation,\n      execute,\n      status: 'active',\n      attempts: 0,\n      error: null,\n      errorCode: null,\n      nextRetryAt: null,\n      createdAt: Date.now(),\n      abortController: new AbortController(),\n      retryTimer: null,\n      meta: meta ?? null,\n    };\n\n    this._operations.set(id, op);\n    this._snapshot(op);\n    this.notify();\n\n    // Schedule processing via microtask (allows batching multiple enqueues)\n    queueMicrotask(() => this._process(id));\n  }\n\n  // ── Controls ──\n\n  /** Retry a failed operation. No-op if the operation is not in 'failed' status. */\n  retry(id: K): void {\n    if (this.disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] Pending.retry() called after dispose — ignored.');\n      }\n      return;\n    }\n\n    const op = this._operations.get(id);\n    if (!op || op.status !== 'failed') return;\n\n    op.attempts = 0;\n    op.error = null;\n    op.errorCode = null;\n    op.nextRetryAt = null;\n    op.abortController = new AbortController();\n    this._process(id);\n  }\n\n  /** Retry all failed operations. */\n  retryAll(): void {\n    if (this.disposed) {\n      if (__DEV__) {\n        console.warn('[mvc-kit] Pending.retryAll() called after dispose — ignored.');\n      }\n      return;\n    }\n\n    const failedIds: K[] = [];\n    for (const op of this._operations.values()) {\n      if (op.status === 'failed') failedIds.push(op.id);\n    }\n    for (const id of failedIds) {\n      this.retry(id);\n    }\n  }\n\n  /** Cancel an in-flight operation by ID. Aborts the signal, clears timers, and removes it. */\n  cancel(id: K): void {\n    const op = this._operations.get(id);\n    if (!op) return;\n\n    op.abortController.abort();\n    if (op.retryTimer !== null) {\n      clearTimeout(op.retryTimer);\n    }\n    this._operations.delete(id);\n    this._snapshots.delete(id);\n    this.notify();\n  }\n\n  /** Cancel all operations. */\n  cancelAll(): void {\n    for (const op of this._operations.values()) {\n      op.abortController.abort();\n      if (op.retryTimer !== null) {\n        clearTimeout(op.retryTimer);\n      }\n    }\n    this._operations.clear();\n    this._snapshots.clear();\n    this.notify();\n  }\n\n  /** Remove a failed operation without retrying. No-op if the operation is not in 'failed' status. */\n  dismiss(id: K): void {\n    const op = this._operations.get(id);\n    if (!op || op.status !== 'failed') return;\n\n    this._operations.delete(id);\n    this._snapshots.delete(id);\n    this.notify();\n  }\n\n  /** Remove all failed operations without retrying. */\n  dismissAll(): void {\n    const failedIds: K[] = [];\n    for (const op of this._operations.values()) {\n      if (op.status === 'failed') failedIds.push(op.id);\n    }\n    if (failedIds.length === 0) return;\n    for (const id of failedIds) {\n      this._operations.delete(id);\n      this._snapshots.delete(id);\n    }\n    this.notify();\n  }\n\n  // ── Hooks (overridable in subclass) ──\n\n  /**\n   * Determines whether an error is retryable. Override in a subclass to customize.\n   * Default: retries on network, timeout, and server_error codes.\n   * @protected\n   */\n  protected isRetryable(error: unknown): boolean {\n    const code = classifyError(error).code;\n    return code === 'network' || code === 'timeout' || code === 'server_error';\n  }\n\n  /** Called when an operation succeeds. Override in a subclass for side effects. @protected */\n  protected onConfirmed?(id: K, operation: string): void;\n  /** Called when an operation fails permanently. Override in a subclass for side effects. @protected */\n  protected onFailed?(id: K, operation: string, error: unknown): void;\n\n  // ── Lifecycle ──\n\n  /** Dispose: cancels all operations, then runs Trackable cleanup. */\n  dispose(): void {\n    if (this.disposed) return;\n    this.cancelAll();\n    super.dispose();\n  }\n\n  // ── Notification override ──\n\n  /** @internal Invalidates entries cache before notifying subscribers. */\n  protected notify(): void {\n    this._entriesCache = null;\n    super.notify();\n  }\n\n  // ── Internals ──\n\n  private _snapshot(op: InternalOp<K, Meta>): void {\n    const ctor = this.constructor as typeof Pending;\n    this._snapshots.set(op.id, Object.freeze({\n      status: op.status,\n      operation: op.operation,\n      attempts: op.attempts,\n      maxRetries: ctor.MAX_RETRIES,\n      error: op.error,\n      errorCode: op.errorCode,\n      nextRetryAt: op.nextRetryAt,\n      createdAt: op.createdAt,\n      meta: op.meta,\n    }));\n  }\n\n  private _process(id: K): void {\n    const op = this._operations.get(id);\n    if (!op || this.disposed) return;\n\n    // Set active status\n    op.status = 'active';\n    op.attempts++;\n    op.error = null;\n    op.errorCode = null;\n    op.nextRetryAt = null;\n    this._snapshot(op);\n    this.notify();\n\n    op.execute(op.abortController.signal).then(\n      () => {\n        // Identity check: ignore if this op was superseded or cancelled\n        if (this._operations.get(id) !== op) return;\n        const operation = op.operation;\n        this._operations.delete(id);\n        this._snapshots.delete(id);\n        this.notify();\n        this.onConfirmed?.(id, operation);\n      },\n      (error: unknown) => {\n        // Identity check: ignore if this op was superseded or cancelled\n        if (this._operations.get(id) !== op) return;\n\n        // AbortError — remove silently (cancel or supersede)\n        if (isAbortError(error)) {\n          this._operations.delete(id);\n          this._snapshots.delete(id);\n          this.notify();\n          return;\n        }\n\n        const ctor = this.constructor as typeof Pending;\n        const classified = classifyError(error);\n\n        // Check if retryable and under max retries\n        if (this.isRetryable(error) && op.attempts < ctor.MAX_RETRIES) {\n          op.status = 'retrying';\n          const delay = this._calculateDelay(op.attempts - 1);\n          op.nextRetryAt = Date.now() + delay;\n          op.error = classified.message;\n          op.errorCode = classified.code;\n          this._snapshot(op);\n          this.notify();\n\n          op.retryTimer = setTimeout(() => {\n            op.retryTimer = null;\n            this._process(id);\n          }, delay);\n        } else {\n          // Non-retryable or max retries exceeded\n          op.status = 'failed';\n          op.error = classified.message;\n          op.errorCode = classified.code;\n          op.nextRetryAt = null;\n          this._snapshot(op);\n          this.notify();\n          this.onFailed?.(id, op.operation, error);\n        }\n      },\n    );\n  }\n\n  /** Computes retry backoff delay with jitter (Channel formula). @private */\n  private _calculateDelay(attempt: number): number {\n    const ctor = this.constructor as typeof Pending;\n    const capped = Math.min(\n      ctor.RETRY_BASE * Math.pow(ctor.RETRY_FACTOR, attempt),\n      ctor.RETRY_MAX,\n    );\n    return Math.random() * capped;\n  }\n}\n"],"mappings":"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"}