@scopieflows/app-salesforce-marketing-cloud 0.1.0

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@scopieflows/app-salesforce-marketing-cloud",
+  "version": "0.1.0",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.lib.json && cp package.json dist/",
+    "lint": "eslint 'src/**/*.ts'"
+  },
+  "dependencies": {
+    "@scopieflows/pieces-common": "0.12.0",
+    "@scopieflows/pieces-framework": "0.26.0",
+    "@scopieflows/shared": "0.50.0",
+    "tslib": "2.6.2"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export declare const sfmcAuth: import("@scopieflows/pieces-framework").OAuth2Property<import("@scopieflows/pieces-framework").OAuth2Props>;
+export declare const salesforceMarketingCloud: import("@scopieflows/pieces-framework").Piece<import("@scopieflows/pieces-framework").OAuth2Property<import("@scopieflows/pieces-framework").OAuth2Props>>;

package/src/index.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.salesforceMarketingCloud = exports.sfmcAuth = void 0;
+const tslib_1 = require("tslib");
+const pieces_framework_1 = require("@scopieflows/pieces-framework");
+const shared_1 = require("@scopieflows/shared");
+const pieces_common_1 = require("@scopieflows/pieces-common");
+const upsert_data_extension_row_1 = require("./lib/actions/upsert-data-extension-row");
+const get_data_extension_rows_1 = require("./lib/actions/get-data-extension-rows");
+const trigger_journey_event_1 = require("./lib/actions/trigger-journey-event");
+exports.sfmcAuth = pieces_framework_1.PieceAuth.OAuth2({
+    description: `Connect your Salesforce Marketing Cloud account.
+
+To set this up you need a **Connected App** in SFMC:
+
+1. In SFMC go to **Setup > Apps > Installed Packages**
+2. Click **New** and create a package
+3. Click **Add Component > API Integration > Web App**
+4. Set the redirect URI to the one shown below
+5. Select the scopes your actions need (at minimum: **Data Extensions Read/Write**, **Journeys Read/Execute**)
+6. Copy the **Client ID**, **Client Secret**, and **Auth Base URI** from the package details`,
+    required: true,
+    props: {
+        authBaseUri: pieces_framework_1.Property.ShortText({
+            displayName: 'Auth Base URI',
+            description: 'Your tenant-specific authentication subdomain. Find it in SFMC under Setup > Apps > Installed Packages — it looks like "mc123abc.auth.marketingcloudapis.com".',
+            required: true,
+        }),
+    },
+    authUrl: 'https://{authBaseUri}/v2/authorize',
+    tokenUrl: 'https://{authBaseUri}/v2/token',
+    scope: ['offline'],
+    validate: (_a) => tslib_1.__awaiter(void 0, [_a], void 0, function* ({ auth }) {
+        var _b;
+        try {
+            const authValue = auth;
+            const restInstanceUrl = (_b = authValue.data) === null || _b === void 0 ? void 0 : _b['rest_instance_url'];
+            if (!restInstanceUrl) {
+                return {
+                    valid: false,
+                    error: 'Missing rest_instance_url in token response. Ensure your connected app has the required API scopes.',
+                };
+            }
+            yield pieces_common_1.httpClient.sendRequest({
+                method: pieces_common_1.HttpMethod.GET,
+                url: `${restInstanceUrl.replace(/\/$/, '')}/platform/v1/endpoints`,
+                authentication: {
+                    type: pieces_common_1.AuthenticationType.BEARER_TOKEN,
+                    token: authValue.access_token,
+                },
+            });
+            return { valid: true };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('ENOTFOUND') || message.includes('getaddrinfo')) {
+                return {
+                    valid: false,
+                    error: 'Could not reach SFMC. Check your Auth Base URI.',
+                };
+            }
+            return {
+                valid: false,
+                error: `Connection test failed: ${message}`,
+            };
+        }
+    }),
+});
+exports.salesforceMarketingCloud = (0, pieces_framework_1.createPiece)({
+    displayName: 'Salesforce Marketing Cloud',
+    description: 'Digital marketing automation and analytics platform for email, mobile, social, and web marketing.',
+    minimumSupportedRelease: '0.36.1',
+    logoUrl: '/pieces/salesforce-marketing-cloud.png',
+    categories: [shared_1.PieceCategory.MARKETING],
+    auth: exports.sfmcAuth,
+    authors: [],
+    actions: [
+        upsert_data_extension_row_1.upsertDataExtensionRow,
+        get_data_extension_rows_1.getDataExtensionRows,
+        trigger_journey_event_1.triggerJourneyEvent,
+        (0, pieces_common_1.createCustomApiCallAction)({
+            baseUrl: (auth) => {
+                var _a;
+                const restInstanceUrl = (_a = auth.data) === null || _a === void 0 ? void 0 : _a['rest_instance_url'];
+                return restInstanceUrl
+                    ? restInstanceUrl.replace(/\/$/, '')
+                    : '';
+            },
+            auth: exports.sfmcAuth,
+            authMapping: (auth) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+                return ({
+                    Authorization: `Bearer ${auth.access_token}`,
+                });
+            }),
+        }),
+    ],
+    triggers: [],
+});
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,oEAKuC;AACvC,gDAAoD;AACpD,8DAKoC;AACpC,uFAAiF;AACjF,mFAA6E;AAC7E,+EAA0E;AAE7D,QAAA,QAAQ,GAAG,4BAAS,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE;;;;;;;;;6FAS+E;IAC5F,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE;QACN,WAAW,EAAE,2BAAQ,CAAC,SAAS,CAAC;YAC/B,WAAW,EAAE,eAAe;YAC5B,WAAW,EACV,gKAAgK;YACjK,QAAQ,EAAE,IAAI;SACd,CAAC;KACF;IACD,OAAO,EAAE,oCAAoC;IAC7C,QAAQ,EAAE,gCAAgC;IAC1C,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,QAAQ,EAAE,KAAiB,EAAE,oDAAZ,EAAE,IAAI,EAAE;;QACxB,IAAI,CAAC;YACJ,MAAM,SAAS,GAAG,IAA2B,CAAC;YAC9C,MAAM,eAAe,GAAG,MAAA,SAAS,CAAC,IAAI,0CAAG,mBAAmB,CAEhD,CAAC;YACb,IAAI,CAAC,eAAe,EAAE,CAAC;gBACtB,OAAO;oBACN,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,qGAAqG;iBAC5G,CAAC;YACH,CAAC;YACD,MAAM,0BAAU,CAAC,WAAW,CAAC;gBAC5B,MAAM,EAAE,0BAAU,CAAC,GAAG;gBACtB,GAAG,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB;gBAClE,cAAc,EAAE;oBACf,IAAI,EAAE,kCAAkB,CAAC,YAAY;oBACrC,KAAK,EAAE,SAAS,CAAC,YAAY;iBAC7B;aACD,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBACtE,OAAO;oBACN,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,iDAAiD;iBACxD,CAAC;YACH,CAAC;YACD,OAAO;gBACN,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,2BAA2B,OAAO,EAAE;aAC3C,CAAC;QACH,CAAC;IACF,CAAC,CAAA;CACD,CAAC,CAAC;AAEU,QAAA,wBAAwB,GAAG,IAAA,8BAAW,EAAC;IACnD,WAAW,EAAE,4BAA4B;IACzC,WAAW,EACV,mGAAmG;IACpG,uBAAuB,EAAE,QAAQ;IACjC,OAAO,EAAE,wCAAwC;IACjD,UAAU,EAAE,CAAC,sBAAa,CAAC,SAAS,CAAC;IACrC,IAAI,EAAE,gBAAQ;IACd,OAAO,EAAE,EAAE;IACX,OAAO,EAAE;QACR,kDAAsB;QACtB,8CAAoB;QACpB,2CAAmB;QACnB,IAAA,yCAAyB,EAAC;YACzB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;;gBACjB,MAAM,eAAe,GAAG,MAAC,IAA4B,CAAC,IAAI,0CACzD,mBAAmB,CACG,CAAC;gBACxB,OAAO,eAAe;oBACrB,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;oBACpC,CAAC,CAAC,EAAE,CAAC;YACP,CAAC;YACD,IAAI,EAAE,gBAAQ;YACd,WAAW,EAAE,CAAO,IAAI,EAAE,EAAE;gBAAC,OAAA,CAAC;oBAC7B,aAAa,EAAE,UAAW,IAA4B,CAAC,YAAY,EAAE;iBACrE,CAAC,CAAA;cAAA;SACF,CAAC;KACF;IACD,QAAQ,EAAE,EAAE;CACZ,CAAC,CAAC"}

