pi-readseek 0.1.0

package/src/find-parsers.ts

@@ -0,0 +1,89 @@
+const SIZE_MULTIPLIERS: Record<string, number> = {
+  "": 1,
+  B: 1,
+  K: 1024,
+  KB: 1024,
+  M: 1024 * 1024,
+  MB: 1024 * 1024,
+  G: 1024 ** 3,
+  GB: 1024 ** 3,
+};
+
+export function parseSize(field: string, value: number | string): number {
+  if (typeof value === "number") {
+    if (!Number.isFinite(value) || value < 0) {
+      throw new Error(
+        `Invalid ${field} value: ${value} (expected a non-negative number of bytes)`,
+      );
+    }
+    return value;
+  }
+
+  const match = /^\s*(\d+(?:\.\d+)?)\s*([a-zA-Z]*)\s*$/.exec(value);
+  if (!match) {
+    throw new Error(
+      `Invalid ${field} value: ${JSON.stringify(value)} ` +
+        `(expected a number with optional B/K/KB/M/MB/G/GB suffix; units are 1024-based)`,
+    );
+  }
+
+  const num = parseFloat(match[1]);
+  const suffix = match[2].toUpperCase();
+  const mult = SIZE_MULTIPLIERS[suffix];
+  if (mult === undefined) {
+    throw new Error(
+      `Invalid ${field} value: ${JSON.stringify(value)} ` +
+        `(unknown unit '${match[2]}'; accepted: B, K, KB, M, MB, G, GB)`,
+    );
+  }
+
+  return Math.round(num * mult);
+}
+
+const RELATIVE_UNIT_MS: Record<string, number> = {
+  m: 60 * 1000,
+  h: 60 * 60 * 1000,
+  d: 24 * 60 * 60 * 1000,
+};
+
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const ISO_TS_RE =
+  /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?(?:Z|[+-]\d{2}:\d{2})$/;
+
+export function parseRelativeOrIsoDate(
+  field: string,
+  value: string,
+  now: Date = new Date(),
+): Date {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(
+      `Invalid ${field} value: ${JSON.stringify(value)} ` +
+        `(expected ISO date/timestamp or relative shorthand like '1h', '24h', '7d', '30m')`,
+    );
+  }
+
+  const rel = /^\s*(\d+)\s*([mhd])\s*$/.exec(value);
+  if (rel) {
+    const n = parseInt(rel[1], 10);
+    return new Date(now.getTime() - n * RELATIVE_UNIT_MS[rel[2]]);
+  }
+
+  if (ISO_DATE_RE.test(value)) {
+    const parsed = new Date(`${value}T00:00:00.000Z`);
+    if (!Number.isNaN(parsed.getTime())) {
+      return parsed;
+    }
+  }
+
+  if (ISO_TS_RE.test(value)) {
+    const parsed = new Date(value);
+    if (!Number.isNaN(parsed.getTime())) {
+      return parsed;
+    }
+  }
+
+  throw new Error(
+    `Invalid ${field} value: ${JSON.stringify(value)} ` +
+      `(expected ISO date/timestamp or relative shorthand like '1h', '24h', '7d', '30m')`,
+  );
+}

package/src/find-stat.ts

@@ -0,0 +1,36 @@
+import * as fsPromises from "node:fs/promises";
+import type { Stats } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+
+export const DEFAULT_STAT_CONCURRENCY = 32;
+export const _testable = {
+  stat: fsPromises.stat,
+};
+
+export async function statAllWithConcurrency(
+  relPaths: string[],
+  baseDir: string,
+  concurrency: number = DEFAULT_STAT_CONCURRENCY,
+): Promise<(Stats | null)[]> {
+  const requested = Number.isFinite(concurrency)
+    ? concurrency
+    : DEFAULT_STAT_CONCURRENCY;
+  const limit = Math.max(1, Math.min(requested, DEFAULT_STAT_CONCURRENCY));
+  const out: (Stats | null)[] = new Array(relPaths.length).fill(null);
+  let next = 0;
+
+  async function worker() {
+    while (true) {
+      const i = next++;
+      if (i >= relPaths.length) return;
+      try {
+        out[i] = await _testable.stat(resolvePath(baseDir, relPaths[i]));
+      } catch {
+        out[i] = null;
+      }
+    }
+  }
+
+  await Promise.all(Array.from({ length: Math.min(limit, relPaths.length) }, () => worker()));
+  return out;
+}