Add dbx hosting integration (#1391)

* feat(dbx): implement sqlserver extensions

* feat(dbx): implement postgres extensions

* feat(dbx): implement mysql extensions

* test: add tests for dbx integration

* feat(dbx): implement redis extensions

* feat(dbx): implement mongodb extensions

* docs(dbx): add missing readme

* feat(dbx): disable password protection

* Apply suggestions from code review

Co-authored-by: Aaron Powell <me@aaron-powell.com>

* ci: bump typescript app host sdk version

---------

Co-authored-by: Aaron Powell <me@aaron-powell.com>

Author: Odonno

CommunityToolkit.Aspire.slnx

@@ -30,6 +30,9 @@
   <Folder Name="/examples/dbgate/">
     <Project Path="examples/dbgate/CommunityToolkit.Aspire.Hosting.DbGate.AppHost/CommunityToolkit.Aspire.Hosting.DbGate.AppHost.csproj" />
   </Folder>
+  <Folder Name="/examples/dbx/">
+    <Project Path="examples/dbx/CommunityToolkit.Aspire.Hosting.Dbx.AppHost/CommunityToolkit.Aspire.Hosting.Dbx.AppHost.csproj" />
+  </Folder>
   <Folder Name="/examples/deno/">
     <Project Path="examples/deno/CommunityToolkit.Aspire.Hosting.Deno.AppHost/CommunityToolkit.Aspire.Hosting.Deno.AppHost.csproj" />
   </Folder>
@@ -216,6 +219,7 @@
     <Project Path="src/CommunityToolkit.Aspire.Hosting.Azure.Extensions/CommunityToolkit.Aspire.Hosting.Azure.Extensions.csproj" />
     <Project Path="src/CommunityToolkit.Aspire.Hosting.Bun/CommunityToolkit.Aspire.Hosting.Bun.csproj" />
     <Project Path="src/CommunityToolkit.Aspire.Hosting.DbGate/CommunityToolkit.Aspire.Hosting.DbGate.csproj" />
+    <Project Path="src/CommunityToolkit.Aspire.Hosting.Dbx/CommunityToolkit.Aspire.Hosting.Dbx.csproj" />
     <Project Path="src/CommunityToolkit.Aspire.Hosting.Deno/CommunityToolkit.Aspire.Hosting.Deno.csproj" />
     <Project Path="src/CommunityToolkit.Aspire.Hosting.DuckDB/CommunityToolkit.Aspire.Hosting.DuckDB.csproj" />
     <Project Path="src/CommunityToolkit.Aspire.Hosting.Elasticsearch.Extensions/CommunityToolkit.Aspire.Hosting.Elasticsearch.Extensions.csproj" />
@@ -283,6 +287,7 @@
     <Project Path="tests/CommunityToolkit.Aspire.Hosting.Azure.Extensions.Tests/CommunityToolkit.Aspire.Hosting.Azure.Extensions.Tests.csproj" />
     <Project Path="tests/CommunityToolkit.Aspire.Hosting.Bun.Tests/CommunityToolkit.Aspire.Hosting.Bun.Tests.csproj" />
     <Project Path="tests/CommunityToolkit.Aspire.Hosting.DbGate.Tests/CommunityToolkit.Aspire.Hosting.DbGate.Tests.csproj" />
+    <Project Path="tests/CommunityToolkit.Aspire.Hosting.Dbx.Tests/CommunityToolkit.Aspire.Hosting.Dbx.Tests.csproj" />
     <Project Path="tests/CommunityToolkit.Aspire.Hosting.Deno.Tests/CommunityToolkit.Aspire.Hosting.Deno.Tests.csproj" />
     <Project Path="tests/CommunityToolkit.Aspire.Hosting.DuckDB.Tests/CommunityToolkit.Aspire.Hosting.DuckDB.Tests.csproj" />
     <Project Path="tests/CommunityToolkit.Aspire.Hosting.Elasticsearch.Extensions.Tests/CommunityToolkit.Aspire.Hosting.Elasticsearch.Extensions.Tests.csproj" />

examples/dbx/CommunityToolkit.Aspire.Hosting.Dbx.AppHost.TypeScript/apphost.mts

@@ -0,0 +1,19 @@
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { createBuilder } from "./.aspire/modules/aspire.mjs";
+
+const builder = await createBuilder();
+
+// addDbx — create a Dbx resource with an explicit name
+const dbx = await builder.addDbx({ name: "dbx" });
+
+// withHostPort — configure a fixed host port
+await dbx.withHostPort({ port: 3310 });
+
+// ---- Property access on DbxContainerResource (ExposeProperties = true) ----
+const dbxResource = await dbx;
+const _primaryEndpoint = await dbxResource.primaryEndpoint();
+
+await builder.build().run();

examples/dbx/CommunityToolkit.Aspire.Hosting.Dbx.AppHost.TypeScript/aspire.config.json

@@ -0,0 +1,21 @@
+{
+  "appHost": {
+    "path": "apphost.mts",
+    "language": "typescript/nodejs"
+  },
+  "sdk": {
+    "version": "13.4.3"
+  },
+  "profiles": {
+    "https": {
+      "applicationUrl": "https://localhost:29750;http://localhost:28931",
+      "environmentVariables": {
+        "ASPIRE_DASHBOARD_OTLP_ENDPOINT_URL": "https://localhost:10975",
+        "ASPIRE_RESOURCE_SERVICE_ENDPOINT_URL": "https://localhost:13319"
+      }
+    }
+  },
+  "packages": {
+    "CommunityToolkit.Aspire.Hosting.Dbx": "../../../src/CommunityToolkit.Aspire.Hosting.Dbx/CommunityToolkit.Aspire.Hosting.Dbx.csproj"
+  }
+}

examples/dbx/CommunityToolkit.Aspire.Hosting.Dbx.AppHost.TypeScript/eslint.config.mjs

@@ -0,0 +1,17 @@
+// @ts-check
+
+import { defineConfig } from 'eslint/config';
+import tseslint from 'typescript-eslint';
+
+export default defineConfig({
+  files: ['apphost.mts'],
+  extends: [tseslint.configs.base],
+  languageOptions: {
+    parserOptions: {
+      projectService: true,
+    },
+  },
+  rules: {
+    '@typescript-eslint/no-floating-promises': ['error', { checkThenables: true }],
+  },
+});