piece-signal-cli-rest-api 0.2.0 → 0.2.1

package/src/lib/actions/list-groups.ts

@@ -1,32 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { GroupEntry } from '../common/types';
-import { formatPhoneNumber } from '../common/utils';
-
-export const listGroups = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'listGroups',
-	displayName: 'List Groups',
-	description: 'List all Signal groups for a registered number',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format',
-			required: true,
-		}),
-	},
-	async run(context) {
-		const { number } = context.propsValue;
-		// Auth props are passed directly to API client
-
-		const apiClient = new SignalCliApiClient(context.auth.props);
-		const formattedNumber = formatPhoneNumber(number);
-
-		const response = await apiClient.get<GroupEntry[]>(
-			`/v1/groups/${encodeURIComponent(formattedNumber)}`
-		);
-
-		return response;
-	},
-});

package/src/lib/actions/list-identities.ts

@@ -1,32 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { IdentityEntry } from '../common/types';
-import { formatPhoneNumber } from '../common/utils';
-
-export const listIdentities = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'listIdentities',
-	displayName: 'List Identities',
-	description: 'List all identities for a registered number',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format',
-			required: true,
-		}),
-	},
-	async run(context) {
-		const { number } = context.propsValue;
-		// Auth props are passed directly to API client
-
-		const apiClient = new SignalCliApiClient(context.auth.props);
-		const formattedNumber = formatPhoneNumber(number);
-
-		const response = await apiClient.get<IdentityEntry[]>(
-			`/v1/identities/${encodeURIComponent(formattedNumber)}`
-		);
-
-		return response;
-	},
-});

package/src/lib/actions/quit-group.ts

@@ -1,36 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { formatPhoneNumber } from '../common/utils';
-
-export const quitGroup = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'quitGroup',
-	displayName: 'Quit Group',
-	description: 'Quit a Signal group',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format',
-			required: true,
-		}),
-		groupid: Property.ShortText({
-			displayName: 'Group ID',
-			description: 'Group ID (base64 encoded)',
-			required: true,
-		}),
-	},
-	async run(context) {
-		const { number, groupid } = context.propsValue;
-		// Auth props are passed directly to API client
-
-		const apiClient = new SignalCliApiClient(context.auth.props);
-		const formattedNumber = formatPhoneNumber(number);
-
-		await apiClient.post(
-			`/v1/groups/${encodeURIComponent(formattedNumber)}/${encodeURIComponent(groupid)}/quit`
-		);
-
-		return { success: true };
-	},
-});

package/src/lib/actions/receive-messages.ts

