@mastra/cloudflare-d1 1.3.2-alpha.0 → 1.3.2

package/README.md

@@ -2,30 +2,10 @@
 
 A Mastra store for Cloudflare D1 SQL databases, supporting threads, messages, workflows, evaluations, and traces with robust SQL features.
 
-## Features
-
-- Thread and message storage using SQL tables
-- True sorted order and filtering via SQL queries
-- Rich metadata support (JSON-encoded)
-- Timestamp tracking for all records
-- Workflow snapshot persistence
-- Trace and evaluation storage
-- Efficient batch operations (with prepared statements)
-- Automatic JSON serialization/deserialization for metadata and custom fields
-- Error handling and logging for all operations
-- Supports both Cloudflare Workers D1 Binding and REST API
-
-## Prerequisites
-
-- Access to a Cloudflare account with D1 enabled
-- D1 database created and configured
-- For Workers binding: Worker configured with D1 binding
-- For REST API: Cloudflare API Token with D1 permissions
-
 ## Installation
 
 ```bash
-pnpm add @mastra/cloudflare-d1
+npm install @mastra/cloudflare-d1
 ```
 
 ## Usage
@@ -41,122 +21,15 @@ const store = new D1Store({
 });
 ```
 
-### With REST API
-
-```typescript
-import { D1Store } from '@mastra/cloudflare-d1';
-
-const store = new D1Store({
-  accountId: '<your-account-id>',
-  databaseId: '<your-d1-database-id>',
-  apiToken: '<your-api-token>',
-  tablePrefix: 'mastra_', // optional
-});
-```
-
-### Or you can pass any client implementation you want
-
-```typescript
-import { D1Store } from '@mastra/cloudflare-d1';
-
-const store = new D1Store({
-  client: {
-    query: ({ sql, params }) => {
-      // do something
-    },
-  },
-  tablePrefix: 'mastra_', // optional
-});
-```
-
-## 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 the title and/or metadata of a thread.
-- `deleteThread({ threadId })`: Delete a thread and all its messages.
-
-### Message Operations
-
-- `saveMessages({ messages })`: Save multiple messages in a batch operation (uses prepared statements).
-- `listMessages({ threadId, perPage?, page? })`: Retrieve messages for a thread with pagination.
-- `listMessagesById({ messageIds })`: Get specific messages by their IDs
-- `updateMessages({ messages })`: Update existing messages
-
-### Workflow Operations
-
-- `persistWorkflowSnapshot({ workflowName, runId, snapshot })`: Save workflow state for a given workflow/run.
-- `loadWorkflowSnapshot({ workflowName, runId })`: Load persisted workflow state.
-- `listWorkflowRuns({ workflowName, pagination })`: List workflow runs with pagination
-- `getWorkflowRunById({ workflowName, runId })`: Get a specific workflow run
-
-### Operations Not Currently Supported
-
-- `deleteMessages(messageIds)`: Message deletion is not currently supported
-- AI Observability (traces/spans): Not currently supported
-- Evaluation/Scoring: 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
-
-The D1 store supports the following data types:
-
-- `text`: String
-- `timestamp`: ISO8601 string (converted to/from Date)
-- `uuid`: String
-- `jsonb`: JSON-encoded object
-- `integer`: Integer (for internal counters, etc)
-
-All metadata and custom fields are automatically serialized/deserialized as JSON.
-
----
-
-## Configuration Reference
-
-| Option      | Type       | Description                          |
-| ----------- | ---------- | ------------------------------------ |
-| binding     | D1Database | D1 Workers binding (for Workers)     |
-| accountId   | string     | Cloudflare Account ID (for REST API) |
-| databaseId  | string     | D1 Database ID (for REST API)        |
-| apiToken    | string     | Cloudflare API Token (for REST API)  |
-| tablePrefix | string     | Optional prefix for all table names  |
-
----
-
-## Table/Namespace Mapping
-
-Each logical Mastra table maps to a SQL table in D1 (with optional prefix):
-
-- `mastra_threads` — stores threads
-- `mastra_messages` — stores messages
-- `mastra_workflow_snapshot` — stores workflow snapshots
-- `mastra_evals` — stores evaluations
-- `mastra_traces` — stores traces
-
-(The prefix is configurable via `tablePrefix`.)
+## Documentation
 
----
+- [Cloudflare D1 integration guide](https://mastra.ai/integrations/databases/cloudflare-d1)
+- [Storage reference](https://mastra.ai/reference/storage/overview)
 
-## Limitations
+## Changelog
 
-- No multi-statement transactions (D1 currently supports single statements per query)
-- No advanced SQL joins (D1 is SQLite-based, but some features may be limited)
-- Batch operations are processed in chunks, not truly atomic
-- Some REST API operations may be slower than Workers binding
-- D1 is in beta and may have evolving limitations
-- No vector search capabilities
-- Note: D1 has specific limitations and behaviors, please refer to the official Cloudflare D1 documentation for more information.
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/stores/cloudflare-d1/CHANGELOG.md) for version history and release notes.
 
-## Cleanup / Disconnect
+## Support
 
-No explicit cleanup is required. Connections are managed by the platform.
+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-d1
 description: Documentation for @mastra/cloudflare-d1. Use when working with @mastra/cloudflare-d1 APIs, configuration, or implementation.
 metadata:
   package: "@mastra/cloudflare-d1"
-  version: "1.3.2-alpha.0"
+  version: "1.3.2"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/cloudflare-d1",
-  "version": "1.3.2-alpha.0",
+  "version": "1.3.2",
   "description": "D1 provider for Mastra - includes db storage capabilities",
   "type": "module",
   "files": [
@@ -36,10 +36,10 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/storage-test-utils": "0.0.125",
-    "@internal/lint": "0.0.129",
-    "@internal/types-builder": "0.0.104",
-    "@mastra/core": "1.64.0-alpha.2"
+    "@internal/lint": "0.0.130",
+    "@mastra/core": "1.64.0",
+    "@internal/storage-test-utils": "0.0.126",
+    "@internal/types-builder": "0.0.105"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.54.0-0 <2.0.0-0",