@unchainedshop/plugins 4.0.0-rc.7 → 4.0.0-rc.9

package/lib/presets/all.d.ts

@@ -9,7 +9,9 @@ import '../payment/datatrans-v2/index.js';
 import '../payment/payrexx/index.js';
 import '../filters/strict-equal.js';
 import '../filters/local-search.js';
-import '../worker/sms.js';
+import '../worker/twilio.js';
+import '../worker/bulkgate.js';
+import '../worker/budgetsms.js';
 import '../worker/push-notification.js';
 import '../worker/enrollment-order-generator.js';
 declare const modules: {

package/lib/presets/all.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../src/presets/all.ts"],"names":[],"mappings":"AACA,OAAO,mBAAmB,CAAC;AAI3B,OAAO,6BAA6B,CAAC;AACrC,OAAO,uBAAuB,CAAC;AAG/B,OAAO,+BAA+B,CAAC;AACvC,OAAO,+BAA+B,CAAC;AAGvC,OAAO,4BAA4B,CAAC;AACpC,OAAO,0CAA0C,CAAC;AAClD,OAAO,kCAAkC,CAAC;AAC1C,OAAO,6BAA6B,CAAC;AAGrC,OAAO,4BAA4B,CAAC;AACpC,OAAO,4BAA4B,CAAC;AAGpC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,gCAAgC,CAAC;AACxC,OAAO,yCAAyC,CAAC;AAEjD,QAAA,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAQs0C,CAAC;;;;;;wBAD70C,CAAA;;;;;;;;;;;;;;;;;;CAFN,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../src/presets/all.ts"],"names":[],"mappings":"AACA,OAAO,mBAAmB,CAAC;AAI3B,OAAO,6BAA6B,CAAC;AACrC,OAAO,uBAAuB,CAAC;AAG/B,OAAO,+BAA+B,CAAC;AACvC,OAAO,+BAA+B,CAAC;AAGvC,OAAO,4BAA4B,CAAC;AACpC,OAAO,0CAA0C,CAAC;AAClD,OAAO,kCAAkC,CAAC;AAC1C,OAAO,6BAA6B,CAAC;AAGrC,OAAO,4BAA4B,CAAC;AACpC,OAAO,4BAA4B,CAAC;AAGpC,OAAO,qBAAqB,CAAC;AAC7B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,gCAAgC,CAAC;AACxC,OAAO,yCAAyC,CAAC;AAEjD,QAAA,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAQkwC,CAAC;;;;;;wBALzwC,CAAC;;;;;;;;;;;;;;;;;;CAEP,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/lib/presets/all.js

@@ -17,7 +17,9 @@ import '../payment/payrexx/index.js';
 import '../filters/strict-equal.js';
 import '../filters/local-search.js';
 // Workers
-import '../worker/sms.js';
+import '../worker/twilio.js';
+import '../worker/bulkgate.js';
+import '../worker/budgetsms.js';
 import '../worker/push-notification.js';
 import '../worker/enrollment-order-generator.js';
 const modules = {

package/lib/presets/all.js.map

@@ -1 +1 @@
-{"version":3,"file":"all.js","sourceRoot":"","sources":["../../src/presets/all.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,WAAW,CAAC;AACpC,OAAO,mBAAmB,CAAC;AAC3B,OAAO,aAAa,MAAM,aAAa,CAAC;AAExC,WAAW;AACX,OAAO,6BAA6B,CAAC;AACrC,OAAO,uBAAuB,CAAC;AAE/B,UAAU;AACV,OAAO,+BAA+B,CAAC;AACvC,OAAO,+BAA+B,CAAC;AACvC,OAAO,wBAAwB,MAAM,+BAA+B,CAAC;AACrE,OAAO,2BAA2B,MAAM,8BAA8B,CAAC;AACvE,OAAO,4BAA4B,CAAC;AACpC,OAAO,0CAA0C,CAAC;AAClD,OAAO,kCAAkC,CAAC;AAC1C,OAAO,6BAA6B,CAAC;AAErC,kBAAkB;AAClB,OAAO,4BAA4B,CAAC;AACpC,OAAO,4BAA4B,CAAC;AAEpC,UAAU;AACV,OAAO,kBAAkB,CAAC;AAC1B,OAAO,gCAAgC,CAAC;AACxC,OAAO,yCAAyC,CAAC;AAEjD,MAAM,OAAO,GAAG;IACd,GAAG,WAAW;IACd,GAAG,aAAa;IAChB,GAAG,wBAAwB;IAC3B,GAAG,2BAA2B;CAC/B,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"all.js","sourceRoot":"","sources":["../../src/presets/all.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,WAAW,CAAC;AACpC,OAAO,mBAAmB,CAAC;AAC3B,OAAO,aAAa,MAAM,aAAa,CAAC;AAExC,WAAW;AACX,OAAO,6BAA6B,CAAC;AACrC,OAAO,uBAAuB,CAAC;AAE/B,UAAU;AACV,OAAO,+BAA+B,CAAC;AACvC,OAAO,+BAA+B,CAAC;AACvC,OAAO,wBAAwB,MAAM,+BAA+B,CAAC;AACrE,OAAO,2BAA2B,MAAM,8BAA8B,CAAC;AACvE,OAAO,4BAA4B,CAAC;AACpC,OAAO,0CAA0C,CAAC;AAClD,OAAO,kCAAkC,CAAC;AAC1C,OAAO,6BAA6B,CAAC;AAErC,kBAAkB;AAClB,OAAO,4BAA4B,CAAC;AACpC,OAAO,4BAA4B,CAAC;AAEpC,UAAU;AACV,OAAO,qBAAqB,CAAC;AAC7B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,gCAAgC,CAAC;AACxC,OAAO,yCAAyC,CAAC;AAEjD,MAAM,OAAO,GAAG;IACd,GAAG,WAAW;IACd,GAAG,aAAa;IAChB,GAAG,wBAAwB;IAC3B,GAAG,2BAA2B;CAC/B,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/lib/worker/budgetsms.d.ts

@@ -0,0 +1,10 @@
+export declare function checkBudgetSmsCredentials(): Promise<{
+    success: boolean;
+    credit: number;
+    error?: undefined;
+} | {
+    error: any;
+    success?: undefined;
+    credit?: undefined;
+}>;
+//# sourceMappingURL=budgetsms.d.ts.map

package/lib/worker/budgetsms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgetsms.d.ts","sourceRoot":"","sources":["../../src/worker/budgetsms.ts"],"names":[],"mappings":"AA8OA,wBAAsB,yBAAyB;;;;;;;;GA6B9C"}

package/lib/worker/budgetsms.js

@@ -0,0 +1,217 @@
+import { WorkerAdapter, WorkerDirector } from '@unchainedshop/core';
+const { BUDGETSMS_USERNAME, BUDGETSMS_USERID, BUDGETSMS_HANDLE } = process.env;
+// BudgetSMS Plugin - Verified against official API documentation
+// Note: BudgetSMS API has a quirk where it returns error 1001 (authentication failed)
+// when you have insufficient credit, instead of the correct error 1003.
+const BudgetSMSWorker = {
+    ...WorkerAdapter,
+    key: 'shop.unchained.worker-plugin.budgetsms',
+    label: 'Send Messages through BudgetSMS',
+    version: '1.0.0',
+    type: 'BUDGETSMS',
+    doWork: async ({ from, to, text, test = false, customid, price = false, mccmnc = false, credit = false, ...params }) => {
+        try {
+            // Validate credentials
+            if (!BUDGETSMS_USERNAME || !BUDGETSMS_USERID || !BUDGETSMS_HANDLE) {
+                throw new Error('Missing BudgetSMS credentials. Please set BUDGETSMS_USERNAME, BUDGETSMS_USERID, and BUDGETSMS_HANDLE');
+            }
+            // Trim credentials to remove any whitespace
+            const username = BUDGETSMS_USERNAME.trim();
+            const userid = BUDGETSMS_USERID.trim();
+            const handle = BUDGETSMS_HANDLE.trim();
+            // Validate userid is numeric only
+            if (!/^\d+$/.test(userid)) {
+                throw new Error('BUDGETSMS_USERID must be numeric only. Found: ' + userid);
+            }
+            // Choose endpoint based on test mode
+            const url = test ? 'https://api.budgetsms.net/testsms/' : 'https://api.budgetsms.net/sendsms/';
+            // Format phone number according to E.164 (no + or 00, no spaces/dashes)
+            const formattedTo = to.replace(/^\+|^00/, '').replace(/[\s-]/g, '');
+            // Build query parameters
+            const queryParams = new URLSearchParams({
+                username: username,
+                userid: userid,
+                handle: handle,
+                msg: text || '', // Note: parameter is 'msg' not 'text'
+                from: from || '',
+                to: formattedTo,
+                ...(customid && { customid }),
+                ...(!test && price && { price: '1' }), // Price info only for real sends
+                ...(!test && mccmnc && { mccmnc: '1' }), // Carrier info only for real sends
+                ...(!test && credit && { credit: '1' }), // Credit info only for real sends
+                ...params,
+            });
+            // Make GET request
+            const fullUrl = `${url}?${queryParams.toString()}`;
+            const response = await fetch(fullUrl, {
+                method: 'GET',
+                headers: {
+                    Accept: 'text/plain',
+                    'User-Agent': 'Unchained/BudgetSMS-Plugin',
+                },
+            });
+            const responseText = await response.text().then((text) => text.trim());
+            // Parse response: "OK <smsid> [price] [parts] [mccmnc] [credit]" or "ERR <errorcode>"
+            if (responseText.startsWith('OK')) {
+                const parts = responseText.split(' ');
+                const result = {
+                    sms_id: parts[1] || null,
+                    status: test ? 'test_successful' : 'sent',
+                    test_mode: test,
+                };
+                if (test) {
+                    result.message = 'Test SMS validated successfully (no credit deducted)';
+                }
+                else {
+                    // Parse additional info based on parameters used
+                    let index = 2;
+                    if (price && parts[index] && parts[index + 1]) {
+                        result.price = parseFloat(parts[index]);
+                        result.parts = parseInt(parts[index + 1]);
+                        index += 2;
+                    }
+                    if (mccmnc && parts[index]) {
+                        result.mccmnc = parts[index];
+                        index += 1;
+                    }
+                    if (credit && parts[index]) {
+                        result.remaining_credit = parseFloat(parts[index]);
+                    }
+                }
+                return {
+                    success: true,
+                    result,
+                    error: null,
+                };
+            }
+            if (responseText.startsWith('ERR')) {
+                const parts = responseText.split(' ');
+                const errorCode = parts[1] || 'UNKNOWN';
+                // Error code mappings from documentation
+                const errorMessages = {
+                    '1001': 'Authentication failed OR insufficient credit (BudgetSMS returns 1001 for both)',
+                    '1002': 'Account not active',
+                    '1003': 'Insufficient credit',
+                    '1004': 'No access to this API',
+                    '1005': 'No handle provided',
+                    '1006': 'No UserID provided',
+                    '1007': 'No Username provided',
+                    '2001': 'SMS message text is empty',
+                    '2002': 'SMS numeric senderid can be max. 16 numbers',
+                    '2003': 'SMS alphanumeric sender can be max. 11 characters',
+                    '2004': 'SMS senderid is empty or invalid',
+                    '2005': 'Destination number is too short',
+                    '2006': 'Destination is not numeric',
+                    '2007': 'Destination is empty',
+                    '2008': 'SMS text is not OK (check encoding?)',
+                    '2009': 'Parameter issue',
+                    '2010': 'Destination number is invalidly formatted',
+                    '2011': 'Destination is invalid',
+                    '2012': 'SMS message text is too long',
+                    '2013': 'SMS message is invalid',
+                    '2014': 'SMS CustomID is used before',
+                    '2015': 'Charset problem',
+                    '2016': 'Invalid UTF-8 encoding',
+                    '3001': 'No route to destination',
+                    '3002': 'No routes are setup',
+                    '3003': 'Invalid destination',
+                    '4001': 'System error, related to customid',
+                    '4002': 'System error, temporary issue',
+                };
+                // Special handling for 1001 error
+                let message = errorMessages[errorCode] || `Unknown error code: ${errorCode}`;
+                if (errorCode === '1001') {
+                    message += '. Note: Check your account balance - BudgetSMS may return 1001 when credit is 0.';
+                }
+                return {
+                    success: false,
+                    error: {
+                        name: 'BUDGETSMS_ERROR',
+                        code: errorCode,
+                        message,
+                    },
+                };
+            }
+            // Unexpected response
+            return {
+                success: false,
+                error: {
+                    name: 'BUDGETSMS_ERROR',
+                    message: 'Unexpected response format from BudgetSMS API',
+                    response: responseText,
+                },
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: {
+                    name: err.name,
+                    message: err.message,
+                    stack: err.stack,
+                },
+            };
+        }
+    },
+};
+WorkerDirector.registerAdapter(BudgetSMSWorker);
+// Environment variables needed:
+// BUDGETSMS_USERNAME=your_username (alphanumeric)
+// BUDGETSMS_USERID=your_userid (NUMERIC ONLY - found in BudgetSMS control panel)
+// BUDGETSMS_HANDLE=your_api_handle (alphanumeric - found in BudgetSMS control panel)
+// IMPORTANT: The userid MUST be numeric only. You can find it in the BudgetSMS control panel after login.
+// Example: BUDGETSMS_USERID=12345 (NOT "user12345" or any non-numeric value)
+// Usage examples:
+//
+// Send real SMS (requires credits):
+// await WorkerDirector.doWork({
+//   type: 'BUDGETSMS',
+//   from: 'YourCompany',
+//   to: '+41791234567',
+//   text: 'Your message here',
+//   price: true, // Get price info
+//   credit: true, // Get remaining credit
+// });
+//
+// Test SMS (no credit deducted):
+// await WorkerDirector.doWork({
+//   type: 'BUDGETSMS',
+//   test: true,
+//   from: 'YourCompany',
+//   to: '+41791234567',
+//   text: 'Test message',
+// });
+//
+// IMPORTANT: If you get error 1001, it could mean either:
+// 1. Authentication failed (wrong credentials)
+// 2. Insufficient credit (0 balance)
+// Use the checkBudgetSmsCredentials() helper to verify which one it is.
+// Helper function to check credentials and balance
+export async function checkBudgetSmsCredentials() {
+    const url = 'https://api.budgetsms.net/checkcredit/';
+    const username = process.env.BUDGETSMS_USERNAME?.trim();
+    const userid = process.env.BUDGETSMS_USERID?.trim();
+    const handle = process.env.BUDGETSMS_HANDLE?.trim();
+    if (!username || !userid || !handle) {
+        return { error: 'Missing credentials' };
+    }
+    if (!/^\d+$/.test(userid)) {
+        return { error: 'UserID must be numeric only' };
+    }
+    const queryParams = new URLSearchParams({ username, userid, handle });
+    try {
+        const response = await fetch(`${url}?${queryParams.toString()}`, { method: 'GET' });
+        const text = await response.text();
+        if (text.startsWith('OK')) {
+            const credit = parseFloat(text.split(' ')[1]) || 0;
+            return { success: true, credit };
+        }
+        else {
+            return { error: text };
+        }
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+}
+//# sourceMappingURL=budgetsms.js.map

package/lib/worker/budgetsms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgetsms.js","sourceRoot":"","sources":["../../src/worker/budgetsms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEpF,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;AAE/E,iEAAiE;AACjE,sFAAsF;AACtF,wEAAwE;AACxE,MAAM,eAAe,GAajB;IACF,GAAG,aAAa;IAEhB,GAAG,EAAE,wCAAwC;IAC7C,KAAK,EAAE,iCAAiC;IACxC,OAAO,EAAE,OAAO;IAEhB,IAAI,EAAE,WAAW;IAEjB,MAAM,EAAE,KAAK,EAAE,EACb,IAAI,EACJ,EAAE,EACF,IAAI,EACJ,IAAI,GAAG,KAAK,EACZ,QAAQ,EACR,KAAK,GAAG,KAAK,EACb,MAAM,GAAG,KAAK,EACd,MAAM,GAAG,KAAK,EACd,GAAG,MAAM,EACV,EAAE,EAAE;QACH,IAAI,CAAC;YACH,uBAAuB;YACvB,IAAI,CAAC,kBAAkB,IAAI,CAAC,gBAAgB,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAClE,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;YACJ,CAAC;YAED,4CAA4C;YAC5C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC;YAEvC,kCAAkC;YAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,gDAAgD,GAAG,MAAM,CAAC,CAAC;YAC7E,CAAC;YAED,qCAAqC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,oCAAoC,CAAC;YAE/F,wEAAwE;YACxE,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAEpE,yBAAyB;YACzB,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;gBACtC,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,IAAI,IAAI,EAAE,EAAE,sCAAsC;gBACvD,IAAI,EAAE,IAAI,IAAI,EAAE;gBAChB,EAAE,EAAE,WAAW;gBACf,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC7B,GAAG,CAAC,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,iCAAiC;gBACxE,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,mCAAmC;gBAC5E,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,kCAAkC;gBAC3E,GAAG,MAAM;aACV,CAAC,CAAC;YAEH,mBAAmB;YACnB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;YAEnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;gBACpC,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,MAAM,EAAE,YAAY;oBACpB,YAAY,EAAE,4BAA4B;iBAC3C;aACF,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAEvE,sFAAsF;YACtF,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACtC,MAAM,MAAM,GAAQ;oBAClB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI;oBACxB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM;oBACzC,SAAS,EAAE,IAAI;iBAChB,CAAC;gBAEF,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM,CAAC,OAAO,GAAG,sDAAsD,CAAC;gBAC1E,CAAC;qBAAM,CAAC;oBACN,iDAAiD;oBACjD,IAAI,KAAK,GAAG,CAAC,CAAC;oBACd,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;wBAC9C,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;wBACxC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;wBAC1C,KAAK,IAAI,CAAC,CAAC;oBACb,CAAC;oBACD,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC3B,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;wBAC7B,KAAK,IAAI,CAAC,CAAC;oBACb,CAAC;oBACD,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC3B,MAAM,CAAC,gBAAgB,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM;oBACN,KAAK,EAAE,IAAI;iBACZ,CAAC;YACJ,CAAC;YAED,IAAI,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACtC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;gBAExC,yCAAyC;gBACzC,MAAM,aAAa,GAA2B;oBAC5C,MAAM,EAAE,gFAAgF;oBACxF,MAAM,EAAE,oBAAoB;oBAC5B,MAAM,EAAE,qBAAqB;oBAC7B,MAAM,EAAE,uBAAuB;oBAC/B,MAAM,EAAE,oBAAoB;oBAC5B,MAAM,EAAE,oBAAoB;oBAC5B,MAAM,EAAE,sBAAsB;oBAC9B,MAAM,EAAE,2BAA2B;oBACnC,MAAM,EAAE,6CAA6C;oBACrD,MAAM,EAAE,mDAAmD;oBAC3D,MAAM,EAAE,kCAAkC;oBAC1C,MAAM,EAAE,iCAAiC;oBACzC,MAAM,EAAE,4BAA4B;oBACpC,MAAM,EAAE,sBAAsB;oBAC9B,MAAM,EAAE,sCAAsC;oBAC9C,MAAM,EAAE,iBAAiB;oBACzB,MAAM,EAAE,2CAA2C;oBACnD,MAAM,EAAE,wBAAwB;oBAChC,MAAM,EAAE,8BAA8B;oBACtC,MAAM,EAAE,wBAAwB;oBAChC,MAAM,EAAE,6BAA6B;oBACrC,MAAM,EAAE,iBAAiB;oBACzB,MAAM,EAAE,wBAAwB;oBAChC,MAAM,EAAE,yBAAyB;oBACjC,MAAM,EAAE,qBAAqB;oBAC7B,MAAM,EAAE,qBAAqB;oBAC7B,MAAM,EAAE,mCAAmC;oBAC3C,MAAM,EAAE,+BAA+B;iBACxC,CAAC;gBAEF,kCAAkC;gBAClC,IAAI,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,uBAAuB,SAAS,EAAE,CAAC;gBAC7E,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;oBACzB,OAAO,IAAI,kFAAkF,CAAC;gBAChG,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE;wBACL,IAAI,EAAE,iBAAiB;wBACvB,IAAI,EAAE,SAAS;wBACf,OAAO;qBACR;iBACF,CAAC;YACJ,CAAC;YAED,sBAAsB;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,+CAA+C;oBACxD,QAAQ,EAAE,YAAY;iBACvB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;iBACjB;aACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,cAAc,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;AAEhD,gCAAgC;AAChC,kDAAkD;AAClD,iFAAiF;AACjF,qFAAqF;AAErF,0GAA0G;AAC1G,6EAA6E;AAE7E,kBAAkB;AAClB,EAAE;AACF,oCAAoC;AACpC,gCAAgC;AAChC,uBAAuB;AACvB,yBAAyB;AACzB,wBAAwB;AACxB,+BAA+B;AAC/B,mCAAmC;AACnC,0CAA0C;AAC1C,MAAM;AACN,EAAE;AACF,iCAAiC;AACjC,gCAAgC;AAChC,uBAAuB;AACvB,gBAAgB;AAChB,yBAAyB;AACzB,wBAAwB;AACxB,0BAA0B;AAC1B,MAAM;AACN,EAAE;AACF,0DAA0D;AAC1D,+CAA+C;AAC/C,qCAAqC;AACrC,wEAAwE;AAExE,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,MAAM,GAAG,GAAG,wCAAwC,CAAC;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IAEpD,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;AACH,CAAC"}

package/lib/worker/bulkgate.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bulkgate.d.ts.map

package/lib/worker/bulkgate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkgate.d.ts","sourceRoot":"","sources":["../../src/worker/bulkgate.ts"],"names":[],"mappings":""}

package/lib/worker/bulkgate.js

@@ -0,0 +1,104 @@
+import { WorkerAdapter, WorkerDirector } from '@unchainedshop/core';
+const { BULKGATE_APPLICATION_ID, BULKGATE_APPLICATION_TOKEN } = process.env;
+// BulkGate Simple API for SMS (transactional by default, promotional via boolean)
+const BulkGateWorker = {
+    ...WorkerAdapter,
+    key: 'shop.unchained.worker-plugin.bulkgate',
+    label: 'Send SMS through BulkGate',
+    version: '1.0.0',
+    type: 'BULKGATE',
+    doWork: async ({ from, to, text, unicode = false, country, schedule, promotional = false, ...params }) => {
+        try {
+            // Choose API endpoint based on promotional flag
+            const url = promotional
+                ? 'https://portal.bulkgate.com/api/1.0/simple/promotional'
+                : 'https://portal.bulkgate.com/api/1.0/simple/transactional';
+            // Prepare the request body
+            const requestBody = {
+                application_id: BULKGATE_APPLICATION_ID,
+                application_token: BULKGATE_APPLICATION_TOKEN,
+                number: to, // Phone number in international format (or semicolon-separated for promotional)
+                text: text || '',
+                unicode: unicode, // Boolean value for unicode support
+                sender_id: from ? 'gText' : 'gSystem', // Use text sender if 'from' is provided
+                sender_id_value: from || '', // Custom sender name if using gText
+                ...(country && { country }), // Optional country code
+                ...(schedule && { schedule }), // Optional scheduled time
+                ...params, // Any additional parameters
+            };
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Cache-Control': 'no-cache',
+                },
+                body: JSON.stringify(requestBody),
+            });
+            const responseData = await response.json();
+            // Check if we have an error response
+            if (responseData.error || responseData.type) {
+                return {
+                    success: false,
+                    error: {
+                        name: 'BULKGATE_ERROR',
+                        message: responseData.error ||
+                            `Failed to send ${promotional ? 'promotional' : 'transactional'} SMS`,
+                        type: responseData.type || null,
+                        code: responseData.code || response.status,
+                        detail: responseData.detail || null,
+                    },
+                };
+            }
+            // Success response (transactional has specific structure, promotional might vary)
+            if (responseData.data) {
+                // For transactional SMS, check for specific accepted status
+                if (!promotional && responseData.data.status === 'accepted') {
+                    return {
+                        success: true,
+                        result: {
+                            sms_id: responseData.data.sms_id,
+                            price: responseData.data.price,
+                            credit: responseData.data.credit,
+                            number: responseData.data.number,
+                            status: responseData.data.status,
+                        },
+                        error: null,
+                    };
+                }
+                // For promotional SMS or other successful responses
+                if (promotional || responseData.data.status) {
+                    return {
+                        success: true,
+                        result: responseData.data,
+                        error: null,
+                    };
+                }
+            }
+            // Unexpected response format
+            return {
+                success: false,
+                error: {
+                    name: 'BULKGATE_ERROR',
+                    message: 'Unexpected response format from BulkGate API',
+                    response: responseData,
+                },
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: {
+                    name: err.name,
+                    message: err.message,
+                    stack: err.stack,
+                },
+            };
+        }
+    },
+};
+// Register the plugin
+WorkerDirector.registerAdapter(BulkGateWorker);
+// Environment variables needed:
+// BULKGATE_APPLICATION_ID=your_application_id
+// BULKGATE_APPLICATION_TOKEN=your_application_token
+//# sourceMappingURL=bulkgate.js.map

package/lib/worker/bulkgate.js.map

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

package/lib/worker/twilio.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=twilio.d.ts.map

package/lib/worker/twilio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio.d.ts","sourceRoot":"","sources":["../../src/worker/twilio.ts"],"names":[],"mappings":""}

package/lib/worker/twilio.js

@@ -0,0 +1,56 @@
+import { WorkerAdapter, WorkerDirector } from '@unchainedshop/core';
+const { TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_SMS_FROM } = process.env;
+const SmsWorkerPlugin = {
+    ...WorkerAdapter,
+    key: 'shop.unchained.worker-plugin.twilio',
+    label: 'Send Messages through Twilio',
+    version: '1.0.0',
+    type: 'TWILIO',
+    doWork: async ({ from, to, text, ...params }) => {
+        try {
+            const url = `https://api.twilio.com/2010-04-01/Accounts/${TWILIO_ACCOUNT_SID}/Messages.json`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Basic ${Buffer.from(`${TWILIO_ACCOUNT_SID}:${TWILIO_AUTH_TOKEN}`).toString('base64')}`,
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body: new URLSearchParams({
+                    Body: text || '',
+                    From: from || TWILIO_SMS_FROM,
+                    To: to,
+                    ...params, // Include any additional parameters passed
+                }),
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                return {
+                    success: false,
+                    error: {
+                        name: 'TWILIO_ERROR',
+                        message: data.message || 'Failed to send SMS',
+                    },
+                };
+            }
+            return {
+                success: true,
+                result: {
+                    sid: data.sid,
+                },
+                error: null,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: {
+                    name: err.name,
+                    message: err.message,
+                    stack: err.stack,
+                },
+            };
+        }
+    },
+};
+WorkerDirector.registerAdapter(SmsWorkerPlugin);
+//# sourceMappingURL=twilio.js.map

package/lib/worker/twilio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio.js","sourceRoot":"","sources":["../../src/worker/twilio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEpF,MAAM,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;AAE/E,MAAM,eAAe,GAQjB;IACF,GAAG,aAAa;IAEhB,GAAG,EAAE,qCAAqC;IAC1C,KAAK,EAAE,8BAA8B;IACrC,OAAO,EAAE,OAAO;IAEhB,IAAI,EAAE,QAAQ;IAEd,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,8CAA8C,kBAAkB,gBAAgB,CAAC;YAC7F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,kBAAkB,IAAI,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;oBACtG,cAAc,EAAE,mCAAmC;iBACpD;gBACD,IAAI,EAAE,IAAI,eAAe,CAAC;oBACxB,IAAI,EAAE,IAAI,IAAI,EAAE;oBAChB,IAAI,EAAE,IAAI,IAAI,eAAe;oBAC7B,EAAE,EAAE,EAAE;oBACN,GAAG,MAAM,EAAE,2CAA2C;iBACvD,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE;wBACL,IAAI,EAAE,cAAc;wBACpB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,oBAAoB;qBAC9C;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,GAAG,EAAE,IAAI,CAAC,GAAG;iBACd;gBACD,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;iBACjB;aACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,cAAc,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unchainedshop/plugins",
-  "version": "4.0.0-rc.7",
+  "version": "4.0.0-rc.9",
   "main": "lib/plugins-index.js",
   "types": "lib/plugins-index.d.ts",
   "exports": {

package/src/presets/all.ts

@@ -21,7 +21,9 @@ import '../filters/strict-equal.js';
 import '../filters/local-search.js';
 
 // Workers
-import '../worker/sms.js';
+import '../worker/twilio.js';
+import '../worker/bulkgate.js';
+import '../worker/budgetsms.js';
 import '../worker/push-notification.js';
 import '../worker/enrollment-order-generator.js';
 

package/src/worker/budgetsms.ts

@@ -0,0 +1,268 @@
+import { IWorkerAdapter, WorkerAdapter, WorkerDirector } from '@unchainedshop/core';
+
+const { BUDGETSMS_USERNAME, BUDGETSMS_USERID, BUDGETSMS_HANDLE } = process.env;
+
+// BudgetSMS Plugin - Verified against official API documentation
+// Note: BudgetSMS API has a quirk where it returns error 1001 (authentication failed)
+// when you have insufficient credit, instead of the correct error 1003.
+const BudgetSMSWorker: IWorkerAdapter<
+  {
+    from?: string;
+    to?: string;
+    text?: string;
+    test?: boolean; // If true, uses test endpoint (no credit deducted)
+    customid?: string;
+    price?: boolean; // Include price info in response
+    mccmnc?: boolean; // Include carrier info in response
+    credit?: boolean; // Include remaining credit in response
+    [key: string]: any;
+  },
+  any
+> = {
+  ...WorkerAdapter,
+
+  key: 'shop.unchained.worker-plugin.budgetsms',
+  label: 'Send Messages through BudgetSMS',
+  version: '1.0.0',
+
+  type: 'BUDGETSMS',
+
+  doWork: async ({
+    from,
+    to,
+    text,
+    test = false,
+    customid,
+    price = false,
+    mccmnc = false,
+    credit = false,
+    ...params
+  }) => {
+    try {
+      // Validate credentials
+      if (!BUDGETSMS_USERNAME || !BUDGETSMS_USERID || !BUDGETSMS_HANDLE) {
+        throw new Error(
+          'Missing BudgetSMS credentials. Please set BUDGETSMS_USERNAME, BUDGETSMS_USERID, and BUDGETSMS_HANDLE',
+        );
+      }
+
+      // Trim credentials to remove any whitespace
+      const username = BUDGETSMS_USERNAME.trim();
+      const userid = BUDGETSMS_USERID.trim();
+      const handle = BUDGETSMS_HANDLE.trim();
+
+      // Validate userid is numeric only
+      if (!/^\d+$/.test(userid)) {
+        throw new Error('BUDGETSMS_USERID must be numeric only. Found: ' + userid);
+      }
+
+      // Choose endpoint based on test mode
+      const url = test ? 'https://api.budgetsms.net/testsms/' : 'https://api.budgetsms.net/sendsms/';
+
+      // Format phone number according to E.164 (no + or 00, no spaces/dashes)
+      const formattedTo = to.replace(/^\+|^00/, '').replace(/[\s-]/g, '');
+
+      // Build query parameters
+      const queryParams = new URLSearchParams({
+        username: username,
+        userid: userid,
+        handle: handle,
+        msg: text || '', // Note: parameter is 'msg' not 'text'
+        from: from || '',
+        to: formattedTo,
+        ...(customid && { customid }),
+        ...(!test && price && { price: '1' }), // Price info only for real sends
+        ...(!test && mccmnc && { mccmnc: '1' }), // Carrier info only for real sends
+        ...(!test && credit && { credit: '1' }), // Credit info only for real sends
+        ...params,
+      });
+
+      // Make GET request
+      const fullUrl = `${url}?${queryParams.toString()}`;
+
+      const response = await fetch(fullUrl, {
+        method: 'GET',
+        headers: {
+          Accept: 'text/plain',
+          'User-Agent': 'Unchained/BudgetSMS-Plugin',
+        },
+      });
+
+      const responseText = await response.text().then((text) => text.trim());
+
+      // Parse response: "OK <smsid> [price] [parts] [mccmnc] [credit]" or "ERR <errorcode>"
+      if (responseText.startsWith('OK')) {
+        const parts = responseText.split(' ');
+        const result: any = {
+          sms_id: parts[1] || null,
+          status: test ? 'test_successful' : 'sent',
+          test_mode: test,
+        };
+
+        if (test) {
+          result.message = 'Test SMS validated successfully (no credit deducted)';
+        } else {
+          // Parse additional info based on parameters used
+          let index = 2;
+          if (price && parts[index] && parts[index + 1]) {
+            result.price = parseFloat(parts[index]);
+            result.parts = parseInt(parts[index + 1]);
+            index += 2;
+          }
+          if (mccmnc && parts[index]) {
+            result.mccmnc = parts[index];
+            index += 1;
+          }
+          if (credit && parts[index]) {
+            result.remaining_credit = parseFloat(parts[index]);
+          }
+        }
+
+        return {
+          success: true,
+          result,
+          error: null,
+        };
+      }
+
+      if (responseText.startsWith('ERR')) {
+        const parts = responseText.split(' ');
+        const errorCode = parts[1] || 'UNKNOWN';
+
+        // Error code mappings from documentation
+        const errorMessages: Record<string, string> = {
+          '1001': 'Authentication failed OR insufficient credit (BudgetSMS returns 1001 for both)',
+          '1002': 'Account not active',
+          '1003': 'Insufficient credit',
+          '1004': 'No access to this API',
+          '1005': 'No handle provided',
+          '1006': 'No UserID provided',
+          '1007': 'No Username provided',
+          '2001': 'SMS message text is empty',
+          '2002': 'SMS numeric senderid can be max. 16 numbers',
+          '2003': 'SMS alphanumeric sender can be max. 11 characters',
+          '2004': 'SMS senderid is empty or invalid',
+          '2005': 'Destination number is too short',
+          '2006': 'Destination is not numeric',
+          '2007': 'Destination is empty',
+          '2008': 'SMS text is not OK (check encoding?)',
+          '2009': 'Parameter issue',
+          '2010': 'Destination number is invalidly formatted',
+          '2011': 'Destination is invalid',
+          '2012': 'SMS message text is too long',
+          '2013': 'SMS message is invalid',
+          '2014': 'SMS CustomID is used before',
+          '2015': 'Charset problem',
+          '2016': 'Invalid UTF-8 encoding',
+          '3001': 'No route to destination',
+          '3002': 'No routes are setup',
+          '3003': 'Invalid destination',
+          '4001': 'System error, related to customid',
+          '4002': 'System error, temporary issue',
+        };
+
+        // Special handling for 1001 error
+        let message = errorMessages[errorCode] || `Unknown error code: ${errorCode}`;
+        if (errorCode === '1001') {
+          message += '. Note: Check your account balance - BudgetSMS may return 1001 when credit is 0.';
+        }
+
+        return {
+          success: false,
+          error: {
+            name: 'BUDGETSMS_ERROR',
+            code: errorCode,
+            message,
+          },
+        };
+      }
+
+      // Unexpected response
+      return {
+        success: false,
+        error: {
+          name: 'BUDGETSMS_ERROR',
+          message: 'Unexpected response format from BudgetSMS API',
+          response: responseText,
+        },
+      };
+    } catch (err) {
+      return {
+        success: false,
+        error: {
+          name: err.name,
+          message: err.message,
+          stack: err.stack,
+        },
+      };
+    }
+  },
+};
+
+WorkerDirector.registerAdapter(BudgetSMSWorker);
+
+// Environment variables needed:
+// BUDGETSMS_USERNAME=your_username (alphanumeric)
+// BUDGETSMS_USERID=your_userid (NUMERIC ONLY - found in BudgetSMS control panel)
+// BUDGETSMS_HANDLE=your_api_handle (alphanumeric - found in BudgetSMS control panel)
+
+// IMPORTANT: The userid MUST be numeric only. You can find it in the BudgetSMS control panel after login.
+// Example: BUDGETSMS_USERID=12345 (NOT "user12345" or any non-numeric value)
+
+// Usage examples:
+//
+// Send real SMS (requires credits):
+// await WorkerDirector.doWork({
+//   type: 'BUDGETSMS',
+//   from: 'YourCompany',
+//   to: '+41791234567',
+//   text: 'Your message here',
+//   price: true, // Get price info
+//   credit: true, // Get remaining credit
+// });
+//
+// Test SMS (no credit deducted):
+// await WorkerDirector.doWork({
+//   type: 'BUDGETSMS',
+//   test: true,
+//   from: 'YourCompany',
+//   to: '+41791234567',
+//   text: 'Test message',
+// });
+//
+// IMPORTANT: If you get error 1001, it could mean either:
+// 1. Authentication failed (wrong credentials)
+// 2. Insufficient credit (0 balance)
+// Use the checkBudgetSmsCredentials() helper to verify which one it is.
+
+// Helper function to check credentials and balance
+export async function checkBudgetSmsCredentials() {
+  const url = 'https://api.budgetsms.net/checkcredit/';
+  const username = process.env.BUDGETSMS_USERNAME?.trim();
+  const userid = process.env.BUDGETSMS_USERID?.trim();
+  const handle = process.env.BUDGETSMS_HANDLE?.trim();
+
+  if (!username || !userid || !handle) {
+    return { error: 'Missing credentials' };
+  }
+
+  if (!/^\d+$/.test(userid)) {
+    return { error: 'UserID must be numeric only' };
+  }
+
+  const queryParams = new URLSearchParams({ username, userid, handle });
+
+  try {
+    const response = await fetch(`${url}?${queryParams.toString()}`, { method: 'GET' });
+    const text = await response.text();
+
+    if (text.startsWith('OK')) {
+      const credit = parseFloat(text.split(' ')[1]) || 0;
+      return { success: true, credit };
+    } else {
+      return { error: text };
+    }
+  } catch (err) {
+    return { error: err.message };
+  }
+}

package/src/worker/bulkgate.ts

@@ -0,0 +1,138 @@
+import { IWorkerAdapter, WorkerAdapter, WorkerDirector } from '@unchainedshop/core';
+
+const { BULKGATE_APPLICATION_ID, BULKGATE_APPLICATION_TOKEN } = process.env;
+
+// BulkGate Simple API for SMS (transactional by default, promotional via boolean)
+const BulkGateWorker: IWorkerAdapter<
+  {
+    from?: string;
+    to?: string;
+    text?: string;
+    unicode?: boolean;
+    country?: string;
+    schedule?: string | number; // ISO 8601 format or Unix timestamp
+    promotional?: boolean; // Set to true for promotional SMS, defaults to transactional
+    [key: string]: any;
+  },
+  any
+> = {
+  ...WorkerAdapter,
+
+  key: 'shop.unchained.worker-plugin.bulkgate',
+  label: 'Send SMS through BulkGate',
+  version: '1.0.0',
+
+  type: 'BULKGATE',
+
+  doWork: async ({
+    from,
+    to,
+    text,
+    unicode = false,
+    country,
+    schedule,
+    promotional = false,
+    ...params
+  }) => {
+    try {
+      // Choose API endpoint based on promotional flag
+      const url = promotional
+        ? 'https://portal.bulkgate.com/api/1.0/simple/promotional'
+        : 'https://portal.bulkgate.com/api/1.0/simple/transactional';
+
+      // Prepare the request body
+      const requestBody = {
+        application_id: BULKGATE_APPLICATION_ID,
+        application_token: BULKGATE_APPLICATION_TOKEN,
+        number: to, // Phone number in international format (or semicolon-separated for promotional)
+        text: text || '',
+        unicode: unicode, // Boolean value for unicode support
+        sender_id: from ? 'gText' : 'gSystem', // Use text sender if 'from' is provided
+        sender_id_value: from || '', // Custom sender name if using gText
+        ...(country && { country }), // Optional country code
+        ...(schedule && { schedule }), // Optional scheduled time
+        ...params, // Any additional parameters
+      };
+
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Cache-Control': 'no-cache',
+        },
+        body: JSON.stringify(requestBody),
+      });
+
+      const responseData = await response.json();
+
+      // Check if we have an error response
+      if (responseData.error || responseData.type) {
+        return {
+          success: false,
+          error: {
+            name: 'BULKGATE_ERROR',
+            message:
+              responseData.error ||
+              `Failed to send ${promotional ? 'promotional' : 'transactional'} SMS`,
+            type: responseData.type || null,
+            code: responseData.code || response.status,
+            detail: responseData.detail || null,
+          },
+        };
+      }
+
+      // Success response (transactional has specific structure, promotional might vary)
+      if (responseData.data) {
+        // For transactional SMS, check for specific accepted status
+        if (!promotional && responseData.data.status === 'accepted') {
+          return {
+            success: true,
+            result: {
+              sms_id: responseData.data.sms_id,
+              price: responseData.data.price,
+              credit: responseData.data.credit,
+              number: responseData.data.number,
+              status: responseData.data.status,
+            },
+            error: null,
+          };
+        }
+
+        // For promotional SMS or other successful responses
+        if (promotional || responseData.data.status) {
+          return {
+            success: true,
+            result: responseData.data,
+            error: null,
+          };
+        }
+      }
+
+      // Unexpected response format
+      return {
+        success: false,
+        error: {
+          name: 'BULKGATE_ERROR',
+          message: 'Unexpected response format from BulkGate API',
+          response: responseData,
+        },
+      };
+    } catch (err) {
+      return {
+        success: false,
+        error: {
+          name: err.name,
+          message: err.message,
+          stack: err.stack,
+        },
+      };
+    }
+  },
+};
+
+// Register the plugin
+WorkerDirector.registerAdapter(BulkGateWorker);
+
+// Environment variables needed:
+// BULKGATE_APPLICATION_ID=your_application_id
+// BULKGATE_APPLICATION_TOKEN=your_application_token

package/src/worker/{sms.ts → twilio.ts}

@@ -7,38 +7,19 @@ const SmsWorkerPlugin: IWorkerAdapter<
     from?: string;
     to?: string;
     text?: string;
+    [key: string]: any; // Allow additional parameters
   },
   any
 > = {
   ...WorkerAdapter,
 
-  key: 'shop.unchained.worker-plugin.sms',
-  label: 'Send a SMS through Twilio',
+  key: 'shop.unchained.worker-plugin.twilio',
+  label: 'Send Messages through Twilio',
   version: '1.0.0',
 
-  type: 'SMS',
-
-  doWork: async ({ from, to, text }) => {
-    if (!TWILIO_SMS_FROM && !from) {
-      return {
-        success: false,
-        error: {
-          name: 'SENDER_REQUIRED',
-          message: 'SMS requires a from, TWILIO_SMS_FROM not set',
-        },
-      };
-    }
-
-    if (!to) {
-      return {
-        success: false,
-        error: {
-          name: 'RECIPIENT_REQUIRED',
-          message: 'SMS requires a to',
-        },
-      };
-    }
+  type: 'TWILIO',
 
+  doWork: async ({ from, to, text, ...params }) => {
     try {
       const url = `https://api.twilio.com/2010-04-01/Accounts/${TWILIO_ACCOUNT_SID}/Messages.json`;
       const response = await fetch(url, {
@@ -51,6 +32,7 @@ const SmsWorkerPlugin: IWorkerAdapter<
           Body: text || '',
           From: from || TWILIO_SMS_FROM,
           To: to,
+          ...params, // Include any additional parameters passed
         }),
       });