@mastra/dsql 0.0.0-branches-as-default-20260512170712

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @mastra/dsql
+
+## 0.0.0-branches-as-default-20260512170712
+
+### Minor Changes
+
+- Added Amazon Aurora DSQL storage provider with IAM authentication support. ([#10930](https://github.com/mastra-ai/mastra/pull/10930))
+
+  Enables storing threads, messages, workflows, traces, and agent data in Amazon Aurora DSQL clusters.
+
+  ```typescript
+  import { DSQLStore } from '@mastra/dsql';
+
+  const storage = new DSQLStore({
+    id: 'my-dsql-store',
+    host: 'abc123.dsql.us-east-1.on.aws',
+  });
+
+  await storage.init();
+  ```
+
+  Related: #10929
+
+### Patch Changes
+
+- Updated dependencies [[`9f17410`](https://github.com/mastra-ai/mastra/commit/9f1741080def23d42ee50b39887a385ae316a3c6), [`7ad5585`](https://github.com/mastra-ai/mastra/commit/7ad55856406f1de398dc713f6a9eaa78b2784bb6), [`ac47842`](https://github.com/mastra-ai/mastra/commit/ac478427aa7a5f5fdaed633a911218689b438c60), [`d1fdbd0`](https://github.com/mastra-ai/mastra/commit/d1fdbd012add5623cb7e6b7f882b605ab358bbb4), [`210ea7a`](https://github.com/mastra-ai/mastra/commit/210ea7af559791b73a44fc9c12179908aaa3183f), [`7c275a8`](https://github.com/mastra-ai/mastra/commit/7c275a810595e1a6c41ccc39720531ab65734700), [`bae019e`](https://github.com/mastra-ai/mastra/commit/bae019ecb6694da96909f7ec7b9eb3a0a33aa887), [`890b24c`](https://github.com/mastra-ai/mastra/commit/890b24cc7d32ed6aa4dfe253e54dc6bf4099f690), [`f984b4d`](https://github.com/mastra-ai/mastra/commit/f984b4d6c60bf2ae2a9b156f0e8c35a66fe96c91), [`6742347`](https://github.com/mastra-ai/mastra/commit/6742347d71955d7639adc9ddf6ff8282de7ee3ba), [`b59316f`](https://github.com/mastra-ai/mastra/commit/b59316ffa0f7688165b0f9c81ccdf85da461e5b2), [`0f48ebf`](https://github.com/mastra-ai/mastra/commit/0f48ebfc7ac7897b2092a189f45751924cf56d1c), [`37c0dc5`](https://github.com/mastra-ai/mastra/commit/37c0dc5697d343db98628bf867bf71ce6deec6d7), [`087e413`](https://github.com/mastra-ai/mastra/commit/087e4133e5d6efa36619e9556c16750e4179c047), [`83218c8`](https://github.com/mastra-ai/mastra/commit/83218c88b37773c9424fbe733b37be556e55e94d), [`ef6b584`](https://github.com/mastra-ai/mastra/commit/ef6b5847ac33c0a7e80af3a86e8801e2933dd3ee), [`c6eb39e`](https://github.com/mastra-ai/mastra/commit/c6eb39ea6dca381c6563cb240237fbe608e02f93), [`7b0ad1f`](https://github.com/mastra-ai/mastra/commit/7b0ad1f5c53dc118c6da12ae82ae2587037dc2b8), [`d91ebe2`](https://github.com/mastra-ai/mastra/commit/d91ebe28ee065d8f2ed6df741c3c07f58d359529), [`62666c3`](https://github.com/mastra-ai/mastra/commit/62666c367eaeac3941ead454b1d38810cc855721), [`33f5061`](https://github.com/mastra-ai/mastra/commit/33f5061cd1c0335020c3faae61ce96de822854fa), [`4af2160`](https://github.com/mastra-ai/mastra/commit/4af2160322f4718cac421930cce85641e9512389), [`087e413`](https://github.com/mastra-ai/mastra/commit/087e4133e5d6efa36619e9556c16750e4179c047), [`265ec9f`](https://github.com/mastra-ai/mastra/commit/265ec9f887b5c81255c873a76ff7796f16e4f99b), [`ce01024`](https://github.com/mastra-ai/mastra/commit/ce010242eee9bdfc09e4c26725b9d37998679a8d), [`6ce80bf`](https://github.com/mastra-ai/mastra/commit/6ce80bf4872a891e0bddf8b80561a80584efb14b), [`f984b4d`](https://github.com/mastra-ai/mastra/commit/f984b4d6c60bf2ae2a9b156f0e8c35a66fe96c91), [`136c959`](https://github.com/mastra-ai/mastra/commit/136c9592fb0eeb0cd212f28629d8a29b7557a2fc), [`9268531`](https://github.com/mastra-ai/mastra/commit/9268531e7ec4be98beeba3b3ae8be0a7ea380662), [`13ead79`](https://github.com/mastra-ai/mastra/commit/13ead79149486b88144db7e11e6ff551caef5be1), [`dccd8f1`](https://github.com/mastra-ai/mastra/commit/dccd8f1f8b8f1ad203b77556207e5529567c616d), [`4df7cc7`](https://github.com/mastra-ai/mastra/commit/4df7cc79342fd065fe7fdeef93c094db14b12bcd), [`f180e49`](https://github.com/mastra-ai/mastra/commit/f180e4990e71b04c9a475b523584071712f0048f), [`9260e01`](https://github.com/mastra-ai/mastra/commit/9260e015276fb1b500f7878ee452b47476bf1583), [`2f6c54e`](https://github.com/mastra-ai/mastra/commit/2f6c54e17c041cac1def54baaa6b771647836414), [`aca3121`](https://github.com/mastra-ai/mastra/commit/aca31211233dac25459f140ea4fcfb3a5af64c18), [`e06a159`](https://github.com/mastra-ai/mastra/commit/e06a1598ca07a6c3778aefc2a2d288363c6294ff), [`4dd900d`](https://github.com/mastra-ai/mastra/commit/4dd900d75dfe9be89f8c15188b368a8622aa1e18), [`b560d6f`](https://github.com/mastra-ai/mastra/commit/b560d6f88b9b904b15c10f75c949eb145bc27684), [`99869ec`](https://github.com/mastra-ai/mastra/commit/99869ecb1f2aa6dfcc44fa4e843e5ee0344efa64), [`900d086`](https://github.com/mastra-ai/mastra/commit/900d086bb737b9cf2fcf68f11b0389b801a2738c), [`4c0e286`](https://github.com/mastra-ai/mastra/commit/4c0e28637c9cfb4f416549b55e97ebfa13319dfc), [`55f1e2d`](https://github.com/mastra-ai/mastra/commit/55f1e2d65425b95a49ae788053b266f256e38c96), [`4ff5bdf`](https://github.com/mastra-ai/mastra/commit/4ff5bdfe170cba6dfb5260c6af0f4ba668430772), [`9cdf38e`](https://github.com/mastra-ai/mastra/commit/9cdf38e58506e1109c8b38f97cd7770978a4218e), [`087e413`](https://github.com/mastra-ai/mastra/commit/087e4133e5d6efa36619e9556c16750e4179c047), [`db34bc6`](https://github.com/mastra-ai/mastra/commit/db34bc6fb36cf125bda0c46be4d3fdc774b70cc4), [`990851e`](https://github.com/mastra-ai/mastra/commit/990851edcb0e30be5c2c18b6532f1a876cc2d335), [`bbcd93c`](https://github.com/mastra-ai/mastra/commit/bbcd93cf7d8aa1007d6d84bfd033b8015c912087), [`8373ff4`](https://github.com/mastra-ai/mastra/commit/8373ff46745d77af79f183c4470f80fa2727a6b2), [`d48a705`](https://github.com/mastra-ai/mastra/commit/d48a705ff3dfbdc7a996e07ecd8293b5effd9a2a), [`308bd07`](https://github.com/mastra-ai/mastra/commit/308bd074f35cef0c75d82fc1eb19382fe04ecf6f), [`6068a6c`](https://github.com/mastra-ai/mastra/commit/6068a6c42950fad3ebfc92346417896ba60803d2), [`36b3bbf`](https://github.com/mastra-ai/mastra/commit/36b3bbf5a8d59f7e23d47e29340e76c681b4929c), [`d86f031`](https://github.com/mastra-ai/mastra/commit/d86f031eb6b0b2570145afafea664e59bf688962), [`b275631`](https://github.com/mastra-ai/mastra/commit/b275631dc10541a482b2e2d4a3e3cfa843bd5fa1), [`00106be`](https://github.com/mastra-ai/mastra/commit/00106bede59b81e5b0e9cd6aad8d3b5dbc336387), [`bd36d8e`](https://github.com/mastra-ai/mastra/commit/bd36d8eb6de8c9a0310352649dbd4b06703c2299), [`11c1528`](https://github.com/mastra-ai/mastra/commit/11c152848c5d0ef227184853b5040f5b41ee7b1e), [`e2a079c`](https://github.com/mastra-ai/mastra/commit/e2a079cc3755b1895f7bd5dc36e9be81b11c7c22), [`8ac9141`](https://github.com/mastra-ai/mastra/commit/8ac9141439caa8fdd674944c4d84f29b3c730296), [`25184ff`](https://github.com/mastra-ai/mastra/commit/25184ffaf1293ec95119426eb1a1f8d38831b96c), [`534a456`](https://github.com/mastra-ai/mastra/commit/534a456a25e4df1e5407e7e632f4cb3b1fa14f9d), [`aebde9c`](https://github.com/mastra-ai/mastra/commit/aebde9cfacf56592c6b6350cae721740fe090b8a), [`36bae07`](https://github.com/mastra-ai/mastra/commit/36bae07c0e70b1b3006f2fd20830e8883dcbd066), [`5688881`](https://github.com/mastra-ai/mastra/commit/5688881669c7ed157f31ac77f6fc5f8d95ceea32)]:
+  - @mastra/core@0.0.0-branches-as-default-20260512170712

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,357 @@
+# @mastra/dsql
+
+Amazon Aurora DSQL storage implementation for Mastra, providing thread, message, workflow, and observability storage using Aurora DSQL with IAM authentication.
+
+> **Note**  
+> Aurora DSQL doesn’t support PostgreSQL extensions (`CREATE EXTENSION`), including `pgvector`.  
+> For vector storage, use a separate vector store like `@mastra/s3vectors`.
+
+## Installation
+
+```bash
+npm install @mastra/dsql
+```
+
+## Prerequisites
+
+- Amazon Aurora DSQL cluster
+- AWS credentials with access to the DSQL cluster (IAM authentication)
+
+## Usage
+
+### Storage
+
+```typescript
+import { DSQLStore } from '@mastra/dsql';
+
+const store = new DSQLStore({
+  id: 'my-dsql-store',
+  host: 'abc123.dsql.us-east-1.on.aws',
+  // region is auto-detected from host, or specify explicitly:
+  // region: 'us-east-1',
+  // user: 'admin', // default
+  // database: 'postgres', // default
+});
+
+// Initialize the store (creates tables if needed)
+await store.init();
+
+// Create a thread
+await store.saveThread({
+  thread: {
+    id: 'thread-123',
+    resourceId: 'resource-456',
+    title: 'My Thread',
+    metadata: { key: 'value' },
+    createdAt: new Date(),
+  },
+});
+
+// Add messages to thread
+await store.saveMessages({
+  messages: [
+    {
+      id: 'msg-789',
+      threadId: 'thread-123',
+      role: 'user',
+      content: { content: 'Hello' },
+      resourceId: 'resource-456',
+      createdAt: new Date(),
+    },
+  ],
+});
+
+// Query threads and messages
+const savedThread = await store.getThreadById({ threadId: 'thread-123' });
+const messages = await store.listMessages({ threadId: 'thread-123' });
+```
+
+## Configuration
+
+### Connection Methods
+
+`DSQLStore` supports multiple connection methods:
+
+**1. Host Configuration (Recommended)**
+
+```typescript
+import { DSQLStore } from '@mastra/dsql';
+
+const store = new DSQLStore({
+  id: 'my-dsql-store',
+  host: 'abc123.dsql.us-east-1.on.aws',
+  // region is auto-detected from host, or specify explicitly
+  // user: 'admin', // default
+  // database: 'postgres', // default
+  schemaName: 'custom_schema', // optional
+});
+```
+
+**2. Pre-configured pg.Pool**
+
+```typescript
+import { Pool } from 'pg';
+import { AuroraDSQLClient } from '@aws/aurora-dsql-node-postgres-connector';
+import { DSQLStore } from '@mastra/dsql';
+
+const pool = new Pool({
+  host: 'abc123.dsql.us-east-1.on.aws',
+  Client: AuroraDSQLClient,
+  region: 'us-east-1',
+});
+
+const store = new DSQLStore({
+  id: 'my-dsql-store',
+  pool,
+});
+
+// Use store.pool for other libraries that need a pg.Pool
+```
+
+### Custom AWS Credentials
+
+```typescript
+import { DSQLStore } from '@mastra/dsql';
+import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
+
+const store = new DSQLStore({
+  id: 'my-dsql-store',
+  host: 'abc123.dsql.us-east-1.on.aws',
+  customCredentialsProvider: fromNodeProviderChain(),
+});
+```
+
+### Connection Pool Settings
+
+```typescript
+const store = new DSQLStore({
+  id: 'my-dsql-store',
+  host: 'abc123.dsql.us-east-1.on.aws',
+
+  // Connection pool settings
+  max: 10, // maximum connections (default: 10)
+  min: 0, // minimum connections (default: 0)
+  idleTimeoutMillis: 600000, // 10 minutes (default)
+  maxLifetimeSeconds: 3300, // 55 minutes (default, must be < 3600)
+  connectionTimeoutMillis: 5000, // 5 seconds (default)
+  allowExitOnIdle: true, // default: true
+});
+```
+
+### Configuration Options
+
+| Option                      | Type                          | Default         | Description                                                                                               |
+| --------------------------- | ----------------------------- | --------------- | --------------------------------------------------------------------------------------------------------- |
+| `id`                        | string                        | (required)      | Unique identifier for this store instance                                                                 |
+| `host`                      | string                        | (required)\*    | DSQL cluster endpoint (e.g., `abc123.dsql.us-east-1.on.aws`)                                              |
+| `pool`                      | pg.Pool                       | -               | Pre-configured pg.Pool instance (cannot be used with host)                                                |
+| `user`                      | string                        | `'admin'`       | Database user (Aurora DSQL built-in admin role is `admin`)                                                |
+| `database`                  | string                        | `'postgres'`    | Database name (Aurora DSQL exposes a single built-in database named `postgres` per cluster)               |
+| `region`                    | string                        | (auto-detected) | AWS region, extracted from host if not provided                                                           |
+| `schemaName`                | string                        | `'public'`      | PostgreSQL schema name where Mastra tables/indexes are created                                            |
+| `customCredentialsProvider` | AwsCredentialIdentityProvider | (default chain) | Custom AWS credentials provider                                                                           |
+| `max`                       | number                        | `10`            | Maximum connections in the pool                                                                           |
+| `min`                       | number                        | `0`             | Minimum connections in the pool                                                                           |
+| `idleTimeoutMillis`         | number                        | `600000`        | Close idle connections after this many milliseconds                                                       |
+| `maxLifetimeSeconds`        | number                        | `3300`          | Maximum connection lifetime in seconds (must be `< 3600` due to Aurora DSQL’s 60-minute connection limit) |
+| `connectionTimeoutMillis`   | number                        | `5000`          | Connection acquisition timeout in milliseconds                                                            |
+| `allowExitOnIdle`           | boolean                       | `true`          | Allow the process to exit when all connections are idle                                                   |
+
+\* Either `host` or `pool` is required.
+
+### Default Connection Pool Settings
+
+The default pool settings are optimized for Aurora DSQL:
+
+- Maximum connections: 10
+- Idle timeout: 10 minutes (600,000 ms)
+- Max connection lifetime: 55 minutes (3,300 seconds)
+- Connection timeout: 5 seconds
+
+The `maxLifetimeSeconds` is set to 55 minutes to ensure connections are rotated before Aurora DSQL's 60-minute connection duration limit.
+
+## Aurora DSQL Specifics
+
+`@mastra/dsql` is built on top of [Amazon Aurora DSQL](https://docs.aws.amazon.com/aurora-dsql/) using the official Node.js connector.
+You usually interact with it like any other Mastra store, but there are some important Aurora DSQL characteristics to be aware of:
+
+- **IAM-only authentication**
+  - Connections are authenticated with IAM (no database passwords).
+  - `@mastra/dsql` uses `@aws/aurora-dsql-node-postgres-connector` to generate short-lived auth tokens automatically.
+  - You can plug in a custom credentials provider via `customCredentialsProvider`.
+
+- **Single database, schema-based isolation**
+  - Each cluster exposes a single built-in database named `postgres` (no `CREATE DATABASE`).
+  - Logical separation is done via schemas; `schemaName` controls where Mastra tables are created.
+  - Typical pattern: initialize as `admin`, optionally create an application schema, then connect as a non-admin role using that schema.
+
+- **No PostgreSQL extensions**
+  - `CREATE EXTENSION` is not supported (including `pgvector`, `PostGIS`, etc.).
+  - For vectors or extension-based features, use a separate store (e.g. `@mastra/s3vectors`) alongside `DSQLStore`.
+
+- **JSON stored as text**
+  - JSON/JSONB are available as _query_ types but not as column types.
+  - `@mastra/dsql` stores structured fields (metadata, content, etc.) in `TEXT` columns and casts to JSON at query time as needed.
+
+- **Schema & DDL constraints**
+  - Some PostgreSQL features are not available (e.g. foreign key constraints, `TRUNCATE`, synchronous `CREATE INDEX`).
+  - Indexes are created asynchronously using `CREATE INDEX ASYNC`; there is a limit on the number of indexes per table.
+  - The store’s `init()` and index helper APIs are implemented to respect these constraints.
+
+- **Transactions & optimistic concurrency**
+  - Aurora DSQL uses optimistic concurrency control (OCC) and may return retriable OCC errors under contention.
+  - There are limits on transaction duration and size; large bulk operations should be split into smaller batches at the application level.
+
+- **Connection lifetime**
+  - Individual connections are limited to about 60 minutes.
+  - The default `maxLifetimeSeconds: 3300` ensures connections are recycled before hitting this limit.
+
+## Features
+
+### Storage Features
+
+- Thread and message storage with JSON support
+- Atomic transactions for data consistency
+- Efficient batch operations
+- Rich metadata support
+- Timestamp tracking
+
+## Storage Methods
+
+### Thread Operations
+
+- `saveThread({ thread })`: Create or update a thread
+- `getThreadById({ threadId })`: Get a thread by ID
+- `updateThread({ id, title, metadata })`: Update thread title and/or metadata
+- `deleteThread({ threadId })`: Delete a thread and its messages
+- `listThreadsByResourceId({ resourceId, offset, limit, orderBy? })`: List paginated threads for a resource
+
+### Message Operations
+
+- `saveMessages({ messages })`: Save multiple messages in a transaction
+- `listMessages({ threadId, resourceId?, perPage?, page?, orderBy?, filter? })`: Get messages for a thread with pagination
+- `listMessagesById({ messageIds })`: Get specific messages by their IDs
+- `updateMessages({ messages })`: Update existing messages
+- `deleteMessages(messageIds)`: Delete specific messages
+
+### Resource Operations
+
+- `getResourceById({ resourceId })`: Get a resource by ID
+- `saveResource({ resource })`: Create or save a resource
+- `updateResource({ resourceId, workingMemory?, metadata? })`: Update resource working memory and/or metadata
+
+### Workflow Operations
+
+- `persistWorkflowSnapshot({ workflowName, runId, snapshot })`: Save workflow state
+- `loadWorkflowSnapshot({ workflowName, runId })`: Load workflow state
+- `listWorkflowRuns({ workflowName, pagination })`: List workflow runs with pagination
+- `getWorkflowRunById({ workflowName, runId })`: Get a specific workflow run
+- `updateWorkflowState({ workflowName, runId, state })`: Update workflow state
+- `updateWorkflowResults({ workflowName, runId, results })`: Update workflow results
+
+### Observability Operations
+
+- `createSpan(span)`: Create a single span
+- `batchCreateSpans({ records })`: Create multiple spans
+- `updateSpan({ traceId, spanId, updates })`: Update a span
+- `batchUpdateSpans({ records })`: Update multiple spans
+- `getTrace(traceId)`: Get a trace by ID
+- `getTracesPaginated({ ...filters, pagination })`: Get paginated traces with filtering
+- `batchDeleteTraces({ traceIds })`: Delete multiple traces
+
+### Evaluation/Scoring Operations
+
+- `getScoreById({ id })`: Get a score by ID
+- `saveScore(score)`: Save an evaluation score
+- `listScoresByScorerId({ scorerId, pagination })`: List scores by scorer with pagination
+- `listScoresByRunId({ runId, pagination })`: List scores by run with pagination
+- `listScoresByEntityId({ entityId, entityType, pagination })`: List scores by entity with pagination
+- `listScoresBySpan({ traceId, spanId, pagination })`: List scores by span with pagination
+
+## Index Management
+
+The store creates performance indexes during initialization for common query patterns:
+
+- `mastra_threads_resourceid_createdat_idx`: (resourceId, createdAt)
+- `mastra_messages_thread_id_createdat_idx`: (thread_id, createdAt)
+- `mastra_ai_spans_traceid_startedat_idx`: (traceId, startedAt)
+- `mastra_ai_spans_parentspanid_startedat_idx`: (parentSpanId, startedAt)
+- `mastra_ai_spans_name_idx`: (name)
+- `mastra_ai_spans_spantype_startedat_idx`: (spanType, startedAt)
+- `mastra_scores_trace_id_span_id_created_at_idx`: (traceId, spanId, createdAt)
+
+Notes:
+
+- Aurora DSQL creates these indexes asynchronously using `CREATE INDEX ASYNC`.
+- Because index creation is asynchronous, new indexes may not be immediately available after `init()`. The store will continue to function without them, but queries may be slower until index creation completes.
+
+### Custom Indexes
+
+Create additional indexes to optimize specific query patterns:
+
+```typescript
+await store.createIndex({
+  name: 'idx_threads_resource',
+  table: 'mastra_threads',
+  columns: ['resourceId'],
+});
+
+await store.createIndex({
+  name: 'idx_messages_composite',
+  table: 'mastra_messages',
+  columns: ['thread_id', 'createdAt'],
+});
+```
+
+Under the hood:
+
+- `createIndex` uses `CREATE INDEX ASYNC`.
+- Aurora DSQL doesn’t allow `ASC`/`DESC` in `CREATE INDEX ASYNC`, so `columns` should be plain column names.
+
+### Managing Indexes
+
+```typescript
+// List all indexes
+const allIndexes = await store.listIndexes();
+
+// List indexes for a specific table
+const threadIndexes = await store.listIndexes('mastra_threads');
+
+// Get detailed statistics for an index
+const stats = await store.describeIndex('idx_threads_resource');
+console.log(stats);
+// {
+//   name: 'idx_threads_resource',
+//   table: 'mastra_threads',
+//   columns: ['resourceId'],
+//   unique: false,
+//   size: '128 KB',
+//   definition: 'CREATE INDEX idx_threads_resource...',
+//   method: 'btree',
+//   scans: 1542,
+//   tuples_read: 45230,
+//   tuples_fetched: 12050
+// }
+
+// Drop an index
+await store.dropIndex('idx_threads_status');
+```
+
+### Index Options
+
+- `name` (required): Index name
+- `table` (required): Table name
+- `columns` (required): Array of column names (ASC/DESC automatically stripped for Aurora DSQL)
+- `unique`: Create unique index (default: false)
+- `concurrent`: Ignored in Aurora DSQL (indexes are always async)
+- `where`: Partial index condition
+- `method`: Ignored in Aurora DSQL (only btree supported)
+
+## Related Links
+
+- [Aurora DSQL Documentation](https://docs.aws.amazon.com/aurora-dsql/)
+- [SQL Reference](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/working-with-aurora-dsql-sql.html)
+- [Supported SQL Features](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/working-with-postgresql-compatibility-supported-sql-features.html)
+- [Unsupported PostgreSQL Features](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/working-with-postgresql-compatibility-unsupported-features.html)
+- [Supported Data Types](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/working-with-postgresql-compatibility-supported-data-types.html)
+- [Asynchronous Indexes](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/working-with-create-index-async.html)