@mytechtoday/augment-extensions 1.7.0 → 2.2.0

package/augment-extensions/coding-standards/typescript/examples/monorepo-config/README.md

@@ -0,0 +1,47 @@
+# Monorepo Configuration Examples
+
+This directory contains example configuration files for setting up a TypeScript monorepo using Turborepo.
+
+## Files
+
+- **turbo.json** - Turborepo pipeline configuration
+- **pnpm-workspace.yaml** - pnpm workspace configuration
+- **package.json** - Root package.json with scripts
+- **tsconfig.base.json** - Base TypeScript configuration
+
+## Usage
+
+1. Copy these files to your monorepo root
+2. Install dependencies: `pnpm install`
+3. Create your apps and packages directories
+4. Run `turbo run build` to build all packages
+
+## Directory Structure
+
+```
+my-monorepo/
+├── apps/
+│   ├── web/              # Next.js app
+│   └── api/              # Express API
+├── packages/
+│   ├── ui/               # Shared UI components
+│   ├── types/            # Shared TypeScript types
+│   └── config/           # Shared configurations
+├── turbo.json
+├── pnpm-workspace.yaml
+├── package.json
+└── tsconfig.base.json
+```
+
+## Commands
+
+- `pnpm build` - Build all packages
+- `pnpm dev` - Start all dev servers
+- `pnpm lint` - Lint all packages
+- `pnpm test` - Run all tests
+- `pnpm type-check` - Type check all packages
+
+## Learn More
+
+See the main monorepo.md guide for detailed documentation.
+

package/augment-extensions/coding-standards/typescript/examples/monorepo-config/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "my-monorepo",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Example monorepo with Turborepo",
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
+  "scripts": {
+    "build": "turbo run build",
+    "dev": "turbo run dev",
+    "lint": "turbo run lint",
+    "test": "turbo run test",
+    "test:ci": "turbo run test:ci",
+    "type-check": "turbo run type-check",
+    "clean": "turbo run clean && rm -rf node_modules",
+    "format": "prettier --write \"**/*.{ts,tsx,md,json}\"",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "turbo run build && changeset publish"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.0",
+    "@types/node": "^20.11.0",
+    "prettier": "^3.2.0",
+    "turbo": "^2.0.0",
+    "typescript": "^5.6.0",
+    "syncpack": "^12.0.0"
+  },
+  "packageManager": "pnpm@9.0.0",
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}
+

package/augment-extensions/coding-standards/typescript/examples/monorepo-config/pnpm-workspace.yaml

@@ -0,0 +1,5 @@
+packages:
+  - 'apps/*'
+  - 'packages/*'
+  - 'tools/*'
+

package/augment-extensions/coding-standards/typescript/examples/monorepo-config/tsconfig.base.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    // Type Checking
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noFallthroughCasesInSwitch": true,
+    
+    // Modules
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    
+    // Emit
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "removeComments": false,
+    "importHelpers": true,
+    "importsNotUsedAsValues": "error",
+    
+    // Interop Constraints
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    
+    // Language and Environment
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "useDefineForClassFields": true,
+    
+    // Projects
+    "incremental": true,
+    "composite": true,
+    
+    // Completeness
+    "skipLibCheck": true
+  },
+  "exclude": [
+    "node_modules",
+    "dist",
+    "build",
+    ".turbo",
+    ".next",
+    "coverage"
+  ]
+}
+

package/augment-extensions/coding-standards/typescript/examples/monorepo-config/turbo.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "globalDependencies": ["**/.env.*local"],
+  "globalEnv": ["NODE_ENV", "CI"],
+  "pipeline": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": [
+        ".next/**",
+        "!.next/cache/**",
+        "dist/**",
+        "build/**"
+      ],
+      "env": ["NODE_ENV", "NEXT_PUBLIC_*"]
+    },
+    "test": {
+      "dependsOn": ["build"],
+      "outputs": ["coverage/**"],
+      "cache": false
+    },
+    "test:ci": {
+      "dependsOn": ["build"],
+      "outputs": ["coverage/**"],
+      "cache": true
+    },
+    "lint": {
+      "outputs": [],
+      "cache": true
+    },
+    "type-check": {
+      "dependsOn": ["^build"],
+      "outputs": [],
+      "cache": true
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "clean": {
+      "cache": false
+    }
+  },
+  "remoteCache": {
+    "enabled": true
+  }
+}
+

