@smplkit/sdk 3.0.53 → 3.0.55

package/dist/index.d.cts

@@ -22,20 +22,21 @@ interface AuditEvent {
     /** ISO-8601-with-offset timestamp of when the audit service ingested the event. */
     createdAt: string;
     /**
-     * Type of the actor that performed the action (`"user"`, `"api_key"`,
-     * `"system"`, …). Empty string when unknown.
+     * Kind of actor that caused the event — e.g. `"USER"`, `"API_KEY"`,
+     * `"SYSTEM"`, or any label the caller chose. `null` when the caller
+     * did not supply one; the audit service never backfills.
      */
-    actorType: string;
+    actorType: string | null;
     /**
-     * UUID of the actor, when the actor is a tracked entity
-     * (user, api_key). `null` for system actors or anonymous events.
+     * Identifier of the actor that caused the event. Free-form — any
+     * identifier scheme is accepted. `null` when not supplied.
      */
     actorId: string | null;
     /**
-     * Display label for the actor — typically a name or email. Empty
-     * string when unknown.
+     * Human-readable label for the actor (e.g. an email address or API
+     * key name). `null` when not supplied.
      */
-    actorLabel: string;
+    actorLabel: string | null;
     /**
      * Free-form per-event payload defined by the customer. Surfaced on
      * the audit-event resource as a structured JSONB column.
@@ -61,6 +62,17 @@ interface CreateEventInput {
     resourceId: string;
     /** Defaults to server-side `now()` if omitted. */
     occurredAt?: Date | string;
+    /**
+     * Free-form label for the kind of actor that caused the event (e.g.
+     * `"USER"`, `"API_KEY"`, `"SYSTEM"`, or any custom value). The audit
+     * service never backfills this from the request credential — supply
+     * it explicitly when you want the event attributed.
+     */
+    actorType?: string;
+    /** Free-form identifier of the actor. Any string scheme is accepted. */
+    actorId?: string;
+    /** Human-readable label for the actor (e.g. email or API key name). */
+    actorLabel?: string;
     /**
      * Free-form contextual JSON. To record a resource snapshot, nest it
      * inside `data` — smplkit's internal convention is `data.snapshot`,

package/dist/index.d.ts

@@ -22,20 +22,21 @@ interface AuditEvent {
     /** ISO-8601-with-offset timestamp of when the audit service ingested the event. */
     createdAt: string;
     /**
-     * Type of the actor that performed the action (`"user"`, `"api_key"`,
-     * `"system"`, …). Empty string when unknown.
+     * Kind of actor that caused the event — e.g. `"USER"`, `"API_KEY"`,
+     * `"SYSTEM"`, or any label the caller chose. `null` when the caller
+     * did not supply one; the audit service never backfills.
      */
-    actorType: string;
+    actorType: string | null;
     /**
-     * UUID of the actor, when the actor is a tracked entity
-     * (user, api_key). `null` for system actors or anonymous events.
+     * Identifier of the actor that caused the event. Free-form — any
+     * identifier scheme is accepted. `null` when not supplied.
      */
     actorId: string | null;
     /**
-     * Display label for the actor — typically a name or email. Empty
-     * string when unknown.
+     * Human-readable label for the actor (e.g. an email address or API
+     * key name). `null` when not supplied.
      */
-    actorLabel: string;
+    actorLabel: string | null;
     /**
      * Free-form per-event payload defined by the customer. Surfaced on
      * the audit-event resource as a structured JSONB column.
@@ -61,6 +62,17 @@ interface CreateEventInput {
     resourceId: string;
     /** Defaults to server-side `now()` if omitted. */
     occurredAt?: Date | string;
+    /**
+     * Free-form label for the kind of actor that caused the event (e.g.
+     * `"USER"`, `"API_KEY"`, `"SYSTEM"`, or any custom value). The audit
+     * service never backfills this from the request credential — supply
+     * it explicitly when you want the event attributed.
+     */
+    actorType?: string;
+    /** Free-form identifier of the actor. Any string scheme is accepted. */
+    actorId?: string;
+    /** Human-readable label for the actor (e.g. email or API key name). */
+    actorLabel?: string;
     /**
      * Free-form contextual JSON. To record a resource snapshot, nest it
      * inside `data` — smplkit's internal convention is `data.snapshot`,

package/dist/index.js

@@ -16856,6 +16856,9 @@ function _eventBodyFromInput(input) {
   if (input.occurredAt !== void 0) {
     attrs.occurred_at = input.occurredAt instanceof Date ? input.occurredAt.toISOString() : input.occurredAt;
   }
+  if (input.actorType !== void 0) attrs.actor_type = input.actorType;
+  if (input.actorId !== void 0) attrs.actor_id = input.actorId;
+  if (input.actorLabel !== void 0) attrs.actor_label = input.actorLabel;
   if (input.data !== void 0) {
     attrs.data = input.data;
   }
@@ -16870,9 +16873,9 @@ function _eventFromResource(resource) {
     resourceId: String(attrs.resource_id ?? ""),
     occurredAt: String(attrs.occurred_at ?? ""),
     createdAt: String(attrs.created_at ?? ""),
-    actorType: String(attrs.actor_type ?? ""),
+    actorType: attrs.actor_type ?? null,
     actorId: attrs.actor_id ?? null,
-    actorLabel: String(attrs.actor_label ?? ""),
+    actorLabel: attrs.actor_label ?? null,
     data: attrs.data ?? {},
     idempotencyKey: String(attrs.idempotency_key ?? ""),
     doNotForward: Boolean(attrs.do_not_forward ?? false)