@fayz-ai/plugin-agenda 0.1.3 → 0.1.6

package/dist/integrations/google-calendar/GoogleCalendarSettings.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare function GoogleCalendarSettings(): React.JSX.Element;
+//# sourceMappingURL=GoogleCalendarSettings.d.ts.map

package/dist/integrations/google-calendar/GoogleCalendarSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleCalendarSettings.d.ts","sourceRoot":"","sources":["../../../src/integrations/google-calendar/GoogleCalendarSettings.tsx"],"names":[],"mappings":"AAKA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAQlD,wBAAgB,sBAAsB,sBA0HrC"}

package/dist/integrations/google-calendar/connector.d.ts

@@ -0,0 +1,3 @@
+import type { Connector } from '@fayz-ai/core';
+export declare const googleCalendarConnector: Connector;
+//# sourceMappingURL=connector.d.ts.map

package/dist/integrations/google-calendar/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/integrations/google-calendar/connector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,eAAO,MAAM,uBAAuB,EAAE,SAYrC,CAAA"}

package/dist/integrations/google-calendar/connectorDef.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectorDefinition } from '@fayz-ai/core';
+export declare const googleCalendarConnectorDef: ConnectorDefinition;
+//# sourceMappingURL=connectorDef.d.ts.map

package/dist/integrations/google-calendar/connectorDef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectorDef.d.ts","sourceRoot":"","sources":["../../../src/integrations/google-calendar/connectorDef.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAsExD,eAAO,MAAM,0BAA0B,EAAE,mBAcxC,CAAA"}

package/dist/integrations/google-calendar/data/supabase.d.ts

@@ -0,0 +1,16 @@
+import type { CalendarIntegration, CalendarSyncLogEntry } from '../types';
+export interface GoogleCalendarProvider {
+    getIntegration(): Promise<CalendarIntegration | null>;
+    /** Start the OAuth connect flow — returns the Google consent URL to redirect to. */
+    getConnectUrl(redirectTo?: string): Promise<string>;
+    setCalendar(calendarId: string): Promise<void>;
+    disconnect(): Promise<void>;
+    /** Manually pull external changes now (inbound). */
+    syncNow(): Promise<{
+        fetched: number;
+        written: number;
+    }>;
+    getSyncLog(): Promise<CalendarSyncLogEntry[]>;
+}
+export declare function createGoogleCalendarProvider(): GoogleCalendarProvider;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/integrations/google-calendar/data/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../../../src/integrations/google-calendar/data/supabase.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAUzE,MAAM,WAAW,sBAAsB;IACrC,cAAc,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAA;IACrD,oFAAoF;IACpF,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,oDAAoD;IACpD,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxD,UAAU,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;CAC9C;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CA8CrE"}

package/dist/integrations/google-calendar/index.d.ts

@@ -0,0 +1,8 @@
+import type { PluginManifest } from '@fayz-ai/core';
+export { createGoogleCalendarProvider } from './data/supabase';
+export { googleCalendarConnector } from './connector';
+export { googleCalendarConnectorDef } from './connectorDef';
+export { bookingToEvent, eventToBookingPatch, bookingSummary } from './mapping';
+export * from './types';
+export declare function createGoogleCalendarPlugin(): PluginManifest;
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/google-calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/google-calendar/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/E,cAAc,SAAS,CAAA;AAKvB,wBAAgB,0BAA0B,IAAI,cAAc,CAa3D"}

package/dist/integrations/google-calendar/integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/integrations/google-calendar/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../../src/integrations/google-calendar/integration.test.ts"],"names":[],"mappings":""}

package/dist/integrations/google-calendar/mapping.d.ts

@@ -0,0 +1,25 @@
+import type { CalendarBooking } from '../../types';
+import type { GCalEvent } from './types';
+export interface GCalEventInput {
+    summary: string;
+    description?: string;
+    start: {
+        dateTime: string;
+        timeZone?: string;
+    };
+    end: {
+        dateTime: string;
+        timeZone?: string;
+    };
+}
+/** Build the event title from the booking's services + client. */
+export declare function bookingSummary(b: Pick<CalendarBooking, 'services' | 'clientName'>): string;
+/** Map a Fayz booking to a Google Calendar event input. Returns null when the booking has no end. */
+export declare function bookingToEvent(b: CalendarBooking, timeZone?: string): GCalEventInput | null;
+/** Map an inbound Google event change to a partial booking update (reschedule/cancel). */
+export declare function eventToBookingPatch(ev: GCalEvent): {
+    startsAt?: string;
+    endsAt?: string;
+    status?: 'cancelled';
+};
+//# sourceMappingURL=mapping.d.ts.map

