UNPKG

everything-dev

Version:

A consolidated product package for building Module Federation apps with oRPC APIs.

1 lines • 13.9 kB
{"version":3,"file":"client.cjs","names":["Data","parseRuntimeRef","keyPathOf","fetchRaw","fetchJsonOrNull","Context","Layer"],"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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"}