hvp-shared 10.0.0 → 11.0.0

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

@@ -17,6 +17,27 @@
  * skip the role filter.
  */
 export declare const AUDIENCE_ALL = "all";
+/**
+ * Fundamental document nature. Drives lifecycle behavior:
+ *
+ * - `operational` — living doc that evolves; full lifecycle (draft → current →
+ *   outdated → withdrawn); has versions; has elaboratedAt/reviewedAt/
+ *   authorizedAt per version.
+ * - `reference` — singleton authoritative artifact; can be replaced by a newer
+ *   instance (which becomes a separate doc); simpler lifecycle.
+ * - `record` — moment-in-time capture of an unrepeatable event; no real
+ *   lifecycle; just exists.
+ *
+ * Replaces `Purpose` from earlier design (purpose mixed audience + lifecycle).
+ * Migration: operational stays operational; archive → record;
+ * external/reference → reference (with type-level adjustments).
+ */
+export declare enum Category {
+    operational = "operational",
+    reference = "reference",
+    record = "record"
+}
+export declare const CATEGORY_LABELS: Record<Category, string>;
 /**
  * High-level reason a document exists. First axis of the classification
  * (purpose → type → tags). One purpose per audience:
@@ -63,25 +84,61 @@ export declare enum DocumentType {
      */
     control = "control",
     reference_data = "reference_data",
-    training_material = "training_material",
     legal_document = "legal_document",
     brand_asset = "brand_asset",
+    /**
+     * Permits, certifications, fiscal certificates issued by external authorities.
+     * Singletons replaced when re-issued (e.g. CSF SAT, COFEPRIS, MVR cards).
+     * Added with the Category model.
+     */
+    permit = "permit",
     meeting_recording = "meeting_recording",
     historical = "historical",
+    /**
+     * Specific instance of a class/training session (e.g. "Otitis externa 1
+     * con Anahí Fuentes"). Each is its own doc; new courses ≠ new versions.
+     * Added with the Category model — replaces `training_material`.
+     */
+    training_class = "training_class",
+    /**
+     * One-shot presentation tied to a specific event (anniversaries, public
+     * health campaigns). Added with the Category model — covers what
+     * `marketing` used to capture for past-event content.
+     */
+    presentation = "presentation",
+    /** @deprecated Renamed to `training_class` in the Category model. */
+    training_material = "training_material",
+    /** @deprecated One-shot externals → `presentation`; living external → operational/guidance. */
     marketing = "marketing"
 }
 export declare const DOCUMENT_TYPE_LABELS: Record<DocumentType, string>;
+/**
+ * Which Category each DocumentType belongs to. Source of truth for category
+ * derivation when only `type` is known. Used by migration and validation.
+ */
+export declare const TYPE_TO_CATEGORY: Record<DocumentType, Category>;
 /**
  * Lifecycle state of the document.
  *
+ * Unified vocabulary across categories. Each category uses a subset:
+ *   - operational: draft → current → outdated → withdrawn
+ *   - reference:           current → outdated → withdrawn
+ *   - record:              current → withdrawn (rarely outdated)
+ *
  * Per workflow decision (master plan §Decision 3): there are NO automatic
- * direct-publish rules per criticality — author chooses to publish directly
- * or send to in_review. Reviewer (different person from author) approves.
+ * direct-publish rules per criticality — author chooses status directly.
+ *
+ * `draft` covers the pre-publication phase (was previously split into
+ * `draft` + `in_review`; merged for HVP-scale reality).
  */
 export declare enum DocumentStatus {
     draft = "draft",
-    in_review = "in_review",
-    published = "published",
+    /**
+     * Vigente: doc activo y autoritativo (operational), instancia actual
+     * (reference) o registro accesible (record). Renamed from `published` in
+     * the Category model to share vocabulary across categories.
+     */
+    current = "current",
     /**
      * Vigente pero desfasado: el contenido sigue aplicando, pero hay partes
      * desactualizadas que conviene revisar. Visible en listas con un warning.
@@ -94,6 +151,10 @@ export declare enum DocumentStatus {
      * captura mejor la decisión activa que "obsoleto").
      */
     withdrawn = "withdrawn",
+    /** @deprecated Merged into `draft` in the Category model. */
+    in_review = "in_review",
+    /** @deprecated Renamed to `current` in the Category model. */
+    published = "published",
     /**
      * @deprecated Renombrado a `withdrawn` desde 9.3.0. Sigue presente en
      * el enum durante la ventana de migración para compat de lectura;
@@ -102,14 +163,22 @@ export declare enum 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 `withdrawn`: archived es preservación pasiva,
-     * withdrawn es retiro activo.
+     * @deprecated Records ahora usan `current` (existen y son accesibles).
+     * Operational/reference no usan este status. Kept for migration window.
      */
     archived = "archived"
 }
 export declare const DOCUMENT_STATUS_LABELS: Record<DocumentStatus, string>;