package/dist/integrations/google-calendar/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../src/integrations/google-calendar/mapping.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7C;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,MAAM,CAK1F;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAU3F;AAED,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,SAAS,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAM/G"}

package/dist/integrations/google-calendar/types.d.ts

@@ -0,0 +1,36 @@
+export interface CalendarIntegration {
+    id: string;
+    provider: string;
+    calendarId: string;
+    active: boolean;
+    connected: boolean;
+    lastSyncAt?: string;
+}
+export interface CalendarSyncLogEntry {
+    id: string;
+    direction: string;
+    trigger?: string;
+    status: string;
+    fetched: number;
+    written: number;
+    error?: string;
+    createdAt: string;
+}
+/** Minimal Google Calendar event shape we read/write (subset of the API). */
+export interface GCalEvent {
+    id: string;
+    summary?: string;
+    description?: string;
+    start: {
+        dateTime?: string;
+        date?: string;
+        timeZone?: string;
+    };
+    end: {
+        dateTime?: string;
+        date?: string;
+        timeZone?: string;
+    };
+    status?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integrations/google-calendar/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/google-calendar/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,GAAG,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fayz-ai/plugin-agenda",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Fayz SDK — plugin-agenda plugin",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -33,17 +33,19 @@
     "@tanstack/react-table": "^8.20.0",
     "@fullcalendar/resource-timegrid": "^6.1.0",
     "@fullcalendar/list": "^6.1.0",
-    "@fayz-ai/core": "^0.1.7",
-    "@fayz-ai/ui": "^0.1.7",
-    "@fayz-ai/saas": "^0.1.7",
-    "@fayz-ai/plugin-financial": "^0.1.2"
+    "@fayz-ai/core": "^0.2.0",
+    "@fayz-ai/ui": "^0.2.1",
+    "@fayz-ai/saas": "^0.3.0",
+    "@fayz-ai/plugin-financial": "^0.1.5"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",
     "react": "^18.3.0",
     "tsup": "^8.2.0",
     "typescript": "^5.5.0",
-    "@types/react-dom": "^18.3.0"
+    "@types/react-dom": "^18.3.0",
+    "vitest": "^2.1.9",
+    "react-dom": "^18.3.0"
   },
   "license": "MIT",
   "keywords": [
@@ -58,6 +60,7 @@
     "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --noEmit false",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "vitest run"
   }
 }

package/src/index.ts

@@ -11,7 +11,7 @@ import { createAgendaStore } from './store'
 import { agendaRegistries } from './registries'
 import { AgendaGeneralSettings } from './components/AgendaGeneralSettings'
 import { agendaLocales } from './locales'
-import { setScheduleBlockConfig, getScheduleBlockConfig } from '@fayz-ai/saas'
+import { setScheduleBlockConfig, getScheduleBlockConfig, PluginSettingsPanel } from '@fayz-ai/saas'
 
 // ---------------------------------------------------------------------------
 // Factory
@@ -159,8 +159,15 @@ export function createAgendaPlugin(options?: AgendaPluginOptions): PluginManifes
         id: 'agenda',
         label: 'Agenda',
         icon: 'Calendar',
+        // Standard layout: General | Integrations (Google Calendar addon) | Properties (holidays).
         component: (() => {
-          const AgendaSettingsTab: React.FC = () => React.createElement(AgendaGeneralSettings)
+          const AgendaSettingsTab: React.FC = () => React.createElement(PluginSettingsPanel, {
+            title: 'Agenda',
+            generalSettings: React.createElement(AgendaGeneralSettings),
+            registries: agendaRegistries,
+            hostPluginId: 'agenda',
+            routeBase: '/settings/agenda',
+          })
           AgendaSettingsTab.displayName = 'AgendaSettingsTab'
           return AgendaSettingsTab as unknown as React.ComponentType<unknown>
         })(),
