hvp-shared 11.0.0 → 12.0.0

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

@@ -1,15 +1,9 @@
 /**
  * Document Enums — new document management system (GH#21).
  *
- * Replaces the legacy `documentation.enums.ts` (which keeps serving the legacy
- * `documentations` collection during the 60-day retention window). Do not mix
- * the two — `documentation.*` = legacy, `document.*` = new system.
- *
  * Conventions:
  * - snake_case values per `.claude/rules/enums.md`
  * - `*_LABELS: Record<Enum, string>` Spanish labels alongside each enum
- *
- * @see .claude/plans/active/20260427-GH21-documentation-system-redesign.md
  */
 /**
  * Sentinel value for `audience: WebAppRole[]` meaning "visible to everyone".
@@ -27,10 +21,6 @@ export declare const AUDIENCE_ALL = "all";
  *   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",
@@ -39,35 +29,7 @@ export declare enum Category {
 }
 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:
- *
- * - `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",
-    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>;
-/**
- * Specific kind of document within a purpose. Second axis of classification.
- *
- * Mapping of legacy `DocumentationType` is documented in the migration script
- * (`migrate-documentations-to-documents.ts`). Some values exist purely so
- * legacy docs map cleanly (e.g. `meeting_recording` for `admon` videos).
+ * Specific kind of document within a category. Second axis of classification.
  */
 export declare enum DocumentType {
     protocol = "protocol",
@@ -80,7 +42,7 @@ export declare enum DocumentType {
      * Living registry/tracker. The structure is fixed but the data evolves over
      * time (e.g. monthly income tracker, supplier promotional log). Differs from
      * `format` (a template instance is filled once) and from `reference_data`
-     * (typically static reference like catalogs). Added in 9.2.0.
+     * (typically static reference like catalogs).
      */
     control = "control",
     reference_data = "reference_data",
@@ -89,7 +51,6 @@ export declare enum DocumentType {
     /**
      * 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",
@@ -97,24 +58,25 @@ export declare enum DocumentType {
     /**
      * 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.
+     * health campaigns).
      */
     presentation = "presentation",
-    /** @deprecated Renamed to `training_class` in the Category model. */
-    training_material = "training_material",
-    /** @deprecated One-shot externals → `presentation`; living external → operational/guidance. */
+    /**
+     * Promotional or marketing content (videos, banners, campaign materials)
+     * that captures past-event communication. Different from `presentation`
+     * (talk/slide deck) — `marketing` is promotional/external-facing material
+     * preserved as historical record.
+     */
     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.
+ * derivation when only `type` is known. Used by validation and queries.
  */
 export declare const TYPE_TO_CATEGORY: Record<DocumentType, Category>;
 /**
@@ -125,18 +87,14 @@ export declare const TYPE_TO_CATEGORY: Record<DocumentType, Category>;
  *   - 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 status directly.
- *
- * `draft` covers the pre-publication phase (was previously split into
- * `draft` + `in_review`; merged for HVP-scale reality).
+ * No automatic direct-publish rules per criticality — author chooses status
+ * directly.
  */
 export declare enum DocumentStatus {
     draft = "draft",
     /**
      * 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.
+     * (reference) o registro accesible (record).
      */
     current = "current",
     /**
@@ -146,34 +104,11 @@ export declare enum DocumentStatus {
     outdated = "outdated",
     /**
      * Retirado: el documento ya no aplica, fue reemplazado o descontinuado.
-     * Oculto por defecto en listas. Reemplaza a `obsolete` desde 9.3.0
-     * (alineación con ISO/TR 10013 "withdrawn" y con la RAE — "retirado"
-     * 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;
-     * removable en una mayor futura cuando la BBDD ya no contenga este
-     * valor. La UI lo trata como sinónimo de `withdrawn`.
-     */
-    obsolete = "obsolete",
-    /**
-     * @deprecated Records ahora usan `current` (existen y son accesibles).
-     * Operational/reference no usan este status. Kept for migration window.
+     * Oculto por defecto en listas. Alineado con ISO/TR 10013 "withdrawn".
      */
-    archived = "archived"
+    withdrawn = "withdrawn"
 }
 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.

package/dist/constants/document.enums.js

@@ -2,18 +2,12 @@
 /**
  * Document Enums — new document management system (GH#21).
  *
- * Replaces the legacy `documentation.enums.ts` (which keeps serving the legacy
- * `documentations` collection during the 60-day retention window). Do not mix
- * the two — `documentation.*` = legacy, `document.*` = new system.
- *
  * Conventions:
  * - snake_case values per `.claude/rules/enums.md`
  * - `*_LABELS: Record<Enum, string>` Spanish labels alongside each enum
- *
- * @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.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;
+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.DOCUMENT_STATUS_LABELS = exports.DocumentStatus = exports.TYPE_TO_CATEGORY = exports.DOCUMENT_TYPE_LABELS = exports.DocumentType = exports.CATEGORY_LABELS = exports.Category = exports.AUDIENCE_ALL = void 0;
 // ─── Audience sentinel ──────────────────────────────────────────────────────
 /**
  * Sentinel value for `audience: WebAppRole[]` meaning "visible to everyone".
@@ -32,10 +26,6 @@ exports.AUDIENCE_ALL = "all";
  *   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) {
@@ -48,45 +38,9 @@ exports.CATEGORY_LABELS = {
     [Category.reference]: "Referencia",
     [Category.record]: "Registro",
 };
-// ─── Purpose ────────────────────────────────────────────────────────────────
-/**
- * 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["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.reference]: "Consulta",
-    [Purpose.external]: "Externo / comunicación pública",
-    [Purpose.archive]: "Archivo",
-    [Purpose.resource]: "Recurso (deprecated)",
-};
 // ─── DocumentType ───────────────────────────────────────────────────────────
 /**
- * Specific kind of document within a purpose. Second axis of classification.
- *
- * Mapping of legacy `DocumentationType` is documented in the migration script
- * (`migrate-documentations-to-documents.ts`). Some values exist purely so
- * legacy docs map cleanly (e.g. `meeting_recording` for `admon` videos).
+ * Specific kind of document within a category. Second axis of classification.
  */
 var DocumentType;
 (function (DocumentType) {
@@ -101,7 +55,7 @@ var DocumentType;
      * Living registry/tracker. The structure is fixed but the data evolves over
      * time (e.g. monthly income tracker, supplier promotional log). Differs from
      * `format` (a template instance is filled once) and from `reference_data`
-     * (typically static reference like catalogs). Added in 9.2.0.
+     * (typically static reference like catalogs).
      */
     DocumentType["control"] = "control";
     // ── reference types (Category.reference) ───────────────────────────────
@@ -111,7 +65,6 @@ var DocumentType;
     /**
      * 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) ─────────────────────────────────────
@@ -120,19 +73,19 @@ var DocumentType;
     /**
      * 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.
+     * health campaigns).
      */
     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. */
+    /**
+     * Promotional or marketing content (videos, banners, campaign materials)
+     * that captures past-event communication. Different from `presentation`
+     * (talk/slide deck) — `marketing` is promotional/external-facing material
+     * preserved as historical record.
+     */
     DocumentType["marketing"] = "marketing";
 })(DocumentType || (exports.DocumentType = DocumentType = {}));
 exports.DOCUMENT_TYPE_LABELS = {
@@ -151,12 +104,11 @@ exports.DOCUMENT_TYPE_LABELS = {
     [DocumentType.historical]: "Histórico",
     [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)",
+    [DocumentType.marketing]: "Marketing",
 };
 /**
  * Which Category each DocumentType belongs to. Source of truth for category
- * derivation when only `type` is known. Used by migration and validation.
+ * derivation when only `type` is known. Used by validation and queries.
  */
 exports.TYPE_TO_CATEGORY = {
     // operational
@@ -177,8 +129,6 @@ exports.TYPE_TO_CATEGORY = {
     [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 ─────────────────────────────────────────────────────────
@@ -190,19 +140,15 @@ exports.TYPE_TO_CATEGORY = {
  *   - 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 status directly.
- *
- * `draft` covers the pre-publication phase (was previously split into
- * `draft` + `in_review`; merged for HVP-scale reality).
+ * No automatic direct-publish rules per criticality — author chooses status
+ * directly.
  */
 var DocumentStatus;
 (function (DocumentStatus) {
     DocumentStatus["draft"] = "draft";
     /**
      * 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.
+     * (reference) o registro accesible (record).
      */
     DocumentStatus["current"] = "current";
     /**
@@ -212,48 +158,15 @@ var DocumentStatus;
     DocumentStatus["outdated"] = "outdated";
     /**
      * Retirado: el documento ya no aplica, fue reemplazado o descontinuado.
-     * Oculto por defecto en listas. Reemplaza a `obsolete` desde 9.3.0
-     * (alineación con ISO/TR 10013 "withdrawn" y con la RAE — "retirado"
-     * captura mejor la decisión activa que "obsoleto").
+     * Oculto por defecto en listas. Alineado con ISO/TR 10013 "withdrawn".
      */
     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;
-     * removable en una mayor futura cuando la BBDD ya no contenga este
-     * valor. La UI lo trata como sinónimo de `withdrawn`.
-     */
-    DocumentStatus["obsolete"] = "obsolete";
-    /**
-     * @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.current]: "Vigente",
     [DocumentStatus.outdated]: "Desfasado",
     [DocumentStatus.withdrawn]: "Retirado",
-    // 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

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

@@ -6,17 +6,13 @@
  *   - Date fields are ISO 8601 strings, never `Date` objects.
  *   - Update requests are partial; Create requests are complete.
  */
-import { ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider, Purpose } from "../../constants/document.enums";
+import { Category, ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider } 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.withdrawn
-/** @deprecated alias of `withdrawn`; kept for compat during 9.3.x window. */
- | DocumentStatus.obsolete | DocumentStatus.published;
+ * `draft` is governed by the workflow endpoints (saveDraft / publish), not
+ * by the generic status-change endpoint.
+ */
+export type ChangeableDocumentStatus = DocumentStatus.current | DocumentStatus.outdated | DocumentStatus.withdrawn;
 import { WebAppRole } from "../../constants/collaborator.constants";
 /**
  * One element of `audience[]`. Either a role or the `"all"` sentinel.
@@ -50,11 +46,17 @@ export interface CreateDocumentRequest {
     title: string;
     /** Optional — auto-generated from title via slugify if omitted. */
     slug?: string;
-    purpose: Purpose;
+    /**
+     * Optional — derived server-side from `type` via `TYPE_TO_CATEGORY`. If
+     * provided, must agree with the type's required category or the request
+     * is rejected.
+     */
+    category?: Category;
     type: DocumentType;
     tags?: string[];
     audience: DocumentAudienceEntry[];
     criticality: Criticality;
+    description?: string;
     requiredForOnboarding?: boolean;
     requiresAcknowledgment?: boolean;
     /** ObjectIds (as strings) of related documents. */
@@ -73,11 +75,13 @@ export interface CreateDocumentRequest {
 export interface UpdateDocumentMetadataRequest {
     title?: string;
     slug?: string;
-    purpose?: Purpose;
+    /** Server re-derives from `type` if `type` changes; explicit override allowed. */
+    category?: Category;
     type?: DocumentType;
     tags?: string[];
     audience?: DocumentAudienceEntry[];
     criticality?: Criticality;
+    description?: string;
     requiredForOnboarding?: boolean;
     requiresAcknowledgment?: boolean;
     references?: string[];
@@ -198,10 +202,10 @@ export type AcknowledgeVersionRequest = Record<string, never>;
  * Query string parameters for `GET /api/documents`. All optional. Audience
  * filtering by current user role is implicit (handled server-side).
  *
- * @example GET /api/documents?purpose=operational&status=published
+ * @example GET /api/documents?category=operational&status=current
  */
 export interface ListDocumentsQuery {
-    purpose?: Purpose;
+    category?: Category;
     type?: DocumentType;
     status?: DocumentStatus;
     criticality?: Criticality;
@@ -212,16 +216,11 @@ export interface ListDocumentsQuery {
     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.
+     * If true, the response includes `withdrawn` documents. Default: false
+     * (server hides them unless explicitly requested). Ignored when `status`
+     * is set explicitly. Writer-only flag.
      */
-    includeArchived?: boolean;
+    includeWithdrawn?: boolean;
     limit?: number;
     skip?: number;
 }

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

@@ -5,7 +5,7 @@
  *   - Date fields are ISO 8601 strings (server converts Date → ISO at the mapper layer).
  *   - Use Public → View → Admin inheritance where it adds value.
  */
-import { ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider, Purpose } from "../../constants/document.enums";
+import { Category, ChangeType, ContentType, Criticality, DocumentStatus, DocumentType, ExternalLinkProvider } from "../../constants/document.enums";
 import { DocumentAudienceEntry } from "./requests";
 /**
  * Compact reference to a document's current version, embedded in
@@ -28,7 +28,7 @@ export interface PublicDocumentResponse {
     id: string;
     slug: string;
     title: string;
-    purpose: Purpose;
+    category: Category;
     type: DocumentType;
     status: DocumentStatus;
     criticality: Criticality;
@@ -42,6 +42,7 @@ export interface PublicDocumentResponse {
 export interface DocumentViewResponse extends PublicDocumentResponse {
     tags: string[];
     audience: DocumentAudienceEntry[];
+    description?: string;
     requiredForOnboarding: boolean;
     requiresAcknowledgment: boolean;
     references: string[];
@@ -73,7 +74,7 @@ export interface DocumentSummaryResponse {
     id: string;
     slug: string;
     title: string;
-    purpose: Purpose;
+    category: Category;
     type: DocumentType;
     status: DocumentStatus;
     criticality: Criticality;
@@ -109,7 +110,7 @@ export interface DocumentVersionResponse {
     id: string;
     documentId: string;
     versionNumber: string;
-    status: "draft" | "in_review" | "current" | "superseded";
+    status: "draft" | "in_review" | "current" | "superseded" | "withdrawn";
     contentType: ContentType;
     markdown: string | null;
     externalLink: {

package/package.json

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