@opensoha/contracts 0.1.24 → 0.1.25

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

@@ -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

@@ -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

@@ -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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -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

@@ -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/gen/go/sohaapi/client.go

@@ -16,7 +16,7 @@ import (
 	"time"
 )
 
-const defaultUserAgent = "opensoha-contracts/0.1.24"
+const defaultUserAgent = "opensoha-contracts/0.1.25"
 
 type Client struct {
 	BaseURL    string

package/gen/go/sohaapi/kubernetes_monitoring_test.go

@@ -0,0 +1,67 @@
+package sohaapi
+
+import (
+	"encoding/json"
+	"strings"
+	"testing"
+)
+
+func TestMonitoringDTOsKeepNullAndZeroDistinct(t *testing.T) {
+	var nullPoint, zeroPoint ResourceMonitoringPoint
+	if err := json.Unmarshal([]byte(`{"value":null}`), &nullPoint); err != nil {
+		t.Fatal(err)
+	}
+	if err := json.Unmarshal([]byte(`{"value":0}`), &zeroPoint); err != nil {
+		t.Fatal(err)
+	}
+	if nullPoint.Value != nil || zeroPoint.Value == nil || *zeroPoint.Value != 0 {
+		t.Fatal("null sample became zero")
+	}
+	var quantity ResourceMonitoringQuantity
+	if err := json.Unmarshal([]byte(`{"cpuCores":null,"memoryBytes":0,"podSlots":null}`), &quantity); err != nil {
+		t.Fatal(err)
+	}
+	if quantity.CPUCores != nil || quantity.MemoryBytes == nil || *quantity.MemoryBytes != 0 {
+		t.Fatal("nullable capacity lost")
+	}
+	zero := int64(0)
+	edge := KubernetesTopologyGraphEdge{Weight: &zero}
+	raw, err := json.Marshal(edge)
+	if err != nil || !strings.Contains(string(raw), `"weight":0`) {
+		t.Fatalf("zero weight omitted: %s %v", raw, err)
+	}
+}
+func TestPublishedCacheEnumNamesRemainSourceCompatible(t *testing.T) {
+	values := []string{
+		string(LLMCallLogCacheStatusBypass), string(LLMCallLogCacheStatusHit), string(LLMCallLogCacheStatusMiss), string(LLMCallLogCacheStatusStaleHit), string(LLMCallLogCacheStatusWrite), string(LLMCallLogCacheStatusWriteSkipped),
+		string(CreateAIGatewayAnthropicMessageParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayCohereRerankParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayGeminiGenerateContentParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayGeminiInteractionsParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayGeminiStreamGenerateContentParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIAudioSpeechParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIAudioTranscriptionParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIAudioTranslationParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIChatCompletionParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderAudioSpeechParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderAudioTranscriptionParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderAudioTranslationParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderChatCompletionParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderEmbeddingParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderImageEditParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderImageGenerationParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderImageVariationParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAICompatibleProviderResponseParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIEmbeddingParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIImageEditParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIImageGenerationParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIImageVariationParamsXSohaCacheModeBypass),
+		string(CreateAIGatewayOpenAIResponseParamsXSohaCacheModeBypass),
+		string(SohaCacheModeHeaderBypass),
+	}
+	for _, value := range values {
+		if value == "" {
+			t.Fatal("empty published enum")
+		}
+	}
+}