ai.matey.middleware 0.2.0

package/package.json

@@ -0,0 +1,203 @@
+{
+  "name": "ai.matey.middleware",
+  "version": "0.2.0",
+  "description": "Middleware components for AI Matey - Universal AI Adapter System",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./caching": {
+      "import": {
+        "types": "./dist/types/caching.d.ts",
+        "default": "./dist/esm/caching.js"
+      },
+      "require": {
+        "types": "./dist/types/caching.d.ts",
+        "default": "./dist/cjs/caching.js"
+      }
+    },
+    "./retry": {
+      "import": {
+        "types": "./dist/types/retry.d.ts",
+        "default": "./dist/esm/retry.js"
+      },
+      "require": {
+        "types": "./dist/types/retry.d.ts",
+        "default": "./dist/cjs/retry.js"
+      }
+    },
+    "./logging": {
+      "import": {
+        "types": "./dist/types/logging.d.ts",
+        "default": "./dist/esm/logging.js"
+      },
+      "require": {
+        "types": "./dist/types/logging.d.ts",
+        "default": "./dist/cjs/logging.js"
+      }
+    },
+    "./security": {
+      "import": {
+        "types": "./dist/types/security.d.ts",
+        "default": "./dist/esm/security.js"
+      },
+      "require": {
+        "types": "./dist/types/security.d.ts",
+        "default": "./dist/cjs/security.js"
+      }
+    },
+    "./validation": {
+      "import": {
+        "types": "./dist/types/validation.d.ts",
+        "default": "./dist/esm/validation.js"
+      },
+      "require": {
+        "types": "./dist/types/validation.d.ts",
+        "default": "./dist/cjs/validation.js"
+      }
+    },
+    "./conversation-history": {
+      "import": {
+        "types": "./dist/types/conversation-history.d.ts",
+        "default": "./dist/esm/conversation-history.js"
+      },
+      "require": {
+        "types": "./dist/types/conversation-history.d.ts",
+        "default": "./dist/cjs/conversation-history.js"
+      }
+    },
+    "./cost-tracking": {
+      "import": {
+        "types": "./dist/types/cost-tracking.d.ts",
+        "default": "./dist/esm/cost-tracking.js"
+      },
+      "require": {
+        "types": "./dist/types/cost-tracking.d.ts",
+        "default": "./dist/cjs/cost-tracking.js"
+      }
+    },
+    "./opentelemetry": {
+      "import": {
+        "types": "./dist/types/opentelemetry.d.ts",
+        "default": "./dist/esm/opentelemetry.js"
+      },
+      "require": {
+        "types": "./dist/types/opentelemetry.d.ts",
+        "default": "./dist/cjs/opentelemetry.js"
+      }
+    },
+    "./telemetry": {
+      "import": {
+        "types": "./dist/types/telemetry.d.ts",
+        "default": "./dist/esm/telemetry.js"
+      },
+      "require": {
+        "types": "./dist/types/telemetry.d.ts",
+        "default": "./dist/cjs/telemetry.js"
+      }
+    },
+    "./transform": {
+      "import": {
+        "types": "./dist/types/transform.d.ts",
+        "default": "./dist/esm/transform.js"
+      },
+      "require": {
+        "types": "./dist/types/transform.d.ts",
+        "default": "./dist/cjs/transform.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "readme.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "ai.matey.types": "*",
+    "ai.matey.errors": "*",
+    "ai.matey.utils": "*",
+    "ai.matey.core": "*"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.7.0",
+    "@opentelemetry/sdk-trace-base": "^1.30.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.200.0",
+    "@opentelemetry/resources": "^1.30.0",
+    "@opentelemetry/semantic-conventions": "^1.30.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-trace-base": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-trace-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/resources": {
+      "optional": true
+    },
+    "@opentelemetry/semantic-conventions": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^1.30.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.200.0",
+    "@opentelemetry/resources": "^1.30.0",
+    "@opentelemetry/semantic-conventions": "^1.30.0",
+    "ai.matey.testing": "*",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "middleware",
+    "caching",
+    "retry",
+    "logging",
+    "security",
+    "ai-matey"
+  ],
+  "author": "AI Matey",
+  "license": "MIT",
+  "homepage": "https://github.com/johnhenry/ai.matey#readme",
+  "bugs": {
+    "url": "https://github.com/johnhenry/ai.matey/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnhenry/ai.matey.git",
+    "directory": "packages/middleware"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/readme.md

@@ -0,0 +1,103 @@
+# ai.matey.middleware
+
+Middleware components for AI Matey - Universal AI Adapter System.
+
+Part of the [ai.matey](https://github.com/johnhenry/ai.matey) monorepo.
+
+## Installation
+
+```bash
+npm install ai.matey.middleware
+```
+
+## Overview
+
+This package provides middleware components that can be composed into a middleware stack for request/response processing in AI Matey bridges.
+
+## Included Middleware
+
+- **Retry** - Automatic retry with exponential backoff
+- **Caching** - Response caching with configurable storage
+- **Logging** - Request/response logging
+- **Telemetry** - Metrics and telemetry collection
+- **OpenTelemetry** - OpenTelemetry integration
+- **Validation** - Request validation and sanitization
+- **Transform** - Request/response transformation
+- **Security** - Security headers and validation
+- **Cost Tracking** - Token usage and cost tracking
+- **Conversation History** - Conversation state management
+
+## Usage
+
+```typescript
+import { Bridge } from 'ai.matey.core';
+import {
+  createRetryMiddleware,
+  createCachingMiddleware,
+  createLoggingMiddleware,
+  InMemoryCacheStorage,
+} from 'ai.matey.middleware';
+
+const bridge = new Bridge({
+  frontend,
+  backend,
+  middleware: [
+    createLoggingMiddleware({ level: 'info' }),
+    createRetryMiddleware({ maxAttempts: 3 }),
+    createCachingMiddleware({ storage: new InMemoryCacheStorage() }),
+  ],
+});
+```
+
+### Retry Middleware
+
+```typescript
+import { createRetryMiddleware } from 'ai.matey.middleware';
+
+const retry = createRetryMiddleware({
+  maxAttempts: 3,
+  initialDelayMs: 1000,
+  maxDelayMs: 10000,
+  backoffMultiplier: 2,
+});
+```
+
+### Caching Middleware
+
+```typescript
+import { createCachingMiddleware, InMemoryCacheStorage } from 'ai.matey.middleware';
+
+const cache = createCachingMiddleware({
+  storage: new InMemoryCacheStorage(),
+  ttlMs: 60000, // 1 minute
+});
+```
+
+### Validation Middleware
+
+```typescript
+import { createValidationMiddleware } from 'ai.matey.middleware';
+
+const validation = createValidationMiddleware({
+  detectPII: true,
+  detectPromptInjection: true,
+});
+```
+
+### Cost Tracking Middleware
+
+```typescript
+import { createCostTrackingMiddleware, InMemoryCostStorage } from 'ai.matey.middleware';
+
+const costTracking = createCostTrackingMiddleware({
+  storage: new InMemoryCostStorage(),
+});
+```
+
+## API Reference
+
+See the TypeScript definitions for detailed API documentation.
+
+## License
+
+MIT - see [LICENSE](./LICENSE) for details.