datool 0.0.1 → 0.0.2

package/README.md

@@ -169,10 +169,14 @@ Tails a local file and optionally honors `history`.
 
 ```ts
 sources.file({
+  defaultHistory: 5,
   path: "./app.log",
 })
 ```
 
+`defaultHistory` lets the file source emit existing lines on startup when the URL
+does not include a `history` query param.
+
 ### `sources.command(...)`
 
 Spawns a local process and streams stdout lines.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "datool",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "description": "Local-only config-driven log viewer with SSE streaming and a generic table UI.",
   "bin": {

package/src/node/sources/file.ts

@@ -6,6 +6,7 @@ import type { DatoolSource } from "../../shared/types"
 type Resolver<T> = T | ((context: { query: URLSearchParams }) => T)
 
 export type FileSourceOptions = {
+  defaultHistory?: number
   historyParam?: string
   path: Resolver<string>
   pollIntervalMs?: number
@@ -21,20 +22,28 @@ function resolveValue<T>(value: Resolver<T>, query: URLSearchParams) {
   return value
 }
 
-function toHistoryLineCount(query: URLSearchParams, historyParam: string) {
+function normalizeHistoryLineCount(value: number) {
+  if (!Number.isFinite(value) || value <= 0) {
+    return 0
+  }
+
+  return Math.floor(value)
+}
+
+function resolveHistoryLineCount(
+  query: URLSearchParams,
+  historyParam: string,
+  defaultHistory: number
+) {
   const rawValue = query.get(historyParam)
 
   if (!rawValue) {
-    return 0
+    return normalizeHistoryLineCount(defaultHistory)
   }
 
   const parsedValue = Number.parseInt(rawValue, 10)
 
-  if (!Number.isFinite(parsedValue) || parsedValue <= 0) {
-    return 0
-  }
-
-  return parsedValue
+  return normalizeHistoryLineCount(parsedValue)
 }
 
 function normalizeLines(content: string) {
@@ -76,10 +85,15 @@ async function readAppendedText(filePath: string, start: number, end: number) {
 export function fileSource(options: FileSourceOptions): DatoolSource {
   return {
     async open(context) {
+      const defaultHistory = options.defaultHistory ?? 0
       const historyParam = options.historyParam ?? "history"
       const pollIntervalMs = options.pollIntervalMs ?? 250
       const filePath = resolveValue(options.path, context.query)
-      const historyLineCount = toHistoryLineCount(context.query, historyParam)
+      const historyLineCount = resolveHistoryLineCount(
+        context.query,
+        historyParam,
+        defaultHistory
+      )
       let stat = await fs.stat(filePath)
       let position = stat.size
       let remainder = ""