@walkeros/server-destination-aws 4.7.0-next-1790722899482 → 4.7.0

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/server-destination-aws",
-    "version": "4.7.0-next-1790722899482",
+    "version": "4.7.0",
     "type": "destination",
     "platform": [
       "server"
@@ -21,22 +21,19 @@
         "streamName": {
           "type": "string",
           "minLength": 1,
-          "description": "Name of the Kinesis Data Firehose delivery stream (like walker-events)"
+          "description": "Name of the Firehose stream (like walkeros-events). Required."
         },
         "client": {
-          "description": "Pre-configured AWS Firehose client instance (like new FirehoseClient(config))"
+          "description": "A FirehoseClient of your own. Used as is and never closed by the destination."
         },
         "region": {
           "type": "string",
-          "description": "AWS region for the Firehose service (like us-east-1)"
+          "description": "AWS region of the stream (like eu-central-1). Default: AWS_REGION or the active profile, else eu-central-1."
         },
         "config": {
-          "description": "AWS SDK client configuration options (like { credentials: awsCredentials })"
+          "description": "Raw FirehoseClient options passed to the SDK (like { endpoint, maxAttempts }). Put keys in config.credentials instead."
         }
       },
-      "required": [
-        "streamName"
-      ],
       "additionalProperties": false
     },
     "firehoseMapping": {
@@ -49,30 +46,46 @@
       "$schema": "http://json-schema.org/draft-07/schema#",
       "type": "object",
       "properties": {
+        "streamName": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Name of the Firehose stream (like walkeros-events). Required."
+        },
+        "region": {
+          "type": "string",
+          "description": "AWS region of the stream (like eu-central-1). Default: AWS_REGION or the active profile, else eu-central-1."
+        },
+        "newline": {
+          "type": "boolean",
+          "description": "Append a newline to every record (default true). Set false when the stream adds its own new line delimiter."
+        },
+        "config": {
+          "description": "Raw FirehoseClient options passed to the SDK (like { endpoint, maxAttempts }). Put keys in config.credentials instead."
+        },
+        "client": {
+          "description": "A FirehoseClient of your own. Used as is and never closed by the destination."
+        },
         "firehose": {
           "type": "object",
           "properties": {
             "streamName": {
               "type": "string",
               "minLength": 1,
-              "description": "Name of the Kinesis Data Firehose delivery stream (like walker-events)"
+              "description": "Name of the Firehose stream (like walkeros-events). Required."
             },
             "client": {
-              "description": "Pre-configured AWS Firehose client instance (like new FirehoseClient(config))"
+              "description": "A FirehoseClient of your own. Used as is and never closed by the destination."
             },
             "region": {
               "type": "string",
-              "description": "AWS region for the Firehose service (like us-east-1)"
+              "description": "AWS region of the stream (like eu-central-1). Default: AWS_REGION or the active profile, else eu-central-1."
             },
             "config": {
-              "description": "AWS SDK client configuration options (like { credentials: awsCredentials })"
+              "description": "Raw FirehoseClient options passed to the SDK (like { endpoint, maxAttempts }). Put keys in config.credentials instead."
             }
           },
-          "required": [
-            "streamName"
-          ],
           "additionalProperties": false,
-          "description": "AWS Firehose configuration settings (like { streamName: 'walker-events', region: 'us-east-1' })",
+          "description": "Deprecated: use the flat fields streamName, region, config and client.",
           "title": "firehose"
         }
       },
@@ -88,30 +101,46 @@
       "$schema": "http://json-schema.org/draft-07/schema#",
       "type": "object",
       "properties": {
+        "streamName": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Name of the Firehose stream (like walkeros-events). Required."
+        },
+        "region": {
+          "type": "string",
+          "description": "AWS region of the stream (like eu-central-1). Default: AWS_REGION or the active profile, else eu-central-1."
+        },
+        "newline": {
+          "type": "boolean",
+          "description": "Append a newline to every record (default true). Set false when the stream adds its own new line delimiter."
+        },
+        "config": {
+          "description": "Raw FirehoseClient options passed to the SDK (like { endpoint, maxAttempts }). Put keys in config.credentials instead."
+        },
+        "client": {
+          "description": "A FirehoseClient of your own. Used as is and never closed by the destination."
+        },
         "firehose": {
           "type": "object",
           "properties": {
             "streamName": {
               "type": "string",
               "minLength": 1,
-              "description": "Name of the Kinesis Data Firehose delivery stream (like walker-events)"
+              "description": "Name of the Firehose stream (like walkeros-events). Required."
             },
             "client": {
-              "description": "Pre-configured AWS Firehose client instance (like new FirehoseClient(config))"
+              "description": "A FirehoseClient of your own. Used as is and never closed by the destination."
             },
             "region": {
               "type": "string",
-              "description": "AWS region for the Firehose service (like us-east-1)"
+              "description": "AWS region of the stream (like eu-central-1). Default: AWS_REGION or the active profile, else eu-central-1."
             },
             "config": {
-              "description": "AWS SDK client configuration options (like { credentials: awsCredentials })"
+              "description": "Raw FirehoseClient options passed to the SDK (like { endpoint, maxAttempts }). Put keys in config.credentials instead."
             }
           },
-          "required": [
-            "streamName"
-          ],
           "additionalProperties": false,
-          "description": "AWS Firehose configuration settings (like { streamName: 'walker-events', region: 'us-east-1' })",
+          "description": "Deprecated: use the flat fields streamName, region, config and client.",
           "title": "firehose"
         }
       },
@@ -137,29 +166,26 @@
       "$schema": "http://json-schema.org/draft-07/schema#",
       "type": "object",
       "properties": {
+        "topicArn": {
+          "type": "string",
+          "description": "Topic ARN (like arn:aws:sns:eu-central-1:123456789012:walkeros-events). Region and topic name derive from it. Required unless topicName is set."
+        },
         "topicName": {
           "type": "string",
           "minLength": 1,
-          "description": "SNS topic name (like walkeros-events). Required."
+          "description": "Topic name (like walkeros-events). Used by walkeros setup; without topicArn the ARN is completed with the account id at the first publish."
         },
         "region": {
           "type": "string",
-          "description": "AWS region (like eu-central-1)."
+          "description": "AWS region (like eu-central-1). Default: the region in topicArn, AWS_REGION or the active profile, else eu-central-1."
         },
         "client": {
-          "description": "Pre-configured AWS SNSClient instance."
+          "description": "An SNSClient of your own. Used as is and never closed by the destination."
         },
         "config": {
-          "description": "AWS SDK SNSClient configuration options."
-        },
-        "topicArn": {
-          "type": "string",
-          "description": "Topic ARN. Populated by init() from CreateTopic. Operators may pre-set to skip the runtime CreateTopic call."
+          "description": "Raw SNSClient options passed to the SDK. Put keys in config.credentials instead."
         }
       },
