{"version":3,"file":"client.mjs","names":[],"sources":["../../../src/services/registry/client.ts"],"sourcesContent":["import { Context, Data, Layer } from \"effect\";\nimport { fetchJsonOrNull, fetchRaw } from \"../../utils/http-client\";\nimport { keyPathOf, parseRuntimeRef, type RegistryKey } from \"./keys\";\n\n/**\n * The registry transport — the one implementation of FastKV reads. Module is\n * the implementation, tag is the seam (#425's shape): plain functions for\n * direct callers, `RegistryClient` for Effect consumers. The WRITE side is a\n * signing concern (the signer services, #423) and lives elsewhere by design.\n *\n * Reads are action-indexed FastKV entries (namespace = the signing account);\n * on-chain execution of the write may fail without affecting the indexed\n * value — the read-back here is the authority, which is why `absent` and\n * `unreachable` are distinct errors and why nothing in this module swallows\n * them into null silently.\n */\n\nexport type NetworkId = \"mainnet\" | \"testnet\";\n\nconst FASTKV_TESTNET_URL = \"https://kv.test.fastnear.com\";\nconst FASTKV_MAINNET_URL = \"https://kv.main.fastnear.com\";\nconst REGISTRY_NAMESPACE_TESTNET = \"dev.allthethings.testnet\";\nconst REGISTRY_NAMESPACE_MAINNET = \"dev.everything.near\";\n\n/** The network a signing account publishes on — the account suffix is the\n * network. One function; nothing else may derive a base URL. */\nexport function networkIdForAccount(accountId: string): NetworkId {\n  return accountId.endsWith(\".testnet\") ? \"testnet\" : \"mainnet\";\n}\n\nexport function registryBaseUrlForNetwork(network: NetworkId): string {\n  return network === \"testnet\" ? FASTKV_TESTNET_URL : FASTKV_MAINNET_URL;\n}\n\nexport function registryNamespaceForNetwork(network: NetworkId, registry?: string): string {\n  if (registry) return registry;\n  return network === \"testnet\" ? REGISTRY_NAMESPACE_TESTNET : REGISTRY_NAMESPACE_MAINNET;\n}\n\nexport class RegistryError extends Data.TaggedError(\"RegistryError\")<{\n  readonly key: string;\n  readonly kind: \"absent\" | \"unreachable\";\n  readonly cause?: unknown;\n}> {\n  override get message(): string {\n    return this.kind === \"absent\"\n      ? `Not published in the registry: ${this.key}`\n      : `Registry read failed: ${this.key}`;\n  }\n}\n\ninterface FastKvEntry {\n  value?: unknown;\n  key?: string;\n  block_height?: number;\n  block_timestamp?: string | number;\n  tx_hash?: string;\n}\n\ninterface FastKvListResponse {\n  entries?: Array<FastKvEntry | null>;\n  page_token?: string;\n}\n\nexport interface RegistryEntry {\n  key: string;\n  value: unknown;\n  blockHeight: number;\n  blockTimestampNs: string;\n  txHash?: string;\n}\n\nexport interface RegistryHistoryEntry {\n  blockHeight: number;\n  blockTimestampNs: string;\n  txHash?: string;\n  value: unknown;\n}\n\nexport interface RegistryListInput {\n  /** Defaults to the namespace's whole latest-state listing. */\n  ref?: RegistryKey[\"ref\"];\n  keyPrefix?: string;\n  limit?: number;\n  pageToken?: string;\n  includeMetadata?: boolean;\n}\n\nexport interface RegistryListResult {\n  entries: RegistryEntry[];\n  pageToken: string | null;\n}\n\ninterface ReadOptions {\n  /** A registry override — the namespace contract account. */\n  registry?: string;\n  /** Direct-read seam for tests. */\n  fetchImpl?: typeof fetch;\n}\n\nconst parseValue = (value: unknown, key: string): unknown => {\n  if (typeof value === \"string\" && value.length > 0) {\n    return JSON.parse(value) as unknown;\n  }\n  if (value === null || value === undefined || value === \"\") {\n    throw new RegistryError({ key, kind: \"absent\" });\n  }\n  if (typeof value !== \"object\") {\n    throw new RegistryError({ key, kind: \"unreachable\", cause: `Invalid value for ${key}` });\n  }\n  return value;\n};\n\nconst toEntry = (entry: FastKvEntry): RegistryEntry => ({\n  key: entry.key ?? \"\",\n  value: entry.value,\n  blockHeight: entry.block_height ?? 0,\n  blockTimestampNs: String(entry.block_timestamp ?? \"\"),\n  ...(entry.tx_hash ? { txHash: entry.tx_hash } : {}),\n});\n\nconst parseJsonish = (value: unknown): unknown =>\n  typeof value === \"string\" && value.length > 0 ? (JSON.parse(value) as unknown) : value;\n\nconst HISTORY_MAX_LIMIT = 200;\nconst HISTORY_DEFAULT_LIMIT = 20;\n\nfunction buildUrl(key: RegistryKey, surface: \"latest\" | \"history\", opts?: ReadOptions): string {\n  const { accountId } = parseRuntimeRef(key.ref);\n  const network = networkIdForAccount(accountId);\n  const namespace = registryNamespaceForNetwork(network, opts?.registry);\n  const encodedKey = encodeURIComponent(keyPathOf(key));\n  const base = registryBaseUrlForNetwork(network);\n  return `${base}/v0/${surface}/${encodeURIComponent(namespace)}/${encodeURIComponent(accountId)}/${encodedKey}`;\n}\n\nasync function readLatest<T>(key: RegistryKey, opts?: ReadOptions): Promise<T> {\n  const wire = keyPathOf(key);\n  try {\n    const headers: Record<string, string> = { accept: \"application/json\" };\n    const response = opts?.fetchImpl\n      ? await opts.fetchImpl(buildUrl(key, \"latest\", opts), { headers })\n      : await fetchRaw(buildUrl(key, \"latest\", opts), { headers });\n    if (!response.ok) {\n      if (response.status === 404) {\n        throw new RegistryError({ key: wire, kind: \"absent\" });\n      }\n      throw new RegistryError({\n        key: wire,\n        kind: \"unreachable\",\n        cause: `HTTP ${response.status}`,\n      });\n    }\n    const payload = (await response.json()) as FastKvListResponse | null;\n    const value = payload?.entries?.find(Boolean)?.value;\n    if (value === undefined || value === null || value === \"\") {\n      throw new RegistryError({ key: wire, kind: \"absent\" });\n    }\n    return parseValue(value, wire) as T;\n  } catch (error) {\n    if (error instanceof RegistryError) throw error;\n    throw new RegistryError({ key: wire, kind: \"unreachable\", cause: error });\n  }\n}\n\nasync function listLatest(\n  input: RegistryListInput,\n  opts?: ReadOptions,\n): Promise<RegistryListResult> {\n  const ref = input.ref;\n  const accountId = ref ? parseRuntimeRef(ref).accountId : REGISTRY_NAMESPACE_MAINNET;\n  const network = networkIdForAccount(accountId);\n  const namespace = registryNamespaceForNetwork(network, opts?.registry);\n  const base = registryBaseUrlForNetwork(network);\n  const path = ref\n    ? `/v0/latest/${encodeURIComponent(namespace)}/${encodeURIComponent(accountId)}`\n    : `/v0/latest/${encodeURIComponent(namespace)}`;\n  const url = `${base}${path}`;\n  const body = JSON.stringify({\n    limit: input.limit ?? 50,\n    ...(input.keyPrefix ? { key_prefix: input.keyPrefix } : {}),\n    ...(input.pageToken ? { page_token: input.pageToken } : {}),\n    ...(input.includeMetadata ? { include_metadata: true } : {}),\n  });\n  const payload = opts?.fetchImpl\n    ? await (opts.fetchImpl(url, {\n        method: \"POST\",\n        headers: { accept: \"application/json\", \"content-type\": \"application/json\" },\n        body,\n      }) as Promise<Response>)\n    : await fetchRaw(url, {\n        method: \"POST\",\n        headers: { accept: \"application/json\", \"content-type\": \"application/json\" },\n        body,\n      });\n  if (!payload.ok) {\n    throw new RegistryError({\n      key: input.keyPrefix ?? namespace,\n      kind: \"unreachable\",\n      cause: `HTTP ${payload.status}`,\n    });\n  }\n  const parsed = (await payload.json()) as FastKvListResponse | null;\n  const entries = (parsed?.entries ?? [])\n    .filter((entry): entry is FastKvEntry => entry !== null)\n    .map(toEntry);\n  return { entries, pageToken: parsed?.page_token ?? null };\n}\n\nasync function readHistory(\n  key: RegistryKey,\n  limit?: number,\n  opts?: ReadOptions,\n): Promise<RegistryHistoryEntry[]> {\n  const capped = Math.max(1, Math.min(limit ?? HISTORY_DEFAULT_LIMIT, HISTORY_MAX_LIMIT));\n  const url = `${buildUrl(key, \"history\", opts)}?limit=${capped}`;\n  const payload = await fetchJsonOrNull<FastKvListResponse>(url, {\n    headers: { accept: \"application/json\" },\n    retries: 3,\n  });\n  const entries = (payload?.entries ?? []).filter((entry): entry is FastKvEntry => entry !== null);\n  return entries\n    .map((entry) => {\n      const mapped = toEntry(entry);\n      return {\n        blockHeight: mapped.blockHeight,\n        blockTimestampNs: mapped.blockTimestampNs,\n        ...(mapped.txHash ? { txHash: mapped.txHash } : {}),\n        value: parseJsonish(mapped.value),\n      };\n    })\n    .sort((a, b) => b.blockHeight - a.blockHeight);\n}\n\n/** The canonical latest-state URL for a key — for display and external\n * links (the client owns all URL derivation; nothing else builds one). */\nexport function latestUrlFor(key: RegistryKey, opts?: { registry?: string }): string {\n  return buildUrl(key, \"latest\", opts);\n}\n\n/** The plain-function seam — module is the implementation, tag is the seam. */\nexport const registryClientShape = {\n  read: <T>(key: RegistryKey, opts?: ReadOptions): Promise<T> => readLatest<T>(key, opts),\n  readOrNull: <T>(key: RegistryKey, opts?: ReadOptions): Promise<T | null> =>\n    readLatest<T>(key, opts).catch((error: unknown) => {\n      if (error instanceof RegistryError && error.kind === \"absent\") return null;\n      throw error;\n    }),\n  list: (input: RegistryListInput, opts?: ReadOptions): Promise<RegistryListResult> =>\n    listLatest(input, opts),\n  history: (\n    key: RegistryKey,\n    limit?: number,\n    opts?: ReadOptions,\n  ): Promise<RegistryHistoryEntry[]> => readHistory(key, limit, opts),\n};\n\nexport type RegistryClientShape = typeof registryClientShape;\n\nexport class RegistryClient extends Context.Service<RegistryClient, RegistryClientShape>()(\n  \"everything-dev/registry/client\",\n) {\n  static readonly Live = Layer.succeed(this, this.of(registryClientShape));\n}\n"],"mappings":"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"}