hvp-shared 7.10.0 → 8.0.0

package/dist/contracts/document/requests.d.ts

@@ -121,6 +121,18 @@ export type SubmitForReviewRequest = Record<string, never>;
 export interface PublishDocumentRequest {
     /** Required if publishing without prior in_review (audit trail). */
     changeNotes?: string;
+    /** Collaborator id that authored the content. Default: current user. */
+    elaboratedBy?: string;
+    /** ISO date the content was authored. Default: draft creation date or now. */
+    elaboratedAt?: string;
+    /** Collaborator id that reviewed/validated the content. Default: null. */
+    reviewedBy?: string;
+    /** ISO date of review. Default: now (only used when reviewedBy set). */
+    reviewedAt?: string;
+    /** Collaborator id that authorized the publication. Default: current user. */
+    authorizedBy?: string;
+    /** ISO date of authorization. Default: now. Used as the version's `authorizedAt`. */
+    authorizedAt?: string;
 }
 /**
  * Archive Document Request

package/dist/contracts/document/responses.d.ts

@@ -16,7 +16,8 @@ export interface DocumentSummaryVersionRef {
     versionNumber: string;
     contentType: ContentType;
     externalLinkProvider: ExternalLinkProvider | null;
-    publishedAt: string | null;
+    /** Date the version was authorized — i.e. promoted to `current`. */
+    authorizedAt: string | null;
 }
 /**
  * Public Document Response
@@ -96,8 +97,15 @@ export interface DocumentSummaryResponse {
  * Full version row. Returned by the viewer, version history, and
  * acknowledgment lookups.
  *
- * A version has a single meaningful date — `publishedAt` — which is null while
- * the version is draft / in_review and set when it transitions to `current`.
+ * Three independent business-attribution axes per version (all may be set
+ * independently):
+ *   - elaborated: who wrote the content + when ("Elaboró")
+ *   - reviewed:   who reviewed the content + when ("Revisó")
+ *   - authorized: who authorized publication + when ("Autorizó / Validó")
+ *
+ * Versions do NOT carry system audit (`createdBy`, `createdAt`, etc.) because
+ * those would duplicate the business fields above. Forensic insertion timestamp
+ * remains derivable from the row's ObjectId.
  */
 export interface DocumentVersionResponse {
     id: string;
@@ -112,11 +120,15 @@ export interface DocumentVersionResponse {
     } | null;
     changeType: ChangeType;
     changeNotes: string | null;
-    /** Set only when the version reached `current` (or was demoted to `superseded`). Null for draft / in_review. */
-    publishedAt: string | null;
-    publishedBy: string | null;
-    /** Author of this version row (typically who started the draft). */
-    createdBy?: string;
+    /** Author of the content. Defaults to the publisher on legacy versions. */
+    elaboratedBy: string | null;
+    elaboratedAt: string | null;
+    /** Reviewer (validó). Optional — may stay null when no formal review happened. */
+    reviewedBy: string | null;
+    reviewedAt: string | null;
+    /** Authorizer of the publication (autorizó). Set when the version reaches `current`. */
+    authorizedBy: string | null;
+    authorizedAt: string | null;
 }
 /**
  * Document Acknowledgment Response

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "7.10.0",
+  "version": "8.0.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",