@elevasis/core 0.8.0 → 0.8.3

package/src/test-utils/README.md

@@ -1,150 +1,42 @@
-# Test Utilities
-
-Shared test utilities for Elevasis monorepo testing. Provides fixtures, mocks, and test helpers following DRY principles.
-
-## Structure
-
-```
-test-utils/
-├── fixtures/           # Test data using real Supabase types
-│   ├── users.ts       # User fixtures (SupabaseUserProfile)
-│   ├── organizations.ts
-│   ├── memberships.ts
-│   └── api-keys.ts
-├── mocks/             # Mock implementations
-│   ├── supabase.ts   # Supabase client mock
-│   └── workos.ts     # WorkOS JWT mock
-└── index.ts          # Re-exports all utilities
-```
-
-## Fixtures
-
-All fixtures use actual Supabase types from `@elevasis/core/supabase` for type safety.
-
-### User Fixtures
-
-```typescript
-import { TEST_USERS, createTestUser } from '@elevasis/core/test-utils'
-
-// Pre-defined users
-TEST_USERS.admin         // Platform admin user
-TEST_USERS.regularUser   // Regular user with membership
-TEST_USERS.inactiveUser  // Inactive user
-
-// Create custom user
-const customUser = createTestUser({
-  email: 'custom@example.com',
-  is_platform_admin: true
-})
-```
-
-### Organization Fixtures
-
-```typescript
-import { TEST_ORGS, createTestOrg } from '@elevasis/core/test-utils'
-
-TEST_ORGS.acme    // Acme Corp (active, test org)
-TEST_ORGS.beta    // Beta Inc (active, test org)
-TEST_ORGS.gamma   // Gamma LLC (active, test org)
-TEST_ORGS.inactive // Inactive Org
-```
-
-### Membership Fixtures
-
-```typescript
-import { TEST_MEMBERSHIPS, TEST_MEMBERSHIPS_WITH_ORG } from '@elevasis/core/test-utils'
-
-// Simple memberships
-TEST_MEMBERSHIPS.regularUserAcme  // regularUser admin in Acme
-TEST_MEMBERSHIPS.regularUserBeta  // regularUser member in Beta
-
-// Memberships with organization data (for joined queries)
-TEST_MEMBERSHIPS_WITH_ORG.regularUserAcme
-```
-
-### API Key Fixtures
-
-```typescript
-import { TEST_API_KEYS, TEST_API_KEY_PLAINTEXTS } from '@elevasis/core/test-utils'
-
-// API key records (with hashed keys)
-TEST_API_KEYS.acmeKey
-TEST_API_KEYS.betaKey
-
-// Plaintext keys for Authorization headers
-TEST_API_KEY_PLAINTEXTS.acmeKey  // 'sk_test_acme_12345'
-```
-
-## Mocks
-
-### Supabase Client Mock
-
-```typescript
-import { createMockSupabaseClient, TEST_USERS, TEST_ORGS } from '@elevasis/core/test-utils'
-import { vi } from 'vitest'
-
-// Create mock with test data
-const mockClient = createMockSupabaseClient({
-  users: [TEST_USERS.admin, TEST_USERS.regularUser],
-  organizations: [TEST_ORGS.acme, TEST_ORGS.beta]
-})
-
-// Use in tests
-vi.mock('../lib/supabase', () => ({ supabaseClient: mockClient }))
-
-// Query will work with mock data
-const { data } = await supabaseClient
-  .from('users')
-  .select('*')
-  .eq('email', 'admin@test.com')
-  .single()
-// data === TEST_USERS.admin
-```
-
-### WorkOS JWT Mock
-
-```typescript
-import { createMockVerifyJWT, mockExtractToken, TEST_USERS } from '@elevasis/core/test-utils'
-import { vi } from 'vitest'
-
-const mockVerifyJWT = createMockVerifyJWT({
-  'valid-token': {
-    workosId: TEST_USERS.admin.workos_user_id,
-    supabaseId: TEST_USERS.admin.id,
-    email: TEST_USERS.admin.email
-  }
-})
-
-vi.mock('../identity/auth/jwt-verifier', () => ({
-  verifyJWT: mockVerifyJWT,
-  extractToken: mockExtractToken
-}))
-
-// JWT verification will return mock user
-const user = await verifyJWT('valid-token')
-// user.email === 'admin@test.com'
-```
-
-## Usage in Apps
-
-Apps can import test utilities directly:
-
-```typescript
-// In apps/api/src/test-utils/index.ts
-export * from '@elevasis/core/test-utils'  // Re-export shared utilities
-export * from './fastify-test'         // Add app-specific utilities
-```
-
-## Type Safety
-
-All fixtures use actual Supabase types:
-- Changes to database schema automatically update test types
-- TypeScript compiler validates test data structure
-- Single source of truth for types
-
-## Design Principles
-
-- **DRY:** Shared fixtures in `@elevasis/core`, imported by apps
-- **Type Safety:** Use `SupabaseUserProfile`, `SupabaseOrganization`, etc.
-- **Realistic Data:** Fixtures match production schema and patterns
-- **Composable:** Combine fixtures, mocks, and helpers as needed
+# Test Utilities
+
+Published test helpers for downstream consumers of `@elevasis/core`.
+
+The public `@elevasis/core/test-utils` subpath is intentionally narrow. It exposes:
+
+- `RLSTestContext` for dev-database RLS integration tests
+- `setupMatchMedia`, `setupResizeObserver`, and `setupBrowserMocks` for jsdom/browser test setup
+
+Internal monorepo fixtures and Vitest-specific mocks still exist under `packages/core/src/test-utils/`, but they are not part of the published package contract.
+
+## Published Usage
+
+### Browser Mocks
+
+```typescript
+import { setupBrowserMocks } from '@elevasis/core/test-utils'
+
+setupBrowserMocks()
+```
+
+### RLS Integration Tests
+
+```typescript
+import { RLSTestContext } from '@elevasis/core/test-utils'
+
+const ctx = new RLSTestContext()
+```
+
+`RLSTestContext` requires a configured Supabase development environment:
+
+- `SUPABASE_URL`
+- `SUPABASE_ANON_KEY`
+- `SUPABASE_SERVICE_KEY`
+- `SUPABASE_JWT_SECRET`
+
+## Internal Scope
+
+The following folders remain implementation detail for the monorepo and are not published:
+
+- `fixtures/`
+- `mocks/`

