create-aws-project 1.2.1

package/templates/packages/api-client/src/config.ts

@@ -0,0 +1,193 @@
+/**
+ * API Client Configuration Utilities
+ *
+ * Provides environment-aware configuration for the API client.
+ * Works across different environments (web, mobile, Node.js)
+ */
+
+import type { ApiClientConfig } from './api-client';
+
+/**
+ * Environment-specific configuration options
+ */
+export interface EnvironmentConfig {
+  /**
+   * API base URL (e.g., 'https://api.example.com')
+   */
+  apiBaseUrl?: string;
+
+  /**
+   * Request timeout in milliseconds
+   */
+  apiTimeout?: string | number;
+
+  /**
+   * API key or token for authentication
+   */
+  apiKey?: string;
+
+  /**
+   * Whether to send credentials (cookies) with requests
+   */
+  apiWithCredentials?: string | boolean;
+
+  /**
+   * Enable debug logging
+   */
+  apiDebug?: string | boolean;
+}
+
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+  baseURL: 'http://localhost:3000',
+  timeout: 30000,
+  withCredentials: false,
+  debug: false,
+} as const;
+
+/**
+ * Convert string values to appropriate types
+ */
+function parseValue<T>(value: string | T | undefined, defaultValue: T): T {
+  if (value === undefined) return defaultValue;
+  if (typeof value !== 'string') return value;
+
+  // Handle boolean strings
+  if (typeof defaultValue === 'boolean') {
+    return (value.toLowerCase() === 'true') as T;
+  }
+
+  // Handle number strings
+  if (typeof defaultValue === 'number') {
+    const parsed = parseInt(value, 10);
+    return (isNaN(parsed) ? defaultValue : parsed) as T;
+  }
+
+  return value as T;
+}
+
+/**
+ * Get environment variable value
+ *
+ * Supports multiple environment variable naming conventions:
+ * - Vite: VITE_API_BASE_URL
+ * - Expo: EXPO_PUBLIC_API_BASE_URL
+ * - Node.js: API_BASE_URL
+ */
+function getEnvVar(name: string): string | undefined {
+  // Check Node.js process.env (works for both Node.js and React Native/Expo)
+  if (typeof process !== 'undefined' && process.env) {
+    // Try EXPO_PUBLIC_ prefix first (for React Native/Expo)
+    const expoVar = process.env[`EXPO_PUBLIC_${name}`] as string | undefined;
+    if (expoVar) return expoVar;
+
+    // Try VITE_ prefix (for Vite)
+    const viteVar = process.env[`VITE_${name}`] as string | undefined;
+    if (viteVar) return viteVar;
+
+    // Try regular name (for Node.js)
+    const nodeVar = process.env[name] as string | undefined;
+    if (nodeVar) return nodeVar;
+  }
+
+  return undefined;
+}
+
+/**
+ * Create API client configuration from environment variables
+ *
+ * Environment variable mapping:
+ * - VITE_API_BASE_URL / EXPO_PUBLIC_API_BASE_URL / API_BASE_URL
+ * - VITE_API_TIMEOUT / EXPO_PUBLIC_API_TIMEOUT / API_TIMEOUT
+ * - VITE_API_KEY / EXPO_PUBLIC_API_KEY / API_KEY
+ * - VITE_API_WITH_CREDENTIALS / EXPO_PUBLIC_API_WITH_CREDENTIALS / API_WITH_CREDENTIALS
+ * - VITE_API_DEBUG / EXPO_PUBLIC_API_DEBUG / API_DEBUG
+ *
+ * @param overrides - Optional configuration overrides
+ * @returns API client configuration
+ */
+export function createConfigFromEnv(overrides?: Partial<ApiClientConfig>): ApiClientConfig {
+  const baseURL = getEnvVar('API_BASE_URL') || DEFAULT_CONFIG.baseURL;
+  const timeout = parseValue(getEnvVar('API_TIMEOUT'), DEFAULT_CONFIG.timeout);
+  const withCredentials = parseValue(getEnvVar('API_WITH_CREDENTIALS'), DEFAULT_CONFIG.withCredentials);
+  const apiKey = getEnvVar('API_KEY');
+  const debug = parseValue(getEnvVar('API_DEBUG'), DEFAULT_CONFIG.debug);
+
+  // Build headers
+  const headers: Record<string, string> = {};
+  if (apiKey) {
+    headers['Authorization'] = `Bearer ${apiKey}`;
+  }
+
+  // Log configuration in debug mode
+  if (debug) {
+    console.log('[API Client] Configuration:', {
+      baseURL,
+      timeout,
+      withCredentials,
+      hasApiKey: !!apiKey,
+    });
+  }
+
+  return {
+    baseURL,
+    timeout,
+    withCredentials,
+    headers,
+    ...overrides,
+  };
+}
+
+/**
+ * Get default API base URL based on environment
+ *
+ * Auto-detects the appropriate URL:
+ * - In production (web): Uses window.location.origin
+ * - In development (web): Uses localhost:3000
+ * - With env var: Uses provided URL
+ *
+ * @returns The base URL for API requests
+ */
+export function getDefaultBaseURL(): string {
+  // Check for explicit environment variable
+  const envUrl = getEnvVar('API_BASE_URL');
+  if (envUrl) return envUrl;
+
+  // In browser, check if we're in production
+  if (typeof window !== 'undefined') {
+    const origin = window.location.origin;
+
+    // If running on localhost, assume API is on port 3000
+    if (origin.includes('localhost') || origin.includes('127.0.0.1')) {
+      return 'http://localhost:3000';
+    }
+
+    // In production, API is at same origin (CloudFront setup)
+    return origin;
+  }
+
+  // Default fallback
+  return DEFAULT_CONFIG.baseURL;
+}
+
+/**
+ * Create API client configuration with smart defaults
+ *
+ * @param overrides - Optional configuration overrides
+ * @returns API client configuration
+ */
+export function createConfig(overrides?: Partial<ApiClientConfig>): ApiClientConfig {
+  const baseURL = overrides?.baseURL || getDefaultBaseURL();
+
+  return createConfigFromEnv({
+    ...overrides,
+    baseURL,
+  });
+}
+
+/**
+ * Export default configuration values for reference
+ */
+export const DEFAULT_API_CONFIG = DEFAULT_CONFIG;

