@awell-health/awell-extensions 2.1.178 → 2.1.179

package/dist/extensions/markdown.json

@@ -217,7 +217,7 @@
   },
   "transform": {
     "readme": "---\ntitle: Transform\ndescription: Transform is an extension with utility functions that allows you to transform or parse data to a format of your liking\n---\n\n# Transform\n\nTransform is an extension on Awell's Marketplace with utility functions that allows you to transform data from one type to another. These functions are particularly useful e.g. when system A works with IDs that are numbers but system B works with IDs that are strings.\n\n## Custom Actions\n\n### Parse number to text\n\nTransform or parse a number to text (string).\n\n### Parse text to number\n\nTransform or parse text (string) to a number. Will return NaN if the input data is not an actual number.\n\n### Parse date to unix timestamp\n\nTransform or parse a date to a unix timestamp.\n\n### Parse unix timestamp to unix date\n\nTransform or parse a unix timestamp to a date.\n\n## Parse number to text with dictionary\n\nTransform or parse a number to a string using a dictionary. Useful for when you have numeric data points but want to map them to strings based on a dictionary. When the action is called with a number that does not have a corresponding mapping in the provided dictionary, it simply returns the number itself as a string. \n\nThe dictionary should be structured in JSON format with string keys mapping to string values. Each key represents a number (as a string), and each value is the corresponding text representation.\n\n**Example:**\n```json\n{\n  \"0\": \"Male\",\n  \"1\": \"Female\",\n  \"2\": \"Not known\",\n  // ... other number mappings ...\n}\n```\n\n## Generate dynamic URL\n\nGenerate a dynamic URL based on a URL template with placeholder and a data point value.\n\n```\nurlTemplate   https://your-url.com/{{placeholder}}\nvalue         hello-world\noutcome       https://your-url.com/hello-world\n```\n\n## Feet and inches to inches\n\nConverts a measurement in feet and inches to just inches.\n\n## Combine date and time\n\nCombines a reference date with a time string to create a complete datetime in UTC format. This action supports two input formats for the time string:\n\n1. **Simple time format (HH:mm:ss)**: Combines the reference date with the specified time in ISO format (e.g., \"14:30:00\" not \"2PM\")\n2. **Full datetime with timezone**: Accepts ISO8601 datetime strings with timezone offsets and converts them to UTC\n\n**Examples:**\n\n**Example 1 - Simple time combination:**\n```\nReference date: 2025-09-13\nTime string: 17:45:00\nResult: 2025-09-13T17:45:00Z\n```\n\n**Example 2 - Reference date precedence with timezone-aware datetime:**\n```\nReference date: 2025-09-01\nTime string: 2025-09-06T15:34:44+02:00\nResult: 2025-09-01T13:34:44Z (reference date takes precedence, time converted from +02:00 to UTC)\n```\n\n**Example 3 - Different timezone offset:**\n```\nReference date: 2025-09-06\nTime string: 2025-09-06T10:30:00-05:00\nResult: 2025-09-06T15:30:00Z (converted from -05:00 to UTC)\n```\n\nThis action is particularly useful for scheduling systems like Bland API where you need to combine dates and times from different sources, or when working with timezone-aware scheduling data that needs to be normalized to UTC.\n",
-    "changelog": "# Transform changelog\n\n## June 2024\n\n- Added \"Feet and inches to inches\" action\n## March 2024\n\n- Added \"Generate dynamic URL\" action\n\n## January 2024\n\n- Added \"Parse number to text with dictionary\" action"
+    "changelog": "# Transform changelog\n\n## Unreleased\n\n- Fixed \"HTML to PDF\" ignoring the Options field. Awell delivers JSON fields as a string; the action now parses it before forwarding to the PDF server, so page format, margins, and header/footer settings take effect. Invalid JSON in Options now fails the activity with a clear validation message instead of being silently ignored.\n\n## June 2024\n\n- Added \"Feet and inches to inches\" action\n## March 2024\n\n- Added \"Generate dynamic URL\" action\n\n## January 2024\n\n- Added \"Parse number to text with dictionary\" action"
   },
   "twilio": {
     "readme": "---\ntitle: Twilio\ndescription: Twilio is a customer engagement platform used by hundreds of thousands of businesses and more than ten million developers worldwide to build unique, personalized experiences for their customers.\n---\n# Twilio\n\nTwilio is a customer engagement platform used by hundreds of thousands of businesses and more than ten million developers worldwide to build unique, personalized experiences for their customers.\n\nThey are known for democratizing channels like voice, text, chat, video, and email through APIs, making it easy for every organization to build meaningful interactions with customers on the channels they prefer.\n\n## Extension settings\n\nIn order to set up this extension, you will need:\n\n1. A Twilio API key or auth token which can be found in the Twilio console.\n2. Your account SID which can be found in the Twilio console.\n3. A phone number to send the message from. This must be a Twilio phone number that you own.\n\n## User consent\n\nThe extension has some built-in mechanisms to enforce compliance with [Twilio's messaging policy](https://www.twilio.com/en-us/legal/messaging-policy).\n\n### Opt-out\n\nBy default, every text message will be appended with standard opt-out language (\"Reply STOP to unsubscribe.\"). You can specify custom opt-out language within the settings of the extension but make sure the opt-out keywords used are supported. STOP, UNSTOP, UNSUBSCRIBE or CANCEL are the default opt-out keywords supported but Twilio also supports defining custom stop keywords.\n\nIf you don't want to append opt-out language to your text messages, set the \"Add opt-out language\" setting to \"Off\".\n\nFor more information, please visit the Twilio docs.\n\n### Sending text messages to recipients that opted out\n\nIf you attempt to send a text message to a recipient who has opted out, the message will fail to be delivered and the action will be marked as failed. This is the default behavior of Twilio's API, which prevents sending texts to anyone who has chosen to opt out.\n\n## Custom Actions\n\n### Send SMS\n\nSend an SMS with Twilio to a recipient of your liking.\n\n### Get messages\n\nGet a list of text messages matching the given criteria. Only the last 50 messages are returned.\n\n## Send SMS during working hours\n\nThis action allows for the scheduling of SMS messages to be sent within the \"daily operational hours\" of 9 AM to 5 PM. It ensures that text messages are dispatched at appropriate times during the day, avoiding early morning or late-night disturbances to recipients.\n\n**Here's how it works:**\n\n- If the action is activate during business hours (9 AM to 5 PM), the SMS is sent immediately.\n- If activated before 9 AM, the SMS is scheduled to be sent at 9 AM on the same day.\n- If activated after 5 PM, the SMS is scheduled to be sent at 9 AM the following day.\n\nThis setup ensures that all messages reach your respondents during reasonable daytime hours, enhancing the likelihood of a timely and considerate communication. It's important to mention that messages will still be dispatched over the weekend, but they will adhere to the \"business hours\" schedule of 9 AM to 5 PM.\n\nNote that scheduling messages with Twilio is only possible if you send text messages using a MessagingServiceSid.\n\n\n\n\n\n\n",

package/dist/extensions/transform/v1/actions/htmlToPdf/config/fields.d.ts

@@ -18,5 +18,5 @@ export declare const fields: {
 };
 export declare const FieldsValidationSchema: z.ZodObject<{
     htmlString: z.ZodString;
-    options: z.ZodOptional<z.ZodAny>;
+    options: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>, z.ZodTransform<Record<string, unknown> | undefined, string | Record<string, any> | undefined>>;
 }, z.core.$strip>;

package/dist/extensions/transform/v1/actions/htmlToPdf/config/fields.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FieldsValidationSchema = exports.fields = void 0;
 const zod_1 = require("zod");
 const extensions_core_1 = require("@awell-health/extensions-core");
+const lodash_1 = require("lodash");
 exports.fields = {
     htmlString: {
         id: 'htmlString',
@@ -19,8 +20,45 @@ exports.fields = {
         required: false,
     },
 };
+/**
+ * Awell delivers JSON fields to the extension as a string. Parse it so the
+ * options object is forwarded to the PDF server as an object. Objects are
+ * accepted as-is so existing callers and tests keep working.
+ */
+const OptionsSchema = zod_1.z
+    .union([zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.any())])
+    .optional()
+    .transform((value, ctx) => {
+    if ((0, lodash_1.isNil)(value))
+        return undefined;
+    if (typeof value !== 'string')
+        return value;
+    const trimmed = value.trim();
+    if ((0, lodash_1.isEmpty)(trimmed) || (0, lodash_1.isNil)(trimmed))
+        return undefined;
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: 'Options must be a JSON object',
+            });
+            return zod_1.z.NEVER;
+        }
+        return parsed;
+    }
+    catch (err) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: 'Options is not valid JSON',
+        });
+        return zod_1.z.NEVER;
+    }
+});
 exports.FieldsValidationSchema = zod_1.z.object({
     htmlString: zod_1.z.string().min(1),
-    options: zod_1.z.any().optional(),
+    options: OptionsSchema,
 });
 //# sourceMappingURL=fields.js.map

