@aigne/afs-did-space 1.12.0-beta.5

package/dist/resolve.d.mts

@@ -0,0 +1,113 @@
+import { KeyValueStore } from "@aigne/afs-kv";
+
+//#region src/resolve.d.ts
+interface ResolveEntry {
+  owner: string;
+  path: string;
+  type?: string;
+  name?: string;
+  routes?: Array<{
+    name: string;
+    site: string;
+    path: string;
+    source: string;
+    handler: string;
+  }>;
+  /** Whether this blocklet has pre-rendered .web-cache/ content. Set at publish time. */
+  hasWebCache?: boolean;
+  /** Monotonic timestamp (Date.now()) set by CLI at publish time. Used by DO cache invalidation. */
+  publishVersion?: number;
+}
+interface DomainResolveEntry {
+  did: string;
+  owner: string;
+  path: string;
+  blockletDid?: string;
+  blockletOwner?: string;
+  blockletPath?: string;
+  /** Materialized from blocklet ResolveEntry at publish/bind time. */
+  routes?: Array<{
+    name: string;
+    site: string;
+    path: string;
+    source: string;
+    handler: string;
+  }>;
+  /** Materialized from blocklet ResolveEntry at publish/bind time. */
+  hasWebCache?: boolean;
+  /** Materialized from blocklet ResolveEntry at publish/bind time. Used by DO cache invalidation. */
+  publishVersion?: number;
+}
+declare class DIDSpaceResolver {
+  private store;
+  constructor(store: KeyValueStore);
+  resolve(did: string): Promise<ResolveEntry | null>;
+  register(did: string, entry: ResolveEntry): Promise<void>;
+  unregister(did: string): Promise<void>;
+  resolveBlocklet(id: string): Promise<ResolveEntry | null>;
+  registerBlocklet(id: string, entry: ResolveEntry): Promise<void>;
+  unregisterBlocklet(id: string): Promise<void>;
+  /** List all registered blocklets (`resolve/blocklet/*`). */
+  listBlocklets(): Promise<Array<{
+    id: string;
+    entry: ResolveEntry;
+  }>>;
+  list(options?: {
+    type?: string;
+  }): Promise<Array<{
+    did: string;
+    entry: ResolveEntry;
+    createdAt?: number;
+    updatedAt?: number;
+  }>>;
+  /** Optimized: single query with timestamps via D1ResolveStore.listWithTimestamps */
+  private _listWithTimestamps;
+  /** Optimized: single query via listWithValues (no N+1) */
+  private _listOptimized;
+  /** Fallback: N+1 queries (list keys, then get each value) */
+  private _listFallback;
+  listDomains(): Promise<Array<{
+    domain: string;
+    entry: DomainResolveEntry;
+  }>>;
+  /** Optimized: single query via listWithValues */
+  private _listDomainsOptimized;
+  /** Fallback: N+1 queries */
+  private _listDomainsFallback;
+  resolveDomain(domain: string): Promise<DomainResolveEntry | null>;
+  /**
+   * Serve-path host resolution (issue #808): fetch `resolve/blocklet/<name>` and
+   * `resolve/domain/<name>` in ONE store round trip (D1 `IN(...)`) instead of the
+   * sequential `resolveBlocklet` → `resolveDomain` ladder. Blocklet wins (id
+   * key), falling back to the domain entry — identical priority, one fewer round
+   * trip. For a brand-domain host (the prod model), the id key always misses and
+   * the domain key hits, so this saves the domain lookup's whole round trip on
+   * EVERY request. Degrades to two concurrent `get()`s when the store can't
+   * batch. `validateId` mirrors `resolveBlocklet` (the sequential ladder runs it
+   * first, so an invalid id resolves to null there too — never reaching domain).
+   */
+  resolveBlockletOrDomain(name: string): Promise<{
+    source: "blocklet";
+    owner: string;
+    path: string;
+  } | {
+    source: "domain";
+    owner: string;
+    path: string;
+    did: string;
+  } | null>;
+  registerDomain(domain: string, entry: DomainResolveEntry): Promise<void>;
+  unregisterDomain(domain: string): Promise<void>;
+  /**
+   * Domains currently registered to this exact (owner, path) pair (#764 Phase
+   * 4a). Shared by the write hook's reconcile step (drop domains no longer in
+   * a redeploy's manifest) and the delete hook (drop all domains on unpublish)
+   * — same `listDomains()` + filter pattern `applyBlockletDeleteHook` already
+   * used inline for `resolve/blocklet/*`, factored out here since Phase 4
+   * needs it twice.
+   */
+  domainsForBlocklet(owner: string, path: string): Promise<string[]>;
+}
+//#endregion
+export { DIDSpaceResolver, DomainResolveEntry, ResolveEntry };
+//# sourceMappingURL=resolve.d.mts.map

