npm - @opensoha/contracts - Versions diffs - 0.1.24 → 0.1.26 - Mend

@opensoha/contracts 0.1.24 → 0.1.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (137) hide show

package/fixtures/openapi/KubernetesPod/invalid/pod-uid.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "name": "api-0",
+  "namespace": "test",
+  "phase": "Running",
+  "restarts": 0,
+  "uid": "",
+  "readyContainers": "1/1",
+  "ageSeconds": 60
+}

package/fixtures/openapi/KubernetesPod/valid/pod-uid.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "name": "api-0",
+  "namespace": "test",
+  "phase": "Running",
+  "restarts": 0,
+  "uid": "uid-original",
+  "readyContainers": "1/1",
+  "ageSeconds": 60
+}

package/fixtures/openapi/KubernetesPodDetail/invalid/pod-uid.json ADDED Viewed

@@ -0,0 +1,6 @@
+{
+  "name": "api-0",
+  "namespace": "test",
+  "phase": "Running",
+  "uid": ""
+}

package/fixtures/openapi/KubernetesPodDetail/valid/pod-uid.json ADDED Viewed

@@ -0,0 +1,6 @@
+{
+  "name": "api-0",
+  "namespace": "test",
+  "phase": "Running",
+  "uid": "uid-original"
+}

package/fixtures/openapi/KubernetesServiceImportRequest/invalid/empty-source-uid.json ADDED Viewed

@@ -0,0 +1,48 @@
+{
+  "clusterId": "cluster-prod",
+  "namespace": "payments",
+  "applicationKey": "payments",
+  "applicationName": "Payments",
+  "environmentKey": "prod",
+  "environmentName": "Production",
+  "ownershipMode": "observe_only",
+  "workloads": [
+    {
+      "workloadKind": "Deployment",
+      "workloadName": "deployment",
+      "expectedUid": "",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "StatefulSet",
+      "workloadName": "statefulset",
+      "expectedUid": "uid-StatefulSet",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "DaemonSet",
+      "workloadName": "daemonset",
+      "expectedUid": "uid-DaemonSet",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "Job",
+      "workloadName": "job",
+      "expectedUid": "uid-Job",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "CronJob",
+      "workloadName": "cronjob",
+      "expectedUid": "uid-CronJob",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "CustomResource",
+      "workloadName": "customresource",
+      "expectedUid": "uid-CustomResource",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "crdName": "elasticsearches.elasticsearch.k8s.elastic.co"
+    }
+  ]
+}

package/fixtures/openapi/KubernetesServiceImportRequest/valid/pinned-workloads-and-cr.json ADDED Viewed

@@ -0,0 +1,48 @@
+{
+  "clusterId": "cluster-prod",
+  "namespace": "payments",
+  "applicationKey": "payments",
+  "applicationName": "Payments",
+  "environmentKey": "prod",
+  "environmentName": "Production",
+  "ownershipMode": "observe_only",
+  "workloads": [
+    {
+      "workloadKind": "Deployment",
+      "workloadName": "deployment",
+      "expectedUid": "uid-Deployment",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "StatefulSet",
+      "workloadName": "statefulset",
+      "expectedUid": "uid-StatefulSet",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "DaemonSet",
+      "workloadName": "daemonset",
+      "expectedUid": "uid-DaemonSet",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "Job",
+      "workloadName": "job",
+      "expectedUid": "uid-Job",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "CronJob",
+      "workloadName": "cronjob",
+      "expectedUid": "uid-CronJob",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    {
+      "workloadKind": "CustomResource",
+      "workloadName": "customresource",
+      "expectedUid": "uid-CustomResource",
+      "expectedSpecDigest": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "crdName": "elasticsearches.elasticsearch.k8s.elastic.co"
+    }
+  ]
+}

package/fixtures/openapi/KubernetesTopologyCoverage/invalid/empty-as-success.json ADDED Viewed

@@ -0,0 +1,5 @@
+{
+  "provider": "apisix",
+  "sourceId": "apisix.apisixroutes",
+  "state": "empty"
+}

package/fixtures/openapi/KubernetesTopologyCoverage/valid/not-installed.json ADDED Viewed

@@ -0,0 +1,6 @@
+{
+  "provider": "apisix",
+  "sourceId": "apisix.apisixroutes",
+  "state": "not_installed",
+  "reasonCode": "api_not_served"
+}

package/fixtures/openapi/KubernetesTopologyGraphEdge/invalid/negative-weight.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+  "id": "edge-1",
+  "source": "a",
+  "target": "b",
+  "relation": "weights",
+  "resolutionState": "resolved",
+  "weight": -1
+}

