@seedprotocol/query 0.5.2

package/README.md

@@ -0,0 +1,145 @@
+# @seedprotocol/query
+
+Canonical **Seed JSON** reads from remote EAS or a registered local SQLite/files adapter (Seed → Version → property attestations).
+
+Feed generation (`@seedprotocol/feed`) uses this package to assemble items; RSS/Atom/JSON Feed formatting and **HTTP / serialized content** caching stay in feed.
+
+SDK `runSyncFromEas` / `syncDbWithEas` persists the same EAS graph into SQLite using shared **`parseEasPropertyMetadata`**, **`parseEasRelationPropertyName`**, and **`pickLatestPropertyAttestationsByRefAndSchema`** — one definition of property decode/canonicalization for reads and sync writes.
+
+## Scope
+
+- `getSeed(seedUid)` — one seed’s canonical JSON envelope, optional **changelog**
+- `queryBySchema(schemaName, { limit, skip })` — paginated collection (latest-only)
+- `queryBySchemaForMonth` — calendar-month listing (used by feed archives)
+- Resolve mode: **latest Version**, then newest property attestation per `(version, schemaId)`
+- **`source: 'local' | 'remote' | 'auto'`** — pluggable backends (default `'remote'`)
+- **Shared collection + item cache** for **remote** reads (memory → disk)
+
+### Published vs authoring
+
+| Need | Use |
+|------|-----|
+| Published / canonical Seed JSON | `getSeed` / `queryBySchema` / SDK `getPublishedSeedRecord` |
+| Drafts, edits, liveQuery, publish | SDK `Item` / `getItemData` (local-head) |
+| Populate local DB from EAS | SDK `Client.syncFromEas` / `runSyncFromEas` (shared parse + pickLatest) |
+
+The Query API conversion (remote assemble → cache → changelog → local source → sync consolidation) is **complete**. Optional follow-ons (HTTP JSON routes, `auto` freshness TTL) are outside this package’s core read surface.
+
+## Usage
+
+```ts
+import {
+  initializeQueryPlatform,
+  getSeed,
+  queryBySchema,
+} from '@seedprotocol/query'
+
+await initializeQueryPlatform({ arweaveDomain: 'ar.seedprotocol.io' })
+
+const one = await getSeed('0x...')
+console.log(JSON.stringify(one?.data, null, 2))
+
+const { items, limit, skip, etag } = await queryBySchema('post', {
+  limit: 20,
+  skip: 0,
+})
+```
+
+`SeedRecord` shape:
+
+```ts
+{
+  seedUid: string
+  schemaName: string
+  attester?: string
+  timeCreated: number
+  versionUid: string
+  data: Record<string, unknown>  // canonical property map + relations
+}
+```
+
+Options on both APIs: `expandRelations` (default `true`), `hydrateStorage` (default `true`), `cache` (default: follow env; pass `false` to bypass), `source` (default `'remote'`).
+
+## Source (`local` / `remote` / `auto`)
+
+| `source` | Behavior |
+|----------|----------|
+| `'remote'` (default) | EAS GraphQL + Arweave hydrate; uses query CacheManager when enabled |
+| `'local'` | Requires `registerLocalQuerySource(...)` (SDK registers on client init). Published SQLite snapshot only — not drafts |
+| `'auto'` | Prefer registered local when the seed/collection resolves; otherwise remote. No sync refresh / freshness TTL |
+
+```ts
+import {
+  registerLocalQuerySource,
+  getSeed,
+  type QueryDataSource,
+} from '@seedprotocol/query'
+
+// SDK apps: Client.init registers automatically via registerSeedQueryLocalSource().
+// Or register a custom adapter:
+registerLocalQuerySource(myLocalSource)
+
+const local = await getSeed('0x...', { source: 'local' })
+const either = await getSeed('0x...', { source: 'auto' })
+```
+
+Unresolved `source: 'local'` without a registered adapter throws. Local / resolved-local `auto` **bypasses** the query disk/memory cache (SQLite is the store).
+
+From `@seedprotocol/sdk`:
+
+```ts
+import { getPublishedSeedRecord } from '@seedprotocol/sdk'
+
+const published = await getPublishedSeedRecord('0x...', { source: 'local' })
+```
+
+Authoring UIs keep using `Item` / liveQuery for drafts; published JSON snapshots use query + `source`.
+
+## Changelog (`getSeed` only)
+
+```ts
+const withHistory = await getSeed('0x...', {
+  include: 'data+changelog', // 'data' | 'data+changelog' | 'changelog'
+  changelog: {
+    granularity: 'version', // or 'property'
+    since: 1700000000,      // optional unix seconds
+    limit: 20,              // optional; keeps newest N after since
+  },
+})
+// withHistory.changelog?: ChangelogEntry[]
+```
+
+- **`include: 'data'`** (default) — same as before; no `changelog` field.
+- **`include: 'data+changelog'`** — latest assembled `data` (expand/hydrate apply) plus history.
+- **`include: 'changelog'`** — envelope + `changelog`; `data` is `{}`.
+- **Version granularity** (default) — consecutive flat Version snapshots with `before` / `after` / `changedKeys`.
+- **Property granularity** — one entry per property attestation change (`previousValue` / `nextValue`).
+- Historical snapshots are **flat** (no relation expand / Arweave hydrate). Collections stay latest-only.
+- Works for `source: 'local'` when versions + attested metadata exist in the DB.
+
+## Caching
+
+Controlled by the same env vars as feed content cache (ops compatibility):
+
+| Variable | Default | Notes |
+|----------|---------|--------|
+| `CACHE_ENABLED` | on in prod; **off** when `NODE_ENV=development` | Set `true`/`false` to force |
+| `CACHE_TTL` | `3600` | Seconds for collection + item entries |
+| `CACHE_DIR` | `./cache` | Collections: `{schema}.json`; items: `items/{seedUid}-{opts}.json` |
+
+Behavior:
+
+- **Collection cache** — only for **remote** `queryBySchema` with `skip === 0` (working set). Warm hits still fetch the page to detect newer `timeCreated`, then merge/dedupe.
+- **Item cache** — keyed by `seedUid` + options fingerprint (`expandRelations` / `hydrateStorage` / `include` / changelog filters). Default latest-only key remains `e1-h1`. Filled by remote `getSeed` and write-through from collection/month queries.
+- **`cache: false`** — skip all cache reads/writes for that call.
+- **`skip > 0`** — no collection cache; still write-through items when cache is enabled.
+- **Local source** — no query CacheManager (SQLite is authoritative).
+- Refresh lock — concurrent remote `queryBySchema` for the same schema share one in-flight refresh.
+
+Feed still owns serialized RSS/Atom/JSON bodies, HTTP `ETag` / 304, and image-metadata probing.
+
+## Init
+
+Call `initializeQueryPlatform()` once (registers Node EAS + Arweave clients), or rely on `getSeed` / `queryBySchema` which initialize automatically.
+
+For local reads, also ensure the SDK client has initialized (registers `registerLocalQuerySource`) or call `registerSeedQueryLocalSource()` / `registerLocalQuerySource` yourself.

