@agility/management-sdk 0.1.36 → 0.1.38

package/.cursor/manifest.md

@@ -1,243 +0,0 @@
-# Agility CMS Management SDK - Authentication Component
-
-## Overview
-Transform the current authentication UI into a reusable, highly configurable React component that can be embedded in any application. The component should support multiple display modes and extensive customization options.
-
-## Feature Requirements
-
-### Core Functionality
-- **Authentication Flow**: OAuth popup-based authentication with token persistence
-- **Display Modes**: 
-  - Full-screen overlay mode
-  - Compact footer bar mode
-  - Button-only mode
-- **Callback System**: Extensive hooks for user interaction
-- **Styling**: Fully customizable appearance
-- **State Management**: Clean separation of UI and business logic
-
-### Configuration Interface
-```typescript
-interface AgilityAuthConfig {
-  // Callbacks
-  onSignIn?: (user: ServerUser) => void;
-  onSignOut?: () => void;
-  onButtonClick?: () => void;
-  onWebsiteSelect?: (website: WebsiteAccess) => void;
-  onLocaleSelect?: (locale: LocaleInfo) => void;
-  
-  // Appearance
-  title?: string;
-  titleClasses?: string;
-  backgroundClasses?: string;
-  buttonClass?: string;
-  buttonText?: string;
-  
-  // Behavior
-  showCurrentSelection?: boolean;
-  mode?: 'fullscreen' | 'footer' | 'button-only';
-  
-  // OAuth Settings
-  redirectUri?: string;
-  scope?: string;
-  region?: string;
-}
-```
-
-## Architecture Plan
-
-### Phase 1: Foundation & Models (Parallel)
-**Duration**: 1-2 days
-**Dependencies**: None
-
-#### Task 1.1: Type Definitions
-- Create comprehensive TypeScript interfaces
-- Define component props and configuration types
-- Export all types from main SDK index
-
-**Files to Create:**
-- `src/models/authComponent.ts` - Main component interfaces
-- `src/models/authConfig.ts` - Configuration types
-- `src/models/authState.ts` - State management types
-
-#### Task 1.2: Core Component Structure
-- Set up base component directory structure
-- Create component export system
-- Establish styling approach (CSS modules vs styled-components)
-
-**Files to Create:**
-- `src/components/auth/index.ts` - Main export
-- `src/components/auth/AgilityAuth.tsx` - Root component
-- `src/components/auth/styles/` - Styling directory
-
-### Phase 2: Authentication Logic (Parallel with Phase 1.2)
-**Duration**: 1-2 days
-**Dependencies**: Phase 1.1 (Type Definitions)
-
-#### Task 2.1: Auth Hook
-- Extract authentication logic into custom hook
-- Manage authentication state
-- Handle OAuth flow and token management
-
-**Files to Create:**
-- `src/components/auth/hooks/useAgilityAuth.ts`
-- `src/components/auth/hooks/useWebsiteSelection.ts`
-
-#### Task 2.2: State Management
-- Create context for sharing auth state
-- Implement reducer for complex state updates
-- Handle loading states and errors
-
-**Files to Create:**
-- `src/components/auth/context/AuthContext.tsx`
-- `src/components/auth/context/AuthProvider.tsx`
-
-### Phase 3: UI Components (Depends on Phase 1 & 2)
-**Duration**: 2-3 days
-**Dependencies**: Phase 1.2, Phase 2.1
-
-#### Task 3.1: Core UI Components
-- Authentication button component
-- User info display component
-- Website/locale selection dropdowns
-- Loading and error states
-
-**Files to Create:**
-- `src/components/auth/components/AuthButton.tsx`
-- `src/components/auth/components/UserInfo.tsx`
-- `src/components/auth/components/WebsiteSelector.tsx`
-- `src/components/auth/components/LocaleSelector.tsx`
-- `src/components/auth/components/LoadingSpinner.tsx`
-- `src/components/auth/components/ErrorDisplay.tsx`
-
-#### Task 3.2: Layout Components
-- Full-screen modal layout
-- Footer bar layout
-- Button-only layout
-- Selection summary component
-
-**Files to Create:**
-- `src/components/auth/layouts/FullscreenLayout.tsx`
-- `src/components/auth/layouts/FooterLayout.tsx`
-- `src/components/auth/layouts/ButtonLayout.tsx`
-- `src/components/auth/components/SelectionSummary.tsx`
-
-### Phase 4: Styling & Theming (Parallel with Phase 3)
-**Duration**: 1-2 days
-**Dependencies**: Phase 1.2
-
-#### Task 4.1: Base Styles
-- Create CSS module system
-- Define CSS custom properties for theming
-- Responsive design implementation
-
-**Files to Create:**
-- `src/components/auth/styles/base.module.css`
-- `src/components/auth/styles/themes.module.css`
-- `src/components/auth/styles/layouts.module.css`
-- `src/components/auth/styles/components.module.css`
-
-#### Task 4.2: Animation System
-- Framer Motion integration
-- Smooth transitions between modes
-- Loading animations
-
-**Files to Create:**
-- `src/components/auth/animations/transitions.ts`
-- `src/components/auth/animations/variants.ts`
-
-### Phase 5: Integration & Testing (Depends on Phases 3 & 4)
-**Duration**: 1-2 days
-**Dependencies**: Phase 3.1, Phase 3.2, Phase 4.1
-
-#### Task 5.1: Component Integration
-- Integrate all components into main AgilityAuth component
-- Implement mode switching logic
-- Handle configuration prop passing
-
-#### Task 5.2: SDK Integration
-- Export component from main SDK
-- Update package.json with React peer dependencies
-- Create usage documentation
-
-**Files to Create:**
-- `src/components/auth/AgilityAuth.tsx` (complete implementation)
-- `docs/auth-component.md`
-
-### Phase 6: Advanced Features (Optional)
-**Duration**: 1-2 days
-**Dependencies**: Phase 5
-
-#### Task 6.1: Advanced Customization
-- Custom render props support
-- Slot-based customization
-- Advanced theming system
-
-#### Task 6.2: Accessibility & Performance
-- ARIA labels and keyboard navigation
-- Performance optimizations
-- Bundle size optimization
-
-## File Structure
-```
-src/
-├── components/
-│   └── auth/
-│       ├── index.ts                          # Main export
-│       ├── AgilityAuth.tsx                   # Root component (~100 lines)
-│       ├── components/
-│       │   ├── AuthButton.tsx                # ~80 lines
-│       │   ├── UserInfo.tsx                  # ~60 lines
-│       │   ├── WebsiteSelector.tsx           # ~90 lines
-│       │   ├── LocaleSelector.tsx            # ~80 lines
-│       │   ├── LoadingSpinner.tsx            # ~40 lines
-│       │   ├── ErrorDisplay.tsx              # ~50 lines
-│       │   └── SelectionSummary.tsx          # ~70 lines
-│       ├── layouts/
-│       │   ├── FullscreenLayout.tsx          # ~90 lines
-│       │   ├── FooterLayout.tsx              # ~80 lines
-│       │   └── ButtonLayout.tsx              # ~40 lines
-│       ├── hooks/
-│       │   ├── useAgilityAuth.ts             # ~100 lines
-│       │   └── useWebsiteSelection.ts        # ~80 lines
-│       ├── context/
-│       │   ├── AuthContext.tsx               # ~60 lines
-│       │   └── AuthProvider.tsx              # ~90 lines
-│       ├── styles/
-│       │   ├── base.module.css
-│       │   ├── themes.module.css
-│       │   ├── layouts.module.css
-│       │   └── components.module.css
-│       └── animations/
-│           ├── transitions.ts                # ~50 lines
-│           └── variants.ts                   # ~40 lines
-├── models/
-│   ├── authComponent.ts                      # Component interfaces
-│   ├── authConfig.ts                         # Configuration types
-│   └── authState.ts                          # State types
-```
-
-## Dependencies
-- React 16.8+ (hooks support)
-- Framer Motion (animations)
-- Existing SDK authentication methods
-
-## Success Criteria
-1. **Modularity**: Each component < 100 lines, single responsibility
-2. **Configurability**: Extensive customization without code changes
-3. **Performance**: Fast loading, minimal bundle impact
-4. **Accessibility**: WCAG 2.1 AA compliance
-5. **Developer Experience**: Intuitive API, comprehensive TypeScript support
-6. **Visual Polish**: Smooth animations, responsive design
-
-## Migration Path
-1. Existing apps can gradually adopt the component
-2. Backward compatibility with existing auth methods
-3. Progressive enhancement approach
-4. Clear migration documentation
-
-## Next Steps
-1. Start with Phase 1 (Foundation & Models)
-2. Create type definitions and basic structure
-3. Implement authentication hook (Phase 2.1)
-4. Build core UI components (Phase 3.1)
-5. Iterate and refine based on feedback

