@soulbatical/tetra-core 0.1.39 → 0.1.41

package/dist/shared/planner/types.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Planner Module — Types
+ *
+ * Configuration and data types for the Tetra Planner module.
+ * Handles: availability, appointments, vacations, scheduler settings,
+ * Google Calendar integration, and public booking.
+ */
+import type { SupabaseClient } from '@supabase/supabase-js';
+export interface PlannerConfig {
+    /**
+     * Role name for the resource owner (the person who has an agenda).
+     * Examples: 'coach', 'consultant', 'therapist', 'agent'
+     * Used for permission checks and owner identification.
+     */
+    ownerRole: string;
+    /**
+     * Table name for the owner entity (default: 'users_public').
+     */
+    ownerTable?: string;
+    /**
+     * Column on the owner table that holds the organization ID.
+     * Default: 'active_organization_id'
+     */
+    ownerOrgColumn?: string;
+    /**
+     * Optional parent resource that appointments can be linked to.
+     * Example: { table: 'tracks', foreignKey: 'coach_id', label: 'Traject' }
+     * If set, appointments can be linked to a parent record (e.g., a coaching track).
+     */
+    parentResource?: {
+        table: string;
+        foreignKey: string;
+        /** Column on the parent table for the client/assignee (for auto-linking public bookings) */
+        clientKey?: string;
+        /** Human-readable label for the parent (default: table name) */
+        label?: string;
+    };
+    /**
+     * Default timezone for calendar events.
+     * Default: 'Europe/Amsterdam'
+     */
+    timezone?: string;
+    /**
+     * Valid appointment types.
+     * Default: ['online', 'phone', 'in_person']
+     */
+    appointmentTypes?: string[];
+    /**
+     * Valid appointment statuses.
+     * Default: ['scheduled', 'completed', 'cancelled']
+     */
+    appointmentStatuses?: string[];
+    /**
+     * Default scheduler settings for new owners.
+     */
+    defaults?: {
+        sessionDurationMinutes?: number;
+        maxDaysAhead?: number;
+        minLeadTimeHours?: number;
+        timeIncrementMinutes?: number;
+    };
+    /**
+     * Callback: fired after an appointment is created.
+     * Use for sending emails, notifications, etc.
+     */
+    onAppointmentCreated?: (appointment: AppointmentRecord, context: PlannerCallbackContext) => Promise<void>;
+    /**
+     * Callback: fired after an appointment is cancelled.
+     */
+    onAppointmentCancelled?: (appointment: AppointmentRecord, context: PlannerCallbackContext) => Promise<void>;
+    /**
+     * Callback: fired after an appointment is completed.
+     */
+    onAppointmentCompleted?: (appointment: AppointmentRecord, context: PlannerCallbackContext) => Promise<void>;
+    /**
+     * Callback: fired after a public booking is created (unauthenticated).
+     * Receives visitor info (name, email, notes).
+     */
+    onPublicBooking?: (appointment: AppointmentRecord, visitor: PublicBookingVisitor, context: PlannerCallbackContext) => Promise<void>;
+}
+export interface PlannerCallbackContext {
+    /** The owner (coach/consultant) user ID */
+    ownerId: string;
+    /** Organization ID */
+    organizationId: string;
+}
+export interface PlannerCalendarConfig {
+    google: {
+        clientId: string;
+        clientSecret: string;
+        redirectUri: string;
+    };
+    /**
+     * Default timezone for Google Calendar events.
+     * Default: 'Europe/Amsterdam'
+     */
+    timezone?: string;
+    /**
+     * OAuth scopes for Google Calendar.
+     * Default: ['https://www.googleapis.com/auth/calendar.events', 'https://www.googleapis.com/auth/calendar.readonly']
+     */
+    scopes?: string[];
+    /**
+     * Function to get a system-level DB client (bypasses RLS).
+     * Default: uses systemDB from tetra-core.
+     */
+    getSystemDB?: () => Promise<SupabaseClient>;
+}
+export interface PlannerRouteOptions {
+    config: PlannerConfig;
+    /**
+     * Function to get a system-level DB client (for public routes, no auth context).
+     * Required for addPlannerPublicRoutes().
+     */
+    getSystemDB?: () => Promise<SupabaseClient>;
+}
+export interface AvailabilitySlotRecord {
+    id: string;
+    organizationId: string;
+    ownerId: string;
+    dayOfWeek: number;
+    startTime: string;
+    endTime: string;
+    isAvailable: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AppointmentRecord {
+    id: string;
+    organizationId: string;
+    parentId: string | null;
+    organizerId: string;
+    title: string;
+    description: string | null;
+    startTime: string;
+    endTime: string;
+    location: string | null;
+    type: string;
+    status: string;
+    attendeeIds: string[];
+    googleCalendarEventId: string | null;
+    outlookEventId: string | null;
+    reminderSentAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    organizer?: {
+        id: string;
+        name: string;
+        email: string;
+    } | null;
+    parent?: {
+        id: string;
+        title: string;
+    } | null;
+}
+export interface SchedulerSettingsRecord {
+    id: string;
+    organizationId: string;
+    ownerId: string;
+    eventName: string;
+    zoomLink: string | null;
+    description: string | null;
+    sessionDurationMinutes: number;
+    maxDaysAhead: number;
+    minLeadTimeHours: number;
+    timeIncrementMinutes: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface VacationRecord {
+    id: string;
+    organizationId: string;
+    ownerId: string;
+    startDate: string;
+    endDate: string;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CalendarTokenRecord {
+    id: string;
+    userId: string;
+    organizationId: string;
+    accessToken: string;
+    refreshToken: string;
+    tokenExpiry: string;
+    calendarId: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AvailabilitySlotInput {
+    dayOfWeek: number;
+    startTime: string;
+    endTime: string;
+    isAvailable?: boolean;
+}
+export interface AppointmentInput {
+    title: string;
+    parentId?: string;
+    description?: string;
+    startTime: string;
+    endTime: string;
+    location?: string;
+    type?: string;
+    attendeeIds?: string[];
+}
+export interface PublicBookingInput {
+    name: string;
+    email: string;
+    date: string;
+    startTime: string;
+    endTime: string;
+    notes?: string;
+}
+export interface PublicBookingVisitor {
+    name: string;
+    email: string;
+    notes?: string;
+}
+export interface TimeSlot {
+    startTime: string;
+    endTime: string;
+}
+export interface DayAvailability {
+    date: string;
+    dayOfWeek: number;
+    ownerId: string;
+    slots: TimeSlot[];
+    sessionDurationMinutes: number;
+}
+export interface TeamAvailability {
+    date: string;
+    dayOfWeek: number;
+    owners: Array<{
+        id: string;
+        name: string | null;
+        avatarUrl: string | null;
+        slots: TimeSlot[];
+        vacationDay: boolean;
+    }>;
+}
+export interface PublicSchedulerData {
+    owner: {
+        id: string;
+        name: string | null;
+        avatarUrl: string | null;
+    };
+    organization: {
+        name: string | null;
+    };
+    settings: {
+        eventName: string;
+        description: string | null;
+        sessionDurationMinutes: number;
+        maxDaysAhead: number;
+        minLeadTimeHours: number;
+        timeIncrementMinutes: number;
+    };
+    availableDays: number[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/planner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/planner/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/planner/types.js

@@ -0,0 +1,9 @@
+/**
+ * Planner Module — Types
+ *
+ * Configuration and data types for the Tetra Planner module.
+ * Handles: availability, appointments, vacations, scheduler settings,
+ * Google Calendar integration, and public booking.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/planner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/planner/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulbatical/tetra-core",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "publishConfig": {
     "access": "restricted"
   },

package/src/shared/email/migrations/004_add_email_logs_tracking_columns.sql

@@ -0,0 +1,15 @@
+-- ============================================
+-- Email Logs — add tracking & categorization columns
+-- Part of @soulbatical/tetra-core email module
+-- ============================================
+-- Adds: email_type, metadata, delivered_at, opened_at, clicked_at
+-- These support Mailgun webhook tracking and email categorization.
+
+ALTER TABLE email_logs ADD COLUMN IF NOT EXISTS email_type VARCHAR(100);
+ALTER TABLE email_logs ADD COLUMN IF NOT EXISTS metadata JSONB DEFAULT '{}';
+ALTER TABLE email_logs ADD COLUMN IF NOT EXISTS delivered_at TIMESTAMPTZ;
+ALTER TABLE email_logs ADD COLUMN IF NOT EXISTS opened_at TIMESTAMPTZ;
+ALTER TABLE email_logs ADD COLUMN IF NOT EXISTS clicked_at TIMESTAMPTZ;
+
+CREATE INDEX IF NOT EXISTS idx_email_logs_email_type ON email_logs(email_type);
+CREATE INDEX IF NOT EXISTS idx_email_logs_to_email ON email_logs(to_email);