package/augment-extensions/coding-standards/typescript/examples/vitest-setup.ts

@@ -0,0 +1,198 @@
+// test/setup.ts - Vitest + MSW Setup Example
+// This file sets up the test environment with MSW for API mocking
+
+import { afterAll, afterEach, beforeAll } from 'vitest';
+import { cleanup } from '@testing-library/react';
+import '@testing-library/jest-dom/vitest';
+import { server } from './mocks/server';
+
+// ============================================================================
+// MSW Server Setup
+// ============================================================================
+
+// Start MSW server before all tests
+beforeAll(() => {
+  server.listen({
+    onUnhandledRequest: 'error' // Fail tests on unhandled requests
+  });
+  console.log('🔶 MSW server started');
+});
+
+// Reset handlers after each test to ensure test isolation
+afterEach(() => {
+  server.resetHandlers();
+  cleanup(); // Clean up React Testing Library
+});
+
+// Clean up after all tests
+afterAll(() => {
+  server.close();
+  console.log('🔶 MSW server closed');
+});
+
+// ============================================================================
+// MSW Handlers (test/mocks/handlers.ts)
+// ============================================================================
+
+import { http, HttpResponse } from 'msw';
+
+export const handlers = [
+  // GET /api/users - List users
+  http.get('/api/users', () => {
+    return HttpResponse.json([
+      { id: 1, name: 'John Doe', email: 'john@example.com' },
+      { id: 2, name: 'Jane Smith', email: 'jane@example.com' }
+    ]);
+  }),
+
+  // GET /api/users/:id - Get user by ID
+  http.get('/api/users/:id', ({ params }) => {
+    const { id } = params;
+    return HttpResponse.json({
+      id: Number(id),
+      name: 'John Doe',
+      email: 'john@example.com'
+    });
+  }),
+
+  // POST /api/users - Create user
+  http.post('/api/users', async ({ request }) => {
+    const newUser = await request.json();
+    return HttpResponse.json(
+      { id: 3, ...newUser },
+      { status: 201 }
+    );
+  }),
+
+  // PUT /api/users/:id - Update user
+  http.put('/api/users/:id', async ({ params, request }) => {
+    const { id } = params;
+    const updates = await request.json();
+    return HttpResponse.json({
+      id: Number(id),
+      ...updates
+    });
+  }),
+
+  // DELETE /api/users/:id - Delete user
+  http.delete('/api/users/:id', ({ params }) => {
+    const { id } = params;
+    return HttpResponse.json(
+      { message: `User ${id} deleted` },
+      { status: 200 }
+    );
+  }),
+
+  // Error response example
+  http.get('/api/error', () => {
+    return HttpResponse.json(
+      { message: 'Internal Server Error' },
+      { status: 500 }
+    );
+  }),
+
+  // Delayed response example
+  http.get('/api/slow', async () => {
+    await new Promise((resolve) => setTimeout(resolve, 1000));
+    return HttpResponse.json({ data: 'slow response' });
+  }),
+
+  // Paginated response example
+  http.get('/api/posts', ({ request }) => {
+    const url = new URL(request.url);
+    const page = Number(url.searchParams.get('page')) || 1;
+    const limit = Number(url.searchParams.get('limit')) || 10;
+
+    return HttpResponse.json({
+      data: Array.from({ length: limit }, (_, i) => ({
+        id: (page - 1) * limit + i + 1,
+        title: `Post ${(page - 1) * limit + i + 1}`
+      })),
+      pagination: {
+        page,
+        limit,
+        total: 100,
+        totalPages: Math.ceil(100 / limit)
+      }
+    });
+  })
+];
+
+// ============================================================================
+// MSW Server (test/mocks/server.ts)
+// ============================================================================
+
+import { setupServer } from 'msw/node';
+import { handlers } from './handlers';
+
+export const server = setupServer(...handlers);
+
+// ============================================================================
+// Example Test (src/api/users.test.ts)
+// ============================================================================
+
+import { describe, it, expect, beforeEach } from 'vitest';
+import { render, screen, waitFor } from '@testing-library/react';
+import { server } from '../test/mocks/server';
+import { http, HttpResponse } from 'msw';
+import { UserList } from './UserList';
+
+describe('UserList', () => {
+  it('renders users from API', async () => {
+    render(<UserList />);
+
+    await waitFor(() => {
+      expect(screen.getByText('John Doe')).toBeInTheDocument();
+      expect(screen.getByText('Jane Smith')).toBeInTheDocument();
+    });
+  });
+
+  it('handles API errors gracefully', async () => {
+    // Override handler for this specific test
+    server.use(
+      http.get('/api/users', () => {
+        return HttpResponse.json(
+          { message: 'Failed to fetch users' },
+          { status: 500 }
+        );
+      })
+    );
+
+    render(<UserList />);
+
+    await waitFor(() => {
+      expect(screen.getByText('Error loading users')).toBeInTheDocument();
+    });
+  });
+
+  it('handles empty response', async () => {
+    server.use(
+      http.get('/api/users', () => {
+        return HttpResponse.json([]);
+      })
+    );
+
+    render(<UserList />);
+
+    await waitFor(() => {
+      expect(screen.getByText('No users found')).toBeInTheDocument();
+    });
+  });
+
+  it('creates a new user', async () => {
+    const { getByRole, getByLabelText } = render(<UserForm />);
+
+    const nameInput = getByLabelText('Name');
+    const emailInput = getByLabelText('Email');
+    const submitButton = getByRole('button', { name: 'Submit' });
+
+    await userEvent.type(nameInput, 'New User');
+    await userEvent.type(emailInput, 'new@example.com');
+    await userEvent.click(submitButton);
+
+    await waitFor(() => {
+      expect(screen.getByText('User created successfully')).toBeInTheDocument();
+    });
+  });
+});
+

