@almadar/std 15.15.0 → 15.15.1

package/behaviors/registry/core/atoms/std-data-erasure.orb

@@ -0,0 +1,546 @@
+{
+  "name": "std-data-erasure",
+  "version": "1.0.0",
+  "description": "std-data-erasure — GDPR Art. 17 right-to-be-forgotten queue. Tracks ErasureRequest rows through pending → grace → executed lifecycle with Cancel during grace. v1.0 ships the request lifecycle UI + knob set; auto-emit of ExecuteErasure after grace lands in v1.1 (loop-with-emit gap — docs/Almadar_Std_Factories.md). Target app/ atoms then own the actual delete or piiFields scrub via an ExecuteErasure listener.",
+  "orbitals": [
+    {
+      "name": "DataErasureOrbital",
+      "entity": {
+        "name": "ErasureRequest",
+        "collection": "erasure_requests",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "subjectId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "targetEntity",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "pending",
+            "values": [
+              "pending",
+              "grace",
+              "executed",
+              "cancelled"
+            ]
+          },
+          {
+            "name": "requestedAt",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "executesAt",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "executedAt",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "cancelledAt",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "notes",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "ErasureWorkflow",
+          "category": "interaction",
+          "linkedEntity": "ErasureRequest",
+          "emits": [
+            {
+              "event": "CANCEL_ERASURE",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "row.id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "row.subjectId",
+                  "type": "string"
+                },
+                {
+                  "name": "row.targetEntity",
+                  "type": "string"
+                },
+                {
+                  "name": "row.status",
+                  "type": "string"
+                },
+                {
+                  "name": "row.requestedAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.executesAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.executedAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.cancelledAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.notes",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "ErasureLoaded",
+              "payloadSchema": [
+                {
+                  "name": "data",
+                  "type": "[ErasureRequest]"
+                }
+              ]
+            },
+            {
+              "event": "ErasureLoadFailed",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "ErasureSaved",
+              "payloadSchema": [
+                {
+                  "name": "row.id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "row.subjectId",
+                  "type": "string"
+                },
+                {
+                  "name": "row.targetEntity",
+                  "type": "string"
+                },
+                {
+                  "name": "row.status",
+                  "type": "string"
+                },
+                {
+                  "name": "row.requestedAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.executesAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.executedAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.cancelledAt",
+                  "type": "number"
+                },
+                {
+                  "name": "row.notes",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "ErasureSaveFailed",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "loading",
+                "isInitial": true
+              },
+              {
+                "name": "browsing"
+              },
+              {
+                "name": "error"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "ErasureLoaded",
+                "name": "Erasure loaded",
+                "payloadSchema": [
+                  {
+                    "name": "data",
+                    "type": "[ErasureRequest]"
+                  }
+                ]
+              },
+              {
+                "key": "ErasureLoadFailed",
+                "name": "Erasure load failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
+                  },
+                  {
+                    "name": "code",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "key": "CANCEL_ERASURE",
+                "name": "Cancel Erasure",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "row",
+                    "type": "ErasureRequest"
+                  }
+                ]
+              },
+              {
+                "key": "ErasureSaved",
+                "name": "Erasure saved",
+                "payloadSchema": [
+                  {
+                    "name": "row",
+                    "type": "ErasureRequest"
+                  }
+                ]
+              },
+              {
+                "key": "ErasureSaveFailed",
+                "name": "Erasure save failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
+                  },
+                  {
+                    "name": "code",
+                    "type": "string"
+                  }
+                ]
+              }
+            ],
+            "transitions": [
+              {
+                "from": "loading",
+                "to": "loading",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "ErasureRequest",
+                    {
+                      "emit": {
+                        "success": "ErasureLoaded",
+                        "failure": "ErasureLoadFailed"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "color": "muted",
+                          "variant": "caption",
+                          "content": "Loading erasure requests…",
+                          "type": "typography"
+                        }
+                      ],
+                      "type": "stack",
+                      "gap": "md",
+                      "align": "center",
+                      "className": "py-12",
+                      "direction": "vertical"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "loading",
+                "to": "browsing",
+                "event": "ErasureLoaded",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "gap": "md",
+                      "direction": "vertical",
+                      "children": [
+                        {
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "trash-2"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "h3",
+                              "content": "Erasure requests"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "gap": "sm"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "entity": "@payload.data",
+                          "fields": [
+                            {
+                              "label": "Subject",
+                              "variant": "caption",
+                              "name": "subjectId"
+                            },
+                            {
+                              "label": "Status",
+                              "name": "status",
+                              "variant": "badge"
+                            },
+                            {
+                              "name": "executesAt",
+                              "label": "Executes",
+                              "variant": "caption"
+                            }
+                          ],
+                          "cols": 1.0,
+                          "type": "data-grid",
+                          "itemActions": [
+                            {
+                              "variant": "secondary",
+                              "label": "Cancel",
+                              "event": "CANCEL_ERASURE",
+                              "icon": "x"
+                            }
+                          ],
+                          "gap": "sm"
+                        }
+                      ],
+                      "type": "stack"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "loading",
+                "to": "error",
+                "event": "ErasureLoadFailed",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "variant": "error",
+                      "message": "@payload.error",
+                      "type": "alert"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "browsing",
+                "to": "loading",
+                "event": "CANCEL_ERASURE",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.id",
+                    "@payload.id"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "cancelled"
+                  ],
+                  [
+                    "persist",
+                    "update",
+                    "ErasureRequest",
+                    "@entity",
+                    {
+                      "emit": {
+                        "failure": "ErasureSaveFailed",
+                        "success": "ErasureSaved"
+                      }
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "browsing",
+                "to": "loading",
+                "event": "ErasureSaved",
+                "effects": [
+                  [
+                    "fetch",
+                    "ErasureRequest",
+                    {
+                      "emit": {
+                        "success": "ErasureLoaded",
+                        "failure": "ErasureLoadFailed"
+                      }
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "browsing",
+                "to": "browsing",
+                "event": "ErasureSaveFailed",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "message": "@payload.error",
+                      "type": "alert",
+                      "variant": "error"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "error",
+                "to": "loading",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "ErasureRequest",
+                    {
+                      "emit": {
+                        "failure": "ErasureLoadFailed",
+                        "success": "ErasureLoaded"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "spinner",
+                      "size": "sm"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "config": {
+            "piiFields": {
+              "type": "[string]",
+              "default": [],
+              "label": "PII fields to scrub",
+              "description": "Fields the target atom should null when anonymizeVsDelete='anonymize'.",
+              "tier": "customization",
+              "items": {
+                "type": "string"
+              }
+            },
+            "gracePeriodDays": {
+              "type": "number",
+              "default": 30.0,
+              "label": "Grace period (days)",
+              "description": "Days between request and execution. Customer can CANCEL during this window. Default 30 days matches typical GDPR practice.",
+              "tier": "customization"
+            },
+            "anonymizeVsDelete": {
+              "type": "string",
+              "default": "anonymize",
+              "label": "Mode",
+              "description": "anonymize = scrub piiFields and retain row for audit. delete = remove the row entirely.",
+              "tier": "customization",
+              "values": [
+                "anonymize",
+                "delete"
+              ]
+            },
+            "targetEntity": {
+              "type": "string",
+              "default": "",
+              "label": "Target entity",
+              "description": "Entity name whose records erasure requests apply to (e.g. 'CustomerAccount').",
+              "tier": "essential"
+            }
+          },
+          "scope": "collection"
+        }
+      ],
+      "pages": [
+        {
+          "name": "ErasureWorkflowPage",
+          "path": "/erasure/queue",
+          "traits": [
+            {
+              "ref": "ErasureWorkflow"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}