@@ -1,108 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { formatPhoneNumber } from '../common/utils';
-import {
-	tryWebSocketReceive,
-	tryHttpReceive,
-	tryResumeApprovalFlow,
-	SignalMessage,
-} from '../common/message-utils';
-
-export const receiveMessages = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'receiveMessages',
-	displayName: 'Receive Messages',
-	description: 'Receive new messages from Signal. Automatically resumes approval flows if a message is a reaction to an approval request. Can be called manually, e.g., from a webhook or scheduler.',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format (e.g., +43123456789)',
-			required: true,
-		}),
-		timeout: Property.Number({
-			displayName: 'Timeout (seconds)',
-			description: 'Receive timeout in seconds (default: 1)',
-			required: false,
-			defaultValue: 1,
-		}),
-		ignore_attachments: Property.Checkbox({
-			displayName: 'Ignore Attachments',
-			description: 'Ignore attachments when receiving messages',
-			required: false,
-			defaultValue: false,
-		}),
-		ignore_stories: Property.Checkbox({
-			displayName: 'Ignore Stories',
-			description: 'Ignore stories when receiving messages',
-			required: false,
-			defaultValue: false,
-		}),
-		max_messages: Property.Number({
-			displayName: 'Max Messages',
-			description: 'Maximum number of messages to receive (default: unlimited)',
-			required: false,
-		}),
-		send_read_receipts: Property.Checkbox({
-			displayName: 'Send Read Receipts',
-			description: 'Automatically send read receipts when receiving messages',
-			required: false,
-			defaultValue: false,
-		}),
-	},
-	async run(context) {
-		const { baseUrl, useBasicAuth, basicAuthUsername, basicAuthPassword, mode = 'normal' } = context.auth.props;
-		const { number, timeout = 1, ignore_attachments = false, ignore_stories = false, max_messages, send_read_receipts = false } = context.propsValue;
-
-		const formattedNumber = formatPhoneNumber(number);
-
-		// Build query parameters
-		const queryParams = new URLSearchParams();
-		queryParams.append('timeout', timeout.toString());
-		queryParams.append('ignore_attachments', ignore_attachments.toString());
-		queryParams.append('ignore_stories', ignore_stories.toString());
-		if (max_messages) {
-			queryParams.append('max_messages', max_messages.toString());
-		}
-		queryParams.append('send_read_receipts', send_read_receipts.toString());
-
-		const baseUrlClean = baseUrl.replace(/\/$/, '');
-		const httpUrl = `${baseUrlClean}/v1/receive/${encodeURIComponent(formattedNumber)}?${queryParams.toString()}`;
-
-		// Build headers
-		const headers: Record<string, string> = {};
-
-		// Add Basic Auth header if configured
-		if (useBasicAuth && basicAuthUsername && basicAuthPassword) {
-			const credentials = Buffer.from(
-				`${basicAuthUsername}:${basicAuthPassword}`
-			).toString('base64');
-			headers['Authorization'] = `Basic ${credentials}`;
-		}
-
-		// Use the configured mode to determine which method to use
-		let messages: SignalMessage[];
-		if (mode === 'json-rpc') {
-			// Use WebSocket for json-rpc mode
-			messages = await tryWebSocketReceive(httpUrl, headers, timeout, max_messages);
-		} else {
-			// Use HTTP GET for normal/native mode
-			messages = await tryHttpReceive(httpUrl, headers);
-		}
-
-		// Process each message: try to resume approval flows if applicable
-		// Messages are still returned regardless of whether they triggered a resume
-		// Debug information is output via console.log (visible in Docker logs)
-		const apiUrl = context.server?.apiUrl || '';
-		
-		for (const message of messages) {
-			// This will output debug info via console.log
-			await tryResumeApprovalFlow(message, context.store, apiUrl);
-		}
-
-		// Return messages
-		return {
-			messages,
-			count: messages.length,
-		};
-	},
-});

package/src/lib/actions/remote-delete-message.ts

@@ -1,56 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { formatPhoneNumber } from '../common/utils';
-
-interface RemoteDeleteRequest {
-	recipient: string;
-	timestamp: number;
-}
-
-interface RemoteDeleteResponse {
-	timestamp: string;
-}
-
-export const remoteDeleteMessage = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'remoteDeleteMessage',
-	displayName: 'Remote Delete Message',
-	description: 'Delete a message remotely',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format',
-			required: true,
-		}),
-		recipient: Property.ShortText({
-			displayName: 'Recipient',
-			description: 'Phone number or group ID of the recipient',
-			required: true,
-		}),
-		timestamp: Property.Number({
-			displayName: 'Timestamp',
-			description: 'Timestamp of the message to delete',
-			required: true,
-		}),
-	},
-	async run(context) {
-		const { number, recipient, timestamp } = context.propsValue;
-		// Auth props are passed directly to API client
-
-		const apiClient = new SignalCliApiClient(context.auth.props);
-		const formattedNumber = formatPhoneNumber(number);
-
-		const requestBody: RemoteDeleteRequest = {
-			recipient,
-			timestamp,
-		};
-
-		const response = await apiClient.delete<RemoteDeleteResponse>(
-			`/v1/remote-delete/${encodeURIComponent(formattedNumber)}`,
-			requestBody
-		);
-
-		return response;
-	},
-});

package/src/lib/actions/remove-admins-from-group.ts

@@ -1,50 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { formatPhoneNumber } from '../common/utils';
-
-interface ChangeGroupAdminsRequest {
-	admins: string[];
-}
-
-export const removeAdminsFromGroup = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'removeAdminsFromGroup',
-	displayName: 'Remove Admins from Group',
-	description: 'Remove one or more admins from a Signal group',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format',
-			required: true,
-		}),
-		groupid: Property.ShortText({
-			displayName: 'Group ID',
-			description: 'Group ID (base64 encoded)',
-			required: true,
-		}),
-		admins: Property.Array({
-			displayName: 'Admins',
-			description: 'Array of phone numbers to remove as admins',
-			required: true,
-		}),
-	},
-	async run(context) {
-		const { number, groupid, admins } = context.propsValue;
-		// Auth props are passed directly to API client
-
-		const apiClient = new SignalCliApiClient(context.auth.props);
-		const formattedNumber = formatPhoneNumber(number);
-
-		const requestBody: ChangeGroupAdminsRequest = {
-			admins: admins as string[],
-		};
-
-		await apiClient.delete(
-			`/v1/groups/${encodeURIComponent(formattedNumber)}/${encodeURIComponent(groupid)}/admins`,
-			requestBody
-		);
-
-		return { success: true };
-	},
-});

