hvp-shared 8.0.0 → 9.1.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.
@@ -137,15 +145,37 @@ export interface PublishDocumentRequest {
 /**
  * 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
  *
@@ -182,6 +212,17 @@ export interface ListDocumentsQuery {
     search?: string;
     requiredForOnboarding?: boolean;
     requiresAcknowledgment?: boolean;
+    /**
+     * If true, the response includes `obsolete` documents. Default: false (the
+     * server hides obsolete docs unless the caller asks for them). Ignored when
+     * `status` is set explicitly. Writer-only flag.
+     */
+    includeObsolete?: boolean;
+    /**
+     * If true, the response includes `archived` documents. Default: false.
+     * Ignored when `status` is set explicitly. Writer-only flag.
+     */
+    includeArchived?: boolean;
     limit?: number;
     skip?: number;
 }

package/package.json

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