# core/persistence/journal.persistence.ts

> 14 lines of code and 2 definitions.

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

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

## Definitions

- `persistJournal` (lexical_declaration, line 11, exported)
- `readJournal` (lexical_declaration, line 7, exported)

## Contained in

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

## Uses

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

## Used by

- [core/coordinators/page.coordinator.ts](https://banes-lab.com/source/build-scripts/core/coordinators/page.coordinator.ts.md)

## Linked from

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

## Source

```typescript
import { EMPTY_JOURNAL, parseJournal } from "#core/converters/journal.converter";
import { existsSync, readFileSync } from "node:fs";
import type { Journal } from "#types/journal.types";
import { absolutePath } from "@ssot/paths";
import { writeCanonicalJson } from "@govlab/canonical-write";

export const readJournal = function readJournal(file = absolutePath("app.journal")): Journal {
    return existsSync(file) ? parseJournal(readFileSync(file, "utf8")) : EMPTY_JOURNAL;
};

export const persistJournal = async function persistJournal(
    journal: Journal,
    file = absolutePath("app.journal"),
): Promise<void> {
    await writeCanonicalJson(file, journal);
};
```