@mastra/cloudflare 1.2.3 → 1.3.0

package/dist/do/storage/db/index.d.ts

@@ -0,0 +1,76 @@
+import type { SqlStorage } from '@cloudflare/workers-types';
+import { MastraBase } from '@mastra/core/base';
+import type { TABLE_NAMES, StorageColumn } from '@mastra/core/storage';
+import type { SqlQueryOptions } from '../sql-builder.js';
+export interface DODBConfig {
+    sql: SqlStorage;
+    tablePrefix?: string;
+}
+/**
+ * Configuration for standalone domain usage with Durable Objects.
+ */
+export interface DODomainConfig {
+    sql: SqlStorage;
+    tablePrefix?: string;
+}
+export declare class DODB extends MastraBase {
+    private sql;
+    private tablePrefix;
+    constructor(config: DODBConfig);
+    hasColumn(table: string, column: string): Promise<boolean>;
+    getTableName(tableName: TABLE_NAMES): string;
+    private formatSqlParams;
+    /**
+     * Execute a SQL query using Durable Objects SqlStorage.
+     * SqlStorage.exec() is synchronous but we wrap in Promise for interface compatibility.
+     */
+    executeQuery(options: SqlQueryOptions): Promise<Record<string, unknown>[] | Record<string, unknown> | null>;
+    private getTableColumns;
+    private serializeValue;
+    protected getSqlType(type: StorageColumn['type']): string;
+    protected getDefaultValue(type: StorageColumn['type']): string;
+    createTable({ tableName, schema, }: {
+        tableName: TABLE_NAMES;
+        schema: Record<string, StorageColumn>;
+    }): Promise<void>;
+    clearTable({ tableName }: {
+        tableName: TABLE_NAMES;
+    }): Promise<void>;
+    dropTable({ tableName }: {
+        tableName: TABLE_NAMES;
+    }): Promise<void>;
+    alterTable(args: {
+        tableName: TABLE_NAMES;
+        schema: Record<string, StorageColumn>;
+        ifNotExists: string[];
+    }): Promise<void>;
+    insert({ tableName, record }: {
+        tableName: TABLE_NAMES;
+        record: Record<string, unknown>;
+    }): Promise<void>;
+    batchInsert({ tableName, records, }: {
+        tableName: TABLE_NAMES;
+        records: Record<string, unknown>[];
+    }): Promise<void>;
+    load<R>({ tableName, keys, orderBy, }: {
+        tableName: TABLE_NAMES;
+        keys: Record<string, string>;
+        orderBy?: {
+            column: string;
+            direction: 'ASC' | 'DESC';
+        };
+    }): Promise<R | null>;
+    processRecord(record: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Upsert multiple records in a batch operation
+     * @param tableName The table to insert into
+     * @param records The records to insert
+     * @param conflictKeys The columns to use for conflict detection (defaults to ['id'])
+     */
+    batchUpsert({ tableName, records, conflictKeys, }: {
+        tableName: TABLE_NAMES;
+        records: Record<string, unknown>[];
+        conflictKeys?: string[];
+    }): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/do/storage/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/do/storage/db/index.ts"],"names":[],"mappings":"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"}

package/dist/do/storage/domains/memory/index.d.ts

@@ -0,0 +1,60 @@
+import type { MastraMessageContentV2 } from '@mastra/core/agent';
+import type { MastraDBMessage, StorageThreadType } from '@mastra/core/memory';
+import { MemoryStorage } from '@mastra/core/storage';
+import type { StorageResourceType, StorageListMessagesInput, StorageListMessagesOutput, StorageListThreadsInput, StorageListThreadsOutput } from '@mastra/core/storage';
+import type { DODomainConfig } from '../../db/index.js';
+export declare class MemoryStorageDO extends MemoryStorage {
+    #private;
+    constructor(config: DODomainConfig);
+    init(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    getResourceById({ resourceId }: {
+        resourceId: string;
+    }): Promise<StorageResourceType | null>;
+    saveResource({ resource }: {
+        resource: StorageResourceType;
+    }): Promise<StorageResourceType>;
+    updateResource({ resourceId, workingMemory, metadata, }: {
+        resourceId: string;
+        workingMemory?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<StorageResourceType>;
+    getThreadById({ threadId }: {
+        threadId: string;
+    }): Promise<StorageThreadType | null>;
+    listThreads(args: StorageListThreadsInput): Promise<StorageListThreadsOutput>;
+    saveThread({ thread }: {
+        thread: StorageThreadType;
+    }): Promise<StorageThreadType>;
+    updateThread({ id, title, metadata, }: {
+        id: string;
+        title: string;
+        metadata: Record<string, unknown>;
+    }): Promise<StorageThreadType>;
+    deleteThread({ threadId }: {
+        threadId: string;
+    }): Promise<void>;
+    saveMessages(args: {
+        messages: MastraDBMessage[];
+    }): Promise<{
+        messages: MastraDBMessage[];
+    }>;
+    private _getIncludedMessages;
+    listMessagesById({ messageIds }: {
+        messageIds: string[];
+    }): Promise<{
+        messages: MastraDBMessage[];
+    }>;
+    listMessages(args: StorageListMessagesInput): Promise<StorageListMessagesOutput>;
+    updateMessages(args: {
+        messages: (Partial<Omit<MastraDBMessage, 'createdAt'>> & {
+            id: string;
+            content?: {
+                metadata?: MastraMessageContentV2['metadata'];
+                content?: MastraMessageContentV2['content'];
+            };
+        })[];
+    }): Promise<MastraDBMessage[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/do/storage/domains/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/do/storage/domains/memory/index.ts"],"names":[],"mappings":"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"}

package/dist/do/storage/domains/scores/index.d.ts

@@ -0,0 +1,38 @@
+import type { ListScoresResponse, SaveScorePayload, ScoreRowData, ScoringSource } from '@mastra/core/evals';
+import { ScoresStorage } from '@mastra/core/storage';
+import type { StoragePagination } from '@mastra/core/storage';
+import type { DODomainConfig } from '../../db/index.js';
+export declare class ScoresStorageDO extends ScoresStorage {
+    #private;
+    constructor(config: DODomainConfig);
+    init(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    getScoreById({ id }: {
+        id: string;
+    }): Promise<ScoreRowData | null>;
+    saveScore(score: SaveScorePayload): Promise<{
+        score: ScoreRowData;
+    }>;
+    listScoresByScorerId({ scorerId, entityId, entityType, source, pagination, }: {
+        scorerId: string;
+        entityId?: string;
+        entityType?: string;
+        source?: ScoringSource;
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+    listScoresByRunId({ runId, pagination, }: {
+        runId: string;
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+    listScoresByEntityId({ entityId, entityType, pagination, }: {
+        pagination: StoragePagination;
+        entityId: string;
+        entityType: string;
+    }): Promise<ListScoresResponse>;
+    listScoresBySpan({ traceId, spanId, pagination, }: {
+        traceId: string;
+        spanId: string;
+        pagination: StoragePagination;
+    }): Promise<ListScoresResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/do/storage/domains/scores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/do/storage/domains/scores/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE5G,OAAO,EAEL,aAAa,EAMd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAgB/C,qBAAa,eAAgB,SAAQ,aAAa;;gBAGpC,MAAM,EAAE,cAAc;IAK5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAyBlE,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IA4EpE,oBAAoB,CAAC,EACzB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,MAAM,EACN,UAAU,GACX,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+EzB,iBAAiB,CAAC,EACtB,KAAK,EACL,UAAU,GACX,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgEzB,oBAAoB,CAAC,EACzB,QAAQ,EACR,UAAU,EACV,UAAU,GACX,EAAE;QACD,UAAU,EAAE,iBAAiB,CAAC;QAC9B,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqEzB,gBAAgB,CAAC,EACrB,OAAO,EACP,MAAM,EACN,UAAU,GACX,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAoEhC"}

package/dist/do/storage/domains/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function isArrayOfRecords(value: unknown): value is Record<string, unknown>[];
+export declare function deserializeValue(value: unknown, type?: string): unknown;
+//# sourceMappingURL=utils.d.ts.map

package/dist/do/storage/domains/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/do/storage/domains/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAEnF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAwBvE"}

package/dist/do/storage/domains/workflows/index.d.ts

@@ -0,0 +1,46 @@
+import type { WorkflowRun, WorkflowRuns, StorageListWorkflowRunsInput, UpdateWorkflowStateOptions } from '@mastra/core/storage';
+import { WorkflowsStorage } from '@mastra/core/storage';
+import type { StepResult, WorkflowRunState } from '@mastra/core/workflows';
+import type { DODomainConfig } from '../../db/index.js';
+export declare class WorkflowsStorageDO extends WorkflowsStorage {
+    #private;
+    constructor(config: DODomainConfig);
+    supportsConcurrentUpdates(): boolean;
+    init(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    updateWorkflowResults({}: {
+        workflowName: string;
+        runId: string;
+        stepId: string;
+        result: StepResult<unknown, unknown, unknown, unknown>;
+        requestContext: Record<string, unknown>;
+    }): Promise<Record<string, StepResult<unknown, unknown, unknown, unknown>>>;
+    updateWorkflowState({}: {
+        workflowName: string;
+        runId: string;
+        opts: UpdateWorkflowStateOptions;
+    }): Promise<WorkflowRunState | undefined>;
+    persistWorkflowSnapshot({ workflowName, runId, resourceId, snapshot, createdAt, updatedAt, }: {
+        workflowName: string;
+        runId: string;
+        resourceId?: string;
+        snapshot: WorkflowRunState;
+        createdAt?: Date;
+        updatedAt?: Date;
+    }): Promise<void>;
+    loadWorkflowSnapshot(params: {
+        workflowName: string;
+        runId: string;
+    }): Promise<WorkflowRunState | null>;
+    private parseWorkflowRun;
+    listWorkflowRuns({ workflowName, fromDate, toDate, page, perPage, resourceId, status, }?: StorageListWorkflowRunsInput): Promise<WorkflowRuns>;
+    getWorkflowRunById({ runId, workflowName, }: {
+        runId: string;
+        workflowName?: string;
+    }): Promise<WorkflowRun | null>;
+    deleteWorkflowRunById({ runId, workflowName }: {
+        runId: string;
+        workflowName: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/do/storage/domains/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/do/storage/domains/workflows/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,4BAA4B,EAC5B,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAKL,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,qBAAa,kBAAmB,SAAQ,gBAAgB;;gBAG1C,MAAM,EAAE,cAAc;IAKlC,yBAAyB,IAAI,OAAO;IAK9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C,qBAAqB,CACnB,EAMC,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACvD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACzC,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAG1E,mBAAmB,CACjB,EAIC,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,0BAA0B,CAAC;KAClC,GACA,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAIlC,uBAAuB,CAAC,EAC5B,YAAY,EACZ,KAAK,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,GACV,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoEX,oBAAoB,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA6B7G,OAAO,CAAC,gBAAgB;IAqBlB,gBAAgB,CAAC,EACrB,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,OAAO,EACP,UAAU,EACV,MAAM,GACP,GAAE,4BAAiC,GAAG,OAAO,CAAC,YAAY,CAAC;IA2EtD,kBAAkB,CAAC,EACvB,KAAK,EACL,YAAY,GACb,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAgCzB,qBAAqB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB7G"}

package/dist/do/storage/sql-builder.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Type definition for SQL query parameters
+ */
+export type SqlParam = string | number | boolean | null | undefined;
+/**
+ * Interface for SQL query options with generic type support
+ */
+export interface SqlQueryOptions {
+    /** SQL query to execute */
+    sql: string;
+    /** Parameters to bind to the query */
+    params?: SqlParam[];
+    /** Whether to return only the first result */
+    first?: boolean;
+}
+/**
+ * SQL Builder class for constructing type-safe SQL queries
+ * This helps create maintainable and secure SQL queries with proper parameter handling
+ */
+export declare class SqlBuilder {
+    private sql;
+    private params;
+    private whereAdded;
+    select(columns?: string | string[]): SqlBuilder;
+    from(table: string): SqlBuilder;
+    /**
+     * Add a WHERE clause to the query
+     * @param condition The condition to add
+     * @param params Parameters to bind to the condition
+     */
+    where(condition: string, ...params: SqlParam[]): SqlBuilder;
+    /**
+     * Add a WHERE clause if it hasn't been added yet, otherwise add an AND clause
+     * @param condition The condition to add
+     * @param params Parameters to bind to the condition
+     */
+    whereAnd(condition: string, ...params: SqlParam[]): SqlBuilder;
+    andWhere(condition: string, ...params: SqlParam[]): SqlBuilder;
+    orWhere(condition: string, ...params: SqlParam[]): SqlBuilder;
+    orderBy(column: string, direction?: 'ASC' | 'DESC'): SqlBuilder;
+    limit(count: number): SqlBuilder;
+    offset(count: number): SqlBuilder;
+    count(): SqlBuilder;
+    /**
+     * Insert a row, or update specific columns on conflict (upsert).
+     * @param table Table name
+     * @param columns Columns to insert
+     * @param values Values to insert
+     * @param conflictColumns Columns to check for conflict (usually PK or UNIQUE)
+     * @param updateMap Object mapping columns to update to their new value (e.g. { name: 'excluded.name' })
+     */
+    insert(table: string, columns: string[], values: SqlParam[], conflictColumns?: string[], updateMap?: Record<string, string>): SqlBuilder;
+    update(table: string, columns: string[], values: SqlParam[]): SqlBuilder;
+    delete(table: string): SqlBuilder;
+    /**
+     * Create a table if it doesn't exist
+     * @param table The table name
+     * @param columnDefinitions The column definitions as an array of strings
+     * @param tableConstraints Optional constraints for the table
+     * @returns The builder instance
+     */
+    createTable(table: string, columnDefinitions: string[], tableConstraints?: string[]): SqlBuilder;
+    /**
+     * Check if an index exists in the database
+     * @param indexName The name of the index to check
+     * @param tableName The table the index is on
+     * @returns The builder instance
+     */
+    checkIndexExists(indexName: string, tableName: string): SqlBuilder;
+    /**
+     * Create an index if it doesn't exist
+     * @param indexName The name of the index to create
+     * @param tableName The table to create the index on
+     * @param columnName The column to index
+     * @param indexType Optional index type (e.g., 'UNIQUE')
+     * @returns The builder instance
+     */
+    createIndex(indexName: string, tableName: string, columnName: string, indexType?: string): SqlBuilder;
+    /**
+     * Add a LIKE condition to the query
+     * @param column The column to check
+     * @param value The value to match (will be wrapped with % for LIKE)
+     * @param exact If true, will not add % wildcards
+     */
+    like(column: string, value: string, exact?: boolean): SqlBuilder;
+    /**
+     * Add a JSON LIKE condition for searching in JSON fields
+     * @param column The JSON column to search in
+     * @param key The JSON key to match
+     * @param value The value to match
+     */
+    jsonLike(column: string, key: string, value: string): SqlBuilder;
+    /**
+     * Get the built query
+     * @returns Object containing the SQL string and parameters array
+     */
+    build(): {
+        sql: string;
+        params: SqlParam[];
+    };
+    /**
+     * Reset the builder for reuse
+     * @returns The reset builder instance
+     */
+    reset(): SqlBuilder;
+}
+export declare function createSqlBuilder(): SqlBuilder;
+/** Represents a validated SQL SELECT column identifier (or '*', optionally with 'AS alias'). */
+type SelectIdentifier = string & {
+    __brand: 'SelectIdentifier';
+};
+/**
+ * Parses and returns a valid SQL SELECT column identifier.
+ * Allows a single identifier (letters, numbers, underscores), or '*', optionally with 'AS alias'.
+ *
+ * @param column - The column identifier string to parse.
+ * @returns The validated column identifier as a branded type.
+ * @throws {Error} If invalid.
+ *
+ * @example
+ * const col = parseSelectIdentifier('user_id'); // Ok
+ * parseSelectIdentifier('user_id AS uid'); // Ok
+ * parseSelectIdentifier('*'); // Ok
+ * parseSelectIdentifier('user id'); // Throws error
+ */
+export declare function parseSelectIdentifier(column: string): SelectIdentifier;
+export {};
+//# sourceMappingURL=sql-builder.d.ts.map

package/dist/do/storage/sql-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-builder.d.ts","sourceRoot":"","sources":["../../../src/do/storage/sql-builder.ts"],"names":[],"mappings":"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"}

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.2.3"
+  version: "1.3.0"
 ---
 
 ## When to use
@@ -16,7 +16,7 @@ Read the individual reference documents for detailed explanations and code examp
 
 ### Reference
 
-- [Reference: Cloudflare storage](references/reference-storage-cloudflare.md) - Documentation for the Cloudflare KV storage implementation in Mastra.
+- [Reference: Cloudflare Storage](references/reference-storage-cloudflare.md) - Documentation for Cloudflare storage implementations in Mastra, including KV and Durable Objects.
 
 
 Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,6 +1,60 @@
 {
-  "version": "1.2.3",
+  "version": "1.3.0",
   "package": "@mastra/cloudflare",
-  "exports": {},
+  "exports": {
+    "CloudflareDOStorage": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-NSFHQATX.js",
+      "line": 2083
+    },
+    "DODB": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-NSFHQATX.js",
+      "line": 282
+    },
+    "DOStore": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-NSFHQATX.js"
+    },
+    "MemoryStorageDO": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-NSFHQATX.js",
+      "line": 661
+    },
+    "ScoresStorageDO": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-NSFHQATX.js",
+      "line": 1500
+    },
+    "WorkflowsStorageDO": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-NSFHQATX.js",
+      "line": 1818
+    },
+    "CloudflareKVStorage": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-O57GFJSB.js",
+      "line": 2176
+    },
+    "CloudflareStore": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-O57GFJSB.js"
+    },
+    "MemoryStorageCloudflare": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-O57GFJSB.js",
+      "line": 562
+    },
+    "ScoresStorageCloudflare": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-O57GFJSB.js",
+      "line": 1604
+    },
+    "WorkflowsStorageCloudflare": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/chunk-O57GFJSB.js",
+      "line": 1904
+    }
+  },
   "modules": {}
 }

package/dist/docs/references/reference-storage-cloudflare.md

@@ -1,8 +1,11 @@
 # Cloudflare storage
 
-The Cloudflare KV storage implementation provides a globally distributed, serverless key-value store solution using Cloudflare Workers KV.
+Mastra provides two Cloudflare storage implementations:
 
-> **Observability Not Supported:** Cloudflare KV storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to KV, and Mastra Studio's observability features won't work with Cloudflare KV as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
+- **Cloudflare KV** (`CloudflareKVStorage`) - A globally distributed, eventually consistent key-value store
+- **Cloudflare Durable Objects** (`CloudflareDOStorage`) - A strongly consistent, SQLite-based storage using Durable Objects
+
+> **Observability Not Supported:** Cloudflare storage **does not support the observability domain**. Traces from the `DefaultExporter` cannot be persisted, and Mastra Studio's observability features won't work with Cloudflare as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
 
 ## Installation
 
@@ -30,13 +33,17 @@ yarn add @mastra/cloudflare@latest
 bun add @mastra/cloudflare@latest
 ```
 
-## Usage
+## Cloudflare KV Storage
+
+The KV storage implementation provides a globally distributed, serverless key-value store solution using Cloudflare Workers KV.
+
+### Usage
 
 ```typescript
-import { CloudflareStore } from '@mastra/cloudflare'
+import { CloudflareKVStorage } from '@mastra/cloudflare/kv'
 
 // --- Example 1: Using Workers Binding ---
-const storageWorkers = new CloudflareStore({
+const storageWorkers = new CloudflareKVStorage({
   id: 'cloudflare-workers-storage',
   bindings: {
     threads: THREADS_KV, // KVNamespace binding for threads table
@@ -47,7 +54,7 @@ const storageWorkers = new CloudflareStore({
 })
 
 // --- Example 2: Using REST API ---
-const storageRest = new CloudflareStore({
+const storageRest = new CloudflareKVStorage({
   id: 'cloudflare-rest-storage',
   accountId: process.env.CLOUDFLARE_ACCOUNT_ID!, // Cloudflare Account ID
   apiToken: process.env.CLOUDFLARE_API_TOKEN!, // Cloudflare API Token
@@ -55,7 +62,7 @@ const storageRest = new CloudflareStore({
 })
 ```
 
-## Parameters
+### Parameters
 
 **id** (`string`): Unique identifier for this storage instance.
 
@@ -85,4 +92,68 @@ Cloudflare KV is an eventually consistent store, meaning that data may not be im
 
 ### Key Structure & Namespacing
 
-Keys in Cloudflare KV are structured as a combination of a configurable prefix and a table-specific format (e.g., `threads:threadId`). For Workers deployments, `keyPrefix` is used to isolate data within a namespace; for REST API deployments, `namespacePrefix` is used to isolate entire namespaces between environments or applications.
+Keys in Cloudflare KV are structured as a combination of a configurable prefix and a table-specific format (e.g., `threads:threadId`). For Workers deployments, `keyPrefix` is used to isolate data within a namespace; for REST API deployments, `namespacePrefix` is used to isolate entire namespaces between environments or applications.
+
+## Cloudflare Durable Objects Storage
+
+The Durable Objects storage implementation provides strongly consistent, SQLite-based storage using Cloudflare Durable Objects. This is ideal for applications that require transactional consistency and SQL query capabilities.
+
+### Usage
+
+```typescript
+import { DurableObject } from 'cloudflare:workers'
+import { CloudflareDOStorage } from '@mastra/cloudflare/do'
+
+class AgentDurableObject extends DurableObject<Env> {
+  private storage: CloudflareDOStorage
+
+  constructor(ctx: DurableObjectState, env: Env) {
+    super(ctx, env)
+    this.storage = new CloudflareDOStorage({
+      sql: ctx.storage.sql,
+      tablePrefix: 'mastra_', // Optional: prefix for table names
+    })
+  }
+
+  async run() {
+    const memory = await this.storage.getStore('memory')
+    await memory?.saveThread({
+      thread: { id: 'thread-1', resourceId: 'user-1', title: 'Chat', metadata: {} },
+    })
+  }
+}
+```
+
+### Parameters
+
+**sql** (`SqlStorage`): SqlStorage instance from Durable Objects ctx.storage.sql
+
+**tablePrefix** (`string`): Optional prefix for table names (only letters, numbers, and underscores allowed)
+
+**disableInit** (`boolean`): When true, automatic table creation/migrations are disabled. Useful for CI/CD pipelines where migrations run separately.
+
+### Strong Consistency
+
+Unlike KV, Durable Objects provide strong consistency guarantees. All reads and writes within a Durable Object are serialized, making it very suitable for fast, long-running agents.
+
+### SQL Capabilities
+
+Durable Objects storage uses SQLite under the hood, enabling efficient queries, filtering, and pagination that aren't possible with key-value storage.
+
+## Schema Management
+
+Both storage implementations handle schema creation and updates automatically. They create the following tables:
+
+- `threads`: Stores conversation threads
+- `messages`: Stores individual messages
+- `workflow_snapshot`: Stores workflow run state
+
+## Deprecated Aliases
+
+For backwards compatibility, the following aliases are available:
+
+```typescript
+// These are deprecated - use CloudflareKVStorage and CloudflareDOStorage instead
+import { CloudflareStore } from '@mastra/cloudflare/kv' // alias for CloudflareKVStorage
+import { DOStore } from '@mastra/cloudflare/do' // alias for CloudflareDOStorage
+```