import { Caret } from '@theventures/caret';

const caret = new Caret({
  apiKey: 'sk-caret-api-xxxxxxxxxxxxxxxxxxxx'
});

// List all notes
const notes = await caret.notes.list();
console.log(notes);

// Get a specific note
const note = await caret.notes.get('note_id');
if (note) {
  console.log(note);
}

// List all tags
const tags = await caret.tags.list();
console.log(tags);

// Get workspace details
const workspace = await caret.workspace.get();
console.log(workspace);

const caret = new Caret(); // Automatically uses CARET_API_KEY

const caret = new Caret({
  apiKey: 'sk-caret-api-xxxxxxxxxxxxxxxxxxxx'
});

const caret = new Caret({
  apiKey: 'sk-caret-api-xxxxxxxxxxxxxxxxxxxx',
  baseURL: 'https://api.caret.so/v1', // default
  timeout: 30000, // 30 seconds (default)
  maxRetries: 3 // default
});

// List all notes with optional filtering
const notes = await caret.notes.list({
  limit: 10,
  offset: 0
});

// Retrieve a specific note
const note = await caret.notes.get('note_id');

// Update a note
const updatedNote = await caret.notes.update('note_id', {
  title: 'New Title',
  userWrittenNote: 'Updated content'
});

// List all tags in the workspace
const tags = await caret.tags.list();

// Create a new tag
const newTag = await caret.tags.create({
  name: 'Important',
  color: '#FF5733'
});

// Get workspace details
const workspace = await caret.workspace.get();
console.log(workspace.name, workspace.settings);

// List workspace members with pagination
const members = await caret.workspace.listMembers({
  limit: 50,
  offset: 0,
  search: 'john'
});

// Get a specific member
const member = await caret.workspace.getMember('member_id');
console.log(member.name, member.role, member.groups);

// Update member's group assignments
const updatedMember = await caret.workspace.updateMember('member_id', {
  groupIds: ['group_1', 'group_2']
});

// List all groups in the workspace
const groups = await caret.workspace.listGroups();
console.log(groups.map(g => ({ name: g.name, members: g.memberCount })));

// Create a new group
const newGroup = await caret.workspace.createGroup({
  name: 'Engineering Team',
  description: 'All engineering team members'
});
console.log(newGroup.id, newGroup.name);

// List all invites with pagination
const invites = await caret.workspace.listInvites({
  limit: 50,
  offset: 0
});
console.log(invites.items.map(i => ({ email: i.email, role: i.role })));

// Create a new invite
const invite = await caret.workspace.createInvite({
  email: 'newmember@example.com',
  role: 'member',
  groupIds: ['group_1', 'group_2']
});
console.log(invite.code, invite.expiresAt);

// Delete an invite
const deleteResult = await caret.workspace.deleteInvite('invite_id');
console.log(deleteResult.success, deleteResult.message);

import { 
  AuthenticationError,
  CaretAPIError, 
  RateLimitError,
} from '@theventures/caret';

// Note: notes.get() returns null for 404 errors instead of throwing
const note = await caret.notes.get('invalid_id');
if (note === null) {
  console.log('Note not found');
}

// Other methods still throw errors as expected
try {
  const notes = await caret.notes.list();
} catch (error) {
  if (error instanceof RateLimitError) {
    console.log('Rate limit exceeded');
  } else if (error instanceof AuthenticationError) {
    console.log('Invalid API key');
  } else if (error instanceof CaretAPIError) {
    console.log('API error:', error.message);
  }
}

import { WebhookVerifier } from '@theventures/caret';

// Next.js App Router example
export async function POST(request: Request) {
  // Uses CARET_WEBHOOK_SECRET env var automatically or you can pass it in the constructor
  const verifier = new WebhookVerifier(); 
  
  // Verify and parse in one step with full type safety
  const { isValid, data, error } = await verifier.verifyRequest<'note.created'>(request);
  
  if (!isValid) {
    console.error('Webhook verification failed:', error);
    return new Response('Unauthorized', { status: 401 });
  }
  
  // data is fully typed as WebhookEventMap['note.created']
  const note = data.payload.note; // Fully typed as Note
  console.log('New note created:', note.title);
  console.log('Participants:', note.participants);
  // Process the note...
  
  return new Response('OK', { status: 200 });
}

import type { 
  Note, 
  NoteStatus, 
  NoteVisibility, 
  Tag,
  WorkspaceType,
  Member,
  Group,
  Invite,
  WebhookEvent,
  WebhookEventMap
} from '@theventures/caret';

const note: Note | null = await caret.notes.get('note_id');
if (note) {
  console.log(note.title); // Fully typed
}

const tags: Tag[] = await caret.tags.list();
tags.forEach(tag => {
  console.log(tag.name, tag.color); // Fully typed
});

const workspace: WorkspaceType = await caret.workspace.get();
console.log(workspace.settings.defaultLanguage); // Fully typed

const member: Member = await caret.workspace.getMember('member_id');
console.log(member.role, member.groups); // Fully typed

const groups: Group[] = await caret.workspace.listGroups();
groups.forEach(group => {
  console.log(group.name, group.memberCount, group.description); // Fully typed
});

const invite: Invite = await caret.workspace.createInvite({
  email: 'new@example.com',
  role: 'member'
});
console.log(invite.code, invite.expiresAt, invite.groups); // Fully typed

// Webhook event types
const webhookEvent: WebhookEventMap['note.created'] = {
  type: 'note.created',
  eventId: 'evt_123',
  webhookId: 'wh_456',
  workspaceId: 'ws_789',
  timestamp: '2024-01-01T00:00:00Z',
  payload: {
    note: note! // Fully typed as Note
  }
};