package/src/lib/actions/get-data-extension-rows.d.ts

@@ -0,0 +1,7 @@
+export declare const getDataExtensionRows: import("@scopieflows/pieces-framework").IAction<import("@scopieflows/pieces-framework").OAuth2Property<import("@scopieflows/pieces-framework").OAuth2Props>, {
+    externalKey: import("@scopieflows/pieces-framework").ShortTextProperty<true>;
+    top: import("@scopieflows/pieces-framework").NumberProperty<false>;
+    skip: import("@scopieflows/pieces-framework").NumberProperty<false>;
+    orderBy: import("@scopieflows/pieces-framework").ShortTextProperty<false>;
+    filter: import("@scopieflows/pieces-framework").ShortTextProperty<false>;
+}>;

package/src/lib/actions/get-data-extension-rows.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDataExtensionRows = void 0;
+const tslib_1 = require("tslib");
+const pieces_framework_1 = require("@scopieflows/pieces-framework");
+const pieces_common_1 = require("@scopieflows/pieces-common");
+const __1 = require("../../");
+const common_1 = require("../common");
+exports.getDataExtensionRows = (0, pieces_framework_1.createAction)({
+    auth: __1.sfmcAuth,
+    name: 'get_data_extension_rows',
+    displayName: 'Get Data Extension Rows',
+    description: 'Retrieves rows from a Data Extension. Returns up to the specified number of rows.',
+    props: {
+        externalKey: pieces_framework_1.Property.ShortText({
+            displayName: 'Data Extension External Key',
+            description: 'The external key of the Data Extension. Find it in SFMC under Email Studio > Subscribers > Data Extensions — click the Data Extension and copy the "External Key" value.',
+            required: true,
+        }),
+        top: pieces_framework_1.Property.Number({
+            displayName: 'Max Rows',
+            description: 'Maximum number of rows to return.',
+            required: false,
+            defaultValue: 50,
+        }),
+        skip: pieces_framework_1.Property.Number({
+            displayName: 'Skip Rows',
+            description: 'Number of rows to skip (for pagination).',
+            required: false,
+            defaultValue: 0,
+        }),
+        orderBy: pieces_framework_1.Property.ShortText({
+            displayName: 'Order By',
+            description: 'Column name to sort results by (e.g. "EmailAddress asc" or "CreatedDate desc"). Leave empty for default order.',
+            required: false,
+        }),
+        filter: pieces_framework_1.Property.ShortText({
+            displayName: 'Filter',
+            description: 'Simple filter expression (e.g. "Status eq \'Active\'"). Leave empty to return all rows. See SFMC REST API docs for filter syntax.',
+            required: false,
+        }),
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { externalKey, top, skip, orderBy, filter } = context.propsValue;
+            const auth = context.auth;
+            const queryParams = {};
+            if (top !== undefined && top !== null) {
+                queryParams['$top'] = String(top);
+            }
+            if (skip !== undefined && skip !== null && skip > 0) {
+                queryParams['$skip'] = String(skip);
+            }
+            if (orderBy) {
+                queryParams['$orderBy'] = orderBy;
+            }
+            if (filter) {
+                queryParams['$filter'] = filter;
+            }
+            const response = yield (0, common_1.sfmcApiCall)({
+                auth,
+                method: pieces_common_1.HttpMethod.GET,
+                path: `/data/v1/customobjectdata/key/${encodeURIComponent(externalKey)}/rowset`,
+                queryParams,
+            });
+            const items = (_a = response.body.items) !== null && _a !== void 0 ? _a : [];
+            return items.map((item) => {
+                const flat = {};
+                for (const [key, value] of Object.entries(item)) {
+                    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                        for (const [nestedKey, nestedValue] of Object.entries(value)) {
+                            flat[`${key}_${nestedKey}`] = nestedValue !== null && nestedValue !== void 0 ? nestedValue : null;
+                        }
+                    }
+                    else if (Array.isArray(value)) {
+                        flat[key] = value
+                            .map((v) => (typeof v === 'object' ? JSON.stringify(v) : String(v)))
+                            .join(', ');
+                    }
+                    else {
+                        flat[key] = value !== null && value !== void 0 ? value : null;
+                    }
+                }
+                return flat;
+            });
+        });
+    },
+});
+//# sourceMappingURL=get-data-extension-rows.js.map

