@divyacon/piece-twilio 0.0.0-stage → 0.1.0

package/dist/lib/trigger/new-transcription.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.twilioNewTranscription = void 0;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/twilio/src/lib/trigger/new-transcription.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+const pieces_common_1 = require("@agnocon/pieces-common");
+const __1 = require("../..");
+const polling = {
+    strategy: pieces_common_1.DedupeStrategy.TIMEBASED,
+    items(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ auth, lastFetchEpochMS }) {
+            var _b, _c;
+            const isTest = lastFetchEpochMS === 0;
+            const account_sid = auth.username;
+            const auth_token = auth.password;
+            let currentUri = `/2010-04-01/Accounts/${account_sid}/Transcriptions.json?PageSize=${isTest ? 10 : 1000}`;
+            const results = [];
+            let stop = false;
+            do {
+                const response = yield pieces_common_1.httpClient.sendRequest({
+                    method: pieces_common_1.HttpMethod.GET,
+                    url: `https://api.twilio.com${currentUri}`,
+                    authentication: {
+                        type: pieces_common_1.AuthenticationType.BASIC,
+                        username: account_sid,
+                        password: auth_token,
+                    },
+                });
+                const payload = response.body;
+                const transcriptions = (_b = payload.transcriptions) !== null && _b !== void 0 ? _b : [];
+                for (const recording of transcriptions) {
+                    const ts = new Date(recording.date_created).getTime();
+                    if (recording.status !== 'completed')
+                        continue;
+                    if (isTest || ts > lastFetchEpochMS) {
+                        results.push(recording);
+                    }
+                    else {
+                        stop = true;
+                        break;
+                    }
+                }
+                if (isTest)
+                    break;
+                currentUri = (_c = payload === null || payload === void 0 ? void 0 : payload.next_page_uri) !== null && _c !== void 0 ? _c : null;
+            } while (currentUri && !stop);
+            return results.map((recording) => {
+                return {
+                    epochMilliSeconds: new Date(recording.date_created).getTime(),
+                    data: recording,
+                };
+            });
+        });
+    },
+};
+exports.twilioNewTranscription = (0, pieces_framework_1.createTrigger)({
+    auth: __1.twilioAuth,
+    name: 'new_transcription',
+    displayName: 'New Transcription',
+    description: 'Triggers when a new call recording transcription is completed.',
+    aiMetadata: {
+        description: 'Fires when a call recording transcription reaches completed status on the Twilio account. Each event represents one finished transcription tied to a recording, including its transcribed text.',
+    },
+    props: {},
+    sampleData: {
+        "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "api_version": "2008-08-01",
+        "date_created": "Thu, 25 Aug 2011 20:59:45 +0000",
+        "date_updated": "Thu, 25 Aug 2011 20:59:45 +0000",
+        "duration": "10",
+        "price": "0.00000",
+        "price_unit": "USD",
+        "recording_sid": "REaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "sid": "TRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "status": "completed",
+        "transcription_text": null,
+        "type": "fast",
+        "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Transcriptions/TRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json"
+    },
+    type: pieces_framework_1.TriggerStrategy.POLLING,
+    onEnable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            yield pieces_common_1.pollingHelper.onEnable(polling, {
+                auth: context.auth,
+                store: context.store,
+                propsValue: context.propsValue,
+            });
+        });
+    },
+    onDisable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            yield pieces_common_1.pollingHelper.onDisable(polling, {
+                auth: context.auth,
+                store: context.store,
+                propsValue: context.propsValue,
+            });
+        });
+    },
+    test(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return yield pieces_common_1.pollingHelper.test(polling, context);
+        });
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return yield pieces_common_1.pollingHelper.poll(polling, context);
+        });
+    },
+});
+//# sourceMappingURL=new-transcription.js.map