package/templates/packages/api-client/src/index.ts

@@ -0,0 +1,9 @@
+export { ApiClient, createApiClient, ApiError } from './api-client';
+export type { ApiClientConfig } from './api-client';
+export {
+  createConfig,
+  createConfigFromEnv,
+  getDefaultBaseURL,
+  DEFAULT_API_CONFIG
+} from './config';
+export type { EnvironmentConfig } from './config';

package/templates/packages/api-client/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "esnext",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/templates/packages/api-client/tsconfig.lib.json

@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"],
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["jest.config.ts", "src/**/*.spec.ts", "src/**/*.test.ts"]
+}

package/templates/packages/api-client/tsconfig.spec.json

@@ -0,0 +1,14 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "module": "commonjs",
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "jest.config.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.d.ts"
+  ]
+}

package/templates/packages/common-types/.eslintrc.json

@@ -0,0 +1,18 @@
+{
+  "extends": ["../../.eslintrc.js"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

package/templates/packages/common-types/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "{{PACKAGE_SCOPE}}/common-types",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "main": "./src/index.ts"
+}

package/templates/packages/common-types/project.json.template

@@ -0,0 +1,26 @@
+{
+  "name": "common-types",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/common-types/src",
+  "projectType": "library",
+  "tags": ["type:lib"],
+  "targets": {
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": ["{options.outputFile}"],
+      "options": {
+        "lintFilePatterns": ["packages/common-types/**/*.ts"]
+      }
+    },
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/packages/common-types",
+        "main": "packages/common-types/src/index.ts",
+        "tsConfig": "packages/common-types/tsconfig.lib.json",
+        "assets": ["packages/common-types/*.md"]
+      }
+    }
+  }
+}

package/templates/packages/common-types/src/api.types.ts