@@ -178,3 +185,6 @@ export type { ResolvedAgendaConfig } from './config'
 export type { AgendaDataProvider } from './data/types'
 export type { AgendaFinancialBridge, BookingPaymentStatus, BookingPaymentSummary, BookingPaymentDetail } from './financial-bridge'
 export { createFinancialBridge, computeCommissionAmount } from './bridges/create-financial-bridge'
+
+// Google Calendar integration (official addon) — settings-only plugin + helpers
+export { createGoogleCalendarPlugin, createGoogleCalendarProvider, googleCalendarConnector, bookingToEvent, eventToBookingPatch } from './integrations/google-calendar'

package/src/integrations/google-calendar/GoogleCalendarSettings.tsx

@@ -0,0 +1,136 @@
+// Google Calendar integration — settings tab (control plane UI).
+//
+// Connect/disconnect, pick the target calendar, run a manual inbound sync, and
+// see recent runs. Outbound (booking → Google) is automatic via the DB trigger;
+// this screen is the only UI surface the integration needs.
+import React, { useEffect, useState } from 'react'
+import { Calendar, Plug, Power, RefreshCw, CheckCircle2, Loader2, History, AlertCircle } from 'lucide-react'
+import { Button, toast } from '@fayz-ai/ui'
+import { createGoogleCalendarProvider } from './data/supabase'
+import type { CalendarIntegration, CalendarSyncLogEntry } from './types'
+
+const provider = createGoogleCalendarProvider()
+
+export function GoogleCalendarSettings() {
+  const [integration, setIntegration] = useState<CalendarIntegration | null>(null)
+  const [loading, setLoading] = useState(true)
+  const [calendarId, setCalendarId] = useState('primary')
+  const [connecting, setConnecting] = useState(false)
+  const [syncing, setSyncing] = useState(false)
+  const [log, setLog] = useState<CalendarSyncLogEntry[]>([])
+
+  async function load() {
+    setLoading(true)
+    try {
+      const found = await provider.getIntegration()
+      setIntegration(found)
+      if (found) { setCalendarId(found.calendarId); void provider.getSyncLog().then(setLog) }
+    } finally { setLoading(false) }
+  }
+
+  useEffect(() => { void load() }, [])
+
+  async function handleConnect() {
+    setConnecting(true)
+    try {
+      const url = await provider.getConnectUrl()
+      window.location.href = url // → Google consent, then back to the app
+    } catch (e: any) {
+      toast.error(e?.message ?? 'Connect failed')
+      setConnecting(false)
+    }
+  }
+
+  async function handleDisconnect() {
+    await provider.disconnect()
+    toast.success('Disconnected')
+    void load()
+  }
+
+  async function handleSaveCalendar() {
+    await provider.setCalendar(calendarId)
+    toast.success('Saved')
+  }
+
+  async function handleSyncNow() {
+    setSyncing(true)
+    try {
+      const res = await provider.syncNow()
+      toast.success(`Synced — ${res.written} updated`)
+      void provider.getSyncLog().then(setLog)
+      void load()
+    } catch (e: any) {
+      toast.error(e?.message ?? 'Sync failed')
+    } finally { setSyncing(false) }
+  }
+
+  const connected = !!integration?.connected
+
+  return (
+    <div className="space-y-6 max-w-3xl">
+      <div className="flex items-center gap-2">
+        <Calendar className="h-5 w-5 text-muted-foreground" />
+        <div>
+          <h2 className="text-lg font-semibold tracking-tight">Google Calendar</h2>
+          <p className="text-sm text-muted-foreground">Two-way sync between your bookings and Google Calendar.</p>
+        </div>
+        {connected && (
+          <span className="ml-auto inline-flex items-center gap-1 text-xs text-success">
+            <CheckCircle2 className="h-3.5 w-3.5" /> Connected
+          </span>
+        )}
+      </div>
+
+      <section className="rounded-lg border bg-card shadow-sm p-5 space-y-4">
+        {loading ? (
+          <div className="py-6 text-center text-sm text-muted-foreground"><Loader2 className="h-4 w-4 animate-spin inline" /></div>
+        ) : !connected ? (
+          <div className="text-center py-6">
+            <p className="text-sm text-muted-foreground mb-3">Connect a Google account to sync bookings both ways.</p>
+            <Button onClick={handleConnect} disabled={connecting}>
+              {connecting ? <Loader2 className="h-4 w-4 animate-spin" /> : <Plug className="h-4 w-4" />} Connect Google Calendar
+            </Button>
+          </div>
+        ) : (
+          <>
+            <div className="flex flex-wrap items-end gap-3">
+              <label className="block flex-1 min-w-[200px]">
+                <span className="text-xs font-medium text-muted-foreground">Calendar ID</span>
+                <input value={calendarId} onChange={(e) => setCalendarId(e.target.value)} placeholder="primary"
+                  className="w-full mt-1 rounded-input border border-input bg-card px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-ring" />
+              </label>
+              <Button variant="outline" size="sm" onClick={handleSaveCalendar}>Save</Button>
+              <Button variant="outline" size="sm" onClick={handleSyncNow} disabled={syncing}>
+                <RefreshCw className={`h-3.5 w-3.5 ${syncing ? 'animate-spin' : ''}`} /> Sync now
+              </Button>
+              <Button variant="outline" size="sm" onClick={handleDisconnect}>
+                <Power className="h-3.5 w-3.5" /> Disconnect
+              </Button>
+            </div>
+            {integration?.lastSyncAt && (
+              <p className="text-[11px] text-muted-foreground">Last sync: {new Date(integration.lastSyncAt).toLocaleString()}</p>
+            )}
+          </>
+        )}
+      </section>
+
+      {log.length > 0 && (
+        <section className="rounded-lg border bg-card shadow-sm p-5 space-y-2">
+          <div className="flex items-center gap-2"><History className="h-4 w-4 text-muted-foreground" /><h3 className="text-sm font-semibold">History</h3></div>
+          <div className="rounded-md border divide-y text-sm">
+            {log.map((r) => (
+              <div key={r.id} className="flex items-center gap-3 px-3 py-2">
+                <span className="text-muted-foreground text-xs">{new Date(r.createdAt).toLocaleString()}</span>
+                <span className="text-[10px] uppercase tracking-wide px-1 py-px rounded bg-muted text-muted-foreground">{r.direction}</span>
+                <span className="ml-auto text-xs">{r.written} written / {r.fetched} fetched</span>
+                {r.status === 'success'
+                  ? <CheckCircle2 className="h-3.5 w-3.5 text-success" />
+                  : <AlertCircle className="h-3.5 w-3.5 text-warning" />}
+              </div>
+            ))}
+          </div>
+        </section>
+      )}
+    </div>
+  )
+}

