everything-dev
Version:
A consolidated product package for building Module Federation apps with oRPC APIs.
58 lines (56 loc) • 3.1 kB
JavaScript
const require_services_registry_fastkv = require("./fastkv.cjs");
//#region src/services/registry/pointer.ts
/**
* The release-pointer plane's pre-cutover wire (sprint registry-primitive,
* ticket 05). The key model (keys.ts) speaks the post-cutover wire —
* `manifest.json`, `versions/<v>.json`, `deploys/<ts>.json` — but the train
* still writes and the rollback still reads the old keys. Until ticket 10's
* cutover, THIS file is the only place the old wire keys are derived; every
* consumer derives them through here so the flip is one file.
*
* TODO(cutover): delete the templates below and re-point the helpers onto
* keyPathOf({ kind: "manifest" | "version" | "deployRecord", ... }).
*/
/** The pointer key relative to `apps/<account>/<gateway>/` — the form
* `fetchRegistryKey` takes (it wraps with the runtime prefix) and the form
* the history endpoint's `keyPath` parameter takes. The full-key helpers
* below are derived from these — one derivation per wire key, so ticket 10's
* cutover flips this file and nothing else. */
const PLATFORM_POINTER_REL_KEY = "platform.json";
function platformVersionSlotRelKeyOf(version) {
return `platform-versions/${version}.json`;
}
function platformPointerKeyOf(accountId, gatewayId) {
return `apps/${accountId}/${gatewayId}/${PLATFORM_POINTER_REL_KEY}`;
}
function platformVersionSlotKeyOf(accountId, gatewayId, version) {
return `apps/${accountId}/${gatewayId}/${platformVersionSlotRelKeyOf(version)}`;
}
/** The per-deploy audit record's key — the timestamp is munged into a
* FastKV-safe path form. */
function deployAuditKeyOf(accountId, gatewayId, publishedAt) {
return `apps/${accountId}/${gatewayId}/manifests/${publishedAt.replace(/[:.]/g, "-")}.json`;
}
/** The release classifier's pointer read: absent (null) means no release has
* published; a read failure throws — an unknown state must never silently
* classify a release as non-release. The keyPath is RELATIVE —
* `fetchRegistryKey` wraps it with the runtime prefix (a full key here
* double-prefixes the wire key and reads a slot that can never exist). */
function readPlatformPointer(accountId, gatewayId, registry) {
return require_services_registry_fastkv.fetchRegistryKey(accountId, gatewayId, PLATFORM_POINTER_REL_KEY, registry);
}
/** The release leg's immutability check: the version slot must either be
* absent or hold byte-identical content — a divergent republish is a burned
* version. */
function readPlatformVersionSlot(accountId, gatewayId, version, registry) {
return require_services_registry_fastkv.fetchRegistryKey(accountId, gatewayId, platformVersionSlotRelKeyOf(version), registry);
}
//#endregion
exports.PLATFORM_POINTER_REL_KEY = PLATFORM_POINTER_REL_KEY;
exports.deployAuditKeyOf = deployAuditKeyOf;
exports.platformPointerKeyOf = platformPointerKeyOf;
exports.platformVersionSlotKeyOf = platformVersionSlotKeyOf;
exports.platformVersionSlotRelKeyOf = platformVersionSlotRelKeyOf;
exports.readPlatformPointer = readPlatformPointer;
exports.readPlatformVersionSlot = readPlatformVersionSlot;
//# sourceMappingURL=pointer.cjs.map