@usebetterdev/audit-core 0.7.0 → 0.8.1

package/dist/index.d.cts

@@ -53,6 +53,8 @@ interface AuditQueryResult {
     entries: AuditLog[];
     /** If present, more results are available. Pass to `.after()` for the next page. */
     nextCursor?: string;
+    /** If present, more results are available in the reverse direction. */
+    prevCursor?: string;
 }
 
 /** Callback that executes a query spec against the adapter. */
@@ -170,12 +172,6 @@ interface AuditContext {
     /** Arbitrary key-value metadata. Redaction rules do not apply to metadata. */
     metadata?: Record<string, unknown>;
 }
-/**
- * Database adapter provided by ORM packages (e.g. drizzle, prisma).
- * Passed as the `database` field in `BetterAuditConfig`.
- *
- * `writeLog` is required. `queryLogs` is optional — only needed when `query()` is used.
- */
 /** Aggregated statistics returned by `AuditApi.getStats()`. */
 interface AuditStats {
     totalLogs: number;
@@ -195,12 +191,19 @@ interface AuditStats {
     operationBreakdown: Record<string, number>;
     severityBreakdown: Record<string, number>;
 }
+/**
+ * Database adapter provided by ORM packages (e.g. drizzle, prisma).
+ * Passed as the `database` field in `BetterAuditConfig`.
+ *
+ * `writeLog` is required. `queryLogs` is optional — only needed when `query()` is used.
+ */
 interface AuditDatabaseAdapter {
     writeLog(log: AuditLog): Promise<void>;
     queryLogs?(spec: AuditQuerySpec): Promise<AuditQueryResult>;
     getLogById?(id: string): Promise<AuditLog | null>;
     getStats?(options?: {
         since?: Date;
+        until?: Date;
     }): Promise<AuditStats>;
     purgeLogs?(options: {
         before: Date;
@@ -414,7 +417,7 @@ declare function normalizeInput(operation: AuditOperation, before: Record<string
  * ORM adapters translate this into their own migration format.
  * Core never runs SQL — this is a declarative data structure only.
  */
-type ColumnType = "uuid" | "timestamptz" | "text" | "jsonb" | "boolean";
+type ColumnType = "uuid" | "timestamptz" | "text" | "jsonb" | "boolean" | "integer";
 interface ColumnDefinition {
     type: ColumnType;
     nullable: boolean;
@@ -596,6 +599,7 @@ declare class EnrichmentRegistry {
 /** Flat console-friendly query filters. Single-value fields translated to multi-value internal filters. */
 interface ConsoleQueryFilters {
     tableName?: string;
+    recordId?: string;
     operation?: string;
     actorId?: string;
     severity?: string;
@@ -605,6 +609,10 @@ interface ConsoleQueryFilters {
     search?: string;
     limit?: number;
     cursor?: string;
+    /** Pagination direction: "after" fetches older entries (default), "before" fetches newer entries. */
+    direction?: "after" | "before";
+    /** Sort order: "asc" (oldest first) or "desc" (newest first). Overrides direction-based sort when both present. */
+    order?: "asc" | "desc";
 }
 /** Serializable summary of an enrichment config (function fields stripped). */
 interface EnrichmentSummary {
@@ -617,9 +625,10 @@ interface EnrichmentSummary {
     redact?: string[];
     include?: string[];
 }
-/** Query result extended with a convenience `hasNextPage` flag. */
+/** Query result extended with convenience pagination flags. */
 interface ConsoleQueryResult extends AuditQueryResult {
     hasNextPage: boolean;
+    hasPrevPage: boolean;
 }
 /**
  * High-level API consumed by console endpoints.
@@ -630,11 +639,14 @@ interface ConsoleQueryResult extends AuditQueryResult {
 interface AuditApi {
     /** Query audit log entries with optional flat filters and cursor-based pagination. */
     queryLogs(filters?: ConsoleQueryFilters): Promise<ConsoleQueryResult>;
+    /** Query audit log entries centered around a specific log ID. */
+    queryLogsAround(anchorId: string, filters?: ConsoleQueryFilters): Promise<ConsoleQueryResult>;
     /** Retrieve a single audit log entry by its ID. Returns `null` when not found. */
     getLog(id: string): Promise<AuditLog | null>;
     /** Get aggregated audit statistics. Requires adapter.getStats. */
     getStats(options?: {
         since?: Date;
+        until?: Date;
     }): Promise<AuditStats>;
     /** Get serializable summaries of all registered enrichments. */
     getEnrichments(): EnrichmentSummary[];

package/dist/index.d.ts

@@ -53,6 +53,8 @@ interface AuditQueryResult {
     entries: AuditLog[];
     /** If present, more results are available. Pass to `.after()` for the next page. */
     nextCursor?: string;
+    /** If present, more results are available in the reverse direction. */
+    prevCursor?: string;
 }
 
 /** Callback that executes a query spec against the adapter. */
@@ -170,12 +172,6 @@ interface AuditContext {
     /** Arbitrary key-value metadata. Redaction rules do not apply to metadata. */
     metadata?: Record<string, unknown>;
 }
-/**
- * Database adapter provided by ORM packages (e.g. drizzle, prisma).
- * Passed as the `database` field in `BetterAuditConfig`.
- *
- * `writeLog` is required. `queryLogs` is optional — only needed when `query()` is used.
- */
 /** Aggregated statistics returned by `AuditApi.getStats()`. */
 interface AuditStats {
     totalLogs: number;
@@ -195,12 +191,19 @@ interface AuditStats {
     operationBreakdown: Record<string, number>;
     severityBreakdown: Record<string, number>;
 }
+/**
+ * Database adapter provided by ORM packages (e.g. drizzle, prisma).
+ * Passed as the `database` field in `BetterAuditConfig`.
+ *
+ * `writeLog` is required. `queryLogs` is optional — only needed when `query()` is used.
+ */
 interface AuditDatabaseAdapter {
     writeLog(log: AuditLog): Promise<void>;
     queryLogs?(spec: AuditQuerySpec): Promise<AuditQueryResult>;
     getLogById?(id: string): Promise<AuditLog | null>;
     getStats?(options?: {
         since?: Date;
+        until?: Date;
     }): Promise<AuditStats>;
     purgeLogs?(options: {
         before: Date;
@@ -414,7 +417,7 @@ declare function normalizeInput(operation: AuditOperation, before: Record<string
  * ORM adapters translate this into their own migration format.
  * Core never runs SQL — this is a declarative data structure only.
  */
-type ColumnType = "uuid" | "timestamptz" | "text" | "jsonb" | "boolean";
+type ColumnType = "uuid" | "timestamptz" | "text" | "jsonb" | "boolean" | "integer";
 interface ColumnDefinition {
     type: ColumnType;
     nullable: boolean;
@@ -596,6 +599,7 @@ declare class EnrichmentRegistry {
 /** Flat console-friendly query filters. Single-value fields translated to multi-value internal filters. */
 interface ConsoleQueryFilters {
     tableName?: string;
+    recordId?: string;
     operation?: string;
     actorId?: string;
     severity?: string;
@@ -605,6 +609,10 @@ interface ConsoleQueryFilters {
     search?: string;
     limit?: number;
     cursor?: string;
+    /** Pagination direction: "after" fetches older entries (default), "before" fetches newer entries. */
+    direction?: "after" | "before";
+    /** Sort order: "asc" (oldest first) or "desc" (newest first). Overrides direction-based sort when both present. */
+    order?: "asc" | "desc";
 }
 /** Serializable summary of an enrichment config (function fields stripped). */
 interface EnrichmentSummary {
@@ -617,9 +625,10 @@ interface EnrichmentSummary {
     redact?: string[];
     include?: string[];
 }
-/** Query result extended with a convenience `hasNextPage` flag. */
+/** Query result extended with convenience pagination flags. */
 interface ConsoleQueryResult extends AuditQueryResult {
     hasNextPage: boolean;
+    hasPrevPage: boolean;
 }
 /**
  * High-level API consumed by console endpoints.
@@ -630,11 +639,14 @@ interface ConsoleQueryResult extends AuditQueryResult {
 interface AuditApi {
     /** Query audit log entries with optional flat filters and cursor-based pagination. */
     queryLogs(filters?: ConsoleQueryFilters): Promise<ConsoleQueryResult>;
+    /** Query audit log entries centered around a specific log ID. */
+    queryLogsAround(anchorId: string, filters?: ConsoleQueryFilters): Promise<ConsoleQueryResult>;
     /** Retrieve a single audit log entry by its ID. Returns `null` when not found. */
     getLog(id: string): Promise<AuditLog | null>;
     /** Get aggregated audit statistics. Requires adapter.getStats. */
     getStats(options?: {
         since?: Date;
+        until?: Date;
     }): Promise<AuditStats>;
     /** Get serializable summaries of all registered enrichments. */
     getEnrichments(): EnrichmentSummary[];

package/dist/index.js

@@ -725,8 +725,41 @@ async function runExport(executor, options) {
   return { rowCount };
 }
 
+// src/cursor.ts
+var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function encodeCursor(timestamp, id) {
+  const payload = JSON.stringify({ t: timestamp.toISOString(), i: id });
+  return btoa(payload);
+}
+function decodeCursor(cursor) {
+  let parsed;
+  try {
+    parsed = JSON.parse(atob(cursor));
+  } catch {
+    throw new Error("Invalid cursor: failed to decode");
+  }
+  if (typeof parsed !== "object" || parsed === null || !("t" in parsed) || !("i" in parsed)) {
+    throw new Error("Invalid cursor: missing required fields");
+  }
+  const record = parsed;
+  const t = record["t"];
+  const i = record["i"];
+  if (typeof t !== "string" || typeof i !== "string") {
+    throw new Error("Invalid cursor: fields must be strings");
+  }
+  const timestamp = new Date(t);
+  if (isNaN(timestamp.getTime())) {
+    throw new Error("Invalid cursor: invalid timestamp");
+  }
+  if (!UUID_PATTERN.test(i)) {
+    throw new Error("Invalid cursor: id must be a valid UUID");
+  }
+  return { timestamp, id: i };
+}
+
 // src/audit-api.ts
-var VALID_SEVERITIES = /* @__PURE__ */ new Set(["low", "medium", "high", "critical"]);
+var SEVERITY_VALUES = ["low", "medium", "high", "critical"];
+var VALID_SEVERITIES = new Set(SEVERITY_VALUES);
 var VALID_OPERATIONS = /* @__PURE__ */ new Set(["INSERT", "UPDATE", "DELETE"]);
 function toTimeFilter(date) {
   return { date };
@@ -738,18 +771,23 @@ function buildQuerySpec(filters, effectiveLimit) {
     limit
   };
   if (filters.tableName !== void 0) {
-    spec.filters.resource = { tableName: filters.tableName };
+    spec.filters.resource = filters.recordId !== void 0 ? { tableName: filters.tableName, recordId: filters.recordId } : { tableName: filters.tableName };
   }
   if (filters.actorId !== void 0) {
-    spec.filters.actorIds = [filters.actorId];
+    const raw = filters.actorId.split(",").map((v) => v.trim()).filter((v) => v.length > 0);
+    spec.filters.actorIds = [...new Set(raw)];
   }
   if (filters.severity !== void 0) {
-    if (!VALID_SEVERITIES.has(filters.severity)) {
-      throw new Error(
-        `Invalid severity "${filters.severity}". Must be one of: low, medium, high, critical`
-      );
+    const raw = filters.severity.split(",").map((v) => v.trim()).filter((v) => v.length > 0);
+    const unique = [...new Set(raw)];
+    for (const value of unique) {
+      if (!VALID_SEVERITIES.has(value)) {
+        throw new Error(
+          `Invalid severity "${value}". Must be one of: low, medium, high, critical`
+        );
+      }
     }
-    spec.filters.severities = [filters.severity];
+    spec.filters.severities = unique.filter((v) => VALID_SEVERITIES.has(v));
   }
   if (filters.compliance !== void 0) {
     spec.filters.compliance = [filters.compliance];
@@ -775,6 +813,12 @@ function buildQuerySpec(filters, effectiveLimit) {
   if (filters.cursor !== void 0) {
     spec.cursor = filters.cursor;
   }
+  if (filters.direction === "before") {
+    spec.sortOrder = "asc";
+  }
+  if (filters.order !== void 0) {
+    spec.sortOrder = filters.order;
+  }
   return spec;
 }
 function createAuditApi(adapter, registry, maxQueryLimit) {
@@ -813,12 +857,66 @@ function createAuditApi(adapter, registry, maxQueryLimit) {
   }
   async function queryLogs(filters) {
     const queryFn = requireQueryLogs();
-    const spec = buildQuerySpec(filters ?? {}, effectiveLimit);
+    const resolved = filters ?? {};
+    const spec = buildQuerySpec(resolved, effectiveLimit);
     const result = await queryFn(spec);
+    if (resolved.direction === "before") {
+      const entries = [...result.entries].reverse();
+      const lastEntry = entries[entries.length - 1];
+      return {
+        entries,
+        // Adapter's "next" in ASC = newer entries = our prev
+        ...result.nextCursor !== void 0 && { prevCursor: result.nextCursor },
+        hasPrevPage: result.nextCursor !== void 0,
+        // Since we started from a cursor, there are older entries behind it
+        ...resolved.cursor !== void 0 && lastEntry !== void 0 && { nextCursor: encodeCursor(lastEntry.timestamp, lastEntry.id) },
+        hasNextPage: resolved.cursor !== void 0
+      };
+    }
+    const firstEntry = result.entries[0];
+    const prevCursor = resolved.cursor !== void 0 && firstEntry !== void 0 ? encodeCursor(firstEntry.timestamp, firstEntry.id) : void 0;
     return {
       entries: result.entries,
       ...result.nextCursor !== void 0 && { nextCursor: result.nextCursor },
-      hasNextPage: result.nextCursor !== void 0
+      hasNextPage: result.nextCursor !== void 0,
+      hasPrevPage: resolved.cursor !== void 0,
+      ...prevCursor !== void 0 && { prevCursor }
+    };
+  }
+  async function queryLogsAround(anchorId, filters) {
+    const queryFn = requireQueryLogs();
+    const getLogFn = requireGetLogById();
+    const anchor = await getLogFn(anchorId);
+    if (anchor === null) {
+      return { entries: [], hasNextPage: false, hasPrevPage: false };
+    }
+    const resolved = filters ?? {};
+    const limit = Math.min(resolved.limit ?? effectiveLimit, effectiveLimit);
+    const remaining = Math.max(limit - 1, 0);
+    const olderCount = Math.ceil(remaining / 2);
+    const newerCount = Math.floor(remaining / 2);
+    const anchorCursor = encodeCursor(anchor.timestamp, anchor.id);
+    const { direction: _dir, ...baseFilters } = resolved;
+    const olderSpec = buildQuerySpec({ ...baseFilters, cursor: anchorCursor, limit: olderCount }, effectiveLimit);
+    olderSpec.sortOrder = "desc";
+    const newerSpec = buildQuerySpec({ ...baseFilters, cursor: anchorCursor, limit: newerCount }, effectiveLimit);
+    newerSpec.sortOrder = "asc";
+    const [olderResult, newerResult] = await Promise.all([
+      queryFn(olderSpec),
+      queryFn(newerSpec)
+    ]);
+    const newerEntries = [...newerResult.entries].reverse();
+    const entries = [...newerEntries, anchor, ...olderResult.entries];
+    const hasNextPage = olderResult.nextCursor !== void 0;
+    const hasPrevPage = newerResult.nextCursor !== void 0;
+    const oldest = entries[entries.length - 1];
+    const newest = entries[0];
+    return {
+      entries,
+      hasNextPage,
+      hasPrevPage,
+      ...hasNextPage && oldest !== void 0 && { nextCursor: encodeCursor(oldest.timestamp, oldest.id) },
+      ...hasPrevPage && newest !== void 0 && { prevCursor: encodeCursor(newest.timestamp, newest.id) }
     };
   }
   async function getLog(id) {
@@ -863,7 +961,7 @@ function createAuditApi(adapter, registry, maxQueryLimit) {
   }
   async function exportLogs(filters, format) {
     const queryFn = requireQueryLogs();
-    const exportFormat = format ?? "json";
+    const exportFormat = format ?? "csv";
     const spec = buildQuerySpec(filters ?? {}, effectiveLimit);
     const queryBuilder = new AuditQueryBuilder(
       (s) => queryFn(s),
@@ -889,7 +987,7 @@ function createAuditApi(adapter, registry, maxQueryLimit) {
     const purgeFn = requirePurgeLogs();
     return purgeFn(options);
   }
-  return { queryLogs, getLog, getStats, getEnrichments, exportLogs, purgeLogs };
+  return { queryLogs, queryLogsAround, getLog, getStats, getEnrichments, exportLogs, purgeLogs };
 }
 
 // ../../shared/console-utils/src/index.ts
@@ -923,7 +1021,7 @@ function exceedsMaxLength(value) {
   return value !== void 0 && value.length > MAX_PARAM_LENGTH;
 }
 function hasLongQueryParam(query) {
-  return exceedsMaxLength(query.tableName) || exceedsMaxLength(query.actorId) || exceedsMaxLength(query.cursor) || exceedsMaxLength(query.operation) || exceedsMaxLength(query.severity) || exceedsMaxLength(query.compliance) || exceedsMaxLength(query.search);
+  return exceedsMaxLength(query.tableName) || exceedsMaxLength(query.recordId) || exceedsMaxLength(query.actorId) || exceedsMaxLength(query.cursor) || exceedsMaxLength(query.operation) || exceedsMaxLength(query.severity) || exceedsMaxLength(query.compliance) || exceedsMaxLength(query.search) || exceedsMaxLength(query.around) || exceedsMaxLength(query.direction) || exceedsMaxLength(query.order);
 }
 function parseConsoleQueryFilters(query) {
   const filters = {};
@@ -937,6 +1035,12 @@ function parseConsoleQueryFilters(query) {
   if (query.tableName !== void 0) {
     filters.tableName = query.tableName;
   }
+  if (query.recordId !== void 0) {
+    if (query.tableName === void 0) {
+      return { error: "'recordId' requires 'tableName'" };
+    }
+    filters.recordId = query.recordId;
+  }
   if (query.operation !== void 0) {
     filters.operation = query.operation;
   }
@@ -955,6 +1059,18 @@ function parseConsoleQueryFilters(query) {
   if (query.cursor !== void 0) {
     filters.cursor = query.cursor;
   }
+  if (query.direction !== void 0) {
+    if (query.direction !== "after" && query.direction !== "before") {
+      return { error: "Invalid 'direction': must be 'after' or 'before'" };
+    }
+    filters.direction = query.direction;
+  }
+  if (query.order !== void 0) {
+    if (query.order !== "asc" && query.order !== "desc") {
+      return { error: "Invalid 'order': must be 'asc' or 'desc'" };
+    }
+    filters.order = query.order;
+  }
   if (query.since !== void 0) {
     const since = parseIsoDate(query.since);
     if (since === void 0) {
@@ -969,6 +1085,9 @@ function parseConsoleQueryFilters(query) {
     }
     filters.until = until;
   }
+  if (filters.since !== void 0 && filters.until !== void 0 && filters.since >= filters.until) {
+    return { error: "'since' must be before 'until'" };
+  }
   return { filters };
 }
 function serializeLog(log) {
@@ -985,14 +1104,22 @@ function createAuditConsoleEndpoints(api) {
       requiredPermission: "read",
       async handler(request) {
         try {
-          if (hasLongQueryParam(request.query)) {
+          const query = request.query;
+          if (hasLongQueryParam(query)) {
             return { status: 400, body: { error: "Query parameter exceeds maximum length" } };
           }
-          const parsed = parseConsoleQueryFilters(request.query);
+          const parsed = parseConsoleQueryFilters(query);
           if ("error" in parsed) {
             return { status: 400, body: { error: parsed.error } };
           }
-          const result = await api.queryLogs(parsed.filters);
+          if (parsed.filters.order !== void 0 && parsed.filters.direction !== void 0) {
+            return { status: 400, body: { error: "'order' cannot be combined with 'direction'" } };
+          }
+          const around = query.around;
+          if (around !== void 0 && (parsed.filters.cursor !== void 0 || parsed.filters.direction !== void 0 || parsed.filters.order !== void 0)) {
+            return { status: 400, body: { error: "'around' cannot be combined with 'cursor', 'direction', or 'order'" } };
+          }
+          const result = around !== void 0 ? await api.queryLogsAround(around, parsed.filters) : await api.queryLogs(parsed.filters);
           const body = {
             entries: result.entries.map(serializeLog),
             hasNextPage: result.hasNextPage
@@ -1000,6 +1127,12 @@ function createAuditConsoleEndpoints(api) {
           if (result.nextCursor !== void 0) {
             body.nextCursor = result.nextCursor;
           }
+          if (result.prevCursor !== void 0) {
+            body.prevCursor = result.prevCursor;
+          }
+          if (result.hasPrevPage) {
+            body.hasPrevPage = result.hasPrevPage;
+          }
           return { status: 200, body };
         } catch {
           return { status: 500, body: { error: "Internal server error" } };
@@ -1032,14 +1165,28 @@ function createAuditConsoleEndpoints(api) {
       requiredPermission: "read",
       async handler(request) {
         try {
+          const query = request.query;
+          if (exceedsMaxLength(query.since) || exceedsMaxLength(query.until)) {
+            return { status: 400, body: { error: "Query parameter exceeds maximum length" } };
+          }
           const options = {};
-          if (request.query.since !== void 0) {
-            const since = parseIsoDate(request.query.since);
+          if (query.since !== void 0) {
+            const since = parseIsoDate(query.since);
             if (since === void 0) {
               return { status: 400, body: { error: "Invalid 'since': must be an ISO-8601 date" } };
             }
             options.since = since;
           }
+          if (query.until !== void 0) {
+            const until = parseIsoDate(query.until);
+            if (until === void 0) {
+              return { status: 400, body: { error: "Invalid 'until': must be an ISO-8601 date" } };
+            }
+            options.until = until;
+          }
+          if (options.since !== void 0 && options.until !== void 0 && options.since >= options.until) {
+            return { status: 400, body: { error: "'since' must be before 'until'" } };
+          }
           const stats = await api.getStats(options);
           return { status: 200, body: stats };
         } catch {
@@ -1066,20 +1213,33 @@ function createAuditConsoleEndpoints(api) {
       requiredPermission: "read",
       async handler(request) {
         try {
-          const format = request.query.format;
+          const query = request.query;
+          const format = query.format;
           if (format !== void 0 && format !== "csv" && format !== "json") {
             return { status: 400, body: { error: "Invalid format. Must be 'csv' or 'json'" } };
           }
-          if (hasLongQueryParam(request.query)) {
+          if (hasLongQueryParam(query)) {
             return { status: 400, body: { error: "Query parameter exceeds maximum length" } };
           }
-          const parsed = parseConsoleQueryFilters(request.query);
+          const parsed = parseConsoleQueryFilters(query);
           if ("error" in parsed) {
             return { status: 400, body: { error: parsed.error } };
           }
-          const exportFormat = format;
-          const data = await api.exportLogs(parsed.filters, exportFormat);
-          return { status: 200, body: data };
+          const effectiveFormat = format ?? "csv";
+          const data = await api.exportLogs(parsed.filters, effectiveFormat);
+          const contentType = effectiveFormat === "csv" ? "text/csv; charset=utf-8" : "application/json; charset=utf-8";
+          const ext = effectiveFormat === "csv" ? "csv" : "json";
+          const dateStamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+          const filename = `audit-export-${dateStamp}.${ext}`;
+          return {
+            status: 200,
+            body: data,
+            headers: {
+              "content-type": contentType,
+              "content-disposition": `attachment; filename="${filename}"`,
+              "cache-control": "no-cache"
+            }
+          };
         } catch {
           return { status: 500, body: { error: "Internal server error" } };
         }
@@ -1468,38 +1628,6 @@ var AUDIT_LOG_SCHEMA = {
   }
 };
 
-// src/cursor.ts
-var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function encodeCursor(timestamp, id) {
-  const payload = JSON.stringify({ t: timestamp.toISOString(), i: id });
-  return btoa(payload);
-}
-function decodeCursor(cursor) {
-  let parsed;
-  try {
-    parsed = JSON.parse(atob(cursor));
-  } catch {
-    throw new Error("Invalid cursor: failed to decode");
-  }
-  if (typeof parsed !== "object" || parsed === null || !("t" in parsed) || !("i" in parsed)) {
-    throw new Error("Invalid cursor: missing required fields");
-  }
-  const record = parsed;
-  const t = record["t"];
-  const i = record["i"];
-  if (typeof t !== "string" || typeof i !== "string") {
-    throw new Error("Invalid cursor: fields must be strings");
-  }
-  const timestamp = new Date(t);
-  if (isNaN(timestamp.getTime())) {
-    throw new Error("Invalid cursor: invalid timestamp");
-  }
-  if (!UUID_PATTERN.test(i)) {
-    throw new Error("Invalid cursor: id must be a valid UUID");
-  }
-  return { timestamp, id: i };
-}
-
 // src/escape.ts
 function escapeLikePattern(input) {
   return input.replace(/[%_\\]/g, "\\$&");