package/augment-extensions/coding-standards/typescript/metadata.json

@@ -0,0 +1,46 @@
+{
+  "version": "2.0.0",
+  "name": "typescript-standards",
+  "displayName": "TypeScript Standards",
+  "description": "Comprehensive TypeScript coding standards and best practices including modern features, tooling, testing, architecture, and security",
+  "type": "coding-standards",
+  "language": "typescript",
+  "tags": [
+    "typescript",
+    "coding-standards",
+    "best-practices",
+    "type-safety",
+    "modern-typescript",
+    "tooling",
+    "testing",
+    "architecture",
+    "security",
+    "monorepo"
+  ],
+  "compatibility": {
+    "augmentMinVersion": "1.0.0",
+    "nodeMinVersion": "18.0.0",
+    "typescriptMinVersion": "5.0.0"
+  },
+  "characterCount": 25000,
+  "lastUpdated": "2026-02-25",
+  "files": {
+    "rules": [
+      "naming-conventions.md",
+      "type-patterns.md",
+      "modern-features.md",
+      "error-handling.md",
+      "tooling.md",
+      "security-performance.md",
+      "testing.md",
+      "architecture.md",
+      "monorepo.md"
+    ],
+    "examples": [
+      "eslint-flat-config.js",
+      "biome.json",
+      "vitest-setup.ts"
+    ]
+  }
+}
+

package/augment-extensions/coding-standards/typescript/module.json

@@ -1,24 +1,42 @@
 {
   "name": "typescript-standards",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "displayName": "TypeScript Standards",
-  "description": "Comprehensive TypeScript coding standards and best practices",
+  "description": "Comprehensive TypeScript coding standards and best practices including modern features, tooling, testing, architecture, and security",
   "type": "coding-standards",
   "language": "typescript",
   "author": "Augment Extensions",
   "license": "MIT",
-  "keywords": ["typescript", "coding-standards", "best-practices", "type-safety"],
+  "keywords": [
+    "typescript",
+    "coding-standards",
+    "best-practices",
+    "type-safety",
+    "modern-typescript",
+    "tooling",
+    "testing",
+    "architecture",
+    "security",
+    "monorepo"
+  ],
   "dependencies": {},
   "files": [
     "rules/naming-conventions.md",
-    "rules/type-safety.md",
+    "rules/type-patterns.md",
+    "rules/modern-features.md",
     "rules/error-handling.md",
-    "rules/async-patterns.md",
-    "examples/best-practices.ts"
+    "rules/tooling.md",
+    "rules/security-performance.md",
+    "rules/testing.md",
+    "rules/architecture.md",
+    "rules/monorepo.md",
+    "examples/eslint-flat-config.js",
+    "examples/biome.json",
+    "examples/vitest-setup.ts"
   ],
   "augment": {
     "minVersion": "1.0.0",
-    "characterCount": 6416,
+    "characterCount": 25000,
     "priority": "high",
     "category": "coding-standards",
     "autoLoad": false