@malv/base

Base framework implementation for Cloudflare Workers (backend).

Purpose

Provides the core implementation of MALV capabilities for backend services running as Cloudflare Workers.

Installation

yarn add @malv/base

Exports

| Export | Description | |--------|-------------| | ./ | Main entry point | | ./create-response | AI response message creation with streaming | | ./external-ai | AI provider abstraction (Claude, OpenAI) | | ./conversations | Conversation management operations | | ./objects | Object storage CRUD operations | | ./token | Token signing implementation | | ./crypto | Encryption/decryption utilities | | ./validate | JSON schema validation | | ./log | Logging utilities | | ./expression-resolver | Tool expression resolution |

Usage

// AI provider
import { ExternalAI } from '@malv/base/external-ai';
const ai = new ExternalAI('anthropic', apiKey);

// Token signing
import { TokenReferenceImpl } from '@malv/base/token';
const tokenRef = new TokenReferenceImpl({ tokenServiceUrl, appId, appSecret });
const signedToken = await tokenRef.sign(payload, 'current');

// Conversations
import { Conversations } from '@malv/base/conversations';
const conversations = new Conversations(storage);
const conv = await conversations.create({ title: 'My Chat' });

// Objects
import { Objects } from '@malv/base/objects';
const objects = new Objects(storage, conversationId);
await objects.set('my-object', { type: 'custom', data: {} });

Architecture

src/
├── frontware/     # High-level operations (conversations, objects, response creation)
├── middleware/    # Service integrations (AI, crypto, validation)
├── token/         # Token signing implementation
├── log/           # Logging utilities
└── universal/     # Shared logic (expression resolver)

Dependencies

• @malv/types - Core type definitions
• @anthropic-ai/sdk - Claude AI integration
• openai - OpenAI integration

License

MIT