package/fixtures/openapi/KubernetesTopologyGraphEdge/valid/zero-weight.json ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "id": "edge-1",
+  "source": "rule:route-uid:0",
+  "target": "service-1",
+  "relation": "weights",
+  "resolutionState": "resolved",
+  "port": "http",
+  "weight": 0,
+  "totalWeight": 100,
+  "sourceRef": {
+    "clusterId": "cluster-a",
+    "apiVersion": "traefik.io/v1alpha1",
+    "kind": "IngressRoute",
+    "name": "api",
+    "namespace": "team-a",
+    "scopeMode": "namespace",
+    "uid": "route-uid",
+    "resourceVersion": "7"
+  }
+}

package/fixtures/openapi/KubernetesTopologyGraphNode/invalid/fake-flow-kind.json ADDED Viewed

@@ -0,0 +1,42 @@
+{
+  "id": "rule:route-uid:0",
+  "type": "live-traffic",
+  "label": "api /",
+  "provider": "traefik",
+  "protocol": "HTTP",
+  "resolutionState": "resolved",
+  "resource": {
+    "clusterId": "cluster-a",
+    "apiVersion": "traefik.io/v1alpha1",
+    "kind": "IngressRoute",
+    "name": "api",
+    "namespace": "team-a",
+    "scopeMode": "namespace",
+    "uid": "route-uid",
+    "resourceVersion": "7"
+  },
+  "rule": {
+    "index": 0,
+    "matchGroups": [
+      [
+        {
+          "type": "host",
+          "operator": "exact",
+          "value": "api.example.test"
+        },
+        {
+          "type": "path",
+          "operator": "prefix",
+          "value": "/"
+        }
+      ]
+    ],
+    "tlsMode": "terminate"
+  },
+  "properties": [
+    {
+      "name": "source",
+      "value": "configuration"
+    }
+  ]
+}

package/fixtures/openapi/KubernetesTopologyGraphNode/valid/rule.json ADDED Viewed

@@ -0,0 +1,42 @@
+{
+  "id": "rule:route-uid:0",
+  "type": "rule",
+  "label": "api /",
+  "provider": "traefik",
+  "protocol": "HTTP",
+  "resolutionState": "resolved",
+  "resource": {
+    "clusterId": "cluster-a",
+    "apiVersion": "traefik.io/v1alpha1",
+    "kind": "IngressRoute",
+    "name": "api",
+    "namespace": "team-a",
+    "scopeMode": "namespace",
+    "uid": "route-uid",
+    "resourceVersion": "7"
+  },
+  "rule": {
+    "index": 0,
+    "matchGroups": [
+      [
+        {
+          "type": "host",
+          "operator": "exact",
+          "value": "api.example.test"
+        },
+        {
+          "type": "path",
+          "operator": "prefix",
+          "value": "/"
+        }
+      ]
+    ],
+    "tlsMode": "terminate"
+  },
+  "properties": [
+    {
+      "name": "source",
+      "value": "configuration"
+    }
+  ]
+}

package/fixtures/openapi/KubernetesTopologySnapshot/invalid/raw-source-field.json ADDED Viewed

@@ -0,0 +1,33 @@
+{
+  "version": "v1",
+  "sources": [
+    {
+      "coverage": {
+        "provider": "traefik",
+        "sourceId": "traefik.ingressroutes",
+        "state": "available",
+        "namespace": "team-a",
+        "supportedKinds": [
+          "IngressRoute"
+        ],
+        "observedAt": "2026-10-19T02:00:00Z"
+      },
+      "objects": [
+        {
+          "resource": {
+            "clusterId": "cluster-a",
+            "apiVersion": "traefik.io/v1alpha1",
+            "kind": "IngressRoute",
+            "name": "api",
+            "namespace": "team-a",
+            "scopeMode": "namespace",
+            "uid": "route-uid",
+            "resourceVersion": "7"
+          },
+          "content": "{}",
+          "originalManifest": "secret configuration must not cross the snapshot contract"
+        }
+      ]
+    }
+  ]
+}

package/fixtures/openapi/KubernetesTopologySnapshot/valid/projected-source.json ADDED Viewed

@@ -0,0 +1,32 @@
+{
+  "version": "v1",
+  "sources": [
+    {
+      "coverage": {
+        "provider": "traefik",
+        "sourceId": "traefik.ingressroutes",
+        "state": "available",
+        "namespace": "team-a",
+        "supportedKinds": [
+          "IngressRoute"
+        ],
+        "observedAt": "2026-10-19T02:00:00Z"
+      },
+      "objects": [
+        {
+          "resource": {
+            "clusterId": "cluster-a",
+            "apiVersion": "traefik.io/v1alpha1",
+            "kind": "IngressRoute",
+            "name": "api",
+            "namespace": "team-a",
+            "scopeMode": "namespace",
+            "uid": "route-uid",
+            "resourceVersion": "7"
+          },
+          "content": "{\"spec\": {\"routes\": [{\"match\": \"Host(`api.example.test`)\", \"services\": [{\"name\": \"api\", \"port\": 80}]}]}}"
+        }
+      ]
+    }
+  ]
+}

