@seedprotocol/query 0.7.1 → 0.7.2

package/dist/src-CBgjwvGT.js

@@ -0,0 +1,1207 @@
+import { i as e, t } from "./types-DHRoT30t.js";
+import { BaseArweaveClient as n, isKnownArweaveGatewayHostname as r } from "@seedprotocol/arweave";
+import { EasClient as i, GET_SEEDS_LEAN as a, getAttestationChangesSince as o, getItemPropertiesFromEas as s, getItemVersionsFromEas as c, getSeedsBySchemaName as l, getSeedsByUidsFromEas as u, pickLatestPropertyAttestationsByRefAndSchema as d, setSchemaUidForSchemaDefinition as f, withExcludeRevokedFilter as p } from "@seedprotocol/eas";
+import m from "pluralize";
+import { sha256 as h } from "@noble/hashes/sha256";
+import { bytesToHex as g, utf8ToBytes as _ } from "@noble/hashes/utils";
+//#region src/arweaveUrl.ts
+function v(e) {
+	return `https://${n.getHost()}/${e}`;
+}
+//#endregion
+//#region src/listRelationKey.ts
+var ee = /^(.+?)([A-Z][a-zA-Z]+)Ids$/;
+function y(e) {
+	let t = ee.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 b(e, t) {
+	for (let n of Object.keys(e)) n !== t && y(n) === t && delete e[n];
+}
+function x(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 te(e) {
+	let t = e.storageTransactionId ?? e.storage_transaction_id;
+	if (t && typeof t == "string" && t.trim()) try {
+		e.arweaveUrl = v(t.trim());
+	} catch {}
+}
+var ne = te, S = /* @__PURE__ */ new Set([
+	"html",
+	"file",
+	"json"
+]), re = S, ie = "_feedFieldStorageModels", ae = "_feedListElementStorageModels";
+function C(e) {
+	return e.trim().toLowerCase();
+}
+function w(e) {
+	return S.has(C(e));
+}
+var oe = w;
+function se(e) {
+	let t = C(e);
+	return t === "html" ? 0 : t === "file" ? 1 : t === "json" ? 2 : 99;
+}
+var ce = se;
+function T(e) {
+	let t = e[ie];
+	if (typeof t == "object" && t && !Array.isArray(t)) return t;
+}
+var le = T;
+function E(e) {
+	let t = e[ae];
+	if (typeof t == "object" && t && !Array.isArray(t)) return t;
+}
+var ue = E;
+function D(e, t, n) {
+	let r = C(n), i = T(e);
+	i || (i = {}, e[ie] = i), i[t] = r;
+}
+var de = D;
+function fe(e, t, n) {
+	let r = E(e);
+	r || (r = {}, e[ae] = r), r[t] = n.map(C);
+}
+var pe = fe, me = [
+	"html",
+	"Html",
+	"body",
+	"Body",
+	"content",
+	"Content"
+], he = 8e6;
+function ge(e) {
+	let t = e.trim();
+	if (!t.startsWith("http://") && !t.startsWith("https://")) return !1;
+	try {
+		let e = new URL(t), i = e.hostname.toLowerCase();
+		if (i !== n.getHost().toLowerCase() && !r(i)) return !1;
+		let a = e.pathname.replace(/^\//, "").split("/").filter(Boolean);
+		if (a.length !== 1) return !1;
+		let o = a[0];
+		return /^[A-Za-z0-9_-]{43}$/.test(o);
+	} catch {
+		return !1;
+	}
+}
+async function _e(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 > he) return null;
+		let i = new TextDecoder("utf-8", { fatal: !1 }).decode(r);
+		return i.length === 0 || i.includes("\0") ? null : i;
+	} catch {
+		return null;
+	}
+}
+var ve = 32e6, O = /* @__PURE__ */ new Map(), k = 0, A = /* @__PURE__ */ new Map();
+function ye() {
+	O.clear(), k = 0, A.clear();
+}
+function be(e, t) {
+	if (!(t.length > ve)) {
+		O.set(e, t), k += t.length;
+		for (let [e, t] of O) {
+			if (k <= ve) break;
+			O.delete(e), k -= t.length;
+		}
+	}
+}
+async function xe(e) {
+	let t = new URL(e.trim()).pathname.replace(/^\//, ""), n = O.get(t);
+	if (n !== void 0) return O.delete(t), O.set(t, n), n;
+	let r = A.get(t);
+	if (r) return r;
+	let i = _e(e).then((e) => (e !== null && A.get(t) === i && be(t, e), e)).finally(() => {
+		A.get(t) === i && A.delete(t);
+	});
+	return A.set(t, i), i;
+}
+async function Se(e, t, n) {
+	if (n) try {
+		let r = await n({
+			propertyName: e,
+			value: t
+		});
+		if (r != null && r.length > 0) return r;
+	} catch {}
+	return ge(t) ? xe(t) : null;
+}
+var Ce = 8;
+async function we(e, t) {
+	let n = 0;
+	await Promise.all(Array.from({ length: Math.min(t, e.length) }, async () => {
+		for (; n < e.length;) await e[n++]();
+	}));
+}
+async function j(e, t) {
+	let n = t?.readStorageBody, r = [];
+	for (let t of e) {
+		let e = /* @__PURE__ */ new Set([...me]), i = T(t);
+		if (i) for (let [t, n] of Object.entries(i)) w(n) && e.add(t);
+		for (let i of e) {
+			let e = t[i];
+			typeof e == "string" && e.trim() !== "" && r.push(async () => {
+				let r = await Se(i, e, n);
+				r !== null && (t[i] = r);
+			});
+		}
+		let a = E(t);
+		if (a) for (let [e, i] of Object.entries(a)) {
+			let a = t[e];
+			if (!Array.isArray(a)) continue;
+			let o = Math.min(i.length, a.length);
+			for (let t = 0; t < o; t++) {
+				if (!w(i[t])) continue;
+				let o = a[t];
+				typeof o == "string" && r.push(async () => {
+					let r = await Se(e, o, n);
+					r !== null && (a[t] = r);
+				});
+			}
+		}
+	}
+	await we(r, Ce);
+}
+var Te = 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 Ee = 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: i ? t.endsWith("s") ? t : m(t) : t,
+		modelName: n,
+		isList: i
+	};
+}
+//#endregion
+//#region src/source/remote.ts
+function De(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 Oe() {
+	return {
+		kind: "remote",
+		async getSeedByUid(e) {
+			let [t] = await u({ uids: [e] });
+			return t ?? null;
+		},
+		async listSeedsBySchemaName(e, t) {
+			return await l(e, t.limit, t.skip);
+		},
+		async listSeedsByUidPrefix(e, t, n) {
+			return await l(e, n.limit, n.skip, { uidPrefix: t });
+		},
+		async listSeedsBySchemaNameForMonth(e, t, n) {
+			let { startTs: r, endTs: o } = De(t, n), s = p({ AND: [{ schema: { is: { schemaNames: { some: { name: { equals: e } } } } } }, { timeCreated: {
+				gte: r,
+				lt: o
+			} }] }), { itemSeeds: c } = await i.getEasClient().request(a, {
+				where: s,
+				take: 1e3,
+				skip: 0
+			});
+			return (c ?? []).map((t) => ({
+				...t,
+				schema: { schemaNames: [{ name: e }] }
+			}));
+		},
+		async getVersionsForSeed(e) {
+			return await c({ seedUids: [e] });
+		},
+		async getVersionsForSeeds(e, t) {
+			return e.length === 0 ? [] : await c({
+				seedUids: e,
+				excludeRevoked: !t?.includeRevoked
+			});
+		},
+		async getPropertiesForVersionUids(e) {
+			return e.length === 0 ? [] : await s({ versionUids: e });
+		},
+		async getSeedsByUids(e) {
+			return e.length === 0 ? [] : await u({ uids: e });
+		},
+		async listChangesSince(e) {
+			return o(e);
+		}
+	};
+}
+var ke = null;
+function P() {
+	return ke ||= Oe(), ke;
+}
+//#endregion
+//#region src/assembleSeeds.ts
+var F = "image", I = ["0x0000000000000000000000000000000000000000000000000000000000000020"], Ae = /* @__PURE__ */ new Set([
+	"seedUid",
+	"SeedUid",
+	"timeCreated",
+	"attester",
+	"Attester",
+	"storage_transaction_id",
+	"storage_provider_transaction_id",
+	"storageTransactionId",
+	"storageProviderTransactionId",
+	"versionUid"
+]), L = (e) => e.replace(/_([a-z])/g, (e, t) => t.toUpperCase());
+function je() {
+	return {
+		seedUidToModelType: /* @__PURE__ */ new Map(),
+		relatedSeedUids: /* @__PURE__ */ new Set(),
+		relatedSeedUidsBySeedUid: /* @__PURE__ */ new Map(),
+		versionUidToSeedUid: /* @__PURE__ */ new Map(),
+		assembledItems: /* @__PURE__ */ new Map(),
+		versionsBySeedUid: /* @__PURE__ */ new Map(),
+		latestVersionUidsBySeedUid: /* @__PURE__ */ new Map(),
+		droppedSeedUids: /* @__PURE__ */ new Set()
+	};
+}
+function R(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);
+}
+function Me(e, t, n) {
+	e.relatedSeedUids.add(n);
+	let r = e.versionUidToSeedUid.get(t.refUID);
+	if (!r) return;
+	let i = e.relatedSeedUidsBySeedUid.get(r) ?? /* @__PURE__ */ new Set();
+	i.add(n), e.relatedSeedUidsBySeedUid.set(r, i);
+}
+async function Ne(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((n) => {
+				I.includes(n) || Me(e, t, n);
+			});
+		} else I.includes(r.value) || Me(e, t, 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 = L(i);
+	h !== i && (m[h] = d), e.assembledItems.set(p, m);
+}
+async function Pe(e, t, n, r = {}) {
+	let i = [];
+	for (let n = 0; n < t.length; n++) {
+		let r = t[n];
+		if (!r) continue;
+		i.push(r.id);
+		let a = r.schema?.schemaNames?.[0]?.name ?? "unknown";
+		e.seedUidToModelType.set(r.id, a), e.assembledItems.has(r.id) || e.assembledItems.set(r.id, {
+			seedUid: r.id,
+			timeCreated: r.timeCreated,
+			attester: r.attester
+		});
+	}
+	if (i.length === 0) return;
+	let a = new Set(i), o = r.versions ? r.versions.filter((e) => a.has(e.refUID)) : await n.getVersionsForSeeds(i, { includeRevoked: !0 }), s = o.filter((e) => e.revoked !== !0);
+	if (r.dropSeedsWithOnlyRevokedVersions) {
+		let t = new Set(s.map((e) => e.refUID));
+		for (let n of o) {
+			let r = n.refUID;
+			!t.has(r) && a.has(r) && (e.assembledItems.delete(r), e.seedUidToModelType.delete(r), e.droppedSeedUids.add(r));
+		}
+	}
+	for (let t = 0; t < s.length; t++) {
+		let n = s[t], r = n.refUID;
+		e.versionUidToSeedUid.set(n.id, r);
+		let i = e.versionsBySeedUid.get(r) || [];
+		e.versionsBySeedUid.set(r, [...i, n]);
+	}
+	let c = [];
+	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 && (c.push(r.id), e.latestVersionUidsBySeedUid.set(t, r.id));
+	}
+	if (c.length === 0) return;
+	let l = await n.getPropertiesForVersionUids(c), u = d(l);
+	for (let t = 0; t < u.length; t++) await Ne(e, u[t]);
+}
+function Fe(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("_") && !Ae.has(e));
+		for (let r of n) {
+			let n = t[r], i = x(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" && !I.includes(t) && e.assembledItems.has(t))) continue;
+				let a = [], o = [], s = !1;
+				for (let t of i) {
+					if (typeof t != "string" || I.includes(t)) {
+						a.push(String(t)), o.push("unknown");
+						continue;
+					}
+					let n = e.seedUidToModelType.get(t) ?? "unknown";
+					if (n === F) {
+						a.push(t), o.push(F);
+						continue;
+					}
+					let r = e.assembledItems.get(t), i = r?.storageTransactionId ?? r?.storage_transaction_id;
+					if (i && typeof i == "string" && i.trim()) try {
+						a.push(v(i)), o.push(n), s = !0;
+					} catch {
+						a.push(t), o.push(n);
+					}
+					else a.push(t), o.push(n);
+				}
+				if (s) {
+					let e = y(r);
+					if (t[e] = a, fe(t, e, o), b(t, e), e !== r) {
+						delete t[r];
+						let e = L(r);
+						e !== r && delete t[e];
+					}
+				}
+			} else if (typeof n == "string") {
+				if (I.includes(n) || !e.assembledItems.has(n)) continue;
+				let i = e.assembledItems.get(n);
+				if (e.seedUidToModelType.get(n) === F) 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] = v(a);
+					let o = e.seedUidToModelType.get(n) ?? "unknown";
+					D(t, i, o);
+					let s = L(i);
+					if (s !== i && D(t, s, o), i !== r) {
+						delete t[r];
+						let e = L(r);
+						e !== r && delete t[e];
+					}
+				} catch {}
+			}
+		}
+	}
+}
+function Ie(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("_") && !Ae.has(e));
+		for (let r of n) {
+			let n = t[r], i = x(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" || I.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) === F) {
+					let e = { ...n };
+					R(e, t), e.schemaName = F, te(e), s.push(e), c = !0;
+					continue;
+				}
+				if (r && typeof r == "string" && r.trim()) {
+					s.push(t);
+					continue;
+				}
+				let i = { ...n };
+				R(i, t), s.push(i), c = !0;
+			}
+			if (c) {
+				let e = a ? y(r) : r.endsWith("_id") ? r.replace(/_id$/, "") : r;
+				if (t[e] = a ? s : s[0], b(t, e), e !== r) {
+					delete t[r];
+					let e = L(r);
+					e !== r && delete t[e];
+				}
+			}
+		}
+	}
+}
+function Le(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), R(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
+		};
+	});
+}
+function Re(e, t) {
+	let n = [t, ...e.relatedSeedUidsBySeedUid.get(t) ?? []], r = n.map((t) => e.latestVersionUidsBySeedUid.get(t)).filter((e) => !!e);
+	return {
+		refUIDs: [...n, ...r],
+		ids: n
+	};
+}
+async function z(e, t, n, r = P(), i) {
+	let a = n?.expandRelations !== !1, o = n?.hydrateStorage !== !1, s = je();
+	await Pe(s, t, r, {
+		dropSeedsWithOnlyRevokedVersions: !0,
+		versions: i?.versions
+	});
+	let c = Array.from(s.relatedSeedUids).filter((e) => !s.assembledItems.has(e) && !s.droppedSeedUids.has(e));
+	if (c.length > 0) {
+		let [e, t] = await Promise.all([r.getSeedsByUids(c), r.getVersionsForSeeds(c, { includeRevoked: !0 })]);
+		await Pe(s, e, r, { versions: t });
+	}
+	Fe(s, e), Ie(s, e, a);
+	let l = Le(s, e);
+	return o && await j(l.map((e) => e.data), r.readStorageBody ? { readStorageBody: r.readStorageBody.bind(r) } : void 0), {
+		records: l,
+		dependencies: new Map(l.map((e) => [e.seedUid, Re(s, e.seedUid)]))
+	};
+}
+async function ze(e, t, n, r = P()) {
+	return (await z(e, t, n, r)).records;
+}
+//#endregion
+//#region src/changelog.ts
+var Be = (e) => e.replace(/_([a-z])/g, (e, t) => t.toUpperCase());
+function B(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 V(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 = Be(r);
+	return {
+		propertyName: r,
+		value: l,
+		camelName: u === r ? void 0 : u
+	};
+}
+function Ve(e) {
+	let t = {};
+	for (let n of e) {
+		let e = V(n);
+		e && (t[e.propertyName] = e.value, e.camelName && (t[e.camelName] = e.value));
+	}
+	return t;
+}
+function He(e) {
+	let t = [], n = {};
+	for (let r of e) {
+		let e = r.data, i = /* @__PURE__ */ new Set([...Object.keys(n), ...Object.keys(e)]), a = [];
+		for (let t of i) B(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 Ue(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 = V(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;
+		B(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 We(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 Ge(e, t, n = P()) {
+	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 = Ue(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 = e.get(n.id) ?? [], i = d(r);
+			t.push({
+				versionUid: n.id,
+				at: n.timeCreated,
+				data: Ve(i)
+			});
+		}
+		l = He(t);
+	}
+	return {
+		latestVersionUid: o,
+		changelog: We(l, r)
+	};
+}
+//#endregion
+//#region src/cache/etag.ts
+function Ke(e) {
+	return `"${g(h(_(e))).substring(0, 16)}"`;
+}
+function qe(e, t, n) {
+	return Ke(`${e}-${t}-${n.join(",")}`);
+}
+function Je(e, t) {
+	return Ke(`${t}-${Ye(e)}`);
+}
+function Ye(e) {
+	return JSON.stringify(e, (e, t) => t && typeof t == "object" && !Array.isArray(t) ? Object.fromEntries(Object.keys(t).sort().map((e) => [e, t[e]])) : t);
+}
+//#endregion
+//#region src/cache/config.ts
+function Xe() {
+	return globalThis.process?.env ?? {};
+}
+function Ze() {
+	return Xe().NODE_ENV !== "production";
+}
+function H() {
+	let e = Xe(), t = parseInt(e.CACHE_TTL || "3600", 10), n = e.CACHE_DIR || "./cache", r = e.CACHE_ENABLED === "false" || e.CACHE_ENABLED === "0" || e.CACHE_ENABLED === "no" || e.CACHE_ENABLED === "off", i = e.CACHE_ENABLED === "true" || e.CACHE_ENABLED === "1" || e.CACHE_ENABLED === "yes", a = e.NODE_ENV === "development", o;
+	o = r ? !1 : i ? !0 : !a;
+	let s = e.CACHE_BACKGROUND_REFRESH === "true", c = parseInt(e.CACHE_REFRESH_INTERVAL || "300", 10);
+	return {
+		ttl: t,
+		cacheDir: n,
+		enabled: o,
+		backgroundRefresh: s,
+		refreshInterval: c,
+		freezeRecords: Ze()
+	};
+}
+//#endregion
+//#region src/cache/freeze.ts
+function U(e) {
+	if (typeof e != "object" || !e || Object.isFrozen(e) || ArrayBuffer.isView(e)) return e;
+	for (let t of Object.values(e)) U(t);
+	return Object.freeze(e);
+}
+//#endregion
+//#region src/cache/MemoryCache.ts
+var Qe = class {
+	collectionCache = /* @__PURE__ */ new Map();
+	itemCache = /* @__PURE__ */ new Map();
+	config;
+	refreshLocks = /* @__PURE__ */ new Map();
+	constructor(e) {
+		this.config = e;
+	}
+	collectionKey(e, t) {
+		return `${e}\n${t}`;
+	}
+	itemKey(e, t) {
+		return `${e}:${t}`;
+	}
+	get freezeRecords() {
+		return this.config.freezeRecords ?? Ze();
+	}
+	expired(e) {
+		return Math.floor(Date.now() / 1e3) - e > this.config.ttl;
+	}
+	getCollection(e, t) {
+		let n = this.collectionKey(e, t), r = this.collectionCache.get(n);
+		return r ? this.expired(r.lastUpdated) ? (this.collectionCache.delete(n), null) : r : null;
+	}
+	setCollection(e, t, n) {
+		if (this.freezeRecords) for (let e of n.items) U(e);
+		this.collectionCache.set(this.collectionKey(e, t), n);
+	}
+	getItem(e, t) {
+		let n = this.itemKey(e, t), r = this.itemCache.get(n);
+		return r ? this.expired(r.lastUpdated) ? (this.itemCache.delete(n), null) : r : null;
+	}
+	setItem(e) {
+		this.freezeRecords && U(e.record), this.itemCache.set(this.itemKey(e.record.seedUid, e.optionsKey), e);
+	}
+	clearCollection(e) {
+		for (let t of this.collectionCache.keys()) t.startsWith(`${e}\n`) && this.collectionCache.delete(t);
+	}
+	clearItem(e, t) {
+		if (t) this.itemCache.delete(this.itemKey(e, t));
+		else 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
+		};
+	}
+}, $e = () => null;
+function et(e) {
+	$e = e;
+}
+function tt(e) {
+	let t = e;
+	return !!t && Array.isArray(t.items) && typeof t.meta == "object" && t.meta !== null && typeof t.checkedAt == "number" && Array.isArray(t.seenChangeKeys);
+}
+function nt(e) {
+	let t = e;
+	return !!t && !!t.record && !!t.dependencies && typeof t.checkedAt == "number" && Array.isArray(t.seenChangeKeys);
+}
+var W = class {
+	memoryCache;
+	persistent;
+	config;
+	stats = {
+		hits: 0,
+		misses: 0,
+		refreshes: 0,
+		errors: 0
+	};
+	constructor(e, t) {
+		this.config = e, this.memoryCache = new Qe(e), this.persistent = t === void 0 ? $e(e) : t;
+	}
+	get enabled() {
+		return this.config.enabled;
+	}
+	getConfig() {
+		return { ...this.config };
+	}
+	async getCollection(e, t) {
+		if (!this.config.enabled) return null;
+		try {
+			let n = this.memoryCache.getCollection(e, t);
+			if (n) return this.stats.hits++, n;
+			let r = await this.persistent?.getCollection(e, t) ?? null;
+			return tt(r) ? (this.memoryCache.setCollection(e, t, r), this.stats.hits++, r) : (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, n) {
+		if (!this.config.enabled) return null;
+		try {
+			let r = n.items.map((e) => ({
+				...e,
+				data: { ...e.data }
+			})), i = qe(e, t, r.map((e) => Je(e, t))), a = {
+				...n,
+				items: r,
+				etag: i
+			};
+			return this.memoryCache.setCollection(e, t, a), await this.persistent?.setCollection(e, t, a), a;
+		} 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);
+			if (n) return this.stats.hits++, n;
+			let r = await this.persistent?.getItem(e, t) ?? null;
+			return nt(r) ? (this.memoryCache.setItem(r), this.stats.hits++, r) : (this.stats.misses++, null);
+		} catch (t) {
+			return console.error(`Error getting query item cache for ${e}:`, t), this.stats.errors++, null;
+		}
+	}
+	async setItem(e) {
+		if (!this.config.enabled) return null;
+		try {
+			let t = {
+				...e.record,
+				data: { ...e.record.data },
+				...e.record.changelog && { changelog: [...e.record.changelog] }
+			}, n = {
+				...e,
+				record: t,
+				etag: Je(t, e.optionsKey)
+			};
+			return this.memoryCache.setItem(n), await this.persistent?.setItem(n), n;
+		} catch (t) {
+			return console.error(`Error setting query item cache for ${e.record.seedUid}:`, t), this.stats.errors++, null;
+		}
+	}
+	async writeThroughItems(e) {
+		if (this.config.enabled) for (let t of e) await this.setItem(t);
+	}
+	async clearItem(e, t) {
+		this.memoryCache.clearItem(e, t), await this.persistent?.clearItem(e, t);
+	}
+	async clearCollection(e) {
+		this.memoryCache.clearCollection(e), await this.persistent?.clearCollection(e);
+	}
+	async clearAll() {
+		this.memoryCache.clearAll(), await this.persistent?.clearAll();
+	}
+	async withRefreshLock(e, t) {
+		return this.memoryCache.withRefreshLock(e, t);
+	}
+	recordRefresh() {
+		this.stats.refreshes++;
+	}
+	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
+		};
+	}
+}, G = null;
+function K() {
+	return G ||= new W(H()), G;
+}
+function rt() {
+	G = null;
+}
+function it(e, t) {
+	return new W({
+		...H(),
+		...e
+	}, t);
+}
+function q() {
+	return Math.floor(Date.now() / 1e3);
+}
+function J(e) {
+	return e - 600;
+}
+function at(e, t) {
+	return J(t) - e.checkedAt > 600;
+}
+var ot = (e) => `${e.id}:${e.revocationTime}`;
+async function st(e, t, n) {
+	if (!e.listChangesSince) return null;
+	if (t.size === 0) return {
+		changed: /* @__PURE__ */ new Set(),
+		seenChangeKeys: n.seenChangeKeys
+	};
+	let r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), a = (e, t, n) => {
+		let r = e.get(t);
+		r ? r.push(n) : e.set(t, [n]);
+	};
+	for (let [e, n] of t) {
+		for (let t of n.refUIDs) a(r, t, e);
+		for (let t of n.ids) a(i, t, e);
+	}
+	let o = await e.listChangesSince({
+		refUIDs: [...r.keys()],
+		ids: [...i.keys()],
+		since: n.checkedAt
+	}), s = new Set(n.seenChangeKeys), c = /* @__PURE__ */ new Set();
+	for (let e of o) if (!s.has(ot(e))) {
+		for (let t of r.get(e.refUID) ?? []) c.add(t);
+		for (let t of i.get(e.id) ?? []) c.add(t);
+	}
+	return {
+		changed: c,
+		seenChangeKeys: o.map(ot)
+	};
+}
+//#endregion
+//#region src/source/registry.ts
+var Y = null;
+function ct(e) {
+	if (e.kind !== "local") throw Error("[query] registerLocalQuerySource expects a source with kind: \"local\"");
+	Y = e;
+}
+function lt() {
+	Y = null;
+}
+function ut() {
+	return Y;
+}
+function dt() {
+	return Y != null;
+}
+//#endregion
+//#region src/source/resolve.ts
+function X(e = "remote") {
+	if (e === "remote") return {
+		mode: "remote",
+		dataSource: P(),
+		useQueryCache: !0
+	};
+	let t = ut();
+	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: P(),
+		useQueryCache: !0
+	};
+}
+function Z(e) {
+	return e ?? "remote";
+}
+//#endregion
+//#region src/api.ts
+var Q = {
+	refUIDs: [],
+	ids: []
+};
+function $(e, t) {
+	return !t || e?.cache === !1 ? !1 : K().enabled;
+}
+function ft(e) {
+	return e === "data+changelog" || e === "changelog";
+}
+function pt(e) {
+	return e !== "changelog";
+}
+async function mt(e, t, n, r, i) {
+	return z(e, await i.listSeedsBySchemaName(e, {
+		limit: t,
+		skip: n
+	}), r, i);
+}
+async function ht(e, t, n) {
+	let r = await n(t);
+	if (e !== "auto" || t.kind !== "local") return {
+		assembled: r,
+		dataSource: t,
+		useQueryCache: t.kind === "remote"
+	};
+	if (r.records.length > 0) return {
+		assembled: r,
+		dataSource: t,
+		useQueryCache: !1
+	};
+	let i = P();
+	return {
+		assembled: await n(i),
+		dataSource: i,
+		useQueryCache: !0
+	};
+}
+async function gt(e, t, n, r = []) {
+	await K().writeThroughItems(e.records.map((i) => ({
+		record: i,
+		optionsKey: t,
+		dependencies: e.dependencies.get(i.seedUid) ?? Q,
+		checkedAt: J(n),
+		seenChangeKeys: r,
+		lastUpdated: n
+	})));
+}
+async function _t(e, t, n, r, i) {
+	let a = K(), o = q(), s = await a.getCollection(e, r), c = await i.listSeedsBySchemaName(e, {
+		limit: t,
+		skip: 0
+	}), l = new Map(s?.items.map((e) => [e.seedUid, e]) ?? []), u = /* @__PURE__ */ new Set(), d = [];
+	if (s) {
+		let e = /* @__PURE__ */ new Map();
+		for (let t of c) {
+			let n = s.meta[t.id];
+			l.has(t.id) && e.set(t.id, n?.dependencies ?? Q);
+		}
+		let t = await st(i, e, s);
+		t ? (u = t.changed, d = t.seenChangeKeys) : u = new Set(e.keys());
+	}
+	let f = c.filter((e) => !l.has(e.id) || u.has(e.id)), p = f.length > 0 ? await z(e, f, n, i) : {
+		records: [],
+		dependencies: /* @__PURE__ */ new Map()
+	}, m = new Map(p.records.map((e) => [e.seedUid, e])), h = [], g = {};
+	for (let e of c) {
+		let t = m.get(e.id);
+		t ? (h.push(t), g[e.id] = {
+			dependencies: p.dependencies.get(e.id) ?? Q,
+			builtAt: o
+		}) : s && !u.has(e.id) && l.has(e.id) && (h.push(l.get(e.id)), g[e.id] = s.meta[e.id] ?? {
+			dependencies: Q,
+			builtAt: o
+		});
+	}
+	let _ = !!s && p.records.length === 0 && h.length === s.items.length && h.every((e, t) => e === s.items[t]);
+	if (s && _ && !at(s, o)) return {
+		items: h,
+		limit: t,
+		skip: 0,
+		etag: s.etag
+	};
+	s && a.recordRefresh();
+	let v = await a.setCollection(e, r, {
+		items: h,
+		meta: g,
+		checkedAt: J(o),
+		seenChangeKeys: d,
+		lastUpdated: s?.lastUpdated ?? o
+	});
+	return await gt(p, r, o, d), {
+		items: v ? [...v.items] : h,
+		limit: t,
+		skip: 0,
+		etag: v?.etag
+	};
+}
+var vt = 4;
+function yt(e) {
+	let t = e.trim().toLowerCase().replace(/^0x/, "");
+	return t.length < vt || t.length > 64 || !/^[0-9a-f]+$/.test(t) ? null : `0x${t}`;
+}
+async function bt(n, r) {
+	await e();
+	let i = r?.limit ?? 100, a = r?.skip ?? 0, o = Z(r?.source), s = X(o), c = t(r), l = null;
+	if (r?.uidPrefix !== void 0 && (l = yt(r.uidPrefix), !l)) return {
+		items: [],
+		limit: i,
+		skip: a
+	};
+	let u = async (e) => l ? z(n, await e.listSeedsByUidPrefix(n, l, {
+		limit: i,
+		skip: a
+	}), r, e) : mt(n, i, a, r, e);
+	if (!l && $(r, s.useQueryCache) && a === 0 && s.dataSource.kind === "remote") {
+		let e = `${n}\n${c}\n${i}`;
+		return K().withRefreshLock(e, () => _t(n, i, r, c, s.dataSource));
+	}
+	let d = q(), { assembled: f, dataSource: p, useQueryCache: m } = await ht(o, s.dataSource, (e) => u(e));
+	return $(r, m) && p.kind === "remote" && await gt(f, c, d), {
+		items: f.records,
+		limit: i,
+		skip: a
+	};
+}
+async function xt(e, t, n) {
+	let r = K(), i = await r.getItem(e, t);
+	if (!i) return null;
+	let a = q(), o = await st(n, /* @__PURE__ */ new Map([[e, i.dependencies]]), i);
+	return !o || o.changed.has(e) ? (await r.clearItem(e, t), null) : (at(i, a) && await r.setItem({
+		...i,
+		checkedAt: J(a),
+		seenChangeKeys: o.seenChangeKeys
+	}), i.record);
+}
+async function St(n, r) {
+	if (await e(), !n || typeof n != "string" || n.trim() === "") return null;
+	let i = n.trim(), a = r?.include ?? "data", o = Z(r?.source), s = X(o), c = t(r), l = s.dataSource, u = s.useQueryCache;
+	if ($(r, u) && l.kind === "remote") {
+		let e = await xt(i, c, l);
+		if (e) return e;
+	}
+	let d = (e) => Promise.all([e.getSeedByUid(i), e.getVersionsForSeeds([i], { includeRevoked: !0 })]), f = q(), [p, m] = await d(l);
+	if (!p && o === "auto" && l.kind === "local") {
+		if (l = P(), u = !0, $(r, u)) {
+			let e = await xt(i, c, l);
+			if (e) return e;
+		}
+		[p, m] = await d(l);
+	}
+	if (!p) return null;
+	let h = p.schema?.schemaNames?.[0]?.name;
+	if (!h) return null;
+	let g = null, _ = {
+		refUIDs: [i],
+		ids: [i]
+	}, v = async () => {
+		let e = await z(h, [p], r, l, { versions: m }), t = e.records[0];
+		return t && (_ = e.dependencies.get(t.seedUid) ?? _), t ?? null;
+	};
+	if (!ft(a)) g = await v();
+	else {
+		let { latestVersionUid: e, changelog: t } = await Ge(i, r, l);
+		if (pt(a)) {
+			let e = await v();
+			g = e ? {
+				...e,
+				changelog: t
+			} : null;
+		} else g = {
+			seedUid: i,
+			schemaName: h,
+			attester: p.attester,
+			timeCreated: p.timeCreated,
+			versionUid: e,
+			data: {},
+			changelog: t
+		}, e && _.refUIDs.push(e);
+		for (let e of t) _.refUIDs.push(e.versionUid);
+		_ = {
+			refUIDs: [...new Set(_.refUIDs)],
+			ids: _.ids
+		};
+	}
+	if (g && $(r, u) && l.kind === "remote") {
+		let e = await K().setItem({
+			record: g,
+			optionsKey: c,
+			dependencies: _,
+			checkedAt: J(f),
+			seenChangeKeys: [],
+			lastUpdated: f
+		});
+		e && (g = e.record);
+	}
+	return g;
+}
+async function Ct(n, r, i, a) {
+	await e();
+	let o = Z(a?.source), s = X(o), c = async (e) => z(n, await e.listSeedsBySchemaNameForMonth(n, r, i), a, e), l = q(), { assembled: u, dataSource: d, useQueryCache: f } = await ht(o, s.dataSource, c);
+	return $(a, f) && d.kind === "remote" && await gt(u, t(a), l), u.records;
+}
+//#endregion
+export { v as $, Te as A, E as B, He as C, N as D, P as E, S as F, pe as G, w as H, ce as I, te as J, D as K, le as L, ge as M, ye as N, M as O, re as P, x as Q, ue as R, Ue as S, Oe as T, se as U, oe as V, de as W, y as X, ne as Y, b as Z, Ge as _, Z as a, B as b, ut as c, it as d, K as f, H as g, et as h, Ct as i, j, Ee as k, dt as l, W as m, yt as n, X as o, rt as p, fe as q, bt as r, lt as s, St as t, ct as u, We as v, ze as w, V as x, Ve as y, T as z };
+
+//# sourceMappingURL=src-CBgjwvGT.js.map