@@ -0,0 +1,24 @@
+/**
+ * API Response Types
+ *
+ * Standard response structures for API endpoints
+ */
+
+/**
+ * Standard API response wrapper
+ */
+export interface ApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: ApiError;
+    message?: string;
+}
+
+/**
+ * Error details structure
+ */
+export interface ApiError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}

package/templates/packages/common-types/src/auth.types.ts

@@ -0,0 +1,36 @@
+/**
+ * Authenticated user information
+ */
+export interface AuthUser {
+  id: string;           // Cognito sub
+  email: string;
+  emailVerified: boolean;
+  groups?: string[];
+}
+
+/**
+ * Auth state for UI consumption
+ */
+export interface AuthState {
+  user: AuthUser | null;
+  isLoading: boolean;
+  isAuthenticated: boolean;
+  error: Error | null;
+}
+
+/**
+ * Auth context actions
+ */
+export interface AuthActions {
+  signIn: (email: string, password: string) => Promise<void>;
+  signUp: (email: string, password: string) => Promise<void>;
+  signOut: () => Promise<void>;
+  confirmSignUp: (email: string, code: string) => Promise<void>;
+  forgotPassword: (email: string) => Promise<void>;
+  confirmForgotPassword: (email: string, code: string, newPassword: string) => Promise<void>;
+}
+
+/**
+ * Complete auth context type
+ */
+export type AuthContextType = AuthState & AuthActions;

package/templates/packages/common-types/src/common.types.ts

@@ -0,0 +1,46 @@
+/**
+ * Common Types and Constants
+ *
+ * Shared utility types and constant values used across the application
+ */
+
+/**
+ * Utility Types
+ */
+
+/**
+ * Makes a type nullable (can be T or null)
+ */
+export type Nullable<T> = T | null;
+
+/**
+ * Makes a type optional (can be T or undefined)
+ */
+export type Optional<T> = T | undefined;
+
+/**
+ * Constants
+ */
+
+/**
+ * HTTP status codes
+ */
+export const HTTP_STATUS = {
+    OK: 200,
+    CREATED: 201,
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    INTERNAL_SERVER_ERROR: 500,
+} as const;
+
+/**
+ * Application error codes
+ */
+export const ERROR_CODES = {
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    NOT_FOUND: 'NOT_FOUND',
+    UNAUTHORIZED: 'UNAUTHORIZED',
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+} as const;

package/templates/packages/common-types/src/index.ts

@@ -0,0 +1,19 @@
+/**
+ * {{PACKAGE_SCOPE}}/common-types
+ *
+ * Shared TypeScript types for the monorepo
+ *
+ * This package provides common types used across frontend and backend:
+ * - User types and API requests
+ * - API response structures
+ * - AWS Lambda event/context types
+ * - Common utilities and constants
+ * - Authentication types (Cognito/Auth0)
+ */
+
+// Re-export all types for convenience
+export * from './user.types';
+export * from './api.types';
+export * from './lambda.types';
+export * from './common.types';
+export * from './auth.types';

package/templates/packages/common-types/src/lambda.types.ts

@@ -0,0 +1,39 @@
+/**
+ * AWS Lambda Types
+ *
+ * Types for AWS Lambda events, contexts, and responses
+ */
+
+/**
+ * AWS Lambda execution context
+ */
+export interface LambdaContext {
+    requestId: string;
+    functionName: string;
+    functionVersion: string;
+    memoryLimitInMB: string;
+    logGroupName: string;
+    logStreamName: string;
+}
+
+/**
+ * API Gateway proxy event structure
+ */
+export interface ApiGatewayProxyEvent {
+    httpMethod: string;
+    path: string;
+    pathParameters: Record<string, string> | null;
+    queryStringParameters: Record<string, string> | null;
+    headers: Record<string, string>;
+    body: string | null;
+    isBase64Encoded: boolean;
+}
+
+/**
+ * API Gateway proxy response structure
+ */
+export interface ApiGatewayProxyResult {
+    statusCode: number;
+    headers?: Record<string, string>;
+    body: string;
+}

package/templates/packages/common-types/src/user.types.ts

