@askrjs/askr 0.3.0 → 0.4.0

package/dist/resource-18-sFRl9.js

@@ -1,344 +0,0 @@
-import { t as enqueueRuntimeLane, v as logger } from "./access-CEA2pOry.js";
-import { P as isPromiseLike, d as registerCommitOperationForInstance, h as getCurrentContextFrame, y as withAsyncResourceContext } from "./instance-VAFYVJOa.js";
-import { O as ownCleanup, f as getCurrentComponentInstance } from "./scope-Cq_iYbTR.js";
-import { t as brandSnapshotSource } from "./snapshot-source-An4iKajG.js";
-import { C as SSRDataMissingError, a as getResourceVerificationSnapshot, i as getNextRenderKey, n as getActiveRenderContext, o as isHydrationVerificationRender, p as throwSSRDataMissing, r as getCurrentRenderData, s as recordResourceVerificationSnapshot } from "./render-context-B7ohlh6t.js";
-import { t as state } from "./state-BXJfudq1.js";
-//#region src/runtime/lifecycle/resource-cell.ts
-/**
-* Pure, component-agnostic ResourceCell state machine.
-* - Holds value/pending/error/generation/controller
-* - Exposes a stable `snapshot` object: { value, pending, error, refresh }
-* - Uses `withAsyncResourceContext` to bind the synchronous execution step
-*   to a captured frame. Continuations after await do not see the frame.
-*/
-var ResourceCell = class {
-	constructor(fn, deps, resourceFrame) {
-		this.value = null;
-		this.pending = true;
-		this.error = null;
-		this.generation = 0;
-		this.controller = null;
-		this.deps = null;
-		this.resourceFrame = null;
-		this.subscribers = /* @__PURE__ */ new Set();
-		this.disposed = false;
-		this.fn = fn;
-		this.deps = deps ? deps.slice() : null;
-		this.resourceFrame = resourceFrame;
-		this.snapshot = brandSnapshotSource({
-			value: null,
-			pending: true,
-			error: null,
-			refresh: () => this.refresh()
-		});
-	}
-	setLoader(fn) {
-		this.fn = fn;
-	}
-	subscribe(cb) {
-		this.subscribers.add(cb);
-		return () => this.subscribers.delete(cb);
-	}
-	notifySubscribers() {
-		this.snapshot.value = this.value;
-		this.snapshot.pending = this.pending;
-		this.snapshot.error = this.error;
-		for (const cb of this.subscribers) try {
-			cb();
-		} catch (error) {
-			this.reportError(error, "Resource subscriber error");
-		}
-	}
-	reportError(error, label = "Async resource error") {
-		try {
-			logger.error(`[Askr] ${label}${this.ownerName ? ` in ${this.ownerName}` : ""}:`, error);
-		} catch {}
-	}
-	start(ssr = false, notify = true) {
-		if (this.disposed) return;
-		const generation = this.generation;
-		const previous = this.controller;
-		const controller = new AbortController();
-		this.controller = controller;
-		const current = () => this.generation === generation && this.controller === controller && !controller.signal.aborted;
-		previous?.abort();
-		if (!current()) return;
-		this.pending = true;
-		this.error = null;
-		if (notify) this.notifySubscribers();
-		if (!current()) return;
-		const fail = (reason, asynchronous = false) => {
-			if (!current()) return;
-			let error;
-			try {
-				if (asynchronous && (reason instanceof Error && reason.name === "AbortError" || typeof DOMException !== "undefined" && reason instanceof DOMException && reason.name === "AbortError")) return;
-				error = reason instanceof Error ? reason : new Error(String(reason));
-			} catch {
-				error = /* @__PURE__ */ new Error("Resource error normalization failed");
-			}
-			if (!current()) return;
-			this.pending = false;
-			this.error = error;
-			if (asynchronous) this.reportError(reason);
-			if (current() && (notify || asynchronous)) this.notifySubscribers();
-		};
-		let result;
-		let asynchronous;
-		try {
-			result = withAsyncResourceContext(this.resourceFrame, () => this.fn({ signal: controller.signal }));
-			asynchronous = isPromiseLike(result);
-		} catch (err) {
-			fail(err);
-			return;
-		}
-		if (!asynchronous) {
-			if (!current()) return;
-			this.value = result;
-			this.pending = false;
-			this.error = null;
-			if (notify) this.notifySubscribers();
-			return;
-		}
-		if (ssr) {
-			new Promise((resolve) => resolve(result)).then(void 0, () => {});
-			controller.abort();
-			throwSSRDataMissing();
-		}
-		try {
-			Promise.resolve(result).then((val) => {
-				if (!current()) return;
-				this.value = val;
-				this.pending = false;
-				this.error = null;
-				this.notifySubscribers();
-			}, (err) => fail(err, true));
-		} catch (err) {
-			fail(err);
-		}
-	}
-	refresh() {
-		if (this.disposed) return;
-		this.generation++;
-		this.start();
-	}
-	abort() {
-		this.controller?.abort();
-	}
-	dispose() {
-		if (this.disposed) return;
-		this.disposed = true;
-		this.controller?.abort();
-		this.subscribers.clear();
-	}
-};
-//#endregion
-//#region src/runtime/lifecycle/resource.ts
-function hydrationVerificationSnapshot() {
-	return brandSnapshotSource({
-		value: null,
-		pending: true,
-		error: null,
-		refresh: () => {}
-	});
-}
-/**
-* What resource data, if any, the current render was given.
-*
-* Both the outside-a-component path and the in-component path asked this
-* question, each spelling out the same two-part test by hand. One answer keeps
-* the "is this a hydrating render with preloaded values" decision from drifting
-* between them.
-*/
-function resolveResourceRenderData() {
-	const renderData = getCurrentRenderData()?.resources;
-	return {
-		renderData,
-		hasPreloadedData: Boolean(renderData && (getActiveRenderContext()?.resourceDataProvided || Object.keys(renderData).some((key) => key.startsWith("r:"))))
-	};
-}
-/**
-* Resolve a resource declared outside any component instance.
-*
-* Only legitimate during a synchronous SSR render that already carries resolved
-* data; every other caller is creating a resource where it cannot be owned.
-*/
-function resolveResourceWithoutInstance() {
-	const { renderData, hasPreloadedData } = resolveResourceRenderData();
-	if (renderData && hasPreloadedData) {
-		const key = getNextRenderKey();
-		if (!(key in renderData)) throwSSRDataMissing();
-		return brandSnapshotSource({
-			value: renderData[key],
-			pending: false,
-			error: null,
-			refresh: () => {}
-		});
-	}
-	if (getActiveRenderContext()) throwSSRDataMissing();
-	throw new Error("[Askr] resource() must be called during component render inside an app. Do not create resources at module scope or outside render.");
-}
-/**
-* Resource primitive — simple, deterministic async primitive
-* Usage: resource(fn, deps)
-* - fn receives { signal }
-* - captures execution context once at creation (synchronous step only)
-* - executes at most once per generation; stale async results are ignored
-* - refresh() cancels in-flight execution, increments generation and re-runs
-* - exposes { value, pending, error, refresh }
-* - during SSR, async results are disallowed and will throw synchronously
-*/
-function resource(fn, deps = []) {
-	const instance = getCurrentComponentInstance();
-	const inst = instance;
-	if (!instance) return resolveResourceWithoutInstance();
-	const { renderData, hasPreloadedData: hasPreloadedResourceData } = resolveResourceRenderData();
-	const renderKey = inst.ssr || hasPreloadedResourceData ? getNextRenderKey() : null;
-	const verificationSnapshot = renderKey ? getResourceVerificationSnapshot(renderKey) : null;
-	if (renderData && hasPreloadedResourceData && renderKey && renderKey in renderData) {
-		const val = renderData[renderKey];
-		const h = state({
-			cell: void 0,
-			snapshot: brandSnapshotSource({
-				value: val,
-				pending: false,
-				error: null,
-				refresh: () => {}
-			})
-		})();
-		h.snapshot.value = val;
-		h.snapshot.pending = false;
-		h.snapshot.error = null;
-		return h.snapshot;
-	}
-	if (isHydrationVerificationRender() && verificationSnapshot) {
-		const result = hydrationVerificationSnapshot();
-		result.value = verificationSnapshot.value;
-		result.pending = verificationSnapshot.pending;
-		return result;
-	}
-	if (renderData && hasPreloadedResourceData && renderKey && (inst.ssr || !verificationSnapshot)) throwSSRDataMissing();
-	const ssrRenderKey = inst.ssr ? renderKey : null;
-	const clientHydrationSnapshot = inst.ssr ? null : verificationSnapshot;
-	const holder = state({
-		cell: void 0,
-		snapshot: brandSnapshotSource({
-			value: clientHydrationSnapshot ? clientHydrationSnapshot.value : null,
-			pending: clientHydrationSnapshot?.pending ?? true,
-			error: null,
-			refresh: () => {}
-		})
-	});
-	const h = holder();
-	if (!h.cell) {
-		const cell = new ResourceCell(fn, deps, getCurrentContextFrame());
-		if (clientHydrationSnapshot) {
-			cell.value = clientHydrationSnapshot.value;
-			cell.pending = clientHydrationSnapshot.pending;
-			cell.snapshot.value = clientHydrationSnapshot.value;
-			cell.snapshot.pending = clientHydrationSnapshot.pending;
-		}
-		cell.ownerName = inst.fn?.name || "<anonymous>";
-		h.cell = cell;
-		h.snapshot = cell.snapshot;
-		const unsubscribe = cell.subscribe(() => {
-			const cur = holder();
-			cur.snapshot.value = cell.snapshot.value;
-			cur.snapshot.pending = cell.snapshot.pending;
-			cur.snapshot.error = cell.snapshot.error;
-			holder.set(cur);
-			try {
-				inst.notifyUpdate?.();
-			} catch {}
-		});
-		ownCleanup(inst.owner, unsubscribe);
-		ownCleanup(inst.owner, () => cell.dispose());
-		if (inst.ssr) {
-			cell.start(true, false);
-			if (!cell.pending) {
-				const cur = holder();
-				cur.snapshot.value = cell.value;
-				cur.snapshot.pending = cell.pending;
-				cur.snapshot.error = cell.error;
-			}
-			if (ssrRenderKey && cell.value === null && cell.error === null) recordResourceVerificationSnapshot(ssrRenderKey, {
-				value: null,
-				pending: cell.pending
-			});
-		} else {
-			const scheduledGeneration = cell.generation;
-			registerCommitOperationForInstance(inst, () => {
-				enqueueRuntimeLane("post", () => {
-					if (!inst.notifyUpdate || cell.generation !== scheduledGeneration) return;
-					try {
-						cell.start(false, false);
-					} catch (err) {
-						const cur = holder();
-						cur.snapshot.value = cell.value;
-						cur.snapshot.pending = cell.pending;
-						cur.snapshot.error = err ?? null;
-						holder.set(cur);
-						inst.notifyUpdate?.();
-						return;
-					}
-					if (!cell.pending) {
-						const cur = holder();
-						cur.snapshot.value = cell.value;
-						cur.snapshot.pending = cell.pending;
-						cur.snapshot.error = cell.error;
-						holder.set(cur);
-						inst.notifyUpdate?.();
-					}
-				});
-			});
-		}
-	}
-	const cell = h.cell;
-	cell.setLoader(fn);
-	if (!cell.deps || cell.deps.length !== deps.length || cell.deps.some((d, i) => !Object.is(d, deps[i]))) {
-		cell.deps = deps.slice();
-		cell.generation++;
-		cell.pending = true;
-		cell.error = null;
-		h.snapshot.pending = true;
-		h.snapshot.error = null;
-		try {
-			if (inst.ssr) {
-				cell.start(true, false);
-				if (!cell.pending) {
-					const cur = holder();
-					cur.snapshot.value = cell.value;
-					cur.snapshot.pending = cell.pending;
-					cur.snapshot.error = cell.error;
-				}
-			} else {
-				const scheduledGeneration = cell.generation;
-				registerCommitOperationForInstance(inst, () => {
-					enqueueRuntimeLane("post", () => {
-						if (!inst.notifyUpdate || cell.generation !== scheduledGeneration) return;
-						cell.start(false, false);
-						if (!cell.pending) {
-							const cur = holder();
-							cur.snapshot.value = cell.value;
-							cur.snapshot.pending = cell.pending;
-							cur.snapshot.error = cell.error;
-							holder.set(cur);
-							inst.notifyUpdate?.();
-						}
-					});
-				});
-			}
-		} catch (err) {
-			if (err instanceof SSRDataMissingError) throw err;
-			cell.error = err;
-			cell.pending = false;
-			const cur = holder();
-			cur.snapshot.value = cell.value;
-			cur.snapshot.pending = cell.pending;
-			cur.snapshot.error = cell.error;
-		}
-	}
-	return h.snapshot;
-}
-//#endregion
-export { resource as t };