package/dist/api.d.ts

@@ -0,0 +1,9 @@
+import type { AssembleOptions, GetSeedOptions, GetSeedResult, QueryBySchemaOptions, QueryBySchemaResult, SeedRecord } from './types.js';
+export declare function queryBySchema(schemaName: string, options?: QueryBySchemaOptions): Promise<QueryBySchemaResult>;
+export declare function getSeed(seedUid: string, options?: GetSeedOptions): Promise<GetSeedResult | null>;
+/**
+ * Query seeds of a schema created within a calendar month (local timezone bounds).
+ * No collection cache; may write-through to item cache when remote.
+ */
+export declare function queryBySchemaForMonth(schemaName: string, year: number, month: number, options?: AssembleOptions): Promise<SeedRecord[]>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACX,MAAM,YAAY,CAAA;AAyDnB,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAyE9B;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAyF/B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAuBvB"}

package/dist/arweaveUrl.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Builds an Arweave gateway URL for a transaction ID (no `/raw` segment).
+ */
+export declare function getArweaveUrlForTransaction(transactionId: string): string;
+//# sourceMappingURL=arweaveUrl.d.ts.map

package/dist/arweaveUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arweaveUrl.d.ts","sourceRoot":"","sources":["../src/arweaveUrl.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/assembleChangelog.d.ts

@@ -0,0 +1,12 @@
+import type { QueryDataSource } from './source/types.js';
+import type { ChangelogEntry, GetSeedOptions } from './types.js';
+export type AssembleSeedChangelogResult = {
+    latestVersionUid: string;
+    changelog: ChangelogEntry[];
+};
+/**
+ * Build a changelog for one seed from all Versions + property attestations.
+ * Snapshots are flat (no relation expand / hydrate).
+ */
+export declare function assembleSeedChangelog(seedUid: string, options?: Pick<GetSeedOptions, 'changelog'>, dataSource?: QueryDataSource): Promise<AssembleSeedChangelogResult>;
+//# sourceMappingURL=assembleChangelog.d.ts.map

package/dist/assembleChangelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembleChangelog.d.ts","sourceRoot":"","sources":["../src/assembleChangelog.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAEV,cAAc,EAEd,cAAc,EACf,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,2BAA2B,GAAG;IACxC,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,cAAc,EAAE,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,EAC3C,UAAU,GAAE,eAA4C,GACvD,OAAO,CAAC,2BAA2B,CAAC,CAmDtC"}

