hvp-shared 7.10.0 → 9.0.0

package/dist/constants/document.enums.d.ts

@@ -75,6 +75,22 @@ export declare enum DocumentStatus {
     draft = "draft",
     in_review = "in_review",
     published = "published",
+    /**
+     * Vigente pero desfasado: el contenido sigue aplicando, pero hay partes
+     * desactualizadas que conviene revisar. Visible en listas con un warning.
+     */
+    outdated = "outdated",
+    /**
+     * Retirado: el documento ya no aplica, fue reemplazado o descontinuado.
+     * Oculto por defecto en listas. ISO 9001 lo llama "obsolete".
+     */
+    obsolete = "obsolete",
+    /**
+     * Archivado-histórico: preservación de un documento cuya naturaleza es
+     * registro (grabaciones de reunión, comunicados pasados, etc.). Oculto por
+     * defecto. Distinto de `obsolete`: archived es preservación pasiva,
+     * obsolete es retiro activo.
+     */
     archived = "archived"
 }
 export declare const DOCUMENT_STATUS_LABELS: Record<DocumentStatus, string>;

package/dist/constants/document.enums.js

@@ -109,12 +109,30 @@ var DocumentStatus;
     DocumentStatus["draft"] = "draft";
     DocumentStatus["in_review"] = "in_review";
     DocumentStatus["published"] = "published";
+    /**
+     * Vigente pero desfasado: el contenido sigue aplicando, pero hay partes
+     * desactualizadas que conviene revisar. Visible en listas con un warning.
+     */
+    DocumentStatus["outdated"] = "outdated";
+    /**
+     * Retirado: el documento ya no aplica, fue reemplazado o descontinuado.
+     * Oculto por defecto en listas. ISO 9001 lo llama "obsolete".
+     */
+    DocumentStatus["obsolete"] = "obsolete";
+    /**
+     * Archivado-histórico: preservación de un documento cuya naturaleza es
+     * registro (grabaciones de reunión, comunicados pasados, etc.). Oculto por
+     * defecto. Distinto de `obsolete`: archived es preservación pasiva,
+     * obsolete es retiro activo.
+     */
     DocumentStatus["archived"] = "archived";
 })(DocumentStatus || (exports.DocumentStatus = DocumentStatus = {}));
 exports.DOCUMENT_STATUS_LABELS = {
     [DocumentStatus.draft]: "Borrador",
     [DocumentStatus.in_review]: "En revisión",
     [DocumentStatus.published]: "Publicado",
+    [DocumentStatus.outdated]: "Desactualizado",
+    [DocumentStatus.obsolete]: "Obsoleto",
     [DocumentStatus.archived]: "Archivado",
 };
 // ─── Criticality ────────────────────────────────────────────────────────────

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

@@ -7,6 +7,14 @@
  *   - Update requests are partial; Create requests are complete.
  */
 import { ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider, Purpose } from "../../constants/document.enums";
+/**
+ * Status values that callers may set via the generic status-change endpoint.
+ * `draft`, `in_review`, `published` follow the existing workflow endpoints
+ * (saveDraft / submitForReview / publish); `archived` keeps its `/archive`
+ * endpoint for backward compat. The generic endpoint covers the new
+ * lifecycle moves added in GH#22 SP2 plus return-to-published.
+ */
+export type ChangeableDocumentStatus = DocumentStatus.outdated | DocumentStatus.obsolete | DocumentStatus.published;
 import { WebAppRole } from "../../constants/collaborator.constants";
 /**
  * One element of `audience[]`. Either a role or the `"all"` sentinel.
@@ -121,19 +129,53 @@ 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
  *
- * Marks the document as `archived`. Archived docs are hidden from default
- * lists but data is preserved. Restricted to admin for `legal_document` and
- * `brand_asset` types.
+ * Marks the document as `archived` (historical preservation). Archived docs
+ * are hidden from default lists but data is preserved. Restricted to admin
+ * for `legal_document` and `brand_asset` types.
+ *
+ * Use this only for *preservation* (meeting recordings, past events). For
+ * "retired / no longer applies" use the generic status endpoint with
+ * `obsolete`.
  *
  * @example POST /api/documents/:id/archive
  */
 export interface ArchiveDocumentRequest {
     reason?: string;
 }
+/**
+ * Change Status Request
+ *
+ * Generic lifecycle transition for the new statuses introduced in GH#22 SP2:
+ *  - `published → outdated` / `outdated → published`
+ *  - `published → obsolete` / `outdated → obsolete`
+ *  - `obsolete → published` (admin only — recovery)
+ *
+ * For `draft` / `in_review` use the existing workflow endpoints. For
+ * `archived` use `/archive` and `/unarchive`.
+ *
+ * @example POST /api/documents/:id/status
+ */
+export interface ChangeStatusRequest {
+    status: ChangeableDocumentStatus;
+    /** Optional explanation, shown in the doc's audit trail. */
+    reason?: string;
+}
 /**
  * Unarchive 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": "9.0.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",