@mastra/core 1.0.0-beta.15 → 1.0.0-beta.17

package/dist/storage/base.d.ts

@@ -1,6 +1,5 @@
 import { MastraBase } from '../base.js';
 import type { AgentsStorage, ScoresStorage, WorkflowsStorage, MemoryStorage, ObservabilityStorage } from './domains/index.js';
-import type { StorageSupports } from './types.js';
 export type StorageDomains = {
     workflows: WorkflowsStorage;
     scores: ScoresStorage;
@@ -30,31 +29,45 @@ export declare function calculatePagination(page: number, perPageInput: number |
     perPage: number | false;
 };
 /**
- * Base class for all Mastra storage adapters.
- *
- * Storage adapters provide persistence for various domains (memory, workflows, scores, observability, agents).
- * All domain-specific operations should be accessed through `getStore()`:
- *
- * @example
- * ```typescript
- * // Access memory domain
- * const memory = await storage.getStore('memory');
- * await memory?.saveThread({ thread });
- *
- * // Access workflows domain
- * const workflows = await storage.getStore('workflows');
- * await workflows?.persistWorkflowSnapshot({ workflowName, runId, snapshot });
+ * Configuration for individual domain overrides.
+ * Each domain can be sourced from a different storage adapter.
+ */
+export type MastraStorageDomains = Partial<StorageDomains>;
+/**
+ * Configuration options for MastraStorage.
  *
- * // Access observability domain
- * const observability = await storage.getStore('observability');
- * await observability?.createSpan(span);
- * ```
+ * Can be used in two ways:
+ * 1. By store implementations: `{ id, name, disableInit? }` - stores set `this.stores` directly
+ * 2. For composition: `{ id, default?, domains?, disableInit? }` - compose domains from multiple stores
  */
-export declare abstract class MastraStorage extends MastraBase {
-    protected hasInitialized: null | Promise<boolean>;
-    protected shouldCacheInit: boolean;
+export interface MastraStorageConfig {
+    /**
+     * Unique identifier for this storage instance.
+     */
     id: string;
-    stores?: StorageDomains;
+    /**
+     * Name of the storage adapter (used for logging).
+     * Required for store implementations extending MastraStorage.
+     */
+    name?: string;
+    /**
+     * Default storage adapter to use for domains not explicitly specified.
+     * If provided, domains from this storage will be used as fallbacks.
+     */
+    default?: MastraStorage;
+    /**
+     * Individual domain overrides. Each domain can come from a different storage adapter.
+     * These take precedence over the default storage.
+     *
+     * @example
+     * ```typescript
+     * domains: {
+     *   memory: pgStore.stores?.memory,
+     *   workflows: libsqlStore.stores?.workflows,
+     * }
+     * ```
+     */
+    domains?: MastraStorageDomains;
     /**
      * When true, automatic initialization (table creation/migrations) is disabled.
      * This is useful for CI/CD pipelines where you want to:
@@ -74,13 +87,47 @@ export declare abstract class MastraStorage extends MastraBase {
      * const storage = new PostgresStore({ ...config, disableInit: true });
      * // No auto-init, tables must already exist
      */
+    disableInit?: boolean;
+}
+/**
+ * Base class for all Mastra storage adapters.
+ *
+ * Can be used in two ways:
+ *
+ * 1. **Extended by store implementations** (PostgresStore, LibSQLStore, etc.):
+ *    Store implementations extend this class and set `this.stores` with their domain implementations.
+ *
+ * 2. **Directly instantiated for composition**:
+ *    Compose domains from multiple storage backends using `default` and `domains` options.
+ *
+ * All domain-specific operations should be accessed through `getStore()`:
+ *
+ * @example
+ * ```typescript
+ * // Composition: mix domains from different stores
+ * const storage = new MastraStorage({
+ *   id: 'composite',
+ *   default: pgStore,
+ *   domains: {
+ *     memory: libsqlStore.stores?.memory,
+ *   },
+ * });
+ *
+ * // Access domains
+ * const memory = await storage.getStore('memory');
+ * await memory?.saveThread({ thread });
+ * ```
+ */
+export declare class MastraStorage extends MastraBase {
+    protected hasInitialized: null | Promise<boolean>;
+    protected shouldCacheInit: boolean;
+    id: string;
+    stores?: StorageDomains;
+    /**
+     * When true, automatic initialization (table creation/migrations) is disabled.
+     */
     disableInit: boolean;
-    constructor({ id, name, disableInit }: {
-        id: string;
-        name: string;
-        disableInit?: boolean;
-    });
-    get supports(): StorageSupports;
+    constructor(config: MastraStorageConfig);
     /**
      * Get a domain-specific storage interface.
      *

package/dist/storage/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/storage/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAErH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAUvG;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EACxC,iBAAiB,EAAE,MAAM,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,CAK7C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,aAAc,SAAQ,UAAU;IACpD,SAAS,CAAC,cAAc,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAQ;IACzD,SAAS,CAAC,eAAe,UAAQ;IAEjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,EAAE,OAAO,CAAS;gBAEjB,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE;IAY1F,IAAW,QAAQ,IAAI,eAAe,CAYrC;IAED;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAIpG;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiC5B"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/storage/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAErH,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAUvG;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EACxC,iBAAiB,EAAE,MAAM,GACxB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,CAK7C;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAE/B;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,SAAS,CAAC,cAAc,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAQ;IACzD,SAAS,CAAC,eAAe,UAAQ;IAEjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAS;gBAEjB,MAAM,EAAE,mBAAmB;IA2CvC;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAIpG;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiC5B"}

package/dist/storage/constants.cjs

@@ -1,60 +1,60 @@
 'use strict';
 
-var chunkCBVHOGXX_cjs = require('../chunk-CBVHOGXX.cjs');
+var chunkXR7RX2PS_cjs = require('../chunk-XR7RX2PS.cjs');
 
 
 
 Object.defineProperty(exports, "AGENTS_SCHEMA", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.AGENTS_SCHEMA; }
+  get: function () { return chunkXR7RX2PS_cjs.AGENTS_SCHEMA; }
 });
 Object.defineProperty(exports, "OLD_SPAN_SCHEMA", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.OLD_SPAN_SCHEMA; }
+  get: function () { return chunkXR7RX2PS_cjs.OLD_SPAN_SCHEMA; }
 });
 Object.defineProperty(exports, "SCORERS_SCHEMA", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.SCORERS_SCHEMA; }
+  get: function () { return chunkXR7RX2PS_cjs.SCORERS_SCHEMA; }
 });
 Object.defineProperty(exports, "SPAN_SCHEMA", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.SPAN_SCHEMA; }
+  get: function () { return chunkXR7RX2PS_cjs.SPAN_SCHEMA; }
 });
 Object.defineProperty(exports, "TABLE_AGENTS", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_AGENTS; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_AGENTS; }
 });
 Object.defineProperty(exports, "TABLE_MESSAGES", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_MESSAGES; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_MESSAGES; }
 });
 Object.defineProperty(exports, "TABLE_RESOURCES", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_RESOURCES; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_RESOURCES; }
 });
 Object.defineProperty(exports, "TABLE_SCHEMAS", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_SCHEMAS; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_SCHEMAS; }
 });
 Object.defineProperty(exports, "TABLE_SCORERS", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_SCORERS; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_SCORERS; }
 });
 Object.defineProperty(exports, "TABLE_SPANS", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_SPANS; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_SPANS; }
 });
 Object.defineProperty(exports, "TABLE_THREADS", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_THREADS; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_THREADS; }
 });
 Object.defineProperty(exports, "TABLE_TRACES", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_TRACES; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_TRACES; }
 });
 Object.defineProperty(exports, "TABLE_WORKFLOW_SNAPSHOT", {
   enumerable: true,
-  get: function () { return chunkCBVHOGXX_cjs.TABLE_WORKFLOW_SNAPSHOT; }
+  get: function () { return chunkXR7RX2PS_cjs.TABLE_WORKFLOW_SNAPSHOT; }
 });
 //# sourceMappingURL=constants.cjs.map
 //# sourceMappingURL=constants.cjs.map

package/dist/storage/constants.js

@@ -1,3 +1,3 @@
-export { AGENTS_SCHEMA, OLD_SPAN_SCHEMA, SCORERS_SCHEMA, SPAN_SCHEMA, TABLE_AGENTS, TABLE_MESSAGES, TABLE_RESOURCES, TABLE_SCHEMAS, TABLE_SCORERS, TABLE_SPANS, TABLE_THREADS, TABLE_TRACES, TABLE_WORKFLOW_SNAPSHOT } from '../chunk-YV43YEZ6.js';
+export { AGENTS_SCHEMA, OLD_SPAN_SCHEMA, SCORERS_SCHEMA, SPAN_SCHEMA, TABLE_AGENTS, TABLE_MESSAGES, TABLE_RESOURCES, TABLE_SCHEMAS, TABLE_SCORERS, TABLE_SPANS, TABLE_THREADS, TABLE_TRACES, TABLE_WORKFLOW_SNAPSHOT } from '../chunk-6RFJWX4V.js';
 //# sourceMappingURL=constants.js.map
 //# sourceMappingURL=constants.js.map