@awiki/cli 0.0.1-beta.2

package/internal/identity/public_test.go

@@ -0,0 +1,73 @@
+package identity
+
+import (
+	"encoding/json"
+	"strings"
+	"testing"
+)
+
+func TestPublicDataStripsInternalUserIDFields(t *testing.T) {
+	t.Parallel()
+
+	data := map[string]any{
+		"identity": IdentitySummary{
+			IdentityName: "alice",
+			DID:          "did:wba:awiki.ai:user:alice",
+			UserID:       "user-123",
+			Handle:       "alice",
+		},
+		"legacy_scan": LegacyScan{
+			IndexedEntries: map[string]IndexEntry{
+				"alice": {
+					CredentialName: "alice",
+					DID:            "did:wba:awiki.ai:user:alice",
+					UserID:         "user-123",
+					Handle:         "alice",
+				},
+			},
+			HasLegacy: true,
+		},
+		"result": map[string]any{
+			"user_id": "user-123",
+			"nested": map[string]any{
+				"userId": "user-456",
+				"handle": "alice",
+			},
+		},
+	}
+
+	sanitized := PublicData(data)
+	raw, err := json.Marshal(sanitized)
+	if err != nil {
+		t.Fatalf("json.Marshal() error = %v", err)
+	}
+	output := string(raw)
+	for _, forbidden := range []string{"user_id", "userId", "UserID", "user-123", "user-456"} {
+		if strings.Contains(output, forbidden) {
+			t.Fatalf("sanitized output %q still contains %q", output, forbidden)
+		}
+	}
+	if !strings.Contains(output, "alice") {
+		t.Fatalf("sanitized output %q lost public handle fields", output)
+	}
+}
+
+func TestEvaluateUserStateUsesPublicFriendlyMissingFields(t *testing.T) {
+	t.Parallel()
+
+	state := EvaluateUserState("", "")
+	for _, item := range state.Missing {
+		if item == "user_id" {
+			t.Fatalf("unexpected internal field in Missing: %#v", state.Missing)
+		}
+	}
+	expected := []string{"registration", "handle"}
+	if len(state.Missing) != len(expected) {
+		t.Fatalf("state.Missing = %#v, want %#v", state.Missing, expected)
+	}
+	for index, want := range expected {
+		if state.Missing[index] != want {
+			t.Fatalf("state.Missing[%d] = %q, want %q", index, state.Missing[index], want)
+		}
+	}
+}

package/internal/identity/readiness.go

@@ -0,0 +1,74 @@
+package identity
+
+import (
+	"fmt"
+	"strings"
+)
+
+func EvaluateUserState(userID string, handle string) UserState {
+	missing := make([]string, 0, 2)
+	if strings.TrimSpace(userID) == "" {
+		missing = append(missing, "registration")
+	}
+	if strings.TrimSpace(handle) == "" {
+		missing = append(missing, "handle")
+	}
+
+	state := UserState{
+		RegistrationState: "registered_user",
+		ReadyForMessaging: len(missing) == 0,
+	}
+	if len(missing) > 0 {
+		state.Missing = missing
+		switch len(missing) {
+		case 2:
+			state.RegistrationState = "local_identity"
+		default:
+			state.RegistrationState = "partial_user"
+		}
+	}
+	return state
+}
+
+func EvaluateStoredIdentityUserState(record *StoredIdentity) UserState {
+	if record == nil {
+		return UserState{
+			RegistrationState: "missing_identity",
+			ReadyForMessaging: false,
+			Missing:           []string{"identity"},
+		}
+	}
+	return EvaluateUserState(record.UserID, record.Handle)
+}
+
+func EvaluateIdentitySummaryUserState(summary *IdentitySummary) UserState {
+	if summary == nil {
+		return UserState{
+			RegistrationState: "missing_identity",
+			ReadyForMessaging: false,
+			Missing:           []string{"identity"},
+		}
+	}
+	return EvaluateUserState(summary.UserID, summary.Handle)
+}
+
+func UserRegistrationError(identityName string, state UserState) error {
+	if state.ReadyForMessaging {
+		return nil
+	}
+	name := strings.TrimSpace(identityName)
+	if name == "" {
+		name = "active identity"
+	}
+	missing := "user registration metadata"
+	if len(state.Missing) > 0 {
+		missing = strings.Join(state.Missing, ", ")
+	}
+	return fmt.Errorf(
+		"%w: identity %s is %s and missing %s; complete user setup with `awiki-cli id register --handle <handle> ...` or recover an existing handle first",
+		ErrUserRegistrationRequired,
+		name,
+		state.RegistrationState,
+		missing,
+	)
+}