package/dist/lib/trigger/new-transcription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-transcription.js","sourceRoot":"","sources":["../../../src/lib/trigger/new-transcription.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@divyacon/piece-twilio",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "DivyaCon twilio connector",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE.MIT-AP"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "vendor": "node ../scripts/vendor-ap.mjs piece-twilio"
+  },
+  "dependencies": {
+    "@agnocon/core-utils": "0.2.0",
+    "@agnocon/piece-types": "0.3.1",
+    "@agnocon/pieces-common": "0.12.8",
+    "@agnocon/pieces-framework": "0.36.0",
+    "tslib": "2.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "20.17.6",
+    "typescript": "5.5.4"
+  },
+  "license": "MIT",
+  "agnocon": {
+    "originVersion": "0.4.8"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "keywords": [
+    "agnocon",
+    "connector"
+  ]
 }

package/src/index.ts

@@ -0,0 +1,63 @@
+import { createCustomApiCallAction } from '@agnocon/pieces-common';
+import { PieceAuth, createPiece } from '@agnocon/pieces-framework';
+import { PieceCategory } from '@agnocon/pieces-framework';
+import { twilioSendSms } from './lib/action/send-sms';
+import { twilioNewIncomingSms } from './lib/trigger/new-incoming-sms';
+import { twilioPhoneNumberLookup } from './lib/action/phone-number-lookup';
+import { twilioMakeCall } from './lib/action/make-call';
+import { twilioGetMessage } from './lib/action/get-message';
+import { twilioDownloadRecordingMedia } from './lib/action/download-recording-media';
+import { twilioNewPhoneNumber } from './lib/trigger/new-phone-number';
+import { twilioNewRecording } from './lib/trigger/new-recording';
+import { twilioNewTranscription } from './lib/trigger/new-transcription';
+import { twilioNewCall } from './lib/trigger/new-call';
+
+export const twilioAuth = PieceAuth.BasicAuth({
+  description: 'The authentication to use to connect to Twilio',
+
+  required: true,
+  username: {
+    displayName: 'Account SID',
+    description: 'The account SID to use to connect to Twilio',
+  },
+  password: {
+    displayName: 'Auth token',
+    description: 'The auth token to use to connect to Twilio',
+  },
+});
+
+export const twilio = createPiece({
+  displayName: 'Twilio',
+  description:
+    'Cloud communications platform for building SMS, Voice & Messaging applications',
+
+  minimumSupportedRelease: '0.30.0',
+  logoUrl: 'https://cdn.activepieces.com/pieces/twilio.png',
+  auth: twilioAuth,
+  categories: [PieceCategory.COMMUNICATION],
+  actions: [
+    twilioSendSms,
+    twilioPhoneNumberLookup,
+    twilioMakeCall,
+    twilioGetMessage,
+    twilioDownloadRecordingMedia,
+    createCustomApiCallAction({
+      baseUrl: () => 'https://api.twilio.com/2010-04-01',
+      auth: twilioAuth,
+      authMapping: async (auth) => ({
+        Authorization: `Basic ${Buffer.from(
+          `${auth.username}:${
+            auth.password
+          }`
+        ).toString('base64')}`,
+      }),
+    }),
+  ],
+  authors: ["kishanprmr","MoShizzle","khaledmashaly","abuaboud"],
+  triggers: [twilioNewIncomingSms,
+    twilioNewPhoneNumber,
+    twilioNewRecording,
+    twilioNewTranscription,
+    twilioNewCall
+  ],
+});

package/src/lib/action/download-recording-media.ts