package/fixtures/openapi/KubernetesTopologySnapshotRequest/invalid/arbitrary-gvr.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+  "queries": [
+    {
+      "sourceId": "kubernetes.secrets",
+      "resource": "secrets"
+    }
+  ]
+}

package/fixtures/openapi/KubernetesTopologySnapshotRequest/valid/bounded-sources.json ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "queries": [
+    {
+      "sourceId": "traefik.ingressroutes",
+      "namespace": "team-a"
+    },
+    {
+      "sourceId": "kubernetes.ingressclasses"
+    }
+  ]
+}

package/fixtures/openapi/KubernetesTopologySourceQuery/invalid/cluster-namespace.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "sourceId": "kubernetes.ingressclasses",
+  "namespace": "team-a"
+}

package/fixtures/openapi/KubernetesTopologySourceQuery/valid/all-namespaces.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "sourceId": "traefik.ingressroutes",
+  "namespace": ""
+}

package/fixtures/openapi/ManifestExecutionTaskPayload/invalid/initialization.json ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "action": "preflight",
+  "packageId": "pkg",
+  "generation": 1,
+  "idempotencyKey": "initialization:plan:target",
+  "initializationPlanId": ""
+}

package/fixtures/openapi/ManifestExecutionTaskPayload/valid/initialization.json ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "action": "preflight",
+  "packageId": "pkg",
+  "generation": 1,
+  "idempotencyKey": "initialization:plan:target",
+  "initializationPlanId": "plan"
+}

package/fixtures/openapi/ManifestRootResource/invalid/root.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"apiVersion":"unknown.example/v1","kind":"Database","namespace":"team","name":"db","uid":"","generation":0,"crdName":"databases.unknown.example"}

package/fixtures/openapi/ManifestRootResource/valid/root.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"apiVersion": "unknown.example/v1", "kind": "Database", "namespace": "team", "name": "db", "uid": "uid-1", "generation": 2, "crdName": "databases.unknown.example", "targetId": "target", "deliveryPlanId": "plan"}

package/fixtures/openapi/ResourceMonitoringPanel/invalid/unknown-quality.json ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "key": "conntrack.entries",
+  "label": "Conntrack",
+  "unit": "count",
+  "quality": "unknown",
+  "series": []
+}

package/fixtures/openapi/ResourceMonitoringPanel/valid/not-collected.json ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "key": "conntrack.entries",
+  "label": "Conntrack",
+  "unit": "count",
+  "quality": "not_collected",
+  "series": []
+}

package/fixtures/openapi/ResourceMonitoringPoint/invalid/string-zero.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "timestamp": "2026-10-19T00:00:00Z",
+  "value": "0"
+}

package/fixtures/openapi/ResourceMonitoringPoint/valid/missing.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "timestamp": "2026-10-19T00:00:00Z",
+  "value": null
+}

package/fixtures/openapi/ResourceMonitoringPoint/valid/zero.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "timestamp": "2026-10-19T00:00:00Z",
+  "value": 0
+}

package/fixtures/openapi/ResourceMonitoringView/invalid/raw-query.json ADDED Viewed

@@ -0,0 +1,12 @@
+{
+  "clusterId": "c",
+  "view": "raw",
+  "from": "2026-10-18T23:00:00Z",
+  "to": "2026-10-19T00:00:00Z",
+  "stepSeconds": 60,
+  "generatedAt": "2026-10-19T00:00:00Z",
+  "snapshotQuality": "partial",
+  "unscheduledPendingPods": null,
+  "nodes": [],
+  "panels": []
+}

package/fixtures/openapi/ResourceMonitoringView/valid/unconfigured.json ADDED Viewed

@@ -0,0 +1,12 @@
+{
+  "clusterId": "c",
+  "view": "overview",
+  "from": "2026-10-18T23:00:00Z",
+  "to": "2026-10-19T00:00:00Z",
+  "stepSeconds": 60,
+  "generatedAt": "2026-10-19T00:00:00Z",
+  "snapshotQuality": "partial",
+  "unscheduledPendingPods": null,
+  "nodes": [],
+  "panels": []
+}

package/fixtures/openapi/ResourceRelationConfig/invalid/executable-rule.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+  "version": "v1",
+  "rootUid": "root",
+  "sources": [],
+  "rules": [
+    {
+      "id": "bad",
+      "type": "script",
+      "target": {
+        "apiVersion": "v1",
+        "resource": "pods",
+        "kind": "Pod",
+        "namespace": "team"
+      }
+    }
+  ]
+}

package/fixtures/openapi/ResourceRelationConfig/valid/unknown-kind.json ADDED Viewed

