add users merge

Author: gmethvin

COMMANDS.md

@@ -1,4 +1,4 @@
-# Available Commands (109)
+# Available Commands (110)
 
 All commands follow the pattern: `iterable <category> <command> [options]`
 
@@ -1426,7 +1426,7 @@ iterable templates upsert-sms <clientTemplateId>
 | `--name` | string | no | Template name |
 
 
-## users (12)
+## users (13)
 
 ### bulk-update
 
@@ -1539,6 +1539,22 @@ iterable users get-sent-messages
 | `--startDateTime` | string | no | Start date time (yyyy-MM-dd HH:mm:ss ZZ) |
 | `--userId` | string | no | User ID (alternative to email) |
 
+### merge
+
+Merge two user profiles — all data and events from source are migrated to destination
+
+```
+iterable users merge
+```
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `--arrayMerge` | json[] | no | Array fields whose contents should be merged (only custom arrays, not Iterable-managed ones like devices) |
+| `--destinationEmail` | string | no | Email of the destination user profile to merge into |
+| `--destinationUserId` | string | no | User ID of the destination user profile to merge into |
+| `--sourceEmail` | string | no | Email of the source user profile to merge from |
+| `--sourceUserId` | string | no | User ID of the source user profile to merge from |
+
 ### update
 
 Update user profile information (accepts email OR userId)

package.json

@@ -59,7 +59,7 @@
     "update-commands": "node scripts/update-commands.js"
   },
   "dependencies": {
-    "@iterable/api": "0.10.1",
+    "@iterable/api": "0.10.2",
     "@primno/dpapi": "2.0.1",
     "boxen": "8.0.1",
     "chalk": "5.6.2",

pnpm-lock.yaml

@@ -5,6 +5,7 @@ import {
   GetSentMessagesParamsSchema,
   GetUserByEmailParamsSchema,
   GetUserByIdParamsSchema,
+  MergeUsersParamsSchema,
   UpdateEmailParamsSchema,
   UpdateUserParamsSchema,
   UpdateUserSubscriptionsParamsSchema,
@@ -116,4 +117,13 @@ export const userCommands: CommandDefinition[] = [
     schema: z.object({}),
     execute: (client) => client.getUserFields(),
   }),
+  defineCommand({
+    category: "users",
+    name: "merge",
+    description:
+      "Merge two user profiles — all data and events from source are migrated to destination",
+    clientMethod: "mergeUsers",
+    schema: MergeUsersParamsSchema,
+    destructive: true,
+  }),
 ];

src/commands/users.ts

@@ -112,6 +112,7 @@ const EXPECTED_COMMANDS = [
   "users:get-by-userid",
   "users:get-fields",
   "users:get-sent-messages",
+  "users:merge",
   "users:update",
   "users:update-email",
   "users:update-subscriptions",