package/src/lib/actions/get-data-extension-rows.js.map

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

package/src/lib/actions/trigger-journey-event.d.ts

@@ -0,0 +1,5 @@
+export declare const triggerJourneyEvent: import("@scopieflows/pieces-framework").IAction<import("@scopieflows/pieces-framework").OAuth2Property<import("@scopieflows/pieces-framework").OAuth2Props>, {
+    eventDefinitionKey: import("@scopieflows/pieces-framework").ShortTextProperty<true>;
+    contactKey: import("@scopieflows/pieces-framework").ShortTextProperty<true>;
+    data: import("@scopieflows/pieces-framework").ObjectProperty<false>;
+}>;

package/src/lib/actions/trigger-journey-event.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.triggerJourneyEvent = void 0;
+const tslib_1 = require("tslib");
+const pieces_framework_1 = require("@scopieflows/pieces-framework");
+const pieces_common_1 = require("@scopieflows/pieces-common");
+const __1 = require("../../");
+const common_1 = require("../common");
+exports.triggerJourneyEvent = (0, pieces_framework_1.createAction)({
+    auth: __1.sfmcAuth,
+    name: 'trigger_journey_event',
+    displayName: 'Trigger Journey Event',
+    description: 'Fires an entry event to inject a contact into a Journey Builder journey.',
+    props: {
+        eventDefinitionKey: pieces_framework_1.Property.ShortText({
+            displayName: 'Event Definition Key',
+            description: 'The unique key of the journey entry event. Find it in Journey Builder: open the journey, click the entry event, and copy the "Event Definition Key".',
+            required: true,
+        }),
+        contactKey: pieces_framework_1.Property.ShortText({
+            displayName: 'Contact Key',
+            description: 'The unique identifier for the contact entering the journey (usually the Subscriber Key or email address).',
+            required: true,
+        }),
+        data: pieces_framework_1.Property.Object({
+            displayName: 'Event Data',
+            description: 'Key-value pairs to pass as event data to the journey (e.g. {"EmailAddress": "john@example.com", "FirstName": "John"}).',
+            required: false,
+        }),
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { eventDefinitionKey, contactKey, data } = context.propsValue;
+            const auth = context.auth;
+            const payload = {
+                ContactKey: contactKey,
+                EventDefinitionKey: eventDefinitionKey,
+            };
+            if (data && Object.keys(data).length > 0) {
+                payload['Data'] = data;
+            }
+            const response = yield (0, common_1.sfmcApiCall)({
+                auth,
+                method: pieces_common_1.HttpMethod.POST,
+                path: '/interaction/v1/events',
+                body: payload,
+            });
+            const body = response.body;
+            const flat = {};
+            for (const [key, value] of Object.entries(body)) {
+                if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                    for (const [nestedKey, nestedValue] of Object.entries(value)) {
+                        flat[`${key}_${nestedKey}`] = nestedValue !== null && nestedValue !== void 0 ? nestedValue : null;
+                    }
+                }
+                else {
+                    flat[key] = value !== null && value !== void 0 ? value : null;
+                }
+            }
+            return flat;
+        });
+    },
+});
+//# sourceMappingURL=trigger-journey-event.js.map