+/**
+ * Map Category back to legacy Purpose for backwards-compat during migration.
+ * Used by mappers/responses that still emit `purpose`.
+ */
+export declare const CATEGORY_TO_PURPOSE: Record<Category, Purpose>;
+/**
+ * Allowed statuses per category. UI uses this to render the right options
+ * in dropdowns. Unified vocabulary, but each category uses a subset.
+ */
+export declare const STATUS_BY_CATEGORY: Record<Category, DocumentStatus[]>;
 /**
  * How critical the document is. Used for ranking, badge color, and (in SP4)
  * acknowledgment urgency.

package/dist/constants/document.enums.js

@@ -13,7 +13,7 @@
  * @see .claude/plans/active/20260427-GH21-documentation-system-redesign.md
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EXTERNAL_LINK_PROVIDER_LABELS = exports.ExternalLinkProvider = exports.CONTENT_TYPE_LABELS = exports.ContentType = exports.CHANGE_TYPE_LABELS = exports.ChangeType = exports.CRITICALITY_LABELS = exports.Criticality = exports.DOCUMENT_STATUS_LABELS = exports.DocumentStatus = exports.DOCUMENT_TYPE_LABELS = exports.DocumentType = exports.PURPOSE_LABELS = exports.Purpose = exports.AUDIENCE_ALL = void 0;
+exports.EXTERNAL_LINK_PROVIDER_LABELS = exports.ExternalLinkProvider = exports.CONTENT_TYPE_LABELS = exports.ContentType = exports.CHANGE_TYPE_LABELS = exports.ChangeType = exports.CRITICALITY_LABELS = exports.Criticality = exports.STATUS_BY_CATEGORY = exports.CATEGORY_TO_PURPOSE = exports.DOCUMENT_STATUS_LABELS = exports.DocumentStatus = exports.TYPE_TO_CATEGORY = exports.DOCUMENT_TYPE_LABELS = exports.DocumentType = exports.PURPOSE_LABELS = exports.Purpose = exports.CATEGORY_LABELS = exports.Category = exports.AUDIENCE_ALL = void 0;
 // ─── Audience sentinel ──────────────────────────────────────────────────────
 /**
  * Sentinel value for `audience: WebAppRole[]` meaning "visible to everyone".
@@ -21,6 +21,33 @@ exports.EXTERNAL_LINK_PROVIDER_LABELS = exports.ExternalLinkProvider = exports.C
  * skip the role filter.
  */
 exports.AUDIENCE_ALL = "all";