@@ -0,0 +1,13 @@
+{
+  "version": "v1",
+  "rootUid": "root",
+  "sources": [
+    {
+      "apiVersion": "widgets.test/v1",
+      "resource": "widgets",
+      "kind": "Widget",
+      "namespace": "team"
+    }
+  ],
+  "rules": []
+}

package/fixtures/openapi/ServiceDeploymentTemplateInput/invalid/migration-missing-guide-valid-yaml.json ADDED Viewed

@@ -0,0 +1,38 @@
+{
+  "key": "http",
+  "name": "HTTP service",
+  "source": {
+    "renderer": "raw_yaml",
+    "files": [
+      {
+        "path": "deployment.yaml",
+        "content": "kind: Deployment\napiVersion: apps/v1\n"
+      }
+    ]
+  },
+  "parameterSchema": {
+    "type": "object",
+    "properties": {
+      "port": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 65535
+      }
+    },
+    "required": [
+      "port"
+    ]
+  },
+  "defaults": {
+    "port": 8080
+  },
+  "health": {
+    "mode": "workload_ready",
+    "timeoutSeconds": 300
+  },
+  "enabled": true,
+  "migrationPolicy": {
+    "sequential": true,
+    "irreversible": false
+  }
+}

package/fixtures/openapi/ServiceDeploymentTemplateInput/valid/migration-valid-yaml.json ADDED Viewed

@@ -0,0 +1,39 @@
+{
+  "key": "http",
+  "name": "HTTP service",
+  "source": {
+    "renderer": "raw_yaml",
+    "files": [
+      {
+        "path": "deployment.yaml",
+        "content": "kind: Deployment\napiVersion: apps/v1\n"
+      }
+    ]
+  },
+  "parameterSchema": {
+    "type": "object",
+    "properties": {
+      "port": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 65535
+      }
+    },
+    "required": [
+      "port"
+    ]
+  },
+  "defaults": {
+    "port": 8080
+  },
+  "health": {
+    "mode": "workload_ready",
+    "timeoutSeconds": 300
+  },
+  "enabled": true,
+  "migrationPolicy": {
+    "sequential": true,
+    "irreversible": true,
+    "guide": "Backup, migrate in order, verify; forward repair only."
+  }
+}

package/fixtures/openapi/TemplateMigrationAssessment/invalid/initialization.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "fromVersion": 0,
+  "toVersion": 3,
+  "blocked": false,
+  "requiresApproval": true,
+  "reason": "首次发布须先证明不存在并审批",
+  "steps": [],
+  "initialization": "force"
+}

package/fixtures/openapi/TemplateMigrationAssessment/valid/initialization.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "fromVersion": 0,
+  "toVersion": 3,
+  "blocked": false,
+  "requiresApproval": true,
+  "reason": "首次发布须先证明不存在并审批",
+  "steps": [],
+  "initialization": true
+}

package/fixtures/openapi/TemplateMigrationPolicy/invalid/blank-guide.json ADDED Viewed

@@ -0,0 +1,5 @@
+{
+  "sequential": false,
+  "irreversible": true,
+  "guide": "  \n"
+}

package/fixtures/openapi/TemplateMigrationPolicy/invalid/missing-guide.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "sequential": true,
+  "irreversible": false
+}

package/fixtures/openapi/TemplateMigrationPolicy/invalid/unknown-escape-hatch.json ADDED Viewed

@@ -0,0 +1,6 @@
+{
+  "sequential": true,
+  "irreversible": true,
+  "guide": "manual",
+  "force": true
+}

package/fixtures/openapi/TemplateMigrationPolicy/valid/legacy-safe.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "sequential": false,
+  "irreversible": false
+}

package/fixtures/openapi/TemplateMigrationPolicy/valid/ordered-data-change.json ADDED Viewed

@@ -0,0 +1,5 @@
+{
+  "sequential": true,
+  "irreversible": true,
+  "guide": "先备份，再按相邻版本发布；完成业务检查后继续。"
+}

package/fixtures/openapi/TemplateUpdateBatchInput/invalid/duplicate-candidates.json ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "previewDigest": "sha256:abc",
+  "candidateIds": [
+    "candidate-1",
+    "candidate-1"
+  ],
+  "waveSize": 2,
+  "stopOnFailure": true,
+  "acknowledgeHistoryGaps": false,
+  "idempotencyKey": "manual-1"
+}

package/fixtures/openapi/TemplateUpdateBatchInput/invalid/empty-identities.json ADDED Viewed

@@ -0,0 +1,10 @@
+{
+  "previewDigest": "",
+  "candidateIds": [
+    ""
+  ],
+  "waveSize": 2,
+  "stopOnFailure": true,
+  "acknowledgeHistoryGaps": false,
+  "idempotencyKey": ""
+}