add wiremock runner sample app

Author: HarshCasper

wiremock/sample-app-runner/.gitignore

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+lambda/node_modules/
+
+# Build outputs
+dist/
+*.js
+*.d.ts
+!jest.config.js
+
+# CDK
+cdk.out/
+.cdk.staging/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Local env files
+.env
+.env.local

wiremock/sample-app-runner/README.md

@@ -0,0 +1,99 @@
+# WireMock Chat Backend Sample App
+
+A CDK application demonstrating integration with WireMock-mocked OpenAI APIs running in LocalStack.
+
+## Overview
+
+This sample app deploys a serverless chat backend using:
+
+- **AWS Lambda** - Handles API requests
+- **Amazon API Gateway** - REST API endpoints
+- **WireMock** - Mocks OpenAI API responses
+
+### API Endpoints
+
+| Method | Endpoint  | Description                              |
+|--------|-----------|------------------------------------------|
+| GET    | /models   | List available AI models                 |
+| POST   | /chat     | Send a chat message                      |
+
+### WireMock OpenAI Endpoints Used
+
+- `GET /models` - Returns list of available models
+- `POST /chat/completions` - Chat completion response
+
+## Prerequisites
+
+- [LocalStack](https://localstack.cloud/) installed
+- [Node.js](https://nodejs.org/) 18+ installed
+- [AWS CDK Local](https://github.com/localstack/aws-cdk-local) (`npm install -g aws-cdk-local`)
+- WireMock extension configured with OpenAI stubs
+
+## Setup
+
+### 1. Start LocalStack with WireMock Extension
+
+To use the OpenAI mock, you need to [create the mock API in WireMock Cloud](https://app.wiremock.cloud/mock-apis/create-flow), then pull the configuration locally. Follow the instructions in the [WireMock README](../README.md) to create the mock API and pull the configuration.
+
+Once pulled, the configuration will be in the `.wiremock` directory.
+
+```bash
+LOCALSTACK_WIREMOCK_API_TOKEN="<your-wiremock-api-token>" \
+LOCALSTACK_WIREMOCK_CONFIG_DIR="/path/to/.wiremock" \
+localstack start
+```
+
+### 2. Install Dependencies
+
+```bash
+cd wiremock/sample-app-runner
+npm install
+```
+
+### 3. Bootstrap CDK
+
+```bash
+cdklocal bootstrap
+```
+
+### 4. Deploy the Stack
+
+```bash
+cdklocal deploy
+```
+
+After deployment, you'll see output similar to:
+```
+Outputs:
+WiremockChatStack.ApiEndpoint = https://<api-id>.execute-api.localhost.localstack.cloud:4566/dev/
+WiremockChatStack.ChatApiEndpoint = https://<api-id>.execute-api.localhost.localstack.cloud:4566/dev/chat
+WiremockChatStack.ModelsEndpoint = https://<api-id>.execute-api.localhost.localstack.cloud:4566/dev/models
+```
+
+## Usage
+
+### List Available Models
+
+```bash
+curl https://<api-id>.execute-api.localhost.localstack.cloud:4566/dev/models
+```
+
+### Send a Chat Message
+
+```bash
+curl -X POST https://<api-id>.execute-api.localhost.localstack.cloud:4566/dev/chat \
+  -H "Content-Type: application/json" \
+  -d '{"message": "Hello, how are you?"}'
+```
+
+## Testing
+
+```bash
+npm test
+```
+
+## How It Works
+
+1. **GET /models**: Lambda fetches the list of available models from WireMock's `/models` endpoint and returns them.
+
+2. **POST /chat**: Lambda calls WireMock's `/chat/completions` endpoint with the user's message and returns the AI response along with usage statistics.

wiremock/sample-app-runner/bin/app.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import "source-map-support/register";
+import * as cdk from "aws-cdk-lib";
+import { ChatStack } from "../lib/chat-stack";
+
+const app = new cdk.App();
+
+new ChatStack(app, "WiremockChatStack", {
+  env: {
+    account: process.env.CDK_DEFAULT_ACCOUNT || "000000000000",
+    region: process.env.CDK_DEFAULT_REGION || "us-east-1",
+  },
+});

wiremock/sample-app-runner/cdk.json

@@ -0,0 +1,22 @@
+{
+  "app": "npx ts-node --prefer-ts-exts bin/app.ts",
+  "watch": {
+    "include": ["**"],
+    "exclude": [
+      "README.md",
+      "cdk*.json",
+      "**/*.d.ts",
+      "**/*.js",
+      "tsconfig.json",
+      "package*.json",
+      "node_modules",
+      "dist"
+    ]
+  },
+  "context": {
+    "@aws-cdk/aws-apigateway:usagePlanKeyOrderInsensitiveId": true,
+    "@aws-cdk/core:stackRelativeExports": true,
+    "@aws-cdk/aws-lambda:recognizeLayerVersion": true,
+    "@aws-cdk/core:enablePartitionLiterals": true
+  }
+}

wiremock/sample-app-runner/jest.config.js

@@ -0,0 +1,9 @@
+module.exports = {
+  testEnvironment: "node",
+  roots: ["<rootDir>/test"],
+  testMatch: ["**/*.test.ts"],
+  transform: {
+    "^.+\\.tsx?$": "ts-jest",
+  },
+  testTimeout: 30000,
+};