@lovelaces-io/storyteller 0.1.0

package/dist/index.js

@@ -0,0 +1,478 @@
+// src/utils.ts
+var ANSI = {
+  reset: "\x1B[0m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[38;2;250;128;114m",
+  grayLight: "\x1B[37m",
+  grayDark: "\x1B[37m"
+};
+function getLevelColor(level) {
+  if (level === "tell") return ANSI.green;
+  if (level === "warn") return ANSI.yellow;
+  return ANSI.red;
+}
+function formatOrigin(origin) {
+  if (!origin?.where) return;
+  if (typeof origin.where === "string") return origin.where;
+  const whereRecord = origin.where;
+  const parts = [whereRecord.app, whereRecord.service, whereRecord.page, whereRecord.component].filter(Boolean).map(String);
+  return parts.length ? parts.join(" / ") : void 0;
+}
+function colorizeJsonSections(json, colors) {
+  const lines = json.split("\n");
+  let insideNotes = false;
+  let bracketDepth = 0;
+  return lines.map((line) => {
+    if (!insideNotes && line.includes('"notes": [')) {
+      insideNotes = true;
+      bracketDepth = countBrackets(line);
+      return `${colors.notes}${line}${colors.reset}`;
+    }
+    if (insideNotes) {
+      const colored = `${colors.notes}${line}${colors.reset}`;
+      bracketDepth += countBrackets(line);
+      if (bracketDepth <= 0) insideNotes = false;
+      return colored;
+    }
+    return `${colors.base}${line}${colors.reset}`;
+  });
+}
+function countBrackets(line) {
+  const openCount = (line.match(/\[/g) || []).length;
+  const closeCount = (line.match(/\]/g) || []).length;
+  return openCount - closeCount;
+}
+
+// src/audiences/consoleAudience.ts
+function consoleAudience() {
+  return {
+    name: "console",
+    hear: (event) => {
+      const prefix = "Storyteller";
+      const style = event.level === "tell" ? "color:#16a34a;font-weight:600" : event.level === "warn" ? "color:#f59e0b;font-weight:600" : "color:#dc2626;font-weight:600";
+      const header = `${prefix}: ${event.title}`;
+      console.groupCollapsed(`%c${header}`, style);
+      const payload = JSON.stringify(event, null, 2);
+      const coloredPayload = event.level === "oops" ? `${ANSI.red}${payload}${ANSI.reset}` : payload;
+      if (event.level === "tell") {
+        console.log(header, payload);
+      } else if (event.level === "warn") {
+        console.warn(header, payload);
+      } else {
+        console.error(header, coloredPayload);
+      }
+      console.groupEnd();
+    }
+  };
+}
+
+// src/storyteller.ts
+var AudienceRegistry = class {
+  members = /* @__PURE__ */ new Map();
+  /** Register an audience member, replacing any existing member with the same name */
+  add(member) {
+    this.members.set(member.name, member);
+    return this;
+  }
+  /** Remove an audience member by name */
+  remove(name) {
+    this.members.delete(name);
+    return this;
+  }
+  /** Return all registered audience members */
+  getAll() {
+    return [...this.members.values()];
+  }
+  /** Return only the audience members matching the given names */
+  getOnly(names) {
+    return names.map((name) => this.members.get(name)).filter(Boolean);
+  }
+};
+var Storyteller = class {
+  audience = new AudienceRegistry();
+  origin;
+  notes = [];
+  constructor(options) {
+    this.origin = options?.origin;
+    this.audience.add(consoleAudience());
+    options?.audiences?.forEach((audience) => this.audience.add(audience));
+  }
+  /** Add a timestamped note with optional context (who, what, where, error) */
+  note(text, data = {}) {
+    this.notes.push({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      note: text,
+      ...data.who ? { who: data.who } : {},
+      ...data.what ? { what: data.what } : {},
+      ...data.where ? { where: data.where } : {},
+      ...data.error ? { error: normalizeError(data.error) } : {}
+    });
+    return this;
+  }
+  /** Clear all accumulated notes without emitting a story */
+  reset() {
+    this.notes = [];
+    return this;
+  }
+  /** Generate a formatted summary of current notes without emitting or clearing them */
+  summarize(options = {}) {
+    const {
+      title = "Story preview",
+      level = "tell",
+      error,
+      ...summaryOptions
+    } = options;
+    const event = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      title,
+      ...this.origin ? { origin: this.origin } : {},
+      notes: [...this.notes],
+      ...error ? { error: normalizeError(error) } : {}
+    };
+    return summarizeStory(event, summaryOptions);
+  }
+  /** Emit a story at the "tell" level (success / informational) */
+  tell(title) {
+    return this.createDelivery("tell", title);
+  }
+  /** Emit a story at the "warn" level (something was off) */
+  warn(title) {
+    return this.createDelivery("warn", title);
+  }
+  /** Emit a story at the "oops" level (something broke) with an optional error */
+  oops(title, error) {
+    return this.createDelivery("oops", title, error);
+  }
+  /** Build a story event and schedule delivery, returning a handle to override the audience list */
+  createDelivery(level, title, error) {
+    const event = this.buildEvent(level, title, error);
+    let delivered = false;
+    let defaultCancelled = false;
+    queueMicrotask(() => {
+      if (delivered || defaultCancelled) return;
+      delivered = true;
+      void this.deliver(event);
+    });
+    return {
+      to: (...names) => {
+        defaultCancelled = true;
+        if (delivered) return;
+        delivered = true;
+        void this.deliver(event, { only: names });
+      }
+    };
+  }
+  /** Assemble the story event from current notes and clear notes for the next story */
+  buildEvent(level, title, error) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const collectedNotes = [...this.notes];
+    this.notes = [];
+    const event = {
+      timestamp: now,
+      level,
+      title,
+      ...this.origin ? { origin: this.origin } : {},
+      notes: collectedNotes,
+      ...error ? { error: normalizeError(error) } : {}
+    };
+    const eventWithSummary = event;
+    Object.defineProperty(eventWithSummary, "summarize", {
+      value: (options) => summarizeStory(event, options),
+      enumerable: false
+    });
+    return eventWithSummary;
+  }
+  /** Deliver a story event to matching audience members */
+  async deliver(event, options) {
+    const targets = options?.only?.length ? this.audience.getOnly(options.only) : this.audience.getAll();
+    await Promise.allSettled(
+      targets.filter((member) => member.accepts ? member.accepts(event) : true).map((member) => member.hear(event))
+    );
+  }
+};
+function normalizeError(rawError) {
+  if (rawError instanceof Error) {
+    const normalized = {
+      name: rawError.name,
+      message: rawError.message
+    };
+    if (rawError.stack !== void 0) {
+      normalized.stack = rawError.stack;
+    }
+    const cause = rawError.cause;
+    if (cause !== void 0) {
+      normalized.cause = cause;
+    }
+    return normalized;
+  }
+  return { message: String(rawError) };
+}
+function calculateNoteDuration(notes) {
+  if (notes.length <= 1) {
+    return {
+      durationMs: void 0
+    };
+  }
+  const startTime = Date.parse(notes[0].timestamp);
+  const endTime = Date.parse(notes[notes.length - 1].timestamp);
+  return {
+    durationMs: Number.isFinite(startTime) && Number.isFinite(endTime) ? Math.max(0, endTime - startTime) : void 0
+  };
+}
+function summarizeStory(story, options = {}) {
+  const {
+    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone,
+    locale = "en-US",
+    verbosity = "normal",
+    maxNotes = 50,
+    showData = true,
+    colorize = true
+  } = options;
+  const dateTimeFormatter = new Intl.DateTimeFormat(locale, {
+    timeZone: timezone,
+    year: "numeric",
+    month: "short",
+    day: "2-digit",
+    hour: "numeric",
+    minute: "2-digit",
+    second: "2-digit"
+  });
+  const timeFormatter = new Intl.DateTimeFormat(locale, {
+    timeZone: timezone,
+    hour: "numeric",
+    minute: "2-digit",
+    second: "2-digit"
+  });
+  const orderedNotes = [...story.notes].sort(
+    (noteA, noteB) => Date.parse(noteA.timestamp) - Date.parse(noteB.timestamp)
+  );
+  const noteTiming = calculateNoteDuration(orderedNotes);
+  const originLabel = formatOrigin(story.origin);
+  const duration = noteTiming.durationMs != null ? formatDuration(noteTiming.durationMs) : void 0;
+  const slicedNotes = orderedNotes.slice(0, maxNotes);
+  const summaryNotes = slicedNotes.map((note) => ({
+    timestamp: note.timestamp,
+    when: timeFormatter.format(new Date(note.timestamp)),
+    note: note.note,
+    text: formatNoteText(note, verbosity),
+    ...note.who ? { who: note.who } : {},
+    ...note.what ? { what: note.what } : {},
+    ...note.where ? { where: note.where } : {},
+    ...note.error ? { error: note.error } : {}
+  }));
+  const data = {
+    title: story.title,
+    level: story.level,
+    when: dateTimeFormatter.format(new Date(story.timestamp)),
+    ...noteTiming.durationMs != null ? { durationMs: noteTiming.durationMs } : {},
+    ...duration ? { duration } : {},
+    ...story.origin ? { origin: story.origin } : {},
+    notes: summaryNotes,
+    ...story.error ? { error: story.error } : {}
+  };
+  const levelColor = getLevelColor(story.level);
+  const label = (text) => colorize ? `${levelColor}${text}${ANSI.reset}` : text;
+  const lines = [];
+  lines.push(`${label("Story")}: ${story.title}`);
+  lines.push(`${label("Level")}: ${story.level}`);
+  lines.push(`${label("Time")}: ${data.when}${duration ? ` (${duration})` : ""}`);
+  if (originLabel) {
+    lines.push(`${label("Origin")}: ${originLabel}`);
+  }
+  if (story.error) {
+    const errorLine = [story.error.name, story.error.message].filter(Boolean).join(": ");
+    if (errorLine) lines.push(`${label("Error")}: ${errorLine}`);
+  }
+  if (verbosity !== "brief" && summaryNotes.length) {
+    lines.push(`${label("Notes")}:`);
+    for (const note of summaryNotes) {
+      lines.push(`  ${note.when} \u2014 ${note.text}`);
+    }
+    if (orderedNotes.length > summaryNotes.length) {
+      lines.push(`  \u2026 (${orderedNotes.length - summaryNotes.length} more)`);
+    }
+  }
+  if (showData) {
+    lines.push(`${label("Data")}:`);
+    const json = JSON.stringify(data, null, 2);
+    if (colorize) {
+      const colored = colorizeJsonSections(json, {
+        base: ANSI.grayLight,
+        notes: ANSI.grayDark,
+        reset: ANSI.reset
+      });
+      lines.push(...colored);
+    } else {
+      lines.push(...json.split("\n"));
+    }
+  }
+  return { text: lines.join("\n"), data };
+}
+function formatDuration(milliseconds) {
+  if (milliseconds < 1e3) return `${milliseconds}ms`;
+  const seconds = milliseconds / 1e3;
+  if (seconds < 60) return `${seconds.toFixed(1)}s`;
+  const minutes = Math.floor(seconds / 60);
+  const remainingSeconds = Math.round(seconds % 60).toString().padStart(2, "0");
+  return `${minutes}:${remainingSeconds}m`;
+}
+function formatNoteText(note, verbosity) {
+  if (verbosity !== "full") return note.note;
+  const details = [];
+  const what = note.what;
+  const where = note.where;
+  if (typeof what === "string") {
+    details.push(`what=${what}`);
+  } else if (what) {
+    if (what.field) details.push(`field=${String(what.field)}`);
+    if (what.status) details.push(`status=${String(what.status)}`);
+  }
+  if (typeof where === "string") {
+    details.push(`where=${where}`);
+  } else if (where) {
+    if (where.component) details.push(`component=${String(where.component)}`);
+  }
+  if (note.error) {
+    const errorLine = [note.error.name, note.error.message].filter(Boolean).join(": ");
+    if (errorLine) details.push(`error=${errorLine}`);
+  }
+  return details.length ? `${note.note} (${details.join(" ")})` : note.note;
+}
+
+// src/useStoryteller.ts
+var sharedInstance;
+function useStoryteller(options = {}) {
+  if (!sharedInstance || options.reset) {
+    sharedInstance = new Storyteller({ origin: options.origin });
+    return sharedInstance;
+  }
+  return sharedInstance;
+}
+
+// src/audiences/dbAudience.ts
+function dbAudience(insert) {
+  return {
+    name: "db",
+    accepts: (event) => event.level === "warn" || event.level === "oops",
+    hear: async (event) => {
+      await insert(event);
+    }
+  };
+}
+
+// src/report/writeStoryReport.ts
+function writeStoryReport(stories, options = {}) {
+  const {
+    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone,
+    locale = "en-US",
+    verbosity = "normal",
+    maxNotesPerStory = 50,
+    showData = true,
+    colorize = true
+  } = options;
+  if (!stories.length) {
+    return "Storyteller Report\n\n(no stories)\n";
+  }
+  const sorted = [...stories].sort(
+    (storyA, storyB) => Date.parse(storyA.timestamp) - Date.parse(storyB.timestamp)
+  );
+  const dateFormatter = new Intl.DateTimeFormat(locale, {
+    timeZone: timezone,
+    year: "numeric",
+    month: "short",
+    day: "2-digit"
+  });
+  const firstStory = sorted[0];
+  const lastStory = sorted[sorted.length - 1];
+  if (!firstStory || !lastStory) {
+    return "Storyteller Report\n\n(no stories)\n";
+  }
+  const lines = [];
+  lines.push(`Storyteller Report (${timezone})`);
+  lines.push(
+    `Range: ${dateFormatter.format(new Date(firstStory.timestamp))} \u2013 ${dateFormatter.format(
+      new Date(lastStory.timestamp)
+    )}`
+  );
+  lines.push("");
+  const storiesByDay = /* @__PURE__ */ new Map();
+  for (const story of sorted) {
+    const dayKey = dateFormatter.format(new Date(story.timestamp));
+    const dayEvents = storiesByDay.get(dayKey) ?? [];
+    dayEvents.push(story);
+    storiesByDay.set(dayKey, dayEvents);
+  }
+  for (const [day, dayStories] of storiesByDay) {
+    lines.push(day);
+    for (const story of dayStories) {
+      const summary = summarizeStory(story, {
+        timezone,
+        locale,
+        verbosity,
+        maxNotes: maxNotesPerStory,
+        colorize
+      });
+      const { data } = summary;
+      const originLabel = formatOrigin(story.origin);
+      const levelColor = getLevelColor(story.level);
+      const label = (text) => colorize ? `${levelColor}${text}${ANSI.reset}` : text;
+      const duration = data.duration ? ` (${data.duration})` : "";
+      lines.push(`${label("Story")}: ${story.title}`);
+      lines.push(`${label("Level")}: ${story.level}`);
+      lines.push(`${label("Time")}: ${data.when}${duration}`);
+      if (originLabel) {
+        lines.push(`${label("Origin")}: ${originLabel}`);
+      }
+      if (data.error) {
+        const errorLine = [
+          data.error.name,
+          data.error.message
+        ].filter(Boolean).join(": ");
+        if (errorLine) lines.push(`${label("Error")}: ${errorLine}`);
+      }
+      if (verbosity !== "brief" && data.notes.length) {
+        lines.push(`  ${label("Notes")}:`);
+        for (const summaryNote of data.notes) {
+          lines.push(`    ${summaryNote.when} \u2014 ${summaryNote.text}`);
+        }
+        if (story.notes.length > data.notes.length) {
+          lines.push(
+            `    \u2026 (${story.notes.length - data.notes.length} more)`
+          );
+        }
+      }
+      if (showData) {
+        lines.push(`${label("Data")}:`);
+        const json = JSON.stringify(data, null, 2);
+        if (colorize) {
+          const colored = colorizeJsonSections(json, {
+            base: ANSI.grayLight,
+            notes: ANSI.grayDark,
+            reset: ANSI.reset
+          });
+          lines.push(...colored);
+        } else {
+          lines.push(...json.split("\n"));
+        }
+      }
+      lines.push("");
+    }
+  }
+  return lines.join("\n").trim() + "\n";
+}
+export {
+  ANSI,
+  Storyteller,
+  colorizeJsonSections,
+  consoleAudience,
+  countBrackets,
+  dbAudience,
+  formatOrigin,
+  getLevelColor,
+  summarizeStory,
+  useStoryteller,
+  writeStoryReport
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/audiences/consoleAudience.ts","../src/storyteller.ts","../src/useStoryteller.ts","../src/audiences/dbAudience.ts","../src/report/writeStoryReport.ts"],"sourcesContent":["import type { StoryEventBase, StoryLevel } from \"./storyteller\";\n\n/** ANSI escape codes for terminal colorization */\nexport const ANSI = {\n  reset: \"\\x1b[0m\",\n  green: \"\\x1b[32m\",\n  yellow: \"\\x1b[33m\",\n  red: \"\\x1b[38;2;250;128;114m\",\n  grayLight: \"\\x1b[37m\",\n  grayDark: \"\\x1b[37m\",\n};\n\n/** Map a story level to its corresponding ANSI terminal color */\nexport function getLevelColor(level: StoryLevel): string {\n  if (level === \"tell\") return ANSI.green;\n  if (level === \"warn\") return ANSI.yellow;\n  return ANSI.red;\n}\n\n/** Format an origin context into a human-readable path like \"app / page / component\" */\nexport function formatOrigin(origin?: StoryEventBase[\"origin\"]): string | undefined {\n  if (!origin?.where) return;\n  if (typeof origin.where === \"string\") return origin.where;\n  const whereRecord = origin.where as Record<string, unknown>;\n  const parts = [whereRecord.app, whereRecord.service, whereRecord.page, whereRecord.component]\n    .filter(Boolean)\n    .map(String);\n  return parts.length ? parts.join(\" / \") : undefined;\n}\n\n/** Colorize JSON output, dimming the notes section for visual hierarchy */\nexport function colorizeJsonSections(\n  json: string,\n  colors: { base: string; notes: string; reset: string }\n): string[] {\n  const lines = json.split(\"\\n\");\n  let insideNotes = false;\n  let bracketDepth = 0;\n\n  return lines.map((line) => {\n    if (!insideNotes && line.includes('\"notes\": [')) {\n      insideNotes = true;\n      bracketDepth = countBrackets(line);\n      return `${colors.notes}${line}${colors.reset}`;\n    }\n\n    if (insideNotes) {\n      const colored = `${colors.notes}${line}${colors.reset}`;\n      bracketDepth += countBrackets(line);\n      if (bracketDepth <= 0) insideNotes = false;\n      return colored;\n    }\n\n    return `${colors.base}${line}${colors.reset}`;\n  });\n}\n\n/** Count the net bracket depth change in a line (opening brackets minus closing brackets) */\nexport function countBrackets(line: string): number {\n  const openCount = (line.match(/\\[/g) || []).length;\n  const closeCount = (line.match(/\\]/g) || []).length;\n  return openCount - closeCount;\n}\n","import type { AudienceMember } from \"../storyteller\";\nimport { ANSI } from \"../utils\";\n\n/** Create an audience that logs stories to the browser console with color-coded grouped output */\nexport function consoleAudience(): AudienceMember {\n  return {\n    name: \"console\",\n    hear: (event) => {\n      const prefix = \"Storyteller\";\n\n      const style =\n        event.level === \"tell\"\n          ? \"color:#16a34a;font-weight:600\"\n          : event.level === \"warn\"\n          ? \"color:#f59e0b;font-weight:600\"\n          : \"color:#dc2626;font-weight:600\";\n\n      const header = `${prefix}: ${event.title}`;\n\n      console.groupCollapsed(`%c${header}`, style);\n\n      const payload = JSON.stringify(event, null, 2);\n      const coloredPayload =\n        event.level === \"oops\" ? `${ANSI.red}${payload}${ANSI.reset}` : payload;\n\n      if (event.level === \"tell\") {\n        console.log(header, payload);\n      } else if (event.level === \"warn\") {\n        console.warn(header, payload);\n      } else {\n        console.error(header, coloredPayload);\n      }\n\n      console.groupEnd();\n    },\n  };\n}\n","import { consoleAudience } from \"./audiences/consoleAudience\";\nimport { ANSI, getLevelColor, formatOrigin, colorizeJsonSections } from \"./utils\";\n\nexport type StoryLevel = \"tell\" | \"warn\" | \"oops\";\n\nexport type StoryContextValue = Record<string, unknown> | string;\n\nexport type StoryError = {\n  name?: string;\n  message?: string;\n  stack?: string;\n  cause?: unknown;\n};\n\nexport type StoryNote = {\n  timestamp: string;\n  note: string;\n  who?: StoryContextValue;\n  what?: StoryContextValue;\n  where?: StoryContextValue;\n  error?: StoryError;\n};\n\nexport type StoryEventBase = {\n  timestamp: string;\n  level: StoryLevel;\n  title: string;\n\n  origin?: {\n    who?: StoryContextValue;\n    what?: StoryContextValue;\n    where?: StoryContextValue;\n  };\n\n  notes: StoryNote[];\n\n  error?: StoryError;\n};\n\nexport type StorySummaryOptions = {\n  timezone?: string;\n  locale?: string;\n  verbosity?: \"brief\" | \"normal\" | \"full\";\n  maxNotes?: number;\n  showData?: boolean;\n  colorize?: boolean;\n};\n\nexport type StoryPreviewOptions = StorySummaryOptions & {\n  title?: string;\n  level?: StoryLevel;\n  error?: unknown;\n};\n\nexport type StorySummaryNote = {\n  timestamp: string;\n  when: string;\n  note: string;\n  text: string;\n  who?: StoryContextValue;\n  what?: StoryContextValue;\n  where?: StoryContextValue;\n  error?: StoryError;\n};\n\nexport type StorySummaryData = {\n  title: string;\n  level: StoryLevel;\n  when: string;\n  durationMs?: number;\n  duration?: string;\n  origin?: StoryEventBase[\"origin\"];\n  notes: StorySummaryNote[];\n  error?: StoryError;\n};\n\nexport type StorySummary = {\n  text: string;\n  data: StorySummaryData;\n};\n\nexport type StoryEvent = StoryEventBase & {\n  summarize: (options?: StorySummaryOptions) => StorySummary;\n};\n\nexport type AudienceMember = {\n  name: string;\n  accepts?: (event: StoryEvent) => boolean;\n  hear: (event: StoryEvent) => void | Promise<void>;\n};\n\ntype NoteData = {\n  who?: StoryContextValue;\n  what?: StoryContextValue;\n  where?: StoryContextValue;\n  error?: unknown;\n};\n\n/** Manages the set of audience members that receive story events */\nclass AudienceRegistry {\n  private members = new Map<string, AudienceMember>();\n\n  /** Register an audience member, replacing any existing member with the same name */\n  add(member: AudienceMember) {\n    this.members.set(member.name, member);\n    return this;\n  }\n\n  /** Remove an audience member by name */\n  remove(name: string) {\n    this.members.delete(name);\n    return this;\n  }\n\n  /** Return all registered audience members */\n  getAll() {\n    return [...this.members.values()];\n  }\n\n  /** Return only the audience members matching the given names */\n  getOnly(names: string[]) {\n    return names.map((name) => this.members.get(name)).filter(Boolean) as AudienceMember[];\n  }\n}\n\n/** Core logging class that collects timestamped notes and emits them as structured story events */\nexport class Storyteller {\n  public readonly audience = new AudienceRegistry();\n\n  private readonly origin?: StoryEventBase[\"origin\"];\n  private notes: StoryNote[] = [];\n\n  constructor(options?: { origin?: StoryEventBase[\"origin\"]; audiences?: AudienceMember[] }) {\n    this.origin = options?.origin;\n\n    // Every storyteller gets a console audience by default\n    this.audience.add(consoleAudience());\n\n    options?.audiences?.forEach((audience) => this.audience.add(audience));\n  }\n\n  /** Add a timestamped note with optional context (who, what, where, error) */\n  note(text: string, data: NoteData = {}) {\n    this.notes.push({\n      timestamp: new Date().toISOString(),\n      note: text,\n      ...(data.who ? { who: data.who } : {}),\n      ...(data.what ? { what: data.what } : {}),\n      ...(data.where ? { where: data.where } : {}),\n      ...(data.error ? { error: normalizeError(data.error) } : {}),\n    });\n    return this;\n  }\n\n  /** Clear all accumulated notes without emitting a story */\n  reset() {\n    this.notes = [];\n    return this;\n  }\n\n  /** Generate a formatted summary of current notes without emitting or clearing them */\n  summarize(options: StoryPreviewOptions = {}) {\n    const {\n      title = \"Story preview\",\n      level = \"tell\",\n      error,\n      ...summaryOptions\n    } = options;\n    const event: StoryEventBase = {\n      timestamp: new Date().toISOString(),\n      level,\n      title,\n      ...(this.origin ? { origin: this.origin } : {}),\n      notes: [...this.notes],\n      ...(error ? { error: normalizeError(error) } : {}),\n    };\n\n    return summarizeStory(event, summaryOptions);\n  }\n\n  /** Emit a story at the \"tell\" level (success / informational) */\n  tell(title: string) {\n    return this.createDelivery(\"tell\", title);\n  }\n\n  /** Emit a story at the \"warn\" level (something was off) */\n  warn(title: string) {\n    return this.createDelivery(\"warn\", title);\n  }\n\n  /** Emit a story at the \"oops\" level (something broke) with an optional error */\n  oops(title: string, error?: unknown) {\n    return this.createDelivery(\"oops\", title, error);\n  }\n\n  /** Build a story event and schedule delivery, returning a handle to override the audience list */\n  private createDelivery(level: StoryLevel, title: string, error?: unknown) {\n    const event = this.buildEvent(level, title, error);\n\n    let delivered = false;\n    let defaultCancelled = false;\n\n    // Delivery is microtask-scheduled so .to() can override synchronously\n    queueMicrotask(() => {\n      if (delivered || defaultCancelled) return;\n      delivered = true;\n      void this.deliver(event);\n    });\n\n    return {\n      to: (...names: string[]) => {\n        defaultCancelled = true;\n        if (delivered) return;\n        delivered = true;\n        void this.deliver(event, { only: names });\n      },\n    };\n  }\n\n  /** Assemble the story event from current notes and clear notes for the next story */\n  private buildEvent(level: StoryLevel, title: string, error?: unknown): StoryEvent {\n    const now = new Date().toISOString();\n    const collectedNotes = [...this.notes];\n\n    this.notes = [];\n\n    const event: StoryEventBase = {\n      timestamp: now,\n      level,\n      title,\n      ...(this.origin ? { origin: this.origin } : {}),\n      notes: collectedNotes,\n      ...(error ? { error: normalizeError(error) } : {}),\n    };\n\n    const eventWithSummary = event as StoryEvent;\n    Object.defineProperty(eventWithSummary, \"summarize\", {\n      value: (options?: StorySummaryOptions) => summarizeStory(event, options),\n      enumerable: false,\n    });\n\n    return eventWithSummary;\n  }\n\n  /** Deliver a story event to matching audience members */\n  private async deliver(event: StoryEvent, options?: { only?: string[] }) {\n    const targets = options?.only?.length\n      ? this.audience.getOnly(options.only)\n      : this.audience.getAll();\n\n    await Promise.allSettled(\n      targets\n        .filter((member) => (member.accepts ? member.accepts(event) : true))\n        .map((member) => member.hear(event))\n    );\n  }\n}\n\n/** Convert an unknown error value into a serializable StoryError object */\nfunction normalizeError(rawError: unknown): StoryError {\n  if (rawError instanceof Error) {\n    const normalized: StoryError = {\n      name: rawError.name,\n      message: rawError.message,\n    };\n\n    if (rawError.stack !== undefined) {\n      normalized.stack = rawError.stack;\n    }\n\n    const cause = (rawError as { cause?: unknown }).cause;\n    if (cause !== undefined) {\n      normalized.cause = cause;\n    }\n\n    return normalized;\n  }\n\n  return { message: String(rawError) };\n}\n\n/** Calculate the duration between the first and last note in a sequence */\nfunction calculateNoteDuration(notes: StoryNote[]) {\n  if (notes.length <= 1) {\n    return {\n      durationMs: undefined as number | undefined,\n    };\n  }\n\n  const startTime = Date.parse(notes[0]!.timestamp);\n  const endTime = Date.parse(notes[notes.length - 1]!.timestamp);\n\n  return {\n    durationMs: Number.isFinite(startTime) && Number.isFinite(endTime)\n      ? Math.max(0, endTime - startTime)\n      : undefined,\n  };\n}\n\n/** Generate a formatted, human-readable summary from a story event */\nexport function summarizeStory(\n  story: StoryEventBase,\n  options: StorySummaryOptions = {}\n): StorySummary {\n  const {\n    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone,\n    locale = \"en-US\",\n    verbosity = \"normal\",\n    maxNotes = 50,\n    showData = true,\n    colorize = true,\n  } = options;\n\n  const dateTimeFormatter = new Intl.DateTimeFormat(locale, {\n    timeZone: timezone,\n    year: \"numeric\",\n    month: \"short\",\n    day: \"2-digit\",\n    hour: \"numeric\",\n    minute: \"2-digit\",\n    second: \"2-digit\",\n  });\n\n  const timeFormatter = new Intl.DateTimeFormat(locale, {\n    timeZone: timezone,\n    hour: \"numeric\",\n    minute: \"2-digit\",\n    second: \"2-digit\",\n  });\n\n  const orderedNotes = [...story.notes].sort(\n    (noteA, noteB) => Date.parse(noteA.timestamp) - Date.parse(noteB.timestamp)\n  );\n  const noteTiming = calculateNoteDuration(orderedNotes);\n  const originLabel = formatOrigin(story.origin);\n  const duration =\n    noteTiming.durationMs != null ? formatDuration(noteTiming.durationMs) : undefined;\n\n  const slicedNotes = orderedNotes.slice(0, maxNotes);\n  const summaryNotes: StorySummaryNote[] = slicedNotes.map((note) => ({\n    timestamp: note.timestamp,\n    when: timeFormatter.format(new Date(note.timestamp)),\n    note: note.note,\n    text: formatNoteText(note, verbosity),\n    ...(note.who ? { who: note.who } : {}),\n    ...(note.what ? { what: note.what } : {}),\n    ...(note.where ? { where: note.where } : {}),\n    ...(note.error ? { error: note.error } : {}),\n  }));\n\n  const data: StorySummaryData = {\n    title: story.title,\n    level: story.level,\n    when: dateTimeFormatter.format(new Date(story.timestamp)),\n    ...(noteTiming.durationMs != null ? { durationMs: noteTiming.durationMs } : {}),\n    ...(duration ? { duration } : {}),\n    ...(story.origin ? { origin: story.origin } : {}),\n    notes: summaryNotes,\n    ...(story.error ? { error: story.error } : {}),\n  };\n\n  const levelColor = getLevelColor(story.level);\n  const label = (text: string) =>\n    colorize ? `${levelColor}${text}${ANSI.reset}` : text;\n\n  const lines: string[] = [];\n  lines.push(`${label(\"Story\")}: ${story.title}`);\n  lines.push(`${label(\"Level\")}: ${story.level}`);\n  lines.push(`${label(\"Time\")}: ${data.when}${duration ? ` (${duration})` : \"\"}`);\n\n  if (originLabel) {\n    lines.push(`${label(\"Origin\")}: ${originLabel}`);\n  }\n\n  if (story.error) {\n    const errorLine = [story.error.name, story.error.message]\n      .filter(Boolean)\n      .join(\": \");\n    if (errorLine) lines.push(`${label(\"Error\")}: ${errorLine}`);\n  }\n\n  if (verbosity !== \"brief\" && summaryNotes.length) {\n    lines.push(`${label(\"Notes\")}:`);\n    for (const note of summaryNotes) {\n      lines.push(`  ${note.when} — ${note.text}`);\n    }\n    if (orderedNotes.length > summaryNotes.length) {\n      lines.push(`  … (${orderedNotes.length - summaryNotes.length} more)`);\n    }\n  }\n\n  if (showData) {\n    lines.push(`${label(\"Data\")}:`);\n    const json = JSON.stringify(data, null, 2);\n    if (colorize) {\n      const colored = colorizeJsonSections(json, {\n        base: ANSI.grayLight,\n        notes: ANSI.grayDark,\n        reset: ANSI.reset,\n      });\n      lines.push(...colored);\n    } else {\n      lines.push(...json.split(\"\\n\"));\n    }\n  }\n\n  return { text: lines.join(\"\\n\"), data };\n}\n\n/** Convert milliseconds into a human-readable duration string */\nfunction formatDuration(milliseconds: number): string {\n  if (milliseconds < 1000) return `${milliseconds}ms`;\n  const seconds = milliseconds / 1000;\n  if (seconds < 60) return `${seconds.toFixed(1)}s`;\n  const minutes = Math.floor(seconds / 60);\n  const remainingSeconds = Math.round(seconds % 60)\n    .toString()\n    .padStart(2, \"0\");\n  return `${minutes}:${remainingSeconds}m`;\n}\n\n/** Format a note's text with optional context details when verbosity is \"full\" */\nfunction formatNoteText(\n  note: StoryNote,\n  verbosity: \"brief\" | \"normal\" | \"full\"\n): string {\n  if (verbosity !== \"full\") return note.note;\n\n  const details: string[] = [];\n  const what = note.what;\n  const where = note.where;\n\n  if (typeof what === \"string\") {\n    details.push(`what=${what}`);\n  } else if (what) {\n    if (what.field) details.push(`field=${String(what.field)}`);\n    if (what.status) details.push(`status=${String(what.status)}`);\n  }\n  if (typeof where === \"string\") {\n    details.push(`where=${where}`);\n  } else if (where) {\n    if (where.component) details.push(`component=${String(where.component)}`);\n  }\n  if (note.error) {\n    const errorLine = [note.error.name, note.error.message]\n      .filter(Boolean)\n      .join(\": \");\n    if (errorLine) details.push(`error=${errorLine}`);\n  }\n\n  return details.length\n    ? `${note.note} (${details.join(\" \")})`\n    : note.note;\n}\n","import type { StoryEventBase } from \"./storyteller\";\nimport { Storyteller } from \"./storyteller\";\n\nlet sharedInstance: Storyteller | undefined;\n\ntype StorytellerSharedOptions = {\n  origin?: StoryEventBase[\"origin\"];\n  reset?: boolean;\n};\n\n/** Return a shared singleton Storyteller instance for cross-component or cross-service logging */\nexport function useStoryteller(\n  options: StorytellerSharedOptions = {}\n): Storyteller {\n  if (!sharedInstance || options.reset) {\n    sharedInstance = new Storyteller({ origin: options.origin });\n    return sharedInstance;\n  }\n\n  return sharedInstance;\n}\n","import type { AudienceMember, StoryEvent } from \"../storyteller\";\n\n/** Create an audience that persists warn and oops stories to a database via the provided insert function */\nexport function dbAudience(insert: (event: StoryEvent) => Promise<void> | void): AudienceMember {\n  return {\n    name: \"db\",\n    accepts: (event) => event.level === \"warn\" || event.level === \"oops\",\n    hear: async (event) => {\n      await insert(event);\n    },\n  };\n}\n","import type { StoryEventBase } from \"../storyteller\";\nimport { summarizeStory } from \"../storyteller\";\nimport { ANSI, getLevelColor, formatOrigin, colorizeJsonSections } from \"../utils\";\n\nexport type StoryReportOptions = {\n  timezone?: string;\n  locale?: string;\n  verbosity?: \"brief\" | \"normal\" | \"full\";\n  maxNotesPerStory?: number;\n  showData?: boolean;\n  colorize?: boolean;\n};\n\n/** Generate a formatted report from an array of story events, grouped by day */\nexport function writeStoryReport(\n  stories: StoryEventBase[],\n  options: StoryReportOptions = {}\n): string {\n  const {\n    timezone = Intl.DateTimeFormat().resolvedOptions().timeZone,\n    locale = \"en-US\",\n    verbosity = \"normal\",\n    maxNotesPerStory = 50,\n    showData = true,\n    colorize = true,\n  } = options;\n\n  if (!stories.length) {\n    return \"Storyteller Report\\n\\n(no stories)\\n\";\n  }\n\n  const sorted = [...stories].sort(\n    (storyA, storyB) => Date.parse(storyA.timestamp) - Date.parse(storyB.timestamp)\n  );\n\n  const dateFormatter = new Intl.DateTimeFormat(locale, {\n    timeZone: timezone,\n    year: \"numeric\",\n    month: \"short\",\n    day: \"2-digit\",\n  });\n\n  const firstStory = sorted[0];\n  const lastStory = sorted[sorted.length - 1];\n  if (!firstStory || !lastStory) {\n    return \"Storyteller Report\\n\\n(no stories)\\n\";\n  }\n\n  const lines: string[] = [];\n  lines.push(`Storyteller Report (${timezone})`);\n  lines.push(\n    `Range: ${dateFormatter.format(new Date(firstStory.timestamp))} – ${dateFormatter.format(\n      new Date(lastStory.timestamp)\n    )}`\n  );\n  lines.push(\"\");\n\n  const storiesByDay = new Map<string, StoryEventBase[]>();\n  for (const story of sorted) {\n    const dayKey = dateFormatter.format(new Date(story.timestamp));\n    const dayEvents = storiesByDay.get(dayKey) ?? [];\n    dayEvents.push(story);\n    storiesByDay.set(dayKey, dayEvents);\n  }\n\n  for (const [day, dayStories] of storiesByDay) {\n    lines.push(day);\n\n    for (const story of dayStories) {\n      const summary = summarizeStory(story, {\n        timezone,\n        locale,\n        verbosity,\n        maxNotes: maxNotesPerStory,\n        colorize,\n      });\n      const { data } = summary;\n      const originLabel = formatOrigin(story.origin);\n      const levelColor = getLevelColor(story.level);\n      const label = (text: string) =>\n        colorize ? `${levelColor}${text}${ANSI.reset}` : text;\n\n      const duration = data.duration ? ` (${data.duration})` : \"\";\n      lines.push(`${label(\"Story\")}: ${story.title}`);\n      lines.push(`${label(\"Level\")}: ${story.level}`);\n      lines.push(`${label(\"Time\")}: ${data.when}${duration}`);\n\n      if (originLabel) {\n        lines.push(`${label(\"Origin\")}: ${originLabel}`);\n      }\n\n      if (data.error) {\n        const errorLine = [\n          data.error.name,\n          data.error.message,\n        ]\n          .filter(Boolean)\n          .join(\": \");\n        if (errorLine) lines.push(`${label(\"Error\")}: ${errorLine}`);\n      }\n\n      if (verbosity !== \"brief\" && data.notes.length) {\n        lines.push(`  ${label(\"Notes\")}:`);\n\n        for (const summaryNote of data.notes) {\n          lines.push(`    ${summaryNote.when} — ${summaryNote.text}`);\n        }\n\n        if (story.notes.length > data.notes.length) {\n          lines.push(\n            `    … (${story.notes.length - data.notes.length} more)`\n          );\n        }\n      }\n\n      if (showData) {\n        lines.push(`${label(\"Data\")}:`);\n        const json = JSON.stringify(data, null, 2);\n        if (colorize) {\n          const colored = colorizeJsonSections(json, {\n            base: ANSI.grayLight,\n            notes: ANSI.grayDark,\n            reset: ANSI.reset,\n          });\n          lines.push(...colored);\n        } else {\n          lines.push(...json.split(\"\\n\"));\n        }\n      }\n\n      lines.push(\"\");\n    }\n  }\n\n  return lines.join(\"\\n\").trim() + \"\\n\";\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@lovelaces-io/storyteller",
+  "version": "0.1.0",
+  "description": "Lightweight TypeScript logging library that treats logs as stories: grouped notes emitted as a single structured event.",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lovelaces-io/storyteller.git"
+  },
+  "homepage": "https://github.com/lovelaces-io/storyteller#readme",
+  "bugs": {
+    "url": "https://github.com/lovelaces-io/storyteller/issues"
+  },
+  "keywords": [
+    "logging",
+    "logger",
+    "structured-logging",
+    "storyteller",
+    "events",
+    "observability",
+    "typescript"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test:console": "npm run build && node ./scripts/consoleTest.mjs",
+    "test": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.57.1",
+    "vitest": "^2.0.0"
+  }
+}