@kb-labs/adapters 0.5.0

package/packages/adapters-log-sqlite/src/manifest.ts

@@ -0,0 +1,36 @@
+/**
+ * @module @kb-labs/adapters-log-sqlite/manifest
+ * Adapter manifest for SQLite log persistence extension.
+ */
+
+import type { AdapterManifest } from "@kb-labs/core-platform";
+
+/**
+ * Adapter manifest for SQLite log persistence extension.
+ */
+export const manifest: AdapterManifest = {
+  manifestVersion: "1.0.0",
+  id: "log-persistence",
+  name: "SQLite Log Persistence",
+  version: "1.0.0",
+  description: "SQLite persistence for historical log storage and search",
+  author: "KB Labs Team",
+  license: "KBPL-1.1",
+  type: "extension",
+  implements: "ILogPersistence",
+  requires: {
+    adapters: [{ id: "db", alias: "database" }],
+    platform: ">= 1.0.0",
+  },
+  extends: {
+    adapter: "logger",
+    hook: "onLog",
+    method: "write",
+    priority: 5,
+  },
+  capabilities: {
+    batch: true,
+    search: true,
+    transactions: true,
+  },
+};

package/packages/adapters-log-sqlite/src/schema.sql

@@ -0,0 +1,46 @@
+-- ============================================================================
+-- KB Labs Log Persistence Schema (SQLite)
+-- ============================================================================
+
+-- Logs table
+CREATE TABLE IF NOT EXISTS logs (
+  id TEXT PRIMARY KEY,
+  timestamp INTEGER NOT NULL,
+  level TEXT NOT NULL CHECK(level IN ('trace', 'debug', 'info', 'warn', 'error', 'fatal')),
+  message TEXT NOT NULL,
+  source TEXT NOT NULL,
+  fields TEXT, -- JSON serialized fields
+  created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+);
+
+-- Indexes for common query patterns
+CREATE INDEX IF NOT EXISTS idx_logs_timestamp ON logs(timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_logs_level ON logs(level);
+CREATE INDEX IF NOT EXISTS idx_logs_source ON logs(source);
+CREATE INDEX IF NOT EXISTS idx_logs_created_at ON logs(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_logs_level_timestamp ON logs(level, timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_logs_source_timestamp ON logs(source, timestamp DESC);
+
+-- Full-text search using FTS5
+CREATE VIRTUAL TABLE IF NOT EXISTS logs_fts USING fts5(
+  message,
+  content=logs,
+  content_rowid=rowid
+);
+
+-- Triggers to keep FTS in sync with logs table
+DROP TRIGGER IF EXISTS logs_fts_insert;
+CREATE TRIGGER IF NOT EXISTS logs_fts_insert AFTER INSERT ON logs BEGIN
+  INSERT INTO logs_fts(rowid, message) VALUES (new.rowid, new.message);
+END;
+
+DROP TRIGGER IF EXISTS logs_fts_delete;
+CREATE TRIGGER IF NOT EXISTS logs_fts_delete AFTER DELETE ON logs BEGIN
+  INSERT INTO logs_fts(logs_fts, rowid, message) VALUES('delete', old.rowid, old.message);
+END;
+
+DROP TRIGGER IF EXISTS logs_fts_update;
+CREATE TRIGGER IF NOT EXISTS logs_fts_update AFTER UPDATE ON logs BEGIN
+  INSERT INTO logs_fts(logs_fts, rowid, message) VALUES('delete', old.rowid, old.message);
+  INSERT INTO logs_fts(rowid, message) VALUES (new.rowid, new.message);
+END;

package/packages/adapters-log-sqlite/tsconfig.build.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "baseUrl": ".",
+    "paths": {}
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "dist",
+    "node_modules"
+  ]
+}

package/packages/adapters-log-sqlite/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@kb-labs/devkit/tsconfig/node.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/packages/adapters-log-sqlite/tsup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsup';
+import nodePreset from '@kb-labs/devkit/tsup/node';
+
+export default defineConfig({
+  ...nodePreset,
+  tsconfig: 'tsconfig.build.json',
+  entry: ['src/index.ts', 'src/manifest.ts'],
+  dts: true,
+});

package/packages/adapters-log-sqlite/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['src/**/*.test.ts'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      exclude: ['node_modules/', 'dist/', '**/*.test.ts'],
+    },
+    testTimeout: 10000, // 10 seconds for database tests
+  },
+});

package/packages/adapters-mongodb/README.md

