@echovisionlab/geul-telemetry 0.1.0

package/LICENSE.md

@@ -0,0 +1,6 @@
+Required Notice: Copyright 2026 Echo Vision Lab. All rights reserved.
+
+Licensed under the PolyForm Noncommercial License 1.0.0:
+https://polyformproject.org/licenses/noncommercial/1.0.0
+
+Commercial use requires a separate license from Echo Vision Lab.

package/README.md

@@ -0,0 +1,38 @@
+# Geul telemetry
+
+Shared logging, tracing, audit, security, request-correlation, and redaction
+contracts for Geul services.
+
+- Go module: `github.com/echovisionlab/geul-telemetry`
+- npm package: `@echovisionlab/geul-telemetry`
+
+```sh
+pnpm add @echovisionlab/geul-telemetry
+```
+
+Browser code should import the `/actor`, `/redaction`, or `/trace` subpaths.
+The package root also includes Node request context and is server-only.
+
+## Development
+
+```sh
+corepack enable
+pnpm install --frozen-lockfile
+pnpm format:check
+pnpm lint
+pnpm typecheck
+pnpm test:coverage
+go test -race ./...
+go vet ./...
+```
+
+## Release
+
+One Release Please version and `v*` tag cover both Go and npm consumers. npm
+publication uses GitHub Actions trusted publishing without a repository npm
+token.
+
+## License
+
+PolyForm Noncommercial 1.0.0. Commercial use requires a separate license from
+Echo Vision Lab. See [LICENSE.md](LICENSE.md).

package/fixtures/audit-records.json

@@ -0,0 +1,316 @@
+[
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000001",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "site_settings.updated",
+    "request_id": "018f47a2-8a3d-4e17-9d42-6f12c89b1234",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "site_settings",
+    "target_id": "1",
+    "changed_fields": ["primary_color", "site_title"]
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000002",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "member.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "member",
+    "target_id": "member-2",
+    "changed_fields": ["role"],
+    "previous_role": "user",
+    "new_role": "author"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000003",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "member.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "member",
+    "target_id": "member-2",
+    "changed_fields": ["status"],
+    "previous_state": "active",
+    "new_state": "banned"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000004",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "member.updated",
+    "actor_kind": "system",
+    "actor_service": "geul-backend",
+    "target_type": "member",
+    "target_id": "member-2",
+    "changed_fields": ["status"],
+    "previous_state": "banned",
+    "new_state": "active"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000005",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "post.updated",
+    "actor_kind": "system",
+    "actor_service": "geul-collab",
+    "target_type": "post",
+    "target_id": "post-1",
+    "changed_fields": ["version"],
+    "version_id": "version-1",
+    "contributor_member_ids": [
+      "1b6bcad2-c90d-49e9-bec7-f9a4ba6b2894",
+      "7a7a8fd4-1f69-4e9a-9dc2-2378926ff351"
+    ]
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000006",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "page.updated",
+    "actor_kind": "system",
+    "actor_service": "geul-collab",
+    "target_type": "page",
+    "target_id": "page-1",
+    "changed_fields": ["version"],
+    "version_id": "version-1",
+    "contributor_member_ids": [
+      "1b6bcad2-c90d-49e9-bec7-f9a4ba6b2894",
+      "7a7a8fd4-1f69-4e9a-9dc2-2378926ff351"
+    ]
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000007",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "work.updated",
+    "actor_kind": "system",
+    "actor_service": "geul-collab",
+    "target_type": "work",
+    "target_id": "work-1",
+    "changed_fields": ["version"],
+    "version_id": "version-1",
+    "contributor_member_ids": [
+      "1b6bcad2-c90d-49e9-bec7-f9a4ba6b2894",
+      "7a7a8fd4-1f69-4e9a-9dc2-2378926ff351"
+    ]
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000008",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "post.created",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "post",
+    "target_id": "post-1"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000009",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "page.created",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "page",
+    "target_id": "page-1"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-00000000000a",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "work.created",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "work",
+    "target_id": "work-1"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-00000000000b",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "post.deleted",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "post",
+    "target_id": "post-1"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-00000000000c",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "page.deleted",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "page",
+    "target_id": "page-1"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-00000000000d",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "work.deleted",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "work",
+    "target_id": "work-1"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-00000000000e",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["canonical_email"],
+    "previous_email": "old@example.test",
+    "new_email": "new@example.test"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-00000000000f",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["login_emails"],
+    "collection_operation": "added",
+    "email": "added@example.test"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000010",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["login_emails"],
+    "collection_operation": "removed",
+    "email": "removed@example.test"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000011",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["social_logins"],
+    "collection_operation": "added",
+    "provider": "google",
+    "provider_subject": "google-subject"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000012",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["social_logins"],
+    "collection_operation": "removed",
+    "provider": "github",
+    "provider_subject": "github-subject"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000013",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["passkeys"],
+    "collection_operation": "added",
+    "passkey_ids": ["passkey-1"]
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000014",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["passkeys"],
+    "collection_operation": "removed",
+    "passkey_ids": ["passkey-2"]
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000015",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["sessions"],
+    "collection_operation": "removed",
+    "session_scope": "one",
+    "session_ids": ["018f47a2-8a3d-4e17-9d42-6f12c89b1234"]
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000016",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["deletion_state"],
+    "previous_state": "none",
+    "new_state": "confirmation_pending"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000017",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["deletion_state"],
+    "previous_state": "confirmation_pending",
+    "new_state": "scheduled"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000018",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["deletion_state"],
+    "previous_state": "scheduled",
+    "new_state": "cancelled"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-000000000019",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.updated",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "account",
+    "target_id": "member-1",
+    "changed_fields": ["deletion_state"],
+    "previous_state": "recovery_confirmation_pending",
+    "new_state": "recovered"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-00000000001a",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "account.deleted",
+    "actor_kind": "system",
+    "actor_service": "geul-backend",
+    "target_type": "account",
+    "target_id": "member-1"
+  },
+  {
+    "audit_id": "00000000-0000-4000-8000-00000000001b",
+    "occurred_at": "2026-08-09T03:04:05Z",
+    "action": "member.updated",
+    "request_id": "018f47a2-8a3d-4e17-9d42-6f12c89b1234",
+    "actor_kind": "member",
+    "actor_member_id": "member-1",
+    "target_type": "member",
+    "target_id": "member-1",
+    "changed_fields": ["nickname", "onboarded"],
+    "nickname": "Onboarded Member"
+  }
+]