@@ -0,0 +1,31 @@
+/**
+ * User Domain Types
+ *
+ * Contains all user-related types and interfaces
+ */
+
+/**
+ * User entity
+ */
+export interface User {
+  id: string;
+  email: string;
+  name: string;
+  createdAt: string;
+  updatedAt?: string;
+}
+
+/**
+ * Request body for creating a new user
+ */
+export interface CreateUserRequest {
+  email: string;
+  name: string;
+}
+
+/**
+ * Request body for updating an existing user
+ */
+export interface UpdateUserRequest {
+  name?: string;
+}

package/templates/packages/common-types/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    }
+  ]
+}

package/templates/packages/common-types/tsconfig.lib.json

@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"],
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["**/*.spec.ts", "**/*.test.ts"]
+}

package/templates/root/.editorconfig

@@ -0,0 +1,23 @@
+# EditorConfig helps maintain consistent coding styles
+# for multiple developers working on the same project
+# across various editors and IDEs
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

package/templates/root/.nvmrc

@@ -0,0 +1 @@
+22.16.0

package/templates/root/eslint.config.js

@@ -0,0 +1,61 @@
+const {
+  defineConfig,
+  globalIgnores,
+} = require("eslint/config");
+
+const nx = require("@nx/eslint-plugin");
+const js = require("@eslint/js");
+
+const {
+  FlatCompat,
+} = require("@eslint/eslintrc");
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+  recommendedConfig: js.configs.recommended,
+  allConfig: js.configs.all
+});
+
+module.exports = defineConfig([{
+  plugins: {
+    "@nx": nx,
+  },
+}, globalIgnores([
+  "**/node_modules/**",
+  "**/dist/**",
+  "**/build/**",
+  "**/coverage/**",
+  "**/.nx/**",
+  "**/cdk.out/**",
+  "**/tmp/**"
+]), {
+  files: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"],
+
+  rules: {
+    "@nx/enforce-module-boundaries": ["error", {
+      enforceBuildableLibDependency: true,
+      allow: [],
+
+      depConstraints: [{
+        sourceTag: "*",
+        onlyDependOnLibsWithTags: ["*"],
+      }],
+    }],
+  },
+}, {
+  files: ["**/*.ts", "**/*.tsx"],
+  extends: compat.extends("plugin:@nx/typescript"),
+
+  rules: {
+    "@typescript-eslint/no-explicit-any": "warn",
+
+    "@typescript-eslint/no-unused-vars": ["warn", {
+      argsIgnorePattern: "^_",
+      varsIgnorePattern: "^_",
+    }],
+  },
+}, {
+  files: ["**/*.js", "**/*.jsx"],
+  extends: compat.extends("plugin:@nx/javascript"),
+  rules: {},
+}]);

package/templates/root/jest.preset.js

@@ -0,0 +1,16 @@
+const nxPreset = require('@nx/jest/preset').default;
+
+module.exports = {
+  ...nxPreset,
+  testMatch: ['**/+(*.)+(spec|test).+(ts|js|tsx|jsx)'],
+  transform: {
+    '^.+\\.(ts|tsx|js|jsx)$': [
+      'ts-jest',
+      {
+        tsconfig: '<rootDir>/tsconfig.spec.json',
+      },
+    ],
+  },
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx'],
+  coverageReporters: ['html', 'text', 'json', 'json-summary'],
+};

package/templates/root/nx.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "./node_modules/nx/schemas/nx-schema.json",
+  "affected": {
+    "defaultBase": "main"
+  },
+  "targetDefaults": {
+    "build": {
+      "cache": true,
+      "dependsOn": ["^build"]
+    },
+    "lint": {
+      "cache": true
+    },
+    "test": {
+      "cache": true
+    }
+  },
+  "defaultProject": "web",
+  "namedInputs": {
+    "default": ["{projectRoot}/**/*", "sharedGlobals"],
+    "production": [
+      "default",
+      "!{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)",
+      "!{projectRoot}/tsconfig.spec.json",
+      "!{projectRoot}/.eslintrc.json"
+    ],
+    "sharedGlobals": []
+  }
+}