@metigan/angular 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Metigan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,581 @@
+# Metigan Angular SDK
+
+Official Metigan SDK for Angular. Send emails, manage forms, contacts, and audiences with ease in your Angular applications.
+
+## 📦 Installation
+
+```bash
+npm install @metigan/angular
+# or
+yarn add @metigan/angular
+```
+
+## 🚀 Quick Start
+
+### 1. Import the Module
+
+In your `app.module.ts`:
+
+```typescript
+import { NgModule } from '@angular/core';
+import { MetiganModule } from '@metigan/angular';
+
+@NgModule({
+  imports: [
+    MetiganModule.forRoot({
+      apiKey: 'your-api-key'
+    })
+  ]
+})
+export class AppModule { }
+```
+
+### 2. Use in Components
+
+```typescript
+import { Component, OnInit } from '@angular/core';
+import { MetiganService } from '@metigan/angular';
+
+@Component({
+  selector: 'app-my-component',
+  template: '<button (click)="sendEmail()">Send Email</button>'
+})
+export class MyComponent implements OnInit {
+  constructor(private metigan: MetiganService) {}
+
+  sendEmail() {
+    this.metigan.email.sendEmail({
+      from: 'Your Company <noreply@yourcompany.com>',
+      recipients: ['customer@email.com'],
+      subject: 'Welcome!',
+      content: '<h1>Hello!</h1><p>Thank you for signing up.</p>'
+    }).subscribe({
+      next: (response) => {
+        console.log('Email sent:', response.message);
+        console.log('Emails remaining:', response.emailsRemaining);
+      },
+      error: (error) => {
+        console.error('Error sending email:', error);
+      }
+    });
+  }
+}
+```
+
+### Alternative: Manual Initialization
+
+If you prefer to initialize manually (useful for dynamic API keys):
+
+```typescript
+import { Component, OnInit } from '@angular/core';
+import { MetiganService } from '@metigan/angular';
+
+@Component({
+  selector: 'app-my-component',
+  template: ''
+})
+export class MyComponent implements OnInit {
+  constructor(private metigan: MetiganService) {}
+
+  ngOnInit() {
+    // Initialize with your API key
+    this.metigan.initialize({
+      apiKey: 'your-api-key',
+      timeout: 30000,
+      retryCount: 3
+    });
+  }
+}
+```
+
+## 📧 Email Module
+
+### Send Email
+
+```typescript
+this.metigan.email.sendEmail({
+  from: 'sender@example.com',
+  recipients: ['recipient@example.com'],
+  subject: 'Email Subject',
+  content: '<h1>HTML Content</h1>'
+}).subscribe({
+  next: (response) => console.log('Sent:', response),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Send Email with Attachments
+
+```typescript
+const fileInput = document.querySelector('input[type="file"]') as HTMLInputElement;
+const files = Array.from(fileInput.files || []);
+
+this.metigan.email.sendEmail({
+  from: 'company@email.com',
+  recipients: ['customer@email.com'],
+  subject: 'Important Document',
+  content: 'Please find the document attached.',
+  attachments: files
+}).subscribe({
+  next: (response) => console.log('Sent with attachments'),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Send Email with CC and BCC
+
+```typescript
+this.metigan.email.sendEmail({
+  from: 'company@email.com',
+  recipients: ['main@email.com'],
+  subject: 'Meeting',
+  content: 'Email content',
+  cc: ['copy@email.com'],
+  bcc: ['hidden-copy@email.com'],
+  replyTo: 'reply-here@email.com'
+}).subscribe({
+  next: (response) => console.log('Sent'),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Send Email with Template
+
+```typescript
+this.metigan.email.sendEmail({
+  from: 'sender@example.com',
+  recipients: ['recipient@example.com'],
+  subject: 'Welcome Email',
+  templateId: 'template-123'
+}).subscribe({
+  next: (response) => console.log('Sent'),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+## 📋 Forms Module
+
+### Submit Form
+
+```typescript
+this.metigan.forms.submit({
+  formId: 'form-123', // or form slug
+  data: {
+    'field-email': 'user@email.com',
+    'field-name': 'John Doe',
+    'field-message': 'Hello, I would like more information.'
+  }
+}).subscribe({
+  next: (response) => {
+    console.log(response.message); // "Thank you for your submission!"
+  },
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Get Public Form
+
+```typescript
+// By slug (for public display, no API key required)
+this.metigan.forms.getPublicForm('my-form').subscribe({
+  next: (form) => {
+    console.log(form.title);
+    console.log(form.fields);
+  },
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### List Forms
+
+```typescript
+this.metigan.forms.listForms({
+  page: 1,
+  limit: 10
+}).subscribe({
+  next: (response) => {
+    response.forms.forEach(form => {
+      console.log(`${form.title} - ${form.analytics?.submissions || 0} responses`);
+    });
+  },
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Create Form
+
+```typescript
+this.metigan.forms.createForm({
+  title: 'Contact Form',
+  description: 'Get in touch with us',
+  fields: [
+    {
+      id: 'field-email',
+      type: 'email',
+      label: 'Your Email',
+      required: true
+    },
+    {
+      id: 'field-name',
+      type: 'text',
+      label: 'Your Name',
+      required: true
+    },
+    {
+      id: 'field-message',
+      type: 'textarea',
+      label: 'Message',
+      required: true
+    }
+  ],
+  settings: {
+    successMessage: 'Thank you! We will get back to you soon.',
+    notifyEmail: 'contact@company.com'
+  }
+}).subscribe({
+  next: (form) => console.log('Form created:', form),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+## 👥 Contacts Module
+
+### Create Contact
+
+```typescript
+this.metigan.contacts.create({
+  email: 'new@email.com',
+  firstName: 'Jane',
+  lastName: 'Doe',
+  audienceId: 'audience-123',
+  tags: ['customer', 'newsletter']
+}).subscribe({
+  next: (contact) => console.log('Contact created:', contact),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Get Contact
+
+```typescript
+// By ID
+this.metigan.contacts.get('contact-456').subscribe({
+  next: (contact) => console.log('Contact:', contact),
+  error: (error) => console.error('Error:', error)
+});
+
+// By email
+this.metigan.contacts.getByEmail('jane@email.com', 'audience-123').subscribe({
+  next: (contact) => console.log('Contact:', contact),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Update Contact
+
+```typescript
+this.metigan.contacts.update('contact-456', {
+  firstName: 'Jane Marie',
+  tags: ['customer', 'vip']
+}).subscribe({
+  next: (updated) => console.log('Contact updated:', updated),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### List Contacts
+
+```typescript
+this.metigan.contacts.list({
+  audienceId: 'audience-123',
+  status: 'subscribed',
+  tag: 'customer',
+  page: 1,
+  limit: 50
+}).subscribe({
+  next: (response) => {
+    response.contacts.forEach(contact => {
+      console.log(`${contact.email}: ${contact.firstName}`);
+    });
+  },
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Manage Subscription
+
+```typescript
+// Unsubscribe
+this.metigan.contacts.unsubscribe('contact-456').subscribe({
+  next: (contact) => console.log('Unsubscribed:', contact),
+  error: (error) => console.error('Error:', error)
+});
+
+// Resubscribe
+this.metigan.contacts.subscribe('contact-456').subscribe({
+  next: (contact) => console.log('Subscribed:', contact),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Manage Tags
+
+```typescript
+// Add tags
+this.metigan.contacts.addTags('contact-456', ['vip', 'black-friday']).subscribe({
+  next: (contact) => console.log('Tags added:', contact),
+  error: (error) => console.error('Error:', error)
+});
+
+// Remove tags
+this.metigan.contacts.removeTags('contact-456', ['test']).subscribe({
+  next: (contact) => console.log('Tags removed:', contact),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Bulk Import
+
+```typescript
+this.metigan.contacts.bulkImport(
+  [
+    { email: 'john@email.com', firstName: 'John', audienceId: 'audience-123' },
+    { email: 'jane@email.com', firstName: 'Jane', audienceId: 'audience-123' },
+    { email: 'peter@email.com', firstName: 'Peter', audienceId: 'audience-123', tags: ['vip'] }
+  ],
+  'audience-123'
+).subscribe({
+  next: (result) => {
+    console.log(`Imported: ${result.imported}`);
+    console.log(`Failed: ${result.failed}`);
+  },
+  error: (error) => console.error('Error:', error)
+});
+```
+
+## 📊 Audiences Module
+
+### Create Audience
+
+```typescript
+this.metigan.audiences.create({
+  name: 'Main Newsletter',
+  description: 'Main subscriber list'
+}).subscribe({
+  next: (audience) => console.log('Audience created:', audience),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### List Audiences
+
+```typescript
+this.metigan.audiences.list({
+  page: 1,
+  limit: 10
+}).subscribe({
+  next: (response) => {
+    response.audiences.forEach(audience => {
+      console.log(`${audience.name}: ${audience.count} contacts`);
+    });
+  },
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Get Audience Statistics
+
+```typescript
+this.metigan.audiences.getStats('audience-123').subscribe({
+  next: (stats) => {
+    console.log(`Total: ${stats.total}`);
+    console.log(`Subscribed: ${stats.subscribed}`);
+    console.log(`Unsubscribed: ${stats.unsubscribed}`);
+  },
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Clean Audience
+
+```typescript
+// Remove bounced and unsubscribed contacts
+this.metigan.audiences.clean('audience-123').subscribe({
+  next: (result) => console.log(`${result.removed} contacts removed`),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Merge Audiences
+
+```typescript
+// Merge source into target (source is deleted)
+this.metigan.audiences.merge(
+  'source-audience-id',
+  'target-audience-id'
+).subscribe({
+  next: (merged) => console.log('Audiences merged:', merged),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+## 📧 Templates Module
+
+### List Templates
+
+```typescript
+this.metigan.templates.list({
+  page: 1,
+  limit: 10
+}).subscribe({
+  next: (response) => {
+    response.templates.forEach(template => {
+      console.log(`${template.name}: ${template.subject}`);
+    });
+  },
+  error: (error) => console.error('Error:', error)
+});
+```
+
+### Get Template
+
+```typescript
+this.metigan.templates.get('template-123').subscribe({
+  next: (template) => console.log('Template:', template),
+  error: (error) => console.error('Error:', error)
+});
+```
+
+## ⚙️ Configuration
+
+### Module Configuration
+
+```typescript
+MetiganModule.forRoot({
+  apiKey: 'your-api-key',
+  userId: 'user-123',              // Optional: User ID for logging
+  timeout: 60000,                  // Optional: Request timeout in ms
+  retryCount: 5,                   // Optional: Number of retries
+  retryDelay: 2000,                // Optional: Delay between retries in ms
+  apiUrl: 'https://api.metigan.com' // Optional: Custom API URL
+})
+```
+
+### Manual Initialization
+
+```typescript
+this.metigan.initialize({
+  apiKey: 'your-api-key',
+  timeout: 60000,
+  retryCount: 5,
+  retryDelay: 2000,
+  apiUrl: 'https://api.metigan.com'
+});
+```
+
+## 🛡️ Error Handling
+
+All services return RxJS Observables, so use standard error handling:
+
+```typescript
+import { MetiganError, ValidationError, ApiError } from '@metigan/angular';
+
+this.metigan.email.sendEmail(options).subscribe({
+  next: (response) => {
+    // Success
+  },
+  error: (error) => {
+    if (error instanceof ValidationError) {
+      console.error('Invalid data:', error.message);
+    } else if (error instanceof ApiError) {
+      console.error(`API error (${error.statusCode}):`, error.message);
+    } else if (error instanceof MetiganError) {
+      console.error('Metigan error:', error.message);
+    } else {
+      console.error('Unknown error:', error);
+    }
+  }
+});
+```
+
+## 📝 Using Individual Services
+
+If you only need a specific service:
+
+```typescript
+import { MetiganEmailService } from '@metigan/angular';
+
+constructor(private emailService: MetiganEmailService) {}
+
+ngOnInit() {
+  this.emailService.initialize('your-api-key');
+  
+  this.emailService.sendEmail({
+    from: 'sender@example.com',
+    recipients: ['recipient@example.com'],
+    subject: 'Test',
+    content: '<p>Hello</p>'
+  }).subscribe({
+    next: (response) => console.log('Sent'),
+    error: (error) => console.error('Error:', error)
+  });
+}
+```
+
+## 🔄 RxJS Observables
+
+All service methods return RxJS Observables. Make sure to:
+
+1. Subscribe to the observable
+2. Handle both success and error cases
+3. Unsubscribe if needed (or use `async` pipe in templates)
+
+### Using Async Pipe
+
+```typescript
+// In component
+templates$ = this.metigan.templates.list();
+
+// In template
+<div *ngIf="templates$ | async as templates">
+  <div *ngFor="let template of templates.templates">
+    {{ template.name }}
+  </div>
+</div>
+```
+
+### Manual Subscription with Cleanup
+
+```typescript
+import { Component, OnDestroy } from '@angular/core';
+import { Subscription } from 'rxjs';
+
+export class MyComponent implements OnDestroy {
+  private subscription = new Subscription();
+
+  sendEmail() {
+    const sub = this.metigan.email.sendEmail(options).subscribe({
+      next: (response) => console.log('Sent'),
+      error: (error) => console.error('Error:', error)
+    });
+    
+    this.subscription.add(sub);
+  }
+
+  ngOnDestroy() {
+    this.subscription.unsubscribe();
+  }
+}
+```
+
+## 📄 License
+
+MIT © Metigan
+
+## 🔗 Links
+
+- [Documentation](https://docs.metigan.com)
+- [Dashboard](https://app.metigan.com)
+- [API Reference](https://docs.metigan.com/api)
+- [GitHub](https://github.com/frantchessico/metigan-angular)
+

package/dist/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Metigan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+