hvp-shared 7.9.1 → 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

@@ -7,6 +7,18 @@
  */
 import { ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider, Purpose } from "../../constants/document.enums";
 import { DocumentAudienceEntry } from "./requests";
+/**
+ * Compact reference to a document's current version, embedded in
+ * DocumentSummaryResponse so list views can show version + content-type info
+ * without a per-doc fetch.
+ */
+export interface DocumentSummaryVersionRef {
+    versionNumber: string;
+    contentType: ContentType;
+    externalLinkProvider: ExternalLinkProvider | null;
+    /** Date the version was authorized — i.e. promoted to `current`. */
+    authorizedAt: string | null;
+}
 /**
  * Public Document Response
  *
@@ -68,6 +80,13 @@ export interface DocumentSummaryResponse {
     status: DocumentStatus;
     criticality: Criticality;
     tags: string[];
+    audience: DocumentAudienceEntry[];
+    requiredForOnboarding: boolean;
+    requiresAcknowledgment: boolean;
+    /** Compact current-version data; null when the doc has no published version yet. */
+    currentVersion: DocumentSummaryVersionRef | null;
+    /** Collaborator id of the document author. Frontend resolves to col_code via Redux store. */
+    createdBy: string;
     updatedAt: string;
     /** Match snippet — only present in search responses. */
     snippet?: string;
@@ -78,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;
@@ -94,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.9.1",
+  "version": "8.0.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",