@mastra/cloudflare 1.6.4-alpha.0 → 1.6.4

package/README.md

@@ -8,33 +8,15 @@ Cloudflare KV store for Mastra, providing scalable and serverless storage for th
 npm install @mastra/cloudflare
 ```
 
-## Prerequisites
-
-- Cloudflare account with KV namespaces set up
-- Node.js 22.13.0 or later
-- (Optional) Cloudflare Worker for Workers API mode
-
 ## Usage
 
 ```typescript
 import { CloudflareStore } from '@mastra/cloudflare';
 
-// Using Workers Binding API
-const store = new CloudflareStore({
-  bindings: {
-    threads: THREADS_KV_NAMESPACE,
-    messages: MESSAGES_KV_NAMESPACE,
-    workflow_snapshot: WORKFLOW_KV_NAMESPACE,
-    traces: TRACES_KV_NAMESPACE,
-  },
-  keyPrefix: 'myapp_', // Optional
-});
-
-// Or using REST API
 const store = new CloudflareStore({
   accountId: process.env.CLOUDFLARE_ACCOUNT_ID!,
   apiToken: process.env.CLOUDFLARE_API_TOKEN!,
-  namespacePrefix: 'myapp_', // Optional
+  namespacePrefix: 'myapp_',
 });
 
 // Save a thread