@@ -0,0 +1,147 @@
+# @kb-labs/adapters-mongodb
+
+> Part of [KB Labs](https://github.com/KirillBaranov/kb-labs) ecosystem. Works exclusively within KB Labs platform.
+
+MongoDB document database adapter with full aggregation pipeline and index support.
+
+## Overview
+
+| Property | Value |
+|----------|-------|
+| **Implements** | `IDocumentDatabase` |
+| **Type** | `core` |
+| **Requires** | None |
+| **Category** | Database |
+
+## Features
+
+- **Document Storage** - Flexible JSON-like document storage
+- **Aggregation Pipeline** - Complex data transformations
+- **Full-Text Search** - Text indexes for search
+- **Transactions** - Multi-document ACID transactions
+- **Connection Pooling** - Efficient connection management
+
+## Installation
+
+```bash
+pnpm add @kb-labs/adapters-mongodb
+```
+
+## Configuration
+
+Add to your `kb.config.json`:
+
+```json
+{
+  "platform": {
+    "adapters": {
+      "documentDb": "@kb-labs/adapters-mongodb"
+    },
+    "adapterOptions": {
+      "documentDb": {
+        "uri": "mongodb://localhost:27017",
+        "database": "kb-labs",
+        "poolSize": 10
+      }
+    }
+  }
+}
+```
+
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `uri` | `string` | - | MongoDB connection URI |
+| `database` | `string` | - | Database name |
+| `poolSize` | `number` | `10` | Connection pool size |
+
+## Usage
+
+### Via Platform (Recommended)
+
+```typescript
+import { usePlatform } from '@kb-labs/sdk';
+
+const platform = usePlatform();
+
+// Insert document
+await platform.documentDb.insert('users', {
+  name: 'John',
+  email: 'john@example.com'
+});
+
+// Find documents
+const users = await platform.documentDb.find('users', {
+  name: { $regex: 'John' }
+});
+
+// Aggregate
+const stats = await platform.documentDb.aggregate('orders', [
+  { $group: { _id: '$status', count: { $sum: 1 } } }
+]);
+```
+
+### Standalone (Testing/Development)
+
+```typescript
+import { createAdapter } from '@kb-labs/adapters-mongodb';
+
+const db = createAdapter({
+  uri: 'mongodb://localhost:27017',
+  database: 'test'
+});
+
+await db.connect();
+await db.insert('collection', { key: 'value' });
+```
+
+## Adapter Manifest
+
+```typescript
+{
+  id: 'mongodb-documentdb',
+  name: 'MongoDB Document Database',
+  version: '1.0.0',
+  implements: 'IDocumentDatabase',
+  capabilities: {
+    transactions: true,
+    search: true,
+    custom: {
+      aggregation: true,
+      indexes: true,
+      fullText: true,
+    },
+  },
+}
+```
+
+## FAQ
+
+<details>
+<summary><strong>Q: How do I connect to MongoDB Atlas?</strong></summary>
+
+Use the Atlas connection string:
+
+```json
+{
+  "adapterOptions": {
+    "documentDb": {
+      "uri": "mongodb+srv://user:pass@cluster.mongodb.net",
+      "database": "mydb"
+    }
+  }
+}
+```
+</details>
+
+## Related Adapters
+
+| Adapter | Use Case |
+|---------|----------|
+| `@kb-labs/adapters-sqlite` | Embedded SQL database |
+| `@kb-labs/adapters-qdrant` | Vector database for semantic search |
+
+## License
+
+[KB Public License v1.1](../../LICENSE) - KB Labs Team

package/packages/adapters-mongodb/eslint.config.js

@@ -0,0 +1,27 @@
+/**
+ * Standard ESLint configuration template
+ *
+ * This is the canonical template for all @kb-labs packages.
+ * DO NOT modify this file locally - it is synced from @kb-labs/devkit
+ *
+ * Customization guidelines:
+ * - DevKit preset already includes all standard ignores
+ * - Only add project-specific ignores if absolutely necessary
+ * - Document why custom ignores are needed
+ *
+ * @see https://github.com/kb-labs/devkit#eslint-configuration
+ */
+import nodePreset from '@kb-labs/devkit/eslint/node.js';
+
+export default [
+  ...nodePreset,
+
+  // OPTIONAL: Add project-specific ignores only if needed
+  // DevKit preset already ignores: dist/, coverage/, node_modules/, *.d.ts, scripts/, etc.
+  // {
+  //   ignores: [
+  //     // Add ONLY project-specific patterns here
+  //     // Example: '**/*.generated.ts',
+  //   ]
+  // }
+];

package/packages/adapters-mongodb/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@kb-labs/adapters-mongodb",
+  "version": "0.5.0",
+  "description": "MongoDB adapter implementing IDocumentDatabase interface",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./secure-document": {
+      "import": "./dist/secure-document.js",
+      "types": "./dist/secure-document.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix"
+  },
+  "dependencies": {
+    "mongodb": "^6.12.0"
+  },
+  "peerDependencies": {
+    "@kb-labs/core-platform": "*"
+  },
+  "devDependencies": {
+    "@kb-labs/core-platform": "link:../../../../platform/kb-labs-core/packages/core-platform",
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4",
+    "@kb-labs/devkit": "link:../../../kb-labs-devkit",
+    "rimraf": "^6.0.1"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}