package/src/lib/actions/trigger-journey-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-journey-event.js","sourceRoot":"","sources":["../../../../src/lib/actions/trigger-journey-event.ts"],"names":[],"mappings":";;;;AAAA,oEAAuE;AACvE,8DAAwD;AACxD,8BAAkC;AAClC,sCAAwC;AAG3B,QAAA,mBAAmB,GAAG,IAAA,+BAAY,EAAC;IAC/C,IAAI,EAAE,YAAQ;IACd,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,WAAW,EACV,0EAA0E;IAC3E,KAAK,EAAE;QACN,kBAAkB,EAAE,2BAAQ,CAAC,SAAS,CAAC;YACtC,WAAW,EAAE,sBAAsB;YACnC,WAAW,EACV,sJAAsJ;YACvJ,QAAQ,EAAE,IAAI;SACd,CAAC;QACF,UAAU,EAAE,2BAAQ,CAAC,SAAS,CAAC;YAC9B,WAAW,EAAE,aAAa;YAC1B,WAAW,EACV,2GAA2G;YAC5G,QAAQ,EAAE,IAAI;SACd,CAAC;QACF,IAAI,EAAE,2BAAQ,CAAC,MAAM,CAAC;YACrB,WAAW,EAAE,YAAY;YACzB,WAAW,EACV,wHAAwH;YACzH,QAAQ,EAAE,KAAK;SACf,CAAC;KACF;IACK,GAAG,CAAC,OAAO;;YAChB,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;YACpE,MAAM,IAAI,GAAG,OAAO,CAAC,IAA2B,CAAC;YAEjD,MAAM,OAAO,GAA4B;gBACxC,UAAU,EAAE,UAAU;gBACtB,kBAAkB,EAAE,kBAAkB;aACtC,CAAC;YACF,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;YACxB,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAW,EAA0B;gBAC3D,IAAI;gBACJ,MAAM,EAAE,0BAAU,CAAC,IAAI;gBACvB,IAAI,EAAE,wBAAwB;gBAC9B,IAAI,EAAE,OAAO;aACb,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC3B,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1E,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CACpD,KAAgC,CAChC,EAAE,CAAC;wBACH,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,IAAI,CAAC;oBACnD,CAAC;gBACF,CAAC;qBAAM,CAAC;oBACP,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,IAAI,CAAC;gBAC3B,CAAC;YACF,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC;KAAA;CACD,CAAC,CAAC"}