@@ -0,0 +1,74 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { HttpMethod, httpClient, AuthenticationType, QueryParams } from '@agnocon/pieces-common';
+import { twilioAuth } from '../..';
+
+export const twilioDownloadRecordingMedia = createAction({
+  auth: twilioAuth,
+  name: 'download_recording_media',
+  displayName: 'Download Recording Media',
+  description: 'Download the media file for a specific recording.',
+  audience: 'both',
+  aiMetadata: { description: 'Downloads the audio file for a specific Twilio call recording by its SID, returning it as a file (MP3 or WAV). Use to retrieve recorded call audio for storage or further processing; requires the recording SID (starting with "RE"). Read-only and idempotent.', idempotent: true },
+  props: {
+    recording_sid: Property.ShortText({
+      displayName: 'Recording SID',
+      description: 'The unique identifier (SID) of the recording to download. It starts with "RE".',
+      required: true,
+    }),
+    format: Property.StaticDropdown({
+      displayName: 'Format',
+      description: 'The desired audio format for the download file.',
+      required: false,
+      defaultValue: 'mp3',
+      options: {
+        options: [
+          { label: 'MP3', value: 'mp3' },
+          { label: 'WAV', value: 'wav' },
+        ],
+      },
+    }),
+    channels: Property.StaticDropdown({
+        displayName: 'Channels',
+        description: 'Specify whether to download a mono or dual-channel file. Note: Dual-channel may not be available for all recordings.',
+        required: false,
+        options: {
+            options: [
+                { label: 'Mono', value: 1 },
+                { label: 'Dual', value: 2 },
+            ]
+        }
+    })
+  },
+  async run(context) {
+    const { recording_sid, format, channels } = context.propsValue;
+    const account_sid = context.auth.username;
+    const auth_token = context.auth.password;
+
+    const fileFormat = format ?? 'mp3';
+    const path = `Recordings/${recording_sid}.${fileFormat}`;
+
+    const queryParams: QueryParams = {};
+    if (channels) {
+        queryParams['RequestedChannels'] = channels.toString();
+    }
+
+    const response = await httpClient.sendRequest<ArrayBuffer>({
+      method: HttpMethod.GET,
+      url: `https://api.twilio.com/2010-04-01/Accounts/${account_sid}/${path}`,
+      queryParams: queryParams,
+      authentication: {
+        type: AuthenticationType.BASIC,
+        username: account_sid,
+        password: auth_token,
+      },
+      responseType: 'arraybuffer',
+    });
+
+    const fileData = Buffer.from(response.body);
+
+    return await context.files.write({
+      fileName: `${recording_sid}.${fileFormat}`,
+      data: fileData,
+    });
+  },
+});

package/src/lib/action/get-message.ts

