poltak-daylio-parser

TypeScript utility library for parsing Daylio CSV exports into reusable structures.

Install

npm install poltak-daylio-parser

Browser + Node usage

Default entry is browser-safe (no node:* imports):

import { parseDaylioCsv, getActivityStats } from "poltak-daylio-parser";

Node-only file parsing helper is exposed via subpath:

import { parseDaylioFile } from "poltak-daylio-parser/node";

Example

import { parseDaylioCsv, getActivityStats } from "poltak-daylio-parser";

const dataset = parseDaylioCsv(csvText, {
  activityMap: {
    x1: "deep work",
    soc: "socializing"
  },
  moodScoreMap: {
    awful: 1,
    meh: 3,
    fantastic: 5
  }
});

const stats = getActivityStats(dataset);

API

• parseDaylioCsv(input, options?) where input is string | Uint8Array
• parseDaylioFile(path, options?) from poltak-daylio-parser/node
• groupByDate(entries)
• getActivityStats(dataset)

ParseOptions

• activityMap?: Record<string, string>
• moodScoreMap?: Record<string, number>
• normalizeActivityKey?: (activity: string) => string
• normalizeMoodKey?: (mood: string) => string
• preserveUnmappedActivities?: boolean
• onUnknownMood?: "null" | "error"
• dedupeActivitiesPerEntry?: boolean
• trimExtraWhitespace?: boolean

Notes

• Handles UTF-8 BOM in Daylio export files.
• Keeps both activitiesRaw and mapped activities for traceability.
• Supports extra columns in Daylio CSV (for example scales) as long as required columns are present.
• note_title and note columns are optional; missing columns are treated as null.
• moodScore is null when no moodScoreMap is provided (or for unknown moods when onUnknownMood is "null").