@byline/client 3.7.0 → 3.9.0

package/dist/response.js

@@ -39,6 +39,17 @@ export function shapeDocument(raw) {
     if (typeof raw.source_locale === 'string') {
         shaped.sourceLocale = raw.source_locale;
     }
+    // Version audit metadata — acting user + action (storage keys
+    // `created_by` / `event_type`).
+    // `created_by` is NULL on rows written before audit wiring or by
+    // internal tooling without a request context — omitted here, rendered as
+    // "unknown" by consumers. See docs/AUDIT.md — Workstream 1.
+    if (typeof raw.created_by === 'string') {
+        shaped.createdBy = raw.created_by;
+    }
+    if (typeof raw.event_type === 'string') {
+        shaped.eventType = raw.event_type;
+    }
     // Locale advertising + availability metadata. Present on
     // find / findById / findByPath; absent on version/history reads.
     // Storage raw keys already match the surface names (passthrough) —

package/dist/types.d.ts

@@ -344,6 +344,21 @@ export interface ClientDocument<F = Record<string, any>> {
     createdAt: Date;
     /** When this version was last updated. */
     updatedAt: Date;
+    /**
+     * The acting user's id that created **this version** (storage column
+     * `byline_document_versions.created_by`). Because versions are immutable,
+     * the creator of the current version is also "who last updated the
+     * document". Absent on rows written before audit wiring or by
+     * internal tooling without a request context. Raw id only — display-name
+     * resolution is an admin-realm concern (see docs/AUDIT.md — Workstream 1).
+     */
+    createdBy?: string;
+    /**
+     * The lifecycle action that produced this version (storage column
+     * `event_type`): `create` / `update` / `restore` / `copy_to_locale` /
+     * `delete_locale`. Surfaced for audit rendering in history views.
+     */
+    eventType?: string;
     /** Reconstructed field data. */
     fields: F;
     /**

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/client",
   "private": false,
   "license": "MPL-2.0",
-  "version": "3.7.0",
+  "version": "3.9.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -38,8 +38,8 @@
   ],
   "dependencies": {
     "npm-run-all": "^4.1.5",
-    "@byline/auth": "3.7.0",
-    "@byline/core": "3.7.0"
+    "@byline/auth": "3.9.0",
+    "@byline/core": "3.9.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.15",
@@ -51,7 +51,7 @@
     "tsx": "^4.22.3",
     "typescript": "6.0.3",
     "vitest": "^4.1.7",
-    "@byline/db-postgres": "3.7.0"
+    "@byline/db-postgres": "3.9.0"
   },
   "publishConfig": {
     "access": "public",