@happyvertical/smrt-support 0.51.32 → 0.51.33

package/dist/services/time-entry-approval-service.d.ts

@@ -1,10 +1,37 @@
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
-import { ServiceTimeEntry, ServiceTimeEntryCollection } from '../models/service-time-entry.js';
-import { SupportCase } from '../models/support-case.js';
+/**
+ * TimeEntryApprovalService — the approval gate for Service Time Entries and
+ * the ONLY writer of their commercial snapshots (FR-36/FR-32/FR-35, issue
+ * #1930).
+ *
+ * Approval paths come from the governing Managed Support Plan's
+ * `timeApprovalPolicy`: `automatic` (no principal needed under the
+ * thresholds), `threshold` (an over-threshold automatic entry needs an
+ * operator), `operator` (the `support.approve-time-entry` split), and
+ * `client` (the case's Client, with the operator split as override).
+ *
+ * On approval two deliberately separate rows derive per entry:
+ *
+ * - **SupportCharge** — client side, from the Managed Support Plan only:
+ *   included time consumes first (per case; period windows arrive with usage
+ *   pricing #1925), the remainder meters at the overage (or on-call) rate.
+ *   Rate math uses the CASE's `planSnapshot` when present so later plan edits
+ *   never change history.
+ * - **SupportCompensation** — provider side, from the effective-dated Support
+ *   Compensation Plan only.
+ *
+ * Margin (charge − compensation) stays computable by readers and is NEVER
+ * stored; case-visible audit events carry the charge amount only, never the
+ * compensation. Approved entries freeze (model-enforced); disputes flow
+ * through {@link TimeEntryApprovalService.correct}, which supersedes the
+ * original and re-derives fresh snapshots from the correcting entry.
+ */
+import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
+import { type ServiceTimeEntry, ServiceTimeEntryCollection } from '../models/service-time-entry.js';
+import type { SupportCase } from '../models/support-case.js';
 import { SupportCompensationPlanCollection } from '../models/support-compensation-plan.js';
-import { SupportCharge, SupportChargeCollection, SupportCompensation, SupportCompensationCollection } from '../models/support-settlement.js';
-import { SupportPrincipal } from '../permissions.js';
-import { TimeApprovalPolicy, TimeEntryApprovalPath, TimeEntryEvidence } from '../types.js';
+import { type SupportCharge, SupportChargeCollection, type SupportCompensation, SupportCompensationCollection } from '../models/support-settlement.js';
+import { type SupportPrincipal } from '../permissions.js';
+import type { TimeApprovalPolicy, TimeEntryApprovalPath, TimeEntryEvidence } from '../types.js';
 import { SupportCaseService } from './support-case-service.js';
 /** Thrown when an approval-path or tenant gate refuses the acting principal. */
 export declare class TimeEntryApprovalDeniedError extends Error {

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-support",
-  "packageVersion": "0.51.32",
+  "packageVersion": "0.51.33",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "bbc42c6222cbbc34e6cc8a0fd73502d03323c1182a4701d25b51001441fbb2e8",
-    "packageJson": "d589b22822a4acd3e9e09c8149965cad594969c0a6c393c1d3f90a68caec413c",
+    "manifest": "1af0eeaf5864a26df69b0d66be551e513e1b4f3cd508c03359b3a15db329446e",
+    "packageJson": "9a6b9a7d8aa643c1b2f073eab710d37a761a47e465f23fd672f804ef3a8e4445",
     "agents": "57d75c4e48c549de0e7e50bfc16d739384cd37f4a0c66f0375d1985b24e6cbdd"
   },
   "exports": [
@@ -34,7 +34,7 @@
     "@types/node": "24.13.6",
     "svelte": "^5.57.1",
     "svelte-check": "^4.7.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-support",
-  "version": "0.51.32",
+  "version": "0.51.33",
   "smrtJsdoc": "strict",
   "description": "AI-first Support Cases: channel-neutral intake, lifecycle, routing, service targets, and service time for the SMRT framework",
   "type": "module",
@@ -27,14 +27,14 @@
   },
   "dependencies": {
     "@happyvertical/logger": "^0.94.1",
-    "@happyvertical/smrt-chat": "0.51.32",
-    "@happyvertical/smrt-core": "0.51.32",
-    "@happyvertical/smrt-jobs": "0.51.32",
-    "@happyvertical/smrt-messages": "0.51.32",
-    "@happyvertical/smrt-projects": "0.51.32",
-    "@happyvertical/smrt-tenancy": "0.51.32",
-    "@happyvertical/smrt-ui": "0.51.32",
-    "@happyvertical/smrt-users": "0.51.32",
+    "@happyvertical/smrt-chat": "0.51.33",
+    "@happyvertical/smrt-core": "0.51.33",
+    "@happyvertical/smrt-jobs": "0.51.33",
+    "@happyvertical/smrt-messages": "0.51.33",
+    "@happyvertical/smrt-projects": "0.51.33",
+    "@happyvertical/smrt-tenancy": "0.51.33",
+    "@happyvertical/smrt-ui": "0.51.33",
+    "@happyvertical/smrt-users": "0.51.33",
     "@happyvertical/sql": "^0.94.1"
   },
   "peerDependencies": {
@@ -46,13 +46,13 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.51.32",
+    "@happyvertical/smrt-vitest": "0.51.33",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@types/node": "24.13.6",
     "svelte": "^5.57.1",
     "svelte-check": "^4.7.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },