# core/persistence/route.persistence.ts

> 21 lines of code and 4 definitions.

Tree: Bane's Lab Build Scripts
Language: typescript
Layer: infrastructure
Canonical: https://banes-lab.com/anatomy/build-scripts#file-build-scripts-core-persistence-route-persistence-ts
Source text: https://banes-lab.com/source/build-scripts/core/persistence/route.persistence.ts.txt

Listed in [core/persistence](https://banes-lab.com/api/source/build-scripts/core/persistence.md), after [core/persistence/page.persistence.ts](https://banes-lab.com/source/build-scripts/core/persistence/page.persistence.ts.md) and before [core/persistence/tab.persistence.ts](https://banes-lab.com/source/build-scripts/core/persistence/tab.persistence.ts.md).

## Definitions

- `persistLedger` (lexical_declaration, line 12, exported)
- `stampLedger` (lexical_declaration, line 16, exported)
- `readLedger` (lexical_declaration, line 8, exported)
- `stamped` (lexical_declaration, line 21, exported)

## Contained in

- [core/persistence](https://banes-lab.com/anatomy/build-scripts/folder-build-scripts-core-persistence.md)

## Uses

- [core/converters/route.converter.ts](https://banes-lab.com/source/build-scripts/core/converters/route.converter.ts.md)
- [core/resolvers/route.resolver.ts](https://banes-lab.com/source/build-scripts/core/resolvers/route.resolver.ts.md)

## Linked from

- [core/converters](https://banes-lab.com/anatomy/build-scripts/folder-build-scripts-core-converters.md)
- [core/persistence](https://banes-lab.com/anatomy/build-scripts/folder-build-scripts-core-persistence.md)
- [core/resolvers](https://banes-lab.com/anatomy/build-scripts/folder-build-scripts-core-resolvers.md)

## Source

```typescript
import type { RouteLedger, StampedRoutes } from "#types/route.types";
import { existsSync, readFileSync } from "node:fs";
import { parseLedger, stampRoutes } from "#core/converters/route.converter";
import type { Discovery } from "#types/site.types";
import { ledgerFile } from "#core/resolvers/route.resolver";
import { writeCanonicalJson } from "@govlab/canonical-write";

export const readLedger = function readLedger(file: string): RouteLedger {
    return existsSync(file) ? parseLedger(readFileSync(file, "utf8")) : {};
};

export const persistLedger = async function persistLedger(file: string, ledger: RouteLedger): Promise<void> {
    await writeCanonicalJson(file, ledger);
};

export const stampLedger = async function stampLedger(
    discovery: Discovery,
    moment: Date,
    file = ledgerFile(),
): Promise<StampedRoutes> {
    const stamped = stampRoutes(readLedger(file), discovery, moment);
    await persistLedger(file, stamped.ledger);
    return stamped;
};
```
