@walkeros/server-source-aws 4.7.0-next-1790245733116 → 4.7.0

package/dist/walkerOS.json

@@ -1,7 +1,7 @@
 {
   "$meta": {
     "package": "@walkeros/server-source-aws",
-    "version": "4.7.0-next-1790245733116",
+    "version": "4.7.0",
     "type": "source",
     "platform": [
       "server"
@@ -284,7 +284,7 @@
   },
   "examples": {
     "createTrigger": {
-      "$code": "async e=>{let t;return{get flow(){return t},trigger:()=>async n=>{if(!t){const n=await Vn(e);t={collector:n.collector,elb:n.elb}}const o=function(e){for(const t of Object.values(e.sources||{}))if(\"lambda\"===t.type)return t}(t.collector);if(!o)throw new Error(\"Lambda source not found in collector\");const s={awsRequestId:`test-${Date.now()}`},r=o.push,i=await r(n,s);let a;try{a=JSON.parse(i.body||\"{}\")}catch{a=i.body}const c={};if(i.headers)for(const[e,t]of Object.entries(i.headers))void 0!==t&&(c[e]=String(t));return{statusCode:i.statusCode,body:a,headers:c}}}}"
+      "$code": "async e=>{let t;return{get flow(){return t},trigger:()=>async n=>{if(!t){const n=await co(e);t={collector:n.collector,elb:n.elb}}const o=function(e){for(const t of Object.values(e.sources||{}))if(\"lambda\"===t.type)return t}(t.collector);if(!o)throw new Error(\"Lambda source not found in collector\");const s={awsRequestId:`test-${Date.now()}`},r=o.push,i=await r(n,s);let a;try{a=JSON.parse(i.body||\"{}\")}catch{a=i.body}const c={};if(i.headers)for(const[e,t]of Object.entries(i.headers))void 0!==t&&(c[e]=String(t));return{statusCode:i.statusCode,body:a,headers:c}}}}"
     },
     "env": {
       "push": {
@@ -317,7 +317,7 @@
             "$code": "()=>{}"
           },
           "scope": {
-            "$code": "()=>S"
+            "$code": "()=>i"
           }
         }
       }
@@ -449,7 +449,593 @@
       }
     },
     "trigger": {
-      "$code": "function Xn(e){return async t=>{const n={...t};if(n.body&&\"string\"==typeof n.body){const e=JSON.parse(n.body);e.name&&!e.event&&(n.body=JSON.stringify({...e,event:e.name,name:void 0}))}return e.push(n,{awsRequestId:\"test-req\"})}}"
+      "$code": "function lo(e){return async t=>{const n={...t};if(n.body&&\"string\"==typeof n.body){const e=JSON.parse(n.body);e.name&&!e.event&&(n.body=JSON.stringify({...e,event:e.name,name:void 0}))}return e.push(n,{awsRequestId:\"test-req\"})}}"
+    }
+  },
+  "exportExamples": {
+    "sourceLambda": {
+      "createTrigger": {
+        "$code": "async e=>{let t;return{get flow(){return t},trigger:()=>async n=>{if(!t){const n=await co(e);t={collector:n.collector,elb:n.elb}}const o=function(e){for(const t of Object.values(e.sources||{}))if(\"lambda\"===t.type)return t}(t.collector);if(!o)throw new Error(\"Lambda source not found in collector\");const s={awsRequestId:`test-${Date.now()}`},r=o.push,i=await r(n,s);let a;try{a=JSON.parse(i.body||\"{}\")}catch{a=i.body}const c={};if(i.headers)for(const[e,t]of Object.entries(i.headers))void 0!==t&&(c[e]=String(t));return{statusCode:i.statusCode,body:a,headers:c}}}}"
+      },
+      "env": {
+        "push": {
+          "push": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "command": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "elb": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "logger": {
+            "error": {
+              "$code": "()=>{}"
+            },
+            "warn": {
+              "$code": "()=>{}"
+            },
+            "info": {
+              "$code": "()=>{}"
+            },
+            "debug": {
+              "$code": "()=>{}"
+            },
+            "throw": {
+              "$code": "e=>{throw\"string\"==typeof e?new Error(e):e}"
+            },
+            "json": {
+              "$code": "()=>{}"
+            },
+            "scope": {
+              "$code": "()=>i"
+            }
+          }
+        }
+      },
+      "step": {
+        "apiGatewayV1Post": {
+          "title": "API Gateway v1 POST",
+          "description": "A REST API Gateway v1 POST request with a JSON body is converted into a walker elb event.",
+          "trigger": {
+            "type": "POST"
+          },
+          "in": {
+            "httpMethod": "POST",
+            "path": "/collect",
+            "requestContext": {
+              "requestId": "req-789",
+              "identity": {
+                "sourceIp": "203.0.113.42"
+              }
+            },
+            "queryStringParameters": null,
+            "body": "{\"name\":\"page view\",\"data\":{\"title\":\"Home\"}}",
+            "isBase64Encoded": false
+          },
+          "out": [
+            [
+              "elb",
+              {
+                "name": "page view",
+                "data": {
+                  "title": "Home"
+                }
+              }
+            ]
+          ]
+        },
+        "lambdaGet": {
+          "title": "Lambda GET",
+          "description": "An API Gateway v2 HTTP GET with query parameters is parsed into an elb event payload.",
+          "trigger": {
+            "type": "GET"
+          },
+          "in": {
+            "version": "2.0",
+            "requestContext": {
+              "http": {
+                "method": "GET",
+                "path": "/collect"
+              },
+              "requestId": "req-456"
+            },
+            "rawQueryString": "e=page+view&d=%7B%22title%22%3A%22Home%22%7D",
+            "isBase64Encoded": false
+          },
+          "out": [
+            [
+              "elb",
+              {
+                "e": "page view",
+                "d": "{\"title\":\"Home\"}"
+              }
+            ]
+          ]
+        },
+        "lambdaPost": {
+          "title": "Lambda POST",
+          "description": "An API Gateway v2 HTTP POST with a JSON body is converted into a walker elb event.",
+          "trigger": {
+            "type": "POST"
+          },
+          "in": {
+            "version": "2.0",
+            "requestContext": {
+              "http": {
+                "method": "POST",
+                "path": "/collect"
+              },
+              "requestId": "req-123"
+            },
+            "body": "{\"name\":\"page view\",\"data\":{\"title\":\"Home\"}}",
+            "isBase64Encoded": false
+          },
+          "out": [
+            [
+              "elb",
+              {
+                "name": "page view",
+                "data": {
+                  "title": "Home"
+                }
+              }
+            ]
+          ]
+        },
+        "lambdaPostForwardsSource": {
+          "title": "Lambda POST with provenance",
+          "description": "A POST body carrying a source map is forwarded in full, so release and trace provenance survive the crossing.",
+          "trigger": {
+            "type": "POST"
+          },
+          "in": {
+            "version": "2.0",
+            "requestContext": {
+              "http": {
+                "method": "POST",
+                "path": "/collect"
+              },
+              "requestId": "req-321"
+            },
+            "body": "{\"name\":\"page view\",\"data\":{\"title\":\"Home\"},\"source\":{\"release\":{\"web\":\"r1\"}}}",
+            "isBase64Encoded": false
+          },
+          "out": [
+            [
+              "elb",
+              {
+                "name": "page view",
+                "data": {
+                  "title": "Home"
+                },
+                "source": {
+                  "release": {
+                    "web": "r1"
+                  }
+                }
+              }
+            ]
+          ]
+        }
+      },
+      "trigger": {
+        "$code": "function lo(e){return async t=>{const n={...t};if(n.body&&\"string\"==typeof n.body){const e=JSON.parse(n.body);e.name&&!e.event&&(n.body=JSON.stringify({...e,event:e.name,name:void 0}))}return e.push(n,{awsRequestId:\"test-req\"})}}"
+      }
+    },
+    "sourceSqs": {
+      "createTrigger": {
+        "$code": "async e=>{let t;return{get flow(){return t},trigger:()=>async n=>{if(!t){const n=await co(e);t={collector:n.collector,elb:n.elb}}const o=function(e){for(const t of Object.values(e.sources??{}))if(Oo(t))return t}(t.collector);if(!o)throw new Error(\"sqs source not registered in collector, ensure it is configured in sources\");const s={MessageId:n.MessageId,Body:n.Body,ReceiptHandle:n.ReceiptHandle,Attributes:n.Attributes,MessageAttributes:n.MessageAttributes},r=await o.push(s),i=[];return r&&\"object\"==typeof r&&(r.acked&&i.push([\"message.ack\",n.MessageId]),r.nacked&&i.push([\"message.nack\",n.MessageId])),i}}}"
+      },
+      "env": {
+        "moduleMockEnv": {
+          "push": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "command": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "elb": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "logger": {
+            "error": {
+              "$code": "()=>{}"
+            },
+            "warn": {
+              "$code": "()=>{}"
+            },
+            "info": {
+              "$code": "()=>{}"
+            },
+            "debug": {
+              "$code": "()=>{}"
+            },
+            "throw": {
+              "$code": "e=>{throw\"string\"==typeof e?new Error(e):e}"
+            },
+            "json": {
+              "$code": "()=>{}"
+            },
+            "scope": {
+              "$code": "()=>ho"
+            }
+          }
+        },
+        "push": {
+          "push": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "command": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "elb": {
+            "$code": "()=>Promise.resolve({ok:!0})"
+          },
+          "logger": {
+            "error": {
+              "$code": "()=>{}"
+            },
+            "warn": {
+              "$code": "()=>{}"
+            },
+            "info": {
+              "$code": "()=>{}"
+            },
+            "debug": {
+              "$code": "()=>{}"
+            },
+            "throw": {
+              "$code": "e=>{throw\"string\"==typeof e?new Error(e):e}"
+            },
+            "json": {
+              "$code": "()=>{}"
+            },
+            "scope": {
+              "$code": "()=>ho"
+            }
+          },
+          "AWS": {
+            "SQSClient": {
+              "$code": "class{constructor(e){this.config=e}config;async send(e){return function(e){if(!(\"input\"in e))return!1;const{input:t}=e;return\"object\"==typeof t&&null!==t&&\"WaitTimeSeconds\"in t}(e)&&await new Promise(e=>setTimeout(e,100)),{$metadata:{},QueueUrl:\"https://sqs.eu-central-1.amazonaws.com/000000000000/walkeros-events\",Attributes:{QueueArn:\"arn:aws:sqs:eu-central-1:000000000000:walkeros-events\"},Messages:[]}}destroy(){}}"
+            }
+          }
+        },
+        "simulation": [
+          "call:AWS.SQSClient.send"
+        ]
+      },
+      "step": {
+        "decoderText": {
+          "title": "Text decoder",
+          "description": "When decoder is \"text\", the body string flows under data.payload.",
+          "in": {
+            "MessageId": "m-3",
+            "Body": "raw text payload"
+          },
+          "out": [
+            [
+              "message.ack",
+              "m-3"
+            ]
+          ]
+        },
+        "malformedJson": {
+          "title": "Malformed JSON nacks",
+          "description": "Default decoder is JSON. A malformed body throws DecoderError; the source nacks (skips DeleteMessage) so the message redelivers.",
+          "in": {
+            "MessageId": "m-4",
+            "Body": "{not json"
+          },
+          "out": [
+            [
+              "message.nack",
+              "m-4"
+            ]
+          ]
+        },
+        "orderComplete": {
+          "title": "Order complete from SQS",
+          "description": "Order complete event flowing through the long-poll loop.",
+          "in": {
+            "MessageId": "m-2",
+            "Body": "{\"event\":\"order complete\",\"data\":{\"id\":\"ORD-500\",\"total\":199.99,\"currency\":\"EUR\"}}"
+          },
+          "out": [
+            [
+              "message.ack",
+              "m-2"
+            ]
+          ]
+        },
+        "pageView": {
+          "title": "Page view from SQS",
+          "description": "A standard SQS message body containing a walker elb event payload as JSON.",
+          "in": {
+            "MessageId": "m-1",
+            "Body": "{\"event\":\"page view\",\"data\":{\"title\":\"Documentation\",\"url\":\"https://example.com/docs\"}}"
+          },
+          "out": [
+            [
+              "message.ack",
+              "m-1"
+            ]
+          ]
+        }
+      }
+    }
+  },
+  "exportSchemas": {
+    "sourceLambda": {
+      "settings": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "cors": {
+            "default": true,
+            "anyOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "origin": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      {
+                        "type": "string",
+                        "const": "*"
+                      }
+                    ],
+                    "description": "Allowed origins (* for all, URL string, or array of URLs)"
+                  },
+                  "methods": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "enum": [
+                        "GET",
+                        "POST",
+                        "PUT",
+                        "PATCH",
+                        "DELETE",
+                        "OPTIONS",
+                        "HEAD"
+                      ]
+                    },
+                    "description": "Allowed HTTP methods"
+                  },
+                  "headers": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Allowed request headers"
+                  },
+                  "credentials": {
+                    "type": "boolean",
+                    "description": "Allow credentials (cookies, authorization headers)"
+                  },
+                  "maxAge": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "description": "Preflight cache duration in seconds"
+                  }
+                },
+                "additionalProperties": false
+              }
+            ],
+            "description": "CORS configuration: false = disabled, true = allow all origins, object = custom configuration"
+          },
+          "timeout": {
+            "default": 30000,
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 900000,
+            "description": "Request timeout in milliseconds (max: 900000 for Lambda)"
+          },
+          "enablePixelTracking": {
+            "default": true,
+            "type": "boolean",
+            "description": "Enable GET requests with 1x1 transparent GIF response for pixel tracking"
+          },
+          "maxBatchSize": {
+            "default": 100,
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 9007199254740991,
+            "description": "Maximum number of events accepted in a single batch request"
+          },
+          "healthPath": {
+            "default": "/health",
+            "type": "string",
+            "description": "Health check endpoint path (e.g., /health)"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    "sourceSqs": {
+      "settings": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "queueName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "SQS queue short name (like walkeros-events). Required for both setup and runtime poll."
+          },
+          "region": {
+            "type": "string",
+            "description": "AWS region (like eu-central-1). Default: eu-central-1."
+          },
+          "queueUrl": {
+            "type": "string",
+            "format": "uri",
+            "description": "Optional pre-resolved queue URL. When set, init skips the GetQueueUrl lookup."
+          },
+          "client": {
+            "description": "Pre-configured AWS SQSClient instance. Bypasses construction when supplied."
+          },
+          "config": {
+            "description": "AWS SDK SQSClientConfig (credentials, endpoint overrides, retries)."
+          },
+          "decoder": {
+            "type": "string",
+            "enum": [
+              "json",
+              "text",
+              "raw"
+            ],
+            "description": "Decoder for the message body. json (default) parses JSON, text forwards UTF-8, raw forwards a Buffer."
+          },
+          "maxMessages": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10,
+            "description": "SQS receive batch size. Cap 10. Default: 10."
+          },
+          "waitTimeSeconds": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 20,
+            "description": "Long-poll duration in seconds. Cap 20. Default: 20."
+          },
+          "visibilityTimeout": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991,
+            "description": "Per-receive visibility timeout override. Default: queue-configured value."
+          },
+          "shutdownTimeoutMs": {
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "description": "Graceful shutdown timeout in milliseconds. Default: 30000. After this window, destroy() force-closes."
+          },
+          "onPushError": {
+            "type": "string",
+            "enum": [
+              "nack",
+              "ack"
+            ],
+            "description": "Behavior when forwarding to the collector throws. nack (default) skips DeleteMessage so the message redelivers; ack drops it."
+          }
+        },
+        "required": [
+          "queueName"
+        ],
+        "additionalProperties": false
+      },
+      "setup": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "region": {
+            "type": "string",
+            "minLength": 1,
+            "description": "AWS region."
+          },
+          "fifoQueue": {
+            "type": "boolean",
+            "description": "FIFO queue with content-based deduplication. Auto-appends .fifo suffix to the queue name."
+          },
+          "visibilityTimeoutSeconds": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991,
+            "description": "Visibility timeout in seconds. Default: 30."
+          },
+          "messageRetentionSeconds": {
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "description": "Message retention period in seconds. Default: 345600 (4 days)."
+          },
+          "maximumMessageSize": {
+            "type": "integer",
+            "minimum": 1024,
+            "maximum": 262144,
+            "description": "Max message size in bytes. Default: 262144 (256 KB)."
+          },
+          "kmsMasterKeyId": {
+            "type": "string",
+            "description": "KMS key alias or ID for at-rest encryption."
+          },
+          "deadLetterQueue": {
+            "type": "object",
+            "properties": {
+              "arn": {
+                "type": "string",
+                "description": "ARN of an existing DLQ. Mutually exclusive with create: true."
+              },
+              "create": {
+                "type": "boolean",
+                "description": "Create a sibling DLQ named <queueName>-dlq. Default: false."
+              },
+              "maxReceiveCount": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 1000,
+                "description": "Max receive count before message goes to DLQ. Default: 5."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Optional dead-letter queue.",
+            "title": "deadLetterQueue"
+          },
+          "tags": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Tags applied to the queue (and inherited by an auto-created DLQ)."
+          },
+          "subscribeToSnsTopic": {
+            "type": "object",
+            "properties": {
+              "topicArn": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Topic ARN to subscribe to."
+              },
+              "rawMessageDelivery": {
+                "type": "boolean",
+                "description": "Deliver SNS messages without the SNS envelope."
+              },
+              "filterPolicy": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {},
+                "description": "SNS filter policy applied at subscription level."
+              }
+            },
+            "required": [
+              "topicArn"
+            ],
+            "additionalProperties": false,
+            "description": "Optional SNS topic subscription. Creates the subscription and the matching queue policy.",
+            "title": "subscribeToSnsTopic"
+          }
+        },
+        "additionalProperties": false
+      }
     }
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/server-source-aws",
   "description": "AWS server sources for walkerOS (Lambda, API Gateway, Function URLs)",
-  "version": "4.7.0-next-1790245733116",
+  "version": "4.7.0",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -23,14 +23,14 @@
   "dependencies": {
     "@aws-sdk/client-sqs": "^3.952.0",
     "@aws-sdk/client-sns": "^3.952.0",
-    "@walkeros/core": "4.7.0-next-1790245733116"
+    "@walkeros/core": "4.7.0"
   },
   "peerDependencies": {
     "@types/aws-lambda": "^8.10.0"
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.159",
-    "@walkeros/collector": "4.7.0-next-1790245733116"
+    "@walkeros/collector": "4.7.0"
   },
   "repository": {
     "url": "git+https://github.com/elbwalker/walkerOS.git",