package/src/test-utils/index.ts

@@ -1,11 +1,10 @@
-// Fixtures
-export * from './fixtures'
-
-// Mocks
-export * from './mocks'
-
-// RLS Testing
-export * from './rls'
-
-// Browser Mocks (for React/UI testing)
-export * from './browser-mocks'
+// Published test utilities are intentionally narrow.
+// Internal fixtures and Vitest-heavy mocks stay private to the monorepo.
+export * from './rls'
+
+export * from './browser-mocks'
+
+// Monorepo-only compatibility surface for internal test helpers.
+// publishConfig.exports keeps these out of the public @elevasis/core package.
+export * from './fixtures'
+export * from './mocks'

package/src/test-utils/published.ts

@@ -0,0 +1,4 @@
+// Published test utilities are intentionally narrow.
+// Internal fixtures and Vitest-heavy mocks remain monorepo-only.
+export * from './rls'
+export * from './browser-mocks'

package/src/test-utils/rls/RLSTestContext.ts

@@ -19,9 +19,9 @@
  * ```
  */
 
-import { createClient, SupabaseClient } from '@supabase/supabase-js'
-import jwt from 'jsonwebtoken'
-import type { Database } from '@repo/core'
+import { createClient, SupabaseClient } from '@supabase/supabase-js'
+import jwt from 'jsonwebtoken'
+import type { Database } from '../../supabase/database.types'
 
 type Role = 'admin' | 'member'