package/src/integrations/google-calendar/connector.ts

@@ -0,0 +1,20 @@
+// Google Calendar connector descriptor (control-plane metadata).
+//
+// Declares the connector against the SDK integration spine so the platform can
+// reason about what it syncs. The actual data-plane verbs run in the
+// google-calendar-sync edge function; this is the typed contract + capabilities.
+import type { Connector } from '@fayz-ai/core'
+
+export const googleCalendarConnector: Connector = {
+  id: 'google-calendar',
+  provider: 'google',
+  pluginId: 'agenda',
+  authKind: 'oauth',
+  capabilities: [
+    {
+      entity: 'booking',
+      direction: 'bidirectional',
+      triggers: ['on-write', 'scheduled', 'webhook'],
+    },
+  ],
+}

package/src/integrations/google-calendar/connectorDef.tsx

@@ -0,0 +1,94 @@
+// Google Calendar as a unified ConnectorDefinition.
+//
+// Surfaces inside plugin-agenda's settings → Integrations tab (the host),
+// rendered by the shared ConnectorsHub. The hub handles the OAuth connect/
+// disconnect; the ExtraPanel below adds the calendar picker, manual sync and
+// run history (only meaningful once connected).
+import React, { useEffect, useState } from 'react'
+import { RefreshCw, History, CheckCircle2, AlertCircle, Loader2 } from 'lucide-react'
+import { Button, toast } from '@fayz-ai/ui'
+import type { ConnectorDefinition } from '@fayz-ai/core'
+import { createGoogleCalendarProvider } from './data/supabase'
+import type { CalendarSyncLogEntry } from './types'
+
+const provider = createGoogleCalendarProvider()
+
+function GoogleCalendarExtraPanel() {
+  const [connected, setConnected] = useState(false)
+  const [calendarId, setCalendarId] = useState('primary')
+  const [syncing, setSyncing] = useState(false)
+  const [log, setLog] = useState<CalendarSyncLogEntry[]>([])
+  const [loaded, setLoaded] = useState(false)
+
+  async function load() {
+    const integ = await provider.getIntegration()
+    setConnected(!!integ?.connected)
+    if (integ) { setCalendarId(integ.calendarId); void provider.getSyncLog().then(setLog) }
+    setLoaded(true)
+  }
+  useEffect(() => { void load() }, [])
+
+  // Before connecting there's nothing to configure here.
+  if (!loaded || !connected) return null
+
+  async function handleSaveCalendar() {
+    await provider.setCalendar(calendarId)
+    toast.success('Saved')
+  }
+  async function handleSyncNow() {
+    setSyncing(true)
+    try { const r = await provider.syncNow(); toast.success(`Synced — ${r.written} updated`); void provider.getSyncLog().then(setLog) }
+    catch (e: any) { toast.error(e?.message ?? 'Sync failed') }
+    finally { setSyncing(false) }
+  }
+
+  return (
+    <div className="space-y-4 border-t pt-4">
+      <div className="flex flex-wrap items-end gap-3">
+        <label className="block flex-1 min-w-[200px]">
+          <span className="text-xs font-medium text-muted-foreground">Calendar ID</span>
+          <input value={calendarId} onChange={(e) => setCalendarId(e.target.value)} placeholder="primary"
+            className="w-full mt-1 rounded-input border border-input bg-card px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-ring" />
+        </label>
+        <Button variant="outline" size="sm" onClick={handleSaveCalendar}>Save</Button>
+        <Button variant="outline" size="sm" onClick={handleSyncNow} disabled={syncing}>
+          <RefreshCw className={`h-3.5 w-3.5 ${syncing ? 'animate-spin' : ''}`} /> Sync now
+        </Button>
+      </div>
+
+      {log.length > 0 && (
+        <div className="space-y-2">
+          <div className="flex items-center gap-2"><History className="h-4 w-4 text-muted-foreground" /><h4 className="text-sm font-semibold">History</h4></div>
+          <div className="rounded-md border divide-y text-sm">
+            {log.map((r) => (
+              <div key={r.id} className="flex items-center gap-3 px-3 py-2">
+                <span className="text-muted-foreground text-xs">{new Date(r.createdAt).toLocaleString()}</span>
+                <span className="text-[10px] uppercase tracking-wide px-1 py-px rounded bg-muted text-muted-foreground">{r.direction}</span>
+                <span className="ml-auto text-xs">{r.written} written / {r.fetched} fetched</span>
+                {r.status === 'success'
+                  ? <CheckCircle2 className="h-3.5 w-3.5 text-success" />
+                  : <AlertCircle className="h-3.5 w-3.5 text-warning" />}
+              </div>
+            ))}
+          </div>
+        </div>
+      )}
+    </div>
+  )
+}
+
+export const googleCalendarConnectorDef: ConnectorDefinition = {
+  id: 'google-calendar',
+  hostPluginId: 'agenda',
+  name: 'Google Calendar',
+  description: 'Two-way sync between your bookings and Google Calendar.',
+  icon: 'Calendar',
+  authKind: 'oauth',
+  async getStatus() {
+    const integ = await provider.getIntegration()
+    return { connected: !!integ?.connected }
+  },
+  startOAuth: (redirectTo) => provider.getConnectUrl(redirectTo),
+  disconnect: () => provider.disconnect(),
+  ExtraPanel: GoogleCalendarExtraPanel,
+}

