Copilot instructions

1---
2applyTo: "**/*.ts,**/*.tsx"
3---
4 
5# TypeScript/JavaScript Coding Style
6 
7> This file extends [common/coding-style.md](../common/coding-style.md) with TypeScript/JavaScript specific content.
8 
9## Immutability
10 
11Use spread operator for immutable updates:
12 
13```typescript
14// WRONG: Mutation
15function updateUser(user, name) {
16  user.name = name  // MUTATION!
17  return user
18}
19 
20// CORRECT: Immutability
21function updateUser(user, name) {
22  return {
23    ...user,
24    name
25  }
26}
27```
28 
29## Error Handling
30 
31Use async/await with try-catch:
32 
33```typescript
34try {
35  const result = await riskyOperation()
36  return result
37} catch (error) {
38  console.error('Operation failed:', error)
39  throw new Error('Detailed user-friendly message')
40}
41```
42 
43## Input Validation
44 
45Use Zod for schema-based validation:
46 
47```typescript
48import { z } from 'zod'
49 
50const schema = z.object({
51  email: z.string().email(),
52  age: z.number().int().min(0).max(150)
53})
54 
55const validated = schema.parse(input)
56```
57 
58## Console.log
59 
60- No `console.log` statements in production code
61- Use proper logging libraries instead
62- See hooks for automatic detection
63 
64 
65# TypeScript/JavaScript Patterns
66 
67> This file extends [common/patterns.md](../common/patterns.md) with TypeScript/JavaScript specific content.
68 
69## API Response Format
70 
71```typescript
72interface ApiResponse<T> {
73  success: boolean
74  data?: T
75  error?: string
76  meta?: {
77    total: number
78    page: number
79    limit: number
80  }
81}
82```
83 
84## Custom Hooks Pattern
85 
86```typescript
87export function useDebounce<T>(value: T, delay: number): T {
88  const [debouncedValue, setDebouncedValue] = useState<T>(value)
89 
90  useEffect(() => {
91    const handler = setTimeout(() => setDebouncedValue(value), delay)
92    return () => clearTimeout(handler)
93  }, [value, delay])
94 
95  return debouncedValue
96}
97```
98 
99## Repository Pattern
100 
101```typescript
102interface Repository<T> {
103  findAll(filters?: Filters): Promise<T[]>
104  findById(id: string): Promise<T | null>
105  create(data: CreateDto): Promise<T>
106  update(id: string, data: UpdateDto): Promise<T>
107  delete(id: string): Promise<void>
108}
109```
110 
111 
112# TypeScript/JavaScript Security
113 
114> This file extends [common/security.md](../common/security.md) with TypeScript/JavaScript specific content.
115 
116## Secret Management
117 
118```typescript
119// NEVER: Hardcoded secrets
120const apiKey = "sk-proj-xxxxx"
121 
122// ALWAYS: Environment variables
123const apiKey = process.env.OPENAI_API_KEY
124 
125if (!apiKey) {
126  throw new Error('OPENAI_API_KEY not configured')
127}
128```
129 
130## Agent Support
131 
132- Use **security-reviewer** skill for comprehensive security audits
133 
134 
135# TypeScript/JavaScript Testing
136 
137> This file extends [common/testing.md](../common/testing.md) with TypeScript/JavaScript specific content.
138 
139## E2E Testing
140 
141Use **Playwright** as the E2E testing framework for critical user flows.
142 
143## Agent Support
144 
145- **e2e-runner** - Playwright E2E testing specialist