@almadar/std 3.2.2 → 3.3.4

package/dist/behaviors/exports/molecules/std-service-custom-api-tester.orb

@@ -0,0 +1,860 @@
+{
+  "name": "ServiceCustomApiTesterOrbital",
+  "services": [
+    {
+      "name": "custom-header-api",
+      "type": "rest",
+      "baseUrl": "https://api.example.com/v1",
+      "auth": {
+        "type": "api-key",
+        "keyName": "X-API-Key",
+        "location": "header",
+        "secretEnv": "CUSTOM_API_SECRET"
+      }
+    },
+    {
+      "name": "custom-bearer-api",
+      "type": "rest",
+      "baseUrl": "https://api.example.com/v2",
+      "auth": {
+        "type": "bearer",
+        "secretEnv": "CUSTOM_BEARER_TOKEN"
+      }
+    },
+    {
+      "name": "custom-query-api",
+      "type": "rest",
+      "baseUrl": "https://api.example.com/v3",
+      "auth": {
+        "type": "api-key",
+        "keyName": "api_key",
+        "location": "query",
+        "secretEnv": "CUSTOM_QUERY_KEY"
+      }
+    },
+    {
+      "name": "custom-noauth-api",
+      "type": "rest",
+      "baseUrl": "https://api.example.com/v4"
+    }
+  ],
+  "orbitals": [
+    {
+      "name": "ServiceCustomApiTesterOrbital",
+      "entity": {
+        "name": "ServiceCustomApiTester",
+        "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": "endpoint",
+            "type": "string"
+          },
+          {
+            "name": "method",
+            "type": "string",
+            "default": "GET"
+          },
+          {
+            "name": "requestBody",
+            "type": "string"
+          },
+          {
+            "name": "responseData",
+            "type": "string"
+          },
+          {
+            "name": "statusCode",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "authType",
+            "type": "string",
+            "default": "header"
+          },
+          {
+            "name": "callStatus",
+            "type": "string",
+            "default": "idle"
+          },
+          {
+            "name": "error",
+            "type": "string"
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "ServiceCustomApiTesterApiTester",
+          "linkedEntity": "ServiceCustomApiTester",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              },
+              {
+                "name": "calling"
+              },
+              {
+                "name": "complete"
+              },
+              {
+                "name": "error"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "CALL_HEADER_API",
+                "name": "Call Header API"
+              },
+              {
+                "key": "CALL_BEARER_API",
+                "name": "Call Bearer API"
+              },
+              {
+                "key": "CALL_QUERY_API",
+                "name": "Call Query API"
+              },
+              {
+                "key": "CALL_NOAUTH_API",
+                "name": "Call No-Auth API"
+              },
+              {
+                "key": "API_RESPONSE",
+                "name": "API Response",
+                "payload": [
+                  {
+                    "name": "data",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "statusCode",
+                    "type": "number",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "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",
+                    "ServiceCustomApiTester"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "globe",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Unified API Tester",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "input",
+                          "field": "endpoint",
+                          "placeholder": "/users",
+                          "bind": "@entity.endpoint"
+                        },
+                        {
+                          "type": "select",
+                          "field": "method",
+                          "bind": "@entity.method",
+                          "options": [
+                            {
+                              "label": "GET",
+                              "value": "GET"
+                            },
+                            {
+                              "label": "POST",
+                              "value": "POST"
+                            },
+                            {
+                              "label": "PUT",
+                              "value": "PUT"
+                            },
+                            {
+                              "label": "DELETE",
+                              "value": "DELETE"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "textarea",
+                          "field": "requestBody",
+                          "placeholder": "Request body (JSON)",
+                          "bind": "@entity.requestBody"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Select Auth Type",
+                          "variant": "h4"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "justify": "center",
+                          "children": [
+                            {
+                              "type": "button",
+                              "label": "Header API Key",
+                              "event": "CALL_HEADER_API",
+                              "variant": "primary",
+                              "icon": "key"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Bearer Token",
+                              "event": "CALL_BEARER_API",
+                              "variant": "primary",
+                              "icon": "shield"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Query Param",
+                              "event": "CALL_QUERY_API",
+                              "variant": "primary",
+                              "icon": "search"
+                            },
+                            {
+                              "type": "button",
+                              "label": "No Auth",
+                              "event": "CALL_NOAUTH_API",
+                              "variant": "primary",
+                              "icon": "unlock"
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "calling",
+                "event": "CALL_HEADER_API",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.authType",
+                    "header"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "loading-state",
+                      "title": "Calling API...",
+                      "message": "Sending request to servicecustomapitester endpoint..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "custom-header-api",
+                    "execute",
+                    {
+                      "endpoint": "@entity.endpoint",
+                      "method": "@entity.method",
+                      "body": "@entity.requestBody"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "calling",
+                "event": "CALL_BEARER_API",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.authType",
+                    "bearer"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "loading-state",
+                      "title": "Calling API...",
+                      "message": "Sending request to servicecustomapitester endpoint..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "custom-bearer-api",
+                    "execute",
+                    {
+                      "endpoint": "@entity.endpoint",
+                      "method": "@entity.method",
+                      "body": "@entity.requestBody"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "calling",
+                "event": "CALL_QUERY_API",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.authType",
+                    "query"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "loading-state",
+                      "title": "Calling API...",
+                      "message": "Sending request to servicecustomapitester endpoint..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "custom-query-api",
+                    "execute",
+                    {
+                      "endpoint": "@entity.endpoint",
+                      "method": "@entity.method",
+                      "body": "@entity.requestBody"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "calling",
+                "event": "CALL_NOAUTH_API",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.authType",
+                    "noauth"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "loading-state",
+                      "title": "Calling API...",
+                      "message": "Sending request to servicecustomapitester endpoint..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "custom-noauth-api",
+                    "execute",
+                    {
+                      "endpoint": "@entity.endpoint",
+                      "method": "@entity.method",
+                      "body": "@entity.requestBody"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "calling",
+                "to": "complete",
+                "event": "API_RESPONSE",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.responseData",
+                    "@payload.data"
+                  ],
+                  [
+                    "set",
+                    "@entity.statusCode",
+                    "@payload.statusCode"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "check-circle",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Response",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "justify": "center",
+                          "children": [
+                            {
+                              "type": "badge",
+                              "content": "@entity.authType",
+                              "variant": "info"
+                            },
+                            {
+                              "type": "badge",
+                              "content": "@entity.statusCode",
+                              "variant": "info"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "code",
+                          "content": "@entity.responseData",
+                          "language": "json"
+                        },
+                        {
+                          "type": "button",
+                          "label": "New Request",
+                          "event": "RESET",
+                          "variant": "ghost",
+                          "icon": "rotate-ccw"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "calling",
+                "to": "error",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "error-state",
+                      "title": "Request 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": "icon",
+                          "name": "globe",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Unified API Tester",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "input",
+                          "field": "endpoint",
+                          "placeholder": "/users",
+                          "bind": "@entity.endpoint"
+                        },
+                        {
+                          "type": "select",
+                          "field": "method",
+                          "bind": "@entity.method",
+                          "options": [
+                            {
+                              "label": "GET",
+                              "value": "GET"
+                            },
+                            {
+                              "label": "POST",
+                              "value": "POST"
+                            },
+                            {
+                              "label": "PUT",
+                              "value": "PUT"
+                            },
+                            {
+                              "label": "DELETE",
+                              "value": "DELETE"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "textarea",
+                          "field": "requestBody",
+                          "placeholder": "Request body (JSON)",
+                          "bind": "@entity.requestBody"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Select Auth Type",
+                          "variant": "h4"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "justify": "center",
+                          "children": [
+                            {
+                              "type": "button",
+                              "label": "Header API Key",
+                              "event": "CALL_HEADER_API",
+                              "variant": "primary",
+                              "icon": "key"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Bearer Token",
+                              "event": "CALL_BEARER_API",
+                              "variant": "primary",
+                              "icon": "shield"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Query Param",
+                              "event": "CALL_QUERY_API",
+                              "variant": "primary",
+                              "icon": "search"
+                            },
+                            {
+                              "type": "button",
+                              "label": "No Auth",
+                              "event": "CALL_NOAUTH_API",
+                              "variant": "primary",
+                              "icon": "unlock"
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "complete",
+                "to": "idle",
+                "event": "RESET",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "globe",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Unified API Tester",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "input",
+                          "field": "endpoint",
+                          "placeholder": "/users",
+                          "bind": "@entity.endpoint"
+                        },
+                        {
+                          "type": "select",
+                          "field": "method",
+                          "bind": "@entity.method",
+                          "options": [
+                            {
+                              "label": "GET",
+                              "value": "GET"
+                            },
+                            {
+                              "label": "POST",
+                              "value": "POST"
+                            },
+                            {
+                              "label": "PUT",
+                              "value": "PUT"
+                            },
+                            {
+                              "label": "DELETE",
+                              "value": "DELETE"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "textarea",
+                          "field": "requestBody",
+                          "placeholder": "Request body (JSON)",
+                          "bind": "@entity.requestBody"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Select Auth Type",
+                          "variant": "h4"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "justify": "center",
+                          "children": [
+                            {
+                              "type": "button",
+                              "label": "Header API Key",
+                              "event": "CALL_HEADER_API",
+                              "variant": "primary",
+                              "icon": "key"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Bearer Token",
+                              "event": "CALL_BEARER_API",
+                              "variant": "primary",
+                              "icon": "shield"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Query Param",
+                              "event": "CALL_QUERY_API",
+                              "variant": "primary",
+                              "icon": "search"
+                            },
+                            {
+                              "type": "button",
+                              "label": "No Auth",
+                              "event": "CALL_NOAUTH_API",
+                              "variant": "primary",
+                              "icon": "unlock"
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "error",
+                "to": "idle",
+                "event": "RESET",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "globe",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Unified API Tester",
+                          "variant": "h2"
+                        },
+                        {
+                          "type": "input",
+                          "field": "endpoint",
+                          "placeholder": "/users",
+                          "bind": "@entity.endpoint"
+                        },
+                        {
+                          "type": "select",
+                          "field": "method",
+                          "bind": "@entity.method",
+                          "options": [
+                            {
+                              "label": "GET",
+                              "value": "GET"
+                            },
+                            {
+                              "label": "POST",
+                              "value": "POST"
+                            },
+                            {
+                              "label": "PUT",
+                              "value": "PUT"
+                            },
+                            {
+                              "label": "DELETE",
+                              "value": "DELETE"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "textarea",
+                          "field": "requestBody",
+                          "placeholder": "Request body (JSON)",
+                          "bind": "@entity.requestBody"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Select Auth Type",
+                          "variant": "h4"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "justify": "center",
+                          "children": [
+                            {
+                              "type": "button",
+                              "label": "Header API Key",
+                              "event": "CALL_HEADER_API",
+                              "variant": "primary",
+                              "icon": "key"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Bearer Token",
+                              "event": "CALL_BEARER_API",
+                              "variant": "primary",
+                              "icon": "shield"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Query Param",
+                              "event": "CALL_QUERY_API",
+                              "variant": "primary",
+                              "icon": "search"
+                            },
+                            {
+                              "type": "button",
+                              "label": "No Auth",
+                              "event": "CALL_NOAUTH_API",
+                              "variant": "primary",
+                              "icon": "unlock"
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "ServiceCustomApiTesterPage",
+          "path": "/servicecustomapitesters",
+          "traits": [
+            {
+              "ref": "ServiceCustomApiTesterApiTester"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "description": "Unified API tester molecule that exercises all 4 custom REST auth patterns (header API key, bearer token, query param API key, no auth) with a tab selector. Single entity, single trait, 4 call events. Pure function: params in, OrbitalDefinition out."
+}