package/dist/resolve.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.mts","names":[],"sources":["../src/resolve.ts"],"mappings":";;;UAIiB,YAAA;EACf,KAAA;EACA,IAAA;EACA,IAAA;EACA,IAAA;EACA,MAAA,GAAS,KAAA;IAAQ,IAAA;IAAc,IAAA;IAAc,IAAA;IAAc,MAAA;IAAgB,OAAA;EAAA;EAA1D;EAEjB,WAAA;EAF6C;EAI7C,cAAA;AAAA;AAAA,UAGe,kBAAA;EACf,GAAA;EACA,KAAA;EACA,IAAA;EACA,WAAA;EACA,aAAA;EACA,YAAA;EAEc;EAAd,MAAA,GAAS,KAAA;IAAQ,IAAA;IAAc,IAAA;IAAc,IAAA;IAAc,MAAA;IAAgB,OAAA;EAAA;EAAlE;EAET,WAAA;EAF+B;EAI/B,cAAA;AAAA;AAAA,cAGW,gBAAA;EAAA,QACS,KAAA;cAAA,KAAA,EAAO,aAAA;EAIrB,OAAA,CAAQ,GAAA,WAAc,OAAA,CAAQ,YAAA;EAK9B,QAAA,CAAS,GAAA,UAAa,KAAA,EAAO,YAAA,GAAe,OAAA;EAK5C,UAAA,CAAW,GAAA,WAAc,OAAA;EAkBzB,eAAA,CAAgB,EAAA,WAAa,OAAA,CAAQ,YAAA;EAMrC,gBAAA,CAAiB,EAAA,UAAY,KAAA,EAAO,YAAA,GAAe,OAAA;EAYnD,kBAAA,CAAmB,EAAA,WAAa,OAAA;EA9CF;EAoD9B,aAAA,CAAA,GAAiB,OAAA,CAAQ,KAAA;IAAQ,EAAA;IAAY,KAAA,EAAO,YAAA;EAAA;EAgCpD,IAAA,CAAK,OAAA;IACT,IAAA;EAAA,IACE,OAAA,CAAQ,KAAA;IAAQ,GAAA;IAAa,KAAA,EAAO,YAAA;IAAc,SAAA;IAAoB,SAAA;EAAA;EAAlC;EAAA,QAc1B,mBAAA;EAdV;EAAA,QA6CU,cAAA;EA6Ce;EAAA,QAxBf,aAAA;EAwBR,WAAA,CAAA,GAAe,OAAA,CAAQ,KAAA;IAAQ,MAAA;IAAgB,KAAA,EAAO,kBAAA;EAAA;EAwGK;EAAA,QAhGnD,qBAAA;EAkHyC;EAAA,QA/FzC,oBAAA;EAsBR,aAAA,CAAc,MAAA,WAAiB,OAAA,CAAQ,kBAAA;EArOzB;;;;;;;;;;;EAqPd,uBAAA,CACJ,IAAA,WACC,OAAA;IACG,MAAA;IAAoB,KAAA;IAAe,IAAA;EAAA;IACnC,MAAA;IAAkB,KAAA;IAAe,IAAA;IAAc,GAAA;EAAA;EAmC/C,cAAA,CAAe,MAAA,UAAgB,KAAA,EAAO,kBAAA,GAAqB,OAAA;EAK3D,gBAAA,CAAiB,MAAA,WAAiB,OAAA;EA3PL;;;;;;;;EAwQ7B,kBAAA,CAAmB,KAAA,UAAe,IAAA,WAAe,OAAA;AAAA"}

package/dist/resolve.mjs

@@ -0,0 +1,260 @@
+import { validateId } from "./did-utils.mjs";
+import { AFSAlreadyExistsError } from "@aigne/afs";
+
+//#region src/resolve.ts
+var DIDSpaceResolver = class {
+	constructor(store) {
+		this.store = store;
+	}
+	async resolve(did) {
+		const raw = await this.store.get(`resolve/${did}`);
+		return raw ? JSON.parse(raw) : null;
+	}
+	async register(did, entry) {
+		validateId(did);
+		await this.store.put(`resolve/${did}`, JSON.stringify(entry));
+	}
+	async unregister(did) {
+		validateId(did);
+		await this.store.delete(`resolve/${did}`);
+	}
+	async resolveBlocklet(id) {
+		validateId(id);
+		const raw = await this.store.get(`resolve/blocklet/${id}`);
+		return raw ? JSON.parse(raw) : null;
+	}
+	async registerBlocklet(id, entry) {
+		validateId(id);
+		const existing = await this.resolveBlocklet(id);
+		if (existing && existing.owner !== entry.owner) throw new AFSAlreadyExistsError(id, `blocklet "${id}" is already registered to a different owner`);
+		await this.store.put(`resolve/blocklet/${id}`, JSON.stringify(entry));
+	}
+	async unregisterBlocklet(id) {
+		validateId(id);
+		await this.store.delete(`resolve/blocklet/${id}`);
+	}
+	/** List all registered blocklets (`resolve/blocklet/*`). */
+	async listBlocklets() {
+		const out = [];
+		if (this.store.listWithValues) {
+			const result$1 = await this.store.listWithValues({ prefix: "resolve/blocklet/" });
+			for (const { key, value } of result$1.entries) {
+				let entry;
+				try {
+					entry = JSON.parse(value);
+				} catch {
+					continue;
+				}
+				out.push({
+					id: key.slice(17),
+					entry
+				});
+			}
+			return out;
+		}
+		const result = await this.store.list({ prefix: "resolve/blocklet/" });
+		for (const { name } of result.keys) {
+			const raw = await this.store.get(name);
+			if (!raw) continue;
+			let entry;
+			try {
+				entry = JSON.parse(raw);
+			} catch {
+				continue;
+			}
+			out.push({
+				id: name.slice(17),
+				entry
+			});
+		}
+		return out;
+	}
+	async list(options) {
+		if ("listWithTimestamps" in this.store && typeof this.store.listWithTimestamps === "function") return this._listWithTimestamps(options);
+		if (this.store.listWithValues) return this._listOptimized(options);
+		return this._listFallback(options);
+	}
+	/** Optimized: single query with timestamps via D1ResolveStore.listWithTimestamps */
+	async _listWithTimestamps(options) {
+		const result = await this.store.listWithTimestamps({ prefix: "resolve/" });
+		const entries = [];
+		for (const { key, value, created_at, updated_at } of result.entries) {
+			if (key.startsWith("resolve/domain/") || key.startsWith("resolve/blocklet/")) continue;
+			let entry;
+			try {
+				entry = JSON.parse(value);
+			} catch {
+				continue;
+			}
+			if (options?.type !== void 0 && entry.type !== options.type) continue;
+			const did = key.slice(8);
+			entries.push({
+				did,
+				entry,
+				createdAt: created_at ?? void 0,
+				updatedAt: updated_at ?? void 0
+			});
+		}
+		return entries;
+	}
+	/** Optimized: single query via listWithValues (no N+1) */
+	async _listOptimized(options) {
+		const result = await this.store.listWithValues({ prefix: "resolve/" });
+		const entries = [];
+		for (const { key, value } of result.entries) {
+			if (key.startsWith("resolve/domain/") || key.startsWith("resolve/blocklet/")) continue;
+			let entry;
+			try {
+				entry = JSON.parse(value);
+			} catch {
+				continue;
+			}
+			if (options?.type !== void 0 && entry.type !== options.type) continue;
+			const did = key.slice(8);
+			entries.push({
+				did,
+				entry
+			});
+		}
+		return entries;
+	}
+	/** Fallback: N+1 queries (list keys, then get each value) */
+	async _listFallback(options) {
+		const result = await this.store.list({ prefix: "resolve/" });
+		const entries = [];
+		for (const { name } of result.keys) {
+			if (name.startsWith("resolve/domain/") || name.startsWith("resolve/blocklet/")) continue;
+			const raw = await this.store.get(name);
+			if (!raw) continue;
+			let entry;
+			try {
+				entry = JSON.parse(raw);
+			} catch {
+				continue;
+			}
+			if (options?.type !== void 0 && entry.type !== options.type) continue;
+			const did = name.slice(8);
+			entries.push({
+				did,
+				entry
+			});
+		}
+		return entries;
+	}
+	async listDomains() {
+		if (this.store.listWithValues) return this._listDomainsOptimized();
+		return this._listDomainsFallback();
+	}
+	/** Optimized: single query via listWithValues */
+	async _listDomainsOptimized() {
+		const result = await this.store.listWithValues({ prefix: "resolve/domain/" });
+		const entries = [];
+		for (const { key, value } of result.entries) {
+			let entry;
+			try {
+				entry = JSON.parse(value);
+			} catch {
+				continue;
+			}
+			const domain = key.slice(15);
+			entries.push({
+				domain,
+				entry
+			});
+		}
+		return entries;
+	}
+	/** Fallback: N+1 queries */
+	async _listDomainsFallback() {
+		const result = await this.store.list({ prefix: "resolve/domain/" });
+		const entries = [];
+		for (const { name } of result.keys) {
+			const raw = await this.store.get(name);
+			if (!raw) continue;
+			let entry;
+			try {
+				entry = JSON.parse(raw);
+			} catch {
+				continue;
+			}
+			const domain = name.slice(15);
+			entries.push({
+				domain,
+				entry
+			});
+		}
+		return entries;
+	}
+	async resolveDomain(domain) {
+		const raw = await this.store.get(`resolve/domain/${domain}`);
+		return raw ? JSON.parse(raw) : null;
+	}
+	/**
+	* Serve-path host resolution (issue #808): fetch `resolve/blocklet/<name>` and
+	* `resolve/domain/<name>` in ONE store round trip (D1 `IN(...)`) instead of the
+	* sequential `resolveBlocklet` → `resolveDomain` ladder. Blocklet wins (id
+	* key), falling back to the domain entry — identical priority, one fewer round
+	* trip. For a brand-domain host (the prod model), the id key always misses and
+	* the domain key hits, so this saves the domain lookup's whole round trip on
+	* EVERY request. Degrades to two concurrent `get()`s when the store can't
+	* batch. `validateId` mirrors `resolveBlocklet` (the sequential ladder runs it
+	* first, so an invalid id resolves to null there too — never reaching domain).
+	*/
+	async resolveBlockletOrDomain(name) {
+		try {
+			validateId(name);
+		} catch {
+			return null;
+		}
+		const blockletKey = `resolve/blocklet/${name}`;
+		const domainKey = `resolve/domain/${name}`;
+		let blockletRaw;
+		let domainRaw;
+		if (this.store.getMany) {
+			const map = await this.store.getMany([blockletKey, domainKey]);
+			blockletRaw = map.get(blockletKey) ?? null;
+			domainRaw = map.get(domainKey) ?? null;
+		} else [blockletRaw, domainRaw] = await Promise.all([this.store.get(blockletKey), this.store.get(domainKey)]);
+		if (blockletRaw) {
+			const entry = JSON.parse(blockletRaw);
+			if (entry?.owner) return {
+				source: "blocklet",
+				owner: entry.owner,
+				path: entry.path ?? ""
+			};
+		}
+		if (domainRaw) {
+			const entry = JSON.parse(domainRaw);
+			if (entry?.owner) return {
+				source: "domain",
+				owner: entry.owner,
+				path: entry.path ?? "",
+				did: entry.did
+			};
+		}
+		return null;
+	}
+	async registerDomain(domain, entry) {
+		validateId(domain);
+		await this.store.put(`resolve/domain/${domain}`, JSON.stringify(entry));
+	}
+	async unregisterDomain(domain) {
+		validateId(domain);
+		await this.store.delete(`resolve/domain/${domain}`);
+	}
+	/**
+	* Domains currently registered to this exact (owner, path) pair (#764 Phase
+	* 4a). Shared by the write hook's reconcile step (drop domains no longer in
+	* a redeploy's manifest) and the delete hook (drop all domains on unpublish)
+	* — same `listDomains()` + filter pattern `applyBlockletDeleteHook` already
+	* used inline for `resolve/blocklet/*`, factored out here since Phase 4
+	* needs it twice.
+	*/
+	async domainsForBlocklet(owner, path) {
+		return (await this.listDomains()).filter(({ entry }) => entry.owner === owner && entry.path === path).map(({ domain }) => domain);
+	}
+};
+
+//#endregion
+export { DIDSpaceResolver };
+//# sourceMappingURL=resolve.mjs.map

package/dist/resolve.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.mjs","names":["result"],"sources":["../src/resolve.ts"],"sourcesContent":["import { AFSAlreadyExistsError } from \"@aigne/afs\";\nimport type { KeyValueStore } from \"@aigne/afs-kv\";\nimport { validateId } from \"./did-utils.js\";\n\nexport interface ResolveEntry {\n  owner: string;\n  path: string;\n  type?: string;\n  name?: string;\n  routes?: Array<{ name: string; site: string; path: string; source: string; handler: string }>;\n  /** Whether this blocklet has pre-rendered .web-cache/ content. Set at publish time. */\n  hasWebCache?: boolean;\n  /** Monotonic timestamp (Date.now()) set by CLI at publish time. Used by DO cache invalidation. */\n  publishVersion?: number;\n}\n\nexport interface DomainResolveEntry {\n  did: string;\n  owner: string;\n  path: string;\n  blockletDid?: string;\n  blockletOwner?: string;\n  blockletPath?: string;\n  /** Materialized from blocklet ResolveEntry at publish/bind time. */\n  routes?: Array<{ name: string; site: string; path: string; source: string; handler: string }>;\n  /** Materialized from blocklet ResolveEntry at publish/bind time. */\n  hasWebCache?: boolean;\n  /** Materialized from blocklet ResolveEntry at publish/bind time. Used by DO cache invalidation. */\n  publishVersion?: number;\n}\n\nexport class DIDSpaceResolver {\n  constructor(private store: KeyValueStore) {}\n\n  // ── DID resolve ──\n\n  async resolve(did: string): Promise<ResolveEntry | null> {\n    const raw = await this.store.get(`resolve/${did}`);\n    return raw ? JSON.parse(raw) : null;\n  }\n\n  async register(did: string, entry: ResolveEntry): Promise<void> {\n    validateId(did);\n    await this.store.put(`resolve/${did}`, JSON.stringify(entry));\n  }\n\n  async unregister(did: string): Promise<void> {\n    validateId(did);\n    await this.store.delete(`resolve/${did}`);\n  }\n\n  // ── Blocklet resolve (#674) ──\n  //\n  // A separate `resolve/blocklet/<id>` key namespace (parallel to\n  // `resolve/domain/`) maps a blocklet's manifest id (`blocklet.yaml#id`,\n  // globally unique) → its published location `{ owner, path }`. The CF serve\n  // path reads this to reconstruct the owner space and read the blocklet's\n  // files. Registration is driven by the blocklet write-hook (blocklet-hook.ts)\n  // on `blocklet.yaml` writes — never a REST endpoint. `id` is validated with\n  // the same rules as a DID id (no slashes / traversal), so the composed key\n  // `resolve/blocklet/<id>` is always a single safe path segment under the\n  // prefix. These entries are EXCLUDED from the generic `list()` above (like\n  // domains) so website/blocklet namespaces never cross-contaminate.\n\n  async resolveBlocklet(id: string): Promise<ResolveEntry | null> {\n    validateId(id);\n    const raw = await this.store.get(`resolve/blocklet/${id}`);\n    return raw ? JSON.parse(raw) : null;\n  }\n\n  async registerBlocklet(id: string, entry: ResolveEntry): Promise<void> {\n    validateId(id);\n    const existing = await this.resolveBlocklet(id);\n    if (existing && existing.owner !== entry.owner) {\n      throw new AFSAlreadyExistsError(\n        id,\n        `blocklet \"${id}\" is already registered to a different owner`,\n      );\n    }\n    await this.store.put(`resolve/blocklet/${id}`, JSON.stringify(entry));\n  }\n\n  async unregisterBlocklet(id: string): Promise<void> {\n    validateId(id);\n    await this.store.delete(`resolve/blocklet/${id}`);\n  }\n\n  /** List all registered blocklets (`resolve/blocklet/*`). */\n  async listBlocklets(): Promise<Array<{ id: string; entry: ResolveEntry }>> {\n    const out: Array<{ id: string; entry: ResolveEntry }> = [];\n    if (this.store.listWithValues) {\n      const result = await this.store.listWithValues({ prefix: \"resolve/blocklet/\" });\n      for (const { key, value } of result.entries) {\n        let entry: ResolveEntry;\n        try {\n          entry = JSON.parse(value);\n        } catch {\n          continue;\n        }\n        out.push({ id: key.slice(\"resolve/blocklet/\".length), entry });\n      }\n      return out;\n    }\n    const result = await this.store.list({ prefix: \"resolve/blocklet/\" });\n    for (const { name } of result.keys) {\n      const raw = await this.store.get(name);\n      if (!raw) continue;\n      let entry: ResolveEntry;\n      try {\n        entry = JSON.parse(raw);\n      } catch {\n        continue;\n      }\n      out.push({ id: name.slice(\"resolve/blocklet/\".length), entry });\n    }\n    return out;\n  }\n\n  // ── List resolve entries ──\n\n  async list(options?: {\n    type?: string;\n  }): Promise<Array<{ did: string; entry: ResolveEntry; createdAt?: number; updatedAt?: number }>> {\n    if (\n      \"listWithTimestamps\" in this.store &&\n      typeof (this.store as any).listWithTimestamps === \"function\"\n    ) {\n      return this._listWithTimestamps(options);\n    }\n    if (this.store.listWithValues) {\n      return this._listOptimized(options);\n    }\n    return this._listFallback(options);\n  }\n\n  /** Optimized: single query with timestamps via D1ResolveStore.listWithTimestamps */\n  private async _listWithTimestamps(options?: {\n    type?: string;\n  }): Promise<Array<{ did: string; entry: ResolveEntry; createdAt?: number; updatedAt?: number }>> {\n    const result = await (this.store as any).listWithTimestamps({ prefix: \"resolve/\" });\n    const entries: Array<{\n      did: string;\n      entry: ResolveEntry;\n      createdAt?: number;\n      updatedAt?: number;\n    }> = [];\n    for (const { key, value, created_at, updated_at } of result.entries) {\n      if (key.startsWith(\"resolve/domain/\") || key.startsWith(\"resolve/blocklet/\")) continue;\n      let entry: ResolveEntry;\n      try {\n        entry = JSON.parse(value);\n      } catch {\n        continue; // skip corrupted entries\n      }\n      if (options?.type !== undefined && entry.type !== options.type) continue;\n      const did = key.slice(\"resolve/\".length);\n      entries.push({\n        did,\n        entry,\n        createdAt: created_at ?? undefined,\n        updatedAt: updated_at ?? undefined,\n      });\n    }\n    return entries;\n  }\n\n  /** Optimized: single query via listWithValues (no N+1) */\n  private async _listOptimized(options?: {\n    type?: string;\n  }): Promise<Array<{ did: string; entry: ResolveEntry }>> {\n    const result = await this.store.listWithValues!({ prefix: \"resolve/\" });\n    const entries: Array<{ did: string; entry: ResolveEntry }> = [];\n    for (const { key, value } of result.entries) {\n      if (key.startsWith(\"resolve/domain/\") || key.startsWith(\"resolve/blocklet/\")) continue;\n      let entry: ResolveEntry;\n      try {\n        entry = JSON.parse(value);\n      } catch {\n        continue; // skip corrupted entries\n      }\n      if (options?.type !== undefined && entry.type !== options.type) continue;\n      const did = key.slice(\"resolve/\".length);\n      entries.push({ did, entry });\n    }\n    return entries;\n  }\n\n  /** Fallback: N+1 queries (list keys, then get each value) */\n  private async _listFallback(options?: {\n    type?: string;\n  }): Promise<Array<{ did: string; entry: ResolveEntry }>> {\n    const result = await this.store.list({ prefix: \"resolve/\" });\n    const entries: Array<{ did: string; entry: ResolveEntry }> = [];\n    for (const { name } of result.keys) {\n      if (name.startsWith(\"resolve/domain/\") || name.startsWith(\"resolve/blocklet/\")) continue;\n      const raw = await this.store.get(name);\n      if (!raw) continue;\n      let entry: ResolveEntry;\n      try {\n        entry = JSON.parse(raw);\n      } catch {\n        continue; // skip corrupted entries\n      }\n      if (options?.type !== undefined && entry.type !== options.type) continue;\n      const did = name.slice(\"resolve/\".length);\n      entries.push({ did, entry });\n    }\n    return entries;\n  }\n\n  // ── List domain entries ──\n\n  async listDomains(): Promise<Array<{ domain: string; entry: DomainResolveEntry }>> {\n    if (this.store.listWithValues) {\n      return this._listDomainsOptimized();\n    }\n    return this._listDomainsFallback();\n  }\n\n  /** Optimized: single query via listWithValues */\n  private async _listDomainsOptimized(): Promise<\n    Array<{ domain: string; entry: DomainResolveEntry }>\n  > {\n    const result = await this.store.listWithValues!({ prefix: \"resolve/domain/\" });\n    const entries: Array<{ domain: string; entry: DomainResolveEntry }> = [];\n    for (const { key, value } of result.entries) {\n      let entry: DomainResolveEntry;\n      try {\n        entry = JSON.parse(value);\n      } catch {\n        continue; // skip corrupted entries\n      }\n      const domain = key.slice(\"resolve/domain/\".length);\n      entries.push({ domain, entry });\n    }\n    return entries;\n  }\n\n  /** Fallback: N+1 queries */\n  private async _listDomainsFallback(): Promise<\n    Array<{ domain: string; entry: DomainResolveEntry }>\n  > {\n    const result = await this.store.list({ prefix: \"resolve/domain/\" });\n    const entries: Array<{ domain: string; entry: DomainResolveEntry }> = [];\n    for (const { name } of result.keys) {\n      const raw = await this.store.get(name);\n      if (!raw) continue;\n      let entry: DomainResolveEntry;\n      try {\n        entry = JSON.parse(raw);\n      } catch {\n        continue; // skip corrupted entries\n      }\n      const domain = name.slice(\"resolve/domain/\".length);\n      entries.push({ domain, entry });\n    }\n    return entries;\n  }\n\n  // ── Domain resolve ──\n\n  async resolveDomain(domain: string): Promise<DomainResolveEntry | null> {\n    const raw = await this.store.get(`resolve/domain/${domain}`);\n    return raw ? JSON.parse(raw) : null;\n  }\n\n  /**\n   * Serve-path host resolution (issue #808): fetch `resolve/blocklet/<name>` and\n   * `resolve/domain/<name>` in ONE store round trip (D1 `IN(...)`) instead of the\n   * sequential `resolveBlocklet` → `resolveDomain` ladder. Blocklet wins (id\n   * key), falling back to the domain entry — identical priority, one fewer round\n   * trip. For a brand-domain host (the prod model), the id key always misses and\n   * the domain key hits, so this saves the domain lookup's whole round trip on\n   * EVERY request. Degrades to two concurrent `get()`s when the store can't\n   * batch. `validateId` mirrors `resolveBlocklet` (the sequential ladder runs it\n   * first, so an invalid id resolves to null there too — never reaching domain).\n   */\n  async resolveBlockletOrDomain(\n    name: string,\n  ): Promise<\n    | { source: \"blocklet\"; owner: string; path: string }\n    | { source: \"domain\"; owner: string; path: string; did: string }\n    | null\n  > {\n    try {\n      validateId(name);\n    } catch {\n      return null;\n    }\n    const blockletKey = `resolve/blocklet/${name}`;\n    const domainKey = `resolve/domain/${name}`;\n    let blockletRaw: string | null;\n    let domainRaw: string | null;\n    if (this.store.getMany) {\n      const map = await this.store.getMany([blockletKey, domainKey]);\n      blockletRaw = map.get(blockletKey) ?? null;\n      domainRaw = map.get(domainKey) ?? null;\n    } else {\n      [blockletRaw, domainRaw] = await Promise.all([\n        this.store.get(blockletKey),\n        this.store.get(domainKey),\n      ]);\n    }\n    if (blockletRaw) {\n      const entry = JSON.parse(blockletRaw) as ResolveEntry;\n      if (entry?.owner) return { source: \"blocklet\", owner: entry.owner, path: entry.path ?? \"\" };\n    }\n    if (domainRaw) {\n      const entry = JSON.parse(domainRaw) as DomainResolveEntry;\n      if (entry?.owner) {\n        return { source: \"domain\", owner: entry.owner, path: entry.path ?? \"\", did: entry.did };\n      }\n    }\n    return null;\n  }\n\n  async registerDomain(domain: string, entry: DomainResolveEntry): Promise<void> {\n    validateId(domain);\n    await this.store.put(`resolve/domain/${domain}`, JSON.stringify(entry));\n  }\n\n  async unregisterDomain(domain: string): Promise<void> {\n    validateId(domain);\n    await this.store.delete(`resolve/domain/${domain}`);\n  }\n\n  /**\n   * Domains currently registered to this exact (owner, path) pair (#764 Phase\n   * 4a). Shared by the write hook's reconcile step (drop domains no longer in\n   * a redeploy's manifest) and the delete hook (drop all domains on unpublish)\n   * — same `listDomains()` + filter pattern `applyBlockletDeleteHook` already\n   * used inline for `resolve/blocklet/*`, factored out here since Phase 4\n   * needs it twice.\n   */\n  async domainsForBlocklet(owner: string, path: string): Promise<string[]> {\n    const all = await this.listDomains();\n    return all\n      .filter(({ entry }) => entry.owner === owner && entry.path === path)\n      .map(({ domain }) => domain);\n  }\n}\n"],"mappings":";;;;AA+BA,IAAa,mBAAb,MAA8B;CAC5B,YAAY,AAAQ,OAAsB;EAAtB;;CAIpB,MAAM,QAAQ,KAA2C;EACvD,MAAM,MAAM,MAAM,KAAK,MAAM,IAAI,WAAW,MAAM;AAClD,SAAO,MAAM,KAAK,MAAM,IAAI,GAAG;;CAGjC,MAAM,SAAS,KAAa,OAAoC;AAC9D,aAAW,IAAI;AACf,QAAM,KAAK,MAAM,IAAI,WAAW,OAAO,KAAK,UAAU,MAAM,CAAC;;CAG/D,MAAM,WAAW,KAA4B;AAC3C,aAAW,IAAI;AACf,QAAM,KAAK,MAAM,OAAO,WAAW,MAAM;;CAgB3C,MAAM,gBAAgB,IAA0C;AAC9D,aAAW,GAAG;EACd,MAAM,MAAM,MAAM,KAAK,MAAM,IAAI,oBAAoB,KAAK;AAC1D,SAAO,MAAM,KAAK,MAAM,IAAI,GAAG;;CAGjC,MAAM,iBAAiB,IAAY,OAAoC;AACrE,aAAW,GAAG;EACd,MAAM,WAAW,MAAM,KAAK,gBAAgB,GAAG;AAC/C,MAAI,YAAY,SAAS,UAAU,MAAM,MACvC,OAAM,IAAI,sBACR,IACA,aAAa,GAAG,8CACjB;AAEH,QAAM,KAAK,MAAM,IAAI,oBAAoB,MAAM,KAAK,UAAU,MAAM,CAAC;;CAGvE,MAAM,mBAAmB,IAA2B;AAClD,aAAW,GAAG;AACd,QAAM,KAAK,MAAM,OAAO,oBAAoB,KAAK;;;CAInD,MAAM,gBAAqE;EACzE,MAAM,MAAkD,EAAE;AAC1D,MAAI,KAAK,MAAM,gBAAgB;GAC7B,MAAMA,WAAS,MAAM,KAAK,MAAM,eAAe,EAAE,QAAQ,qBAAqB,CAAC;AAC/E,QAAK,MAAM,EAAE,KAAK,WAAWA,SAAO,SAAS;IAC3C,IAAI;AACJ,QAAI;AACF,aAAQ,KAAK,MAAM,MAAM;YACnB;AACN;;AAEF,QAAI,KAAK;KAAE,IAAI,IAAI,MAAM,GAA2B;KAAE;KAAO,CAAC;;AAEhE,UAAO;;EAET,MAAM,SAAS,MAAM,KAAK,MAAM,KAAK,EAAE,QAAQ,qBAAqB,CAAC;AACrE,OAAK,MAAM,EAAE,UAAU,OAAO,MAAM;GAClC,MAAM,MAAM,MAAM,KAAK,MAAM,IAAI,KAAK;AACtC,OAAI,CAAC,IAAK;GACV,IAAI;AACJ,OAAI;AACF,YAAQ,KAAK,MAAM,IAAI;WACjB;AACN;;AAEF,OAAI,KAAK;IAAE,IAAI,KAAK,MAAM,GAA2B;IAAE;IAAO,CAAC;;AAEjE,SAAO;;CAKT,MAAM,KAAK,SAEsF;AAC/F,MACE,wBAAwB,KAAK,SAC7B,OAAQ,KAAK,MAAc,uBAAuB,WAElD,QAAO,KAAK,oBAAoB,QAAQ;AAE1C,MAAI,KAAK,MAAM,eACb,QAAO,KAAK,eAAe,QAAQ;AAErC,SAAO,KAAK,cAAc,QAAQ;;;CAIpC,MAAc,oBAAoB,SAE+D;EAC/F,MAAM,SAAS,MAAO,KAAK,MAAc,mBAAmB,EAAE,QAAQ,YAAY,CAAC;EACnF,MAAM,UAKD,EAAE;AACP,OAAK,MAAM,EAAE,KAAK,OAAO,YAAY,gBAAgB,OAAO,SAAS;AACnE,OAAI,IAAI,WAAW,kBAAkB,IAAI,IAAI,WAAW,oBAAoB,CAAE;GAC9E,IAAI;AACJ,OAAI;AACF,YAAQ,KAAK,MAAM,MAAM;WACnB;AACN;;AAEF,OAAI,SAAS,SAAS,UAAa,MAAM,SAAS,QAAQ,KAAM;GAChE,MAAM,MAAM,IAAI,MAAM,EAAkB;AACxC,WAAQ,KAAK;IACX;IACA;IACA,WAAW,cAAc;IACzB,WAAW,cAAc;IAC1B,CAAC;;AAEJ,SAAO;;;CAIT,MAAc,eAAe,SAE4B;EACvD,MAAM,SAAS,MAAM,KAAK,MAAM,eAAgB,EAAE,QAAQ,YAAY,CAAC;EACvE,MAAM,UAAuD,EAAE;AAC/D,OAAK,MAAM,EAAE,KAAK,WAAW,OAAO,SAAS;AAC3C,OAAI,IAAI,WAAW,kBAAkB,IAAI,IAAI,WAAW,oBAAoB,CAAE;GAC9E,IAAI;AACJ,OAAI;AACF,YAAQ,KAAK,MAAM,MAAM;WACnB;AACN;;AAEF,OAAI,SAAS,SAAS,UAAa,MAAM,SAAS,QAAQ,KAAM;GAChE,MAAM,MAAM,IAAI,MAAM,EAAkB;AACxC,WAAQ,KAAK;IAAE;IAAK;IAAO,CAAC;;AAE9B,SAAO;;;CAIT,MAAc,cAAc,SAE6B;EACvD,MAAM,SAAS,MAAM,KAAK,MAAM,KAAK,EAAE,QAAQ,YAAY,CAAC;EAC5D,MAAM,UAAuD,EAAE;AAC/D,OAAK,MAAM,EAAE,UAAU,OAAO,MAAM;AAClC,OAAI,KAAK,WAAW,kBAAkB,IAAI,KAAK,WAAW,oBAAoB,CAAE;GAChF,MAAM,MAAM,MAAM,KAAK,MAAM,IAAI,KAAK;AACtC,OAAI,CAAC,IAAK;GACV,IAAI;AACJ,OAAI;AACF,YAAQ,KAAK,MAAM,IAAI;WACjB;AACN;;AAEF,OAAI,SAAS,SAAS,UAAa,MAAM,SAAS,QAAQ,KAAM;GAChE,MAAM,MAAM,KAAK,MAAM,EAAkB;AACzC,WAAQ,KAAK;IAAE;IAAK;IAAO,CAAC;;AAE9B,SAAO;;CAKT,MAAM,cAA6E;AACjF,MAAI,KAAK,MAAM,eACb,QAAO,KAAK,uBAAuB;AAErC,SAAO,KAAK,sBAAsB;;;CAIpC,MAAc,wBAEZ;EACA,MAAM,SAAS,MAAM,KAAK,MAAM,eAAgB,EAAE,QAAQ,mBAAmB,CAAC;EAC9E,MAAM,UAAgE,EAAE;AACxE,OAAK,MAAM,EAAE,KAAK,WAAW,OAAO,SAAS;GAC3C,IAAI;AACJ,OAAI;AACF,YAAQ,KAAK,MAAM,MAAM;WACnB;AACN;;GAEF,MAAM,SAAS,IAAI,MAAM,GAAyB;AAClD,WAAQ,KAAK;IAAE;IAAQ;IAAO,CAAC;;AAEjC,SAAO;;;CAIT,MAAc,uBAEZ;EACA,MAAM,SAAS,MAAM,KAAK,MAAM,KAAK,EAAE,QAAQ,mBAAmB,CAAC;EACnE,MAAM,UAAgE,EAAE;AACxE,OAAK,MAAM,EAAE,UAAU,OAAO,MAAM;GAClC,MAAM,MAAM,MAAM,KAAK,MAAM,IAAI,KAAK;AACtC,OAAI,CAAC,IAAK;GACV,IAAI;AACJ,OAAI;AACF,YAAQ,KAAK,MAAM,IAAI;WACjB;AACN;;GAEF,MAAM,SAAS,KAAK,MAAM,GAAyB;AACnD,WAAQ,KAAK;IAAE;IAAQ;IAAO,CAAC;;AAEjC,SAAO;;CAKT,MAAM,cAAc,QAAoD;EACtE,MAAM,MAAM,MAAM,KAAK,MAAM,IAAI,kBAAkB,SAAS;AAC5D,SAAO,MAAM,KAAK,MAAM,IAAI,GAAG;;;;;;;;;;;;;CAcjC,MAAM,wBACJ,MAKA;AACA,MAAI;AACF,cAAW,KAAK;UACV;AACN,UAAO;;EAET,MAAM,cAAc,oBAAoB;EACxC,MAAM,YAAY,kBAAkB;EACpC,IAAI;EACJ,IAAI;AACJ,MAAI,KAAK,MAAM,SAAS;GACtB,MAAM,MAAM,MAAM,KAAK,MAAM,QAAQ,CAAC,aAAa,UAAU,CAAC;AAC9D,iBAAc,IAAI,IAAI,YAAY,IAAI;AACtC,eAAY,IAAI,IAAI,UAAU,IAAI;QAElC,EAAC,aAAa,aAAa,MAAM,QAAQ,IAAI,CAC3C,KAAK,MAAM,IAAI,YAAY,EAC3B,KAAK,MAAM,IAAI,UAAU,CAC1B,CAAC;AAEJ,MAAI,aAAa;GACf,MAAM,QAAQ,KAAK,MAAM,YAAY;AACrC,OAAI,OAAO,MAAO,QAAO;IAAE,QAAQ;IAAY,OAAO,MAAM;IAAO,MAAM,MAAM,QAAQ;IAAI;;AAE7F,MAAI,WAAW;GACb,MAAM,QAAQ,KAAK,MAAM,UAAU;AACnC,OAAI,OAAO,MACT,QAAO;IAAE,QAAQ;IAAU,OAAO,MAAM;IAAO,MAAM,MAAM,QAAQ;IAAI,KAAK,MAAM;IAAK;;AAG3F,SAAO;;CAGT,MAAM,eAAe,QAAgB,OAA0C;AAC7E,aAAW,OAAO;AAClB,QAAM,KAAK,MAAM,IAAI,kBAAkB,UAAU,KAAK,UAAU,MAAM,CAAC;;CAGzE,MAAM,iBAAiB,QAA+B;AACpD,aAAW,OAAO;AAClB,QAAM,KAAK,MAAM,OAAO,kBAAkB,SAAS;;;;;;;;;;CAWrD,MAAM,mBAAmB,OAAe,MAAiC;AAEvE,UADY,MAAM,KAAK,aAAa,EAEjC,QAAQ,EAAE,YAAY,MAAM,UAAU,SAAS,MAAM,SAAS,KAAK,CACnE,KAAK,EAAE,aAAa,OAAO"}

package/dist/rsync-content.cjs

@@ -0,0 +1,33 @@
+
+//#region src/rsync-content.ts
+/**
+* Shared content-decoding helpers for rsync + local metadata sync.
+*
+* AFSFS returns binary files as base64 strings with `meta.contentType = "base64"`.
+* Both rsync (CID computation, transfer) and the Task 1.3 metadata subscriber
+* need to normalize that to raw bytes.
+*/
+/** Normalize AFS read content to a form accepted by computeCID (string | Uint8Array). */
+function toBytes(content) {
+	if (content instanceof Uint8Array) return content;
+	if (content instanceof ArrayBuffer) return new Uint8Array(content);
+	return String(content);
+}
+/**
+* Decode AFSFS base64-encoded binary content to raw bytes.
+* AFSFS returns binary files as base64 string with meta.contentType = "base64".
+* All rsync + metadata-sync operations (CID computation, transfer) must use
+* raw bytes or the original UTF-8 string.
+*/
+function resolveAFSContent(content, meta) {
+	if (typeof content === "string" && meta?.contentType === "base64") {
+		const binaryStr = atob(content);
+		const bytes = new Uint8Array(binaryStr.length);
+		for (let i = 0; i < binaryStr.length; i++) bytes[i] = binaryStr.charCodeAt(i);
+		return bytes;
+	}
+	return toBytes(content);
+}
+
+//#endregion
+exports.resolveAFSContent = resolveAFSContent;