-      "required": [
-        "topicName"
-      ],
       "additionalProperties": false
     },
     "snsSetup": {
@@ -237,7 +263,7 @@
       "push": {
         "AWS": {
           "FirehoseClient": {
-            "$code": "class{config;constructor(e){this.config=e}async send(e){return{RecordId:\"mock-record-id\",ResponseMetadata:{RequestId:\"mock-request-id\"}}}}"
+            "$code": "class{config;constructor(e){this.config=e}async send(e){const t=\"input\"in e?e.input:void 0;var i;return{FailedPutCount:0,Encrypted:!1,RequestResponses:(\"object\"==typeof(i=t)&&null!==i&&\"Records\"in i&&Array.isArray(i.Records)?t.Records:[]).map((e,t)=>({RecordId:`mock-record-id-${t}`}))}}destroy(){}}"
           },
           "PutRecordBatchCommand": {
             "$code": "class{input;constructor(e){this.input=e}get[Symbol.toStringTag](){return\"PutRecordBatchCommand\"}}"
@@ -253,7 +279,7 @@
         "push": {
           "AWS": {
             "FirehoseClient": {
-              "$code": "class{config;constructor(e){this.config=e}async send(e){return{RecordId:\"mock-record-id\",ResponseMetadata:{RequestId:\"mock-request-id\"}}}}"
+              "$code": "class{config;constructor(e){this.config=e}async send(e){const t=\"input\"in e?e.input:void 0;var i;return{FailedPutCount:0,Encrypted:!1,RequestResponses:(\"object\"==typeof(i=t)&&null!==i&&\"Records\"in i&&Array.isArray(i.Records)?t.Records:[]).map((e,t)=>({RecordId:`mock-record-id-${t}`}))}}destroy(){}}"
             },
             "PutRecordBatchCommand": {
               "$code": "class{input;constructor(e){this.input=e}get[Symbol.toStringTag](){return\"PutRecordBatchCommand\"}}"
@@ -267,7 +293,7 @@
       "step": {
         "firehoseRecord": {
           "title": "Page view record",
-          "description": "A page view is sent to Kinesis Firehose as a single record with the full event JSON-stringified into the Data buffer.",
+          "description": "A page view is sent to Firehose as one record: the full event as JSON followed by a newline.",
           "in": {
             "name": "page view",
             "data": {
@@ -844,7 +870,236 @@
                       "518": 114,
                       "519": 34,
                       "520": 125,
-                      "521": 125
+                      "521": 125,
+                      "522": 10
+                    }
+                  }
+                ]
+              }
+            ]
+          ]
+        },
+        "init": {
+          "title": "Initialization",
+          "description": "Init builds one FirehoseClient for the stream region with the credentials from config.credentials and a 2500 ms per-attempt timeout. Nothing is sent until the first event.",
+          "in": {
+            "settings": {
+              "streamName": "walkeros-events",
+              "region": "eu-central-1"
+            },
+            "credentials": {
+              "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+              "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+            }
+          },
+          "out": [
+            [
+              "new FirehoseClient",
+              {
+                "region": "eu-central-1",
+                "credentials": {
+                  "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+                  "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+                },
+                "requestHandler": {
+                  "requestTimeout": 2500,
+                  "throwOnRequestTimeout": true
+                }
+              }
+            ]
+          ]
+        },
+        "mappedRecord": {
+          "title": "Mapped record",
+          "description": "A mapping that produces an object sends that object as the record instead of the full event. Keep the event id in it for deduplication.",
+          "in": {
+            "name": "order complete",
+            "data": {
+              "id": "ORD-400",
+              "total": 99.99,
+              "currency": "EUR"
+            },
+            "context": {
+              "shopping": [
+                "complete",
+                0
+              ]
+            },
+            "globals": {
+              "pagegroup": "shop"
+            },
+            "custom": {
+              "completely": "random"
+            },
+            "user": {
+              "id": "us3r",
+              "device": "c00k13",
+              "session": "s3ss10n"
+            },
+            "nested": [
+              {
+                "entity": "product",
+                "data": {
+                  "id": "ers",
+                  "name": "Everyday Ruck Snack",
+                  "color": "black",
+                  "size": "l",
+                  "price": 420
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              },
+              {
+                "entity": "product",
+                "data": {
+                  "id": "cc",
+                  "name": "Cool Cap",
+                  "size": "one size",
+                  "price": 42
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              },
+              {
+                "entity": "gift",
+                "data": {
+                  "name": "Surprise"
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              }
+            ],
+            "consent": {
+              "functional": true
+            },
+            "id": "ev-1700001001",
+            "trigger": "load",
+            "entity": "order",
+            "action": "complete",
+            "timestamp": 1700001001,
+            "timing": 3.14,
+            "source": {
+              "count": 1,
+              "trace": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
+              "type": "express",
+              "platform": "server"
+            }
+          },
+          "mapping": {
+            "data": {
+              "map": {
+                "id": "id",
+                "name": "name",
+                "order_id": "data.id",
+                "total": "data.total"
+              }
+            }
+          },
+          "out": [
+            [
+              "client.send",
+              {
+                "DeliveryStreamName": "walkeros-events",
+                "Records": [
+                  {
+                    "Data": {
+                      "0": 123,
+                      "1": 34,
+                      "2": 105,
+                      "3": 100,
+                      "4": 34,
+                      "5": 58,
+                      "6": 34,
+                      "7": 101,
+                      "8": 118,
+                      "9": 45,
+                      "10": 49,
+                      "11": 55,
+                      "12": 48,
+                      "13": 48,
+                      "14": 48,
+                      "15": 48,
+                      "16": 49,
+                      "17": 48,
+                      "18": 48,
+                      "19": 49,
+                      "20": 34,
+                      "21": 44,
+                      "22": 34,
+                      "23": 110,
+                      "24": 97,
+                      "25": 109,
+                      "26": 101,
+                      "27": 34,
+                      "28": 58,
+                      "29": 34,
+                      "30": 111,
+                      "31": 114,
+                      "32": 100,
+                      "33": 101,
+                      "34": 114,
+                      "35": 32,
+                      "36": 99,
+                      "37": 111,
+                      "38": 109,
+                      "39": 112,
+                      "40": 108,
+                      "41": 101,
+                      "42": 116,
+                      "43": 101,
+                      "44": 34,
+                      "45": 44,
+                      "46": 34,
+                      "47": 111,
+                      "48": 114,
+                      "49": 100,
+                      "50": 101,
+                      "51": 114,
+                      "52": 95,
+                      "53": 105,
+                      "54": 100,
+                      "55": 34,
+                      "56": 58,
+                      "57": 34,
+                      "58": 79,
+                      "59": 82,
+                      "60": 68,
+                      "61": 45,
+                      "62": 52,
+                      "63": 48,
+                      "64": 48,
+                      "65": 34,
+                      "66": 44,
+                      "67": 34,
+                      "68": 116,
+                      "69": 111,
+                      "70": 116,
+                      "71": 97,
+                      "72": 108,
+                      "73": 34,
+                      "74": 58,
+                      "75": 57,
+                      "76": 57,
+                      "77": 46,
+                      "78": 57,
+                      "79": 57,
+                      "80": 125,
+                      "81": 10
                     }
                   }
                 ]
@@ -854,7 +1109,7 @@
         },
         "orderEvent": {
           "title": "Order record",
-          "description": "An order complete event is serialized and delivered to Firehose as a batch record for downstream storage.",
+          "description": "An order complete event is serialized and delivered to Firehose as one newline-terminated record.",
           "in": {
             "name": "order complete",
             "data": {
@@ -1836,7 +2091,8 @@
                       "882": 114,
                       "883": 34,
                       "884": 125,
-                      "885": 125
+                      "885": 125,
+                      "886": 10
                     }
                   }
                 ]
@@ -2404,7 +2660,8 @@
                       "500": 114,
                       "501": 34,
                       "502": 125,
-                      "503": 125
+                      "503": 125,
+                      "504": 10
                     }
                   }
                 ]
@@ -2419,25 +2676,25 @@
         "push": {
           "AWS": {
             "SNSClient": {
-              "$code": "class{constructor(e){this.config=e}config;async send(e){return e instanceof J?{TopicArn:\"arn:aws:sns:eu-central-1:123456789012:walkeros-events\"}:e instanceof j?{MessageId:\"mock-message-id\"}:{}}}"
+              "$code": "class{constructor(e){this.config=e}config;async send(e){return e instanceof C?{TopicArn:\"arn:aws:sns:eu-central-1:123456789012:walkeros-events\"}:e instanceof _?{MessageId:\"mock-message-id\"}:{}}destroy(){}}"
             },
             "CreateTopicCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"CreateTopicCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"CreateTopicCommand\"}}"
             },
             "PublishCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"PublishCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"PublishCommand\"}}"
             },
             "GetTopicAttributesCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"GetTopicAttributesCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"GetTopicAttributesCommand\"}}"
             },
             "SubscribeCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"SubscribeCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"SubscribeCommand\"}}"
             },
             "STSClient": {
-              "$code": "class{constructor(e){this.config=e}config;async send(){return{Account:\"123456789012\"}}}"
+              "$code": "class{constructor(e){this.config=e}config;async send(){return{Account:\"123456789012\",Arn:\"arn:aws:iam::123456789012:user/walkeros\"}}destroy(){}}"
             },
             "GetCallerIdentityCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"GetCallerIdentityCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"GetCallerIdentityCommand\"}}"
             }
           }
         },
@@ -2511,7 +2768,7 @@
             [
               "client.send",
               {
-                "TopicArn": "arn:aws:sns:eu-central-1:000000000000:walkeros-events",
+                "TopicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events",
                 "Message": "{\"name\":\"product view\",\"data\":{\"id\":\"SKU-1\",\"tenant_id\":\"acme\"},\"context\":{\"shopping\":[\"detail\",0]},\"globals\":{\"pagegroup\":\"shop\"},\"custom\":{\"completely\":\"random\"},\"user\":{\"id\":\"us3r\",\"device\":\"c00k13\",\"session\":\"s3ss10n\"},\"nested\":[],\"consent\":{\"functional\":true},\"id\":\"ev-1700001002\",\"trigger\":\"load\",\"entity\":\"product\",\"action\":\"view\",\"timestamp\":1700001002,\"timing\":3.14,\"source\":{\"count\":1,\"trace\":\"0a1b2c3d4e5f60718293a4b5c6d7e8f9\",\"type\":\"express\",\"platform\":\"server\"}}",
                 "MessageAttributes": {
                   "schema_version": {
@@ -2527,9 +2784,38 @@
             ]
           ]
         },
-        "orderEvent": {
-          "title": "Order publish with FIFO group (path-resolved)",
-          "description": "An order complete event is published with a FIFO messageGroupId resolved from the event via the mapping path \"user.id\". `messageGroupId` is a `Mapping.Value`, so a string path is sufficient; no literal is hard-coded.",
+        "init": {
+          "title": "Initialization",
+          "description": "Init builds one SNSClient in the region of the topic ARN with the credentials from config.credentials and a 2500 ms per-attempt timeout. No topic is created and nothing is sent until the first event.",
+          "in": {
+            "settings": {
+              "topicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events"
+            },
+            "credentials": {
+              "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+              "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+            }
+          },
+          "out": [
+            [
+              "new SNSClient",
+              {
+                "region": "eu-central-1",
+                "credentials": {
+                  "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+                  "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+                },
+                "requestHandler": {
+                  "requestTimeout": 2500,
+                  "throwOnRequestTimeout": true
+                }
+              }
+            ]
+          ]
+        },
+        "mappedMessage": {
+          "title": "Mapped message",
+          "description": "A mapping that produces an object publishes that object as the Message instead of the full event. Keep the event id in it for deduplication.",
           "in": {
             "name": "order complete",
             "data": {
@@ -2617,87 +2903,197 @@
             }
           },
           "mapping": {
-            "settings": {
-              "messageGroupId": "user.id"
+            "data": {
+              "map": {
+                "id": "id",
+                "name": "name",
+                "order_id": "data.id",
+                "total": "data.total"
+              }
             }
           },
           "out": [
             [
               "client.send",
               {
-                "TopicArn": "arn:aws:sns:eu-central-1:000000000000:walkeros-events.fifo",
-                "Message": "{\"name\":\"order complete\",\"data\":{\"id\":\"ORD-400\",\"total\":99.99,\"currency\":\"EUR\"},\"context\":{\"shopping\":[\"complete\",0]},\"globals\":{\"pagegroup\":\"shop\"},\"custom\":{\"completely\":\"random\"},\"user\":{\"id\":\"usr-789\"},\"nested\":[{\"entity\":\"product\",\"data\":{\"id\":\"ers\",\"name\":\"Everyday Ruck Snack\",\"color\":\"black\",\"size\":\"l\",\"price\":420},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]},{\"entity\":\"product\",\"data\":{\"id\":\"cc\",\"name\":\"Cool Cap\",\"size\":\"one size\",\"price\":42},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]},{\"entity\":\"gift\",\"data\":{\"name\":\"Surprise\"},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]}],\"consent\":{\"functional\":true},\"id\":\"ev-1700001001\",\"trigger\":\"load\",\"entity\":\"order\",\"action\":\"complete\",\"timestamp\":1700001001,\"timing\":3.14,\"source\":{\"count\":1,\"trace\":\"0a1b2c3d4e5f60718293a4b5c6d7e8f9\",\"type\":\"express\",\"platform\":\"server\"}}",
-                "MessageGroupId": "usr-789"
+                "TopicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events",
+                "Message": "{\"id\":\"ev-1700001001\",\"name\":\"order complete\",\"order_id\":\"ORD-400\",\"total\":99.99}"
               }
             ]
           ]
         },
-        "pageView": {
-          "title": "Page view publish",
-          "description": "A page view event is JSON-stringified and published as the Message of an SNS Publish call.",
+        "orderEvent": {
+          "title": "Order publish with FIFO group (path-resolved)",
+          "description": "An order complete event is published to a FIFO topic with a messageGroupId resolved from the event via the mapping path \"user.id\". The deduplication id defaults to the event id.",
           "in": {
-            "name": "page view",
+            "name": "order complete",
             "data": {
-              "title": "Home",
-              "url": "https://example.com/"
+              "id": "ORD-400",
+              "total": 99.99,
+              "currency": "EUR"
             },
             "context": {
-              "dev": [
-                "test",
-                1
+              "shopping": [
+                "complete",
+                0
               ]
             },
             "globals": {
-              "pagegroup": "docs"
+              "pagegroup": "shop"
             },
             "custom": {
               "completely": "random"
             },
             "user": {
-              "id": "us3r",
-              "device": "c00k13",
-              "session": "s3ss10n"
+              "id": "usr-789"
             },
             "nested": [
               {
-                "entity": "child",
+                "entity": "product",
                 "data": {
-                  "is": "subordinated"
-                }
-              }
-            ],
-            "consent": {
-              "functional": true
-            },
-            "id": "ev-1700001000",
-            "trigger": "load",
-            "entity": "page",
-            "action": "view",
-            "timestamp": 1700001000,
-            "timing": 3.14,
-            "source": {
-              "count": 1,
-              "trace": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
-              "type": "express",
-              "platform": "server"
-            }
-          },
-          "out": [
-            [
-              "client.send",
+                  "id": "ers",
+                  "name": "Everyday Ruck Snack",
+                  "color": "black",
+                  "size": "l",
+                  "price": 420
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              },
               {
-                "TopicArn": "arn:aws:sns:eu-central-1:000000000000:walkeros-events",
-                "Message": "{\"name\":\"page view\",\"data\":{\"title\":\"Home\",\"url\":\"https://example.com/\"},\"context\":{\"dev\":[\"test\",1]},\"globals\":{\"pagegroup\":\"docs\"},\"custom\":{\"completely\":\"random\"},\"user\":{\"id\":\"us3r\",\"device\":\"c00k13\",\"session\":\"s3ss10n\"},\"nested\":[{\"entity\":\"child\",\"data\":{\"is\":\"subordinated\"}}],\"consent\":{\"functional\":true},\"id\":\"ev-1700001000\",\"trigger\":\"load\",\"entity\":\"page\",\"action\":\"view\",\"timestamp\":1700001000,\"timing\":3.14,\"source\":{\"count\":1,\"trace\":\"0a1b2c3d4e5f60718293a4b5c6d7e8f9\",\"type\":\"express\",\"platform\":\"server\"}}"
-              }
-            ]
-          ]
-        }
+                "entity": "product",
+                "data": {
+                  "id": "cc",
+                  "name": "Cool Cap",
+                  "size": "one size",
+                  "price": 42
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              },
+              {
+                "entity": "gift",
+                "data": {
+                  "name": "Surprise"
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              }
+            ],
+            "consent": {
+              "functional": true
+            },
+            "id": "ev-1700001001",
+            "trigger": "load",
+            "entity": "order",
+            "action": "complete",
+            "timestamp": 1700001001,
+            "timing": 3.14,
+            "source": {
+              "count": 1,
+              "trace": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
+              "type": "express",
+              "platform": "server"
+            }
+          },
+          "mapping": {
+            "settings": {
+              "messageGroupId": "user.id"
+            }
+          },
+          "out": [
+            [
+              "client.send",
+              {
+                "TopicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events.fifo",
+                "Message": "{\"name\":\"order complete\",\"data\":{\"id\":\"ORD-400\",\"total\":99.99,\"currency\":\"EUR\"},\"context\":{\"shopping\":[\"complete\",0]},\"globals\":{\"pagegroup\":\"shop\"},\"custom\":{\"completely\":\"random\"},\"user\":{\"id\":\"usr-789\"},\"nested\":[{\"entity\":\"product\",\"data\":{\"id\":\"ers\",\"name\":\"Everyday Ruck Snack\",\"color\":\"black\",\"size\":\"l\",\"price\":420},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]},{\"entity\":\"product\",\"data\":{\"id\":\"cc\",\"name\":\"Cool Cap\",\"size\":\"one size\",\"price\":42},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]},{\"entity\":\"gift\",\"data\":{\"name\":\"Surprise\"},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]}],\"consent\":{\"functional\":true},\"id\":\"ev-1700001001\",\"trigger\":\"load\",\"entity\":\"order\",\"action\":\"complete\",\"timestamp\":1700001001,\"timing\":3.14,\"source\":{\"count\":1,\"trace\":\"0a1b2c3d4e5f60718293a4b5c6d7e8f9\",\"type\":\"express\",\"platform\":\"server\"}}",
+                "MessageGroupId": "usr-789",
+                "MessageDeduplicationId": "ev-1700001001"
+              }
+            ]
+          ]
+        },
+        "pageView": {
+          "title": "Page view publish",
+          "description": "A page view event is JSON-stringified and published as the Message of an SNS Publish call.",
+          "in": {
+            "name": "page view",
+            "data": {
+              "title": "Home",
+              "url": "https://example.com/"
+            },
+            "context": {
+              "dev": [
+                "test",
+                1
+              ]
+            },
+            "globals": {
+              "pagegroup": "docs"
+            },
+            "custom": {
+              "completely": "random"
+            },
+            "user": {
+              "id": "us3r",
+              "device": "c00k13",
+              "session": "s3ss10n"
+            },
+            "nested": [
+              {
+                "entity": "child",
+                "data": {
+                  "is": "subordinated"
+                }
+              }
+            ],
+            "consent": {
+              "functional": true
+            },
+            "id": "ev-1700001000",
+            "trigger": "load",
+            "entity": "page",
+            "action": "view",
+            "timestamp": 1700001000,
+            "timing": 3.14,
+            "source": {
+              "count": 1,
+              "trace": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
+              "type": "express",
+              "platform": "server"
+            }
+          },
+          "out": [
+            [
+              "client.send",
+              {
+                "TopicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events",
+                "Message": "{\"name\":\"page view\",\"data\":{\"title\":\"Home\",\"url\":\"https://example.com/\"},\"context\":{\"dev\":[\"test\",1]},\"globals\":{\"pagegroup\":\"docs\"},\"custom\":{\"completely\":\"random\"},\"user\":{\"id\":\"us3r\",\"device\":\"c00k13\",\"session\":\"s3ss10n\"},\"nested\":[{\"entity\":\"child\",\"data\":{\"is\":\"subordinated\"}}],\"consent\":{\"functional\":true},\"id\":\"ev-1700001000\",\"trigger\":\"load\",\"entity\":\"page\",\"action\":\"view\",\"timestamp\":1700001000,\"timing\":3.14,\"source\":{\"count\":1,\"trace\":\"0a1b2c3d4e5f60718293a4b5c6d7e8f9\",\"type\":\"express\",\"platform\":\"server\"}}"
+              }
+            ]
+          ]
+        }
       }
     },
     "step": {
       "firehoseRecord": {
         "title": "Page view record",
-        "description": "A page view is sent to Kinesis Firehose as a single record with the full event JSON-stringified into the Data buffer.",
+        "description": "A page view is sent to Firehose as one record: the full event as JSON followed by a newline.",
         "in": {
           "name": "page view",
           "data": {
@@ -3274,7 +3670,236 @@
                     "518": 114,
                     "519": 34,
                     "520": 125,
-                    "521": 125
+                    "521": 125,
+                    "522": 10
+                  }
+                }
+              ]
+            }
+          ]
+        ]
+      },
+      "init": {
+        "title": "Initialization",
+        "description": "Init builds one FirehoseClient for the stream region with the credentials from config.credentials and a 2500 ms per-attempt timeout. Nothing is sent until the first event.",
+        "in": {
+          "settings": {
+            "streamName": "walkeros-events",
+            "region": "eu-central-1"
+          },
+          "credentials": {
+            "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+            "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+          }
+        },
+        "out": [
+          [
+            "new FirehoseClient",
+            {
+              "region": "eu-central-1",
+              "credentials": {
+                "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+                "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+              },
+              "requestHandler": {
+                "requestTimeout": 2500,
+                "throwOnRequestTimeout": true
+              }
+            }
+          ]
+        ]
+      },
+      "mappedRecord": {
+        "title": "Mapped record",
+        "description": "A mapping that produces an object sends that object as the record instead of the full event. Keep the event id in it for deduplication.",
+        "in": {
+          "name": "order complete",
+          "data": {
+            "id": "ORD-400",
+            "total": 99.99,
+            "currency": "EUR"
+          },
+          "context": {
+            "shopping": [
+              "complete",
+              0
+            ]
+          },
+          "globals": {
+            "pagegroup": "shop"
+          },
+          "custom": {
+            "completely": "random"
+          },
+          "user": {
+            "id": "us3r",
+            "device": "c00k13",
+            "session": "s3ss10n"
+          },
+          "nested": [
+            {
+              "entity": "product",
+              "data": {
+                "id": "ers",
+                "name": "Everyday Ruck Snack",
+                "color": "black",
+                "size": "l",
+                "price": 420
+              },
+              "context": {
+                "shopping": [
+                  "complete",
+                  0
+                ]
+              },
+              "nested": []
+            },
+            {
+              "entity": "product",
+              "data": {
+                "id": "cc",
+                "name": "Cool Cap",
+                "size": "one size",
+                "price": 42
+              },
+              "context": {
+                "shopping": [
+                  "complete",
+                  0
+                ]
+              },
+              "nested": []
+            },
+            {
+              "entity": "gift",
+              "data": {
+                "name": "Surprise"
+              },
+              "context": {
+                "shopping": [
+                  "complete",
+                  0
+                ]
+              },
+              "nested": []
+            }
+          ],
+          "consent": {
+            "functional": true
+          },
+          "id": "ev-1700001001",
+          "trigger": "load",
+          "entity": "order",
+          "action": "complete",
+          "timestamp": 1700001001,
+          "timing": 3.14,
+          "source": {
+            "count": 1,
+            "trace": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
+            "type": "express",
+            "platform": "server"
+          }
+        },
+        "mapping": {
+          "data": {
+            "map": {
+              "id": "id",
+              "name": "name",
+              "order_id": "data.id",
+              "total": "data.total"
+            }
+          }
+        },
+        "out": [
+          [
+            "client.send",
+            {
+              "DeliveryStreamName": "walkeros-events",
+              "Records": [
+                {
+                  "Data": {
+                    "0": 123,
+                    "1": 34,
+                    "2": 105,
+                    "3": 100,
+                    "4": 34,
+                    "5": 58,
+                    "6": 34,
+                    "7": 101,
+                    "8": 118,
+                    "9": 45,
+                    "10": 49,
+                    "11": 55,
+                    "12": 48,
+                    "13": 48,
+                    "14": 48,
+                    "15": 48,
+                    "16": 49,
+                    "17": 48,
+                    "18": 48,
+                    "19": 49,
+                    "20": 34,
+                    "21": 44,
+                    "22": 34,
+                    "23": 110,
+                    "24": 97,
+                    "25": 109,
+                    "26": 101,
+                    "27": 34,
+                    "28": 58,
+                    "29": 34,
+                    "30": 111,
+                    "31": 114,
+                    "32": 100,
+                    "33": 101,
+                    "34": 114,
+                    "35": 32,
+                    "36": 99,
+                    "37": 111,
+                    "38": 109,
+                    "39": 112,
+                    "40": 108,
+                    "41": 101,
+                    "42": 116,
+                    "43": 101,
+                    "44": 34,
+                    "45": 44,
+                    "46": 34,
+                    "47": 111,
+                    "48": 114,
+                    "49": 100,
+                    "50": 101,
+                    "51": 114,
+                    "52": 95,
+                    "53": 105,
+                    "54": 100,
+                    "55": 34,
+                    "56": 58,
+                    "57": 34,
+                    "58": 79,
+                    "59": 82,
+                    "60": 68,
+                    "61": 45,
+                    "62": 52,
+                    "63": 48,
+                    "64": 48,
+                    "65": 34,
+                    "66": 44,
+                    "67": 34,
+                    "68": 116,
+                    "69": 111,
+                    "70": 116,
+                    "71": 97,
+                    "72": 108,
+                    "73": 34,
+                    "74": 58,
+                    "75": 57,
+                    "76": 57,
+                    "77": 46,
+                    "78": 57,
+                    "79": 57,
+                    "80": 125,
+                    "81": 10
                   }
                 }
               ]
@@ -3284,7 +3909,7 @@
       },
       "orderEvent": {
         "title": "Order record",
-        "description": "An order complete event is serialized and delivered to Firehose as a batch record for downstream storage.",
+        "description": "An order complete event is serialized and delivered to Firehose as one newline-terminated record.",
         "in": {
           "name": "order complete",
           "data": {
@@ -4266,7 +4891,8 @@
                     "882": 114,
                     "883": 34,
                     "884": 125,
-                    "885": 125
+                    "885": 125,
+                    "886": 10
                   }
                 }
               ]
@@ -4834,7 +5460,8 @@
                     "500": 114,
                     "501": 34,
                     "502": 125,
-                    "503": 125
+                    "503": 125,
+                    "504": 10
                   }
                 }
               ]
