@khester/create-dynamics-app 2.7.0 → 2.8.0

package/templates/teams-bot/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "private": true,
+  "description": "{{projectName}} — Microsoft Teams bot (Bot Framework SDK v4)",
+  "scripts": {
+    "dev": "nodemon src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "botbuilder": "^4.22.1",
+    "dotenv": "^16.4.1",
+    "express": "^4.18.2"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.11.0",
+    "nodemon": "^3.0.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  }
+}

package/templates/teams-bot/src/adapters/botAdapter.ts

@@ -0,0 +1,45 @@
+import {
+  CloudAdapter,
+  ConfigurationBotFrameworkAuthentication,
+  ConfigurationBotFrameworkAuthenticationOptions,
+  TurnContext,
+} from 'botbuilder';
+import { config } from '../config';
+
+// Error handler for the adapter
+const onTurnErrorHandler = async (context: TurnContext, error: Error): Promise<void> => {
+  console.error(`\n [onTurnError] unhandled error: ${error}`);
+  console.error(error.stack);
+
+  await context.sendActivity('The bot encountered an error or bug.');
+
+  // Send a trace activity (visible in Bot Framework Emulator)
+  await context.sendTraceActivity(
+    'OnTurnError Trace',
+    `${error}`,
+    'https://www.botframework.com/schemas/error',
+    'TurnError'
+  );
+};
+
+export function createBotAdapter(): CloudAdapter {
+  // MicrosoftAppTenantId only applies to SingleTenant — a MultiTenant bot must
+  // authenticate against the common Bot Framework authority, so omit it there.
+  const authConfig: ConfigurationBotFrameworkAuthenticationOptions = config.mockMode
+    ? {} // Empty config for mock mode
+    : {
+        MicrosoftAppId: config.botId,
+        MicrosoftAppPassword: config.botPassword,
+        MicrosoftAppType: config.appType,
+        ...(config.appType === 'SingleTenant'
+          ? { MicrosoftAppTenantId: config.botTenantId }
+          : {}),
+      };
+
+  const botFrameworkAuth = new ConfigurationBotFrameworkAuthentication(authConfig);
+  const adapter = new CloudAdapter(botFrameworkAuth);
+
+  adapter.onTurnError = onTurnErrorHandler;
+
+  return adapter;
+}

package/templates/teams-bot/src/config.ts

@@ -0,0 +1,34 @@
+import dotenv from 'dotenv';
+
+// .env.local first (the teams-app-manager identity stage writes secrets there),
+// then .env — dotenv never overwrites a key that is already set.
+dotenv.config({ path: ['.env.local', '.env'] });
+
+export type AppType = 'SingleTenant' | 'MultiTenant';
+
+export const config = {
+  // Bot Framework credentials
+  botId: process.env.MICROSOFT_APP_ID || '',
+  botPassword: process.env.MICROSOFT_APP_PASSWORD || '',
+  botTenantId: process.env.MICROSOFT_APP_TENANT_ID || '',
+  // Must match the Azure Bot resource's app type; MultiTenant needs no tenant id.
+  appType: (process.env.MICROSOFT_APP_TYPE as AppType) || 'SingleTenant',
+
+  // Shared secret for POST /api/notify (notification bots). Empty = endpoint disabled.
+  notifyApiKey: process.env.NOTIFY_API_KEY || '',
+
+  // Conversation-reference persistence (notification bots).
+  conversationStorePath: process.env.CONVERSATION_STORE_PATH || './.data/conversations.json',
+
+  // Server configuration
+  port: parseInt(process.env.PORT || '3978', 10),
+
+  // Mock mode for development without an Azure registration
+  mockMode: process.env.MOCK_MODE === 'true',
+};
+
+export function validateConfig(): void {
+  if (!config.mockMode && !config.botId) {
+    console.warn('Warning: MICROSOFT_APP_ID not set. Set MOCK_MODE=true for local development.');
+  }
+}

package/templates/teams-bot/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}