package/.cursor/mocks.md

@@ -1,100 +0,0 @@
-# Mock Test Suite Progress Tracker
-
-## 🎯 Goal: Complete Unit Test Coverage for All SDK Components
-
-### ✅ **COMPLETED (100% Passing)**
-- **ModelMethods** (16/16 tests) ✅
-- **AssetMethods** (24/24 tests) ✅
-- **ContainerMethods** (16/16 tests) ✅
-- **WebhookMethods** (14/14 tests) ✅
-
-### 🎉 **MISSION ACCOMPLISHED: 103/103 TOTAL TESTS PASSING (100%)**
-
-**📊 Complete Test Coverage:**
-- **Unit Tests**: 70/70 passing (4 suites)
-- **Integration Tests**: 33/33 passing (5 suites)
-- **Total**: 103/103 passing (9 suites)
-
-### 📋 **PENDING**
-- **ContentMethods** - Complex (requires locale params, method signature fixes)
-- **PageMethods** - Complex (requires locale params, missing methods)
-- **BatchMethods** - Simple (should be quick)
-
-### 📝 **ANALYSIS & FIXES NEEDED**
-
-#### WebhookMethods (Currently Working)
-- ✅ Apply mockedAxiosInstance pattern
-- ⏳ Fix method signatures and URL patterns
-- ⏳ Test and validate
-
-#### ContentMethods (Major Rework Needed)
-**Issues Found:**
-- ❌ Missing `locale` parameter in most method calls
-- ❌ Methods like `deleteContentItem` don't exist (should be `deleteContent`)
-- ❌ Wrong method signatures: `publishContentItem` → `publishContent`
-- ❌ Error message mismatches
-- ❌ Complex batch operations with async polling
-
-**Required Fixes:**
-- [ ] Update all method calls to include `locale` parameter
-- [ ] Fix method names to match actual SDK
-- [ ] Update error message expectations
-- [ ] Mock batch operations properly
-
-#### PageMethods (Major Rework Needed)
-**Issues Found:**
-- ❌ Missing `locale` parameter in most method calls
-- ❌ Method `getPageList` doesn't exist
-- ❌ URL patterns include `undefined/` prefix (missing locale)
-- ❌ Methods like `unpublishPage`, `requestApprovalPage` don't exist
-- ❌ Error message format mismatches
-
-**Required Fixes:**
-- [ ] Add `locale` parameter to all method calls
-- [ ] Remove non-existent methods from tests
-- [ ] Fix URL pattern expectations
-- [ ] Update error message expectations
-
-#### BatchMethods (Should Be Simple)
-**Expected Issues:**
-- ⚠️ Likely just needs axios mock pattern applied
-- ⚠️ Possible method signature fixes
-
-### 🛠️ **PROVEN PATTERN (Use for All)**
-
-```typescript
-// Mock axios.create to return our controlled instance
-const mockedAxiosInstance = {
-	get: jest.fn(),
-	post: jest.fn(),
-	put: jest.fn(),
-	delete: jest.fn(),
-	defaults: { headers: { common: {} } }
-};
-
-jest.mock('axios', () => ({
-	create: jest.fn(() => mockedAxiosInstance)
-}));
-
-beforeEach(() => {
-	jest.clearAllMocks();
-	mockedAxiosInstance.get.mockClear();
-	mockedAxiosInstance.post.mockClear();
-	mockedAxiosInstance.put.mockClear();
-	mockedAxiosInstance.delete.mockClear();
-});
-```
-
-### 📊 **CURRENT STATUS**
-- **Working Tests**: 3 components (56 tests passing)
-- **Target**: 6-7 components (estimated 100+ tests)
-- **Next Goal**: Get WebhookMethods to 100% → BatchMethods → ContentMethods → PageMethods
-
-### 🎯 **IMMEDIATE TASKS**
-1. ✅ Finish WebhookMethods (in progress)
-2. 📋 Apply pattern to BatchMethods
-3. 📋 Tackle ContentMethods method signature issues
-4. 📋 Tackle PageMethods method signature issues
-
----
-*Last Updated: Working on WebhookMethods*