setListeners

Documentation Index

Fetch the complete documentation index at: https://docs.hotglue.com/llms.txt

Use this file to discover all available pages before exploring further.

​

setListeners

​

Parameters:

• listeners: object
  • onConnectorLink: (event: ConnectorLinkEvent) => void
    • Callback for when a connector is successfully linked.
  • onConnectorRelink: (event: ConnectorLinkEvent) => void
    • Callback for when a connector is relinked.
  • onConnectorUnlink: (event: ConnectorUnlinkEvent) => void
    • Callback for when a connector is unlinked.
  • onConnectorLinkFail: (event: ConnectorLinkFailEvent) => void
    • Callback for when a connector link fails.
  • onScheduleSave: (event: ScheduleEvent) => void (optional)
    • Callback when the sync schedule is saved or disabled in the widget. Your app can mirror schedule state, trigger backend syncs, or run analytics. For how the schedule UI behaves, see Sync Schedule.
    • If you omit onScheduleSave, the widget skips it. If your callback throws, the widget catches the error and logs onScheduleSave listener failed to the console without breaking the save flow in the UI.

​

Event Types:

• ConnectorLinkEvent:
  • connectorId: string
  • connectorType: 'connector' | 'source' | 'target'
  • connectorDetail: Record<string, unknown>
  • flowId: string
  • tenantId: string
• ConnectorUnlinkEvent:
  • connectorId: string
  • connectorType: 'connector' | 'source' | 'target'
  • flowId: string
  • tenantId: string
• ConnectorLinkFailEvent:
  • error: string
  • connectorId: string
  • connectorType: 'connector' | 'source' | 'target'
  • flowId: string
  • tenantId: string
  • type: 'failed' | 'cancelled' (optional)
• ScheduleEvent:
  • type: 'save' | 'disabled' — 'save' when the user saves with scheduling enabled; 'disabled' when they save with scheduling turned off in the schedule UI.
  • oldSchedule: string | null — Previous schedule expression before the change; null if none applied.
  • newSchedule: string | null — Schedule after the change; null if cleared or not applicable.
  • connectorId: string (optional) — Present when your environment has Enable connector schedules on and the user saved a connector-level schedule (the widget scoped the save to that connector). Omitted for flow-only schedule updates. See Sync Schedule — flow vs connector.
  • flowId: string
  • tenantId: string — May be an empty string when no tenant id is available (the widget passes tenantId || '').

​

Example:

// Alternatively exported by useHotglue in the React package
const hotglue = new Hotglue({
    // Configuration
});

hotglue.setListeners({
    onConnectorLink: (event) => {
        console.log("Connector linked:", event);
    },
    onConnectorRelink: (event) => {
        console.log("Connector relinked:", event);
    },
    onConnectorUnlink: (event) => {
        console.log("Connector unlinked:", event);
    },
    onConnectorLinkFail: (event) => {
        console.error("Connector link failed:", event);
    },
    onScheduleSave: (event) => {
        if (event.type === "save") {
            console.log("Schedule saved", {
                flowId: event.flowId,
                connectorId: event.connectorId,
                from: event.oldSchedule,
                to: event.newSchedule,
            });
        } else {
            console.log("Schedule disabled", event);
        }
    },
});