@@ -4850,7 +5477,7 @@
         "push": {
           "AWS": {
             "FirehoseClient": {
-              "$code": "class{config;constructor(e){this.config=e}async send(e){return{RecordId:\"mock-record-id\",ResponseMetadata:{RequestId:\"mock-request-id\"}}}}"
+              "$code": "class{config;constructor(e){this.config=e}async send(e){const t=\"input\"in e?e.input:void 0;var i;return{FailedPutCount:0,Encrypted:!1,RequestResponses:(\"object\"==typeof(i=t)&&null!==i&&\"Records\"in i&&Array.isArray(i.Records)?t.Records:[]).map((e,t)=>({RecordId:`mock-record-id-${t}`}))}}destroy(){}}"
             },
             "PutRecordBatchCommand": {
               "$code": "class{input;constructor(e){this.input=e}get[Symbol.toStringTag](){return\"PutRecordBatchCommand\"}}"
@@ -4864,7 +5491,7 @@
       "step": {
         "firehoseRecord": {
           "title": "Page view record",
-          "description": "A page view is sent to Kinesis Firehose as a single record with the full event JSON-stringified into the Data buffer.",
+          "description": "A page view is sent to Firehose as one record: the full event as JSON followed by a newline.",
           "in": {
             "name": "page view",
             "data": {
@@ -5441,7 +6068,8 @@
                       "518": 114,
                       "519": 34,
                       "520": 125,
-                      "521": 125
+                      "521": 125,
+                      "522": 10
                     }
                   }
                 ]
@@ -5449,13 +6077,241 @@
             ]
           ]
         },
-        "orderEvent": {
-          "title": "Order record",
-          "description": "An order complete event is serialized and delivered to Firehose as a batch record for downstream storage.",
+        "init": {
+          "title": "Initialization",
+          "description": "Init builds one FirehoseClient for the stream region with the credentials from config.credentials and a 2500 ms per-attempt timeout. Nothing is sent until the first event.",
           "in": {
-            "name": "order complete",
-            "data": {
-              "id": "ORD-400",
+            "settings": {
+              "streamName": "walkeros-events",
+              "region": "eu-central-1"
+            },
+            "credentials": {
+              "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+              "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+            }
+          },
+          "out": [
+            [
+              "new FirehoseClient",
+              {
+                "region": "eu-central-1",
+                "credentials": {
+                  "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+                  "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+                },
+                "requestHandler": {
+                  "requestTimeout": 2500,
+                  "throwOnRequestTimeout": true
+                }
+              }
+            ]
+          ]
+        },
+        "mappedRecord": {
+          "title": "Mapped record",
+          "description": "A mapping that produces an object sends that object as the record instead of the full event. Keep the event id in it for deduplication.",
+          "in": {
+            "name": "order complete",
+            "data": {
+              "id": "ORD-400",
+              "total": 99.99,
+              "currency": "EUR"
+            },
+            "context": {
+              "shopping": [
+                "complete",
+                0
+              ]
+            },
+            "globals": {
+              "pagegroup": "shop"
+            },
+            "custom": {
+              "completely": "random"
+            },
+            "user": {
+              "id": "us3r",
+              "device": "c00k13",
+              "session": "s3ss10n"
+            },
+            "nested": [
+              {
+                "entity": "product",
+                "data": {
+                  "id": "ers",
+                  "name": "Everyday Ruck Snack",
+                  "color": "black",
+                  "size": "l",
+                  "price": 420
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              },
+              {
+                "entity": "product",
+                "data": {
+                  "id": "cc",
+                  "name": "Cool Cap",
+                  "size": "one size",
+                  "price": 42
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              },
+              {
+                "entity": "gift",
+                "data": {
+                  "name": "Surprise"
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              }
+            ],
+            "consent": {
+              "functional": true
+            },
+            "id": "ev-1700001001",
+            "trigger": "load",
+            "entity": "order",
+            "action": "complete",
+            "timestamp": 1700001001,
+            "timing": 3.14,
+            "source": {
+              "count": 1,
+              "trace": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
+              "type": "express",
+              "platform": "server"
+            }
+          },
+          "mapping": {
+            "data": {
+              "map": {
+                "id": "id",
+                "name": "name",
+                "order_id": "data.id",
+                "total": "data.total"
+              }
+            }
+          },
+          "out": [
+            [
+              "client.send",
+              {
+                "DeliveryStreamName": "walkeros-events",
+                "Records": [
+                  {
+                    "Data": {
+                      "0": 123,
+                      "1": 34,
+                      "2": 105,
+                      "3": 100,
+                      "4": 34,
+                      "5": 58,
+                      "6": 34,
+                      "7": 101,
+                      "8": 118,
+                      "9": 45,
+                      "10": 49,
+                      "11": 55,
+                      "12": 48,
+                      "13": 48,
+                      "14": 48,
+                      "15": 48,
+                      "16": 49,
+                      "17": 48,
+                      "18": 48,
+                      "19": 49,
+                      "20": 34,
+                      "21": 44,
+                      "22": 34,
+                      "23": 110,
+                      "24": 97,
+                      "25": 109,
+                      "26": 101,
+                      "27": 34,
+                      "28": 58,
+                      "29": 34,
+                      "30": 111,
+                      "31": 114,
+                      "32": 100,
+                      "33": 101,
+                      "34": 114,
+                      "35": 32,
+                      "36": 99,
+                      "37": 111,
+                      "38": 109,
+                      "39": 112,
+                      "40": 108,
+                      "41": 101,
+                      "42": 116,
+                      "43": 101,
+                      "44": 34,
+                      "45": 44,
+                      "46": 34,
+                      "47": 111,
+                      "48": 114,
+                      "49": 100,
+                      "50": 101,
+                      "51": 114,
+                      "52": 95,
+                      "53": 105,
+                      "54": 100,
+                      "55": 34,
+                      "56": 58,
+                      "57": 34,
+                      "58": 79,
+                      "59": 82,
+                      "60": 68,
+                      "61": 45,
+                      "62": 52,
+                      "63": 48,
+                      "64": 48,
+                      "65": 34,
+                      "66": 44,
+                      "67": 34,
+                      "68": 116,
+                      "69": 111,
+                      "70": 116,
+                      "71": 97,
+                      "72": 108,
+                      "73": 34,
+                      "74": 58,
+                      "75": 57,
+                      "76": 57,
+                      "77": 46,
+                      "78": 57,
+                      "79": 57,
+                      "80": 125,
+                      "81": 10
+                    }
+                  }
+                ]
+              }
+            ]
+          ]
+        },
+        "orderEvent": {
+          "title": "Order record",
+          "description": "An order complete event is serialized and delivered to Firehose as one newline-terminated record.",
+          "in": {
+            "name": "order complete",
+            "data": {
+              "id": "ORD-400",
               "total": 99.99,
               "currency": "EUR"
             },
@@ -6433,7 +7289,8 @@
                       "882": 114,
                       "883": 34,
                       "884": 125,
-                      "885": 125
+                      "885": 125,
+                      "886": 10
                     }
                   }
                 ]
@@ -7001,7 +7858,8 @@
                       "500": 114,
                       "501": 34,
                       "502": 125,
-                      "503": 125
+                      "503": 125,
+                      "504": 10
                     }
                   }
                 ]
@@ -7016,25 +7874,25 @@
         "push": {
           "AWS": {
             "SNSClient": {
-              "$code": "class{constructor(e){this.config=e}config;async send(e){return e instanceof J?{TopicArn:\"arn:aws:sns:eu-central-1:123456789012:walkeros-events\"}:e instanceof j?{MessageId:\"mock-message-id\"}:{}}}"
+              "$code": "class{constructor(e){this.config=e}config;async send(e){return e instanceof C?{TopicArn:\"arn:aws:sns:eu-central-1:123456789012:walkeros-events\"}:e instanceof _?{MessageId:\"mock-message-id\"}:{}}destroy(){}}"
             },
             "CreateTopicCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"CreateTopicCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"CreateTopicCommand\"}}"
             },
             "PublishCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"PublishCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"PublishCommand\"}}"
             },
             "GetTopicAttributesCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"GetTopicAttributesCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"GetTopicAttributesCommand\"}}"
             },
             "SubscribeCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"SubscribeCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"SubscribeCommand\"}}"
             },
             "STSClient": {
-              "$code": "class{constructor(e){this.config=e}config;async send(){return{Account:\"123456789012\"}}}"
+              "$code": "class{constructor(e){this.config=e}config;async send(){return{Account:\"123456789012\",Arn:\"arn:aws:iam::123456789012:user/walkeros\"}}destroy(){}}"
             },
             "GetCallerIdentityCommand": {
-              "$code": "class extends G{get[Symbol.toStringTag](){return\"GetCallerIdentityCommand\"}}"
+              "$code": "class extends E{get[Symbol.toStringTag](){return\"GetCallerIdentityCommand\"}}"
             }
           }
         },