package/dist/rsync-content.mjs

@@ -0,0 +1,33 @@
+//#region src/rsync-content.ts
+/**
+* Shared content-decoding helpers for rsync + local metadata sync.
+*
+* AFSFS returns binary files as base64 strings with `meta.contentType = "base64"`.
+* Both rsync (CID computation, transfer) and the Task 1.3 metadata subscriber
+* need to normalize that to raw bytes.
+*/
+/** Normalize AFS read content to a form accepted by computeCID (string | Uint8Array). */
+function toBytes(content) {
+	if (content instanceof Uint8Array) return content;
+	if (content instanceof ArrayBuffer) return new Uint8Array(content);
+	return String(content);
+}
+/**
+* Decode AFSFS base64-encoded binary content to raw bytes.
+* AFSFS returns binary files as base64 string with meta.contentType = "base64".
+* All rsync + metadata-sync operations (CID computation, transfer) must use
+* raw bytes or the original UTF-8 string.
+*/
+function resolveAFSContent(content, meta) {
+	if (typeof content === "string" && meta?.contentType === "base64") {
+		const binaryStr = atob(content);
+		const bytes = new Uint8Array(binaryStr.length);
+		for (let i = 0; i < binaryStr.length; i++) bytes[i] = binaryStr.charCodeAt(i);
+		return bytes;
+	}
+	return toBytes(content);
+}
+
+//#endregion
+export { resolveAFSContent };
+//# sourceMappingURL=rsync-content.mjs.map

