everything-dev
Version:
A consolidated product package for building Module Federation apps with oRPC APIs.
1 lines • 16.3 kB
Source Map (JSON)
{"version":3,"file":"fastkv.cjs","names":["registryBaseUrlForNetwork","latestUrlFor","registryNamespaceForNetwork","keyPathOf","networkIdForAccount","parseRuntimeRef","registryClientShape","RegistryError","fetchRaw","fetchJsonOrNull","Context","Layer"],"sources":["../../../src/services/registry/fastkv.ts"],"sourcesContent":["import { Context, Layer } from \"effect\";\n\nexport type NetworkId = \"mainnet\" | \"testnet\";\n\ninterface FastKvEntry {\n value: unknown;\n}\n\ninterface FastKvListResponse {\n entries?: Array<FastKvEntry | null>;\n}\n\nimport { fetchJsonOrNull, fetchRaw } from \"../../utils/http-client\";\nimport {\n latestUrlFor,\n networkIdForAccount,\n RegistryError,\n registryBaseUrlForNetwork,\n registryClientShape,\n registryNamespaceForNetwork,\n} from \"./client\";\nimport { keyPathOf, parseRuntimeRef, type RegistryKey, type RuntimeRef } from \"./keys\";\n\nexport function getFastKvBaseUrlForNetwork(network: NetworkId): string {\n return registryBaseUrlForNetwork(network);\n}\n\nexport function buildRegistryConfigUrl(\n accountId: string,\n gatewayId: string,\n registry?: string,\n): string {\n return latestUrlFor(configKey(accountId, gatewayId), { registry });\n}\n\nexport function buildRegistryConfigUrlForNetwork(\n network: NetworkId,\n accountId: string,\n gatewayId: string,\n registry?: string,\n): string {\n const base = registryBaseUrlForNetwork(network);\n const namespace = registryNamespaceForNetwork(network, registry);\n const key = encodeURIComponent(keyPathOf(configKey(accountId, gatewayId)));\n return `${base}/v0/latest/${encodeURIComponent(namespace)}/${encodeURIComponent(accountId)}/${key}`;\n}\n\nexport function getRegistryNamespaceForAccount(accountId: string, registry?: string): string {\n return registry ?? registryNamespaceForNetwork(networkIdForAccount(accountId));\n}\n\nexport function getRegistryNamespaceForNetwork(network: NetworkId, registry?: string): string {\n return registryNamespaceForNetwork(network, registry);\n}\n\nfunction configKey(accountId: string, gatewayId: string, pathSegments: string[] = []): RegistryKey {\n return {\n kind: \"runtimeConfig\",\n ref: runtimeRefOf(accountId, gatewayId),\n ...(pathSegments.length > 0 ? { path: pathSegments } : {}),\n };\n}\n\nfunction getRegistryConfigKey(\n accountId: string,\n gatewayId: string,\n pathSegments: string[] = [],\n): string {\n return keyPathOf(configKey(accountId, gatewayId, pathSegments));\n}\n\nfunction runtimeRefOf(accountId: string, gatewayId: string): RuntimeRef {\n return `bos://${accountId}/${gatewayId}`;\n}\n\nexport function parseBosUrl(bosUrl: string): {\n accountId: string;\n gatewayId: string;\n pathSegments: string[];\n} {\n const parsed = parseRuntimeRef(bosUrl);\n return {\n accountId: parsed.accountId,\n gatewayId: parsed.gatewayId,\n pathSegments: parsed.path,\n };\n}\n\nexport async function fetchBosConfigFromFastKv<T>(bosUrl: string, registry?: string): Promise<T> {\n const { accountId, gatewayId, pathSegments } = parseBosUrl(bosUrl);\n try {\n return await registryClientShape.read<T>(\n configKey(accountId, gatewayId, pathSegments),\n registry !== undefined ? { registry } : undefined,\n );\n } catch (error) {\n // message parity: the historical failure surface is \"No config found\n // for <bosUrl>\" — keep it for absent reads so every \"startsWith\" check\n // downstream keeps working.\n if (error instanceof RegistryError && error.kind === \"absent\") {\n throw new Error(`No config found for ${bosUrl}`);\n }\n throw error;\n }\n}\n\n/**\n * Read an arbitrary registry key under `apps/<account>/<gateway>/` — the\n * well-known-slot seam (ADR 0034's `platform.json` lives beside the config).\n * Absent key (404) → null; a network failure throws so callers can distinguish\n * \"the slot is empty\" from \"the slot is unreachable\" (a swallowed error here\n * would silently tighten a compat floor).\n */\nexport async function fetchRegistryKey<T>(\n accountId: string,\n gatewayId: string,\n keyPath: string,\n registry?: string,\n): Promise<T | null> {\n const key = encodeURIComponent(`apps/${accountId}/${gatewayId}/${keyPath}`);\n const payload = await fetchJson<FastKvListResponse>(\n `${registryBaseUrlForNetwork(networkIdForAccount(accountId))}/v0/latest/${encodeURIComponent(getRegistryNamespaceForAccount(accountId, registry))}/${encodeURIComponent(accountId)}/${key}`,\n );\n const value = payload?.entries?.find(Boolean)?.value;\n if (!value) return null;\n if (typeof value === \"string\") return JSON.parse(value) as T;\n return value as T;\n}\n\n/** Tolerant variant of {@link fetchRegistryKey} — any failure collapses to null. */\nexport async function fetchRegistryKeyOrNull<T>(\n accountId: string,\n gatewayId: string,\n keyPath: string,\n registry?: string,\n): Promise<T | null> {\n try {\n return await fetchRegistryKey<T>(accountId, gatewayId, keyPath, registry);\n } catch {\n return null;\n }\n}\n\n/** Read a published config from an already-built registry URL\n * (`buildRegistryConfigUrlForNetwork`). Unlike {@link fetchBosConfigFromFastKv}\n * this takes the URL directly, so the read key is exactly the one the publish\n * writes, and a network failure is reported as such instead of collapsing\n * into \"No config found\" (fetchJsonOrNull swallows errors into null). */\nexport async function fetchPublishedConfigFromFastKv<T>(url: string): Promise<T> {\n const response = await fetchRaw(url, { headers: { accept: \"application/json\" } });\n if (!response.ok) {\n if (response.status === 404) {\n throw new Error(`No config found for ${url}`);\n }\n throw new Error(`HTTP ${response.status} fetching ${url}`);\n }\n const payload = (await response.json()) as FastKvListResponse | null;\n return parseFastKvConfigValue<T>(payload, url);\n}\n\nexport function parseFastKvConfigValue<T>(payload: FastKvListResponse | null, label: string): T {\n const value = payload?.entries?.find(Boolean)?.value;\n if (!value) {\n throw new Error(`No config found for ${label}`);\n }\n if (typeof value === \"string\") {\n return JSON.parse(value) as T;\n }\n if (typeof value !== \"object\") {\n throw new Error(`Invalid config value for ${label}`);\n }\n return value as T;\n}\n\nexport interface ConfigHistoryEntry {\n blockHeight: number;\n blockTimestampNs: string;\n txHash?: string;\n value: unknown;\n}\n\ninterface FastKvHistoryEntry {\n block_height?: number;\n block_timestamp?: string | number;\n tx_hash?: string;\n value?: unknown;\n}\n\ninterface FastKvHistoryResponse {\n entries?: Array<FastKvHistoryEntry | null>;\n}\n\nconst FASTKV_HISTORY_MAX_LIMIT = 200;\n\n/**\n * Publish history for the registry config key (atomic-deploys 11): the\n * exact-key variant of FastData's history endpoint, newest-first. The API\n * caps a page at 200 rows; a config key's write history fits well inside\n * that, so a single request is the whole story (the limit param is clamped).\n */\nexport async function fetchConfigHistory(opts: {\n accountId: string;\n gatewayId: string;\n registry?: string;\n limit?: number;\n /** An exact key under `apps/<account>/<gateway>/` — defaults to the\n * registry config key. The platform pointer's history feeds the rollback\n * pointer restore (#573). */\n keyPath?: string;\n}): Promise<ConfigHistoryEntry[]> {\n const key = encodeURIComponent(\n opts.keyPath ?? getRegistryConfigKey(opts.accountId, opts.gatewayId),\n );\n const limit = Math.max(1, Math.min(opts.limit ?? 20, FASTKV_HISTORY_MAX_LIMIT));\n const url = `${registryBaseUrlForNetwork(networkIdForAccount(opts.accountId))}/v0/history/${encodeURIComponent(getRegistryNamespaceForAccount(opts.accountId, opts.registry))}/${encodeURIComponent(opts.accountId)}/${key}?limit=${limit}`;\n const payload = await fetchJson<FastKvHistoryResponse>(url);\n const entries = (payload?.entries ?? []).filter(Boolean) as FastKvHistoryEntry[];\n\n return entries\n .map((entry) => ({\n blockHeight: entry.block_height ?? 0,\n blockTimestampNs: String(entry.block_timestamp ?? \"\"),\n ...(entry.tx_hash ? { txHash: entry.tx_hash } : {}),\n value:\n typeof entry.value === \"string\" && entry.value.length > 0\n ? (JSON.parse(entry.value) as unknown)\n : entry.value,\n }))\n .sort((a, b) => b.blockHeight - a.blockHeight);\n}\n\nexport interface DeployManifestEntry {\n key: string;\n blockHeight: number;\n blockTimestampNs: string;\n value: unknown;\n}\n\n/**\n * The per-deploy audit trail (atomic-deploys 03/12): every publish writes\n * `apps/<account>/<gateway>/manifests/<ts>.json` atomically with the pointer\n * swap — this lists that key family newest-first via the history-by-prefix\n * endpoint.\n */\nexport async function fetchDeployManifests(opts: {\n accountId: string;\n gatewayId: string;\n registry?: string;\n limit?: number;\n}): Promise<DeployManifestEntry[]> {\n const keyPrefix = encodeURIComponent(\n `${getRegistryConfigKey(opts.accountId, opts.gatewayId).replace(/bos\\.config\\.json$/, \"\")}manifests/`,\n );\n const url = `${registryBaseUrlForNetwork(networkIdForAccount(opts.accountId))}/v0/history/${encodeURIComponent(getRegistryNamespaceForAccount(opts.accountId, opts.registry))}/${encodeURIComponent(opts.accountId)}`;\n const payload = await fetchJson<FastKvHistoryResponse>(url, {\n method: \"POST\",\n body: JSON.stringify({\n key_prefix: decodeURIComponent(keyPrefix),\n asc: false,\n limit: Math.max(1, Math.min(opts.limit ?? 20, FASTKV_HISTORY_MAX_LIMIT)),\n }),\n });\n const entries = (payload?.entries ?? []).filter(Boolean) as Array<\n FastKvHistoryEntry & { key?: string }\n >;\n\n return entries\n .map((entry) => ({\n key: entry.key ?? \"\",\n blockHeight: entry.block_height ?? 0,\n blockTimestampNs: String(entry.block_timestamp ?? \"\"),\n value:\n typeof entry.value === \"string\" && entry.value.length > 0\n ? (JSON.parse(entry.value) as unknown)\n : entry.value,\n }))\n .sort((a, b) => b.blockHeight - a.blockHeight);\n}\n\nexport interface PluginManifest {\n schemaVersion: number;\n kind: string;\n plugin: { name: string; version: string };\n runtime: { remoteEntry: string };\n contract: {\n kind: string;\n types: { path: string; exportName: string; typeName: string; sha256: string };\n };\n additionalExports?: Array<{ path: string; exports: string[]; sha256: string }>;\n}\n\nexport async function fetchRemotePluginManifest(cdnUrl: string): Promise<PluginManifest | null> {\n const baseUrl = cdnUrl.replace(/\\/$/, \"\");\n return fetchJsonOrNull<PluginManifest>(`${baseUrl}/plugin.manifest.json`, { retries: 2 });\n}\n\nasync function fetchJson<T>(url: string, init?: RequestInit): Promise<T | null> {\n const headers: Record<string, string> = {\n accept: \"application/json\",\n \"content-type\": \"application/json\",\n ...(init?.headers as Record<string, string> | undefined),\n };\n return fetchJsonOrNull<T>(url, {\n method: init?.method,\n headers,\n body: init?.body ?? undefined,\n retries: 3,\n });\n}\n\n/**\n * The FastKV registry as a Context.Service (#425): reads (config, published\n * config, history, deploy manifests) and the bos:// URL algebra behind one\n * tag. The registry WRITE is a signing concern — it rides the signer\n * services (#423), not this tag. Callers may keep using the plain\n * functions — the module is the implementation; the tag is the seam.\n */\nexport class FastKVRegistryService extends Context.Service<\n FastKVRegistryService,\n {\n fetchBosConfigFromFastKv: typeof fetchBosConfigFromFastKv;\n fetchPublishedConfigFromFastKv: typeof fetchPublishedConfigFromFastKv;\n fetchConfigHistory: typeof fetchConfigHistory;\n fetchDeployManifests: typeof fetchDeployManifests;\n }\n>()(\"everything-dev/registry/fastkv\") {\n static readonly Live = Layer.succeed(\n this,\n this.of({\n fetchBosConfigFromFastKv,\n fetchPublishedConfigFromFastKv,\n fetchConfigHistory,\n fetchDeployManifests,\n }),\n );\n}\n"],"mappings":"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"}