+// ─── Category ───────────────────────────────────────────────────────────────
+/**
+ * Fundamental document nature. Drives lifecycle behavior:
+ *
+ * - `operational` — living doc that evolves; full lifecycle (draft → current →
+ *   outdated → withdrawn); has versions; has elaboratedAt/reviewedAt/
+ *   authorizedAt per version.
+ * - `reference` — singleton authoritative artifact; can be replaced by a newer
+ *   instance (which becomes a separate doc); simpler lifecycle.
+ * - `record` — moment-in-time capture of an unrepeatable event; no real
+ *   lifecycle; just exists.
+ *
+ * Replaces `Purpose` from earlier design (purpose mixed audience + lifecycle).
+ * Migration: operational stays operational; archive → record;
+ * external/reference → reference (with type-level adjustments).
+ */
+var Category;
+(function (Category) {
+    Category["operational"] = "operational";
+    Category["reference"] = "reference";
+    Category["record"] = "record";
+})(Category || (exports.Category = Category = {}));
+exports.CATEGORY_LABELS = {
+    [Category.operational]: "Operativo",
+    [Category.reference]: "Referencia",
+    [Category.record]: "Registro",
+};
 // ─── Purpose ────────────────────────────────────────────────────────────────
 /**
  * High-level reason a document exists. First axis of the classification
@@ -63,7 +90,7 @@ exports.PURPOSE_LABELS = {
  */
 var DocumentType;
 (function (DocumentType) {
-    // Operational
+    // ── operational types (Category.operational) ───────────────────────────
     DocumentType["protocol"] = "protocol";
     DocumentType["guidance"] = "guidance";
     DocumentType["tutorial"] = "tutorial";
@@ -77,15 +104,35 @@ var DocumentType;
      * (typically static reference like catalogs). Added in 9.2.0.
      */
     DocumentType["control"] = "control";
-    // Resource
+    // ── reference types (Category.reference) ───────────────────────────────
     DocumentType["reference_data"] = "reference_data";
-    DocumentType["training_material"] = "training_material";
     DocumentType["legal_document"] = "legal_document";
     DocumentType["brand_asset"] = "brand_asset";
-    // Archive
+    /**
+     * Permits, certifications, fiscal certificates issued by external authorities.
+     * Singletons replaced when re-issued (e.g. CSF SAT, COFEPRIS, MVR cards).
+     * Added with the Category model.
+     */
+    DocumentType["permit"] = "permit";
+    // ── record types (Category.record) ─────────────────────────────────────
     DocumentType["meeting_recording"] = "meeting_recording";
     DocumentType["historical"] = "historical";
-    // Resource — communication / external content (added in 7.8.0)
+    /**
+     * Specific instance of a class/training session (e.g. "Otitis externa 1
+     * con Anahí Fuentes"). Each is its own doc; new courses ≠ new versions.
+     * Added with the Category model — replaces `training_material`.
+     */
+    DocumentType["training_class"] = "training_class";
+    /**
+     * One-shot presentation tied to a specific event (anniversaries, public
+     * health campaigns). Added with the Category model — covers what
+     * `marketing` used to capture for past-event content.
+     */
+    DocumentType["presentation"] = "presentation";
+    // ── deprecated (kept for migration compat) ─────────────────────────────
+    /** @deprecated Renamed to `training_class` in the Category model. */
+    DocumentType["training_material"] = "training_material";
+    /** @deprecated One-shot externals → `presentation`; living external → operational/guidance. */
     DocumentType["marketing"] = "marketing";
 })(DocumentType || (exports.DocumentType = DocumentType = {}));
 exports.DOCUMENT_TYPE_LABELS = {
@@ -97,26 +144,67 @@ exports.DOCUMENT_TYPE_LABELS = {
     [DocumentType.policy]: "Política",
     [DocumentType.control]: "Control",
     [DocumentType.reference_data]: "Datos de referencia",
-    [DocumentType.training_material]: "Material de capacitación",
     [DocumentType.legal_document]: "Documento legal",
     [DocumentType.brand_asset]: "Activo de marca",
+    [DocumentType.permit]: "Permiso / certificado",
     [DocumentType.meeting_recording]: "Grabación de reunión",
     [DocumentType.historical]: "Histórico",
-    [DocumentType.marketing]: "Marketing y comunicación externa",
+    [DocumentType.training_class]: "Clase de capacitación",
+    [DocumentType.presentation]: "Presentación de evento",
+    [DocumentType.training_material]: "Material de capacitación (legacy)",
+    [DocumentType.marketing]: "Marketing (legacy)",
+};
+/**
+ * Which Category each DocumentType belongs to. Source of truth for category
+ * derivation when only `type` is known. Used by migration and validation.
+ */
+exports.TYPE_TO_CATEGORY = {
+    // operational
+    [DocumentType.protocol]: Category.operational,
+    [DocumentType.guidance]: Category.operational,
+    [DocumentType.tutorial]: Category.operational,
+    [DocumentType.format]: Category.operational,
+    [DocumentType.tool]: Category.operational,
+    [DocumentType.policy]: Category.operational,
+    [DocumentType.control]: Category.operational,
+    // reference
+    [DocumentType.reference_data]: Category.reference,
+    [DocumentType.legal_document]: Category.reference,
+    [DocumentType.brand_asset]: Category.reference,
+    [DocumentType.permit]: Category.reference,
+    // record
+    [DocumentType.meeting_recording]: Category.record,
+    [DocumentType.historical]: Category.record,
+    [DocumentType.training_class]: Category.record,
+    [DocumentType.presentation]: Category.record,
+    // deprecated — keep in their old category for migration compat
+    [DocumentType.training_material]: Category.record,
+    [DocumentType.marketing]: Category.record,
 };
 // ─── DocumentStatus ─────────────────────────────────────────────────────────
 /**
  * Lifecycle state of the document.
  *
+ * Unified vocabulary across categories. Each category uses a subset:
+ *   - operational: draft → current → outdated → withdrawn
+ *   - reference:           current → outdated → withdrawn
+ *   - record:              current → withdrawn (rarely outdated)
+ *
  * Per workflow decision (master plan §Decision 3): there are NO automatic
- * direct-publish rules per criticality — author chooses to publish directly
- * or send to in_review. Reviewer (different person from author) approves.
+ * direct-publish rules per criticality — author chooses status directly.
+ *
+ * `draft` covers the pre-publication phase (was previously split into
+ * `draft` + `in_review`; merged for HVP-scale reality).
  */
 var DocumentStatus;
 (function (DocumentStatus) {
     DocumentStatus["draft"] = "draft";
-    DocumentStatus["in_review"] = "in_review";
-    DocumentStatus["published"] = "published";
+    /**
+     * Vigente: doc activo y autoritativo (operational), instancia actual
+     * (reference) o registro accesible (record). Renamed from `published` in
+     * the Category model to share vocabulary across categories.
+     */
+    DocumentStatus["current"] = "current";
     /**
      * Vigente pero desfasado: el contenido sigue aplicando, pero hay partes
      * desactualizadas que conviene revisar. Visible en listas con un warning.
@@ -129,6 +217,11 @@ var DocumentStatus;
      * captura mejor la decisión activa que "obsoleto").
      */
     DocumentStatus["withdrawn"] = "withdrawn";
+    // ── deprecated values (kept for migration compat / UI fallback) ────────
+    /** @deprecated Merged into `draft` in the Category model. */
+    DocumentStatus["in_review"] = "in_review";
+    /** @deprecated Renamed to `current` in the Category model. */
+    DocumentStatus["published"] = "published";
     /**
      * @deprecated Renombrado a `withdrawn` desde 9.3.0. Sigue presente en
      * el enum durante la ventana de migración para compat de lectura;
@@ -137,22 +230,51 @@ var DocumentStatus;
      */
     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 `withdrawn`: archived es preservación pasiva,
-     * withdrawn es retiro activo.
+     * @deprecated Records ahora usan `current` (existen y son accesibles).
+     * Operational/reference no usan este status. Kept for migration window.
      */
     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.current]: "Vigente",
+    [DocumentStatus.outdated]: "Desfasado",
     [DocumentStatus.withdrawn]: "Retirado",
-    // Deprecated alias — kept for read compat during 9.3.x migration window
-    [DocumentStatus.obsolete]: "Retirado",
-    [DocumentStatus.archived]: "Archivado",
+    // Deprecated aliases — kept for read compat during migration window
+    [DocumentStatus.in_review]: "En revisión (legacy)",
+    [DocumentStatus.published]: "Vigente (legacy)",
+    [DocumentStatus.obsolete]: "Retirado (legacy)",
+    [DocumentStatus.archived]: "Archivado (legacy)",
+};
+/**
+ * Map Category back to legacy Purpose for backwards-compat during migration.
+ * Used by mappers/responses that still emit `purpose`.
+ */
+exports.CATEGORY_TO_PURPOSE = {
+    [Category.operational]: Purpose.operational,
+    [Category.reference]: Purpose.reference,
+    [Category.record]: Purpose.archive, // best legacy mapping
+};
+/**
+ * Allowed statuses per category. UI uses this to render the right options
+ * in dropdowns. Unified vocabulary, but each category uses a subset.
+ */
+exports.STATUS_BY_CATEGORY = {
+    [Category.operational]: [
+        DocumentStatus.draft,
+        DocumentStatus.current,
+        DocumentStatus.outdated,
+        DocumentStatus.withdrawn,
+    ],
+    [Category.reference]: [
+        DocumentStatus.current,
+        DocumentStatus.outdated,
+        DocumentStatus.withdrawn,
+    ],
+    [Category.record]: [
+        DocumentStatus.current,
+        DocumentStatus.withdrawn,
+    ],
 };
 // ─── Criticality ────────────────────────────────────────────────────────────
 /**

package/package.json

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