package/src/lib/actions/upsert-data-extension-row.d.ts

@@ -0,0 +1,4 @@
+export declare const upsertDataExtensionRow: import("@scopieflows/pieces-framework").IAction<import("@scopieflows/pieces-framework").OAuth2Property<import("@scopieflows/pieces-framework").OAuth2Props>, {
+    externalKey: import("@scopieflows/pieces-framework").ShortTextProperty<true>;
+    rows: import("@scopieflows/pieces-framework").JsonProperty<true>;
+}>;

package/src/lib/actions/upsert-data-extension-row.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upsertDataExtensionRow = void 0;
+const tslib_1 = require("tslib");
+const pieces_framework_1 = require("@scopieflows/pieces-framework");
+const pieces_common_1 = require("@scopieflows/pieces-common");
+const __1 = require("../../");
+const common_1 = require("../common");
+exports.upsertDataExtensionRow = (0, pieces_framework_1.createAction)({
+    auth: __1.sfmcAuth,
+    name: 'upsert_data_extension_row',
+    displayName: 'Create or Update Data Extension Row',
+    description: 'Inserts or updates one or more rows in a Data Extension. If a row with the same primary key exists, it will be updated; otherwise a new row is created.',
+    props: {
+        externalKey: pieces_framework_1.Property.ShortText({
+            displayName: 'Data Extension External Key',
+            description: 'The external key of the Data Extension. Find it in SFMC under Email Studio > Subscribers > Data Extensions — click the Data Extension and copy the "External Key" value.',
+            required: true,
+        }),
+        rows: pieces_framework_1.Property.Json({
+            displayName: 'Row Data (JSON)',
+            description: 'A JSON array of objects to upsert. Each object should have a "keys" property with column name/value pairs.\n\nExample:\n```json\n[{"keys": {"EmailAddress": "john@example.com", "FirstName": "John"}}]\n```\n\nFor a single row you can also pass just the keys object:\n```json\n{"EmailAddress": "john@example.com", "FirstName": "John"}\n```',
+            required: true,
+        }),
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { externalKey, rows } = context.propsValue;
+            const auth = context.auth;
+            const parsed = typeof rows === 'string' ? JSON.parse(rows) : rows;
+            let payload;
+            if (Array.isArray(parsed)) {
+                payload = parsed.map((item) => item['keys'] ? item : { keys: item });
+            }
+            else {
+                payload = [{ keys: parsed }];
+            }
+            const response = yield (0, common_1.sfmcApiCall)({
+                auth,
+                method: pieces_common_1.HttpMethod.POST,
+                path: `/hub/v1/dataevents/key:${encodeURIComponent(externalKey)}/rowset`,
+                body: payload,
+            });
+            return response.body;
+        });
+    },
+});
+//# sourceMappingURL=upsert-data-extension-row.js.map