package/src/integrations/google-calendar/data/supabase.ts

@@ -0,0 +1,74 @@
+// Google Calendar integration (control plane) — Supabase client.
+//
+// Thin client: reads/writes the calendar_integrations row and invokes the
+// google-calendar-sync edge function for OAuth connect + manual sync. The
+// function holds the OAuth client secret and does the Calendar API work.
+import { getSupabaseClientOptional } from '@fayz-ai/core'
+import type { CalendarIntegration, CalendarSyncLogEntry } from '../types'
+
+const FUNCTION = 'google-calendar-sync'
+
+function sb() {
+  const supabase = getSupabaseClientOptional() as any
+  if (!supabase) throw new Error('Supabase not initialized')
+  return supabase
+}
+
+export interface GoogleCalendarProvider {
+  getIntegration(): Promise<CalendarIntegration | null>
+  /** Start the OAuth connect flow — returns the Google consent URL to redirect to. */
+  getConnectUrl(redirectTo?: string): Promise<string>
+  setCalendar(calendarId: string): Promise<void>
+  disconnect(): Promise<void>
+  /** Manually pull external changes now (inbound). */
+  syncNow(): Promise<{ fetched: number; written: number }>
+  getSyncLog(): Promise<CalendarSyncLogEntry[]>
+}
+
+export function createGoogleCalendarProvider(): GoogleCalendarProvider {
+  return {
+    async getIntegration() {
+      const { data } = await sb().from('calendar_integrations').select('*').eq('provider', 'google').limit(1).maybeSingle()
+      if (!data) return null
+      return {
+        id: data.id,
+        provider: data.provider,
+        calendarId: data.calendar_id ?? 'primary',
+        active: data.active ?? true,
+        connected: !!data.oauth_refresh_token,
+        lastSyncAt: data.last_sync_at ?? undefined,
+      }
+    },
+
+    async getConnectUrl(redirectTo) {
+      const { data, error } = await sb().functions.invoke(FUNCTION, {
+        body: { action: 'oauth_start', redirectTo: redirectTo ?? window.location.href },
+      })
+      if (error) throw new Error(error.message)
+      return (data as { url: string }).url
+    },
+
+    async setCalendar(calendarId) {
+      await sb().from('calendar_integrations').update({ calendar_id: calendarId, updated_at: new Date().toISOString() }).eq('provider', 'google')
+    },
+
+    async disconnect() {
+      await sb().from('calendar_integrations').update({ active: false, oauth_refresh_token: null, oauth_access_token: null }).eq('provider', 'google')
+    },
+
+    async syncNow() {
+      const { data, error } = await sb().functions.invoke(FUNCTION, { body: { action: 'pull_events', trigger: 'manual' } })
+      if (error) throw new Error(error.message)
+      return data as { fetched: number; written: number }
+    },
+
+    async getSyncLog() {
+      const { data } = await sb().from('calendar_sync_log').select('*').order('created_at', { ascending: false }).limit(20)
+      return (data ?? []).map((r: any) => ({
+        id: r.id, direction: r.direction, trigger: r.trigger ?? undefined,
+        status: r.status, fetched: r.fetched ?? 0, written: r.written ?? 0,
+        error: r.error ?? undefined, createdAt: r.created_at,
+      }))
+    },
+  }
+}

