hvp-shared 7.8.0 → 7.9.1

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

@@ -18,13 +18,27 @@
  */
 export declare const AUDIENCE_ALL = "all";
 /**
- * High-level reason a document exists. The first axis of the 3-tier
- * classification (purpose → type → tags).
+ * High-level reason a document exists. First axis of the classification
+ * (purpose → type → tags). One purpose per audience:
+ *
+ * - `operational` — staff, day-to-day workflow
+ * - `reference`   — staff, consultation / support material
+ * - `external`    — public / clients (marketing, communication)
+ * - `archive`     — historical records preserved deliberately
+ *
+ * Note: `resource` was the previous name of the catch-all bucket. It is
+ * deprecated in favor of two narrower purposes (`reference` + `external`)
+ * because mixing internal-staff and external-public content under one
+ * purpose led to incoherent search filtering. Kept in the enum for legacy
+ * data compatibility (migration script will not produce it for new docs).
  */
 export declare enum Purpose {
     operational = "operational",
-    resource = "resource",
-    archive = "archive"
+    reference = "reference",
+    external = "external",
+    archive = "archive",
+    /** @deprecated Use `reference` (internal staff) or `external` (clients/public) instead. */
+    resource = "resource"
 }
 export declare const PURPOSE_LABELS: Record<Purpose, string>;
 /**

package/dist/constants/document.enums.js

@@ -23,19 +23,35 @@ exports.EXTERNAL_LINK_PROVIDER_LABELS = exports.ExternalLinkProvider = exports.C
 exports.AUDIENCE_ALL = "all";
 // ─── Purpose ────────────────────────────────────────────────────────────────
 /**
- * High-level reason a document exists. The first axis of the 3-tier
- * classification (purpose → type → tags).
+ * High-level reason a document exists. First axis of the classification
+ * (purpose → type → tags). One purpose per audience:
+ *
+ * - `operational` — staff, day-to-day workflow
+ * - `reference`   — staff, consultation / support material
+ * - `external`    — public / clients (marketing, communication)
+ * - `archive`     — historical records preserved deliberately
+ *
+ * Note: `resource` was the previous name of the catch-all bucket. It is
+ * deprecated in favor of two narrower purposes (`reference` + `external`)
+ * because mixing internal-staff and external-public content under one
+ * purpose led to incoherent search filtering. Kept in the enum for legacy
+ * data compatibility (migration script will not produce it for new docs).
  */
 var Purpose;
 (function (Purpose) {
     Purpose["operational"] = "operational";
-    Purpose["resource"] = "resource";
+    Purpose["reference"] = "reference";
+    Purpose["external"] = "external";
     Purpose["archive"] = "archive";
+    /** @deprecated Use `reference` (internal staff) or `external` (clients/public) instead. */
+    Purpose["resource"] = "resource";
 })(Purpose || (exports.Purpose = Purpose = {}));
 exports.PURPOSE_LABELS = {
     [Purpose.operational]: "Operativo",
-    [Purpose.resource]: "Recurso",
+    [Purpose.reference]: "Consulta",
+    [Purpose.external]: "Externo / comunicación pública",
     [Purpose.archive]: "Archivo",
+    [Purpose.resource]: "Recurso (deprecated)",
 };
 // ─── DocumentType ───────────────────────────────────────────────────────────
 /**

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

@@ -77,6 +77,9 @@ 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`.
  */
 export interface DocumentVersionResponse {
     id: string;
@@ -91,10 +94,11 @@ export interface DocumentVersionResponse {
     } | null;
     changeType: ChangeType;
     changeNotes: string | null;
-    createdAt: string;
-    createdBy: string;
+    /** 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;
 }
 /**
  * Document Acknowledgment Response

package/package.json

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