package/dist/extensions/transform/v1/actions/htmlToPdf/config/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../../../../extensions/transform/v1/actions/htmlToPdf/config/fields.ts"],"names":[],"mappings":";;;AAAA,6BAAgC;AAChC,mEAAqE;AAExD,QAAA,MAAM,GAAG;IACpB,UAAU,EAAE;QACV,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,sCAAsC;QACnD,IAAI,EAAE,2BAAS,CAAC,MAAM;QACtB,QAAQ,EAAE,IAAI;KACf;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,wEAAwE;QAC1E,IAAI,EAAE,2BAAS,CAAC,IAAI;QACpB,QAAQ,EAAE,KAAK;KAChB;CAC8B,CAAA;AAEpB,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAA"}
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../../../../extensions/transform/v1/actions/htmlToPdf/config/fields.ts"],"names":[],"mappings":";;;AAAA,6BAAqC;AACrC,mEAAqE;AACrE,mCAAuC;AAE1B,QAAA,MAAM,GAAG;IACpB,UAAU,EAAE;QACV,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,sCAAsC;QACnD,IAAI,EAAE,2BAAS,CAAC,MAAM;QACtB,QAAQ,EAAE,IAAI;KACf;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,wEAAwE;QAC1E,IAAI,EAAE,2BAAS,CAAC,IAAI;QACpB,QAAQ,EAAE,KAAK;KAChB;CAC8B,CAAA;AAEjC;;;;GAIG;AACH,MAAM,aAAa,GAAG,OAAC;KACpB,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;KAClD,QAAQ,EAAE;KACV,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAuC,EAAE;IAC7D,IAAI,IAAA,cAAK,EAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,IAAA,gBAAO,EAAC,OAAO,CAAC,IAAI,IAAA,cAAK,EAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAA;IAExD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAClC,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACrB,CAAC;YACD,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,OAAO,EAAE,+BAA+B;aACzC,CAAC,CAAA;YACF,OAAO,OAAC,CAAC,KAAK,CAAA;QAChB,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAA;QACF,OAAO,OAAC,CAAC,KAAK,CAAA;IAChB,CAAC;AACH,CAAC,CAAC,CAAA;AAES,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,EAAE,aAAa;CACwB,CAAC,CAAA"}