package/src/lib/actions/remove-device.ts

@@ -1,36 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { formatPhoneNumber } from '../common/utils';
-
-export const removeDevice = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'removeDevice',
-	displayName: 'Remove Device',
-	description: 'Remove a linked device from the primary account',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format',
-			required: true,
-		}),
-		deviceId: Property.Number({
-			displayName: 'Device ID',
-			description: 'Device ID from listDevices',
-			required: true,
-		}),
-	},
-	async run(context) {
-		const { number, deviceId } = context.propsValue;
-		// Auth props are passed directly to API client
-
-		const apiClient = new SignalCliApiClient(context.auth.props);
-		const formattedNumber = formatPhoneNumber(number);
-
-		await apiClient.delete(
-			`/v1/devices/${encodeURIComponent(formattedNumber)}/${deviceId}`
-		);
-
-		return { success: true };
-	},
-});

package/src/lib/actions/remove-members-from-group.ts

@@ -1,50 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { formatPhoneNumber } from '../common/utils';
-
-interface ChangeGroupMembersRequest {
-	members: string[];
-}
-
-export const removeMembersFromGroup = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'removeMembersFromGroup',
-	displayName: 'Remove Members from Group',
-	description: 'Remove one or more members from a Signal group',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format',
-			required: true,
-		}),
-		groupid: Property.ShortText({
-			displayName: 'Group ID',
-			description: 'Group ID (base64 encoded)',
-			required: true,
-		}),
-		members: Property.Array({
-			displayName: 'Members',
-			description: 'Array of phone numbers to remove',
-			required: true,
-		}),
-	},
-	async run(context) {
-		const { number, groupid, members } = context.propsValue;
-		// Auth props are passed directly to API client
-
-		const apiClient = new SignalCliApiClient(context.auth.props);
-		const formattedNumber = formatPhoneNumber(number);
-
-		const requestBody: ChangeGroupMembersRequest = {
-			members: members as string[],
-		};
-
-		await apiClient.delete(
-			`/v1/groups/${encodeURIComponent(formattedNumber)}/${encodeURIComponent(groupid)}/members`,
-			requestBody
-		);
-
-		return { success: true };
-	},
-});

package/src/lib/actions/remove-reaction.ts

@@ -1,59 +0,0 @@
-import { createAction, Property } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { formatPhoneNumber } from '../common/utils';
-
-interface ReactionRequest {
-	recipient: string;
-	target_author: string;
-	timestamp: number;
-}
-
-export const removeReaction = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'removeReaction',
-	displayName: 'Remove Reaction',
-	description: 'Remove a reaction from a message',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format',
-			required: true,
-		}),
-		recipient: Property.ShortText({
-			displayName: 'Recipient',
-			description: 'Phone number or group ID of the recipient',
-			required: true,
-		}),
-		target_author: Property.ShortText({
-			displayName: 'Target Author',
-			description: 'Phone number of the message author',
-			required: true,
-		}),
-		timestamp: Property.Number({
-			displayName: 'Timestamp',
-			description: 'Timestamp of the message',
-			required: true,
-		}),
-	},
-	async run(context) {
-		const { number, recipient, target_author, timestamp } = context.propsValue;
-		// Auth props are passed directly to API client
-
-		const apiClient = new SignalCliApiClient(context.auth.props);
-		const formattedNumber = formatPhoneNumber(number);
-
-		const requestBody: ReactionRequest = {
-			recipient,
-			target_author,
-			timestamp,
-		};
-
-		await apiClient.delete(
-			`/v1/reactions/${encodeURIComponent(formattedNumber)}`,
-			requestBody
-		);
-
-		return { success: true };
-	},
-});

