crewly 1.3.31 → 1.4.0

package/dist/backend/backend/src/services/messaging/adapters/google-chat-messenger.adapter.d.ts

@@ -1,109 +1,47 @@
 /**
  * Google Chat Messenger Adapter
  *
- * Messenger adapter for Google Chat supporting three connection modes:
- * 1. **Webhook mode** — post messages via an incoming webhook URL (send-only)
- * 2. **Service account mode** — send messages via the Chat API (send-only)
- * 3. **Pub/Sub mode** — pull incoming messages from a Cloud Pub/Sub subscription
- *    and reply via the Chat API (bidirectional, thread-aware)
- *
- * In Pub/Sub mode, a Google Chat App is configured to publish events to a
- * Pub/Sub topic. Crewly pulls from the subscription, processes MESSAGE events,
- * and replies in the same thread via the Chat API.
+ * Messenger adapter for Google Chat using the Google Chat API (webhook or service account).
+ * Supports sending messages to Google Chat spaces via incoming webhooks or
+ * the Chat API with a service account.
  *
  * @module services/messaging/adapters/google-chat-messenger.adapter
  */
-import { MessengerAdapter, MessengerPlatform, IncomingMessage } from '../messenger-adapter.interface.js';
-/** Authentication mode — how OAuth2 tokens are obtained */
-export type GoogleChatAuthMode = 'service_account' | 'adc';
-/**
- * ADC (Application Default Credentials) JSON file shape.
- * Created by `gcloud auth application-default login`.
- */
-interface AdcCredentials {
-    client_id: string;
-    client_secret: string;
-    refresh_token: string;
-    type: string;
-}
+import { MessengerAdapter, MessengerPlatform } from '../messenger-adapter.interface.js';
 /**
- * Callback type for incoming messages from Pub/Sub pull.
- */
-export type GoogleChatIncomingCallback = (msg: IncomingMessage) => void;
-/**
- * Messenger adapter for Google Chat with Pub/Sub support.
+ * Messenger adapter for Google Chat.
+ *
+ * Supports two modes:
+ * 1. **Webhook mode** (simpler): uses an incoming webhook URL to post messages
+ * 2. **Service account mode**: uses a service account key to call the Chat API
  *
- * Supports webhook, service-account, and pubsub modes.
- * Pub/Sub mode enables bidirectional communication with thread tracking.
+ * Webhook mode is used when `webhookUrl` is provided in config.
+ * Service account mode is used when `serviceAccountKey` is provided.
  */
 export declare class GoogleChatMessengerAdapter implements MessengerAdapter {
     readonly platform: MessengerPlatform;
-    /** Current connection mode */
-    private mode;
     /** Webhook URL for posting messages (webhook mode) */
     private webhookUrl;
-    /** Service account key JSON string */
+    /** Service account key JSON (service account mode) */
     private serviceAccountKey;
-    /** Authentication mode: service_account (JWT) or adc (refresh token) */
-    private authMode;
-    /** ADC credentials (parsed from application_default_credentials.json) */
-    private adcCredentials;
-    /** Access token obtained from service account or ADC (cached) */
+    /** Access token obtained from service account (cached) */
     private accessToken;
     /** Access token expiry timestamp */
     private tokenExpiresAt;
-    /** OAuth2 scopes for the current mode */
-    private tokenScopes;
-    /** Pending token refresh promise to deduplicate concurrent requests (RL2) */
-    private pendingTokenRefresh;
-    /** Full Pub/Sub subscription resource name (e.g. projects/PROJECT/subscriptions/SUB) */
-    private subscriptionName;
-    /** GCP project ID (for Pub/Sub mode) */
-    private projectId;
-    /** Pub/Sub pull interval timer */
-    private pullIntervalTimer;
-    /** Callback for incoming messages */
-    private onIncomingMessage;
-    /** Service account email for impersonation (ADC mode) */
-    private serviceAccountEmail;
-    /** Impersonated SA token (separate from user ADC token) */
-    private saAccessToken;
-    /** Impersonated SA token expiry timestamp */
-    private saTokenExpiresAt;
     /**
-     * Recent send deduplication cache.
-     * Key: `${space}:${threadId}:${contentPrefix}`, value: timestamp (epoch ms).
-     * Prevents the same message being sent twice within DEDUP_WINDOW_MS (e.g. when
-     * both the auto-route and a manual reply-gchat call fire for the same response).
-     */
-    private recentSends;
-    /** Deduplication window in milliseconds */
-    private static readonly DEDUP_WINDOW_MS;
-    /** Consecutive pull failure count */
-    private consecutiveFailures;
-    /** Whether the pull loop is paused due to failures */
-    private pullPaused;
-    /** Timestamp of the last successful pull (epoch ms) */
-    private lastPullAt;
-    /**
-     * Initialize the adapter with the provided credentials.
+     * Initialize the adapter by validating credentials.
      *
-     * Detects mode based on provided config fields:
-     * - `webhookUrl` → webhook mode
-     * - `serviceAccountKey` + `projectId` + `subscriptionName` → pubsub mode
-     * - `serviceAccountKey` alone → service-account mode
-     *
-     * @param config - Configuration object with credentials
-     * @throws Error if credentials are invalid or missing
+     * @param config - Must contain either `webhookUrl` string or `serviceAccountKey` string
+     * @throws Error if neither credential is provided or validation fails
      */
     initialize(config: Record<string, unknown>): Promise<void>;
     /**
      * Send a text message to a Google Chat space.
      *
      * In webhook mode, the `channel` parameter is ignored (webhook URL determines the space).
-     * In service-account/pubsub mode, `channel` is the space name (e.g., "spaces/AAAA...").
+     * In service account mode, `channel` is the space name (e.g., "spaces/AAAA...").
      *
-     * @param channel - Google Chat space name (used in service-account/pubsub mode)
+     * @param channel - Google Chat space name (used in service account mode)
      * @param text - Message content
      * @param options - Optional send options (threadId for threaded replies)
      * @throws Error if adapter is not initialized or send fails
@@ -114,7 +52,7 @@ export declare class GoogleChatMessengerAdapter implements MessengerAdapter {
     /**
      * Get the current connection status.
      *
-     * @returns Status object with connected flag, platform, and mode details
+     * @returns Status object with connected flag and platform identifier
      */
     getStatus(): {
         connected: boolean;
@@ -122,43 +60,19 @@ export declare class GoogleChatMessengerAdapter implements MessengerAdapter {
         details?: Record<string, unknown>;
     };
     /**
-     * Disconnect by clearing stored credentials and stopping the pull loop.
+     * Disconnect by clearing stored credentials.
      */
     disconnect(): Promise<void>;
     /**
-     * Start the Pub/Sub pull loop that periodically fetches messages.
-     */
-    private startPubSubPull;
-    /**
-     * Stop the Pub/Sub pull loop.
-     */
-    private stopPubSubPull;
-    /**
-     * Pull messages from the Pub/Sub subscription, process them, and acknowledge.
+     * Add an emoji reaction to a Google Chat message.
      *
-     * Each message is a base64-encoded Google Chat event JSON. Only MESSAGE-type
-     * events are forwarded to the incoming message callback. All messages are
-     * acknowledged regardless of type to prevent redelivery.
-     */
-    pullMessages(): Promise<number>;
-    /**
-     * Process a Google Chat event and forward MESSAGE events to the callback.
-     *
-     * Supports two payload formats:
-     * - **Legacy (v1)**: `{ type: 'MESSAGE', message: { text, sender, thread }, space }`
-     * - **v2**: `{ commonEventObject: {...}, chat: { messagePayload: { message: {...}, space: {...} } } }`
-     *
-     * Both formats are normalized into the same IncomingMessage shape.
-     *
-     * @param event - Parsed Google Chat event payload (legacy or v2)
-     */
-    private processChatEvent;
-    /**
-     * Acknowledge processed messages to prevent redelivery.
+     * Only works in service account mode — webhook mode does not support the
+     * reactions API. Calls `spaces.messages.reactions.create`.
      *
-     * @param ackIds - Array of ack IDs from the pull response
+     * @param messageName - Full message resource name (e.g., "spaces/xxx/messages/yyy")
+     * @param emoji - Unicode emoji character (e.g., "👀", "✅")
      */
-    private acknowledgeMessages;
+    addReaction(messageName: string, emoji: string): Promise<void>;
     /**
      * Send a message via incoming webhook URL.
      *
@@ -169,110 +83,18 @@ export declare class GoogleChatMessengerAdapter implements MessengerAdapter {
     /**
      * Send a message via the Google Chat REST API using service account credentials.
      *
-     * When a threadId (thread name) is provided, the reply is posted to the same
-     * thread. This enables conversational thread tracking for Pub/Sub mode.
-     *
      * @param space - Space name (e.g., "spaces/AAAA...")
      * @param text - Message text
-     * @param threadName - Optional full thread name (e.g., "spaces/SPACE/threads/THREAD")
+     * @param threadKey - Optional thread key for threaded replies
      */
     private sendViaApi;
-    /**
-     * Split a message into chunks that fit within Google Chat's character limit.
-     *
-     * Splits on double-newline paragraph boundaries when possible. Falls back to
-     * single-newline, then hard truncation at maxLength.
-     *
-     * @param text - The full message text to split
-     * @param maxLength - Maximum characters per chunk (default 4000)
-     * @returns Array of text chunks, each within maxLength
-     */
-    static splitMessage(text: string, maxLength?: number): string[];
     /**
      * Get a valid access token, refreshing if needed.
      *
-     * Uses JWT-based OAuth2 for service accounts, or refresh_token flow for ADC.
-     * The scope includes Pub/Sub when in pubsub mode.
+     * Uses a simplified JWT-based OAuth2 flow for service accounts.
      *
      * @returns Valid access token string
      */
-    getAccessToken(): Promise<string>;
-    /**
-     * Perform the actual token refresh.
-     *
-     * Dispatches to the appropriate flow based on authMode:
-     * - `service_account`: JWT-based OAuth2 flow with SA private key
-     * - `adc`: Refresh token flow using ADC credentials
-     *
-     * @returns Fresh access token string
-     */
-    private refreshAccessToken;
-    /**
-     * Refresh access token via JWT-based OAuth2 flow (service account).
-     *
-     * @returns Fresh access token string
-     */
-    private refreshAccessTokenViaJwt;
-    /**
-     * Refresh access token via ADC (Application Default Credentials).
-     *
-     * Uses the refresh_token from the ADC JSON file to obtain a new access token
-     * from Google's OAuth2 token endpoint. This supports credentials created by
-     * `gcloud auth application-default login`.
-     *
-     * When `serviceAccountEmail` is configured, the ADC user token is used to
-     * impersonate the service account via the IAM Credentials API, producing a
-     * token with `chat.bot` and `pubsub` scopes that the Chat API accepts.
-     *
-     * @returns Fresh access token string (impersonated SA token if configured, else user token)
-     */
-    private refreshAccessTokenViaAdc;
-    /**
-     * Impersonate a service account using the IAM Credentials API.
-     *
-     * Uses the user's ADC access token to call `generateAccessToken` on the
-     * target service account, producing a token with `chat.bot` and `pubsub`
-     * scopes. The user must have the `Service Account Token Creator` IAM role.
-     *
-     * @param userToken - ADC user access token for authorization
-     * @returns Impersonated service account access token
-     * @throws Error if impersonation fails (e.g., missing IAM role)
-     */
-    private impersonateServiceAccount;
-    /**
-     * Build auth headers for Google API requests.
-     *
-     * When using ADC auth mode, adds x-goog-user-project header to set the
-     * billing/quota project. Without this header, ADC requests fail with
-     * 403 PERMISSION_DENIED because Google cannot determine which project
-     * should be billed for the API usage.
-     *
-     * @param token - OAuth2 access token
-     * @returns Headers object with Authorization, Content-Type, and optional quota project
-     */
-    private getAuthHeaders;
-    /**
-     * Validate a service account key JSON string.
-     *
-     * @param key - JSON string of the service account key
-     * @throws Error if the key is invalid
-     */
-    private validateServiceAccountKey;
-    /**
-     * Load ADC (Application Default Credentials) from the filesystem.
-     *
-     * Checks (in order):
-     * 1. `GOOGLE_APPLICATION_CREDENTIALS` environment variable (custom path)
-     * 2. Default gcloud ADC path: `~/.config/gcloud/application_default_credentials.json`
-     *
-     * @returns Parsed ADC credentials
-     * @throws Error if the ADC file is not found or invalid
-     */
-    loadAdcCredentials(): Promise<AdcCredentials>;
-    /**
-     * Reset all internal state to defaults.
-     */
-    private resetState;
+    private getAccessToken;
 }
-export {};
 //# sourceMappingURL=google-chat-messenger.adapter.d.ts.map

package/dist/backend/backend/src/services/messaging/adapters/google-chat-messenger.adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-chat-messenger.adapter.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/messaging/adapters/google-chat-messenger.adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"google-chat-messenger.adapter.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/messaging/adapters/google-chat-messenger.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAKxF;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAiB;IAErD,sDAAsD;IACtD,OAAO,CAAC,UAAU,CAAuB;IAEzC,sDAAsD;IACtD,OAAO,CAAC,iBAAiB,CAAuB;IAEhD,0DAA0D;IAC1D,OAAO,CAAC,WAAW,CAAuB;IAE1C,oCAAoC;IACpC,OAAO,CAAC,cAAc,CAAK;IAE3B;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyChE;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAchG;;;;OAIG;IACH,SAAS,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAWnG;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;;;OAQG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCpE;;;;;OAKG;YACW,cAAc;IA8B5B;;;;;;OAMG;YACW,UAAU;IAmCxB;;;;;;OAMG;YACW,cAAc;CAkD7B"}