package/dist/rsync-content.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsync-content.mjs","names":[],"sources":["../src/rsync-content.ts"],"sourcesContent":["/**\n * Shared content-decoding helpers for rsync + local metadata sync.\n *\n * AFSFS returns binary files as base64 strings with `meta.contentType = \"base64\"`.\n * Both rsync (CID computation, transfer) and the Task 1.3 metadata subscriber\n * need to normalize that to raw bytes.\n */\n\n/** Normalize AFS read content to a form accepted by computeCID (string | Uint8Array). */\nexport function toBytes(content: unknown): string | Uint8Array {\n  if (content instanceof Uint8Array) return content;\n  if (content instanceof ArrayBuffer) return new Uint8Array(content);\n  return String(content);\n}\n\n/**\n * Decode AFSFS base64-encoded binary content to raw bytes.\n * AFSFS returns binary files as base64 string with meta.contentType = \"base64\".\n * All rsync + metadata-sync operations (CID computation, transfer) must use\n * raw bytes or the original UTF-8 string.\n */\nexport function resolveAFSContent(\n  content: unknown,\n  meta?: Record<string, unknown> | null,\n): string | Uint8Array {\n  if (typeof content === \"string\" && meta?.contentType === \"base64\") {\n    const binaryStr = atob(content);\n    const bytes = new Uint8Array(binaryStr.length);\n    for (let i = 0; i < binaryStr.length; i++) bytes[i] = binaryStr.charCodeAt(i);\n    return bytes;\n  }\n  return toBytes(content);\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,QAAQ,SAAuC;AAC7D,KAAI,mBAAmB,WAAY,QAAO;AAC1C,KAAI,mBAAmB,YAAa,QAAO,IAAI,WAAW,QAAQ;AAClE,QAAO,OAAO,QAAQ;;;;;;;;AASxB,SAAgB,kBACd,SACA,MACqB;AACrB,KAAI,OAAO,YAAY,YAAY,MAAM,gBAAgB,UAAU;EACjE,MAAM,YAAY,KAAK,QAAQ;EAC/B,MAAM,QAAQ,IAAI,WAAW,UAAU,OAAO;AAC9C,OAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,IAAK,OAAM,KAAK,UAAU,WAAW,EAAE;AAC7E,SAAO;;AAET,QAAO,QAAQ,QAAQ"}