package/src/lib/actions/request-approval-message.ts

@@ -1,215 +0,0 @@
-import { createAction, Property, StoreScope } from '@activepieces/pieces-framework';
-import { signalCliRestApiAuth } from '../common/auth';
-import { SignalCliApiClient } from '../common/api-client';
-import { SendMessageV2Request, SendMessageResponse } from '../common/types';
-import { formatPhoneNumber, commonProps } from '../common/utils';
-import { ExecutionType, PauseType } from '@activepieces/shared';
-import { assertNotNullOrUndefined } from '@activepieces/shared';
-
-interface ApprovalMapping {
-	flowRunId: string;
-	requestId: string;
-	approveEmoji: string;
-	disapproveEmoji: string;
-	targetAuthor: string;
-	messageTimestamp: number;
-	timeoutSeconds: number;
-	createdAt: number;
-}
-
-export const requestApprovalMessage = createAction({
-	auth: signalCliRestApiAuth,
-	name: 'request_approval_message',
-	displayName: 'Request Approval (Signal)',
-	description: 'Send an approval message via Signal and wait for a reaction response. This action sends a message and pauses the flow until the recipient reacts with an approve or disapprove emoji.',
-	props: {
-		number: Property.ShortText({
-			displayName: 'Phone Number',
-			description: 'Registered phone number in international format (e.g., +43123456789). If not provided, uses the default number from the connection.',
-			required: false,
-		}),
-		recipients: commonProps.recipients,
-		message: commonProps.message,
-		approve_emoji: Property.ShortText({
-			displayName: 'Approve Emoji',
-			description: 'Emoji for approval (e.g., 👍)',
-			required: false,
-			defaultValue: '👍',
-		}),
-		disapprove_emoji: Property.ShortText({
-			displayName: 'Disapprove Emoji',
-			description: 'Emoji for disapproval (e.g., 👎)',
-			required: false,
-			defaultValue: '👎',
-		}),
-		timeout_seconds: Property.Number({
-			displayName: 'Timeout (seconds)',
-			description: 'Timeout in seconds after which the approval expires (default: 86400 = 24 hours)',
-			required: false,
-			defaultValue: 86400,
-		}),
-	},
-	async run(context) {
-		if (context.executionType === ExecutionType.BEGIN) {
-			const { number, recipients, message, approve_emoji = '👍', disapprove_emoji = '👎', timeout_seconds = 86400 } = context.propsValue;
-
-			assertNotNullOrUndefined(message, 'message');
-			assertNotNullOrUndefined(recipients, 'recipients');
-
-			const apiClient = new SignalCliApiClient(context.auth.props);
-
-			// Use number from props or fallback to default from connection
-			const phoneNumber = number || context.auth.props.defaultNumber;
-			if (!phoneNumber) {
-				throw new Error('Phone number is required. Please provide it in the action or set a default in the connection settings.');
-			}
-
-			const formattedNumber = formatPhoneNumber(phoneNumber);
-
-			// Generate resume URL to extract requestId
-			const resumeUrl = context.generateResumeUrl({
-				queryParams: { action: 'approve' },
-			});
-
-			// Extract requestId from URL: /v1/flow-runs/{flowRunId}/requests/{requestId}
-			const urlMatch = resumeUrl.match(/\/flow-runs\/[^/]+\/requests\/([^/?]+)/);
-			if (!urlMatch || !urlMatch[1]) {
-				throw new Error('Failed to extract requestId from resume URL');
-			}
-			const requestId = urlMatch[1];
-
-			// Prepare request body - send message exactly as user entered it
-			const requestBody: SendMessageV2Request = {
-				number: formattedNumber,
-				recipients: recipients as string[],
-				message: message || '',
-			};
-
-			// Send the message
-			const response = await apiClient.post<SendMessageResponse>('/v2/send', requestBody);
-
-			// Extract messageTimestamp from response
-			// Signal API returns timestamp in milliseconds as a string, convert to seconds (Unix timestamp)
-			const timestampMs = typeof response.timestamp === 'string' 
-				? parseInt(response.timestamp, 10) 
-				: Math.floor(response.timestamp);
-			const messageTimestamp = Math.floor(timestampMs / 1000); // Convert milliseconds to seconds
-
-			// targetAuthor is the phone number of the sender
-			const targetAuthor = formattedNumber;
-			const createdAt = Math.floor(Date.now() / 1000); // Unix timestamp in seconds
-
-			// Create store key
-			const storeKey = `approval:${messageTimestamp}:${targetAuthor}`;
-
-			// DEBUG: Log storing approval mapping
-			console.log('[RequestApprovalMessage] DEBUG - Storing approval mapping:', {
-				storeKey,
-				timestampMs,
-				messageTimestamp,
-				targetAuthor,
-				formattedNumber,
-				flowRunId: context.run.id,
-				requestId,
-				responseTimestamp: response.timestamp,
-				responseTimestampType: typeof response.timestamp
-			});
-
-			// Create mapping value
-			const mapping: ApprovalMapping = {
-				flowRunId: context.run.id,
-				requestId: requestId,
-				approveEmoji: approve_emoji,
-				disapproveEmoji: disapprove_emoji,
-				targetAuthor: targetAuthor,
-				messageTimestamp: messageTimestamp,
-				timeoutSeconds: timeout_seconds,
-				createdAt: createdAt,
-			};
-
-			// DEBUG: Log full mapping
-			console.log('[RequestApprovalMessage] DEBUG - Full mapping object:', mapping);
-
-			// Save mapping in Store (PROJECT-scoped)
-			await context.store.put(storeKey, mapping, StoreScope.PROJECT);
-
-			// DEBUG: Verify it was stored
-			const verifyMapping = await context.store.get<ApprovalMapping>(storeKey, StoreScope.PROJECT);
-			console.log('[RequestApprovalMessage] DEBUG - Verified stored mapping:', verifyMapping);
-
-			// Add key to approval keys list
-			const keysListKey = 'approval:keys';
-			const existingKeys = (await context.store.get<string[]>(keysListKey, StoreScope.PROJECT)) || [];
-			if (!existingKeys.includes(storeKey)) {
-				existingKeys.push(storeKey);
-				await context.store.put(keysListKey, existingKeys, StoreScope.PROJECT);
-			}
-
-			// Also save mapping from flowRunId to storeKey for easy lookup in RESUME phase
-			const flowRunMappingKey = `approval:flowRun:${context.run.id}`;
-			await context.store.put(flowRunMappingKey, storeKey, StoreScope.PROJECT);
-
-			const output = {
-				messageTimestamp,
-				targetAuthor,
-				flowRunId: context.run.id,
-				requestId,
-				debug: {
-					timestampMs,
-					messageTimestamp,
-					storeKey,
-					formattedNumber,
-					responseTimestamp: response.timestamp,
-					responseTimestampType: typeof response.timestamp,
-					approveEmoji: approve_emoji,
-					disapproveEmoji: disapprove_emoji,
-					timeoutSeconds: timeout_seconds,
-					createdAt,
-					mapping: mapping,
-					verifiedMapping: verifyMapping,
-				},
-			};
-
-			// Pause the flow and wait for approval
-			context.run.pause({
-				pauseMetadata: {
-					type: PauseType.WEBHOOK,
-					response: {},
-				},
-			});
-
-			return output;
-		} else {
-			// RESUME-Phase: Flow was resumed by Resume-Action
-			const action = context.resumePayload.queryParams['action'];
-			const approved = action === 'approve';
-
-			// Find the storeKey for this flowRunId
-			const flowRunMappingKey = `approval:flowRun:${context.run.id}`;
-			const storeKey = await context.store.get<string>(flowRunMappingKey, StoreScope.PROJECT);
-
-			if (storeKey) {
-				// Delete mapping from Store
-				await context.store.delete(storeKey, StoreScope.PROJECT);
-
-				// Delete flowRunId mapping
-				await context.store.delete(flowRunMappingKey, StoreScope.PROJECT);
-
-				// Remove key from approval keys list
-				const keysListKey = 'approval:keys';
-				const existingKeys = (await context.store.get<string[]>(keysListKey, StoreScope.PROJECT)) || [];
-				const updatedKeys = existingKeys.filter(key => key !== storeKey);
-				await context.store.put(keysListKey, updatedKeys, StoreScope.PROJECT);
-			}
-
-			return {
-				approved,
-				debug: {
-					action,
-					storeKey: storeKey || null,
-					flowRunId: context.run.id,
-				},
-			};
-		}
-	},
-});