add publish ai-docs flow to release process

Author: matuscongrady

.github/workflows/release.yml

@@ -192,6 +192,10 @@ jobs:
         env:
           STACKTAPE_API_KEY: ${{ secrets.STACKTAPE_API_KEY }}
         run: bun run publish:schemas
+      - name: Publish AI docs
+        env:
+          STACKTAPE_API_KEY: ${{ secrets.STACKTAPE_API_KEY }}
+        run: bun run publish:ai:docs
 
       - name: Update package.json versions
         run: |

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/01-overview.md

@@ -0,0 +1,5 @@
+# Overview
+
+A MongoDB Atlas cluster is a schema-less, NoSQL database that is fully managed by MongoDB. Although it is not an AWS-native service, Stacktape seamlessly integrates it into your stacks.
+
+MongoDB Atlas clusters are secure, scalable, and highly available. They have built-in replication and support backups and point-in-time recovery. Each stack that includes a MongoDB Atlas cluster will also create a new [MongoDB Atlas project](https://docs.atlas.mongodb.com/tutorial/manage-projects/), which ensures isolation between stacks.

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/02-advantages.md

@@ -0,0 +1,8 @@
+# Advantages
+
+- **Secure:** Your data is protected by multiple layers of security.
+- **Scalable:** You can scale your cluster up or down as your needs change.
+- **Performant:** MongoDB Atlas is designed for high performance.
+- **Backups and point-in-time recovery:** You can restore your data to a previous state in case of an accident.
+- **High availability:** Your data is replicated across multiple servers to ensure that it is always available.
+- **ACID transactions:** MongoDB supports multi-document ACID transactions.

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/03-disadvantages.md

@@ -0,0 +1,3 @@
+# Disadvantages
+
+- **Separate billing:** Although Stacktape integrates with MongoDB Atlas, you will still need to manage your billing separately.

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/04-provider-configuration.md

@@ -0,0 +1,23 @@
+# Provider configuration
+
+To use MongoDB Atlas with Stacktape, you will need to:
+
+1.  Create a [MongoDB Atlas account](https://account.mongodb.com/account/register).
+2.  Follow our [step-by-step guide](../../user-guides/mongo-db-atlas-credentials/.md) to get your `organizationId`, `publicKey`, and `privateKey`.
+3.  Store your credentials in a [secret](../../security-resources/secrets//index.md).
+
+```yaml
+# {start-highlight}
+providerConfig:
+  mongoDbAtlas:
+    privateKey: 'xxxxfa523543fxxxx42543xx'
+    publicKey: 'xxxxxxx'
+    organizationId: 'xxxxxxxxxxx07a593cbe63dd'
+# {stop-highlight}
+
+resources:
+  myMongoCluster:
+    type: 'mongo-db-atlas-cluster'
+    properties:
+      clusterTier: M2
+```

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/05-basic-usage.md

@@ -0,0 +1,51 @@
+# Basic usage
+
+```yaml
+# {start-ignore}
+providerConfig:
+  mongoDbAtlas:
+    privateKey: 'xxxxfa523543fxxxx42543xx'
+    publicKey: 'xxxxxxx'
+    organizationId: 'xxxxxxxxxxx07a593cbe63dd'
+# {stop-ignore}
+resources:
+  # {start-highlight}
+  myMongoDbCluster:
+    type: mongo-db-atlas-cluster
+    properties:
+      clusterTier: M2
+  # {stop-highlight}
+  myLambda:
+    type: function
+    properties:
+      packaging:
+        type: stacktape-lambda-buildpack
+        properties:
+          entryfilePath: path/to/my/lambda.ts
+      environment:
+        - name: MONGODB_CONNECTION_STRING
+          value: $ResourceParam('myMongoDbCluster', 'connectionString')
+      connectTo:
+        - myMongoDbCluster
+```
+
+```typescript
+import { MongoClient } from 'mongodb';
+
+const client = new MongoClient(process.env.MONGODB_CONNECTION_STRING);
+
+const handler = async (event, context) => {
+  await client.connect();
+
+  const db = client.db('mydb');
+
+  await db.collection('posts').insertOne({
+    title: 'My first post',
+    content: 'Hello!'
+  });
+
+  const post = await db.collection('posts').findOne({ title: 'My first post' });
+
+  await client.close();
+};
+```

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/06-cluster-tier.md

@@ -0,0 +1,20 @@
+# Cluster tier
+
+The cluster tier determines the resources (memory, storage, IOPS) for each data-bearing node in your cluster. To learn more, see the [MongoDB Atlas documentation](https://docs.atlas.mongodb.com/cluster-tier/).
+
+```yaml
+# {start-ignore}
+providerConfig:
+  mongoDbAtlas:
+    privateKey: 'xxxxfa523543fxxxx42543xx'
+    publicKey: 'xxxxxxx'
+    organizationId: 'xxxxxxxxxxx07a593cbe63dd'
+# {stop-ignore}
+resources:
+  myMongoCluster:
+    type: 'mongo-db-atlas-cluster'
+    properties:
+      # {start-highlight}
+      clusterTier: M2
+      # {stop-highlight}
+```

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/07-disk-size.md

@@ -0,0 +1,21 @@
+# Disk size
+
+Each cluster tier comes with a default amount of storage. All M10+ clusters automatically scale their storage, but you can disable this behavior. You can also customize the storage capacity for all M10+ clusters.
+
+```yaml
+# {start-ignore}
+providerConfig:
+  mongoDbAtlas:
+    privateKey: 'xxxxfa523543fxxxx42543xx'
+    publicKey: 'xxxxxxx'
+    organizationId: 'xxxxxxxxxxx07a593cbe63dd'
+# {stop-ignore}
+resources:
+  myMongoCluster:
+    type: mongo-db-atlas-cluster
+    properties:
+      clusterTier: M2
+      # {start-highlight}
+      diskSizeGB: 60
+      # {stop-highlight}
+```

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/08-auto-scaling.md

@@ -0,0 +1,23 @@
+# Auto-scaling
+
+```yaml
+# {start-ignore}
+providerConfig:
+  mongoDbAtlas:
+    privateKey: 'xxxxfa523543fxxxx42543xx'
+    publicKey: 'xxxxxxx'
+    organizationId: 'xxxxxxxxxxx07a593cbe63dd'
+# {stop-ignore}
+resources:
+  myMongoDbCluster:
+    type: mongo-db-atlas-cluster
+    properties:
+      clusterTier: M10
+      # {start-highlight}
+      autoScaling:
+        minClusterTier: M10
+        maxClusterTier: M30
+        disableDiskScaling: true
+        disableScaleDown: true
+      # {stop-highlight}
+```

@generated/ai-docs/3rd-party-resources/mongo-db-atlas-clusters/09-sharding.md

@@ -0,0 +1,19 @@
+# Sharding
+
+```yaml
+# {start-ignore}
+providerConfig:
+  mongoDbAtlas:
+    privateKey: 'xxxxfa523543fxxxx42543xx'
+    publicKey: 'xxxxxxx'
+    organizationId: 'xxxxxxxxxxx07a593cbe63dd'
+# {stop-ignore}
+resources:
+  myMongoCluster:
+    type: mongo-db-atlas-cluster
+    properties:
+      clusterTier: M30
+      # {start-highlight}
+      numShards: 3
+      # {stop-highlight}
+```