@seedprotocol/query 0.5.2

package/dist/index.js

@@ -0,0 +1,1078 @@
+import { i as e, n as t, r as n, t as r } from "./bootstrap-DQZ8ehyx.js";
+import { BaseArweaveClient as i, isKnownArweaveGatewayHostname as a } from "@seedprotocol/arweave";
+import { EasClient as o, GET_SEEDS as s, getItemPropertiesFromEas as c, getItemVersionsFromEas as l, getSeedsBySchemaName as u, pickLatestPropertyAttestationsByRefAndSchema as d, setSchemaUidForSchemaDefinition as f, withExcludeRevokedFilter as p } from "@seedprotocol/eas";
+import m from "pluralize";
+import { promises as h } from "fs";
+import { join as g } from "path";
+import { createHash as ee } from "crypto";
+//#region src/arweaveUrl.ts
+function _(e) {
+	return `https://${i.getHost()}/${e}`;
+}
+//#endregion
+//#region src/listRelationKey.ts
+var te = /^(.+?)([A-Z][a-zA-Z]+)Ids$/;
+function v(e) {
+	let t = te.exec(e);
+	if (t) {
+		let e = t[1];
+		if (e) return m(e);
+	}
+	if (e.endsWith("_ids")) {
+		let t = e.slice(0, -4), n = t.split("_").filter(Boolean);
+		if (n.length >= 2) {
+			let e = n[0];
+			return e.endsWith("s") ? e : m(e);
+		}
+		return m(t);
+	}
+	return e;
+}
+function y(e, t) {
+	for (let n of Object.keys(e)) n !== t && v(n) === t && delete e[n];
+}
+function b(e) {
+	if (Array.isArray(e) || typeof e != "string") return e;
+	let t = e.trim();
+	if (!t.startsWith("[")) return e;
+	try {
+		let e = JSON.parse(t);
+		if (Array.isArray(e)) return e;
+	} catch {}
+	return e;
+}
+//#endregion
+//#region src/imageRelationEnrichment.ts
+function x(e) {
+	let t = e.storageTransactionId ?? e.storage_transaction_id;
+	if (t && typeof t == "string" && t.trim()) try {
+		e.arweaveUrl = _(t.trim());
+	} catch {}
+}
+var ne = x, S = new Set([
+	"html",
+	"file",
+	"json"
+]), re = S, C = "_feedFieldStorageModels", ie = "_feedListElementStorageModels";
+function w(e) {
+	return e.trim().toLowerCase();
+}
+function T(e) {
+	return S.has(w(e));
+}
+var ae = T;
+function E(e) {
+	let t = w(e);
+	return t === "html" ? 0 : t === "file" ? 1 : t === "json" ? 2 : 99;
+}
+var oe = E;
+function D(e) {
+	let t = e[C];
+	if (typeof t == "object" && t && !Array.isArray(t)) return t;
+}
+var se = D;
+function O(e) {
+	let t = e[ie];
+	if (typeof t == "object" && t && !Array.isArray(t)) return t;
+}
+var ce = O;
+function k(e, t, n) {
+	let r = w(n), i = D(e);
+	i || (i = {}, e[C] = i), i[t] = r;
+}
+var le = k;
+function A(e, t, n) {
+	let r = O(e);
+	r || (r = {}, e[ie] = r), r[t] = n.map(w);
+}
+var ue = A, de = [
+	"html",
+	"Html",
+	"body",
+	"Body",
+	"content",
+	"Content"
+], fe = 8e6;
+function pe(e) {
+	let t = e.trim();
+	if (!t.startsWith("http://") && !t.startsWith("https://")) return !1;
+	try {
+		let e = new URL(t), n = e.hostname.toLowerCase();
+		if (n !== i.getHost().toLowerCase() && !a(n)) return !1;
+		let r = e.pathname.replace(/^\//, "").split("/").filter(Boolean);
+		if (r.length !== 1) return !1;
+		let o = r[0];
+		return /^[A-Za-z0-9_-]{43}$/.test(o);
+	} catch {
+		return !1;
+	}
+}
+async function me(e) {
+	try {
+		let t = await fetch(e, {
+			headers: { Accept: "text/html, text/plain, text/markdown, application/json, */*" },
+			signal: AbortSignal.timeout(15e3)
+		});
+		if (!t.ok) return null;
+		let n = t.headers.get("content-type") ?? "";
+		if (/^(image|video|audio)\//i.test(n)) return null;
+		let r = await t.arrayBuffer();
+		if (r.byteLength > fe) return null;
+		let i = new TextDecoder("utf-8", { fatal: !1 }).decode(r);
+		return i.length === 0 || i.includes("\0") ? null : i;
+	} catch {
+		return null;
+	}
+}
+async function he(e, t, n) {
+	if (n) try {
+		let r = await n({
+			propertyName: e,
+			value: t
+		});
+		if (r != null && r.length > 0) return r;
+	} catch {}
+	return pe(t) ? me(t) : null;
+}
+async function ge(e, t, n) {
+	let r = e[t];
+	if (typeof r != "string" || r.trim() === "") return;
+	let i = await he(t, r, n);
+	i !== null && (e[t] = i);
+}
+async function j(e, t) {
+	let n = t?.readStorageBody;
+	for (let t of e) {
+		let e = new Set([...de]), r = D(t);
+		if (r) for (let [t, n] of Object.entries(r)) T(n) && e.add(t);
+		for (let r of e) await ge(t, r, n);
+		let i = O(t);
+		if (i) for (let [e, r] of Object.entries(i)) {
+			let i = t[e];
+			if (!Array.isArray(i)) continue;
+			let a = Math.min(r.length, i.length);
+			for (let t = 0; t < a; t++) {
+				if (!T(r[t])) continue;
+				let a = i[t];
+				if (typeof a != "string") continue;
+				let o = await he(e, a, n);
+				o !== null && (i[t] = o);
+			}
+		}
+	}
+}
+var _e = j;
+//#endregion
+//#region src/parseEasPropertyMetadata.ts
+function M(e) {
+	let t = typeof e == "string" ? e.trim() : "";
+	if (!t) return {
+		ok: !1,
+		reason: "empty"
+	};
+	let n;
+	try {
+		n = JSON.parse(t);
+	} catch (e) {
+		return {
+			ok: !1,
+			reason: "parse",
+			error: e
+		};
+	}
+	return !Array.isArray(n) || n.length === 0 || !n[0]?.value ? {
+		ok: !1,
+		reason: "shape"
+	} : {
+		ok: !0,
+		metadata: n[0].value
+	};
+}
+var ve = M;
+//#endregion
+//#region src/parseEasRelationPropertyName.ts
+function N(e) {
+	let [t, n, r] = e.split("_");
+	if (!t || !n) return null;
+	let i = r === "ids";
+	return {
+		propertyName: t.endsWith("s") ? t : t + "s",
+		modelName: n,
+		isList: i
+	};
+}
+//#endregion
+//#region src/source/remote.ts
+function ye(e, t) {
+	let n = new Date(e, t - 1, 1), r = new Date(e, t, 0, 23, 59, 59);
+	return {
+		startTs: Math.floor(n.getTime() / 1e3),
+		endTs: Math.floor(r.getTime() / 1e3) + 1
+	};
+}
+function P() {
+	return {
+		kind: "remote",
+		async getSeedByUid(e) {
+			let { itemSeeds: t } = await o.getEasClient().request(s, {
+				where: p({ id: { equals: e } }),
+				take: 1,
+				skip: 0
+			});
+			return (t ?? [])[0] ?? null;
+		},
+		async listSeedsBySchemaName(e, t) {
+			return await u(e, t.limit, t.skip);
+		},
+		async listSeedsBySchemaNameForMonth(e, t, n) {
+			let { startTs: r, endTs: i } = ye(t, n), a = p({ AND: [{ schema: { is: { schemaNames: { some: { name: { equals: e } } } } } }, { timeCreated: {
+				gte: r,
+				lt: i
+			} }] }), { itemSeeds: c } = await o.getEasClient().request(s, {
+				where: a,
+				take: 1e3,
+				skip: 0
+			});
+			return c ?? [];
+		},
+		async getVersionsForSeed(e) {
+			return await l({ seedUids: [e] });
+		},
+		async getVersionsForSeeds(e) {
+			return e.length === 0 ? [] : await l({ seedUids: e });
+		},
+		async getPropertiesForVersionUids(e) {
+			return e.length === 0 ? [] : await c({ versionUids: e });
+		},
+		async getSeedsByUids(e) {
+			if (e.length === 0) return [];
+			let { itemSeeds: t } = await o.getEasClient().request(s, {
+				where: p({ id: { in: e } }),
+				take: e.length || 1,
+				skip: 0
+			});
+			return t ?? [];
+		}
+	};
+}
+var F = null;
+function I() {
+	return F ||= P(), F;
+}
+//#endregion
+//#region src/assembleSeeds.ts
+var L = "image", R = ["0x0000000000000000000000000000000000000000000000000000000000000020"], be = new Set([
+	"seedUid",
+	"SeedUid",
+	"timeCreated",
+	"attester",
+	"Attester",
+	"storage_transaction_id",
+	"storage_provider_transaction_id",
+	"storageTransactionId",
+	"storageProviderTransactionId",
+	"versionUid"
+]), z = (e) => e.replace(/_([a-z])/g, (e, t) => t.toUpperCase());
+function xe() {
+	return {
+		seedUidToModelType: /* @__PURE__ */ new Map(),
+		relatedSeedUids: /* @__PURE__ */ new Set(),
+		versionUidToSeedUid: /* @__PURE__ */ new Map(),
+		assembledItems: /* @__PURE__ */ new Map(),
+		versionsBySeedUid: /* @__PURE__ */ new Map(),
+		latestVersionUidsBySeedUid: /* @__PURE__ */ new Map()
+	};
+}
+function B(e, t) {
+	!e.seedUid && !e.SeedUid ? (e.seedUid = t, e.SeedUid = t) : e.seedUid && !e.SeedUid ? e.SeedUid = e.seedUid : e.SeedUid && !e.seedUid && (e.seedUid = e.SeedUid), e.attester && !e.Attester ? e.Attester = e.attester : e.Attester && !e.attester && (e.attester = e.Attester);
+}
+async function Se(e, t) {
+	let n = M(t.decodedDataJson);
+	if (!n.ok) {
+		let { id: e, refUID: r, schemaId: i } = t;
+		n.reason === "empty" ? console.warn("[query] [processItemProperty] empty decodedDataJson for property:", e, r, i) : n.reason === "parse" ? console.warn("[query] [processItemProperty] failed to parse decodedDataJson for property:", e, r, i, n.error) : console.warn("[query] [processItemProperty] invalid decodedDataJson structure for property:", e, r, i);
+		return;
+	}
+	let r = n.metadata, i = r.name;
+	if (!i) return;
+	let a = t.schemaId;
+	f({
+		text: i,
+		schemaUid: a
+	});
+	let o = !1, s = !1, c = r.type, l = (c === "bytes32" || c === "bytes32[]") && i !== "storage_transaction_id" && i !== "storage_provider_transaction_id", u = !l && (i.endsWith("_id") || i.endsWith("_ids")) && i !== "storage_transaction_id" && i !== "storage_provider_transaction_id";
+	if (l || u) if (o = !0, Array.isArray(r.value)) {
+		if (s = !0, u) {
+			let e = N(i);
+			e && (i = e.propertyName);
+		}
+		r.value.forEach((t) => {
+			R.includes(t) || e.relatedSeedUids.add(t);
+		});
+	} else R.includes(r.value) || e.relatedSeedUids.add(r.value);
+	let d = r.value;
+	o && s && Array.isArray(d) ? d = d.map((e) => String(e)) : typeof d != "string" && (d = JSON.stringify(d));
+	let p = e.versionUidToSeedUid.get(t.refUID);
+	if (!p) return;
+	let m = e.assembledItems.get(p) || {};
+	m[i] = d;
+	let h = z(i);
+	h !== i && (m[h] = d), e.assembledItems.set(p, m);
+}
+async function Ce(e, t, n) {
+	let r = [];
+	for (let n = 0; n < t.length; n++) {
+		let i = t[n];
+		if (!i) continue;
+		r.push(i.id);
+		let a = i.schema?.schemaNames?.[0]?.name ?? "unknown";
+		e.seedUidToModelType.set(i.id, a), e.assembledItems.has(i.id) || e.assembledItems.set(i.id, {
+			seedUid: i.id,
+			timeCreated: i.timeCreated,
+			attester: i.attester
+		});
+	}
+	if (r.length === 0) return;
+	let i = await n.getVersionsForSeeds(r);
+	for (let t = 0; t < i.length; t++) {
+		let n = i[t], r = n.refUID;
+		e.versionUidToSeedUid.set(n.id, r);
+		let a = e.versionsBySeedUid.get(r) || [];
+		e.versionsBySeedUid.set(r, [...a, n]);
+	}
+	let a = [];
+	for (let [t, n] of e.versionsBySeedUid.entries()) {
+		if (e.latestVersionUidsBySeedUid.has(t)) continue;
+		let r = [...n].sort((e, t) => t.timeCreated - e.timeCreated)[0];
+		r && (a.push(r.id), e.latestVersionUidsBySeedUid.set(t, r.id));
+	}
+	if (a.length === 0) return;
+	let o = d(await n.getPropertiesForVersionUids(a));
+	for (let t = 0; t < o.length; t++) await Se(e, o[t]);
+}
+function we(e, t) {
+	let n = Array.from(e.assembledItems.entries()).filter(([n]) => e.seedUidToModelType.get(n) === t);
+	for (let [, t] of n) {
+		let n = Object.keys(t).filter((e) => !e.startsWith("_") && !be.has(e));
+		for (let r of n) {
+			let n = t[r], i = b(n);
+			if (i !== n && Array.isArray(i) && (t[r] = i, n = i), Array.isArray(n)) {
+				let i = n;
+				if (!i.some((t) => typeof t == "string" && !R.includes(t) && e.assembledItems.has(t))) continue;
+				let a = [], o = [], s = !1;
+				for (let t of i) {
+					if (typeof t != "string" || R.includes(t)) {
+						a.push(String(t)), o.push("unknown");
+						continue;
+					}
+					let n = e.seedUidToModelType.get(t) ?? "unknown";
+					if (n === L) {
+						a.push(t), o.push(L);
+						continue;
+					}
+					let r = e.assembledItems.get(t), i = r?.storageTransactionId ?? r?.storage_transaction_id;
+					if (i && typeof i == "string" && i.trim()) try {
+						a.push(_(i)), o.push(n), s = !0;
+					} catch {
+						a.push(t), o.push(n);
+					}
+					else a.push(t), o.push(n);
+				}
+				if (s) {
+					let e = v(r);
+					if (t[e] = a, A(t, e, o), y(t, e), e !== r) {
+						delete t[r];
+						let e = z(r);
+						e !== r && delete t[e];
+					}
+				}
+			} else if (typeof n == "string") {
+				if (R.includes(n) || !e.assembledItems.has(n)) continue;
+				let i = e.assembledItems.get(n);
+				if (e.seedUidToModelType.get(n) === L) continue;
+				let a = i?.storageTransactionId ?? i?.storage_transaction_id;
+				if (a && typeof a == "string" && a.trim()) try {
+					let i = r.endsWith("_id") ? r.replace(/_id$/, "") : r;
+					t[i] = _(a);
+					let o = e.seedUidToModelType.get(n) ?? "unknown";
+					k(t, i, o);
+					let s = z(i);
+					if (s !== i && k(t, s, o), i !== r) {
+						delete t[r];
+						let e = z(r);
+						e !== r && delete t[e];
+					}
+				} catch {}
+			}
+		}
+	}
+}
+function Te(e, t, n) {
+	if (!n) return;
+	let r = Array.from(e.assembledItems.entries()).filter(([n]) => e.seedUidToModelType.get(n) === t);
+	for (let [, t] of r) {
+		let n = Object.keys(t).filter((e) => !e.startsWith("_") && !be.has(e));
+		for (let r of n) {
+			let n = t[r], i = b(n);
+			i !== n && Array.isArray(i) && (t[r] = i, n = i);
+			let a = Array.isArray(n), o = a ? n : [n], s = [], c = !1;
+			for (let t of o) {
+				if (typeof t != "string" || R.includes(t)) {
+					s.push(t);
+					continue;
+				}
+				let n = e.assembledItems.get(t);
+				if (!n) {
+					s.push(t);
+					continue;
+				}
+				let r = n?.storageTransactionId ?? n?.storage_transaction_id;
+				if (e.seedUidToModelType.get(t) === L) {
+					let e = { ...n };
+					B(e, t), e.schemaName = L, x(e), s.push(e), c = !0;
+					continue;
+				}
+				if (r && typeof r == "string" && r.trim()) {
+					s.push(t);
+					continue;
+				}
+				let i = { ...n };
+				B(i, t), s.push(i), c = !0;
+			}
+			if (c) {
+				let e = a ? v(r) : r.endsWith("_id") ? r.replace(/_id$/, "") : r;
+				if (t[e] = a ? s : s[0], y(t, e), e !== r) {
+					delete t[r];
+					let e = z(r);
+					e !== r && delete t[e];
+				}
+			}
+		}
+	}
+}
+function Ee(e, t) {
+	return Array.from(e.assembledItems.entries()).filter(([n]) => e.seedUidToModelType.get(n) === t).map(([n, r]) => {
+		let i = e.latestVersionUidsBySeedUid.get(n) ?? "";
+		i && (r.versionUid = i), B(r, n);
+		let a = typeof r.timeCreated == "number" ? r.timeCreated : 0;
+		return {
+			seedUid: n,
+			schemaName: t,
+			attester: typeof r.attester == "string" ? r.attester : typeof r.Attester == "string" ? r.Attester : void 0,
+			timeCreated: a,
+			versionUid: i,
+			data: r
+		};
+	});
+}
+async function V(e, t, n, r = I()) {
+	let i = n?.expandRelations !== !1, a = n?.hydrateStorage !== !1, o = xe();
+	await Ce(o, t, r);
+	let s = Array.from(o.relatedSeedUids).filter((e) => !o.assembledItems.has(e));
+	s.length > 0 && await Ce(o, await r.getSeedsByUids(s), r), we(o, e), Te(o, e, i);
+	let c = Ee(o, e);
+	return a && await j(c.map((e) => e.data), r.readStorageBody ? { readStorageBody: r.readStorageBody.bind(r) } : void 0), c;
+}
+//#endregion
+//#region src/changelog.ts
+var De = (e) => e.replace(/_([a-z])/g, (e, t) => t.toUpperCase());
+function H(e, t) {
+	if (Object.is(e, t)) return !0;
+	if (e === void 0 || t === void 0) return !1;
+	if (e === null || t === null) return e === t;
+	if (typeof e != typeof t || typeof e != "object") return !1;
+	try {
+		return JSON.stringify(e) === JSON.stringify(t);
+	} catch {
+		return !1;
+	}
+}
+function U(e) {
+	let t = M(e.decodedDataJson);
+	if (!t.ok) return null;
+	let n = t.metadata, r = n.name;
+	if (!r) return null;
+	let i = n.type, a = (i === "bytes32" || i === "bytes32[]") && r !== "storage_transaction_id" && r !== "storage_provider_transaction_id", o = !a && (r.endsWith("_id") || r.endsWith("_ids")) && r !== "storage_transaction_id" && r !== "storage_provider_transaction_id", s = !1, c = !1;
+	if ((a || o) && (s = !0, Array.isArray(n.value) && (c = !0, o))) {
+		let e = N(r);
+		e?.isList && (r = e.propertyName);
+	}
+	let l = n.value;
+	s && c && Array.isArray(l) ? l = l.map((e) => String(e)) : typeof l != "string" && (l = JSON.stringify(l));
+	let u = De(r);
+	return {
+		propertyName: r,
+		value: l,
+		camelName: u === r ? void 0 : u
+	};
+}
+function Oe(e) {
+	let t = {};
+	for (let n of e) {
+		let e = U(n);
+		e && (t[e.propertyName] = e.value, e.camelName && (t[e.camelName] = e.value));
+	}
+	return t;
+}
+function ke(e) {
+	let t = [], n = {};
+	for (let r of e) {
+		let e = r.data, i = new Set([...Object.keys(n), ...Object.keys(e)]), a = [];
+		for (let t of i) H(n[t], e[t]) || a.push(t);
+		a.sort(), t.push({
+			type: "version",
+			at: r.at,
+			versionUid: r.versionUid,
+			before: { ...n },
+			after: { ...e },
+			changedKeys: a
+		}), n = e;
+	}
+	return t;
+}
+function Ae(e) {
+	let t = [...e].sort((e, t) => e.timeCreated === t.timeCreated ? e.id.localeCompare(t.id) : e.timeCreated - t.timeCreated), n = /* @__PURE__ */ new Map(), r = [];
+	for (let e of t) {
+		let t = U(e);
+		if (!t) continue;
+		let i = [t.propertyName];
+		t.camelName && i.push(t.camelName);
+		let a = n.has(t.propertyName) ? n.get(t.propertyName) : void 0, o = t.value;
+		H(a, o) || r.push({
+			type: "property",
+			at: e.timeCreated,
+			versionUid: e.refUID,
+			property: t.propertyName,
+			attestationUid: e.id,
+			previousValue: a,
+			nextValue: o
+		}), n.set(t.propertyName, o), t.camelName && n.set(t.camelName, o);
+	}
+	return r;
+}
+function je(e, t) {
+	let n = e;
+	if (typeof t?.since == "number") {
+		let e = t.since;
+		n = n.filter((t) => t.at >= e);
+	}
+	return typeof t?.limit == "number" && t.limit >= 0 && (n = [...n].sort((e, t) => t.at === e.at ? 0 : t.at - e.at).slice(0, t.limit).reverse()), n;
+}
+//#endregion
+//#region src/assembleChangelog.ts
+async function Me(e, t, n = I()) {
+	let r = t?.changelog ?? {}, i = r.granularity ?? "version", a = [...await n.getVersionsForSeed(e)].sort((e, t) => e.timeCreated - t.timeCreated);
+	if (a.length === 0) return {
+		latestVersionUid: "",
+		changelog: []
+	};
+	let o = a[a.length - 1].id, s = a.map((e) => e.id), c = await n.getPropertiesForVersionUids(s), l;
+	if (i === "property") l = Ae(c);
+	else {
+		let e = /* @__PURE__ */ new Map();
+		for (let t of c) {
+			let n = e.get(t.refUID) ?? [];
+			n.push(t), e.set(t.refUID, n);
+		}
+		let t = [];
+		for (let n of a) {
+			let r = d(e.get(n.id) ?? []);
+			t.push({
+				versionUid: n.id,
+				at: n.timeCreated,
+				data: Oe(r)
+			});
+		}
+		l = ke(t);
+	}
+	return {
+		latestVersionUid: o,
+		changelog: je(l, r)
+	};
+}
+//#endregion
+//#region src/cache/types.ts
+function Ne(e) {
+	return !e || e === "data" ? "" : e === "data+changelog" ? "i1" : "i2";
+}
+function W(e) {
+	let t = e?.expandRelations !== !1, n = e?.hydrateStorage !== !1, r = `e${+!!t}-h${+!!n}`, i = Ne(e?.include);
+	return i ? `${r}-${i}-${e?.changelog?.granularity === "property" ? "gp" : "gv"}-${typeof e?.changelog?.since == "number" ? `s${e.changelog.since}` : "s0"}-${typeof e?.changelog?.limit == "number" ? `l${e.changelog.limit}` : "l0"}` : r;
+}
+function Pe(e) {
+	return e.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 120);
+}
+//#endregion
+//#region src/cache/FileCache.ts
+var Fe = class {
+	cacheDir;
+	config;
+	constructor(e) {
+		this.cacheDir = e.cacheDir, this.config = e, this.ensureCacheDir().catch((e) => {
+			console.error("Failed to create query cache directory:", e);
+		});
+	}
+	async ensureCacheDir() {
+		try {
+			await h.mkdir(this.cacheDir, { recursive: !0 });
+		} catch (e) {
+			if (e.code !== "EEXIST") throw e;
+		}
+	}
+	async ensureItemsDir() {
+		try {
+			await h.mkdir(g(this.cacheDir, "items"), { recursive: !0 });
+		} catch (e) {
+			if (e.code !== "EEXIST") throw e;
+		}
+	}
+	collectionPath(e) {
+		return g(this.cacheDir, `${e}.json`);
+	}
+	itemPath(e, t) {
+		let n = Pe(e);
+		return g(this.cacheDir, "items", `${n}-${t}.json`);
+	}
+	async getCollection(e) {
+		try {
+			let t = await h.readFile(this.collectionPath(e), "utf-8"), n = JSON.parse(t);
+			return Math.floor(Date.now() / 1e3) - n.lastUpdated > this.config.ttl ? (await this.clearCollection(e), null) : n;
+		} catch (t) {
+			return t.code === "ENOENT" || console.error(`Error reading query collection cache for ${e}:`, t), null;
+		}
+	}
+	async setCollection(e, t) {
+		try {
+			await this.ensureCacheDir(), await h.writeFile(this.collectionPath(e), JSON.stringify(t, null, 2), "utf-8");
+		} catch (t) {
+			console.error(`Error writing query collection cache for ${e}:`, t);
+		}
+	}
+	async getItem(e, t) {
+		try {
+			let n = await h.readFile(this.itemPath(e, t), "utf-8"), r = JSON.parse(n);
+			return Math.floor(Date.now() / 1e3) - r.lastUpdated > this.config.ttl ? (await this.clearItem(e, t), null) : r;
+		} catch (t) {
+			return t.code === "ENOENT" || console.error(`Error reading query item cache for ${e}:`, t), null;
+		}
+	}
+	async setItem(e) {
+		try {
+			await this.ensureItemsDir(), await h.writeFile(this.itemPath(e.record.seedUid, e.optionsKey), JSON.stringify(e, null, 2), "utf-8");
+		} catch (t) {
+			console.error(`Error writing query item cache for ${e.record.seedUid}:`, t);
+		}
+	}
+	async clearCollection(e) {
+		try {
+			await h.unlink(this.collectionPath(e));
+		} catch (t) {
+			t.code !== "ENOENT" && console.error(`Error clearing query collection cache for ${e}:`, t);
+		}
+	}
+	async clearItem(e, t) {
+		try {
+			await h.unlink(this.itemPath(e, t));
+		} catch (t) {
+			t.code !== "ENOENT" && console.error(`Error clearing query item cache for ${e}:`, t);
+		}
+	}
+	async clearAll() {
+		try {
+			let e = await h.readdir(this.cacheDir);
+			for (let t of e) t.endsWith(".json") && await h.unlink(g(this.cacheDir, t));
+			let t = g(this.cacheDir, "items");
+			try {
+				let e = await h.readdir(t);
+				for (let n of e) n.endsWith(".json") && await h.unlink(g(t, n));
+			} catch {}
+		} catch (e) {
+			console.error("Error clearing all query caches:", e);
+		}
+	}
+};
+//#endregion
+//#region src/cache/etag.ts
+function Ie(e) {
+	return `"${ee("md5").update(e).digest("hex").substring(0, 16)}"`;
+}
+function Le(e, t, n) {
+	return Ie(`${e}-data-${t}-${n}`);
+}
+function Re(e, t, n, r) {
+	return Ie(`${e}-${t}-${n}-${r}`);
+}
+//#endregion
+//#region src/cache/MemoryCache.ts
+var ze = class {
+	collectionCache = /* @__PURE__ */ new Map();
+	itemCache = /* @__PURE__ */ new Map();
+	config;
+	refreshLocks = /* @__PURE__ */ new Map();
+	constructor(e) {
+		this.config = e;
+	}
+	itemKey(e, t) {
+		return `${e}:${t}`;
+	}
+	getCollection(e) {
+		let t = this.collectionCache.get(e);
+		return t ? Math.floor(Date.now() / 1e3) - t.lastUpdated > this.config.ttl ? (this.collectionCache.delete(e), null) : t : null;
+	}
+	setCollection(e, t) {
+		let n = Math.floor(Date.now() / 1e3), r = 0, i = "";
+		for (let e of t) e.timeCreated && e.timeCreated > r && (r = e.timeCreated, i = e.seedUid);
+		r === 0 && (r = n);
+		let a = Le(e, r, t.length), o = {
+			items: t.map((e) => ({
+				...e,
+				data: { ...e.data }
+			})),
+			lastProcessedTimestamp: r,
+			lastProcessedItemId: i,
+			lastUpdated: n,
+			etag: a
+		};
+		return this.collectionCache.set(e, o), o;
+	}
+	getItem(e, t) {
+		let n = this.itemCache.get(this.itemKey(e, t));
+		return n ? Math.floor(Date.now() / 1e3) - n.lastUpdated > this.config.ttl ? (this.itemCache.delete(this.itemKey(e, t)), null) : n : null;
+	}
+	setItem(e, t) {
+		let n = Math.floor(Date.now() / 1e3), r = Re(e.seedUid, e.versionUid, e.timeCreated, t), i = {
+			...e,
+			data: { ...e.data }
+		};
+		e.changelog && (i.changelog = [...e.changelog]);
+		let a = {
+			record: i,
+			lastUpdated: n,
+			etag: r,
+			optionsKey: t
+		};
+		return this.itemCache.set(this.itemKey(e.seedUid, t), a), a;
+	}
+	clearCollection(e) {
+		this.collectionCache.delete(e);
+	}
+	clearItem(e, t) {
+		if (t) {
+			this.itemCache.delete(this.itemKey(e, t));
+			return;
+		}
+		for (let t of this.itemCache.keys()) t.startsWith(`${e}:`) && this.itemCache.delete(t);
+	}
+	clearAll() {
+		this.collectionCache.clear(), this.itemCache.clear();
+	}
+	async withRefreshLock(e, t) {
+		let n = this.refreshLocks.get(e);
+		if (n) return n;
+		let r = (async () => {
+			try {
+				return await t();
+			} finally {
+				this.refreshLocks.delete(e);
+			}
+		})();
+		return this.refreshLocks.set(e, r), r;
+	}
+	updateConfig(e) {
+		this.config = {
+			...this.config,
+			...e
+		};
+	}
+	getStats() {
+		return {
+			collectionCount: this.collectionCache.size,
+			itemCount: this.itemCache.size,
+			activeLocks: this.refreshLocks.size
+		};
+	}
+}, G = class {
+	memoryCache;
+	fileCache;
+	config;
+	stats = {
+		hits: 0,
+		misses: 0,
+		refreshes: 0,
+		errors: 0
+	};
+	constructor(e) {
+		this.config = e, this.memoryCache = new ze(e), this.fileCache = new Fe(e);
+	}
+	get enabled() {
+		return this.config.enabled;
+	}
+	getConfig() {
+		return { ...this.config };
+	}
+	async getCollection(e) {
+		if (!this.config.enabled) return null;
+		try {
+			let t = this.memoryCache.getCollection(e);
+			return t ? (this.stats.hits++, t) : (t = await this.fileCache.getCollection(e), t ? (this.memoryCache.setCollection(e, t.items), this.stats.hits++, t) : (this.stats.misses++, null));
+		} catch (t) {
+			return console.error(`Error getting query collection cache for ${e}:`, t), this.stats.errors++, null;
+		}
+	}
+	async setCollection(e, t) {
+		if (!this.config.enabled) return null;
+		try {
+			let n = this.memoryCache.setCollection(e, t);
+			return await this.fileCache.setCollection(e, n), n;
+		} catch (t) {
+			return console.error(`Error setting query collection cache for ${e}:`, t), this.stats.errors++, null;
+		}
+	}
+	async getItem(e, t) {
+		if (!this.config.enabled) return null;
+		try {
+			let n = this.memoryCache.getItem(e, t);
+			return n ? (this.stats.hits++, n) : (n = await this.fileCache.getItem(e, t), n ? (this.memoryCache.setItem(n.record, t), this.stats.hits++, n) : (this.stats.misses++, null));
+		} catch (t) {
+			return console.error(`Error getting query item cache for ${e}:`, t), this.stats.errors++, null;
+		}
+	}
+	async setItem(e, t) {
+		if (!this.config.enabled) return null;
+		try {
+			let n = this.memoryCache.setItem(e, t);
+			return await this.fileCache.setItem(n), n;
+		} catch (t) {
+			return console.error(`Error setting query item cache for ${e.seedUid}:`, t), this.stats.errors++, null;
+		}
+	}
+	async writeThroughItems(e, t) {
+		if (this.config.enabled) for (let n of e) await this.setItem(n, t);
+	}
+	async clearCollection(e) {
+		this.memoryCache.clearCollection(e), await this.fileCache.clearCollection(e);
+	}
+	async clearAll() {
+		this.memoryCache.clearAll(), await this.fileCache.clearAll();
+	}
+	async withRefreshLock(e, t) {
+		return this.memoryCache.withRefreshLock(e, t);
+	}
+	mergeRecords(e, t) {
+		let n = /* @__PURE__ */ new Map();
+		for (let t of e) t.seedUid && n.set(t.seedUid, t);
+		for (let e of t) e.seedUid ? n.set(e.seedUid, e) : n.set(`temp-${Date.now()}-${Math.random()}`, e);
+		let r = Array.from(n.values());
+		return r.sort((e, t) => (t.timeCreated || 0) - (e.timeCreated || 0)), r;
+	}
+	filterNewRecords(e, t) {
+		return e.filter((e) => e.timeCreated && e.timeCreated > t);
+	}
+	updateConfig(e) {
+		this.config = {
+			...this.config,
+			...e
+		}, this.memoryCache.updateConfig(this.config);
+	}
+	getStats() {
+		return {
+			...this.stats,
+			memoryStats: this.memoryCache.getStats()
+		};
+	}
+	resetStats() {
+		this.stats = {
+			hits: 0,
+			misses: 0,
+			refreshes: 0,
+			errors: 0
+		};
+	}
+};
+//#endregion
+//#region src/cache/config.ts
+function K() {
+	let e = parseInt(process.env.CACHE_TTL || "3600", 10), t = process.env.CACHE_DIR || "./cache", n = process.env.CACHE_ENABLED === "false" || process.env.CACHE_ENABLED === "0" || process.env.CACHE_ENABLED === "no" || process.env.CACHE_ENABLED === "off", r = process.env.CACHE_ENABLED === "true" || process.env.CACHE_ENABLED === "1" || process.env.CACHE_ENABLED === "yes", i = process.env.NODE_ENV === "development", a;
+	a = n ? !1 : r ? !0 : !i;
+	let o = process.env.CACHE_BACKGROUND_REFRESH === "true", s = parseInt(process.env.CACHE_REFRESH_INTERVAL || "300", 10);
+	return {
+		ttl: e,
+		cacheDir: t,
+		enabled: a,
+		backgroundRefresh: o,
+		refreshInterval: s
+	};
+}
+//#endregion
+//#region src/cache/index.ts
+var q = null;
+function J() {
+	return q ||= new G(K()), q;
+}
+function Be() {
+	q = null;
+}
+function Ve(e) {
+	return new G({
+		...K(),
+		...e
+	});
+}
+//#endregion
+//#region src/source/registry.ts
+var Y = null;
+function He(e) {
+	if (e.kind !== "local") throw Error("[query] registerLocalQuerySource expects a source with kind: \"local\"");
+	Y = e;
+}
+function Ue() {
+	Y = null;
+}
+function We() {
+	return Y;
+}
+function Ge() {
+	return Y != null;
+}
+//#endregion
+//#region src/source/resolve.ts
+function X(e = "remote") {
+	if (e === "remote") return {
+		mode: "remote",
+		dataSource: I(),
+		useQueryCache: !0
+	};
+	let t = We();
+	if (e === "local") {
+		if (!t) throw Error("[query] source: \"local\" requires registerLocalQuerySource(...) (e.g. SDK DB ready)");
+		return {
+			mode: "local",
+			dataSource: t,
+			useQueryCache: !1
+		};
+	}
+	return t ? {
+		mode: "auto",
+		dataSource: t,
+		useQueryCache: !1
+	} : {
+		mode: "auto",
+		dataSource: I(),
+		useQueryCache: !0
+	};
+}
+function Z(e) {
+	return e ?? "remote";
+}
+//#endregion
+//#region src/api.ts
+function Q(e, t) {
+	return !t || e?.cache === !1 ? !1 : J().enabled;
+}
+function Ke(e) {
+	return e === "data+changelog" || e === "changelog";
+}
+function qe(e) {
+	return e !== "changelog";
+}
+async function $(e, t, n, r, i) {
+	return V(e, await i.listSeedsBySchemaName(e, {
+		limit: t,
+		skip: n
+	}), r, i);
+}
+async function Je(e, t, n) {
+	let r = await n(t);
+	if (e !== "auto" || t.kind !== "local") return {
+		items: r,
+		dataSource: t,
+		useQueryCache: t.kind === "remote"
+	};
+	if (r.length > 0) return {
+		items: r,
+		dataSource: t,
+		useQueryCache: !1
+	};
+	let i = I();
+	return {
+		items: await n(i),
+		dataSource: i,
+		useQueryCache: !0
+	};
+}
+async function Ye(e, n) {
+	await t();
+	let r = n?.limit ?? 100, i = n?.skip ?? 0, a = Z(n?.source), o = X(a), s = W(n), c = (t) => $(e, r, i, n, t);
+	if (Q(n, o.useQueryCache) && i === 0 && o.dataSource.kind === "remote") {
+		let t = J();
+		return t.withRefreshLock(e, async () => {
+			let a = await t.getCollection(e), c, l;
+			if (a) {
+				let i = await $(e, r, 0, n, o.dataSource), s = t.filterNewRecords(i, a.lastProcessedTimestamp);
+				c = s.length > 0 ? t.mergeRecords(a.items, s).slice(0, r) : a.items.slice(0, r);
+			} else c = await $(e, r, 0, n, o.dataSource);
+			return l = (await t.setCollection(e, c))?.etag, await t.writeThroughItems(c, s), {
+				items: c,
+				limit: r,
+				skip: i,
+				etag: l
+			};
+		});
+	}
+	let { items: l, dataSource: u, useQueryCache: d } = await Je(a, o.dataSource, (e) => c(e));
+	return Q(n, d) && u.kind === "remote" && await J().writeThroughItems(l, s), {
+		items: l,
+		limit: r,
+		skip: i
+	};
+}
+async function Xe(e, n) {
+	if (await t(), !e || typeof e != "string" || e.trim() === "") return null;
+	let r = e.trim(), i = n?.include ?? "data", a = Z(n?.source), o = X(a), s = W(n), c = o.dataSource, l = o.useQueryCache;
+	if (Q(n, l) && c.kind === "remote") {
+		let e = await J().getItem(r, s);
+		if (e) return e.record;
+	}
+	let u = await c.getSeedByUid(r);
+	if (!u && a === "auto" && c.kind === "local" && (c = I(), l = !0, u = await c.getSeedByUid(r), Q(n, l))) {
+		let e = await J().getItem(r, s);
+		if (e) return e.record;
+	}
+	if (!u) return null;
+	let d = u.schema?.schemaNames?.[0]?.name;
+	if (!d) return null;
+	let f = null;
+	if (!Ke(i)) f = (await V(d, [u], n, c))[0] ?? null;
+	else {
+		let { latestVersionUid: e, changelog: t } = await Me(r, n, c);
+		if (qe(i)) {
+			let e = (await V(d, [u], n, c))[0];
+			f = e ? {
+				...e,
+				changelog: t
+			} : null;
+		} else f = {
+			seedUid: r,
+			schemaName: d,
+			attester: u.attester,
+			timeCreated: u.timeCreated,
+			versionUid: e,
+			data: {},
+			changelog: t
+		};
+	}
+	return f && Q(n, l) && c.kind === "remote" && await J().setItem(f, s), f;
+}
+async function Ze(e, n, r, i) {
+	await t();
+	let a = Z(i?.source), { items: o, dataSource: s, useQueryCache: c } = await Je(a, X(a).dataSource, async (t) => V(e, await t.listSeedsBySchemaNameForMonth(e, n, r), i, t));
+	if (Q(i, c) && s.kind === "remote") {
+		let e = W(i);
+		await J().writeThroughItems(o, e);
+	}
+	return o;
+}
+//#endregion
+export { G as CacheManager, r as DEFAULT_ARWEAVE_HOST, re as FEED_RICH_BODY_STORAGE_SCHEMAS, S as RICH_BODY_STORAGE_SCHEMAS, je as applyChangelogFilters, Me as assembleSeedChangelog, V as assembleSeeds, W as buildAssembleOptionsKey, Oe as buildFlatSnapshotFromProperties, H as changelogValuesEqual, Ue as clearLocalQuerySource, Ve as createQueryCacheManager, P as createRemoteQueryDataSource, U as decodePropertyAttestation, Ae as diffPropertyAttestations, ke as diffVersionSnapshots, x as enrichImageSeedClone, ne as enrichImageSeedCloneForFeed, oe as feedRichBodyModelPriority, _ as getArweaveUrlForTransaction, se as getFeedFieldStorageModels, ce as getFeedListElementStorageModels, D as getFieldStorageModels, O as getListElementStorageModels, J as getQueryCacheManager, We as getRegisteredLocalQuerySource, I as getRemoteQueryDataSource, Xe as getSeed, Ge as hasLocalQuerySource, _e as hydrateArweaveRichTextInFeedItems, j as hydrateArweaveRichTextInItems, t as initializeQueryPlatform, pe as isArweaveTransactionGatewayUrl, ae as isFeedRichBodyStorageSchema, n as isQueryPlatformInitialized, T as isRichBodyStorageSchema, K as loadQueryCacheConfig, Z as normalizeSourceMode, M as parseEasPropertyMetadata, ve as parseEasPropertyMetadataForFeed, N as parseEasRelationPropertyName, v as publicListRelationPropertyKey, Ye as queryBySchema, Ze as queryBySchemaForMonth, He as registerLocalQuerySource, Be as resetQueryCacheManager, X as resolveQuerySource, E as richBodyModelPriority, le as setFeedFieldStorageModel, ue as setFeedListElementStorageModels, k as setFieldStorageModel, A as setListElementStorageModels, y as stripListRelationStorageAliasesForPublicKey, e as teardownQueryPlatform, b as tryCoerceJsonStringArray };
+
+//# sourceMappingURL=index.js.map