package/dist/assembleSeeds.d.ts

@@ -0,0 +1,8 @@
+import type { QueryDataSource } from './source/types.js';
+import type { AssembleOptions, AttestationLike, SeedRecord } from './types.js';
+/**
+ * Assemble canonical SeedRecords from Seed attestations (latest Version + canonical properties).
+ * Uses per-call state (safe for concurrent requests).
+ */
+export declare function assembleSeeds(schemaName: string, seeds: AttestationLike[], options?: AssembleOptions, dataSource?: QueryDataSource): Promise<SeedRecord[]>;
+//# sourceMappingURL=assembleSeeds.d.ts.map

package/dist/assembleSeeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembleSeeds.d.ts","sourceRoot":"","sources":["../src/assembleSeeds.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAob9E;;;GAGG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,eAAe,EAAE,EACxB,OAAO,CAAC,EAAE,eAAe,EACzB,UAAU,GAAE,eAA4C,GACvD,OAAO,CAAC,UAAU,EAAE,CAAC,CA+BvB"}

package/dist/bootstrap-DQZ8ehyx.js

@@ -0,0 +1,25 @@
+import { DEFAULT_ARWEAVE_HOST as e, DEFAULT_ARWEAVE_HOST as t, resolveArweaveHostFromEnv as n } from "@seedprotocol/arweave";
+//#region src/bootstrap.ts
+var r = !1;
+function i(t) {
+	return t ?? n() ?? e;
+}
+async function a(e) {
+	if (r) return;
+	let [{ registerNodeEasPlatform: t }, { registerNodeArweavePlatform: n }] = await Promise.all([import("@seedprotocol/eas/node"), import("@seedprotocol/arweave/node")]);
+	if (t(), n({ arweaveDomain: i(e?.arweaveDomain) }), e?.arweaveDomain) {
+		let { BaseArweaveClient: t } = await import("@seedprotocol/arweave");
+		t.setHost(e.arweaveDomain);
+	}
+	r = !0;
+}
+async function o() {
+	r = !1;
+}
+function s() {
+	return r;
+}
+//#endregion
+export { o as i, a as n, s as r, t };
+
+//# sourceMappingURL=bootstrap-DQZ8ehyx.js.map

package/dist/bootstrap-DQZ8ehyx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-DQZ8ehyx.js","names":[],"sources":["../src/bootstrap.ts"],"sourcesContent":["import {\n  DEFAULT_ARWEAVE_HOST,\n  resolveArweaveHostFromEnv,\n} from '@seedprotocol/arweave'\n\nlet initialized = false\n\nexport type InitializeQueryPlatformOptions = {\n  arweaveDomain?: string\n}\n\nfunction resolveQueryArweaveDomain(explicit?: string): string {\n  return explicit ?? resolveArweaveHostFromEnv() ?? DEFAULT_ARWEAVE_HOST\n}\n\n/** Register Node EAS + Arweave clients for remote query (no full SDK client). */\nexport async function initializeQueryPlatform(\n  options?: InitializeQueryPlatformOptions,\n): Promise<void> {\n  if (initialized) return\n  const [{ registerNodeEasPlatform }, { registerNodeArweavePlatform }] = await Promise.all([\n    import('@seedprotocol/eas/node'),\n    import('@seedprotocol/arweave/node'),\n  ])\n  registerNodeEasPlatform()\n  const arweaveDomain = resolveQueryArweaveDomain(options?.arweaveDomain)\n  registerNodeArweavePlatform({ arweaveDomain })\n  if (options?.arweaveDomain) {\n    const { BaseArweaveClient } = await import('@seedprotocol/arweave')\n    BaseArweaveClient.setHost(options.arweaveDomain)\n  }\n  initialized = true\n}\n\nexport async function teardownQueryPlatform(): Promise<void> {\n  initialized = false\n}\n\nexport function isQueryPlatformInitialized(): boolean {\n  return initialized\n}\n\nexport { DEFAULT_ARWEAVE_HOST } from '@seedprotocol/arweave'\n"],"mappings":";;AAKA,IAAI,IAAc;AAMlB,SAAS,EAA0B,GAA2B;CAC5D,OAAO,KAAY,EAA0B,KAAK;AACpD;AAGA,eAAsB,EACpB,GACe;CACf,IAAI,GAAa;CACjB,IAAM,CAAC,EAAE,8BAA2B,EAAE,oCAAiC,MAAM,QAAQ,IAAI,CACvF,OAAO,2BACP,OAAO,6BACT,CAAC;CAID,IAHA,EAAwB,GAExB,EAA4B,EAAE,eADR,EAA0B,GAAS,aAC3B,EAAc,CAAC,GACzC,GAAS,eAAe;EAC1B,IAAM,EAAE,yBAAsB,MAAM,OAAO;EAC3C,EAAkB,QAAQ,EAAQ,aAAa;CACjD;CACA,IAAc;AAChB;AAEA,eAAsB,IAAuC;CAC3D,IAAc;AAChB;AAEA,SAAgB,IAAsC;CACpD,OAAO;AACT"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,9 @@
+export type InitializeQueryPlatformOptions = {
+    arweaveDomain?: string;
+};
+/** Register Node EAS + Arweave clients for remote query (no full SDK client). */
+export declare function initializeQueryPlatform(options?: InitializeQueryPlatformOptions): Promise<void>;
+export declare function teardownQueryPlatform(): Promise<void>;
+export declare function isQueryPlatformInitialized(): boolean;
+export { DEFAULT_ARWEAVE_HOST } from '@seedprotocol/arweave';
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,8BAA8B,GAAG;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAMD,iFAAiF;AACjF,wBAAsB,uBAAuB,CAC3C,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/cache/CacheManager.d.ts

