@almadar/std 3.2.3 → 3.3.5

package/behaviors/exports/molecules/std-service-payment-flow.orb

@@ -0,0 +1,873 @@
+{
+  "name": "ServicePaymentFlowOrbital",
+  "orbitals": [
+    {
+      "name": "ServicePaymentFlowOrbital",
+      "entity": {
+        "name": "ServicePaymentFlow",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string"
+          },
+          {
+            "name": "name",
+            "type": "string"
+          },
+          {
+            "name": "description",
+            "type": "string"
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "active",
+            "values": [
+              "active",
+              "inactive",
+              "pending"
+            ]
+          },
+          {
+            "name": "createdAt",
+            "type": "string"
+          },
+          {
+            "name": "amount",
+            "type": "number"
+          },
+          {
+            "name": "currency",
+            "type": "string",
+            "default": "usd"
+          },
+          {
+            "name": "paymentIntentId",
+            "type": "string"
+          },
+          {
+            "name": "clientSecret",
+            "type": "string"
+          },
+          {
+            "name": "paymentStatus",
+            "type": "string",
+            "default": "idle"
+          },
+          {
+            "name": "to",
+            "type": "string"
+          },
+          {
+            "name": "subject",
+            "type": "string",
+            "default": "Payment Receipt"
+          },
+          {
+            "name": "body",
+            "type": "string"
+          },
+          {
+            "name": "sendStatus",
+            "type": "string",
+            "default": "idle"
+          },
+          {
+            "name": "error",
+            "type": "string"
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "ServicePaymentFlowPayment",
+          "linkedEntity": "ServicePaymentFlow",
+          "category": "interaction",
+          "emits": [
+            {
+              "event": "SEND_RECEIPT"
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              },
+              {
+                "name": "creating"
+              },
+              {
+                "name": "confirming"
+              },
+              {
+                "name": "succeeded"
+              },
+              {
+                "name": "error"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "CREATE_PAYMENT",
+                "name": "Create Payment"
+              },
+              {
+                "key": "PAYMENT_CREATED",
+                "name": "Payment Created",
+                "payload": [
+                  {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "clientSecret",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "PAYMENT_CONFIRMED",
+                "name": "Payment Confirmed"
+              },
+              {
+                "key": "FAILED",
+                "name": "Failed",
+                "payload": [
+                  {
+                    "name": "error",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "RETRY",
+                "name": "Retry"
+              },
+              {
+                "key": "RESET",
+                "name": "Reset"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "ServicePaymentFlow"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "credit-card",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Payment",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "vertical",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "input",
+                              "label": "Amount",
+                              "field": "amount",
+                              "inputType": "number",
+                              "placeholder": "0.00"
+                            },
+                            {
+                              "type": "select",
+                              "label": "Currency",
+                              "field": "currency",
+                              "options": [
+                                {
+                                  "label": "USD",
+                                  "value": "usd"
+                                },
+                                {
+                                  "label": "EUR",
+                                  "value": "eur"
+                                },
+                                {
+                                  "label": "GBP",
+                                  "value": "gbp"
+                                }
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Pay",
+                          "event": "CREATE_PAYMENT",
+                          "variant": "primary",
+                          "icon": "credit-card"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "creating",
+                "event": "CREATE_PAYMENT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "loading-state",
+                      "title": "Creating payment...",
+                      "message": "Setting up your payment intent."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "stripe",
+                    "createPaymentIntent",
+                    {
+                      "amount": "@entity.amount",
+                      "currency": "@entity.currency"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "creating",
+                "to": "confirming",
+                "event": "PAYMENT_CREATED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.paymentIntentId",
+                    "@payload.id"
+                  ],
+                  [
+                    "set",
+                    "@entity.clientSecret",
+                    "@payload.clientSecret"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "loading-state",
+                      "title": "Confirming payment...",
+                      "message": "Processing your payment."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "stripe",
+                    "confirmPayment",
+                    {
+                      "paymentIntentId": "@entity.paymentIntentId"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "confirming",
+                "to": "succeeded",
+                "event": "PAYMENT_CONFIRMED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.paymentStatus",
+                    "succeeded"
+                  ],
+                  [
+                    "emit",
+                    "SEND_RECEIPT"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "check-circle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "alert",
+                          "variant": "success",
+                          "message": "Payment successful! Sending receipt..."
+                        },
+                        {
+                          "type": "typography",
+                          "variant": "body",
+                          "color": "muted",
+                          "content": "@entity.paymentIntentId"
+                        },
+                        {
+                          "type": "button",
+                          "label": "New Payment",
+                          "event": "RESET",
+                          "variant": "ghost",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "creating",
+                "to": "error",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "error-state",
+                      "title": "Payment Failed",
+                      "message": "@entity.error",
+                      "onRetry": "RETRY"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "confirming",
+                "to": "error",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "error-state",
+                      "title": "Payment Failed",
+                      "message": "@entity.error",
+                      "onRetry": "RETRY"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "error",
+                "to": "idle",
+                "event": "RETRY",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "credit-card",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Payment",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "vertical",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "input",
+                              "label": "Amount",
+                              "field": "amount",
+                              "inputType": "number",
+                              "placeholder": "0.00"
+                            },
+                            {
+                              "type": "select",
+                              "label": "Currency",
+                              "field": "currency",
+                              "options": [
+                                {
+                                  "label": "USD",
+                                  "value": "usd"
+                                },
+                                {
+                                  "label": "EUR",
+                                  "value": "eur"
+                                },
+                                {
+                                  "label": "GBP",
+                                  "value": "gbp"
+                                }
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Pay",
+                          "event": "CREATE_PAYMENT",
+                          "variant": "primary",
+                          "icon": "credit-card"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "succeeded",
+                "to": "idle",
+                "event": "RESET",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "credit-card",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Payment",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "vertical",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "input",
+                              "label": "Amount",
+                              "field": "amount",
+                              "inputType": "number",
+                              "placeholder": "0.00"
+                            },
+                            {
+                              "type": "select",
+                              "label": "Currency",
+                              "field": "currency",
+                              "options": [
+                                {
+                                  "label": "USD",
+                                  "value": "usd"
+                                },
+                                {
+                                  "label": "EUR",
+                                  "value": "eur"
+                                },
+                                {
+                                  "label": "GBP",
+                                  "value": "gbp"
+                                }
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Pay",
+                          "event": "CREATE_PAYMENT",
+                          "variant": "primary",
+                          "icon": "credit-card"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "error",
+                "to": "idle",
+                "event": "RESET",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "credit-card",
+                              "size": "lg"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Payment",
+                              "variant": "h2"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "vertical",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "input",
+                              "label": "Amount",
+                              "field": "amount",
+                              "inputType": "number",
+                              "placeholder": "0.00"
+                            },
+                            {
+                              "type": "select",
+                              "label": "Currency",
+                              "field": "currency",
+                              "options": [
+                                {
+                                  "label": "USD",
+                                  "value": "usd"
+                                },
+                                {
+                                  "label": "EUR",
+                                  "value": "eur"
+                                },
+                                {
+                                  "label": "GBP",
+                                  "value": "gbp"
+                                }
+                              ]
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "label": "Pay",
+                          "event": "CREATE_PAYMENT",
+                          "variant": "primary",
+                          "icon": "credit-card"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "ServicePaymentFlowReceipt",
+          "linkedEntity": "ServicePaymentFlow",
+          "category": "interaction",
+          "listens": [
+            {
+              "event": "SEND_RECEIPT",
+              "triggers": "SEND_RECEIPT"
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "waiting",
+                "isInitial": true
+              },
+              {
+                "name": "sending"
+              },
+              {
+                "name": "sent",
+                "isTerminal": true
+              },
+              {
+                "name": "receiptError"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "SEND_RECEIPT",
+                "name": "Send Receipt"
+              },
+              {
+                "key": "SENT",
+                "name": "Receipt Sent"
+              },
+              {
+                "key": "FAILED",
+                "name": "Send Failed",
+                "payload": [
+                  {
+                    "name": "error",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "RETRY_RECEIPT",
+                "name": "Retry Receipt"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "waiting",
+                "to": "waiting",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "mail",
+                          "size": "md"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Receipt will be sent after payment.",
+                          "variant": "body",
+                          "color": "muted"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "waiting",
+                "to": "sending",
+                "event": "SEND_RECEIPT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "loading-state",
+                      "title": "Sending receipt...",
+                      "message": "Delivering your payment receipt."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "email",
+                    "send",
+                    {
+                      "to": "@entity.to",
+                      "subject": "@entity.subject",
+                      "body": "@entity.body"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "sending",
+                "to": "sent",
+                "event": "SENT",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.sendStatus",
+                    "sent"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "check-circle",
+                          "size": "md"
+                        },
+                        {
+                          "type": "alert",
+                          "variant": "success",
+                          "message": "Receipt sent successfully"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "sending",
+                "to": "receiptError",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.sendStatus",
+                    "error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "error-state",
+                          "title": "Receipt Failed",
+                          "message": "Could not send receipt email.",
+                          "onRetry": "RETRY_RECEIPT"
+                        },
+                        {
+                          "type": "button",
+                          "label": "Retry",
+                          "event": "RETRY_RECEIPT",
+                          "variant": "primary",
+                          "icon": "refresh-cw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "receiptError",
+                "to": "sending",
+                "event": "RETRY_RECEIPT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "loading-state",
+                      "title": "Sending receipt...",
+                      "message": "Delivering your payment receipt."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "email",
+                    "send",
+                    {
+                      "to": "@entity.to",
+                      "subject": "@entity.subject",
+                      "body": "@entity.body"
+                    }
+                  ]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "ServicePaymentFlowPage",
+          "path": "/servicepaymentflows",
+          "traits": [
+            {
+              "ref": "ServicePaymentFlowPayment"
+            },
+            {
+              "ref": "ServicePaymentFlowReceipt"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "description": "Payment flow molecule. Composes stripe payment and email receipt into a single orchestrated flow: pay, then auto-send receipt email. Two inline traits share one entity and one page: - Payment trait: idle -> creating -> confirming -> succeeded -> error   Emits SEND_RECEIPT when payment is confirmed. - Receipt trait: waiting -> sending -> sent -> receiptError   Listens for SEND_RECEIPT and calls the email service. Traits on the same page share the event bus automatically."
+}