package/src/integrations/google-calendar/index.ts

@@ -0,0 +1,36 @@
+// Google Calendar integration — official (in-SDK) addon for plugin-agenda.
+//
+// Settings-only PluginManifest: contributes a "Google Calendar" tab to /settings
+// for connecting an account and running a manual sync. Outbound (booking →
+// Google) is automatic via a DB trigger; inbound (Google → booking) via pg_cron
+// or a Google watch webhook. The data plane is the google-calendar-sync edge
+// function (see ./functions/google-calendar-sync). The booking↔event link lives
+// on saas_core.bookings.metadata.googleCalendarEventId.
+//
+// Graduation path: extract to its own `@fayz-ai/plugin-google-calendar` package.
+import type { PluginManifest } from '@fayz-ai/core'
+import { googleCalendarConnectorDef } from './connectorDef'
+
+export { createGoogleCalendarProvider } from './data/supabase'
+export { googleCalendarConnector } from './connector'
+export { googleCalendarConnectorDef } from './connectorDef'
+export { bookingToEvent, eventToBookingPatch, bookingSummary } from './mapping'
+export * from './types'
+
+// Addon plugin: contributes the Google Calendar connector into its host
+// (plugin-agenda). It appears in Agenda settings → Integrations — no top-level
+// settings tab of its own. See packages/saas ConnectorsHub.
+export function createGoogleCalendarPlugin(): PluginManifest {
+  return {
+    id: 'google-calendar',
+    name: 'Google Calendar',
+    icon: 'Calendar',
+    version: '0.1.0',
+    scope: 'addon',
+    defaultEnabled: true,
+    dependencies: ['agenda'],
+    navigation: [],
+    routes: [],
+    connectors: [googleCalendarConnectorDef],
+  }
+}