package/dist/extensions/transform/v1/actions/htmlToPdf/htmlToPdf.js

@@ -12,7 +12,7 @@ exports.htmlToPdf = {
     category: extensions_core_1.Category.DATA,
     fields: config_1.fields,
     dataPoints: config_1.dataPoints,
-    previewable: false,
+    previewable: true,
     onEvent: async ({ payload, onComplete, onError, helpers }) => {
         helpers.log({ fields: payload.fields }, 'Processing htmlToPdf');
         try {

package/dist/extensions/transform/v1/actions/htmlToPdf/htmlToPdf.js.map

@@ -1 +1 @@
-{"version":3,"file":"htmlToPdf.js","sourceRoot":"","sources":["../../../../../../extensions/transform/v1/actions/htmlToPdf/htmlToPdf.ts"],"names":[],"mappings":";;;AACA,mEAAkE;AAElE,qCAAqE;AACrE,6BAAuB;AACvB,kEAAoE;AAEvD,QAAA,SAAS,GAIlB;IACF,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,aAAa;IACpB,WAAW,EACT,0FAA0F;IAC5F,QAAQ,EAAE,0BAAQ,CAAC,IAAI;IACvB,MAAM,EAAN,eAAM;IACN,UAAU,EAAV,mBAAU;IACV,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3D,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAA;QAE/D,IAAI,CAAC;YACH,MAAM,EACJ,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,GAChC,GAAG,IAAA,0BAAQ,EAAC;gBACX,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;oBACf,MAAM,EAAE,+BAAsB;iBAC/B,CAAC;gBACF,OAAO;aACR,CAAC,CAAA;YAEF,MAAM,SAAS,GAAG,MAAM,IAAA,2BAAe,EAAC,UAAU,EAAE,OAAO,CAAC,CAAA;YAE5D,OAAO,CAAC,GAAG,CACT;gBACE,gBAAgB,EAAE,UAAU,CAAC,MAAM;gBACnC,OAAO;gBACP,eAAe,EAAE,SAAS,CAAC,MAAM;aAClC,EACD,uBAAuB,CACxB,CAAA;YAED,MAAM,UAAU,CAAC;gBACf,WAAW,EAAE;oBACX,SAAS;iBACV;aACF,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAY,CAAC,CAAA;YAC3C,MAAM,KAAK,GAAG,GAAY,CAAA;YAC1B,MAAM,OAAO,CAAC;gBACZ,MAAM,EAAE;oBACN;wBACE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBAC9B,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE;wBAC3B,KAAK,EAAE;4BACL,QAAQ,EAAE,cAAc;4BACxB,OAAO,EAAE,KAAK,CAAC,OAAO;yBACvB;qBACF;iBACF;aACF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF,CAAA"}
+{"version":3,"file":"htmlToPdf.js","sourceRoot":"","sources":["../../../../../../extensions/transform/v1/actions/htmlToPdf/htmlToPdf.ts"],"names":[],"mappings":";;;AACA,mEAAkE;AAElE,qCAAqE;AACrE,6BAAuB;AACvB,kEAAoE;AAEvD,QAAA,SAAS,GAIlB;IACF,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,aAAa;IACpB,WAAW,EACT,0FAA0F;IAC5F,QAAQ,EAAE,0BAAQ,CAAC,IAAI;IACvB,MAAM,EAAN,eAAM;IACN,UAAU,EAAV,mBAAU;IACV,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3D,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAA;QAE/D,IAAI,CAAC;YACH,MAAM,EACJ,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,GAChC,GAAG,IAAA,0BAAQ,EAAC;gBACX,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;oBACf,MAAM,EAAE,+BAAsB;iBAC/B,CAAC;gBACF,OAAO;aACR,CAAC,CAAA;YAEF,MAAM,SAAS,GAAG,MAAM,IAAA,2BAAe,EAAC,UAAU,EAAE,OAAO,CAAC,CAAA;YAE5D,OAAO,CAAC,GAAG,CACT;gBACE,gBAAgB,EAAE,UAAU,CAAC,MAAM;gBACnC,OAAO;gBACP,eAAe,EAAE,SAAS,CAAC,MAAM;aAClC,EACD,uBAAuB,CACxB,CAAA;YAED,MAAM,UAAU,CAAC;gBACf,WAAW,EAAE;oBACX,SAAS;iBACV;aACF,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAY,CAAC,CAAA;YAC3C,MAAM,KAAK,GAAG,GAAY,CAAA;YAC1B,MAAM,OAAO,CAAC;gBACZ,MAAM,EAAE;oBACN;wBACE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBAC9B,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE;wBAC3B,KAAK,EAAE;4BACL,QAAQ,EAAE,cAAc;4BACxB,OAAO,EAAE,KAAK,CAAC,OAAO;yBACvB;qBACF;iBACF;aACF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awell-health/awell-extensions",
-  "version": "2.1.178",
+  "version": "2.1.179",
   "packageManager": "yarn@4.5.3",
   "main": "dist/src/index.js",
   "repository": {