@bernierllc/email 1.0.1 → 1.1.0

package/packages/react/src/index.ts

@@ -1,20 +0,0 @@
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-
-/**
- * Email Template Manager - React Components
- * React components for email template management
- */
-
-// Re-export core types and classes
-export * from '@email-template-manager/core';
-
-// TODO: Add React components when implemented
-// export { EmailTemplateProvider } from './components/EmailTemplateProvider';
-// export { EmailTemplateEditor } from './components/EmailTemplateEditor';
-// export { useEmailTemplates } from './hooks/useEmailTemplates'; 

package/packages/react/tsconfig.json

@@ -1,24 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "lib": ["ES2020", "DOM", "DOM.Iterable"],
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "moduleResolution": "node",
-    "allowSyntheticDefaultImports": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": false,
-    "jsx": "react-jsx"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
-} 

package/plans/email-template-manager_app-admin.md

@@ -1,590 +0,0 @@
-# Email Template Manager - App-Admin Integration Plan
-
-## Overview
-
-Update the existing email-template-manager tool to be fully pluggable with the app-admin system. This will allow the email template manager to register itself with app-admin, provide admin UI pages, and integrate seamlessly with the centralized user management and RBAC system.
-
-## Current State Analysis
-
-### What We Have:
-- **Email Template Manager**: Existing tool with template management functionality
-- **Template System**: Template creation, editing, and management
-- **Email Sending**: Integration with email providers
-- **Basic UI**: Template management interface
-
-### What's Missing:
-- **App-Admin Integration**: No registration with admin system
-- **RBAC Integration**: No permission-based access control
-- **Admin UI Pages**: No admin panel integration
-- **User Management**: No integration with centralized user system
-- **Configuration Management**: No admin-configurable settings
-
-## Integration Requirements
-
-### 1. App-Admin Registration
-```typescript
-// Register with app-admin system
-const emailTemplateManagerRegistration = {
-  id: 'email-template-manager',
-  name: 'Email Template Manager',
-  version: '2.0.0',
-  description: 'Manage email templates and send emails',
-  icon: 'Mail',
-  permissions: [
-    'email-templates:read',
-    'email-templates:write',
-    'email-templates:delete',
-    'email-templates:send',
-    'email-templates:admin'
-  ],
-  pages: [
-    {
-      path: '/admin/email-templates',
-      title: 'Email Templates',
-      component: 'EmailTemplatesPage',
-      permissions: ['email-templates:read']
-    },
-    {
-      path: '/admin/email-templates/new',
-      title: 'Create Template',
-      component: 'CreateTemplatePage',
-      permissions: ['email-templates:write']
-    },
-    {
-      path: '/admin/email-templates/[id]',
-      title: 'Edit Template',
-      component: 'EditTemplatePage',
-      permissions: ['email-templates:write']
-    },
-    {
-      path: '/admin/email-settings',
-      title: 'Email Settings',
-      component: 'EmailSettingsPage',
-      permissions: ['email-templates:admin']
-    }
-  ],
-  hooks: [
-    'useEmailTemplates',
-    'useEmailSending',
-    'useEmailSettings'
-  ],
-  config: {
-    defaultProvider: 'sendgrid',
-    allowedProviders: ['sendgrid', 'mailgun', 'ses'],
-    templateCategories: ['welcome', 'notification', 'marketing'],
-    maxTemplatesPerUser: 50
-  }
-};
-```
-
-### 2. RBAC Permission System
-```typescript
-// Define permissions for email template manager
-const emailTemplatePermissions = [
-  {
-    id: 'email-templates:read',
-    name: 'Read Email Templates',
-    description: 'View email templates',
-    resource: 'email-templates',
-    action: 'read'
-  },
-  {
-    id: 'email-templates:write',
-    name: 'Write Email Templates',
-    description: 'Create and edit email templates',
-    resource: 'email-templates',
-    action: 'write'
-  },
-  {
-    id: 'email-templates:delete',
-    name: 'Delete Email Templates',
-    description: 'Delete email templates',
-    resource: 'email-templates',
-    action: 'delete'
-  },
-  {
-    id: 'email-templates:send',
-    name: 'Send Emails',
-    description: 'Send emails using templates',
-    resource: 'email-templates',
-    action: 'send'
-  },
-  {
-    id: 'email-templates:admin',
-    name: 'Email Template Administration',
-    description: 'Manage email settings and configurations',
-    resource: 'email-templates',
-    action: 'admin'
-  }
-];
-```
-
-### 3. Admin UI Integration
-```typescript
-// Admin pages for email template manager
-interface EmailTemplateAdminPages {
-  templates: {
-    path: '/admin/email-templates';
-    component: EmailTemplatesListPage;
-    permissions: ['email-templates:read'];
-  };
-  create: {
-    path: '/admin/email-templates/new';
-    component: CreateTemplatePage;
-    permissions: ['email-templates:write'];
-  };
-  edit: {
-    path: '/admin/email-templates/[id]';
-    component: EditTemplatePage;
-    permissions: ['email-templates:write'];
-  };
-  settings: {
-    path: '/admin/email-settings';
-    component: EmailSettingsPage;
-    permissions: ['email-templates:admin'];
-  };
-  analytics: {
-    path: '/admin/email-analytics';
-    component: EmailAnalyticsPage;
-    permissions: ['email-templates:read'];
-  };
-}
-```
-
-## Implementation Plan
-
-### Phase 1: App-Admin Integration (Week 1)
-
-#### 1.1 Registration System
-- [ ] Create app-admin registration module
-- [ ] Implement utility registration API
-- [ ] Add permission definitions
-- [ ] Create admin page registrations
-- [ ] Set up configuration management
-
-#### 1.2 Permission Integration
-- [ ] Integrate with app-admin RBAC system
-- [ ] Add permission checking middleware
-- [ ] Implement role-based template access
-- [ ] Create user-specific template filtering
-- [ ] Add group-based permissions
-
-#### 1.3 Configuration Management
-- [ ] Create admin-configurable settings
-- [ ] Implement provider configuration
-- [ ] Add template category management
-- [ ] Create user limit configurations
-- [ ] Set up audit logging
-
-### Phase 2: Admin UI Development (Week 2)
-
-#### 2.1 Template Management UI
-- [ ] Create admin template list page
-- [ ] Implement template creation form
-- [ ] Add template editing interface
-- [ ] Create template preview functionality
-- [ ] Add bulk template operations
-
-#### 2.2 Settings Management UI
-- [ ] Create email provider settings
-- [ ] Implement template category management
-- [ ] Add user permission management
-- [ ] Create system configuration interface
-- [ ] Add audit log viewer
-
-#### 2.3 Analytics Dashboard
-- [ ] Create email analytics page
-- [ ] Implement sending statistics
-- [ ] Add template usage metrics
-- [ ] Create delivery rate tracking
-- [ ] Add performance monitoring
-
-### Phase 3: API Enhancement (Week 3)
-
-#### 3.1 User-Aware APIs
-- [ ] Update template APIs for user context
-- [ ] Add permission-based filtering
-- [ ] Implement user-specific templates
-- [ ] Add group-based template access
-- [ ] Create audit trail APIs
-
-#### 3.2 Admin APIs
-- [ ] Create admin-specific endpoints
-- [ ] Add bulk template operations
-- [ ] Implement system configuration APIs
-- [ ] Create analytics data endpoints
-- [ ] Add user management APIs
-
-#### 3.3 Integration APIs
-- [ ] Create app-admin integration endpoints
-- [ ] Add utility registration APIs
-- [ ] Implement configuration sync
-- [ ] Create permission sync APIs
-- [ ] Add webhook endpoints
-
-### Phase 4: Hook System (Week 4)
-
-#### 4.1 React Hooks
-- [ ] Create useEmailTemplates hook
-- [ ] Implement useEmailSending hook
-- [ ] Add useEmailSettings hook
-- [ ] Create useEmailAnalytics hook
-- [ ] Add useEmailPermissions hook
-
-#### 4.2 Integration Hooks
-- [ ] Create app-admin integration hooks
-- [ ] Add permission checking hooks
-- [ ] Implement user context hooks
-- [ ] Create configuration hooks
-- [ ] Add audit logging hooks
-
-### Phase 5: Documentation and Testing (Week 5)
-
-#### 5.1 Documentation
-- [ ] Update installation guide
-- [ ] Create app-admin integration guide
-- [ ] Document new APIs and hooks
-- [ ] Create configuration guide
-- [ ] Add troubleshooting guide
-
-#### 5.2 Testing
-- [ ] Add integration tests for app-admin
-- [ ] Create permission testing
-- [ ] Add admin UI tests
-- [ ] Implement configuration tests
-- [ ] Create end-to-end tests
-
-## Technical Implementation
-
-### 1. App-Admin Registration Module
-```typescript
-// src/integrations/app-admin.ts
-import { registerUtility } from '@app-admin/core';
-
-export class AppAdminIntegration {
-  static async register() {
-    await registerUtility({
-      id: 'email-template-manager',
-      name: 'Email Template Manager',
-      version: '2.0.0',
-      description: 'Manage email templates and send emails',
-      icon: 'Mail',
-      permissions: emailTemplatePermissions,
-      pages: emailTemplateAdminPages,
-      hooks: emailTemplateHooks,
-      config: emailTemplateConfig
-    });
-  }
-
-  static async unregister() {
-    // Cleanup registration
-  }
-}
-```
-
-### 2. Enhanced Template Management
-```typescript
-// src/services/template-service.ts
-export class TemplateService {
-  constructor(private userContext: UserContext) {}
-
-  async getTemplates(filters?: TemplateFilters): Promise<Template[]> {
-    // Apply user permissions
-    const userPermissions = await this.userContext.getPermissions();
-    
-    if (!userPermissions.includes('email-templates:read')) {
-      throw new Error('Insufficient permissions');
-    }
-
-    // Filter by user access
-    const templates = await this.templateRepository.findByUser(
-      this.userContext.userId,
-      filters
-    );
-
-    return templates;
-  }
-
-  async createTemplate(template: CreateTemplateRequest): Promise<Template> {
-    // Check permissions
-    if (!this.userContext.hasPermission('email-templates:write')) {
-      throw new Error('Insufficient permissions');
-    }
-
-    // Create template with user context
-    const newTemplate = await this.templateRepository.create({
-      ...template,
-      createdBy: this.userContext.userId,
-      organizationId: this.userContext.organizationId
-    });
-
-    // Audit log
-    await this.auditService.log({
-      action: 'template_created',
-      userId: this.userContext.userId,
-      resourceId: newTemplate.id,
-      details: template
-    });
-
-    return newTemplate;
-  }
-}
-```
-
-### 3. Admin UI Components
-```typescript
-// src/components/admin/EmailTemplatesListPage.tsx
-export function EmailTemplatesListPage() {
-  const { hasPermission } = useAdmin();
-  const { templates, loading, error } = useEmailTemplates();
-  const { user } = useAuth();
-
-  if (!hasPermission('email-templates:read')) {
-    return <AccessDenied />;
-  }
-
-  return (
-    <div className="space-y-6">
-      <div className="flex justify-between items-center">
-        <h1 className="text-2xl font-bold">Email Templates</h1>
-        {hasPermission('email-templates:write') && (
-          <Button asChild>
-            <Link href="/admin/email-templates/new">Create Template</Link>
-          </Button>
-        )}
-      </div>
-      
-      <TemplatesList 
-        templates={templates}
-        loading={loading}
-        error={error}
-        canEdit={hasPermission('email-templates:write')}
-        canDelete={hasPermission('email-templates:delete')}
-      />
-    </div>
-  );
-}
-```
-
-### 4. Configuration Management
-```typescript
-// src/config/admin-config.ts
-export interface EmailTemplateAdminConfig {
-  providers: {
-    sendgrid: SendGridConfig;
-    mailgun: MailgunConfig;
-    ses: SESConfig;
-  };
-  templates: {
-    maxPerUser: number;
-    allowedCategories: string[];
-    defaultCategory: string;
-  };
-  permissions: {
-    defaultRole: string;
-    adminRoles: string[];
-  };
-  features: {
-    analytics: boolean;
-    auditLogging: boolean;
-    bulkOperations: boolean;
-  };
-}
-
-export class AdminConfigManager {
-  static async getConfig(): Promise<EmailTemplateAdminConfig> {
-    // Get from app-admin configuration
-    const config = await getAdminConfig('email-template-manager');
-    return config;
-  }
-
-  static async updateConfig(config: Partial<EmailTemplateAdminConfig>) {
-    // Update app-admin configuration
-    await updateAdminConfig('email-template-manager', config);
-  }
-}
-```
-
-## Database Schema Updates
-
-### 1. User Context Tables
-```sql
--- Add user context to templates
-ALTER TABLE email_templates 
-ADD COLUMN created_by UUID REFERENCES users(id),
-ADD COLUMN organization_id UUID REFERENCES organizations(id),
-ADD COLUMN is_public BOOLEAN DEFAULT false;
-
--- Add permissions table
-CREATE TABLE email_template_permissions (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  user_id UUID REFERENCES users(id),
-  template_id UUID REFERENCES email_templates(id),
-  permission TEXT NOT NULL,
-  granted_by UUID REFERENCES users(id),
-  granted_at TIMESTAMP DEFAULT NOW(),
-  UNIQUE(user_id, template_id, permission)
-);
-
--- Add audit log table
-CREATE TABLE email_template_audit_log (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  user_id UUID REFERENCES users(id),
-  action TEXT NOT NULL,
-  resource_type TEXT NOT NULL,
-  resource_id UUID,
-  details JSONB,
-  created_at TIMESTAMP DEFAULT NOW()
-);
-```
-
-### 2. Configuration Tables
-```sql
--- Add configuration table
-CREATE TABLE email_template_config (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  organization_id UUID REFERENCES organizations(id),
-  config_key TEXT NOT NULL,
-  config_value JSONB,
-  created_at TIMESTAMP DEFAULT NOW(),
-  updated_at TIMESTAMP DEFAULT NOW(),
-  UNIQUE(organization_id, config_key)
-);
-
--- Add analytics table
-CREATE TABLE email_template_analytics (
-  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  template_id UUID REFERENCES email_templates(id),
-  sent_count INTEGER DEFAULT 0,
-  delivered_count INTEGER DEFAULT 0,
-  opened_count INTEGER DEFAULT 0,
-  clicked_count INTEGER DEFAULT 0,
-  last_sent_at TIMESTAMP,
-  created_at TIMESTAMP DEFAULT NOW(),
-  updated_at TIMESTAMP DEFAULT NOW()
-);
-```
-
-## Integration Examples
-
-### 1. Basic Integration
-```typescript
-// In your Next.js app
-import { EmailTemplateManager } from '@email-template-manager/core';
-import { AppAdminIntegration } from '@email-template-manager/integrations';
-
-// Initialize with app-admin integration
-const emailManager = new EmailTemplateManager({
-  provider: 'sendgrid',
-  apiKey: process.env.SENDGRID_API_KEY,
-  integrations: {
-    appAdmin: {
-      enabled: true,
-      config: {
-        defaultRole: 'email-manager',
-        adminRoles: ['admin', 'email-admin']
-      }
-    }
-  }
-});
-
-// Register with app-admin
-await AppAdminIntegration.register();
-```
-
-### 2. Using Admin UI
-```typescript
-// In your admin layout
-import { AdminNavigation } from '@app-admin/ui';
-
-const adminPages = [
-  // ... other admin pages
-  {
-    title: 'Email Templates',
-    href: '/admin/email-templates',
-    icon: 'Mail',
-    permission: 'email-templates:read'
-  }
-];
-
-export default function AdminLayout({ children }) {
-  return (
-    <div>
-      <AdminNavigation pages={adminPages} />
-      {children}
-    </div>
-  );
-}
-```
-
-### 3. Using Hooks
-```typescript
-// In your components
-import { useEmailTemplates, useEmailSending } from '@email-template-manager/hooks';
-
-export function EmailDashboard() {
-  const { templates, loading } = useEmailTemplates();
-  const { sendEmail } = useEmailSending();
-
-  const handleSendEmail = async (templateId: string, data: any) => {
-    await sendEmail(templateId, data);
-  };
-
-  return (
-    <div>
-      {templates.map(template => (
-        <TemplateCard 
-          key={template.id} 
-          template={template}
-          onSend={handleSendEmail}
-        />
-      ))}
-    </div>
-  );
-}
-```
-
-## Success Criteria
-
-### Functional Requirements
-- [ ] Complete app-admin registration
-- [ ] Full RBAC integration
-- [ ] Admin UI pages working
-- [ ] User-specific template access
-- [ ] Configuration management
-- [ ] Audit logging system
-- [ ] Analytics integration
-
-### Technical Requirements
-- [ ] TypeScript support throughout
-- [ ] Permission-based access control
-- [ ] User context integration
-- [ ] Configuration management
-- [ ] Audit trail implementation
-- [ ] Performance optimization
-
-### Integration Requirements
-- [ ] Seamless app-admin integration
-- [ ] Working admin UI pages
-- [ ] Proper permission checking
-- [ ] Configuration synchronization
-- [ ] Hook system working
-- [ ] Documentation complete
-
-## Future Enhancements
-
-### Advanced Features
-- [ ] Multi-tenant support
-- [ ] Advanced analytics
-- [ ] Template versioning
-- [ ] A/B testing
-- [ ] Advanced scheduling
-- [ ] Template marketplace
-
-### Integration Features
-- [ ] More email providers
-- [ ] CRM integrations
-- [ ] Marketing automation
-- [ ] Webhook system
-- [ ] API rate limiting
-- [ ] Real-time notifications 

package/src/index.js

@@ -1 +0,0 @@
-// Entry point for @bernierllc/email package