@@ -0,0 +1,37 @@
+import type { GetSeedResult, SeedRecord } from '../types.js';
+import { MemoryCache } from './MemoryCache.js';
+import type { CachedCollectionData, CachedItemData, QueryCacheConfig, QueryCacheStats } from './types.js';
+/**
+ * Unified query cache: memory → disk for collections and items.
+ */
+export declare class CacheManager {
+    private memoryCache;
+    private fileCache;
+    private config;
+    private stats;
+    constructor(config: QueryCacheConfig);
+    get enabled(): boolean;
+    getConfig(): QueryCacheConfig;
+    getCollection(schemaName: string): Promise<CachedCollectionData | null>;
+    setCollection(schemaName: string, items: SeedRecord[]): Promise<CachedCollectionData | null>;
+    getItem(seedUid: string, optionsKey: string): Promise<CachedItemData | null>;
+    setItem(record: GetSeedResult, optionsKey: string): Promise<CachedItemData | null>;
+    writeThroughItems(items: SeedRecord[], optionsKey: string): Promise<void>;
+    clearCollection(schemaName: string): Promise<void>;
+    clearAll(): Promise<void>;
+    withRefreshLock<T>(schemaName: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Merge records by seedUid; new wins. Sort by timeCreated descending.
+     */
+    mergeRecords(cachedItems: SeedRecord[], newItems: SeedRecord[]): SeedRecord[];
+    /**
+     * Keep only records newer than lastProcessedTimestamp.
+     */
+    filterNewRecords(items: SeedRecord[], lastProcessedTimestamp: number): SeedRecord[];
+    updateConfig(config: Partial<QueryCacheConfig>): void;
+    getStats(): QueryCacheStats & {
+        memoryStats: ReturnType<MemoryCache['getStats']>;
+    };
+    resetStats(): void;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/cache/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAKZ;gBAEW,MAAM,EAAE,gBAAgB;IAMpC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,SAAS,IAAI,gBAAgB;IAIvB,aAAa,CACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA6BjC,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAiBjC,OAAO,CACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA0B3B,OAAO,CACX,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiB3B,iBAAiB,CACrB,KAAK,EAAE,UAAU,EAAE,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAOV,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,eAAe,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACH,YAAY,CACV,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,UAAU,EAAE,GACrB,UAAU,EAAE;IAmBf;;OAEG;IACH,gBAAgB,CACd,KAAK,EAAE,UAAU,EAAE,EACnB,sBAAsB,EAAE,MAAM,GAC7B,UAAU,EAAE;IAMf,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAKrD,QAAQ,IAAI,eAAe,GAAG;QAC5B,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAA;KACjD;IAOD,UAAU,IAAI,IAAI;CAQnB"}

package/dist/cache/FileCache.d.ts

@@ -0,0 +1,21 @@
+import type { CachedCollectionData, CachedItemData, QueryCacheConfig } from './types.js';
+/**
+ * File-based persistent cache for collections and items (Node / best-effort).
+ */
+export declare class FileCache {
+    private cacheDir;
+    private config;
+    constructor(config: QueryCacheConfig);
+    private ensureCacheDir;
+    private ensureItemsDir;
+    private collectionPath;
+    private itemPath;
+    getCollection(schemaName: string): Promise<CachedCollectionData | null>;
+    setCollection(schemaName: string, data: CachedCollectionData): Promise<void>;
+    getItem(seedUid: string, optionsKey: string): Promise<CachedItemData | null>;
+    setItem(data: CachedItemData): Promise<void>;
+    clearCollection(schemaName: string): Promise<void>;
+    clearItem(seedUid: string, optionsKey: string): Promise<void>;
+    clearAll(): Promise<void>;
+}
+//# sourceMappingURL=FileCache.d.ts.map

package/dist/cache/FileCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileCache.d.ts","sourceRoot":"","sources":["../../src/cache/FileCache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAGnB;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,gBAAgB;YAQtB,cAAc;YAUd,cAAc;IAU5B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,QAAQ;IAKV,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAsBvE,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC;IAgBV,OAAO,CACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAsB3B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAalD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBhC"}

package/dist/cache/MemoryCache.d.ts

@@ -0,0 +1,31 @@
+import type { GetSeedResult, SeedRecord } from '../types.js';
+import type { CachedCollectionData, CachedItemData, QueryCacheConfig } from './types.js';
+/**
+ * In-memory collection + item cache with TTL and refresh locks.
+ */
+export declare class MemoryCache {
+    private collectionCache;
+    private itemCache;
+    private config;
+    private refreshLocks;
+    constructor(config: QueryCacheConfig);
+    private itemKey;
+    getCollection(schemaName: string): CachedCollectionData | null;
+    setCollection(schemaName: string, items: SeedRecord[]): CachedCollectionData;
+    getItem(seedUid: string, optionsKey: string): CachedItemData | null;
+    setItem(record: GetSeedResult, optionsKey: string): CachedItemData;
+    clearCollection(schemaName: string): void;
+    clearItem(seedUid: string, optionsKey?: string): void;
+    clearAll(): void;
+    /**
+     * Single-flight: concurrent callers for the same schema share one in-flight promise.
+     */
+    withRefreshLock<T>(schemaName: string, fn: () => Promise<T>): Promise<T>;
+    updateConfig(config: Partial<QueryCacheConfig>): void;
+    getStats(): {
+        collectionCount: number;
+        itemCount: number;
+        activeLocks: number;
+    };
+}
+//# sourceMappingURL=MemoryCache.d.ts.map

package/dist/cache/MemoryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCache.d.ts","sourceRoot":"","sources":["../../src/cache/MemoryCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE5D,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAA2C;gBAEnD,MAAM,EAAE,gBAAgB;IAIpC,OAAO,CAAC,OAAO;IAIf,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAY9D,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,oBAAoB;IAgC5E,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAYnE,OAAO,CACL,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,GACjB,cAAc;IAyBjB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIzC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAYrD,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACG,eAAe,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAkBb,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAIrD,QAAQ,IAAI;QACV,eAAe,EAAE,MAAM,CAAA;QACvB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;KACpB;CAOF"}

package/dist/cache/config.d.ts

@@ -0,0 +1,15 @@
+import type { QueryCacheConfig } from './types.js';
+/**
+ * Load query cache configuration from environment variables.
+ *
+ * Uses the same CACHE_* vars as feed for ops compatibility:
+ * - CACHE_ENABLED
+ * - CACHE_TTL (default 3600)
+ * - CACHE_DIR (default ./cache)
+ * - CACHE_BACKGROUND_REFRESH / CACHE_REFRESH_INTERVAL (unused stubs)
+ *
+ * In development (NODE_ENV=development), cache is disabled unless
+ * CACHE_ENABLED is explicitly true.
+ */
+export declare function loadQueryCacheConfig(): QueryCacheConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/cache/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cache/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAuCvD"}

package/dist/cache/etag.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate an ETag from a string value (MD5, first 16 hex chars, quoted).
+ */
+export declare function generateETag(value: string): string;
+/**
+ * Generate an ETag for a collection working set.
+ */
+export declare function generateCollectionETag(schemaName: string, lastProcessedTimestamp: number, itemCount: number): string;
+/**
+ * Generate an ETag for a single SeedRecord.
+ */
+export declare function generateItemETag(seedUid: string, versionUid: string, timeCreated: number, optionsKey: string): string;
+//# sourceMappingURL=etag.d.ts.map

package/dist/cache/etag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../src/cache/etag.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,sBAAsB,EAAE,MAAM,EAC9B,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAIR"}

package/dist/cache/index.d.ts

@@ -0,0 +1,22 @@
+import { CacheManager } from './CacheManager.js';
+import { loadQueryCacheConfig } from './config.js';
+export { CacheManager } from './CacheManager.js';
+export { MemoryCache } from './MemoryCache.js';
+export { FileCache } from './FileCache.js';
+export { loadQueryCacheConfig } from './config.js';
+export { generateETag, generateCollectionETag, generateItemETag, } from './etag.js';
+export { buildAssembleOptionsKey, sanitizeSeedUidForPath, } from './types.js';
+export type { CachedCollectionData, CachedItemData, QueryCacheConfig, QueryCacheStats, } from './types.js';
+/**
+ * Get the singleton query CacheManager (lazy-init from env).
+ */
+export declare function getQueryCacheManager(): CacheManager;
+/**
+ * Reset singleton (tests / config reload).
+ */
+export declare function resetQueryCacheManager(): void;
+/**
+ * Create a CacheManager with an explicit config (tests).
+ */
+export declare function createQueryCacheManager(config?: Partial<ReturnType<typeof loadQueryCacheConfig>>): CacheManager;
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAA;AAInB;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,YAAY,CAKnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,GACxD,YAAY,CAKd"}

package/dist/cache/types.d.ts

@@ -0,0 +1,49 @@
+import type { ChangelogInclude, GetSeedOptions, GetSeedResult, SeedRecord } from '../types.js';
+/**
+ * Cached collection working set for a schema (skip=0 page).
+ */
+export type CachedCollectionData = {
+    items: SeedRecord[];
+    lastProcessedTimestamp: number;
+    lastProcessedItemId: string;
+    lastUpdated: number;
+    etag: string;
+};
+/**
+ * Cached single-seed assembly result (may include changelog).
+ */
+export type CachedItemData = {
+    record: GetSeedResult;
+    lastUpdated: number;
+    etag: string;
+    /** Fingerprint of assemble options used when caching. */
+    optionsKey: string;
+};
+export type QueryCacheConfig = {
+    ttl: number;
+    cacheDir: string;
+    enabled: boolean;
+    backgroundRefresh: boolean;
+    refreshInterval: number;
+};
+export type QueryCacheStats = {
+    hits: number;
+    misses: number;
+    refreshes: number;
+    errors: number;
+};
+/**
+ * Build a stable key for assemble options that affect cached payloads.
+ * Default latest-only (`include: 'data'`) keeps Phase 2 key `e1-h1`.
+ */
+export declare function buildAssembleOptionsKey(options?: {
+    expandRelations?: boolean;
+    hydrateStorage?: boolean;
+    include?: ChangelogInclude;
+    changelog?: GetSeedOptions['changelog'];
+}): string;
+/**
+ * Sanitize seedUid for use as a filename segment.
+ */
+export declare function sanitizeSeedUidForPath(seedUid: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,UAAU,EACX,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,aAAa,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;CACxC,GAAG,MAAM,CAkBT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/changelog.d.ts

@@ -0,0 +1,39 @@
+import type { AttestationLike, ChangelogEntry, ChangelogOptions, PropertyChangelogEntry, VersionChangelogEntry } from './types.js';
+/**
+ * Stable-ish deep equality for changelog value comparison.
+ */
+export declare function changelogValuesEqual(a: unknown, b: unknown): boolean;
+export type DecodedProperty = {
+    propertyName: string;
+    value: string | string[];
+    camelName?: string;
+};
+/**
+ * Decode a single property attestation into name + value (no relation expand).
+ * Returns null when metadata cannot be parsed.
+ */
+export declare function decodePropertyAttestation(property: AttestationLike): DecodedProperty | null;
+/**
+ * Build a flat property map from canonical property attestations for one Version.
+ */
+export declare function buildFlatSnapshotFromProperties(properties: AttestationLike[]): Record<string, unknown>;
+export type VersionSnapshot = {
+    versionUid: string;
+    at: number;
+    data: Record<string, unknown>;
+};
+/**
+ * Diff consecutive version snapshots (ascending by `at`).
+ * First version: `before = {}`, all keys in `after` are changed.
+ */
+export declare function diffVersionSnapshots(sortedSnapshots: VersionSnapshot[]): VersionChangelogEntry[];
+/**
+ * Per-attestation property diffs across all versions (ordered by timeCreated asc).
+ */
+export declare function diffPropertyAttestations(properties: AttestationLike[]): PropertyChangelogEntry[];
+/**
+ * Filter by `since` (inclusive), then keep the newest `limit` entries (newest-first).
+ * Returned array is newest-first when limit is applied; otherwise chronological (asc).
+ */
+export declare function applyChangelogFilters(entries: ChangelogEntry[], options?: ChangelogOptions): ChangelogEntry[];
+//# sourceMappingURL=changelog.d.ts.map

package/dist/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,YAAY,CAAA;AAMnB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAWpE;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,eAAe,GACxB,eAAe,GAAG,IAAI,CA+CxB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,eAAe,EAAE,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,eAAe,EAAE,GACjC,qBAAqB,EAAE,CA0BzB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,eAAe,EAAE,GAC5B,sBAAsB,EAAE,CAyC1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EAAE,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,EAAE,CAiBlB"}

package/dist/fieldStorageModel.d.ts

@@ -0,0 +1,30 @@
+/** Related Seed schema names (lowercased) used as primary rich-body sources. */
+export declare const RICH_BODY_STORAGE_SCHEMAS: Set<string>;
+/** @deprecated Alias for {@link RICH_BODY_STORAGE_SCHEMAS} (feed key compatibility). */
+export declare const FEED_RICH_BODY_STORAGE_SCHEMAS: Set<string>;
+export type FieldStorageModels = Record<string, string>;
+export type ListElementStorageModels = Record<string, string[]>;
+/** @deprecated Use {@link FieldStorageModels} */
+export type FeedFieldStorageModels = FieldStorageModels;
+/** @deprecated Use {@link ListElementStorageModels} */
+export type FeedListElementStorageModels = ListElementStorageModels;
+export declare function isRichBodyStorageSchema(schemaName: string): boolean;
+/** @deprecated Use {@link isRichBodyStorageSchema} */
+export declare const isFeedRichBodyStorageSchema: typeof isRichBodyStorageSchema;
+/** html < file < json for tie-breaking among rich body fields. */
+export declare function richBodyModelPriority(schemaName: string): number;
+/** @deprecated Use {@link richBodyModelPriority} */
+export declare const feedRichBodyModelPriority: typeof richBodyModelPriority;
+export declare function getFieldStorageModels(item: Record<string, unknown>): FieldStorageModels | undefined;
+/** @deprecated Use {@link getFieldStorageModels} */
+export declare const getFeedFieldStorageModels: typeof getFieldStorageModels;
+export declare function getListElementStorageModels(item: Record<string, unknown>): ListElementStorageModels | undefined;
+/** @deprecated Use {@link getListElementStorageModels} */
+export declare const getFeedListElementStorageModels: typeof getListElementStorageModels;
+export declare function setFieldStorageModel(item: Record<string, unknown>, fieldKey: string, schemaName: string): void;
+/** @deprecated Use {@link setFieldStorageModel} */
+export declare const setFeedFieldStorageModel: typeof setFieldStorageModel;
+export declare function setListElementStorageModels(item: Record<string, unknown>, outputKey: string, models: string[]): void;
+/** @deprecated Use {@link setListElementStorageModels} */
+export declare const setFeedListElementStorageModels: typeof setListElementStorageModels;
+//# sourceMappingURL=fieldStorageModel.d.ts.map

package/dist/fieldStorageModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldStorageModel.d.ts","sourceRoot":"","sources":["../src/fieldStorageModel.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,aAAoC,CAAA;AAE1E,wFAAwF;AACxF,eAAO,MAAM,8BAA8B,aAA4B,CAAA;AAMvE,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACvD,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAE/D,iDAAiD;AACjD,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAA;AACvD,uDAAuD;AACvD,MAAM,MAAM,4BAA4B,GAAG,wBAAwB,CAAA;AAMnE,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,sDAAsD;AACtD,eAAO,MAAM,2BAA2B,gCAA0B,CAAA;AAElE,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,8BAAwB,CAAA;AAE9D,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,kBAAkB,GAAG,SAAS,CAMhC;AAED,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,8BAAwB,CAAA;AAE9D,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,wBAAwB,GAAG,SAAS,CAMtC;AAED,0DAA0D;AAC1D,eAAO,MAAM,+BAA+B,oCAA8B,CAAA;AAE1E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,IAAI,CAQN;AAED,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,6BAAuB,CAAA;AAE5D,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAON;AAED,0DAA0D;AAC1D,eAAO,MAAM,+BAA+B,oCAA8B,CAAA"}

package/dist/hydrateArweaveRichText.d.ts

@@ -0,0 +1,20 @@
+export type HydrateStorageOptions = {
+    /** Prefer local file body when available; fall back to Arweave gateway fetch. */
+    readStorageBody?: (ref: {
+        propertyName: string;
+        value: unknown;
+        localPathHint?: string;
+    }) => Promise<string | null>;
+};
+/**
+ * True for a single-path gateway URL whose path looks like an Arweave transaction id.
+ */
+export declare function isArweaveTransactionGatewayUrl(raw: string): boolean;
+/**
+ * After relation URL resolution, Html/File fields may be gateway URLs (or local paths).
+ * Replace those with the UTF-8 body when `hydrateStorage` is enabled.
+ */
+export declare function hydrateArweaveRichTextInItems(items: Record<string, unknown>[], options?: HydrateStorageOptions): Promise<void>;
+/** @deprecated Use {@link hydrateArweaveRichTextInItems} */
+export declare const hydrateArweaveRichTextInFeedItems: typeof hydrateArweaveRichTextInItems;
+//# sourceMappingURL=hydrateArweaveRichText.d.ts.map

package/dist/hydrateArweaveRichText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrateArweaveRichText.d.ts","sourceRoot":"","sources":["../src/hydrateArweaveRichText.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,qBAAqB,GAAG;IAClC,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,OAAO,CAAA;QACd,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAC7B,CAAA;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAenE;AAkDD;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,4DAA4D;AAC5D,eAAO,MAAM,iCAAiC,sCAAgC,CAAA"}

package/dist/imageRelationEnrichment.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Adds `arweaveUrl` to an assembled Image seed clone when `storageTransactionId`
+ * (or snake_case) is present.
+ */
+export declare function enrichImageSeedClone(clone: Record<string, unknown>): void;
+/** @deprecated Use {@link enrichImageSeedClone} */
+export declare const enrichImageSeedCloneForFeed: typeof enrichImageSeedClone;
+//# sourceMappingURL=imageRelationEnrichment.d.ts.map

package/dist/imageRelationEnrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageRelationEnrichment.d.ts","sourceRoot":"","sources":["../src/imageRelationEnrichment.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWzE;AAED,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,6BAAuB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { initializeQueryPlatform, teardownQueryPlatform, isQueryPlatformInitialized, DEFAULT_ARWEAVE_HOST, } from './bootstrap.js';
+export type { InitializeQueryPlatformOptions } from './bootstrap.js';
+export { assembleSeeds } from './assembleSeeds.js';
+export { assembleSeedChangelog } from './assembleChangelog.js';
+export { getSeed, queryBySchema, queryBySchemaForMonth } from './api.js';
+export { registerLocalQuerySource, clearLocalQuerySource, getRegisteredLocalQuerySource, hasLocalQuerySource, createRemoteQueryDataSource, getRemoteQueryDataSource, resolveQuerySource, normalizeSourceMode, } from './source/index.js';
+export type { QueryDataSource, ResolvedQuerySource } from './source/index.js';
+export { buildFlatSnapshotFromProperties, diffVersionSnapshots, diffPropertyAttestations, applyChangelogFilters, decodePropertyAttestation, changelogValuesEqual, } from './changelog.js';
+export type { SeedRecord, AssembleOptions, QuerySourceMode, GetSeedOptions, GetSeedResult, ChangelogInclude, ChangelogOptions, ChangelogEntry, VersionChangelogEntry, PropertyChangelogEntry, QueryBySchemaOptions, QueryBySchemaResult, AttestationLike, } from './types.js';
+export { getQueryCacheManager, resetQueryCacheManager, createQueryCacheManager, loadQueryCacheConfig, CacheManager, buildAssembleOptionsKey, } from './cache/index.js';
+export type { CachedCollectionData, CachedItemData, QueryCacheConfig, QueryCacheStats, } from './cache/index.js';
+export { getArweaveUrlForTransaction } from './arweaveUrl.js';
+export { publicListRelationPropertyKey, stripListRelationStorageAliasesForPublicKey, tryCoerceJsonStringArray, } from './listRelationKey.js';
+export { parseEasPropertyMetadata, parseEasPropertyMetadataForFeed, } from './parseEasPropertyMetadata.js';
+export type { EasPropertyMetadata, EasPropertyMetadataForFeed, ParseEasPropertyMetadataResult, ParseEasPropertyMetadataForFeedResult, } from './parseEasPropertyMetadata.js';
+export { parseEasRelationPropertyName } from './parseEasRelationPropertyName.js';
+export type { ParsedEasRelationPropertyName } from './parseEasRelationPropertyName.js';
+export { RICH_BODY_STORAGE_SCHEMAS, FEED_RICH_BODY_STORAGE_SCHEMAS, isRichBodyStorageSchema, isFeedRichBodyStorageSchema, richBodyModelPriority, feedRichBodyModelPriority, getFieldStorageModels, getFeedFieldStorageModels, getListElementStorageModels, getFeedListElementStorageModels, setFieldStorageModel, setFeedFieldStorageModel, setListElementStorageModels, setFeedListElementStorageModels, } from './fieldStorageModel.js';
+export type { FieldStorageModels, FeedFieldStorageModels, ListElementStorageModels, FeedListElementStorageModels, } from './fieldStorageModel.js';
+export { enrichImageSeedClone, enrichImageSeedCloneForFeed, } from './imageRelationEnrichment.js';
+export { hydrateArweaveRichTextInItems, hydrateArweaveRichTextInFeedItems, isArweaveTransactionGatewayUrl, } from './hydrateArweaveRichText.js';
+export type { HydrateStorageOptions } from './hydrateArweaveRichText.js';
+//# sourceMappingURL=index.d.ts.map