{"_id":"@caleblawson/astra","name":"@caleblawson/astra","dist-tags":{"latest":"0.10.2"},"versions":{"0.10.2":{"name":"@caleblawson/astra","version":"0.10.2","description":"Astra DB provider for Mastra - includes vector store capabilities","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./package.json":"./package.json"},"license":"MIT","dependencies":{"@datastax/astra-db-ts":"^1.5.0"},"devDependencies":{"@microsoft/api-extractor":"^7.52.8","@types/node":"^20.19.0","eslint":"^9.28.0","tsup":"^8.5.0","typescript":"^5.8.3","vitest":"^3.2.3","@internal/lint":"0.0.13","@mastra/core":"npm:@caleblawson/core@0.10.7-alpha.0"},"peerDependencies":{"@mastra/core":">=0.10.4-0 <0.11.0"},"scripts":{"build":"tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting","build:watch":"pnpm build --watch","test":"vitest run","lint":"eslint ."},"gitHead":"c31e90130a5c9765c23f688ecea70adc6164543d","_id":"@caleblawson/astra@0.10.2","_integrity":"sha512-Jhe5vQsuNdH0ePigXCcYgtSpoTcbq1wAkuB9XOYkTqgWUJyTbm4pHQBzbiphBjckSHe2gn6CLn00KSkJWmXZ8Q==","_resolved":"C:\\Users\\caleb\\AppData\\Local\\Temp\\31187d9a8981a82e408f94128a7c9931\\caleblawson-astra-0.10.2.tgz","_from":"file:caleblawson-astra-0.10.2.tgz","_nodeVersion":"21.2.0","_npmVersion":"10.2.3","dist":{"integrity":"sha512-Jhe5vQsuNdH0ePigXCcYgtSpoTcbq1wAkuB9XOYkTqgWUJyTbm4pHQBzbiphBjckSHe2gn6CLn00KSkJWmXZ8Q==","shasum":"70b6e6e7d78b4ebcf39fdb6baaa033502710b4af","tarball":"https://registry.npmjs.org/@caleblawson/astra/-/astra-0.10.2.tgz","fileCount":20,"unpackedSize":158239,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDBGaFGh7F/O+SyBYydnuWaCcOwV6cx/NUW2oNcPEty7gIhAMpPNrG7l7eIkA939wPaHft0//ukulkhJOmS0TxB+/IP"}]},"_npmUser":{"name":"caleblawson","email":"caleb.lawson@dynapt.com","actor":{"name":"caleblawson","email":"caleb.lawson@dynapt.com","type":"user"}},"directories":{},"maintainers":[{"name":"caleblawson","email":"caleb.lawson@dynapt.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/astra_0.10.2_1750619783399_0.20658185618118519"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-22T19:16:23.320Z","0.10.2":"2025-06-22T19:16:23.560Z","modified":"2025-06-22T19:16:23.838Z"},"maintainers":[{"name":"caleblawson","email":"caleb.lawson@dynapt.com"}],"description":"Astra DB provider for Mastra - includes vector store capabilities","license":"MIT","readme":"# @mastra/astra\r\n\r\nVector store implementation for DataStax Astra DB, providing vector similarity search capabilities using Cassandra's vector search functionality.\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @mastra/astra\r\n```\r\n\r\n## Usage\r\n\r\n```typescript\r\nimport { AstraVector } from '@mastra/astra';\r\n\r\nconst vectorStore = new AstraVector({\r\n  token: 'your-astra-token',\r\n  endpoint: 'your-astra-endpoint',\r\n  keyspace: 'your-keyspace' // optional\r\n});\r\n\r\n// Create a new collection\r\nawait vectorStore.createIndex({ indexName: 'myCollection', dimension: 1536, metric: 'cosine' });\r\n\r\n// Add vectors\r\nconst vectors = [[0.1, 0.2, ...], [0.3, 0.4, ...]];\r\nconst metadata = [{ text: 'doc1' }, { text: 'doc2' }];\r\nconst ids = await vectorStore.upsert({ indexName: 'myCollection', vectors, metadata });\r\n\r\n// Query vectors\r\nconst results = await vectorStore.query({\r\n  indexName: 'myCollection',\r\n  queryVector: [0.1, 0.2, ...],\r\n  topK: 10, // topK\r\n  filter: { text: { $eq: 'doc1' } }, // optional filter\r\n  includeVector: false // includeVectors\r\n});\r\n```\r\n\r\n## Configuration\r\n\r\nThe Astra DB vector store requires:\r\n\r\n- `token`: Your Astra DB token\r\n- `endpoint`: Your Astra DB endpoint\r\n- `keyspace`: (Optional) The keyspace to use\r\n\r\n## Features\r\n\r\n- Vector similarity search with cosine, euclidean, and dot product metrics\r\n- Metadata filtering support\r\n- Batch vector upsert operations\r\n- Collection management (create, list, describe, delete)\r\n- Optional vector inclusion in query results\r\n- Automatic UUID generation for vectors\r\n- Built on top of @datastax/astra-db-ts client\r\n\r\n## Methods\r\n\r\n- `createIndex({ indexName, dimension, metric? })`: Create a new collection\r\n- `upsert({ indexName, vectors, metadata?, ids })`: Add or update vectors\r\n- `query({ indexName, queryVector, topK?, filter?, includeVector? })`: Search for similar vectors\r\n- `listIndexes()`: List all collections\r\n- `describeIndex(indexName)`: Get collection statistics\r\n- `deleteIndex(indexName)`: Delete a collection\r\n\r\n## Related Links\r\n\r\n- [Astra DB Vector Search Documentation](https://docs.datastax.com/en/astra-db/docs/vector-search.html)\r\n- [Astra DB API Reference](https://docs.datastax.com/en/astra-db-serverless/api-reference/documents.html)\r\n","readmeFilename":"README.md","_rev":"1-85d8a513636df47c1bbe14a4a6474bc6"}