@mastra/cloudflare-d1 0.0.0-remove-unused-import-20250909212718 → 0.0.0-remove-ai-peer-dep-from-evals-20260105220639

package/README.md

@@ -75,24 +75,29 @@ const store = new D1Store({
 
 - `saveThread(thread)`: Create or update a thread
 - `getThreadById({ threadId })`: Get a thread by ID
-- `getThreadsByResourceId({ resourceId })`: Fetch all threads associated with a resource.
+- `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).
-- `getMessages({ threadId, selectBy? })`: Retrieve messages for a thread, with optional filtering (e.g., last N, include surrounding messages).
+- `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
 
-### Trace/Evaluation Operations
+### Operations Not Currently Supported
 
-- `getTraces({ name?, scope?, page, perPage, attributes? })`: Query trace records with optional filters and pagination.
-- `getEvalsByAgentName({ agentName, type? })`: Query evaluation results by agent name.
+- `deleteMessages(messageIds)`: Message deletion is not currently supported
+- AI Observability (traces/spans): Not currently supported
+- Evaluation/Scoring: Not currently supported
 
 ### Utility
 

package/dist/docs/README.md

@@ -0,0 +1,31 @@
+# @mastra/cloudflare-d1 Documentation
+
+> Embedded documentation for coding agents
+
+## Quick Start
+
+```bash
+# Read the skill overview
+cat docs/SKILL.md
+
+# Get the source map
+cat docs/SOURCE_MAP.json
+
+# Read topic documentation
+cat docs/<topic>/01-overview.md
+```
+
+## Structure
+
+```
+docs/
+├── SKILL.md           # Entry point
+├── README.md          # This file
+├── SOURCE_MAP.json    # Export index
+├── storage/ (1 files)
+```
+
+## Version
+
+Package: @mastra/cloudflare-d1
+Version: 1.0.0-beta.8

package/dist/docs/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: mastra-cloudflare-d1-docs
+description: Documentation for @mastra/cloudflare-d1. Includes links to type definitions and readable implementation code in dist/.
+---
+
+# @mastra/cloudflare-d1 Documentation
+
+> **Version**: 1.0.0-beta.8
+> **Package**: @mastra/cloudflare-d1
+
+## Quick Navigation
+
+Use SOURCE_MAP.json to find any export:
+
+```bash
+cat docs/SOURCE_MAP.json
+```
+
+Each export maps to:
+- **types**: `.d.ts` file with JSDoc and API signatures
+- **implementation**: `.js` chunk file with readable source
+- **docs**: Conceptual documentation in `docs/`
+
+## Top Exports
+
+
+
+See SOURCE_MAP.json for the complete list.
+
+## Available Topics
+
+- [Storage](storage/) - 1 file(s)

package/dist/docs/SOURCE_MAP.json

@@ -0,0 +1,6 @@
+{
+  "version": "1.0.0-beta.8",
+  "package": "@mastra/cloudflare-d1",
+  "exports": {},
+  "modules": {}
+}

package/dist/docs/storage/01-reference.md

@@ -0,0 +1,110 @@
+# Storage API Reference
+
+> API reference for storage - 1 entries
+
+
+---
+
+## Reference: Cloudflare D1 Storage
+
+> Documentation for the Cloudflare D1 SQL storage implementation in Mastra.
+
+The Cloudflare D1 storage implementation provides a serverless SQL database solution using Cloudflare D1, supporting relational operations and transactional consistency.
+
+## Installation
+
+```bash
+npm install @mastra/cloudflare-d1@beta
+```
+
+## Usage
+
+```typescript
+import { D1Store } from "@mastra/cloudflare-d1";
+
+type Env = {
+  // Add your bindings here, e.g. Workers KV, D1, Workers AI, etc.
+  D1Database: D1Database;
+};
+
+// --- Example 1: Using Workers Binding ---
+const storageWorkers = new D1Store({
+  binding: D1Database, // D1Database binding provided by the Workers runtime
+  tablePrefix: "dev_", // Optional: isolate tables per environment
+});
+
+// --- Example 2: Using REST API ---
+const storageRest = new D1Store({
+  accountId: process.env.CLOUDFLARE_ACCOUNT_ID!, // Cloudflare Account ID
+  databaseId: process.env.CLOUDFLARE_D1_DATABASE_ID!, // D1 Database ID
+  apiToken: process.env.CLOUDFLARE_API_TOKEN!, // Cloudflare API Token
+  tablePrefix: "dev_", // Optional: isolate tables per environment
+});
+```
+
+And add the following to your `wrangler.toml` or `wrangler.jsonc` file:
+
+```
+[[d1_databases]]
+binding = "D1Database"
+database_name = "db-name"
+database_id = "db-id"
+```
+
+## Parameters
+
+## Additional Notes
+
+### Schema Management
+
+The storage implementation handles schema creation and updates automatically. It creates the following tables:
+
+- `threads`: Stores conversation threads
+- `messages`: Stores individual messages
+- `metadata`: Stores additional metadata for threads and messages
+
+### Initialization
+
+When you pass storage to the Mastra class, `init()` is called automatically before any storage operation:
+
+```typescript
+import { Mastra } from "@mastra/core";
+import { D1Store } from "@mastra/cloudflare-d1";
+
+const storage = new D1Store({
+  binding: D1Database,
+});
+
+const mastra = new Mastra({
+  storage, // init() is called automatically
+});
+```
+
+If you're using storage directly without Mastra, you must call `init()` explicitly to create the tables:
+
+```typescript
+import { D1Store } from "@mastra/cloudflare-d1";
+
+const storage = new D1Store({
+  id: 'd1-storage',
+  binding: D1Database,
+});
+
+// Required when using storage directly
+await storage.init();
+
+// Access domain-specific stores via getStore()
+const memoryStore = await storage.getStore('memory');
+const thread = await memoryStore?.getThreadById({ threadId: "..." });
+```
+
+> **Note:**
+If `init()` is not called, tables won't be created and storage operations will fail silently or throw errors.
+
+### Transactions & Consistency
+
+Cloudflare D1 provides transactional guarantees for single-row operations. This means that multiple operations can be executed as a single, all-or-nothing unit of work.
+
+### Table Creation & Migrations
+
+Tables are created automatically when storage is initialized (and can be isolated per environment using the `tablePrefix` option), but advanced schema changes—such as adding columns, changing data types, or modifying indexes—require manual migration and careful planning to avoid data loss.