[{"data":1,"prerenderedAt":2496},["ShallowReactive",2],{"navigation_docs":3,"-docs-guides-adding-events-to-go-module":968,"-docs-guides-adding-events-to-go-module-surround":2491},[4,27,63,129,287,311,893,902,950,964],{"title":5,"path":6,"stem":7,"children":8,"order":10,"icon":11},"Overview","\u002Fdocs\u002Foverview","docs\u002F1.overview\u002Findex",[9,12,18,24],{"title":5,"path":6,"stem":7,"order":10,"icon":11},1,"i-lucide-info",{"title":13,"path":14,"stem":15,"order":16,"icon":17},"Getting Started","\u002Fdocs\u002Foverview\u002Fgetting-started","docs\u002F1.overview\u002F2.getting-started",2,"i-lucide-rocket",{"title":19,"path":20,"stem":21,"order":22,"icon":23},"Contributing","\u002Fdocs\u002Foverview\u002Fcontributing","docs\u002F1.overview\u002F3.contributing",3,"i-lucide-heart",{"title":5,"path":25,"stem":26,"order":10},"\u002Fdocs\u002Foverview\u002F_dir","docs\u002F1.overview\u002F_dir",{"title":28,"path":29,"stem":30,"children":31,"page":62},"Concepts","\u002Fdocs\u002Fconcepts","docs\u002F2.concepts",[32,37,42,47,53,59],{"title":33,"path":34,"stem":35,"order":10,"icon":36},"Events","\u002Fdocs\u002Fconcepts\u002Fevents","docs\u002F2.concepts\u002F1.events","i-lucide-zap",{"title":38,"path":39,"stem":40,"order":16,"icon":41},"Transports","\u002Fdocs\u002Fconcepts\u002Ftransports","docs\u002F2.concepts\u002F2.transports","i-lucide-network",{"title":43,"path":44,"stem":45,"order":22,"icon":46},"Module System","\u002Fdocs\u002Fconcepts\u002Fmodules","docs\u002F2.concepts\u002F3.modules","i-lucide-puzzle",{"title":48,"path":49,"stem":50,"order":51,"icon":52},"Flows","\u002Fdocs\u002Fconcepts\u002Fflows","docs\u002F2.concepts\u002F4.flows",4,"i-lucide-workflow",{"title":54,"path":55,"stem":56,"order":57,"icon":58},"Scheduler","\u002Fdocs\u002Fconcepts\u002Fscheduler","docs\u002F2.concepts\u002F5.scheduler",5,"i-lucide-clock",{"title":28,"path":60,"stem":61,"order":16},"\u002Fdocs\u002Fconcepts\u002F_dir","docs\u002F2.concepts\u002F_dir",false,{"title":64,"path":65,"stem":66,"children":67,"page":62},"Guides","\u002Fdocs\u002Fguides","docs\u002F3.guides",[68,73,77,81,85,89,93,98,104,110,116,122,126],{"title":69,"path":70,"stem":71,"order":10,"icon":72},"Creating a Go App","\u002Fdocs\u002Fguides\u002Fcreating-go-app","docs\u002F3.guides\u002F1.creating-go-app","i-lucide-terminal",{"title":74,"path":75,"stem":76},"E2E tests & demo videos","\u002Fdocs\u002Fguides\u002Fe2e-and-demo-videos","docs\u002F3.guides\u002F10.e2e-and-demo-videos",{"title":78,"path":79,"stem":80,"icon":17},"Deploying to production","\u002Fdocs\u002Fguides\u002Fdeploying-to-production","docs\u002F3.guides\u002F11.deploying-to-production",{"title":82,"path":83,"stem":84,"order":16,"icon":46},"Creating a Go Module","\u002Fdocs\u002Fguides\u002Fcreating-go-module","docs\u002F3.guides\u002F2.creating-go-module",{"title":86,"path":87,"stem":88,"order":22,"icon":36},"Adding Events","\u002Fdocs\u002Fguides\u002Fadding-events-to-go-module","docs\u002F3.guides\u002F3.adding-events-to-go-module",{"title":90,"path":91,"stem":92,"order":51,"icon":52},"FlowDSL to Service","\u002Fdocs\u002Fguides\u002Fflowdsl-to-redelay","docs\u002F3.guides\u002F4.flowdsl-to-redelay",{"title":94,"path":95,"stem":96,"order":57,"icon":97},"Choosing a Transport","\u002Fdocs\u002Fguides\u002Fchoosing-a-transport","docs\u002F3.guides\u002F5.choosing-a-transport","i-lucide-git-branch",{"title":99,"path":100,"stem":101,"order":102,"icon":103},"Module Browser (\u002Fmodules)","\u002Fdocs\u002Fguides\u002Fmodules-browser","docs\u002F3.guides\u002F6.modules-browser",6,"i-lucide-layout-dashboard",{"title":105,"path":106,"stem":107,"order":108,"icon":109},"Running Flows","\u002Fdocs\u002Fguides\u002Frunning-flows","docs\u002F3.guides\u002F7.running-flows",7,"i-lucide-play-circle",{"title":111,"path":112,"stem":113,"order":114,"icon":115},"Trace + Live Observability","\u002Fdocs\u002Fguides\u002Fobservability","docs\u002F3.guides\u002F8.observability",8,"i-lucide-activity",{"title":117,"path":118,"stem":119,"order":120,"icon":121},"Project AI Assistant","\u002Fdocs\u002Fguides\u002Fai-assistant","docs\u002F3.guides\u002F9.ai-assistant",9,"i-lucide-sparkles",{"title":123,"path":124,"stem":125},"Debug taps — trace live data through any node","\u002Fdocs\u002Fguides\u002Fdebug-taps","docs\u002F3.guides\u002F9.debug-taps",{"title":64,"path":127,"stem":128,"order":22},"\u002Fdocs\u002Fguides\u002F_dir","docs\u002F3.guides\u002F_dir",{"title":130,"path":131,"stem":132,"children":133,"page":62},"Reference","\u002Fdocs\u002Freference","docs\u002F4.reference",[134,139,143,148,153,158,163,168,172,177,182,187,193,199,205,210,215,219,225,230,236,242,247,253,259,263,267,273,278,284],{"title":135,"path":136,"stem":137,"order":10,"icon":138},"Go Framework","\u002Fdocs\u002Freference\u002Fgo-framework","docs\u002F4.reference\u002F01.go-framework","i-simple-icons-go",{"title":140,"path":141,"stem":142,"order":16,"icon":46},"Built-in Modules","\u002Fdocs\u002Freference\u002Fgo-modules","docs\u002F4.reference\u002F02.go-modules",{"title":144,"path":145,"stem":146,"order":22,"icon":147},"Domain Addon Modules","\u002Fdocs\u002Freference\u002Fgo-modules-addons","docs\u002F4.reference\u002F03.go-modules-addons","i-lucide-blocks",{"title":149,"path":150,"stem":151,"order":51,"icon":152},"Go Events","\u002Fdocs\u002Freference\u002Fgo-events","docs\u002F4.reference\u002F04.go-events","i-lucide-radio",{"title":154,"path":155,"stem":156,"order":57,"icon":157},"Email Module","\u002Fdocs\u002Freference\u002Fgo-module-email","docs\u002F4.reference\u002F05.go-module-email","i-lucide-mail",{"title":159,"path":160,"stem":161,"order":102,"icon":162},"Go Core & IR","\u002Fdocs\u002Freference\u002Fgo-core","docs\u002F4.reference\u002F06.go-core","i-lucide-cpu",{"title":164,"path":165,"stem":166,"order":108,"icon":167},"Module Definition Files","\u002Fdocs\u002Freference\u002Fgo-module-files","docs\u002F4.reference\u002F07.go-module-files","i-lucide-file-code",{"title":169,"path":170,"stem":171,"order":114,"icon":72},"CLI Reference","\u002Fdocs\u002Freference\u002Fgo-cli","docs\u002F4.reference\u002F08.go-cli",{"title":173,"path":174,"stem":175,"order":120,"icon":176},"Go Formats","\u002Fdocs\u002Freference\u002Fgo-formats","docs\u002F4.reference\u002F09.go-formats","i-lucide-file-json",{"title":178,"path":179,"stem":180,"order":181,"icon":152},"AsyncAPI Module","\u002Fdocs\u002Freference\u002Fgo-asyncapi","docs\u002F4.reference\u002F10.go-asyncapi",10,{"title":183,"path":184,"stem":185,"order":186,"icon":52},"Go FlowDSL","\u002Fdocs\u002Freference\u002Fgo-flowdsl","docs\u002F4.reference\u002F11.go-flowdsl",11,{"title":188,"path":189,"stem":190,"order":191,"icon":192},"FlowDSL Examples","\u002Fdocs\u002Freference\u002Fflowdsl-examples","docs\u002F4.reference\u002F12.flowdsl-examples",12,"i-lucide-file-code-2",{"title":194,"path":195,"stem":196,"order":197,"icon":198},"FlowDSL Sync","\u002Fdocs\u002Freference\u002Fflowdsl-sync","docs\u002F4.reference\u002F13.flowdsl-sync",13,"i-lucide-refresh-cw",{"title":200,"path":201,"stem":202,"order":203,"icon":204},"Node.js Framework","\u002Fdocs\u002Freference\u002Fjs-framework","docs\u002F4.reference\u002F14.js-framework",14,"i-simple-icons-nodedotjs",{"title":206,"path":207,"stem":208,"order":203,"icon":209},"Python Framework","\u002Fdocs\u002Freference\u002Fpy-framework","docs\u002F4.reference\u002F14.py-framework","i-simple-icons-python",{"title":211,"path":212,"stem":213,"order":214,"icon":204},"Node.js Events","\u002Fdocs\u002Freference\u002Fjs-events","docs\u002F4.reference\u002F15.js-events",15,{"title":216,"path":217,"stem":218,"order":214,"icon":209},"Python Events","\u002Fdocs\u002Freference\u002Fpy-events","docs\u002F4.reference\u002F15.py-events",{"title":220,"path":221,"stem":222,"order":223,"icon":224},"go-ai — LLM Providers, Guard, Ledger","\u002Fdocs\u002Freference\u002Fgo-ai","docs\u002F4.reference\u002F16.go-ai",16,"i-lucide-brain-circuit",{"title":226,"path":227,"stem":228,"order":229,"icon":41},"Infrastructure Modules","\u002Fdocs\u002Freference\u002Fgeneric-infra-modules","docs\u002F4.reference\u002F17.generic-infra-modules",17,{"title":231,"path":232,"stem":233,"order":234,"icon":235},"Flow Templates","\u002Fdocs\u002Freference\u002Fflow-templates","docs\u002F4.reference\u002F18.flow-templates",18,"i-lucide-library-big",{"title":237,"path":238,"stem":239,"order":240,"icon":241},"Assistant (chat + handoff)","\u002Fdocs\u002Freference\u002Fassistant","docs\u002F4.reference\u002F19.assistant",19,"i-lucide-messages-square",{"title":243,"path":244,"stem":245,"order":246,"icon":41},"Coordination","\u002Fdocs\u002Freference\u002Fcoordination","docs\u002F4.reference\u002F20.coordination",20,{"title":248,"path":249,"stem":250,"order":251,"icon":252},"Search (vector)","\u002Fdocs\u002Freference\u002Fsearch","docs\u002F4.reference\u002F21.search",21,"i-lucide-search",{"title":254,"path":255,"stem":256,"order":257,"icon":258},"Profiles","\u002Fdocs\u002Freference\u002Fprofiles","docs\u002F4.reference\u002F22.profiles",22,"i-lucide-bookmark",{"title":260,"path":261,"stem":262},"Flow-driven HTTP endpoints","\u002Fdocs\u002Freference\u002Fflow-driven-endpoints","docs\u002F4.reference\u002F23.flow-driven-endpoints",{"title":264,"path":265,"stem":266},"Deployments","\u002Fdocs\u002Freference\u002Fdeployments","docs\u002F4.reference\u002F24.deployments",{"title":268,"path":269,"stem":270,"order":271,"icon":272},"i18n (translations)","\u002Fdocs\u002Freference\u002Fi18n","docs\u002F4.reference\u002F25.i18n",25,"i-lucide-languages",{"title":274,"path":275,"stem":276,"order":277,"icon":152},"WebSockets","\u002Fdocs\u002Freference\u002Fwebsockets","docs\u002F4.reference\u002F26.websockets",26,{"title":279,"path":280,"stem":281,"order":282,"icon":283},"Localized content","\u002Fdocs\u002Freference\u002Flocalized-content","docs\u002F4.reference\u002F27.localized-content",27,"i-lucide-file-text",{"title":130,"path":285,"stem":286,"order":51},"\u002Fdocs\u002Freference\u002F_dir","docs\u002F4.reference\u002F_dir",{"title":288,"path":289,"stem":290,"children":291,"page":62},"Integrations","\u002Fdocs\u002Fintegrations","docs\u002F5.integrations",[292,296,300,304,308],{"title":293,"path":294,"stem":295,"order":10,"icon":52},"FlowDSL","\u002Fdocs\u002Fintegrations\u002Fflowdsl","docs\u002F5.integrations\u002F1.flowdsl",{"title":297,"path":298,"stem":299,"order":16,"icon":283},"OpenAPI","\u002Fdocs\u002Fintegrations\u002Fopenapi","docs\u002F5.integrations\u002F2.openapi",{"title":301,"path":302,"stem":303,"order":22,"icon":152},"AsyncAPI","\u002Fdocs\u002Fintegrations\u002Fasyncapi","docs\u002F5.integrations\u002F3.asyncapi",{"title":305,"path":306,"stem":307},"MCP Integration","\u002Fdocs\u002Fintegrations\u002Fmcp","docs\u002F5.integrations\u002F4.mcp",{"title":288,"path":309,"stem":310,"order":57},"\u002Fdocs\u002Fintegrations\u002F_dir","docs\u002F5.integrations\u002F_dir",{"title":312,"path":313,"stem":314,"children":315},"FlowDSL Node Catalog","\u002Fdocs\u002Fnodes","docs\u002F5.nodes\u002Findex",[316,317,321,325,329,333,337,341,345,349,353,357,361,365,369,373,377,381,385,389,393,397,401,405,409,413,417,421,425,429,433,437,441,445,449,453,457,461,465,469,473,477,481,485,489,493,497,501,505,509,513,517,521,525,529,533,537,541,545,549,553,557,561,565,569,573,577,581,585,589,593,597,601,605,609,613,617,621,625,629,633,637,641,645,649,653,657,661,665,669,673,677,681,685,689,693,697,701,705,709,713,717,721,725,729,733,737,741,745,749,753,757,761,765,769,773,777,781,785,789,793,797,801,805,809,813,817,821,825,829,833,837,841,845,849,853,857,861,865,869,873,877,881,885,889],{"title":312,"path":313,"stem":314},{"title":318,"path":319,"stem":320,"order":57},"Node Catalog","\u002Fdocs\u002Fnodes\u002F_dir","docs\u002F5.nodes\u002F_dir",{"title":322,"path":323,"stem":324},"Record Alert","\u002Fdocs\u002Fnodes\u002Falerts_record","docs\u002F5.nodes\u002Falerts_record",{"title":326,"path":327,"stem":328},"Log to API Log","\u002Fdocs\u002Fnodes\u002Fapilog_record","docs\u002F5.nodes\u002Fapilog_record",{"title":330,"path":331,"stem":332},"ClickHouse Exec","\u002Fdocs\u002Fnodes\u002Fclickhouse_exec","docs\u002F5.nodes\u002Fclickhouse_exec",{"title":334,"path":335,"stem":336},"ClickHouse Insert","\u002Fdocs\u002Fnodes\u002Fclickhouse_insert","docs\u002F5.nodes\u002Fclickhouse_insert",{"title":338,"path":339,"stem":340},"ClickHouse Query","\u002Fdocs\u002Fnodes\u002Fclickhouse_query","docs\u002F5.nodes\u002Fclickhouse_query",{"title":342,"path":343,"stem":344},"Array Op","\u002Fdocs\u002Fnodes\u002Fcore_array-ops","docs\u002F5.nodes\u002Fcore_array-ops",{"title":346,"path":347,"stem":348},"Assert","\u002Fdocs\u002Fnodes\u002Fcore_assert","docs\u002F5.nodes\u002Fcore_assert",{"title":350,"path":351,"stem":352},"Audit Emit","\u002Fdocs\u002Fnodes\u002Fcore_audit-emit","docs\u002F5.nodes\u002Fcore_audit-emit",{"title":354,"path":355,"stem":356},"Catch","\u002Fdocs\u002Fnodes\u002Fcore_catch","docs\u002F5.nodes\u002Fcore_catch",{"title":358,"path":359,"stem":360},"DateTime","\u002Fdocs\u002Fnodes\u002Fcore_datetime","docs\u002F5.nodes\u002Fcore_datetime",{"title":362,"path":363,"stem":364},"Dead Letter","\u002Fdocs\u002Fnodes\u002Fcore_dead-letter","docs\u002F5.nodes\u002Fcore_dead-letter",{"title":366,"path":367,"stem":368},"Delay","\u002Fdocs\u002Fnodes\u002Fcore_delay","docs\u002F5.nodes\u002Fcore_delay",{"title":370,"path":371,"stem":372},"ForEach","\u002Fdocs\u002Fnodes\u002Fcore_foreach","docs\u002F5.nodes\u002Fcore_foreach",{"title":374,"path":375,"stem":376},"Idempotency Key","\u002Fdocs\u002Fnodes\u002Fcore_idempotency-key","docs\u002F5.nodes\u002Fcore_idempotency-key",{"title":378,"path":379,"stem":380},"If","\u002Fdocs\u002Fnodes\u002Fcore_if","docs\u002F5.nodes\u002Fcore_if",{"title":382,"path":383,"stem":384},"Inspect","\u002Fdocs\u002Fnodes\u002Fcore_inspect","docs\u002F5.nodes\u002Fcore_inspect",{"title":386,"path":387,"stem":388},"JSON Merge","\u002Fdocs\u002Fnodes\u002Fcore_json-merge","docs\u002F5.nodes\u002Fcore_json-merge",{"title":390,"path":391,"stem":392},"JSON Schema Validate","\u002Fdocs\u002Fnodes\u002Fcore_json-schema-validate","docs\u002F5.nodes\u002Fcore_json-schema-validate",{"title":394,"path":395,"stem":396},"JSONPath Extract","\u002Fdocs\u002Fnodes\u002Fcore_jsonpath-extract","docs\u002F5.nodes\u002Fcore_jsonpath-extract",{"title":398,"path":399,"stem":400},"Log","\u002Fdocs\u002Fnodes\u002Fcore_log","docs\u002F5.nodes\u002Fcore_log",{"title":402,"path":403,"stem":404},"Math","\u002Fdocs\u002Fnodes\u002Fcore_math","docs\u002F5.nodes\u002Fcore_math",{"title":406,"path":407,"stem":408},"Merge","\u002Fdocs\u002Fnodes\u002Fcore_merge","docs\u002F5.nodes\u002Fcore_merge",{"title":410,"path":411,"stem":412},"Metric Counter","\u002Fdocs\u002Fnodes\u002Fcore_metric-counter","docs\u002F5.nodes\u002Fcore_metric-counter",{"title":414,"path":415,"stem":416},"Metric Gauge","\u002Fdocs\u002Fnodes\u002Fcore_metric-gauge","docs\u002F5.nodes\u002Fcore_metric-gauge",{"title":418,"path":419,"stem":420},"Mock","\u002Fdocs\u002Fnodes\u002Fcore_mock","docs\u002F5.nodes\u002Fcore_mock",{"title":422,"path":423,"stem":424},"No-op","\u002Fdocs\u002Fnodes\u002Fcore_noop","docs\u002F5.nodes\u002Fcore_noop",{"title":426,"path":427,"stem":428},"Object Omit","\u002Fdocs\u002Fnodes\u002Fcore_object-omit","docs\u002F5.nodes\u002Fcore_object-omit",{"title":430,"path":431,"stem":432},"Object Pick","\u002Fdocs\u002Fnodes\u002Fcore_object-pick","docs\u002F5.nodes\u002Fcore_object-pick",{"title":434,"path":435,"stem":436},"Parallel Fan-Out","\u002Fdocs\u002Fnodes\u002Fcore_parallel","docs\u002F5.nodes\u002Fcore_parallel",{"title":438,"path":439,"stem":440},"Raise","\u002Fdocs\u002Fnodes\u002Fcore_raise","docs\u002F5.nodes\u002Fcore_raise",{"title":442,"path":443,"stem":444},"Rate Limit Check","\u002Fdocs\u002Fnodes\u002Fcore_rate-limit-check","docs\u002F5.nodes\u002Fcore_rate-limit-check",{"title":446,"path":447,"stem":448},"Regex Extract","\u002Fdocs\u002Fnodes\u002Fcore_regex-extract","docs\u002F5.nodes\u002Fcore_regex-extract",{"title":450,"path":451,"stem":452},"Require Fields","\u002Fdocs\u002Fnodes\u002Fcore_require-fields","docs\u002F5.nodes\u002Fcore_require-fields",{"title":454,"path":455,"stem":456},"Rethrow","\u002Fdocs\u002Fnodes\u002Fcore_rethrow","docs\u002F5.nodes\u002Fcore_rethrow",{"title":458,"path":459,"stem":460},"Return","\u002Fdocs\u002Fnodes\u002Fcore_return","docs\u002F5.nodes\u002Fcore_return",{"title":462,"path":463,"stem":464},"HMAC Signature Verify","\u002Fdocs\u002Fnodes\u002Fcore_signature-verify","docs\u002F5.nodes\u002Fcore_signature-verify",{"title":466,"path":467,"stem":468},"String Op","\u002Fdocs\u002Fnodes\u002Fcore_string-ops","docs\u002F5.nodes\u002Fcore_string-ops",{"title":470,"path":471,"stem":472},"Subflow Invoke","\u002Fdocs\u002Fnodes\u002Fcore_subflow-invoke","docs\u002F5.nodes\u002Fcore_subflow-invoke",{"title":474,"path":475,"stem":476},"Switch","\u002Fdocs\u002Fnodes\u002Fcore_switch","docs\u002F5.nodes\u002Fcore_switch",{"title":478,"path":479,"stem":480},"Template Render","\u002Fdocs\u002Fnodes\u002Fcore_template-render","docs\u002F5.nodes\u002Fcore_template-render",{"title":482,"path":483,"stem":484},"Throttle","\u002Fdocs\u002Fnodes\u002Fcore_throttle","docs\u002F5.nodes\u002Fcore_throttle",{"title":486,"path":487,"stem":488},"Timeout","\u002Fdocs\u002Fnodes\u002Fcore_timeout","docs\u002F5.nodes\u002Fcore_timeout",{"title":490,"path":491,"stem":492},"Type Cast","\u002Fdocs\u002Fnodes\u002Fcore_type-cast","docs\u002F5.nodes\u002Fcore_type-cast",{"title":494,"path":495,"stem":496},"Webhook Respond","\u002Fdocs\u002Fnodes\u002Fcore_webhook-respond","docs\u002F5.nodes\u002Fcore_webhook-respond",{"title":498,"path":499,"stem":500},"File Delete","\u002Fdocs\u002Fnodes\u002Ffilesys_delete","docs\u002F5.nodes\u002Ffilesys_delete",{"title":502,"path":503,"stem":504},"Directory List","\u002Fdocs\u002Fnodes\u002Ffilesys_list","docs\u002F5.nodes\u002Ffilesys_list",{"title":506,"path":507,"stem":508},"File Read","\u002Fdocs\u002Fnodes\u002Ffilesys_read","docs\u002F5.nodes\u002Ffilesys_read",{"title":510,"path":511,"stem":512},"File Stat","\u002Fdocs\u002Fnodes\u002Ffilesys_stat","docs\u002F5.nodes\u002Ffilesys_stat",{"title":514,"path":515,"stem":516},"File Write","\u002Fdocs\u002Fnodes\u002Ffilesys_write","docs\u002F5.nodes\u002Ffilesys_write",{"title":518,"path":519,"stem":520},"FTP Delete","\u002Fdocs\u002Fnodes\u002Fftp_delete","docs\u002F5.nodes\u002Fftp_delete",{"title":522,"path":523,"stem":524},"FTP Download","\u002Fdocs\u002Fnodes\u002Fftp_download","docs\u002F5.nodes\u002Fftp_download",{"title":526,"path":527,"stem":528},"FTP List","\u002Fdocs\u002Fnodes\u002Fftp_list","docs\u002F5.nodes\u002Fftp_list",{"title":530,"path":531,"stem":532},"FTP Upload","\u002Fdocs\u002Fnodes\u002Fftp_upload","docs\u002F5.nodes\u002Fftp_upload",{"title":534,"path":535,"stem":536},"HTTP DELETE","\u002Fdocs\u002Fnodes\u002Fhttp_delete","docs\u002F5.nodes\u002Fhttp_delete",{"title":538,"path":539,"stem":540},"HTTP GET","\u002Fdocs\u002Fnodes\u002Fhttp_get","docs\u002F5.nodes\u002Fhttp_get",{"title":542,"path":543,"stem":544},"HTTP POST","\u002Fdocs\u002Fnodes\u002Fhttp_post","docs\u002F5.nodes\u002Fhttp_post",{"title":546,"path":547,"stem":548},"HTTP PUT","\u002Fdocs\u002Fnodes\u002Fhttp_put","docs\u002F5.nodes\u002Fhttp_put",{"title":550,"path":551,"stem":552},"HTTP Request","\u002Fdocs\u002Fnodes\u002Fhttp_request","docs\u002F5.nodes\u002Fhttp_request",{"title":554,"path":555,"stem":556},"Fill Translations","\u002Fdocs\u002Fnodes\u002Fi18n_fill-translations","docs\u002F5.nodes\u002Fi18n_fill-translations",{"title":558,"path":559,"stem":560},"Resolve Locale","\u002Fdocs\u002Fnodes\u002Fi18n_resolve-locale","docs\u002F5.nodes\u002Fi18n_resolve-locale",{"title":562,"path":563,"stem":564},"Translate","\u002Fdocs\u002Fnodes\u002Fi18n_translate","docs\u002F5.nodes\u002Fi18n_translate",{"title":566,"path":567,"stem":568},"Mongo AGGREGATE","\u002Fdocs\u002Fnodes\u002Fmongoops_aggregate","docs\u002F5.nodes\u002Fmongoops_aggregate",{"title":570,"path":571,"stem":572},"Mongo DELETE","\u002Fdocs\u002Fnodes\u002Fmongoops_delete","docs\u002F5.nodes\u002Fmongoops_delete",{"title":574,"path":575,"stem":576},"Mongo FIND","\u002Fdocs\u002Fnodes\u002Fmongoops_find","docs\u002F5.nodes\u002Fmongoops_find",{"title":578,"path":579,"stem":580},"Mongo FIND ONE","\u002Fdocs\u002Fnodes\u002Fmongoops_find-one","docs\u002F5.nodes\u002Fmongoops_find-one",{"title":582,"path":583,"stem":584},"Mongo INSERT","\u002Fdocs\u002Fnodes\u002Fmongoops_insert","docs\u002F5.nodes\u002Fmongoops_insert",{"title":586,"path":587,"stem":588},"Mongo UPDATE","\u002Fdocs\u002Fnodes\u002Fmongoops_update","docs\u002F5.nodes\u002Fmongoops_update",{"title":590,"path":591,"stem":592},"Postgres COPY FROM","\u002Fdocs\u002Fnodes\u002Fpostgres_copy-from","docs\u002F5.nodes\u002Fpostgres_copy-from",{"title":594,"path":595,"stem":596},"Postgres Exec","\u002Fdocs\u002Fnodes\u002Fpostgres_exec","docs\u002F5.nodes\u002Fpostgres_exec",{"title":598,"path":599,"stem":600},"Postgres Query","\u002Fdocs\u002Fnodes\u002Fpostgres_query","docs\u002F5.nodes\u002Fpostgres_query",{"title":602,"path":603,"stem":604},"Postgres Transaction","\u002Fdocs\u002Fnodes\u002Fpostgres_transaction","docs\u002F5.nodes\u002Fpostgres_transaction",{"title":606,"path":607,"stem":608},"RabbitMQ Consume","\u002Fdocs\u002Fnodes\u002Frabbitmq_consume","docs\u002F5.nodes\u002Frabbitmq_consume",{"title":610,"path":611,"stem":612},"RabbitMQ Declare","\u002Fdocs\u002Fnodes\u002Frabbitmq_declare","docs\u002F5.nodes\u002Frabbitmq_declare",{"title":614,"path":615,"stem":616},"RabbitMQ Publish","\u002Fdocs\u002Fnodes\u002Frabbitmq_publish","docs\u002F5.nodes\u002Frabbitmq_publish",{"title":618,"path":619,"stem":620},"Auth Login","\u002Fdocs\u002Fnodes\u002Fredelay_auth-login","docs\u002F5.nodes\u002Fredelay_auth-login",{"title":622,"path":623,"stem":624},"Require Permission","\u002Fdocs\u002Fnodes\u002Fredelay_auth-require-permission","docs\u002F5.nodes\u002Fredelay_auth-require-permission",{"title":626,"path":627,"stem":628},"Validate Token","\u002Fdocs\u002Fnodes\u002Fredelay_auth-validate-token","docs\u002F5.nodes\u002Fredelay_auth-validate-token",{"title":630,"path":631,"stem":632},"Render Email Template","\u002Fdocs\u002Fnodes\u002Fredelay_email-render-template","docs\u002F5.nodes\u002Fredelay_email-render-template",{"title":634,"path":635,"stem":636},"Send Email","\u002Fdocs\u002Fnodes\u002Fredelay_email-send","docs\u002F5.nodes\u002Fredelay_email-send",{"title":638,"path":639,"stem":640},"Send Templated Email","\u002Fdocs\u002Fnodes\u002Fredelay_email-send-templated","docs\u002F5.nodes\u002Fredelay_email-send-templated",{"title":642,"path":643,"stem":644},"Event Source","\u002Fdocs\u002Fnodes\u002Fredelay_event-source","docs\u002F5.nodes\u002Fredelay_event-source",{"title":646,"path":647,"stem":648},"Create Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-create-group","docs\u002F5.nodes\u002Fredelay_groups-create-group",{"title":650,"path":651,"stem":652},"Delete Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-delete-group","docs\u002F5.nodes\u002Fredelay_groups-delete-group",{"title":654,"path":655,"stem":656},"Resolve Permissions","\u002Fdocs\u002Fnodes\u002Fredelay_groups-resolve-permissions","docs\u002F5.nodes\u002Fredelay_groups-resolve-permissions",{"title":658,"path":659,"stem":660},"Update Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-update-group","docs\u002F5.nodes\u002Fredelay_groups-update-group",{"title":662,"path":663,"stem":664},"HTTP Endpoint","\u002Fdocs\u002Fnodes\u002Fredelay_http-endpoint","docs\u002F5.nodes\u002Fredelay_http-endpoint",{"title":666,"path":667,"stem":668},"JSON Stream Source","\u002Fdocs\u002Fnodes\u002Fredelay_json-stream-source","docs\u002F5.nodes\u002Fredelay_json-stream-source",{"title":670,"path":671,"stem":672},"JSON → Event","\u002Fdocs\u002Fnodes\u002Fredelay_json-to-event","docs\u002F5.nodes\u002Fredelay_json-to-event",{"title":674,"path":675,"stem":676},"Kafka Produce","\u002Fdocs\u002Fnodes\u002Fredelay_kafka-produce","docs\u002F5.nodes\u002Fredelay_kafka-produce",{"title":678,"path":679,"stem":680},"Create Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-create","docs\u002F5.nodes\u002Fredelay_links-create",{"title":682,"path":683,"stem":684},"Delete Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-delete","docs\u002F5.nodes\u002Fredelay_links-delete",{"title":686,"path":687,"stem":688},"Resolve Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-resolve","docs\u002F5.nodes\u002Fredelay_links-resolve",{"title":690,"path":691,"stem":692},"LLM Chat","\u002Fdocs\u002Fnodes\u002Fredelay_llm-chat","docs\u002F5.nodes\u002Fredelay_llm-chat",{"title":694,"path":695,"stem":696},"LLM Embed","\u002Fdocs\u002Fnodes\u002Fredelay_llm-embed","docs\u002F5.nodes\u002Fredelay_llm-embed",{"title":698,"path":699,"stem":700},"LLM Guard","\u002Fdocs\u002Fnodes\u002Fredelay_llm-guard","docs\u002F5.nodes\u002Fredelay_llm-guard",{"title":702,"path":703,"stem":704},"LLM Tool Router","\u002Fdocs\u002Fnodes\u002Fredelay_llm-tool-router","docs\u002F5.nodes\u002Fredelay_llm-tool-router",{"title":706,"path":707,"stem":708},"NATS Publish","\u002Fdocs\u002Fnodes\u002Fredelay_nats-publish","docs\u002F5.nodes\u002Fredelay_nats-publish",{"title":710,"path":711,"stem":712},"Mark Notification Read","\u002Fdocs\u002Fnodes\u002Fredelay_notifications-mark-read","docs\u002F5.nodes\u002Fredelay_notifications-mark-read",{"title":714,"path":715,"stem":716},"Send Notification","\u002Fdocs\u002Fnodes\u002Fredelay_notifications-send","docs\u002F5.nodes\u002Fredelay_notifications-send",{"title":718,"path":719,"stem":720},"Redis Stream XADD","\u002Fdocs\u002Fnodes\u002Fredelay_redis-stream-publish","docs\u002F5.nodes\u002Fredelay_redis-stream-publish",{"title":722,"path":723,"stem":724},"S3 Copy Object","\u002Fdocs\u002Fnodes\u002Fredelay_s3-copy-object","docs\u002F5.nodes\u002Fredelay_s3-copy-object",{"title":726,"path":727,"stem":728},"S3 Delete Many","\u002Fdocs\u002Fnodes\u002Fredelay_s3-delete-many","docs\u002F5.nodes\u002Fredelay_s3-delete-many",{"title":730,"path":731,"stem":732},"S3 Head Object","\u002Fdocs\u002Fnodes\u002Fredelay_s3-head-object","docs\u002F5.nodes\u002Fredelay_s3-head-object",{"title":734,"path":735,"stem":736},"S3 List Objects","\u002Fdocs\u002Fnodes\u002Fredelay_s3-list-objects","docs\u002F5.nodes\u002Fredelay_s3-list-objects",{"title":738,"path":739,"stem":740},"Create Schedule","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-create-schedule","docs\u002F5.nodes\u002Fredelay_scheduler-create-schedule",{"title":742,"path":743,"stem":744},"Cron Trigger","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-cron-trigger","docs\u002F5.nodes\u002Fredelay_scheduler-cron-trigger",{"title":746,"path":747,"stem":748},"Delete Schedule","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-delete-schedule","docs\u002F5.nodes\u002Fredelay_scheduler-delete-schedule",{"title":750,"path":751,"stem":752},"Interval Trigger","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-interval-trigger","docs\u002F5.nodes\u002Fredelay_scheduler-interval-trigger",{"title":754,"path":755,"stem":756},"Search Query","\u002Fdocs\u002Fnodes\u002Fredelay_search-query","docs\u002F5.nodes\u002Fredelay_search-query",{"title":758,"path":759,"stem":760},"Search Upsert","\u002Fdocs\u002Fnodes\u002Fredelay_search-upsert","docs\u002F5.nodes\u002Fredelay_search-upsert",{"title":762,"path":763,"stem":764},"Delete Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-delete","docs\u002F5.nodes\u002Fredelay_settings-delete",{"title":766,"path":767,"stem":768},"Get Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-get","docs\u002F5.nodes\u002Fredelay_settings-get",{"title":770,"path":771,"stem":772},"Set Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-set","docs\u002F5.nodes\u002Fredelay_settings-set",{"title":774,"path":775,"stem":776},"Delete File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-delete","docs\u002F5.nodes\u002Fredelay_storage-delete",{"title":778,"path":779,"stem":780},"Download File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-download","docs\u002F5.nodes\u002Fredelay_storage-download",{"title":782,"path":783,"stem":784},"Generate Presigned URL","\u002Fdocs\u002Fnodes\u002Fredelay_storage-presign-url","docs\u002F5.nodes\u002Fredelay_storage-presign-url",{"title":786,"path":787,"stem":788},"Upload File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-upload","docs\u002F5.nodes\u002Fredelay_storage-upload",{"title":790,"path":791,"stem":792},"Subworkflow","\u002Fdocs\u002Fnodes\u002Fredelay_subworkflow","docs\u002F5.nodes\u002Fredelay_subworkflow",{"title":794,"path":795,"stem":796},"Activate User","\u002Fdocs\u002Fnodes\u002Fredelay_users-activate","docs\u002F5.nodes\u002Fredelay_users-activate",{"title":798,"path":799,"stem":800},"Create Pending User","\u002Fdocs\u002Fnodes\u002Fredelay_users-create-pending","docs\u002F5.nodes\u002Fredelay_users-create-pending",{"title":802,"path":803,"stem":804},"Create User","\u002Fdocs\u002Fnodes\u002Fredelay_users-create-user","docs\u002F5.nodes\u002Fredelay_users-create-user",{"title":806,"path":807,"stem":808},"Delete User","\u002Fdocs\u002Fnodes\u002Fredelay_users-delete-user","docs\u002F5.nodes\u002Fredelay_users-delete-user",{"title":810,"path":811,"stem":812},"Find User By Email","\u002Fdocs\u002Fnodes\u002Fredelay_users-find-by-email","docs\u002F5.nodes\u002Fredelay_users-find-by-email",{"title":814,"path":815,"stem":816},"Get User","\u002Fdocs\u002Fnodes\u002Fredelay_users-get-user","docs\u002F5.nodes\u002Fredelay_users-get-user",{"title":818,"path":819,"stem":820},"List Users","\u002Fdocs\u002Fnodes\u002Fredelay_users-list-users","docs\u002F5.nodes\u002Fredelay_users-list-users",{"title":822,"path":823,"stem":824},"Update User","\u002Fdocs\u002Fnodes\u002Fredelay_users-update-user","docs\u002F5.nodes\u002Fredelay_users-update-user",{"title":826,"path":827,"stem":828},"Request Email Verification (legacy)","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request","docs\u002F5.nodes\u002Fredelay_verification-request",{"title":830,"path":831,"stem":832},"Request Email Verification","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request-email","docs\u002F5.nodes\u002Fredelay_verification-request-email",{"title":834,"path":835,"stem":836},"Request SMS Verification","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request-sms","docs\u002F5.nodes\u002Fredelay_verification-request-sms",{"title":838,"path":839,"stem":840},"Verify Token","\u002Fdocs\u002Fnodes\u002Fredelay_verification-verify","docs\u002F5.nodes\u002Fredelay_verification-verify",{"title":842,"path":843,"stem":844},"Redis DEL","\u002Fdocs\u002Fnodes\u002Fredisops_del","docs\u002F5.nodes\u002Fredisops_del",{"title":846,"path":847,"stem":848},"Redis EXPIRE","\u002Fdocs\u002Fnodes\u002Fredisops_expire","docs\u002F5.nodes\u002Fredisops_expire",{"title":850,"path":851,"stem":852},"Redis GET","\u002Fdocs\u002Fnodes\u002Fredisops_get","docs\u002F5.nodes\u002Fredisops_get",{"title":854,"path":855,"stem":856},"Redis HGET","\u002Fdocs\u002Fnodes\u002Fredisops_hget","docs\u002F5.nodes\u002Fredisops_hget",{"title":858,"path":859,"stem":860},"Redis HSET","\u002Fdocs\u002Fnodes\u002Fredisops_hset","docs\u002F5.nodes\u002Fredisops_hset",{"title":862,"path":863,"stem":864},"Redis INCR","\u002Fdocs\u002Fnodes\u002Fredisops_incr","docs\u002F5.nodes\u002Fredisops_incr",{"title":866,"path":867,"stem":868},"Redis LPOP","\u002Fdocs\u002Fnodes\u002Fredisops_lpop","docs\u002F5.nodes\u002Fredisops_lpop",{"title":870,"path":871,"stem":872},"Redis LPUSH","\u002Fdocs\u002Fnodes\u002Fredisops_lpush","docs\u002F5.nodes\u002Fredisops_lpush",{"title":874,"path":875,"stem":876},"Redis PUBLISH","\u002Fdocs\u002Fnodes\u002Fredisops_publish","docs\u002F5.nodes\u002Fredisops_publish",{"title":878,"path":879,"stem":880},"Redis SET","\u002Fdocs\u002Fnodes\u002Fredisops_set","docs\u002F5.nodes\u002Fredisops_set",{"title":882,"path":883,"stem":884},"SFTP Download","\u002Fdocs\u002Fnodes\u002Fsftp_download","docs\u002F5.nodes\u002Fsftp_download",{"title":886,"path":887,"stem":888},"SFTP Upload","\u002Fdocs\u002Fnodes\u002Fsftp_upload","docs\u002F5.nodes\u002Fsftp_upload",{"title":890,"path":891,"stem":892},"Send SMS","\u002Fdocs\u002Fnodes\u002Fsms_send","docs\u002F5.nodes\u002Fsms_send",{"title":894,"path":895,"stem":896,"children":897,"page":62},"Rfcs","\u002Fdocs\u002Frfcs","docs\u002F6.rfcs",[898],{"title":899,"path":900,"stem":901},"RFC 0001 — Worker Assignment for Flow Deployments","\u002Fdocs\u002Frfcs\u002F0001-worker-assignment","docs\u002F6.rfcs\u002F0001-worker-assignment",{"title":903,"path":904,"stem":905,"children":906,"page":62},"Admin","\u002Fdocs\u002Fadmin","docs\u002F7.admin",[907,912,917,922,927,932,937,941,946],{"title":5,"path":908,"stem":909,"order":910,"icon":911},"\u002Fdocs\u002Fadmin\u002Foverview","docs\u002F7.admin\u002F00.overview",0,"i-lucide-compass",{"title":913,"path":914,"stem":915,"order":10,"icon":916},"Getting started","\u002Fdocs\u002Fadmin\u002Fgetting-started","docs\u002F7.admin\u002F01.getting-started","i-lucide-play",{"title":918,"path":919,"stem":920,"order":16,"icon":921},"Layered architecture","\u002Fdocs\u002Fadmin\u002Flayered-architecture","docs\u002F7.admin\u002F02.layered-architecture","i-lucide-layers",{"title":923,"path":924,"stem":925,"order":22,"icon":926},"Building a custom admin project","\u002Fdocs\u002Fadmin\u002Fbuilding-a-custom-admin-project","docs\u002F7.admin\u002F03.building-a-custom-admin-project","i-lucide-folder-plus",{"title":928,"path":929,"stem":930,"order":51,"icon":931},"Building admin modules","\u002Fdocs\u002Fadmin\u002Fbuilding-admin-modules","docs\u002F7.admin\u002F04.building-admin-modules","i-lucide-package-plus",{"title":933,"path":934,"stem":935,"order":57,"icon":936},"Base module reference","\u002Fdocs\u002Fadmin\u002Freference-base-modules","docs\u002F7.admin\u002F05.reference-base-modules","i-lucide-boxes",{"title":938,"path":939,"stem":940,"order":102,"icon":17},"Deployment","\u002Fdocs\u002Fadmin\u002Fdeployment","docs\u002F7.admin\u002F06.deployment",{"title":942,"path":943,"stem":944,"order":108,"icon":945},"Consuming the base layer (versioned)","\u002Fdocs\u002Fadmin\u002Fconsuming-the-base-layer","docs\u002F7.admin\u002F07.consuming-the-base-layer","i-lucide-package",{"title":947,"path":948,"stem":949,"order":108},"Admin UI","\u002Fdocs\u002Fadmin\u002F_dir","docs\u002F7.admin\u002F_dir",{"title":951,"path":952,"stem":953,"children":954,"page":62},"Services","\u002Fdocs\u002Fservices","docs\u002F8.services",[955,960],{"title":956,"path":957,"stem":958,"order":10,"icon":959},"Custom development & support services","\u002Fdocs\u002Fservices\u002Fcustom-development","docs\u002F8.services\u002F1.custom-development","i-lucide-briefcase",{"title":951,"path":961,"stem":962,"icon":959,"order":963},"\u002Fdocs\u002Fservices\u002F_dir","docs\u002F8.services\u002F_dir",80,{"title":965,"path":966,"stem":967,"order":910},"Dir","\u002Fdocs\u002F_dir","docs\u002F_dir",{"id":969,"title":86,"body":970,"description":2484,"extension":2485,"links":2486,"meta":2487,"navigation":2488,"path":87,"seo":2489,"stem":88,"__hash__":2490},"docs\u002Fdocs\u002F3.guides\u002F3.adding-events-to-go-module.md",{"type":971,"value":972,"toc":2466},"minimark",[973,978,982,987,1013,1017,1028,1137,1143,1231,1236,1239,1268,1325,1333,1337,1344,1520,1527,1531,1550,1570,1574,1583,1754,1758,1765,1773,1777,1784,1828,1838,1900,1904,1983,1987,1998,2226,2230,2366,2370,2453,2462],[974,975,977],"h1",{"id":976},"adding-events-to-a-go-module","Adding Events to a Go Module",[979,980,981],"p",{},"This guide walks through the full event integration for a Go module: defining typed events, publishing from handlers, consuming events from other modules, and testing without Kafka.",[983,984,986],"h2",{"id":985},"prerequisites","Prerequisites",[988,989,990,998,1005],"ul",{},[991,992,993,994,997],"li",{},"Go module scaffold in place (see ",[995,996,82],"a",{"href":83},")",[991,999,1000,1004],{},[1001,1002,1003],"code",{},"go-events"," added to your app's dependencies",[991,1006,1007,1010,1011,997],{},[1001,1008,1009],{},"EventBus"," wired at bootstrap (see ",[995,1012,69],{"href":70},[983,1014,1016],{"id":1015},"_1-define-event-types","1. Define event types",[979,1018,1019,1020,1023,1024,1027],{},"Create ",[1001,1021,1022],{},"events.go"," alongside ",[1001,1025,1026],{},"module.go",":",[1029,1030,1035],"pre",{"className":1031,"code":1032,"language":1033,"meta":1034,"style":1034},"language-go shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","package orders\n\nimport \"github.com\u002Fredelay\u002Fgo-events\u002Ftyped\"\n\n\u002F\u002F OrderCreatedPayload is the canonical payload for order.created events.\n\u002F\u002F Defined here so any module can reference it without importing this package.\ntype OrderCreatedPayload struct {\n    OrderID  string  `json:\"order_id\"`\n    Total    float64 `json:\"total\"`\n    Currency string  `json:\"currency\"`\n}\n\n\u002F\u002F OrderCreatedEvent is the compile-time-safe event descriptor.\n\u002F\u002F Call NewMessage() to produce a ready-to-publish EventMessage.\nvar OrderCreatedEvent = typed.EventDefinition[OrderCreatedPayload]{\n    Name:       \"order.created\",\n    EntityType: \"order\",\n    Action:     \"created\",\n    Topic:      \"order.created\",\n}\n","go","",[1001,1036,1037,1044,1050,1055,1059,1064,1069,1074,1079,1084,1089,1094,1098,1103,1108,1113,1118,1123,1128,1133],{"__ignoreMap":1034},[1038,1039,1041],"span",{"class":1040,"line":10},"line",[1038,1042,1043],{},"package orders\n",[1038,1045,1046],{"class":1040,"line":16},[1038,1047,1049],{"emptyLinePlaceholder":1048},true,"\n",[1038,1051,1052],{"class":1040,"line":22},[1038,1053,1054],{},"import \"github.com\u002Fredelay\u002Fgo-events\u002Ftyped\"\n",[1038,1056,1057],{"class":1040,"line":51},[1038,1058,1049],{"emptyLinePlaceholder":1048},[1038,1060,1061],{"class":1040,"line":57},[1038,1062,1063],{},"\u002F\u002F OrderCreatedPayload is the canonical payload for order.created events.\n",[1038,1065,1066],{"class":1040,"line":102},[1038,1067,1068],{},"\u002F\u002F Defined here so any module can reference it without importing this package.\n",[1038,1070,1071],{"class":1040,"line":108},[1038,1072,1073],{},"type OrderCreatedPayload struct {\n",[1038,1075,1076],{"class":1040,"line":114},[1038,1077,1078],{},"    OrderID  string  `json:\"order_id\"`\n",[1038,1080,1081],{"class":1040,"line":120},[1038,1082,1083],{},"    Total    float64 `json:\"total\"`\n",[1038,1085,1086],{"class":1040,"line":181},[1038,1087,1088],{},"    Currency string  `json:\"currency\"`\n",[1038,1090,1091],{"class":1040,"line":186},[1038,1092,1093],{},"}\n",[1038,1095,1096],{"class":1040,"line":191},[1038,1097,1049],{"emptyLinePlaceholder":1048},[1038,1099,1100],{"class":1040,"line":197},[1038,1101,1102],{},"\u002F\u002F OrderCreatedEvent is the compile-time-safe event descriptor.\n",[1038,1104,1105],{"class":1040,"line":203},[1038,1106,1107],{},"\u002F\u002F Call NewMessage() to produce a ready-to-publish EventMessage.\n",[1038,1109,1110],{"class":1040,"line":214},[1038,1111,1112],{},"var OrderCreatedEvent = typed.EventDefinition[OrderCreatedPayload]{\n",[1038,1114,1115],{"class":1040,"line":223},[1038,1116,1117],{},"    Name:       \"order.created\",\n",[1038,1119,1120],{"class":1040,"line":229},[1038,1121,1122],{},"    EntityType: \"order\",\n",[1038,1124,1125],{"class":1040,"line":234},[1038,1126,1127],{},"    Action:     \"created\",\n",[1038,1129,1130],{"class":1040,"line":240},[1038,1131,1132],{},"    Topic:      \"order.created\",\n",[1038,1134,1135],{"class":1040,"line":246},[1038,1136,1093],{},[979,1138,1139,1140,1027],{},"Rules for ",[1001,1141,1142],{},"typed.EventDefinition",[1144,1145,1146,1159],"table",{},[1147,1148,1149],"thead",{},[1150,1151,1152,1156],"tr",{},[1153,1154,1155],"th",{},"Field",[1153,1157,1158],{},"Convention",[1160,1161,1162,1176,1196,1218],"tbody",{},[1150,1163,1164,1170],{},[1165,1166,1167],"td",{},[1001,1168,1169],{},"Name",[1165,1171,1172,1175],{},[1001,1173,1174],{},"{entity}.{action}"," — matches Topic for simplicity",[1150,1177,1178,1183],{},[1165,1179,1180],{},[1001,1181,1182],{},"EntityType",[1165,1184,1185,1186,1189,1190,1189,1193,997],{},"Lowercase singular noun (",[1001,1187,1188],{},"order",", ",[1001,1191,1192],{},"user",[1001,1194,1195],{},"invoice",[1150,1197,1198,1203],{},[1165,1199,1200],{},[1001,1201,1202],{},"Action",[1165,1204,1205,1206,1189,1209,1189,1212,1189,1215,997],{},"Past-tense verb (",[1001,1207,1208],{},"created",[1001,1210,1211],{},"updated",[1001,1213,1214],{},"deleted",[1001,1216,1217],{},"completed",[1150,1219,1220,1225],{},[1165,1221,1222],{},[1001,1223,1224],{},"Topic",[1165,1226,1227,1228,1230],{},"Kafka\u002FRedis\u002FNATS topic name. Mirror ",[1001,1229,1169],{}," unless fan-out is needed",[1232,1233,1235],"h3",{"id":1234},"surface-the-payload-in-asyncapi","Surface the payload in AsyncAPI",[979,1237,1238],{},"So reaction flows and the AsyncAPI Studio see the real fields of your event\n(not an opaque envelope), publish the payload struct and link it to the event:",[1029,1240,1242],{"className":1031,"code":1241,"language":1033,"meta":1034,"style":1034},"\u002F\u002F modules.AsyncAPISchemasProvider — reflects the struct into\n\u002F\u002F \u002Fasyncapi.json#\u002Fcomponents\u002Fschemas\u002FOrderCreatedPayload\nfunc (m *Module) AsyncAPISchemas() []any {\n    return []any{OrderCreatedPayload{}}\n}\n",[1001,1243,1244,1249,1254,1259,1264],{"__ignoreMap":1034},[1038,1245,1246],{"class":1040,"line":10},[1038,1247,1248],{},"\u002F\u002F modules.AsyncAPISchemasProvider — reflects the struct into\n",[1038,1250,1251],{"class":1040,"line":16},[1038,1252,1253],{},"\u002F\u002F \u002Fasyncapi.json#\u002Fcomponents\u002Fschemas\u002FOrderCreatedPayload\n",[1038,1255,1256],{"class":1040,"line":22},[1038,1257,1258],{},"func (m *Module) AsyncAPISchemas() []any {\n",[1038,1260,1261],{"class":1040,"line":51},[1038,1262,1263],{},"    return []any{OrderCreatedPayload{}}\n",[1038,1265,1266],{"class":1040,"line":57},[1038,1267,1093],{},[1029,1269,1273],{"className":1270,"code":1271,"language":1272,"meta":1034,"style":1034},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# module.yaml — link the event to the reflected schema\nevents:\n  - topic: order.created\n    description: An order was created.\n    payload_ref: OrderCreatedPayload\n","yaml",[1001,1274,1275,1281,1291,1305,1315],{"__ignoreMap":1034},[1038,1276,1277],{"class":1040,"line":10},[1038,1278,1280],{"class":1279},"sHwdD","# module.yaml — link the event to the reflected schema\n",[1038,1282,1283,1287],{"class":1040,"line":16},[1038,1284,1286],{"class":1285},"swJcz","events",[1038,1288,1290],{"class":1289},"sMK4o",":\n",[1038,1292,1293,1296,1299,1301],{"class":1040,"line":22},[1038,1294,1295],{"class":1289},"  -",[1038,1297,1298],{"class":1285}," topic",[1038,1300,1027],{"class":1289},[1038,1302,1304],{"class":1303},"sfazB"," order.created\n",[1038,1306,1307,1310,1312],{"class":1040,"line":51},[1038,1308,1309],{"class":1285},"    description",[1038,1311,1027],{"class":1289},[1038,1313,1314],{"class":1303}," An order was created.\n",[1038,1316,1317,1320,1322],{"class":1040,"line":57},[1038,1318,1319],{"class":1285},"    payload_ref",[1038,1321,1027],{"class":1289},[1038,1323,1324],{"class":1303}," OrderCreatedPayload\n",[979,1326,1327,1328,1332],{},"See ",[995,1329,1331],{"href":1330},"\u002Fdocs\u002Fintegrations\u002Fasyncapi#reflected-go-payload-structs-asyncapischemasprovider","AsyncAPI → Reflected Go payload structs","\nfor the full contract.",[983,1334,1336],{"id":1335},"_2-publish-events-from-service-methods","2. Publish events from service methods",[979,1338,1339,1340,1343],{},"Pass ",[1001,1341,1342],{},"modules.EventBus"," into the service:",[1029,1345,1347],{"className":1031,"code":1346,"language":1033,"meta":1034,"style":1034},"type Service struct {\n    crud     *crud.MongoCRUD[*Order]\n    eventBus modules.EventBus\n    logger   *zap.Logger\n}\n\nfunc NewService(col *mongo.Collection, bus modules.EventBus, logger *zap.Logger) *Service {\n    return &Service{crud: crud.NewMongoCRUD[*Order](col), eventBus: bus, logger: logger}\n}\n\nfunc (s *Service) Create(ctx context.Context, input *CreateOrderInput) (*Order, error) {\n    order, err := s.crud.Create(ctx, &Order{\n        Total:    input.Total,\n        Currency: input.Currency,\n    })\n    if err != nil {\n        return nil, err\n    }\n\n    if s.eventBus != nil {\n        msg, err := OrderCreatedEvent.NewMessage(\n            order.ID.Hex(),\n            typed.Actor{Type: typed.ActorTypeUser, ID: input.UserID},\n            OrderCreatedPayload{OrderID: order.ID.Hex(), Total: order.Total, Currency: order.Currency},\n        )\n        if err != nil {\n            s.logger.Error(\"failed to build order.created message\", zap.Error(err))\n        } else if err := s.eventBus.Publish(ctx, msg); err != nil {\n            s.logger.Error(\"failed to publish order.created\", zap.Error(err))\n        }\n    }\n\n    return order, nil\n}\n",[1001,1348,1349,1354,1359,1364,1369,1373,1377,1382,1387,1391,1395,1400,1405,1410,1415,1420,1425,1430,1435,1439,1444,1449,1454,1460,1466,1471,1476,1481,1487,1493,1499,1504,1509,1515],{"__ignoreMap":1034},[1038,1350,1351],{"class":1040,"line":10},[1038,1352,1353],{},"type Service struct {\n",[1038,1355,1356],{"class":1040,"line":16},[1038,1357,1358],{},"    crud     *crud.MongoCRUD[*Order]\n",[1038,1360,1361],{"class":1040,"line":22},[1038,1362,1363],{},"    eventBus modules.EventBus\n",[1038,1365,1366],{"class":1040,"line":51},[1038,1367,1368],{},"    logger   *zap.Logger\n",[1038,1370,1371],{"class":1040,"line":57},[1038,1372,1093],{},[1038,1374,1375],{"class":1040,"line":102},[1038,1376,1049],{"emptyLinePlaceholder":1048},[1038,1378,1379],{"class":1040,"line":108},[1038,1380,1381],{},"func NewService(col *mongo.Collection, bus modules.EventBus, logger *zap.Logger) *Service {\n",[1038,1383,1384],{"class":1040,"line":114},[1038,1385,1386],{},"    return &Service{crud: crud.NewMongoCRUD[*Order](col), eventBus: bus, logger: logger}\n",[1038,1388,1389],{"class":1040,"line":120},[1038,1390,1093],{},[1038,1392,1393],{"class":1040,"line":181},[1038,1394,1049],{"emptyLinePlaceholder":1048},[1038,1396,1397],{"class":1040,"line":186},[1038,1398,1399],{},"func (s *Service) Create(ctx context.Context, input *CreateOrderInput) (*Order, error) {\n",[1038,1401,1402],{"class":1040,"line":191},[1038,1403,1404],{},"    order, err := s.crud.Create(ctx, &Order{\n",[1038,1406,1407],{"class":1040,"line":197},[1038,1408,1409],{},"        Total:    input.Total,\n",[1038,1411,1412],{"class":1040,"line":203},[1038,1413,1414],{},"        Currency: input.Currency,\n",[1038,1416,1417],{"class":1040,"line":214},[1038,1418,1419],{},"    })\n",[1038,1421,1422],{"class":1040,"line":223},[1038,1423,1424],{},"    if err != nil {\n",[1038,1426,1427],{"class":1040,"line":229},[1038,1428,1429],{},"        return nil, err\n",[1038,1431,1432],{"class":1040,"line":234},[1038,1433,1434],{},"    }\n",[1038,1436,1437],{"class":1040,"line":240},[1038,1438,1049],{"emptyLinePlaceholder":1048},[1038,1440,1441],{"class":1040,"line":246},[1038,1442,1443],{},"    if s.eventBus != nil {\n",[1038,1445,1446],{"class":1040,"line":251},[1038,1447,1448],{},"        msg, err := OrderCreatedEvent.NewMessage(\n",[1038,1450,1451],{"class":1040,"line":257},[1038,1452,1453],{},"            order.ID.Hex(),\n",[1038,1455,1457],{"class":1040,"line":1456},23,[1038,1458,1459],{},"            typed.Actor{Type: typed.ActorTypeUser, ID: input.UserID},\n",[1038,1461,1463],{"class":1040,"line":1462},24,[1038,1464,1465],{},"            OrderCreatedPayload{OrderID: order.ID.Hex(), Total: order.Total, Currency: order.Currency},\n",[1038,1467,1468],{"class":1040,"line":271},[1038,1469,1470],{},"        )\n",[1038,1472,1473],{"class":1040,"line":277},[1038,1474,1475],{},"        if err != nil {\n",[1038,1477,1478],{"class":1040,"line":282},[1038,1479,1480],{},"            s.logger.Error(\"failed to build order.created message\", zap.Error(err))\n",[1038,1482,1484],{"class":1040,"line":1483},28,[1038,1485,1486],{},"        } else if err := s.eventBus.Publish(ctx, msg); err != nil {\n",[1038,1488,1490],{"class":1040,"line":1489},29,[1038,1491,1492],{},"            s.logger.Error(\"failed to publish order.created\", zap.Error(err))\n",[1038,1494,1496],{"class":1040,"line":1495},30,[1038,1497,1498],{},"        }\n",[1038,1500,1502],{"class":1040,"line":1501},31,[1038,1503,1434],{},[1038,1505,1507],{"class":1040,"line":1506},32,[1038,1508,1049],{"emptyLinePlaceholder":1048},[1038,1510,1512],{"class":1040,"line":1511},33,[1038,1513,1514],{},"    return order, nil\n",[1038,1516,1518],{"class":1040,"line":1517},34,[1038,1519,1093],{},[979,1521,1522,1523,1526],{},"Always guard ",[1001,1524,1525],{},"eventBus != nil"," — modules must work in apps without a transport configured.",[1232,1528,1530],{"id":1529},"correlation-id-propagation","Correlation ID propagation",[979,1532,1533,1534,1537,1538,1541,1542,1545,1546,1549],{},"Pass the request ",[1001,1535,1536],{},"ctx"," directly to ",[1001,1539,1540],{},"Publish",". The ",[1001,1543,1544],{},"CorrelationPublishMiddleware"," (installed\nby default in ",[1001,1547,1548],{},"eventbus.New()",") reads the correlation ID from context and injects it into\nthe message header automatically.",[1029,1551,1553],{"className":1031,"code":1552,"language":1033,"meta":1034,"style":1034},"\u002F\u002F Set a correlation ID on an incoming HTTP request context:\nctx = eventbus.WithCorrelationID(ctx, r.Header.Get(\"X-Request-ID\"))\n\u002F\u002F Now any Publish call within this ctx will carry the same correlation_id.\n",[1001,1554,1555,1560,1565],{"__ignoreMap":1034},[1038,1556,1557],{"class":1040,"line":10},[1038,1558,1559],{},"\u002F\u002F Set a correlation ID on an incoming HTTP request context:\n",[1038,1561,1562],{"class":1040,"line":16},[1038,1563,1564],{},"ctx = eventbus.WithCorrelationID(ctx, r.Header.Get(\"X-Request-ID\"))\n",[1038,1566,1567],{"class":1040,"line":22},[1038,1568,1569],{},"\u002F\u002F Now any Publish call within this ctx will carry the same correlation_id.\n",[983,1571,1573],{"id":1572},"_3-consume-events-from-other-modules","3. Consume events from other modules",[979,1575,1576,1577,1580,1581,1027],{},"Implement ",[1001,1578,1579],{},"EventsProvider"," in ",[1001,1582,1026],{},[1029,1584,1586],{"className":1031,"code":1585,"language":1033,"meta":1034,"style":1034},"import (\n    \"encoding\u002Fjson\"\n\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fcore\u002Fir\"\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\"\n)\n\n\u002F\u002F Events returns IR metadata for modspec and AsyncAPI spec generation.\nfunc (m *Module) Events() []*ir.Event {\n    return []*ir.Event{\n        {Name: \"order.created\", EntityType: \"order\", Action: \"created\"},\n        \u002F\u002F Consumed events can also be listed here for documentation:\n        {Name: \"payment.completed\", EntityType: \"payment\", Action: \"completed\"},\n    }\n}\n\n\u002F\u002F Consumers returns runtime subscriptions. Called before bus.Start().\nfunc (m *Module) Consumers() []*modules.ConsumerRegistration {\n    return []*modules.ConsumerRegistration{\n        {\n            EventName: \"payment.completed\",\n            Topic:     \"payment.completed\",\n            GroupID:   \"orders\",\n            Handler:   m.handlePaymentCompleted,\n        },\n    }\n}\n\nfunc (m *Module) handlePaymentCompleted(ctx context.Context, msg *modules.EventMessage) error {\n    var p PaymentCompletedPayload\n    if err := json.Unmarshal(msg.Payload, &p); err != nil {\n        return fmt.Errorf(\"orders: unmarshal payment.completed: %w\", err)\n    }\n    return m.Service.MarkAsPaid(ctx, p.OrderID)\n}\n",[1001,1587,1588,1593,1598,1602,1607,1612,1617,1621,1626,1631,1636,1641,1646,1651,1655,1659,1663,1668,1673,1678,1683,1688,1693,1698,1703,1708,1712,1716,1720,1725,1730,1735,1740,1744,1749],{"__ignoreMap":1034},[1038,1589,1590],{"class":1040,"line":10},[1038,1591,1592],{},"import (\n",[1038,1594,1595],{"class":1040,"line":16},[1038,1596,1597],{},"    \"encoding\u002Fjson\"\n",[1038,1599,1600],{"class":1040,"line":22},[1038,1601,1049],{"emptyLinePlaceholder":1048},[1038,1603,1604],{"class":1040,"line":51},[1038,1605,1606],{},"    \"github.com\u002Fredelay\u002Fgo-framework\u002Fcore\u002Fir\"\n",[1038,1608,1609],{"class":1040,"line":57},[1038,1610,1611],{},"    \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\"\n",[1038,1613,1614],{"class":1040,"line":102},[1038,1615,1616],{},")\n",[1038,1618,1619],{"class":1040,"line":108},[1038,1620,1049],{"emptyLinePlaceholder":1048},[1038,1622,1623],{"class":1040,"line":114},[1038,1624,1625],{},"\u002F\u002F Events returns IR metadata for modspec and AsyncAPI spec generation.\n",[1038,1627,1628],{"class":1040,"line":120},[1038,1629,1630],{},"func (m *Module) Events() []*ir.Event {\n",[1038,1632,1633],{"class":1040,"line":181},[1038,1634,1635],{},"    return []*ir.Event{\n",[1038,1637,1638],{"class":1040,"line":186},[1038,1639,1640],{},"        {Name: \"order.created\", EntityType: \"order\", Action: \"created\"},\n",[1038,1642,1643],{"class":1040,"line":191},[1038,1644,1645],{},"        \u002F\u002F Consumed events can also be listed here for documentation:\n",[1038,1647,1648],{"class":1040,"line":197},[1038,1649,1650],{},"        {Name: \"payment.completed\", EntityType: \"payment\", Action: \"completed\"},\n",[1038,1652,1653],{"class":1040,"line":203},[1038,1654,1434],{},[1038,1656,1657],{"class":1040,"line":214},[1038,1658,1093],{},[1038,1660,1661],{"class":1040,"line":223},[1038,1662,1049],{"emptyLinePlaceholder":1048},[1038,1664,1665],{"class":1040,"line":229},[1038,1666,1667],{},"\u002F\u002F Consumers returns runtime subscriptions. Called before bus.Start().\n",[1038,1669,1670],{"class":1040,"line":234},[1038,1671,1672],{},"func (m *Module) Consumers() []*modules.ConsumerRegistration {\n",[1038,1674,1675],{"class":1040,"line":240},[1038,1676,1677],{},"    return []*modules.ConsumerRegistration{\n",[1038,1679,1680],{"class":1040,"line":246},[1038,1681,1682],{},"        {\n",[1038,1684,1685],{"class":1040,"line":251},[1038,1686,1687],{},"            EventName: \"payment.completed\",\n",[1038,1689,1690],{"class":1040,"line":257},[1038,1691,1692],{},"            Topic:     \"payment.completed\",\n",[1038,1694,1695],{"class":1040,"line":1456},[1038,1696,1697],{},"            GroupID:   \"orders\",\n",[1038,1699,1700],{"class":1040,"line":1462},[1038,1701,1702],{},"            Handler:   m.handlePaymentCompleted,\n",[1038,1704,1705],{"class":1040,"line":271},[1038,1706,1707],{},"        },\n",[1038,1709,1710],{"class":1040,"line":277},[1038,1711,1434],{},[1038,1713,1714],{"class":1040,"line":282},[1038,1715,1093],{},[1038,1717,1718],{"class":1040,"line":1483},[1038,1719,1049],{"emptyLinePlaceholder":1048},[1038,1721,1722],{"class":1040,"line":1489},[1038,1723,1724],{},"func (m *Module) handlePaymentCompleted(ctx context.Context, msg *modules.EventMessage) error {\n",[1038,1726,1727],{"class":1040,"line":1495},[1038,1728,1729],{},"    var p PaymentCompletedPayload\n",[1038,1731,1732],{"class":1040,"line":1501},[1038,1733,1734],{},"    if err := json.Unmarshal(msg.Payload, &p); err != nil {\n",[1038,1736,1737],{"class":1040,"line":1506},[1038,1738,1739],{},"        return fmt.Errorf(\"orders: unmarshal payment.completed: %w\", err)\n",[1038,1741,1742],{"class":1040,"line":1511},[1038,1743,1434],{},[1038,1745,1746],{"class":1040,"line":1517},[1038,1747,1748],{},"    return m.Service.MarkAsPaid(ctx, p.OrderID)\n",[1038,1750,1752],{"class":1040,"line":1751},35,[1038,1753,1093],{},[1232,1755,1757],{"id":1756},"consumer-group-naming","Consumer group naming",[979,1759,1760,1761,1764],{},"Use your module name as ",[1001,1762,1763],{},"GroupID",". This ensures exactly-one delivery per module across\nscaled-out replicas:",[1029,1766,1771],{"className":1767,"code":1769,"language":1770},[1768],"language-text","GroupID: \"orders\"   \u002F\u002F all replicas of the orders module share this group\nGroupID: \"notifications\"\nGroupID: \"invoices\"\n","text",[1001,1772,1769],{"__ignoreMap":1034},[1232,1774,1776],{"id":1775},"filtering","Filtering",[979,1778,1779,1780,1783],{},"Register a ",[1001,1781,1782],{},"Filter"," to skip messages that don't apply to this handler:",[1029,1785,1787],{"className":1031,"code":1786,"language":1033,"meta":1034,"style":1034},"{\n    Topic:   \"entity.updated\",\n    GroupID: \"orders\",\n    Filter: func(msg *modules.EventMessage) bool {\n        return msg.EntityType == \"order\"\n    },\n    Handler: m.handleOrderUpdated,\n}\n",[1001,1788,1789,1794,1799,1804,1809,1814,1819,1824],{"__ignoreMap":1034},[1038,1790,1791],{"class":1040,"line":10},[1038,1792,1793],{},"{\n",[1038,1795,1796],{"class":1040,"line":16},[1038,1797,1798],{},"    Topic:   \"entity.updated\",\n",[1038,1800,1801],{"class":1040,"line":22},[1038,1802,1803],{},"    GroupID: \"orders\",\n",[1038,1805,1806],{"class":1040,"line":51},[1038,1807,1808],{},"    Filter: func(msg *modules.EventMessage) bool {\n",[1038,1810,1811],{"class":1040,"line":57},[1038,1812,1813],{},"        return msg.EntityType == \"order\"\n",[1038,1815,1816],{"class":1040,"line":102},[1038,1817,1818],{},"    },\n",[1038,1820,1821],{"class":1040,"line":108},[1038,1822,1823],{},"    Handler: m.handleOrderUpdated,\n",[1038,1825,1826],{"class":1040,"line":114},[1038,1827,1093],{},[979,1829,1830,1831,1834,1835,1837],{},"Or use the ",[1001,1832,1833],{},"filter"," package from ",[1001,1836,1003],{}," for reusable filters:",[1029,1839,1841],{"className":1031,"code":1840,"language":1033,"meta":1034,"style":1034},"import \"github.com\u002Fredelay\u002Fgo-events\u002Ffilter\"\n\nf := filter.All(\n    &filter.ActionFilter{EntityType: \"order\", Action: \"updated\"},\n    &filter.HeaderFilter{Key: \"env\", Value: \"prod\"},\n)\n\n{\n    Topic:   \"entity.updated\",\n    GroupID: \"orders\",\n    Filter:  f.Matches,\n    Handler: m.handleOrderUpdated,\n}\n",[1001,1842,1843,1848,1852,1857,1862,1867,1871,1875,1879,1883,1887,1892,1896],{"__ignoreMap":1034},[1038,1844,1845],{"class":1040,"line":10},[1038,1846,1847],{},"import \"github.com\u002Fredelay\u002Fgo-events\u002Ffilter\"\n",[1038,1849,1850],{"class":1040,"line":16},[1038,1851,1049],{"emptyLinePlaceholder":1048},[1038,1853,1854],{"class":1040,"line":22},[1038,1855,1856],{},"f := filter.All(\n",[1038,1858,1859],{"class":1040,"line":51},[1038,1860,1861],{},"    &filter.ActionFilter{EntityType: \"order\", Action: \"updated\"},\n",[1038,1863,1864],{"class":1040,"line":57},[1038,1865,1866],{},"    &filter.HeaderFilter{Key: \"env\", Value: \"prod\"},\n",[1038,1868,1869],{"class":1040,"line":102},[1038,1870,1616],{},[1038,1872,1873],{"class":1040,"line":108},[1038,1874,1049],{"emptyLinePlaceholder":1048},[1038,1876,1877],{"class":1040,"line":114},[1038,1878,1793],{},[1038,1880,1881],{"class":1040,"line":120},[1038,1882,1798],{},[1038,1884,1885],{"class":1040,"line":181},[1038,1886,1803],{},[1038,1888,1889],{"class":1040,"line":186},[1038,1890,1891],{},"    Filter:  f.Matches,\n",[1038,1893,1894],{"class":1040,"line":191},[1038,1895,1823],{},[1038,1897,1898],{"class":1040,"line":197},[1038,1899,1093],{},[983,1901,1903],{"id":1902},"_4-wire-eventbus-into-the-module-factory","4. Wire EventBus into the module factory",[1029,1905,1907],{"className":1031,"code":1906,"language":1033,"meta":1034,"style":1034},"func init() {\n    modules.RegisterFactory(\"orders\", func(deps modules.ModuleDeps) (modules.Module, error) {\n        cfg := DefaultConfig()\n        return NewModule(deps.DB, cfg, deps.Logger, deps.EventBus), nil\n    })\n}\n\nfunc NewModule(db *mongo.Database, cfg *Config, logger *zap.Logger, bus modules.EventBus) *Module {\n    return &Module{db: db, cfg: cfg, logger: logger, eventBus: bus}\n}\n\nfunc (m *Module) Startup(ctx context.Context) error {\n    col := m.db.Collection(m.cfg.Collection)\n    m.Service = NewService(col, m.eventBus, m.logger)\n    return m.Service.EnsureIndexes(ctx)\n}\n",[1001,1908,1909,1914,1919,1924,1929,1933,1937,1941,1946,1951,1955,1959,1964,1969,1974,1979],{"__ignoreMap":1034},[1038,1910,1911],{"class":1040,"line":10},[1038,1912,1913],{},"func init() {\n",[1038,1915,1916],{"class":1040,"line":16},[1038,1917,1918],{},"    modules.RegisterFactory(\"orders\", func(deps modules.ModuleDeps) (modules.Module, error) {\n",[1038,1920,1921],{"class":1040,"line":22},[1038,1922,1923],{},"        cfg := DefaultConfig()\n",[1038,1925,1926],{"class":1040,"line":51},[1038,1927,1928],{},"        return NewModule(deps.DB, cfg, deps.Logger, deps.EventBus), nil\n",[1038,1930,1931],{"class":1040,"line":57},[1038,1932,1419],{},[1038,1934,1935],{"class":1040,"line":102},[1038,1936,1093],{},[1038,1938,1939],{"class":1040,"line":108},[1038,1940,1049],{"emptyLinePlaceholder":1048},[1038,1942,1943],{"class":1040,"line":114},[1038,1944,1945],{},"func NewModule(db *mongo.Database, cfg *Config, logger *zap.Logger, bus modules.EventBus) *Module {\n",[1038,1947,1948],{"class":1040,"line":120},[1038,1949,1950],{},"    return &Module{db: db, cfg: cfg, logger: logger, eventBus: bus}\n",[1038,1952,1953],{"class":1040,"line":181},[1038,1954,1093],{},[1038,1956,1957],{"class":1040,"line":186},[1038,1958,1049],{"emptyLinePlaceholder":1048},[1038,1960,1961],{"class":1040,"line":191},[1038,1962,1963],{},"func (m *Module) Startup(ctx context.Context) error {\n",[1038,1965,1966],{"class":1040,"line":197},[1038,1967,1968],{},"    col := m.db.Collection(m.cfg.Collection)\n",[1038,1970,1971],{"class":1040,"line":203},[1038,1972,1973],{},"    m.Service = NewService(col, m.eventBus, m.logger)\n",[1038,1975,1976],{"class":1040,"line":214},[1038,1977,1978],{},"    return m.Service.EnsureIndexes(ctx)\n",[1038,1980,1981],{"class":1040,"line":223},[1038,1982,1093],{},[983,1984,1986],{"id":1985},"_5-testing-without-kafka","5. Testing without Kafka",[979,1988,1989,1990,1993,1994,1997],{},"Use ",[1001,1991,1992],{},"memory.New()"," from ",[1001,1995,1996],{},"go-events\u002Ftransport\u002Fmemory"," — no broker required:",[1029,1999,2001],{"className":1031,"code":2000,"language":1033,"meta":1034,"style":1034},"package orders_test\n\nimport (\n    \"context\"\n    \"testing\"\n\n    \"github.com\u002Fredelay\u002Fgo-events\u002Feventbus\"\n    \"github.com\u002Fredelay\u002Fgo-events\u002Ftransport\u002Fmemory\"\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\"\n    \"yourorg\u002Fyourapp\u002Fmodules\u002Forders\"\n)\n\nfunc TestOrderCreatedEventPublished(t *testing.T) {\n    tr := memory.New()\n    bus := eventbus.New(tr)\n\n    var received *modules.EventMessage\n    bus.Register(&modules.ConsumerRegistration{\n        Topic:   \"order.created\",\n        GroupID: \"test\",\n        Handler: func(_ context.Context, msg *modules.EventMessage) error {\n            received = msg\n            return nil\n        },\n    })\n    if err := bus.Start(context.Background()); err != nil {\n        t.Fatal(err)\n    }\n\n    svc := orders.NewService(testCollection(t), bus, zaptest.NewLogger(t))\n    _, err := svc.Create(context.Background(), &orders.CreateOrderInput{\n        Total:    99.00,\n        Currency: \"USD\",\n        UserID:   \"user-1\",\n    })\n    if err != nil {\n        t.Fatalf(\"Create: %v\", err)\n    }\n\n    if received == nil {\n        t.Fatal(\"expected order.created event to be published\")\n    }\n    if received.EntityType != \"order\" || received.Action != \"created\" {\n        t.Errorf(\"unexpected event: %s.%s\", received.EntityType, received.Action)\n    }\n}\n",[1001,2002,2003,2008,2012,2016,2021,2026,2030,2035,2040,2044,2049,2053,2057,2062,2067,2072,2076,2081,2086,2091,2096,2101,2106,2111,2115,2119,2124,2129,2133,2137,2142,2147,2152,2157,2162,2166,2171,2177,2182,2187,2193,2199,2204,2210,2216,2221],{"__ignoreMap":1034},[1038,2004,2005],{"class":1040,"line":10},[1038,2006,2007],{},"package orders_test\n",[1038,2009,2010],{"class":1040,"line":16},[1038,2011,1049],{"emptyLinePlaceholder":1048},[1038,2013,2014],{"class":1040,"line":22},[1038,2015,1592],{},[1038,2017,2018],{"class":1040,"line":51},[1038,2019,2020],{},"    \"context\"\n",[1038,2022,2023],{"class":1040,"line":57},[1038,2024,2025],{},"    \"testing\"\n",[1038,2027,2028],{"class":1040,"line":102},[1038,2029,1049],{"emptyLinePlaceholder":1048},[1038,2031,2032],{"class":1040,"line":108},[1038,2033,2034],{},"    \"github.com\u002Fredelay\u002Fgo-events\u002Feventbus\"\n",[1038,2036,2037],{"class":1040,"line":114},[1038,2038,2039],{},"    \"github.com\u002Fredelay\u002Fgo-events\u002Ftransport\u002Fmemory\"\n",[1038,2041,2042],{"class":1040,"line":120},[1038,2043,1611],{},[1038,2045,2046],{"class":1040,"line":181},[1038,2047,2048],{},"    \"yourorg\u002Fyourapp\u002Fmodules\u002Forders\"\n",[1038,2050,2051],{"class":1040,"line":186},[1038,2052,1616],{},[1038,2054,2055],{"class":1040,"line":191},[1038,2056,1049],{"emptyLinePlaceholder":1048},[1038,2058,2059],{"class":1040,"line":197},[1038,2060,2061],{},"func TestOrderCreatedEventPublished(t *testing.T) {\n",[1038,2063,2064],{"class":1040,"line":203},[1038,2065,2066],{},"    tr := memory.New()\n",[1038,2068,2069],{"class":1040,"line":214},[1038,2070,2071],{},"    bus := eventbus.New(tr)\n",[1038,2073,2074],{"class":1040,"line":223},[1038,2075,1049],{"emptyLinePlaceholder":1048},[1038,2077,2078],{"class":1040,"line":229},[1038,2079,2080],{},"    var received *modules.EventMessage\n",[1038,2082,2083],{"class":1040,"line":234},[1038,2084,2085],{},"    bus.Register(&modules.ConsumerRegistration{\n",[1038,2087,2088],{"class":1040,"line":240},[1038,2089,2090],{},"        Topic:   \"order.created\",\n",[1038,2092,2093],{"class":1040,"line":246},[1038,2094,2095],{},"        GroupID: \"test\",\n",[1038,2097,2098],{"class":1040,"line":251},[1038,2099,2100],{},"        Handler: func(_ context.Context, msg *modules.EventMessage) error {\n",[1038,2102,2103],{"class":1040,"line":257},[1038,2104,2105],{},"            received = msg\n",[1038,2107,2108],{"class":1040,"line":1456},[1038,2109,2110],{},"            return nil\n",[1038,2112,2113],{"class":1040,"line":1462},[1038,2114,1707],{},[1038,2116,2117],{"class":1040,"line":271},[1038,2118,1419],{},[1038,2120,2121],{"class":1040,"line":277},[1038,2122,2123],{},"    if err := bus.Start(context.Background()); err != nil {\n",[1038,2125,2126],{"class":1040,"line":282},[1038,2127,2128],{},"        t.Fatal(err)\n",[1038,2130,2131],{"class":1040,"line":1483},[1038,2132,1434],{},[1038,2134,2135],{"class":1040,"line":1489},[1038,2136,1049],{"emptyLinePlaceholder":1048},[1038,2138,2139],{"class":1040,"line":1495},[1038,2140,2141],{},"    svc := orders.NewService(testCollection(t), bus, zaptest.NewLogger(t))\n",[1038,2143,2144],{"class":1040,"line":1501},[1038,2145,2146],{},"    _, err := svc.Create(context.Background(), &orders.CreateOrderInput{\n",[1038,2148,2149],{"class":1040,"line":1506},[1038,2150,2151],{},"        Total:    99.00,\n",[1038,2153,2154],{"class":1040,"line":1511},[1038,2155,2156],{},"        Currency: \"USD\",\n",[1038,2158,2159],{"class":1040,"line":1517},[1038,2160,2161],{},"        UserID:   \"user-1\",\n",[1038,2163,2164],{"class":1040,"line":1751},[1038,2165,1419],{},[1038,2167,2169],{"class":1040,"line":2168},36,[1038,2170,1424],{},[1038,2172,2174],{"class":1040,"line":2173},37,[1038,2175,2176],{},"        t.Fatalf(\"Create: %v\", err)\n",[1038,2178,2180],{"class":1040,"line":2179},38,[1038,2181,1434],{},[1038,2183,2185],{"class":1040,"line":2184},39,[1038,2186,1049],{"emptyLinePlaceholder":1048},[1038,2188,2190],{"class":1040,"line":2189},40,[1038,2191,2192],{},"    if received == nil {\n",[1038,2194,2196],{"class":1040,"line":2195},41,[1038,2197,2198],{},"        t.Fatal(\"expected order.created event to be published\")\n",[1038,2200,2202],{"class":1040,"line":2201},42,[1038,2203,1434],{},[1038,2205,2207],{"class":1040,"line":2206},43,[1038,2208,2209],{},"    if received.EntityType != \"order\" || received.Action != \"created\" {\n",[1038,2211,2213],{"class":1040,"line":2212},44,[1038,2214,2215],{},"        t.Errorf(\"unexpected event: %s.%s\", received.EntityType, received.Action)\n",[1038,2217,2219],{"class":1040,"line":2218},45,[1038,2220,1434],{},[1038,2222,2224],{"class":1040,"line":2223},46,[1038,2225,1093],{},[1232,2227,2229],{"id":2228},"testing-consumers","Testing consumers",[1029,2231,2233],{"className":1031,"code":2232,"language":1033,"meta":1034,"style":1034},"func TestHandlePaymentCompleted(t *testing.T) {\n    tr := memory.New()\n    bus := eventbus.New(tr)\n\n    mod := orders.NewModule(testDB(t), orders.DefaultConfig(), zaptest.NewLogger(t), bus)\n    \u002F\u002F Register module consumers\n    for _, reg := range mod.Consumers() {\n        bus.Register(reg)\n    }\n    if err := bus.Start(context.Background()); err != nil {\n        t.Fatal(err)\n    }\n    if err := mod.Startup(context.Background()); err != nil {\n        t.Fatal(err)\n    }\n\n    \u002F\u002F Publish a payment.completed event\n    _ = bus.Publish(context.Background(), &modules.EventMessage{\n        EntityType: \"payment\",\n        Action:     \"completed\",\n        Headers:    map[string]string{\"topic\": \"payment.completed\"},\n        Payload:    []byte(`{\"order_id\":\"order-123\",\"amount\":99.00}`),\n    })\n\n    order, _ := mod.Service.GetByID(context.Background(), \"order-123\")\n    if order.Status != \"paid\" {\n        t.Errorf(\"expected order to be marked as paid\")\n    }\n}\n",[1001,2234,2235,2240,2244,2248,2252,2257,2262,2267,2272,2276,2280,2284,2288,2293,2297,2301,2305,2310,2315,2320,2325,2330,2335,2339,2343,2348,2353,2358,2362],{"__ignoreMap":1034},[1038,2236,2237],{"class":1040,"line":10},[1038,2238,2239],{},"func TestHandlePaymentCompleted(t *testing.T) {\n",[1038,2241,2242],{"class":1040,"line":16},[1038,2243,2066],{},[1038,2245,2246],{"class":1040,"line":22},[1038,2247,2071],{},[1038,2249,2250],{"class":1040,"line":51},[1038,2251,1049],{"emptyLinePlaceholder":1048},[1038,2253,2254],{"class":1040,"line":57},[1038,2255,2256],{},"    mod := orders.NewModule(testDB(t), orders.DefaultConfig(), zaptest.NewLogger(t), bus)\n",[1038,2258,2259],{"class":1040,"line":102},[1038,2260,2261],{},"    \u002F\u002F Register module consumers\n",[1038,2263,2264],{"class":1040,"line":108},[1038,2265,2266],{},"    for _, reg := range mod.Consumers() {\n",[1038,2268,2269],{"class":1040,"line":114},[1038,2270,2271],{},"        bus.Register(reg)\n",[1038,2273,2274],{"class":1040,"line":120},[1038,2275,1434],{},[1038,2277,2278],{"class":1040,"line":181},[1038,2279,2123],{},[1038,2281,2282],{"class":1040,"line":186},[1038,2283,2128],{},[1038,2285,2286],{"class":1040,"line":191},[1038,2287,1434],{},[1038,2289,2290],{"class":1040,"line":197},[1038,2291,2292],{},"    if err := mod.Startup(context.Background()); err != nil {\n",[1038,2294,2295],{"class":1040,"line":203},[1038,2296,2128],{},[1038,2298,2299],{"class":1040,"line":214},[1038,2300,1434],{},[1038,2302,2303],{"class":1040,"line":223},[1038,2304,1049],{"emptyLinePlaceholder":1048},[1038,2306,2307],{"class":1040,"line":229},[1038,2308,2309],{},"    \u002F\u002F Publish a payment.completed event\n",[1038,2311,2312],{"class":1040,"line":234},[1038,2313,2314],{},"    _ = bus.Publish(context.Background(), &modules.EventMessage{\n",[1038,2316,2317],{"class":1040,"line":240},[1038,2318,2319],{},"        EntityType: \"payment\",\n",[1038,2321,2322],{"class":1040,"line":246},[1038,2323,2324],{},"        Action:     \"completed\",\n",[1038,2326,2327],{"class":1040,"line":251},[1038,2328,2329],{},"        Headers:    map[string]string{\"topic\": \"payment.completed\"},\n",[1038,2331,2332],{"class":1040,"line":257},[1038,2333,2334],{},"        Payload:    []byte(`{\"order_id\":\"order-123\",\"amount\":99.00}`),\n",[1038,2336,2337],{"class":1040,"line":1456},[1038,2338,1419],{},[1038,2340,2341],{"class":1040,"line":1462},[1038,2342,1049],{"emptyLinePlaceholder":1048},[1038,2344,2345],{"class":1040,"line":271},[1038,2346,2347],{},"    order, _ := mod.Service.GetByID(context.Background(), \"order-123\")\n",[1038,2349,2350],{"class":1040,"line":277},[1038,2351,2352],{},"    if order.Status != \"paid\" {\n",[1038,2354,2355],{"class":1040,"line":282},[1038,2356,2357],{},"        t.Errorf(\"expected order to be marked as paid\")\n",[1038,2359,2360],{"class":1040,"line":1483},[1038,2361,1434],{},[1038,2363,2364],{"class":1040,"line":1489},[1038,2365,1093],{},[983,2367,2369],{"id":2368},"summary","Summary",[1144,2371,2372,2382],{},[1147,2373,2374],{},[1150,2375,2376,2379],{},[1153,2377,2378],{},"Step",[1153,2380,2381],{},"What to do",[1160,2383,2384,2397,2408,2423,2438],{},[1150,2385,2386,2389],{},[1165,2387,2388],{},"1",[1165,2390,1019,2391,2393,2394,2396],{},[1001,2392,1022],{}," with ",[1001,2395,1142],{}," variables",[1150,2398,2399,2402],{},[1165,2400,2401],{},"2",[1165,2403,1339,2404,2407],{},[1001,2405,2406],{},"deps.EventBus"," from factory → service",[1150,2409,2410,2413],{},[1165,2411,2412],{},"3",[1165,2414,2415,2416,2419,2420],{},"Call ",[1001,2417,2418],{},"eventBus.Publish(ctx, msg)"," after successful writes; guard ",[1001,2421,2422],{},"!= nil",[1150,2424,2425,2428],{},[1165,2426,2427],{},"4",[1165,2429,1576,2430,2433,2434,2437],{},[1001,2431,2432],{},"Events()"," and ",[1001,2435,2436],{},"Consumers()"," on the module for IR + runtime wiring",[1150,2439,2440,2443],{},[1165,2441,2442],{},"5",[1165,2444,2445,2446,2448,2449,2452],{},"Test with ",[1001,2447,1992],{}," + ",[1001,2450,2451],{},"eventbus.New(tr)"," — no Kafka needed",[979,2454,1327,2455,2457,2458,2461],{},[995,2456,94],{"href":95}," for the full transport API, and\n",[995,2459,2460],{"href":150},"go-events reference"," for middleware and filter documentation.",[2463,2464,2465],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}",{"title":1034,"searchDepth":16,"depth":16,"links":2467},[2468,2469,2472,2475,2479,2480,2483],{"id":985,"depth":16,"text":986},{"id":1015,"depth":16,"text":1016,"children":2470},[2471],{"id":1234,"depth":22,"text":1235},{"id":1335,"depth":16,"text":1336,"children":2473},[2474],{"id":1529,"depth":22,"text":1530},{"id":1572,"depth":16,"text":1573,"children":2476},[2477,2478],{"id":1756,"depth":22,"text":1757},{"id":1775,"depth":22,"text":1776},{"id":1902,"depth":16,"text":1903},{"id":1985,"depth":16,"text":1986,"children":2481},[2482],{"id":2228,"depth":22,"text":2229},{"id":2368,"depth":16,"text":2369},"How to publish events, consume events, and test event-driven behaviour in a Redelay Go module.","md",null,{},{"order":22,"icon":36},{"title":86,"description":2484},"d7oZeUSFrT8SPgBtGt0OXfanjLHAPcq3Zf5zn7KygVM",[2492,2494],{"title":82,"path":83,"stem":84,"description":2493,"order":16,"icon":46,"children":-1},"Step-by-step guide to creating a new module for the redelay go-framework.",{"title":90,"path":91,"stem":92,"description":2495,"order":51,"icon":52,"children":-1},"Take a FlowDSL diagram, validate it, generate Go models, and run it with Redelay.",1790332226867]