{"record":{"id":"cdf4138537857725","repo":"mastra-ai/mastra","slug":"datasets-store-not-available-cdf413","errorCode":"DATASETS_STORE_NOT_AVAILABLE","errorMessage":"Datasets store not available. Ensure your storage adapter provides a datasets domain.","messagePattern":"Datasets store not available\\. Ensure your storage adapter provides a datasets domain\\.","errorType":"error_code","errorClass":"MastraError","httpStatus":null,"severity":"error","filePath":"packages/core/src/datasets/manager.ts","lineNumber":61,"sourceCode":"  // Lazy storage resolution\n  // ---------------------------------------------------------------------------\n\n  async #getDatasetsStore(): Promise<DatasetsStorage> {\n    if (this.#datasetsStore) return this.#datasetsStore;\n\n    const storage = this.#mastra.getStorage();\n    if (!storage) {\n      throw new MastraError({\n        id: 'DATASETS_STORAGE_NOT_CONFIGURED',\n        text: 'Storage not configured. Configure storage in Mastra instance.',\n        domain: 'STORAGE',\n        category: 'USER',\n      });\n    }\n\n    const store = await storage.getStore('datasets');\n    if (!store) {\n      throw new MastraError({\n        id: 'DATASETS_STORE_NOT_AVAILABLE',\n        text: 'Datasets store not available. Ensure your storage adapter provides a datasets domain.',\n        domain: 'STORAGE',\n        category: 'USER',\n      });\n    }\n\n    this.#datasetsStore = store;\n    return store;\n  }\n\n  async #getExperimentsStore(): Promise<ExperimentsStorage> {\n    if (this.#experimentsStore) return this.#experimentsStore;\n\n    const storage = this.#mastra.getStorage();\n    if (!storage) {\n      throw new MastraError({\n        id: 'DATASETS_STORAGE_NOT_CONFIGURED',","sourceCodeStart":43,"sourceCodeEnd":79,"githubUrl":"https://github.com/mastra-ai/mastra/blob/75dd419e613fe9c39f846ffc500716141b74fda6/packages/core/src/datasets/manager.ts#L43-L79","documentation":"Storage IS configured, but storage.getStore('datasets') returned nothing — the adapter does not implement the datasets domain. #getDatasetsStore throws DATASETS_STORE_NOT_AVAILABLE so callers know their storage backend lacks dataset support rather than failing later with undefined behavior.","triggerScenarios":"Using an older or minimal storage adapter without a datasets domain store; a custom storage implementation that omits the datasets capability; getStore('datasets') returning undefined due to domain registration failure.","commonSituations":"Upgrading @mastra/core datasets features while keeping an old @mastra/* storage package; hand-rolled storage adapters; in-memory dev adapters without datasets support.","solutions":["Upgrade the storage adapter package to a version implementing the datasets domain.","Switch to an adapter known to support datasets (e.g. libsql/pg-based official stores).","If using a custom adapter, implement and register the datasets domain store.","Feature-detect at startup: if (!(await storage.getStore('datasets'))) log/throw early."],"exampleFix":"// before\nstorage: new OldInMemoryStore() // no datasets domain\n// after\nstorage: new LibSQLStore({ url: 'file:./mastra.db' }) // supports datasets","handlingStrategy":"validation","validationCode":"const store = await mastra.getStorage()?.getStore('datasets');\nif (!store) throw new Error('Current storage adapter does not provide a datasets domain');","typeGuard":"async function datasetsSupported(m: Mastra): Promise<boolean> {\n  return !!(await m.getStorage()?.getStore('datasets'));\n}","tryCatchPattern":"try {\n  await datasets.create({ name: 'evals' });\n} catch (err) {\n  if (err?.id === 'DATASETS_STORE_NOT_AVAILABLE') {\n    logger.error('Upgrade/replace storage adapter to one with datasets support');\n  }\n  throw err;\n}","preventionTips":["Pin compatible versions of @mastra/core and your storage adapter (upgrade together).","Feature-detect getStore('datasets') at startup when the datasets feature is optional.","Prefer official adapters with documented datasets support.","For custom adapters, implement and test all required domain stores."],"tags":["storage","datasets","compatibility"],"backgroundTag":"storage-domain-not-supported","analyzedSha":"75dd419e613fe9c39f846ffc500716141b74fda6","analyzedAt":"2026-08-30T00:15:31.844Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}