@@ -0,0 +1,35 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { HttpMethod } from '@agnocon/pieces-common';
+import { callTwilioApi } from '../common';
+import { twilioAuth } from '../..';
+
+export const twilioGetMessage = createAction({
+  auth: twilioAuth,
+  name: 'get_message',
+  description: 'Retrieves the details of a specific message.',
+  audience: 'both',
+  aiMetadata: { description: 'Fetches the full details and status of a single Twilio message by its SID. Use to check delivery status or inspect a known message; requires the message SID (starting with "SM" or "MM"). Read-only and idempotent.', idempotent: true },
+  displayName: 'Get Message',
+  props: {
+    message_sid: Property.ShortText({
+      displayName: 'Message SID',
+      description: 'The unique identifier (SID) of the message to retrieve. It starts with "SM" or "MM".',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const { message_sid } = context.propsValue;
+    const account_sid = context.auth.username;
+    const auth_token = context.auth.password;
+
+    const path = `Messages/${message_sid}.json`;
+
+    const response =  await callTwilioApi(
+      HttpMethod.GET,
+      path,
+      { account_sid, auth_token }
+    );
+
+    return response.body;
+  },
+});

package/src/lib/action/make-call.ts

@@ -0,0 +1,101 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { HttpMethod } from '@agnocon/pieces-common';
+import { callTwilioApi, twilioCommon } from '../common';
+import { twilioAuth } from '../..';
+
+export const twilioMakeCall = createAction({
+  auth: twilioAuth,
+  name: 'make_call',
+  description: 'Call a number and say a message.',
+  audience: 'both',
+  aiMetadata: { description: 'Places an outbound voice call from a Twilio number that reads a text-to-speech message to the recipient. Use to deliver a spoken notification or alert by phone. Requires both numbers in E.164 format and the message text; each call places a real, billable phone call, so it is not idempotent.', idempotent: false },
+  displayName: 'Call Phone',
+  props: {
+    from: twilioCommon.phone_number,
+    to: Property.ShortText({
+      displayName: 'To',
+      description: 'The phone number to call. Must be in E.164 format (e.g., +15558675310).',
+      required: true,
+    }),
+    message: Property.LongText({
+      displayName: 'Message to Say',
+      description: 'The text message to be converted to speech and spoken to the recipient.',
+      required: true,
+    }),
+    voice: Property.StaticDropdown({
+        displayName: 'Voice',
+        description: 'The voice to use for the text-to-speech message.',
+        required: false,
+        options: {
+            options: [
+                { label: 'Alice (Default)', value: 'alice' },
+                { label: 'Man', value: 'man' },
+                { label: 'Woman', value: 'woman' },
+            ]
+        }
+    }),
+    language: Property.StaticDropdown({
+        displayName: 'Language',
+        description: 'The language to use for the text-to-speech message.',
+        required: false,
+        options: {
+            options: [
+                { label: 'English (US)', value: 'en-US' },
+                { label: 'English (UK)', value: 'en-GB' },
+                { label: 'Spanish', value: 'es-ES' },
+                { label: 'French', value: 'fr-FR' },
+                { label: 'German', value: 'de-DE' },
+            ]
+        }
+    }),
+    sendDigits: Property.ShortText({
+      displayName: 'Send DTMF Tones',
+      description: "A string of keys to dial after the call is connected. Use 'w' for a half-second pause.",
+      required: false,
+    }),
+    timeout: Property.Number({
+        displayName: 'Timeout (seconds)',
+        description: 'The number of seconds to let the phone ring before assuming no answer. Default is 60.',
+        required: false,
+    })
+  },
+  async run(context) {
+    const { from, to, message, voice, language, sendDigits, timeout } = context.propsValue;
+
+    const account_sid = context.auth.username;
+    const auth_token = context.auth.password;
+
+    // Construct TwiML for the <Say> verb
+    const voiceAttr = voice ? ` voice="${voice}"` : '';
+    const langAttr = language ? ` language="${language}"` : '';
+    const escapedMessage = message
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+    const twiml = `<Response><Say${voiceAttr}${langAttr}>${escapedMessage}</Say></Response>`;
+
+    const bodyParams: Record<string, unknown> = {
+      From: from,
+      To: to,
+      Twiml: twiml,
+    };
+
+    if (sendDigits) {
+      bodyParams['SendDigits'] = sendDigits;
+    }
+    if (timeout) {
+      bodyParams['Timeout'] = timeout;
+    }
+
+    const response =  await callTwilioApi(
+      HttpMethod.POST,
+      'Calls.json',
+      { account_sid, auth_token },
+      bodyParams
+    );
+
+    return response.body;
+  },
+});

package/src/lib/action/phone-number-lookup.ts

@@ -0,0 +1,39 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { AuthenticationType, httpClient, HttpMethod } from '@agnocon/pieces-common';
+import { twilioAuth } from '../..';
+
+export const twilioPhoneNumberLookup = createAction({
+  auth: twilioAuth,
+  name: 'phone_number_lookup',
+  description: 'Lookup information about a phone number.',
+  audience: 'both',
+  aiMetadata: { description: 'Looks up carrier and line-type intelligence for a single phone number via the Twilio Lookup API. Use to validate or enrich a number (e.g. detect mobile vs landline, carrier) before messaging or calling it. Read-only and idempotent.', idempotent: true },
+  displayName: 'Phone Number Lookup',
+  props: {
+    phone_number:Property.ShortText({
+      displayName:'Phone Number',
+      required:true
+    })
+  },
+  async run(context) {
+    const { phone_number } = context.propsValue;
+
+    const account_sid = context.auth.username;
+    const auth_token = context.auth.password;
+
+    const response = await httpClient.sendRequest({
+      method:HttpMethod.GET,
+      url:`https://lookups.twilio.com/v2/PhoneNumbers/${encodeURIComponent(phone_number)}`,
+       authentication: {
+            type: AuthenticationType.BASIC,
+            username: account_sid,
+            password: auth_token,
+          },
+        queryParams:{
+          Fields:'line_type_intelligence'
+        }
+    })
+
+    return response.body
+  },
+});

package/src/lib/action/send-sms.ts

@@ -0,0 +1,41 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { HttpMethod } from '@agnocon/pieces-common';
+import { callTwilioApi, twilioCommon } from '../common';
+import { twilioAuth } from '../..';
+
+export const twilioSendSms = createAction({
+  auth: twilioAuth,
+  name: 'send_sms',
+  description: 'Send a new SMS message',
+  audience: 'both',
+  aiMetadata: { description: 'Sends an SMS text message from a Twilio phone number to a recipient. Use to notify or message a person by text. Requires the destination number, message body, and a Twilio-owned sender number; sending costs money and delivers a separate message on every call, so it is not idempotent.', idempotent: false },
+  displayName: 'Send SMS',
+  props: {
+    from: twilioCommon.phone_number,
+    body: Property.ShortText({
+      description: 'The body of the message to send',
+      displayName: 'Message Body',
+      required: true,
+    }),
+    to: Property.ShortText({
+      description: 'The phone number to send the message to',
+      displayName: 'To',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const { body, to, from } = context.propsValue;
+    const account_sid = context.auth.username;
+    const auth_token = context.auth.password;
+    return await callTwilioApi(
+      HttpMethod.POST,
+      'Messages.json',
+      { account_sid, auth_token },
+      {
+        From: from,
+        Body: body,
+        To: to,
+      }
+    );
+  },
+});

package/src/lib/common/index.ts

@@ -0,0 +1,69 @@
+import {
+  Property,
+  BasicAuthPropertyValue,
+} from '@agnocon/pieces-framework';
+import {
+  HttpMethod,
+  HttpMessageBody,
+  httpClient,
+  AuthenticationType,
+} from '@agnocon/pieces-common';
+import { twilioAuth } from '../..';
+
+export const twilioCommon = {
+  phone_number: Property.Dropdown({
+    auth: twilioAuth,
+    description: 'The phone number to send the message from',
+    displayName: 'From',
+    required: true,
+    refreshers: [],
+    options: async ({ auth }) => {
+      if (!auth) {
+        return {
+          disabled: true,
+          placeholder: 'connect your account first',
+          options: [],
+        };
+      }
+
+      const basicAuthProperty = auth;
+      const response = await callTwilioApi<{
+        incoming_phone_numbers: {
+          phone_number: string;
+          friendly_name: string;
+        }[];
+      }>(HttpMethod.GET, 'IncomingPhoneNumbers.json', {
+        account_sid: basicAuthProperty.username,
+        auth_token: basicAuthProperty.password,
+      });
+      return {
+        disabled: false,
+        options: response.body.incoming_phone_numbers.map((number: any) => ({
+          value: number.phone_number,
+          label: number.friendly_name,
+        })),
+      };
+    },
+  }),
+};
+
+export const callTwilioApi = async <T extends HttpMessageBody>(
+  method: HttpMethod,
+  path: string,
+  auth: { account_sid: string; auth_token: string },
+  body?: any
+) => {
+  return await httpClient.sendRequest<T>({
+    method,
+    url: `https://api.twilio.com/2010-04-01/Accounts/${auth.account_sid}/${path}`,
+    authentication: {
+      type: AuthenticationType.BASIC,
+      username: auth.account_sid,
+      password: auth.auth_token,
+    },
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded',
+    },
+    body: body,
+  });
+};