@@ -7108,7 +7966,7 @@
             [
               "client.send",
               {
-                "TopicArn": "arn:aws:sns:eu-central-1:000000000000:walkeros-events",
+                "TopicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events",
                 "Message": "{\"name\":\"product view\",\"data\":{\"id\":\"SKU-1\",\"tenant_id\":\"acme\"},\"context\":{\"shopping\":[\"detail\",0]},\"globals\":{\"pagegroup\":\"shop\"},\"custom\":{\"completely\":\"random\"},\"user\":{\"id\":\"us3r\",\"device\":\"c00k13\",\"session\":\"s3ss10n\"},\"nested\":[],\"consent\":{\"functional\":true},\"id\":\"ev-1700001002\",\"trigger\":\"load\",\"entity\":\"product\",\"action\":\"view\",\"timestamp\":1700001002,\"timing\":3.14,\"source\":{\"count\":1,\"trace\":\"0a1b2c3d4e5f60718293a4b5c6d7e8f9\",\"type\":\"express\",\"platform\":\"server\"}}",
                 "MessageAttributes": {
                   "schema_version": {
@@ -7124,9 +7982,147 @@
             ]
           ]
         },
+        "init": {
+          "title": "Initialization",
+          "description": "Init builds one SNSClient in the region of the topic ARN with the credentials from config.credentials and a 2500 ms per-attempt timeout. No topic is created and nothing is sent until the first event.",
+          "in": {
+            "settings": {
+              "topicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events"
+            },
+            "credentials": {
+              "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+              "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+            }
+          },
+          "out": [
+            [
+              "new SNSClient",
+              {
+                "region": "eu-central-1",
+                "credentials": {
+                  "accessKeyId": "$secret.AWS_ACCESS_KEY_ID",
+                  "secretAccessKey": "$secret.AWS_SECRET_ACCESS_KEY"
+                },
+                "requestHandler": {
+                  "requestTimeout": 2500,
+                  "throwOnRequestTimeout": true
+                }
+              }
+            ]
+          ]
+        },
+        "mappedMessage": {
+          "title": "Mapped message",
+          "description": "A mapping that produces an object publishes that object as the Message instead of the full event. Keep the event id in it for deduplication.",
+          "in": {
+            "name": "order complete",
+            "data": {
+              "id": "ORD-400",
+              "total": 99.99,
+              "currency": "EUR"
+            },
+            "context": {
+              "shopping": [
+                "complete",
+                0
+              ]
+            },
+            "globals": {
+              "pagegroup": "shop"
+            },
+            "custom": {
+              "completely": "random"
+            },
+            "user": {
+              "id": "usr-789"
+            },
+            "nested": [
+              {
+                "entity": "product",
+                "data": {
+                  "id": "ers",
+                  "name": "Everyday Ruck Snack",
+                  "color": "black",
+                  "size": "l",
+                  "price": 420
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              },
+              {
+                "entity": "product",
+                "data": {
+                  "id": "cc",
+                  "name": "Cool Cap",
+                  "size": "one size",
+                  "price": 42
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              },
+              {
+                "entity": "gift",
+                "data": {
+                  "name": "Surprise"
+                },
+                "context": {
+                  "shopping": [
+                    "complete",
+                    0
+                  ]
+                },
+                "nested": []
+              }
+            ],
+            "consent": {
+              "functional": true
+            },
+            "id": "ev-1700001001",
+            "trigger": "load",
+            "entity": "order",
+            "action": "complete",
+            "timestamp": 1700001001,
+            "timing": 3.14,
+            "source": {
+              "count": 1,
+              "trace": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
+              "type": "express",
+              "platform": "server"
+            }
+          },
+          "mapping": {
+            "data": {
+              "map": {
+                "id": "id",
+                "name": "name",
+                "order_id": "data.id",
+                "total": "data.total"
+              }
+            }
+          },
+          "out": [
+            [
+              "client.send",
+              {
+                "TopicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events",
+                "Message": "{\"id\":\"ev-1700001001\",\"name\":\"order complete\",\"order_id\":\"ORD-400\",\"total\":99.99}"
+              }
+            ]
+          ]
+        },
         "orderEvent": {
           "title": "Order publish with FIFO group (path-resolved)",
-          "description": "An order complete event is published with a FIFO messageGroupId resolved from the event via the mapping path \"user.id\". `messageGroupId` is a `Mapping.Value`, so a string path is sufficient; no literal is hard-coded.",
+          "description": "An order complete event is published to a FIFO topic with a messageGroupId resolved from the event via the mapping path \"user.id\". The deduplication id defaults to the event id.",
           "in": {
             "name": "order complete",
             "data": {
@@ -7222,9 +8218,10 @@
             [
               "client.send",
               {
-                "TopicArn": "arn:aws:sns:eu-central-1:000000000000:walkeros-events.fifo",
+                "TopicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events.fifo",
                 "Message": "{\"name\":\"order complete\",\"data\":{\"id\":\"ORD-400\",\"total\":99.99,\"currency\":\"EUR\"},\"context\":{\"shopping\":[\"complete\",0]},\"globals\":{\"pagegroup\":\"shop\"},\"custom\":{\"completely\":\"random\"},\"user\":{\"id\":\"usr-789\"},\"nested\":[{\"entity\":\"product\",\"data\":{\"id\":\"ers\",\"name\":\"Everyday Ruck Snack\",\"color\":\"black\",\"size\":\"l\",\"price\":420},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]},{\"entity\":\"product\",\"data\":{\"id\":\"cc\",\"name\":\"Cool Cap\",\"size\":\"one size\",\"price\":42},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]},{\"entity\":\"gift\",\"data\":{\"name\":\"Surprise\"},\"context\":{\"shopping\":[\"complete\",0]},\"nested\":[]}],\"consent\":{\"functional\":true},\"id\":\"ev-1700001001\",\"trigger\":\"load\",\"entity\":\"order\",\"action\":\"complete\",\"timestamp\":1700001001,\"timing\":3.14,\"source\":{\"count\":1,\"trace\":\"0a1b2c3d4e5f60718293a4b5c6d7e8f9\",\"type\":\"express\",\"platform\":\"server\"}}",
-                "MessageGroupId": "usr-789"
+                "MessageGroupId": "usr-789",
+                "MessageDeduplicationId": "ev-1700001001"
               }
             ]
           ]
@@ -7283,7 +8280,7 @@
             [
               "client.send",
               {
-                "TopicArn": "arn:aws:sns:eu-central-1:000000000000:walkeros-events",
+                "TopicArn": "arn:aws:sns:eu-central-1:123456789012:walkeros-events",
                 "Message": "{\"name\":\"page view\",\"data\":{\"title\":\"Home\",\"url\":\"https://example.com/\"},\"context\":{\"dev\":[\"test\",1]},\"globals\":{\"pagegroup\":\"docs\"},\"custom\":{\"completely\":\"random\"},\"user\":{\"id\":\"us3r\",\"device\":\"c00k13\",\"session\":\"s3ss10n\"},\"nested\":[{\"entity\":\"child\",\"data\":{\"is\":\"subordinated\"}}],\"consent\":{\"functional\":true},\"id\":\"ev-1700001000\",\"trigger\":\"load\",\"entity\":\"page\",\"action\":\"view\",\"timestamp\":1700001000,\"timing\":3.14,\"source\":{\"count\":1,\"trace\":\"0a1b2c3d4e5f60718293a4b5c6d7e8f9\",\"type\":\"express\",\"platform\":\"server\"}}"
               }
             ]
@@ -7291,5 +8288,210 @@
         }
       }
     }
+  },
+  "exportSchemas": {
+    "destinationFirehose": {
+      "settings": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "streamName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Name of the Firehose stream (like walkeros-events). Required."
+          },
+          "region": {
+            "type": "string",
+            "description": "AWS region of the stream (like eu-central-1). Default: AWS_REGION or the active profile, else eu-central-1."
+          },
+          "newline": {
+            "type": "boolean",
+            "description": "Append a newline to every record (default true). Set false when the stream adds its own new line delimiter."
+          },
+          "config": {
+            "description": "Raw FirehoseClient options passed to the SDK (like { endpoint, maxAttempts }). Put keys in config.credentials instead."
+          },
+          "client": {
+            "description": "A FirehoseClient of your own. Used as is and never closed by the destination."
+          },
+          "firehose": {
+            "type": "object",
+            "properties": {
+              "streamName": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Name of the Firehose stream (like walkeros-events). Required."
+              },
+              "client": {
+                "description": "A FirehoseClient of your own. Used as is and never closed by the destination."
+              },
+              "region": {
+                "type": "string",
+                "description": "AWS region of the stream (like eu-central-1). Default: AWS_REGION or the active profile, else eu-central-1."
+              },
+              "config": {
+                "description": "Raw FirehoseClient options passed to the SDK (like { endpoint, maxAttempts }). Put keys in config.credentials instead."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Deprecated: use the flat fields streamName, region, config and client.",
+            "title": "firehose"
+          }
+        },
+        "additionalProperties": false
+      },
+      "mapping": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      }
+    },
+    "destinationSNS": {
+      "settings": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "topicArn": {
+            "type": "string",
+            "description": "Topic ARN (like arn:aws:sns:eu-central-1:123456789012:walkeros-events). Region and topic name derive from it. Required unless topicName is set."
+          },
+          "topicName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Topic name (like walkeros-events). Used by walkeros setup; without topicArn the ARN is completed with the account id at the first publish."
+          },
+          "region": {
+            "type": "string",
+            "description": "AWS region (like eu-central-1). Default: the region in topicArn, AWS_REGION or the active profile, else eu-central-1."
+          },
+          "client": {
+            "description": "An SNSClient of your own. Used as is and never closed by the destination."
+          },
+          "config": {
+            "description": "Raw SNSClient options passed to the SDK. Put keys in config.credentials instead."
+          }
+        },
+        "additionalProperties": false
+      },
+      "mapping": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "messageAttributes": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          },
+          "messageGroupId": {},
+          "messageDeduplicationId": {}
+        },
+        "additionalProperties": false
+      },
+      "setup": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "region": {
+            "type": "string"
+          },
+          "displayName": {
+            "type": "string"
+          },
+          "fifoTopic": {
+            "type": "boolean"
+          },
+          "kmsMasterKeyId": {
+            "type": "string"
+          },
+          "tags": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {
+              "type": "string"
+            }
+          },
+          "subscriptions": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "protocol": {
+                  "type": "string",
+                  "enum": [
+                    "sqs",
+                    "lambda",
+                    "https",
+                    "http",
+                    "email",
+                    "sms"
+                  ]
+                },
+                "endpoint": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "rawMessageDelivery": {
+                  "type": "boolean"
+                },
+                "filterPolicy": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {}
+                },
+                "deadLetterTargetArn": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "protocol",
+                "endpoint"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "hints": {
+    "minimal-config": {
+      "text": "Firehose needs settings.streamName (plus settings.region when the stream is not in AWS_REGION or eu-central-1). SNS needs settings.topicArn; region and topic name derive from it. Off AWS, add config.credentials. Nothing is sent and no credentials are loaded until the first event.",
+      "code": [
+        {
+          "lang": "json",
+          "code": "{ \"settings\": { \"streamName\": \"walkeros-events\", \"region\": \"eu-central-1\" }, \"credentials\": { \"accessKeyId\": \"$secret.AWS_ACCESS_KEY_ID\", \"secretAccessKey\": \"$secret.AWS_SECRET_ACCESS_KEY\" } }"
+        },
+        {
+          "lang": "json",
+          "code": "{ \"settings\": { \"topicArn\": \"arn:aws:sns:eu-central-1:123456789012:walkeros-events\" } }"
+        }
+      ]
+    },
+    "auth-credentials": {
+      "text": "On AWS compute an attached IAM role needs no config at all. Elsewhere, config.credentials ({ accessKeyId, secretAccessKey, sessionToken? }, or the same as a JSON string) wins over settings.config.credentials, which wins over the AWS default chain (AWS_* variables, AWS_PROFILE, ECS, EC2 and web identity roles; Kubernetes can go keyless with AWS_ROLE_ARN plus AWS_WEB_IDENTITY_TOKEN_FILE). Back every value with $secret; never write a literal key. Credentials are shape-checked at init and loaded only at the first send.",
+      "code": [
+        {
+          "lang": "json",
+          "code": "{ \"credentials\": { \"accessKeyId\": \"$secret.AWS_ACCESS_KEY_ID\", \"secretAccessKey\": \"$secret.AWS_SECRET_ACCESS_KEY\" } }"
+        }
+      ]
+    },
+    "firehose-records": {
+      "text": "Each record is the mapped data object, or the full event when the mapping produced none, followed by a newline. Set settings.newline: false when the stream adds its own new line delimiter. Batching is on by default (500 records or 1 s); calls carry at most 500 records and 2,900,000 bytes, and a record over 1,000,000 bytes fails as RecordTooLarge without being sent."
+    },
+    "delivery-guarantee": {
+      "text": "Delivery is at least once: deduplicate downstream on event.id, and keep id in mapped data. A record AWS rejects is reported as failed with code, status and retryable. There is no retry beyond the built-in AWS SDK retry: a rejected record goes to the in-memory dead letter queue of the collector, which nothing replays yet. On SNS FIFO topics MessageDeduplicationId defaults to event.id."
+    },
+    "troubleshoot-errors": {
+      "text": "Every failure carries code, status and retryable, and its message names the stream or topic and the region. ResourceNotFoundException: wrong settings.streamName or region. AccessDeniedException / AuthorizationErrorException: the credentials lack firehose:PutRecordBatch or sns:Publish. UnrecognizedClientException, InvalidSignatureException, ExpiredTokenException or no credentials found: check config.credentials or the environment. SNS NotFoundException: the topic does not exist; run walkeros setup or set settings.topicArn. NULL rows in Athena: the stream adds its own new line delimiter too, so set newline: false. InvalidConfig at start: a missing or conflicting setting, named in the message."
+    }
   }
 }