package/src/lib/actions/upsert-data-extension-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-data-extension-row.js","sourceRoot":"","sources":["../../../../src/lib/actions/upsert-data-extension-row.ts"],"names":[],"mappings":";;;;AAAA,oEAAuE;AACvE,8DAAwD;AACxD,8BAAkC;AAClC,sCAAwC;AAG3B,QAAA,sBAAsB,GAAG,IAAA,+BAAY,EAAC;IAClD,IAAI,EAAE,YAAQ;IACd,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,qCAAqC;IAClD,WAAW,EACV,yJAAyJ;IAC1J,KAAK,EAAE;QACN,WAAW,EAAE,2BAAQ,CAAC,SAAS,CAAC;YAC/B,WAAW,EAAE,6BAA6B;YAC1C,WAAW,EACV,0KAA0K;YAC3K,QAAQ,EAAE,IAAI;SACd,CAAC;QACF,IAAI,EAAE,2BAAQ,CAAC,IAAI,CAAC;YACnB,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EACV,kVAAkV;YACnV,QAAQ,EAAE,IAAI;SACd,CAAC;KACF;IACK,GAAG,CAAC,OAAO;;YAChB,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;YACjD,MAAM,IAAI,GAAG,OAAO,CAAC,IAA2B,CAAC;YAEjD,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAElE,IAAI,OAAkC,CAAC;YACvC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAA6B,EAAE,EAAE,CACtD,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CACpC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACP,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAW,EAA0B;gBAC3D,IAAI;gBACJ,MAAM,EAAE,0BAAU,CAAC,IAAI;gBACvB,IAAI,EAAE,0BAA0B,kBAAkB,CAAC,WAAW,CAAC,SAAS;gBACxE,IAAI,EAAE,OAAO;aACb,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;QACtB,CAAC;KAAA;CACD,CAAC,CAAC"}