@@ -65,133 +47,15 @@ await store.saveMessages({
 const messages = await store.listMessages({ threadId: 'thread-123' });
 ```
 
-## Configuration
-
-- **Workers API**: Use the `bindings` option to pass KV namespaces directly (for Cloudflare Workers).
-- **REST API**: Use `accountId`, `apiToken`, and (optionally) `namespacePrefix` for server-side usage.
-- `keyPrefix`/`namespacePrefix`: Useful for isolating environments (e.g., dev/test/prod).
-
-## Features
-
-### Storage Features
-
-- Thread and message storage with JSON support
-- Rich metadata support (JSON-encoded)
-- Timestamp tracking for all records
-- Workflow snapshot persistence
-- Trace and evaluation storage
-- Sorted message order using simulated sorted sets
-- Supports both Cloudflare Workers KV Bindings and REST API
-- Automatic JSON serialization/deserialization for metadata and custom fields
-- Error handling and logging for all operations
-
-### Consistency & Performance
-
-- Eventually consistent (see Limitations)
-- Low-latency access via Workers Binding API
-- Scalable and serverless
-
-## Supported Methods
-
-### Thread Operations
-
-- `saveThread({ thread })`: Create or update a thread
-- `getThreadById({ threadId })`: Get a thread by ID
-- `listThreadsByResourceId({ resourceId, offset, limit, orderBy? })`: List paginated threads for a resource
-- `updateThread({ id, title, metadata })`: Update thread title and metadata
-- `deleteThread({ threadId })`: Delete a thread and its messages
-
-### Message Operations
-
-- `saveMessages({ messages })`: Save multiple messages
-- `listMessages({ threadId, perPage?, page? })`: Get messages for a thread with pagination
-- `listMessagesById({ messageIds })`: Get specific messages by their IDs
-- `updateMessages({ messages })`: Update existing messages
-
-### Resource Operations
-
-- `getResourceById({ resourceId })`: Get a resource by ID
-- `saveResource({ resource })`: Create or save a resource
-- `updateResource({ resourceId, workingMemory })`: Update resource working memory
-
-### Workflow Operations
-
-- `persistWorkflowSnapshot({ workflowName, runId, snapshot })`: Save workflow state
-- `loadWorkflowSnapshot({ workflowName, runId })`: Load workflow state
-- `listWorkflowRuns({ workflowName, pagination })`: List workflow runs with pagination
-- `getWorkflowRunById({ workflowName, runId })`: Get a specific workflow run
-- `updateWorkflowState({ workflowName, runId, state })`: Update workflow state
-- `updateWorkflowResults({ workflowName, runId, results })`: Update workflow results
-
-### Evaluation/Scoring Operations
-
-- `getScoreById({ id })`: Get a score by ID
-- `saveScore(score)`: Save an evaluation score
-- `listScoresByScorerId({ scorerId, pagination })`: List scores by scorer with pagination
-- `listScoresByRunId({ runId, pagination })`: List scores by run with pagination
-- `listScoresByEntityId({ entityId, entityType, pagination })`: List scores by entity with pagination
-- `listScoresBySpan({ traceId, spanId, pagination })`: List scores by span with pagination
-
-### Operations Not Currently Supported
-
-- `deleteMessages(messageIds)`: Message deletion is not currently supported
-- AI Observability (traces/spans): Not currently supported
-
-### Utility
-
-- `clearTable({ tableName })`: Remove all records from a logical table
-- `batchInsert({ tableName, records })`: Batch insert multiple records.
-- `insert({ tableName, record })`: Insert a single record into a table.
-
-## Data Types
-
-- `text`: String
-- `timestamp`: ISO8601 string (converted to/from Date)
-- `uuid`: String
-- `jsonb`: JSON-encoded object
-
-All records are stored as JSON in KV, with automatic serialization/deserialization for metadata, arrays, and custom fields.
-
-## Configuration Reference
-
-- **Workers Binding API**: Use the `bindings` option to pass KV namespaces directly (for Cloudflare Workers).
-- **REST API**: Use `accountId`, `apiToken`, and (optionally) `namespacePrefix` for server-side usage.
-- `keyPrefix`/`namespacePrefix`: Useful for isolating environments (e.g., dev/test/prod).
-
-Example:
-
-```typescript
-const store = new CloudflareStore({
-  bindings: { ... }, // for Workers
-  keyPrefix: 'dev_',
-});
-// or
-const store = new CloudflareStore({
-  accountId: '...',
-  apiToken: '...',
-  namespacePrefix: 'prod_',
-});
-```
-
-## Table/Namespace Mapping
-
-Each logical Mastra table (threads, messages, workflow_snapshot, evals, traces) maps to a separate KV namespace. Keys are structured as `${prefix}${tableName}:${primaryKey}` or `${prefix}${tableName}:${threadId}:${messageId}` for messages. The prefix is set by `keyPrefix`/`namespacePrefix`.
-
-## Limitations
+## Documentation
 
-- **Eventual Consistency:** Cloudflare KV is eventually consistent; concurrent operations may not be immediately visible across all reads.
-- **No Transactions:** Atomic multi-key operations are not supported.
-- **Rate Limits:** Large objects or high-frequency updates may be subject to Cloudflare KV rate limits.
-- **Query Limitations:** No native querying; all filtering is done in-memory after fetching keys/records.
-- **Best for:** Use for serverless, low-latency, and moderate-volume workloads. For relational or strongly consistent needs, consider D1 or a SQL backend.
+- [Cloudflare KV integration guide](https://mastra.ai/integrations/databases/cloudflare-kv)
+- [Storage reference](https://mastra.ai/reference/storage/overview)
 
-## Cloudflare-Specific Notes
+## Changelog
 
-- **Workers Binding API** is recommended for production Workers deployments (low-latency, no API token required at runtime).
-- **REST API** is ideal for server-side Node.js or test environments.
-- Ensure your KV namespaces are provisioned and accessible by your Worker or API token.
-- Namespaces and keys are automatically created as needed.
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/stores/cloudflare/CHANGELOG.md) for version history and release notes.
 
-## Cleanup/Disconnect
+## Support
 
-No explicit cleanup or disconnect is required; Cloudflare KV is fully managed.
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-cloudflare
 description: Documentation for @mastra/cloudflare. Use when working with @mastra/cloudflare APIs, configuration, or implementation.
 metadata:
   package: "@mastra/cloudflare"
-  version: "1.6.4-alpha.0"
+  version: "1.6.4"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.6.4-alpha.0",
+  "version": "1.6.4",
   "package": "@mastra/cloudflare",
   "exports": {},
   "modules": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/cloudflare",
-  "version": "1.6.4-alpha.0",
+  "version": "1.6.4",
   "description": "Cloudflare provider for Mastra - includes db storage capabilities",
   "type": "module",
   "files": [
@@ -57,10 +57,10 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/lint": "0.0.129",
-    "@internal/types-builder": "0.0.104",
-    "@internal/storage-test-utils": "0.0.125",
-    "@mastra/core": "1.64.0-alpha.2"
+    "@internal/lint": "0.0.130",
+    "@internal/types-builder": "0.0.105",
+    "@internal/storage-test-utils": "0.0.126",
+    "@mastra/core": "1.64.0"
   },
   "peerDependencies": {
     "@cloudflare/workers-types": "^4.20240919.0",