@kb-labs/adapters-log-document 2.96.0

package/README.md

@@ -0,0 +1,5 @@
+# @kb-labs/adapters-log-document
+
+> Part of [KB Labs](https://github.com/KirillBaranov/kb-labs) ecosystem.
+
+`ILogPersistence` implementation backed by `IDocumentDatabase`. Driver-agnostic — swap sqlite for postgres-JSONB and logs follow.

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+import { ILogPersistence, LogPersistenceConfig, LogRecord, LogQuery } from '@kb-labs/sdk/adapters';
+export { manifest } from './manifest.js';
+
+/**
+ * @module @kb-labs/adapters-log-document
+ *
+ * `ILogPersistence` implementation backed by any `IDocumentDatabase`.
+ *
+ * This is the dogfooded replacement for the old sqlite-only log persistence
+ * adapter: log entries are now stored as documents in a `logs` collection
+ * using the same abstraction every other plugin uses. The platform stays
+ * driver-agnostic — switch from sqlite to postgres-JSONB and logs follow.
+ *
+ * Buffering: writes are queued in memory and flushed in batches to amortise
+ * per-call overhead. `close()` (and the next flush after batchSize entries)
+ * drains the queue.
+ *
+ * Retention: a periodic timer deletes documents older than the configured
+ * thresholds per log level. Without retention the collection grows
+ * unbounded — defaults are applied if `retention` is absent.
+ *
+ * Search: implemented via `$contains` on the message field. Full-text
+ * indexing (FTS5, MongoDB text) is intentionally OUT of scope here — that's
+ * a backend-specific capability and would leak through the contract. If
+ * advanced search is needed, route it via an external index (Meilisearch
+ * etc.) and keep this layer simple.
+ */
+
+declare class DocumentLogPersistence implements ILogPersistence {
+    private readonly docs;
+    private readonly collection;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private readonly retention;
+    private buffer;
+    private flushTimer;
+    private retentionTimer;
+    private closed;
+    private flushing;
+    private initialised;
+    constructor(config: LogPersistenceConfig);
+    write(record: LogRecord): Promise<void>;
+    writeBatch(records: LogRecord[]): Promise<void>;
+    private flush;
+    query(query: LogQuery, options?: {
+        limit?: number;
+        offset?: number;
+        sortBy?: 'timestamp' | 'level';
+        sortOrder?: 'asc' | 'desc';
+    }): Promise<{
+        logs: LogRecord[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    getById(id: string): Promise<LogRecord | null>;
+    search(searchText: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        logs: LogRecord[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    deleteOlderThan(beforeTimestamp: number): Promise<number>;
+    deleteByLevelOlderThan(levels: string[], beforeTimestamp: number): Promise<number>;
+    getStats(): Promise<{
+        totalLogs: number;
+        oldestTimestamp: number;
+        newestTimestamp: number;
+        sizeBytes: number;
+    }>;
+    close(): Promise<void>;
+    private runRetention;
+}
+declare function createAdapter(config: LogPersistenceConfig, deps?: Record<string, unknown>): DocumentLogPersistence;
+
+export { DocumentLogPersistence, createAdapter, createAdapter as default };

package/dist/index.js

@@ -0,0 +1,309 @@
+// src/manifest.ts
+var manifest = {
+  manifestVersion: "1.0.0",
+  id: "log-document",
+  name: "Document-backed Log Persistence",
+  version: "1.0.0",
+  description: "ILogPersistence implementation storing log entries in any IDocumentDatabase. Driver-agnostic.",
+  author: "KB Labs Team",
+  license: "KBPL-1.1",
+  type: "core",
+  implements: "ILogPersistence",
+  contexts: ["workspace", "process"],
+  requires: { adapters: [{ id: "documentDatabase", alias: "documentDatabase" }] },
+  capabilities: {
+    batch: true,
+    search: true,
+    custom: {
+      retentionPolicy: true
+    }
+  },
+  configSchema: {
+    collection: {
+      type: "string",
+      default: "logs",
+      description: "Name of the document collection that stores log entries."
+    },
+    batchSize: {
+      type: "number",
+      default: 100,
+      description: "Batch size for buffered writes."
+    },
+    flushInterval: {
+      type: "number",
+      default: 5e3,
+      description: "Maximum delay before a partial batch is flushed (ms)."
+    }
+  }
+};
+
+// src/index.ts
+var LEVEL_ORDER = {
+  trace: 0,
+  debug: 1,
+  info: 2,
+  warn: 3,
+  error: 4,
+  fatal: 5
+};
+var LEVELS_AT_OR_ABOVE = (min) => {
+  const threshold = LEVEL_ORDER[min];
+  return Object.keys(LEVEL_ORDER).filter((l) => LEVEL_ORDER[l] >= threshold);
+};
+var DEFAULT_RETENTION = {
+  maxAge: 7 * 24 * 60 * 60 * 1e3,
+  // 7 days for warn/error/fatal
+  maxAgeDebug: 60 * 60 * 1e3,
+  // 1 hour for debug/trace
+  maxAgeInfo: 24 * 60 * 60 * 1e3,
+  // 24 hours for info
+  maxSizeBytes: 500 * 1024 * 1024,
+  // 500 MB
+  cleanupIntervalMs: 5 * 60 * 1e3
+  // 5 minutes
+};
+var DocumentLogPersistence = class {
+  docs;
+  collection;
+  batchSize;
+  flushIntervalMs;
+  retention;
+  buffer = [];
+  flushTimer = null;
+  retentionTimer = null;
+  closed = false;
+  flushing = null;
+  initialised;
+  constructor(config) {
+    this.docs = config.documentDatabase;
+    this.collection = config.collection ?? "logs";
+    this.batchSize = config.batchSize ?? 100;
+    this.flushIntervalMs = config.flushInterval ?? 5e3;
+    this.retention = { ...DEFAULT_RETENTION, ...config.retention ?? {} };
+    this.initialised = this.docs.ensureCollection(this.collection, {
+      indexes: [
+        { path: "logId", unique: true },
+        { path: "timestamp" },
+        { path: "level" },
+        { path: "source" }
+      ]
+    });
+    this.flushTimer = setInterval(() => {
+      void this.flush();
+    }, this.flushIntervalMs).unref();
+    this.retentionTimer = setInterval(() => {
+      void this.runRetention();
+    }, this.retention.cleanupIntervalMs).unref();
+  }
+  // ──────────────────────────────────────────────────────────────────────────
+  // Write path (buffered)
+  // ──────────────────────────────────────────────────────────────────────────
+  async write(record) {
+    if (this.closed) {
+      throw new Error("DocumentLogPersistence is closed");
+    }
+    this.buffer.push(record);
+    if (this.buffer.length >= this.batchSize) {
+      void this.flush();
+    }
+  }
+  async writeBatch(records) {
+    if (this.closed) {
+      throw new Error("DocumentLogPersistence is closed");
+    }
+    if (records.length === 0) {
+      return;
+    }
+    this.buffer.push(...records);
+    if (this.buffer.length >= this.batchSize) {
+      void this.flush();
+    }
+  }
+  async flush() {
+    if (this.flushing) {
+      await this.flushing;
+      return;
+    }
+    if (this.buffer.length === 0) {
+      return;
+    }
+    const batch = this.buffer.splice(0, this.buffer.length);
+    this.flushing = (async () => {
+      try {
+        await this.initialised;
+        await this.docs.insertMany(this.collection, batch.map((r) => ({
+          logId: r.id,
+          timestamp: r.timestamp,
+          level: r.level,
+          message: r.message,
+          fields: r.fields,
+          source: r.source
+        })));
+      } catch (err) {
+        this.buffer.unshift(...batch);
+        throw err;
+      } finally {
+        this.flushing = null;
+      }
+    })();
+    await this.flushing;
+  }
+  // ──────────────────────────────────────────────────────────────────────────
+  // Read path
+  // ──────────────────────────────────────────────────────────────────────────
+  async query(query, options) {
+    await this.initialised;
+    const filter = buildFilter(query);
+    const limit = options?.limit ?? 100;
+    const offset = options?.offset ?? 0;
+    const sortField = options?.sortBy ?? "timestamp";
+    const sortDir = options?.sortOrder === "asc" ? 1 : -1;
+    const [total, docs] = await Promise.all([
+      this.docs.count(this.collection, filter),
+      this.docs.find(this.collection, filter, {
+        sort: { [sortField]: sortDir },
+        limit,
+        skip: offset
+      })
+    ]);
+    return {
+      logs: docs.map(toLogRecord),
+      total,
+      hasMore: offset + docs.length < total
+    };
+  }
+  async getById(id) {
+    await this.initialised;
+    const docs = await this.docs.find(this.collection, { logId: { $eq: id } }, { limit: 1 });
+    const first = docs[0];
+    return first ? toLogRecord(first) : null;
+  }
+  async search(searchText, options) {
+    await this.initialised;
+    const filter = { message: { $contains: searchText } };
+    const limit = options?.limit ?? 100;
+    const offset = options?.offset ?? 0;
+    const [total, docs] = await Promise.all([
+      this.docs.count(this.collection, filter),
+      this.docs.find(this.collection, filter, {
+        sort: { timestamp: -1 },
+        limit,
+        skip: offset
+      })
+    ]);
+    return {
+      logs: docs.map(toLogRecord),
+      total,
+      hasMore: offset + docs.length < total
+    };
+  }
+  async deleteOlderThan(beforeTimestamp) {
+    await this.initialised;
+    return this.docs.deleteMany(this.collection, {
+      timestamp: { $lt: beforeTimestamp }
+    });
+  }
+  async deleteByLevelOlderThan(levels, beforeTimestamp) {
+    await this.initialised;
+    return this.docs.deleteMany(this.collection, {
+      $and: [
+        { level: { $in: levels } },
+        { timestamp: { $lt: beforeTimestamp } }
+      ]
+    });
+  }
+  async getStats() {
+    await this.initialised;
+    const [totalLogs, oldest, newest] = await Promise.all([
+      this.docs.count(this.collection, {}),
+      this.docs.find(this.collection, {}, { sort: { timestamp: 1 }, limit: 1 }),
+      this.docs.find(this.collection, {}, { sort: { timestamp: -1 }, limit: 1 })
+    ]);
+    return {
+      totalLogs,
+      oldestTimestamp: oldest[0]?.timestamp ?? 0,
+      newestTimestamp: newest[0]?.timestamp ?? 0,
+      sizeBytes: 0
+    };
+  }
+  async close() {
+    if (this.closed) {
+      return;
+    }
+    this.closed = true;
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    if (this.retentionTimer) {
+      clearInterval(this.retentionTimer);
+      this.retentionTimer = null;
+    }
+    try {
+      await this.flush();
+    } catch {
+    }
+  }
+  // ──────────────────────────────────────────────────────────────────────────
+  // Retention
+  // ──────────────────────────────────────────────────────────────────────────
+  async runRetention() {
+    if (this.closed) {
+      return;
+    }
+    const now = Date.now();
+    try {
+      if (this.retention.maxAgeDebug > 0) {
+        await this.deleteByLevelOlderThan(["trace", "debug"], now - this.retention.maxAgeDebug);
+      } else {
+        await this.deleteByLevelOlderThan(["trace", "debug"], now + 1);
+      }
+      if (this.retention.maxAgeInfo > 0) {
+        await this.deleteByLevelOlderThan(["info"], now - this.retention.maxAgeInfo);
+      }
+      if (this.retention.maxAge > 0) {
+        await this.deleteByLevelOlderThan(["warn", "error", "fatal"], now - this.retention.maxAge);
+      }
+    } catch {
+    }
+  }
+};
+var buildFilter = (query) => {
+  const clauses = [];
+  if (query.level !== void 0) {
+    clauses.push({ level: { $in: LEVELS_AT_OR_ABOVE(query.level) } });
+  }
+  if (query.source !== void 0) {
+    clauses.push({ source: { $eq: query.source } });
+  }
+  if (query.from !== void 0) {
+    clauses.push({ timestamp: { $gte: query.from } });
+  }
+  if (query.to !== void 0) {
+    clauses.push({ timestamp: { $lte: query.to } });
+  }
+  if (clauses.length === 0) {
+    return {};
+  }
+  if (clauses.length === 1) {
+    return clauses[0];
+  }
+  return { $and: clauses };
+};
+var toLogRecord = (doc) => ({
+  id: doc.logId,
+  timestamp: doc.timestamp,
+  level: doc.level,
+  message: doc.message,
+  fields: doc.fields,
+  source: doc.source
+});
+function createAdapter(config, deps) {
+  const resolved = deps?.["documentDatabase"] ? { ...config, documentDatabase: deps["documentDatabase"] } : config;
+  return new DocumentLogPersistence(resolved);
+}
+var index_default = createAdapter;
+
+export { DocumentLogPersistence, createAdapter, index_default as default, manifest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts","../src/index.ts"],"names":[],"mappings":";AAUO,IAAM,QAAA,GAA4B;AAAA,EACvC,eAAA,EAAiB,OAAA;AAAA,EACjB,EAAA,EAAI,cAAA;AAAA,EACJ,IAAA,EAAM,iCAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,WAAA,EACE,+FAAA;AAAA,EACF,MAAA,EAAQ,cAAA;AAAA,EACR,OAAA,EAAS,UAAA;AAAA,EACT,IAAA,EAAM,MAAA;AAAA,EACN,UAAA,EAAY,iBAAA;AAAA,EACZ,QAAA,EAAU,CAAC,WAAA,EAAa,SAAS,CAAA;AAAA,EACjC,QAAA,EAAU,EAAE,QAAA,EAAU,CAAC,EAAE,IAAI,kBAAA,EAAoB,KAAA,EAAO,kBAAA,EAAoB,CAAA,EAAE;AAAA,EAC9E,YAAA,EAAc;AAAA,IACZ,KAAA,EAAO,IAAA;AAAA,IACP,MAAA,EAAQ,IAAA;AAAA,IACR,MAAA,EAAQ;AAAA,MACN,eAAA,EAAiB;AAAA;AACnB,GACF;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,UAAA,EAAY;AAAA,MACV,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,MAAA;AAAA,MACT,WAAA,EAAa;AAAA,KACf;AAAA,IACA,SAAA,EAAW;AAAA,MACT,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,GAAA;AAAA,MACT,WAAA,EAAa;AAAA,KACf;AAAA,IACA,aAAA,EAAe;AAAA,MACb,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,GAAA;AAAA,MACT,WAAA,EAAa;AAAA;AACf;AAEJ;;;ACCA,IAAM,WAAA,GAAwC;AAAA,EAC5C,KAAA,EAAO,CAAA;AAAA,EACP,KAAA,EAAO,CAAA;AAAA,EACP,IAAA,EAAM,CAAA;AAAA,EACN,IAAA,EAAM,CAAA;AAAA,EACN,KAAA,EAAO,CAAA;AAAA,EACP,KAAA,EAAO;AACT,CAAA;AAEA,IAAM,kBAAA,GAAqB,CAAC,GAAA,KAA8B;AACxD,EAAA,MAAM,SAAA,GAAY,YAAY,GAAG,CAAA;AACjC,EAAA,OAAQ,MAAA,CAAO,IAAA,CAAK,WAAW,CAAA,CAAiB,MAAA,CAAO,CAAC,CAAA,KAAM,WAAA,CAAY,CAAC,CAAA,IAAK,SAAS,CAAA;AAC3F,CAAA;AAEA,IAAM,iBAAA,GAC+E;AAAA,EACnF,MAAA,EAAQ,CAAA,GAAI,EAAA,GAAK,EAAA,GAAK,EAAA,GAAK,GAAA;AAAA;AAAA,EAC3B,WAAA,EAAa,KAAK,EAAA,GAAK,GAAA;AAAA;AAAA,EACvB,UAAA,EAAY,EAAA,GAAK,EAAA,GAAK,EAAA,GAAK,GAAA;AAAA;AAAA,EAC3B,YAAA,EAAc,MAAM,IAAA,GAAO,IAAA;AAAA;AAAA,EAC3B,iBAAA,EAAmB,IAAI,EAAA,GAAK;AAAA;AAC9B,CAAA;AAEO,IAAM,yBAAN,MAAwD;AAAA,EAC5C,IAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EAGT,SAAsB,EAAC;AAAA,EACvB,UAAA,GAAoC,IAAA;AAAA,EACpC,cAAA,GAAwC,IAAA;AAAA,EACxC,MAAA,GAAS,KAAA;AAAA,EACT,QAAA,GAAiC,IAAA;AAAA,EACjC,WAAA;AAAA,EAER,YAAY,MAAA,EAA8B;AACxC,IAAA,IAAA,CAAK,OAAO,MAAA,CAAO,gBAAA;AACnB,IAAA,IAAA,CAAK,UAAA,GAAa,OAAO,UAAA,IAAc,MAAA;AACvC,IAAA,IAAA,CAAK,SAAA,GAAY,OAAO,SAAA,IAAa,GAAA;AACrC,IAAA,IAAA,CAAK,eAAA,GAAkB,OAAO,aAAA,IAAiB,GAAA;AAC/C,IAAA,IAAA,CAAK,SAAA,GAAY,EAAE,GAAG,iBAAA,EAAmB,GAAI,MAAA,CAAO,SAAA,IAAa,EAAC,EAAG;AAErE,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,IAAA,CAAK,gBAAA,CAAiB,KAAK,UAAA,EAAY;AAAA,MAC7D,OAAA,EAAS;AAAA,QACP,EAAE,IAAA,EAAM,OAAA,EAAS,MAAA,EAAQ,IAAA,EAAK;AAAA,QAC9B,EAAE,MAAM,WAAA,EAAY;AAAA,QACpB,EAAE,MAAM,OAAA,EAAQ;AAAA,QAChB,EAAE,MAAM,QAAA;AAAS;AACnB,KACD,CAAA;AAED,IAAA,IAAA,CAAK,UAAA,GAAa,YAAY,MAAM;AAAE,MAAA,KAAK,KAAK,KAAA,EAAM;AAAA,IAAG,CAAA,EAAG,IAAA,CAAK,eAAe,CAAA,CAAE,KAAA,EAAM;AACxF,IAAA,IAAA,CAAK,cAAA,GAAiB,YAAY,MAAM;AAAE,MAAA,KAAK,KAAK,YAAA,EAAa;AAAA,IAAG,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,iBAAiB,EAAE,KAAA,EAAM;AAAA,EACjH;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,MAAM,MAAA,EAAkC;AAC5C,IAAA,IAAI,KAAK,MAAA,EAAQ;AAAC,MAAA,MAAM,IAAI,MAAM,kCAAkC,CAAA;AAAA,IAAE;AACtE,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,MAAM,CAAA;AACvB,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,MAAA,IAAU,IAAA,CAAK,SAAA,EAAW;AACxC,MAAA,KAAK,KAAK,KAAA,EAAM;AAAA,IAClB;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,OAAA,EAAqC;AACpD,IAAA,IAAI,KAAK,MAAA,EAAQ;AAAC,MAAA,MAAM,IAAI,MAAM,kCAAkC,CAAA;AAAA,IAAE;AACtE,IAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AAAC,MAAA;AAAA,IAAO;AAClC,IAAA,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,GAAG,OAAO,CAAA;AAC3B,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,MAAA,IAAU,IAAA,CAAK,SAAA,EAAW;AACxC,MAAA,KAAK,KAAK,KAAA,EAAM;AAAA,IAClB;AAAA,EACF;AAAA,EAEA,MAAc,KAAA,GAAuB;AACnC,IAAA,IAAI,KAAK,QAAA,EAAU;AACjB,MAAA,MAAM,IAAA,CAAK,QAAA;AACX,MAAA;AAAA,IACF;AACA,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG;AAAC,MAAA;AAAA,IAAO;AACtC,IAAA,MAAM,QAAQ,IAAA,CAAK,MAAA,CAAO,OAAO,CAAA,EAAG,IAAA,CAAK,OAAO,MAAM,CAAA;AAEtD,IAAA,IAAA,CAAK,YAAY,YAAY;AAC3B,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,WAAA;AACX,QAAA,MAAM,IAAA,CAAK,KAAK,UAAA,CAAmB,IAAA,CAAK,YAAY,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,UACpE,OAAO,CAAA,CAAE,EAAA;AAAA,UACT,WAAW,CAAA,CAAE,SAAA;AAAA,UACb,OAAO,CAAA,CAAE,KAAA;AAAA,UACT,SAAS,CAAA,CAAE,OAAA;AAAA,UACX,QAAQ,CAAA,CAAE,MAAA;AAAA,UACV,QAAQ,CAAA,CAAE;AAAA,UACV,CAAC,CAAA;AAAA,MACL,SAAS,GAAA,EAAK;AAEZ,QAAA,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,GAAG,KAAK,CAAA;AAC5B,QAAA,MAAM,GAAA;AAAA,MACR,CAAA,SAAE;AACA,QAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAAA,MAClB;AAAA,IACF,CAAA,GAAG;AAEH,IAAA,MAAM,IAAA,CAAK,QAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,KAAA,CACJ,KAAA,EACA,OAAA,EAMiE;AACjE,IAAA,MAAM,IAAA,CAAK,WAAA;AACX,IAAA,MAAM,MAAA,GAAS,YAAY,KAAK,CAAA;AAChC,IAAA,MAAM,KAAA,GAAQ,SAAS,KAAA,IAAS,GAAA;AAChC,IAAA,MAAM,MAAA,GAAS,SAAS,MAAA,IAAU,CAAA;AAClC,IAAA,MAAM,SAAA,GAAY,SAAS,MAAA,IAAU,WAAA;AACrC,IAAA,MAAM,OAAA,GAAU,OAAA,EAAS,SAAA,KAAc,KAAA,GAAQ,CAAA,GAAI,EAAA;AAEnD,IAAA,MAAM,CAAC,KAAA,EAAO,IAAI,CAAA,GAAI,MAAM,QAAQ,GAAA,CAAI;AAAA,MACtC,IAAA,CAAK,IAAA,CAAK,KAAA,CAAc,IAAA,CAAK,YAAY,MAAM,CAAA;AAAA,MAC/C,IAAA,CAAK,IAAA,CAAK,IAAA,CAAa,IAAA,CAAK,YAAY,MAAA,EAAQ;AAAA,QAC9C,IAAA,EAAM,EAAE,CAAC,SAAS,GAAG,OAAA,EAAQ;AAAA,QAC7B,KAAA;AAAA,QACA,IAAA,EAAM;AAAA,OACP;AAAA,KACF,CAAA;AAED,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,IAAA,CAAK,GAAA,CAAI,WAAW,CAAA;AAAA,MAC1B,KAAA;AAAA,MACA,OAAA,EAAS,MAAA,GAAS,IAAA,CAAK,MAAA,GAAS;AAAA,KAClC;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,EAAA,EAAuC;AACnD,IAAA,MAAM,IAAA,CAAK,WAAA;AACX,IAAA,MAAM,OAAO,MAAM,IAAA,CAAK,IAAA,CAAK,IAAA,CAAa,KAAK,UAAA,EAAY,EAAE,KAAA,EAAO,EAAE,KAAK,EAAA,EAAG,IAAK,EAAE,KAAA,EAAO,GAAG,CAAA;AAC/F,IAAA,MAAM,KAAA,GAAQ,KAAK,CAAC,CAAA;AACpB,IAAA,OAAO,KAAA,GAAQ,WAAA,CAAY,KAAK,CAAA,GAAI,IAAA;AAAA,EACtC;AAAA,EAEA,MAAM,MAAA,CACJ,UAAA,EACA,OAAA,EACiE;AACjE,IAAA,MAAM,IAAA,CAAK,WAAA;AACX,IAAA,MAAM,SAAiC,EAAE,OAAA,EAAS,EAAE,SAAA,EAAW,YAAW,EAAE;AAC5E,IAAA,MAAM,KAAA,GAAQ,SAAS,KAAA,IAAS,GAAA;AAChC,IAAA,MAAM,MAAA,GAAS,SAAS,MAAA,IAAU,CAAA;AAElC,IAAA,MAAM,CAAC,KAAA,EAAO,IAAI,CAAA,GAAI,MAAM,QAAQ,GAAA,CAAI;AAAA,MACtC,IAAA,CAAK,IAAA,CAAK,KAAA,CAAc,IAAA,CAAK,YAAY,MAAM,CAAA;AAAA,MAC/C,IAAA,CAAK,IAAA,CAAK,IAAA,CAAa,IAAA,CAAK,YAAY,MAAA,EAAQ;AAAA,QAC9C,IAAA,EAAM,EAAE,SAAA,EAAW,EAAA,EAAG;AAAA,QACtB,KAAA;AAAA,QACA,IAAA,EAAM;AAAA,OACP;AAAA,KACF,CAAA;AAED,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,IAAA,CAAK,GAAA,CAAI,WAAW,CAAA;AAAA,MAC1B,KAAA;AAAA,MACA,OAAA,EAAS,MAAA,GAAS,IAAA,CAAK,MAAA,GAAS;AAAA,KAClC;AAAA,EACF;AAAA,EAEA,MAAM,gBAAgB,eAAA,EAA0C;AAC9D,IAAA,MAAM,IAAA,CAAK,WAAA;AACX,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,UAAA,CAAmB,IAAA,CAAK,UAAA,EAAY;AAAA,MACnD,SAAA,EAAW,EAAE,GAAA,EAAK,eAAA;AAAgB,KACnC,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,sBAAA,CAAuB,MAAA,EAAkB,eAAA,EAA0C;AACvF,IAAA,MAAM,IAAA,CAAK,WAAA;AACX,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,UAAA,CAAmB,IAAA,CAAK,UAAA,EAAY;AAAA,MACnD,IAAA,EAAM;AAAA,QACJ,EAAE,KAAA,EAAO,EAAE,GAAA,EAAK,QAAqB,EAAE;AAAA,QACvC,EAAE,SAAA,EAAW,EAAE,GAAA,EAAK,iBAAgB;AAAE;AACxC,KACD,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,QAAA,GAKH;AACD,IAAA,MAAM,IAAA,CAAK,WAAA;AACX,IAAA,MAAM,CAAC,SAAA,EAAW,MAAA,EAAQ,MAAM,CAAA,GAAI,MAAM,QAAQ,GAAA,CAAI;AAAA,MACpD,KAAK,IAAA,CAAK,KAAA,CAAc,IAAA,CAAK,UAAA,EAAY,EAAE,CAAA;AAAA,MAC3C,IAAA,CAAK,IAAA,CAAK,IAAA,CAAa,IAAA,CAAK,YAAY,EAAC,EAAG,EAAE,IAAA,EAAM,EAAE,SAAA,EAAW,CAAA,EAAE,EAAG,KAAA,EAAO,GAAG,CAAA;AAAA,MAChF,IAAA,CAAK,IAAA,CAAK,IAAA,CAAa,IAAA,CAAK,YAAY,EAAC,EAAG,EAAE,IAAA,EAAM,EAAE,SAAA,EAAW,EAAA,EAAG,EAAG,KAAA,EAAO,GAAG;AAAA,KAClF,CAAA;AAKD,IAAA,OAAO;AAAA,MACL,SAAA;AAAA,MACA,eAAA,EAAiB,MAAA,CAAO,CAAC,CAAA,EAAG,SAAA,IAAa,CAAA;AAAA,MACzC,eAAA,EAAiB,MAAA,CAAO,CAAC,CAAA,EAAG,SAAA,IAAa,CAAA;AAAA,MACzC,SAAA,EAAW;AAAA,KACb;AAAA,EACF;AAAA,EAEA,MAAM,KAAA,GAAuB;AAC3B,IAAA,IAAI,KAAK,MAAA,EAAQ;AAAC,MAAA;AAAA,IAAO;AACzB,IAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AACd,IAAA,IAAI,KAAK,UAAA,EAAY;AAAE,MAAA,aAAA,CAAc,KAAK,UAAU,CAAA;AAAG,MAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAAA,IAAM;AAC/E,IAAA,IAAI,KAAK,cAAA,EAAgB;AAAE,MAAA,aAAA,CAAc,KAAK,cAAc,CAAA;AAAG,MAAA,IAAA,CAAK,cAAA,GAAiB,IAAA;AAAA,IAAM;AAC3F,IAAA,IAAI;AACF,MAAA,MAAM,KAAK,KAAA,EAAM;AAAA,IACnB,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,YAAA,GAA8B;AAC1C,IAAA,IAAI,KAAK,MAAA,EAAQ;AAAC,MAAA;AAAA,IAAO;AACzB,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,IAAI;AACF,MAAA,IAAI,IAAA,CAAK,SAAA,CAAU,WAAA,GAAc,CAAA,EAAG;AAClC,QAAA,MAAM,IAAA,CAAK,uBAAuB,CAAC,OAAA,EAAS,OAAO,CAAA,EAAG,GAAA,GAAM,IAAA,CAAK,SAAA,CAAU,WAAW,CAAA;AAAA,MACxF,CAAA,MAAO;AAEL,QAAA,MAAM,KAAK,sBAAA,CAAuB,CAAC,SAAS,OAAO,CAAA,EAAG,MAAM,CAAC,CAAA;AAAA,MAC/D;AACA,MAAA,IAAI,IAAA,CAAK,SAAA,CAAU,UAAA,GAAa,CAAA,EAAG;AACjC,QAAA,MAAM,IAAA,CAAK,uBAAuB,CAAC,MAAM,GAAG,GAAA,GAAM,IAAA,CAAK,UAAU,UAAU,CAAA;AAAA,MAC7E;AACA,MAAA,IAAI,IAAA,CAAK,SAAA,CAAU,MAAA,GAAS,CAAA,EAAG;AAC7B,QAAA,MAAM,IAAA,CAAK,sBAAA,CAAuB,CAAC,MAAA,EAAQ,OAAA,EAAS,OAAO,CAAA,EAAG,GAAA,GAAM,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA;AAAA,MAC3F;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACF;AAEA,IAAM,WAAA,GAAc,CAAC,KAAA,KAA4C;AAC/D,EAAA,MAAM,UAAyC,EAAC;AAChD,EAAA,IAAI,KAAA,CAAM,UAAU,MAAA,EAAW;AAC7B,IAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,KAAA,EAAO,EAAE,GAAA,EAAK,mBAAmB,KAAA,CAAM,KAAK,CAAA,EAAE,EAAG,CAAA;AAAA,EAClE;AACA,EAAA,IAAI,KAAA,CAAM,WAAW,MAAA,EAAW;AAC9B,IAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,MAAA,EAAQ,EAAE,KAAK,KAAA,CAAM,MAAA,IAAU,CAAA;AAAA,EAChD;AACA,EAAA,IAAI,KAAA,CAAM,SAAS,MAAA,EAAW;AAC5B,IAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,SAAA,EAAW,EAAE,MAAM,KAAA,CAAM,IAAA,IAAQ,CAAA;AAAA,EAClD;AACA,EAAA,IAAI,KAAA,CAAM,OAAO,MAAA,EAAW;AAC1B,IAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,SAAA,EAAW,EAAE,MAAM,KAAA,CAAM,EAAA,IAAM,CAAA;AAAA,EAChD;AACA,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,EAAC;AAAA,EAAE;AACrC,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AAAC,IAAA,OAAO,QAAQ,CAAC,CAAA;AAAA,EAAG;AAC9C,EAAA,OAAO,EAAE,MAAM,OAAA,EAAQ;AACzB,CAAA;AAEA,IAAM,WAAA,GAAc,CAAC,GAAA,MAA4B;AAAA,EAC/C,IAAI,GAAA,CAAI,KAAA;AAAA,EACR,WAAW,GAAA,CAAI,SAAA;AAAA,EACf,OAAO,GAAA,CAAI,KAAA;AAAA,EACX,SAAS,GAAA,CAAI,OAAA;AAAA,EACb,QAAQ,GAAA,CAAI,MAAA;AAAA,EACZ,QAAQ,GAAA,CAAI;AACd,CAAA,CAAA;AAEO,SAAS,aAAA,CACd,QACA,IAAA,EACwB;AAIxB,EAAA,MAAM,QAAA,GAAiC,IAAA,GAAO,kBAAkB,CAAA,GAC5D,EAAE,GAAG,MAAA,EAAQ,gBAAA,EAAkB,IAAA,CAAK,kBAAkB,CAAA,EAAuB,GAC7E,MAAA;AACJ,EAAA,OAAO,IAAI,uBAAuB,QAAQ,CAAA;AAC5C;AAEA,IAAO,aAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * @module @kb-labs/adapters-log-document/manifest\n *\n * Manifest for the Document-backed log persistence adapter. It depends on\n * the platform's `documentDatabase` service — register a concrete document\n * driver (sqlite, postgres, mongo) first and this adapter rides on top.\n */\n\nimport type { AdapterManifest } from '@kb-labs/sdk/adapters';\n\nexport const manifest: AdapterManifest = {\n  manifestVersion: '1.0.0',\n  id: 'log-document',\n  name: 'Document-backed Log Persistence',\n  version: '1.0.0',\n  description:\n    'ILogPersistence implementation storing log entries in any IDocumentDatabase. Driver-agnostic.',\n  author: 'KB Labs Team',\n  license: 'KBPL-1.1',\n  type: 'core',\n  implements: 'ILogPersistence',\n  contexts: ['workspace', 'process'],\n  requires: { adapters: [{ id: 'documentDatabase', alias: 'documentDatabase' }] },\n  capabilities: {\n    batch: true,\n    search: true,\n    custom: {\n      retentionPolicy: true,\n    },\n  },\n  configSchema: {\n    collection: {\n      type: 'string',\n      default: 'logs',\n      description: 'Name of the document collection that stores log entries.',\n    },\n    batchSize: {\n      type: 'number',\n      default: 100,\n      description: 'Batch size for buffered writes.',\n    },\n    flushInterval: {\n      type: 'number',\n      default: 5000,\n      description: 'Maximum delay before a partial batch is flushed (ms).',\n    },\n  },\n};\n","/**\n * @module @kb-labs/adapters-log-document\n *\n * `ILogPersistence` implementation backed by any `IDocumentDatabase`.\n *\n * This is the dogfooded replacement for the old sqlite-only log persistence\n * adapter: log entries are now stored as documents in a `logs` collection\n * using the same abstraction every other plugin uses. The platform stays\n * driver-agnostic — switch from sqlite to postgres-JSONB and logs follow.\n *\n * Buffering: writes are queued in memory and flushed in batches to amortise\n * per-call overhead. `close()` (and the next flush after batchSize entries)\n * drains the queue.\n *\n * Retention: a periodic timer deletes documents older than the configured\n * thresholds per log level. Without retention the collection grows\n * unbounded — defaults are applied if `retention` is absent.\n *\n * Search: implemented via `$contains` on the message field. Full-text\n * indexing (FTS5, MongoDB text) is intentionally OUT of scope here — that's\n * a backend-specific capability and would leak through the contract. If\n * advanced search is needed, route it via an external index (Meilisearch\n * etc.) and keep this layer simple.\n */\n\nimport type {\n  ILogPersistence,\n  LogPersistenceConfig,\n  LogRetentionPolicy,\n  LogRecord,\n  LogQuery,\n  LogLevel,\n  IDocumentDatabase,\n  DocumentFilter,\n  BaseDocument,\n} from '@kb-labs/sdk/adapters';\n\nexport { manifest } from './manifest.js';\n\ninterface LogDoc extends BaseDocument {\n  logId: string;\n  timestamp: number;\n  level: LogLevel;\n  message: string;\n  fields: Record<string, unknown>;\n  source: string;\n}\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n  trace: 0,\n  debug: 1,\n  info: 2,\n  warn: 3,\n  error: 4,\n  fatal: 5,\n};\n\nconst LEVELS_AT_OR_ABOVE = (min: LogLevel): LogLevel[] => {\n  const threshold = LEVEL_ORDER[min];\n  return (Object.keys(LEVEL_ORDER) as LogLevel[]).filter((l) => LEVEL_ORDER[l] >= threshold);\n};\n\nconst DEFAULT_RETENTION: Required<Pick<LogRetentionPolicy,\n  'maxAge' | 'maxAgeDebug' | 'maxAgeInfo' | 'maxSizeBytes' | 'cleanupIntervalMs'>> = {\n  maxAge: 7 * 24 * 60 * 60 * 1000,       // 7 days for warn/error/fatal\n  maxAgeDebug: 60 * 60 * 1000,            // 1 hour for debug/trace\n  maxAgeInfo: 24 * 60 * 60 * 1000,        // 24 hours for info\n  maxSizeBytes: 500 * 1024 * 1024,        // 500 MB\n  cleanupIntervalMs: 5 * 60 * 1000,       // 5 minutes\n};\n\nexport class DocumentLogPersistence implements ILogPersistence {\n  private readonly docs: IDocumentDatabase;\n  private readonly collection: string;\n  private readonly batchSize: number;\n  private readonly flushIntervalMs: number;\n  private readonly retention: Required<Pick<LogRetentionPolicy,\n    'maxAge' | 'maxAgeDebug' | 'maxAgeInfo' | 'maxSizeBytes' | 'cleanupIntervalMs'>>;\n\n  private buffer: LogRecord[] = [];\n  private flushTimer: NodeJS.Timeout | null = null;\n  private retentionTimer: NodeJS.Timeout | null = null;\n  private closed = false;\n  private flushing: Promise<void> | null = null;\n  private initialised: Promise<void>;\n\n  constructor(config: LogPersistenceConfig) {\n    this.docs = config.documentDatabase;\n    this.collection = config.collection ?? 'logs';\n    this.batchSize = config.batchSize ?? 100;\n    this.flushIntervalMs = config.flushInterval ?? 5_000;\n    this.retention = { ...DEFAULT_RETENTION, ...(config.retention ?? {}) };\n\n    this.initialised = this.docs.ensureCollection(this.collection, {\n      indexes: [\n        { path: 'logId', unique: true },\n        { path: 'timestamp' },\n        { path: 'level' },\n        { path: 'source' },\n      ],\n    });\n\n    this.flushTimer = setInterval(() => { void this.flush(); }, this.flushIntervalMs).unref();\n    this.retentionTimer = setInterval(() => { void this.runRetention(); }, this.retention.cleanupIntervalMs).unref();\n  }\n\n  // ──────────────────────────────────────────────────────────────────────────\n  // Write path (buffered)\n  // ──────────────────────────────────────────────────────────────────────────\n\n  async write(record: LogRecord): Promise<void> {\n    if (this.closed) {throw new Error('DocumentLogPersistence is closed');}\n    this.buffer.push(record);\n    if (this.buffer.length >= this.batchSize) {\n      void this.flush();\n    }\n  }\n\n  async writeBatch(records: LogRecord[]): Promise<void> {\n    if (this.closed) {throw new Error('DocumentLogPersistence is closed');}\n    if (records.length === 0) {return;}\n    this.buffer.push(...records);\n    if (this.buffer.length >= this.batchSize) {\n      void this.flush();\n    }\n  }\n\n  private async flush(): Promise<void> {\n    if (this.flushing) {\n      await this.flushing;\n      return;\n    }\n    if (this.buffer.length === 0) {return;}\n    const batch = this.buffer.splice(0, this.buffer.length);\n\n    this.flushing = (async () => {\n      try {\n        await this.initialised;\n        await this.docs.insertMany<LogDoc>(this.collection, batch.map((r) => ({\n          logId: r.id,\n          timestamp: r.timestamp,\n          level: r.level,\n          message: r.message,\n          fields: r.fields,\n          source: r.source,\n        })));\n      } catch (err) {\n        // Re-queue on failure so the next attempt picks up the lost batch.\n        this.buffer.unshift(...batch);\n        throw err;\n      } finally {\n        this.flushing = null;\n      }\n    })();\n\n    await this.flushing;\n  }\n\n  // ──────────────────────────────────────────────────────────────────────────\n  // Read path\n  // ──────────────────────────────────────────────────────────────────────────\n\n  async query(\n    query: LogQuery,\n    options?: {\n      limit?: number;\n      offset?: number;\n      sortBy?: 'timestamp' | 'level';\n      sortOrder?: 'asc' | 'desc';\n    },\n  ): Promise<{ logs: LogRecord[]; total: number; hasMore: boolean }> {\n    await this.initialised;\n    const filter = buildFilter(query);\n    const limit = options?.limit ?? 100;\n    const offset = options?.offset ?? 0;\n    const sortField = options?.sortBy ?? 'timestamp';\n    const sortDir = options?.sortOrder === 'asc' ? 1 : -1;\n\n    const [total, docs] = await Promise.all([\n      this.docs.count<LogDoc>(this.collection, filter),\n      this.docs.find<LogDoc>(this.collection, filter, {\n        sort: { [sortField]: sortDir },\n        limit,\n        skip: offset,\n      }),\n    ]);\n\n    return {\n      logs: docs.map(toLogRecord),\n      total,\n      hasMore: offset + docs.length < total,\n    };\n  }\n\n  async getById(id: string): Promise<LogRecord | null> {\n    await this.initialised;\n    const docs = await this.docs.find<LogDoc>(this.collection, { logId: { $eq: id } }, { limit: 1 });\n    const first = docs[0];\n    return first ? toLogRecord(first) : null;\n  }\n\n  async search(\n    searchText: string,\n    options?: { limit?: number; offset?: number },\n  ): Promise<{ logs: LogRecord[]; total: number; hasMore: boolean }> {\n    await this.initialised;\n    const filter: DocumentFilter<LogDoc> = { message: { $contains: searchText } };\n    const limit = options?.limit ?? 100;\n    const offset = options?.offset ?? 0;\n\n    const [total, docs] = await Promise.all([\n      this.docs.count<LogDoc>(this.collection, filter),\n      this.docs.find<LogDoc>(this.collection, filter, {\n        sort: { timestamp: -1 },\n        limit,\n        skip: offset,\n      }),\n    ]);\n\n    return {\n      logs: docs.map(toLogRecord),\n      total,\n      hasMore: offset + docs.length < total,\n    };\n  }\n\n  async deleteOlderThan(beforeTimestamp: number): Promise<number> {\n    await this.initialised;\n    return this.docs.deleteMany<LogDoc>(this.collection, {\n      timestamp: { $lt: beforeTimestamp },\n    });\n  }\n\n  async deleteByLevelOlderThan(levels: string[], beforeTimestamp: number): Promise<number> {\n    await this.initialised;\n    return this.docs.deleteMany<LogDoc>(this.collection, {\n      $and: [\n        { level: { $in: levels as LogLevel[] } },\n        { timestamp: { $lt: beforeTimestamp } },\n      ],\n    });\n  }\n\n  async getStats(): Promise<{\n    totalLogs: number;\n    oldestTimestamp: number;\n    newestTimestamp: number;\n    sizeBytes: number;\n  }> {\n    await this.initialised;\n    const [totalLogs, oldest, newest] = await Promise.all([\n      this.docs.count<LogDoc>(this.collection, {}),\n      this.docs.find<LogDoc>(this.collection, {}, { sort: { timestamp: 1 }, limit: 1 }),\n      this.docs.find<LogDoc>(this.collection, {}, { sort: { timestamp: -1 }, limit: 1 }),\n    ]);\n    // Size is not exposed by IDocumentDatabase by design (it varies wildly\n    // by backend). Returning 0 here is honest — callers driving retention\n    // by size should configure maxAge instead and stop pretending bytes are\n    // a universal currency across drivers.\n    return {\n      totalLogs,\n      oldestTimestamp: oldest[0]?.timestamp ?? 0,\n      newestTimestamp: newest[0]?.timestamp ?? 0,\n      sizeBytes: 0,\n    };\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) {return;}\n    this.closed = true;\n    if (this.flushTimer) { clearInterval(this.flushTimer); this.flushTimer = null; }\n    if (this.retentionTimer) { clearInterval(this.retentionTimer); this.retentionTimer = null; }\n    try {\n      await this.flush();\n    } catch {\n      /* swallow — we tried */\n    }\n  }\n\n  // ──────────────────────────────────────────────────────────────────────────\n  // Retention\n  // ──────────────────────────────────────────────────────────────────────────\n\n  private async runRetention(): Promise<void> {\n    if (this.closed) {return;}\n    const now = Date.now();\n    try {\n      if (this.retention.maxAgeDebug > 0) {\n        await this.deleteByLevelOlderThan(['trace', 'debug'], now - this.retention.maxAgeDebug);\n      } else {\n        // maxAgeDebug = 0 means do not persist debug/trace at all → wipe immediately.\n        await this.deleteByLevelOlderThan(['trace', 'debug'], now + 1);\n      }\n      if (this.retention.maxAgeInfo > 0) {\n        await this.deleteByLevelOlderThan(['info'], now - this.retention.maxAgeInfo);\n      }\n      if (this.retention.maxAge > 0) {\n        await this.deleteByLevelOlderThan(['warn', 'error', 'fatal'], now - this.retention.maxAge);\n      }\n    } catch {\n      /* retention failures should not propagate — they're best-effort cleanup */\n    }\n  }\n}\n\nconst buildFilter = (query: LogQuery): DocumentFilter<LogDoc> => {\n  const clauses: Array<DocumentFilter<LogDoc>> = [];\n  if (query.level !== undefined) {\n    clauses.push({ level: { $in: LEVELS_AT_OR_ABOVE(query.level) } });\n  }\n  if (query.source !== undefined) {\n    clauses.push({ source: { $eq: query.source } });\n  }\n  if (query.from !== undefined) {\n    clauses.push({ timestamp: { $gte: query.from } });\n  }\n  if (query.to !== undefined) {\n    clauses.push({ timestamp: { $lte: query.to } });\n  }\n  if (clauses.length === 0) {return {};}\n  if (clauses.length === 1) {return clauses[0]!;}\n  return { $and: clauses };\n};\n\nconst toLogRecord = (doc: LogDoc): LogRecord => ({\n  id: doc.logId,\n  timestamp: doc.timestamp,\n  level: doc.level,\n  message: doc.message,\n  fields: doc.fields,\n  source: doc.source,\n});\n\nexport function createAdapter(\n  config: LogPersistenceConfig,\n  deps?: Record<string, unknown>,\n): DocumentLogPersistence {\n  // deps.documentDatabase is injected by the adapter-loader when the manifest\n  // declares requires.adapters = [{ id: \"documentDatabase\" }]. Merge it in so\n  // callers don't need to duplicate the reference in adapterOptions config.\n  const resolved: LogPersistenceConfig = deps?.['documentDatabase']\n    ? { ...config, documentDatabase: deps['documentDatabase'] as IDocumentDatabase }\n    : config;\n  return new DocumentLogPersistence(resolved);\n}\n\nexport default createAdapter;\n"]}

package/dist/manifest.d.ts

@@ -0,0 +1,13 @@
+import { AdapterManifest } from '@kb-labs/sdk/adapters';
+
+/**
+ * @module @kb-labs/adapters-log-document/manifest
+ *
+ * Manifest for the Document-backed log persistence adapter. It depends on
+ * the platform's `documentDatabase` service — register a concrete document
+ * driver (sqlite, postgres, mongo) first and this adapter rides on top.
+ */
+
+declare const manifest: AdapterManifest;
+
+export { manifest };

package/dist/manifest.js

@@ -0,0 +1,42 @@
+// src/manifest.ts
+var manifest = {
+  manifestVersion: "1.0.0",
+  id: "log-document",
+  name: "Document-backed Log Persistence",
+  version: "1.0.0",
+  description: "ILogPersistence implementation storing log entries in any IDocumentDatabase. Driver-agnostic.",
+  author: "KB Labs Team",
+  license: "KBPL-1.1",
+  type: "core",
+  implements: "ILogPersistence",
+  contexts: ["workspace", "process"],
+  requires: { adapters: [{ id: "documentDatabase", alias: "documentDatabase" }] },
+  capabilities: {
+    batch: true,
+    search: true,
+    custom: {
+      retentionPolicy: true
+    }
+  },
+  configSchema: {
+    collection: {
+      type: "string",
+      default: "logs",
+      description: "Name of the document collection that stores log entries."
+    },
+    batchSize: {
+      type: "number",
+      default: 100,
+      description: "Batch size for buffered writes."
+    },
+    flushInterval: {
+      type: "number",
+      default: 5e3,
+      description: "Maximum delay before a partial batch is flushed (ms)."
+    }
+  }
+};
+
+export { manifest };
+//# sourceMappingURL=manifest.js.map
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts"],"names":[],"mappings":";AAUO,IAAM,QAAA,GAA4B;AAAA,EACvC,eAAA,EAAiB,OAAA;AAAA,EACjB,EAAA,EAAI,cAAA;AAAA,EACJ,IAAA,EAAM,iCAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,WAAA,EACE,+FAAA;AAAA,EACF,MAAA,EAAQ,cAAA;AAAA,EACR,OAAA,EAAS,UAAA;AAAA,EACT,IAAA,EAAM,MAAA;AAAA,EACN,UAAA,EAAY,iBAAA;AAAA,EACZ,QAAA,EAAU,CAAC,WAAA,EAAa,SAAS,CAAA;AAAA,EACjC,QAAA,EAAU,EAAE,QAAA,EAAU,CAAC,EAAE,IAAI,kBAAA,EAAoB,KAAA,EAAO,kBAAA,EAAoB,CAAA,EAAE;AAAA,EAC9E,YAAA,EAAc;AAAA,IACZ,KAAA,EAAO,IAAA;AAAA,IACP,MAAA,EAAQ,IAAA;AAAA,IACR,MAAA,EAAQ;AAAA,MACN,eAAA,EAAiB;AAAA;AACnB,GACF;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,UAAA,EAAY;AAAA,MACV,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,MAAA;AAAA,MACT,WAAA,EAAa;AAAA,KACf;AAAA,IACA,SAAA,EAAW;AAAA,MACT,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,GAAA;AAAA,MACT,WAAA,EAAa;AAAA,KACf;AAAA,IACA,aAAA,EAAe;AAAA,MACb,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,GAAA;AAAA,MACT,WAAA,EAAa;AAAA;AACf;AAEJ","file":"manifest.js","sourcesContent":["/**\n * @module @kb-labs/adapters-log-document/manifest\n *\n * Manifest for the Document-backed log persistence adapter. It depends on\n * the platform's `documentDatabase` service — register a concrete document\n * driver (sqlite, postgres, mongo) first and this adapter rides on top.\n */\n\nimport type { AdapterManifest } from '@kb-labs/sdk/adapters';\n\nexport const manifest: AdapterManifest = {\n  manifestVersion: '1.0.0',\n  id: 'log-document',\n  name: 'Document-backed Log Persistence',\n  version: '1.0.0',\n  description:\n    'ILogPersistence implementation storing log entries in any IDocumentDatabase. Driver-agnostic.',\n  author: 'KB Labs Team',\n  license: 'KBPL-1.1',\n  type: 'core',\n  implements: 'ILogPersistence',\n  contexts: ['workspace', 'process'],\n  requires: { adapters: [{ id: 'documentDatabase', alias: 'documentDatabase' }] },\n  capabilities: {\n    batch: true,\n    search: true,\n    custom: {\n      retentionPolicy: true,\n    },\n  },\n  configSchema: {\n    collection: {\n      type: 'string',\n      default: 'logs',\n      description: 'Name of the document collection that stores log entries.',\n    },\n    batchSize: {\n      type: 'number',\n      default: 100,\n      description: 'Batch size for buffered writes.',\n    },\n    flushInterval: {\n      type: 'number',\n      default: 5000,\n      description: 'Maximum delay before a partial batch is flushed (ms).',\n    },\n  },\n};\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@kb-labs/adapters-log-document",
+  "description": "ILogPersistence implementation backed by IDocumentDatabase (dogfooded — same abstraction the rest of the platform uses).",
+  "version": "2.96.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.6",
+    "@kb-labs/devkit": "2.96.0",
+    "@kb-labs/sdk": "2.21.2",
+    "@kb-labs/adapters-sqlite": "2.96.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "kb": {
+    "manifest": "./dist/manifest.js"
+  },
+  "peerDependencies": {
+    "@kb-labs/sdk": "^2.21.2"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit"
+  }
+}