package/fixtures/collaboration-checkpoint-entity-types.json

@@ -0,0 +1,15 @@
+[
+  "post",
+  "page",
+  "work",
+  "release",
+  "label",
+  "artist",
+  "campaign",
+  "program_event",
+  "map_theme",
+  "terms_history",
+  "privacy_history",
+  "form",
+  "email_layout"
+]

package/fixtures/domain-audit-actions.json

@@ -0,0 +1,132 @@
+[
+  { "action": "site_settings.updated", "target_type": "site_settings" },
+  { "action": "map_theme.created", "target_type": "map_theme" },
+  { "action": "map_theme.updated", "target_type": "map_theme" },
+  { "action": "map_theme.deleted", "target_type": "map_theme" },
+  { "action": "legal_policy.created", "target_type": "legal_policy" },
+  { "action": "legal_policy.updated", "target_type": "legal_policy" },
+  { "action": "legal_policy.deleted", "target_type": "legal_policy" },
+  { "action": "file.created", "target_type": "file" },
+  { "action": "file.updated", "target_type": "file" },
+  { "action": "file.deleted", "target_type": "file" },
+  { "action": "file_folder.created", "target_type": "file_folder" },
+  { "action": "file_folder.updated", "target_type": "file_folder" },
+  { "action": "file_folder.deleted", "target_type": "file_folder" },
+  { "action": "category.created", "target_type": "category" },
+  { "action": "category.updated", "target_type": "category" },
+  { "action": "category.deleted", "target_type": "category" },
+  { "action": "tag.created", "target_type": "tag" },
+  { "action": "tag.updated", "target_type": "tag" },
+  { "action": "tag.deleted", "target_type": "tag" },
+  { "action": "genre.created", "target_type": "genre" },
+  { "action": "genre.updated", "target_type": "genre" },
+  { "action": "genre.deleted", "target_type": "genre" },
+  { "action": "style.created", "target_type": "style" },
+  { "action": "style.updated", "target_type": "style" },
+  { "action": "style.deleted", "target_type": "style" },
+  { "action": "format.created", "target_type": "format" },
+  { "action": "format.updated", "target_type": "format" },
+  { "action": "format.deleted", "target_type": "format" },
+  { "action": "client.created", "target_type": "client" },
+  { "action": "client.updated", "target_type": "client" },
+  { "action": "client.deleted", "target_type": "client" },
+  { "action": "map_place.created", "target_type": "map_place" },
+  { "action": "map_place.updated", "target_type": "map_place" },
+  { "action": "map_place.deleted", "target_type": "map_place" },
+  { "action": "audience_segment.created", "target_type": "audience_segment" },
+  { "action": "audience_segment.updated", "target_type": "audience_segment" },
+  { "action": "menu.created", "target_type": "menu" },
+  { "action": "menu.updated", "target_type": "menu" },
+  { "action": "menu.deleted", "target_type": "menu" },
+  { "action": "mail_adapter.created", "target_type": "mail_adapter" },
+  { "action": "mail_adapter.updated", "target_type": "mail_adapter" },
+  { "action": "mail_adapter.deleted", "target_type": "mail_adapter" },
+  { "action": "email_suppression.updated", "target_type": "email_suppression" },
+  {
+    "action": "translation_settings.updated",
+    "target_type": "translation_settings"
+  },
+  {
+    "action": "translation_provider.created",
+    "target_type": "translation_provider"
+  },
+  {
+    "action": "translation_provider.updated",
+    "target_type": "translation_provider"
+  },
+  {
+    "action": "translation_provider.deleted",
+    "target_type": "translation_provider"
+  },
+  { "action": "member.updated", "target_type": "member" },
+  { "action": "member_tag.created", "target_type": "member_tag" },
+  { "action": "member_tag.deleted", "target_type": "member_tag" },
+  { "action": "artist.created", "target_type": "artist" },
+  { "action": "artist.updated", "target_type": "artist" },
+  { "action": "artist.deleted", "target_type": "artist" },
+  { "action": "label.created", "target_type": "label" },
+  { "action": "label.updated", "target_type": "label" },
+  { "action": "label.deleted", "target_type": "label" },
+  { "action": "post_series.created", "target_type": "post_series" },
+  { "action": "post_series.updated", "target_type": "post_series" },
+  { "action": "post_series.deleted", "target_type": "post_series" },
+  {
+    "action": "program_event_type.created",
+    "target_type": "program_event_type"
+  },
+  {
+    "action": "program_event_type.updated",
+    "target_type": "program_event_type"
+  },
+  {
+    "action": "program_event_type.deleted",
+    "target_type": "program_event_type"
+  },
+  { "action": "program_event.created", "target_type": "program_event" },
+  { "action": "program_event.updated", "target_type": "program_event" },
+  { "action": "program_event.deleted", "target_type": "program_event" },
+  {
+    "action": "program_event_series.created",
+    "target_type": "program_event_series"
+  },
+  {
+    "action": "program_event_series.updated",
+    "target_type": "program_event_series"
+  },
+  {
+    "action": "program_event_series.deleted",
+    "target_type": "program_event_series"
+  },
+  { "action": "release.created", "target_type": "release" },
+  { "action": "release.updated", "target_type": "release" },
+  { "action": "release.deleted", "target_type": "release" },
+  { "action": "campaign.created", "target_type": "campaign" },
+  { "action": "campaign.updated", "target_type": "campaign" },
+  { "action": "campaign.deleted", "target_type": "campaign" },
+  { "action": "email_template.created", "target_type": "email_template" },
+  { "action": "email_template.updated", "target_type": "email_template" },
+  { "action": "email_template.deleted", "target_type": "email_template" },
+  { "action": "email_layout.created", "target_type": "email_layout" },
+  { "action": "email_layout.updated", "target_type": "email_layout" },
+  { "action": "email_layout.deleted", "target_type": "email_layout" },
+  {
+    "action": "email_event_mapping.updated",
+    "target_type": "email_event_mapping"
+  },
+  { "action": "form.created", "target_type": "form" },
+  { "action": "form.updated", "target_type": "form" },
+  { "action": "form.deleted", "target_type": "form" },
+  { "action": "form_submission.created", "target_type": "form_submission" },
+  { "action": "form_submission.deleted", "target_type": "form_submission" },
+  { "action": "post.created", "target_type": "post" },
+  { "action": "post.updated", "target_type": "post" },
+  { "action": "post.deleted", "target_type": "post" },
+  { "action": "page.created", "target_type": "page" },
+  { "action": "page.updated", "target_type": "page" },
+  { "action": "page.deleted", "target_type": "page" },
+  { "action": "work.created", "target_type": "work" },
+  { "action": "work.updated", "target_type": "work" },
+  { "action": "work.deleted", "target_type": "work" },
+  { "action": "account.updated", "target_type": "account" },
+  { "action": "account.deleted", "target_type": "account" }
+]