package/src/lib/common/index.d.ts

@@ -0,0 +1,9 @@
+import { HttpMethod, HttpMessageBody, HttpResponse } from '@scopieflows/pieces-common';
+import { OAuth2PropertyValue } from '@scopieflows/pieces-framework';
+export declare function sfmcApiCall<T extends HttpMessageBody>({ auth, method, path, body, queryParams, }: {
+    auth: OAuth2PropertyValue;
+    method: HttpMethod;
+    path: string;
+    body?: unknown;
+    queryParams?: Record<string, string>;
+}): Promise<HttpResponse<T>>;

package/src/lib/common/index.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sfmcApiCall = sfmcApiCall;
+const tslib_1 = require("tslib");
+const pieces_common_1 = require("@scopieflows/pieces-common");
+function getRestInstanceUrl(auth) {
+    var _a;
+    const restInstanceUrl = (_a = auth.data) === null || _a === void 0 ? void 0 : _a['rest_instance_url'];
+    if (!restInstanceUrl) {
+        throw new Error('Missing rest_instance_url in OAuth response. This usually means the SFMC connected app does not have the correct API permissions enabled.');
+    }
+    return restInstanceUrl.replace(/\/$/, '');
+}
+function mapSfmcError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes('ENOTFOUND') || message.includes('getaddrinfo')) {
+        throw new Error('Could not reach the SFMC auth endpoint. Check your Auth Base URI — it should look like "mc123abc.auth.marketingcloudapis.com".');
+    }
+    if (message.includes('invalid_client') || message.includes('Unauthorized')) {
+        throw new Error('Authentication failed. Check your Client ID, Client Secret, and that the connected app has the required package scopes.');
+    }
+    if (message.includes('redirect_uri')) {
+        throw new Error('Redirect URI mismatch. The redirect URI configured in your SFMC connected app must exactly match the one used by ScopieFlows (no trailing slash differences).');
+    }
+    throw new Error(`SFMC API error: ${message}`);
+}
+function sfmcApiCall(_a) {
+    return tslib_1.__awaiter(this, arguments, void 0, function* ({ auth, method, path, body, queryParams, }) {
+        const baseUrl = getRestInstanceUrl(auth);
+        try {
+            return yield pieces_common_1.httpClient.sendRequest({
+                method,
+                url: `${baseUrl}${path}`,
+                authentication: {
+                    type: pieces_common_1.AuthenticationType.BEARER_TOKEN,
+                    token: auth.access_token,
+                },
+                queryParams,
+                body,
+            });
+        }
+        catch (error) {
+            mapSfmcError(error);
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/src/lib/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/common/index.ts"],"names":[],"mappings":";;AAyCA,kCA4BC;;AArED,8DAMoC;AAGpC,SAAS,kBAAkB,CAAC,IAAyB;;IACpD,MAAM,eAAe,GAAG,MAAA,IAAI,CAAC,IAAI,0CAAG,mBAAmB,CAAuB,CAAC;IAC/E,IAAI,CAAC,eAAe,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACd,2IAA2I,CAC3I,CAAC;IACH,CAAC;IACD,OAAO,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IACnC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CACd,gIAAgI,CAChI,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CACd,yHAAyH,CACzH,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACd,+JAA+J,CAC/J,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAsB,WAAW;iEAA4B,EAC5D,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,WAAW,GAOX;QACA,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC;YACJ,OAAO,MAAM,0BAAU,CAAC,WAAW,CAAI;gBACtC,MAAM;gBACN,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,EAAE;gBACxB,cAAc,EAAE;oBACf,IAAI,EAAE,kCAAkB,CAAC,YAAY;oBACrC,KAAK,EAAE,IAAI,CAAC,YAAY;iBACxB;gBACD,WAAW;gBACX,IAAI;aACJ,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;CAAA"}