@happyvertical/smrt-support 0.39.2

package/dist/types.js

@@ -0,0 +1,109 @@
+//#region src/types.ts
+var SUPPORT_CASE_STATUS_TRANSITIONS = {
+	new: [
+		"triaged",
+		"assigned",
+		"in_progress",
+		"waiting_on_client",
+		"escalated",
+		"resolved",
+		"closed"
+	],
+	triaged: [
+		"assigned",
+		"in_progress",
+		"waiting_on_client",
+		"escalated",
+		"resolved",
+		"closed"
+	],
+	assigned: [
+		"triaged",
+		"in_progress",
+		"waiting_on_client",
+		"escalated",
+		"resolved",
+		"closed"
+	],
+	in_progress: [
+		"assigned",
+		"waiting_on_client",
+		"escalated",
+		"resolved",
+		"closed"
+	],
+	waiting_on_client: [
+		"assigned",
+		"in_progress",
+		"escalated",
+		"resolved",
+		"closed"
+	],
+	escalated: [
+		"assigned",
+		"in_progress",
+		"waiting_on_client",
+		"resolved",
+		"closed"
+	],
+	resolved: [
+		"closed",
+		"in_progress",
+		"triaged"
+	],
+	closed: ["triaged", "in_progress"]
+};
+var OPEN_SUPPORT_CASE_STATUSES = [
+	"new",
+	"triaged",
+	"assigned",
+	"in_progress",
+	"waiting_on_client",
+	"escalated"
+];
+var SERVICE_TIME_ENTRY_STATUS_TRANSITIONS = {
+	draft: ["submitted", "rejected"],
+	submitted: [
+		"approved",
+		"rejected",
+		"draft"
+	],
+	approved: ["corrected"],
+	rejected: ["draft", "submitted"],
+	corrected: []
+};
+var DEFAULT_SEVERITY_DEFINITIONS = {
+	sev1: {
+		label: "Critical",
+		description: "Service down or unusable"
+	},
+	sev2: {
+		label: "Major",
+		description: "Significant degradation"
+	},
+	sev3: {
+		label: "Minor",
+		description: "Limited impact"
+	},
+	sev4: {
+		label: "Question",
+		description: "Question or request"
+	}
+};
+function parseJsonField(raw, fallback) {
+	if (!raw) return fallback;
+	if (typeof raw !== "string") return raw;
+	try {
+		return JSON.parse(raw) ?? fallback;
+	} catch {
+		return fallback;
+	}
+}
+function parseStringArrayField(raw) {
+	const parsed = parseJsonField(raw, []);
+	return Array.isArray(parsed) ? parsed.filter((value) => typeof value === "string") : [];
+}
+//#endregion
+export { DEFAULT_SEVERITY_DEFINITIONS, OPEN_SUPPORT_CASE_STATUSES, SERVICE_TIME_ENTRY_STATUS_TRANSITIONS, SUPPORT_CASE_STATUS_TRANSITIONS, parseJsonField, parseStringArrayField };
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Shared types, enums, and lifecycle maps for `@happyvertical/smrt-support`.\n *\n * Domain language follows the HappyVertical support glossary: a **Support\n * Case** is the canonical record of a client support request; **Support\n * Interactions** are channel transports attached to it; **Service Targets**\n * are operational clocks (not contractual SLAs); a **Managed Support Plan**\n * carries the client-facing terms while a **Support Compensation Plan**\n * carries the provider-facing terms — the two are never merged.\n */\n\n/** Support Case lifecycle states (FR-29b). */\nexport type SupportCaseStatus =\n  | 'new'\n  | 'triaged'\n  | 'assigned'\n  | 'in_progress'\n  | 'waiting_on_client'\n  | 'escalated'\n  | 'resolved'\n  | 'closed';\n\n/**\n * Legal Support Case status transitions, enforced at save time by\n * {@link SupportCase} (S5 guarded-lifecycle idiom — raw mass-assignment on a\n * generated route cannot skip states). Reopening (`resolved`/`closed` back to\n * an active state) is legal here; the reopen bookkeeping (count, history\n * event) is layered by `SupportCaseService.reopen()`.\n */\nexport const SUPPORT_CASE_STATUS_TRANSITIONS: Record<\n  SupportCaseStatus,\n  SupportCaseStatus[]\n> = {\n  new: [\n    'triaged',\n    'assigned',\n    'in_progress',\n    'waiting_on_client',\n    'escalated',\n    'resolved',\n    'closed',\n  ],\n  triaged: [\n    'assigned',\n    'in_progress',\n    'waiting_on_client',\n    'escalated',\n    'resolved',\n    'closed',\n  ],\n  assigned: [\n    'triaged',\n    'in_progress',\n    'waiting_on_client',\n    'escalated',\n    'resolved',\n    'closed',\n  ],\n  in_progress: [\n    'assigned',\n    'waiting_on_client',\n    'escalated',\n    'resolved',\n    'closed',\n  ],\n  waiting_on_client: [\n    'assigned',\n    'in_progress',\n    'escalated',\n    'resolved',\n    'closed',\n  ],\n  escalated: [\n    'assigned',\n    'in_progress',\n    'waiting_on_client',\n    'resolved',\n    'closed',\n  ],\n  resolved: ['closed', 'in_progress', 'triaged'],\n  closed: ['triaged', 'in_progress'],\n};\n\n/** Case statuses considered \"open\" for create-or-join intake dedup. */\nexport const OPEN_SUPPORT_CASE_STATUSES: SupportCaseStatus[] = [\n  'new',\n  'triaged',\n  'assigned',\n  'in_progress',\n  'waiting_on_client',\n  'escalated',\n];\n\n/** Client-facing priority (ordering/urgency inside a queue). */\nexport type SupportCasePriority = 'low' | 'normal' | 'high' | 'urgent';\n\n/** Transport kind a Support Interaction arrived through. */\nexport type SupportChannelKind =\n  | 'chat'\n  | 'email'\n  | 'phone'\n  | 'voice'\n  | 'web'\n  | 'api';\n\n/** Direction of a Support Interaction relative to the Client. */\nexport type SupportInteractionDirection = 'inbound' | 'outbound' | 'internal';\n\n/** Who performed an interaction or case event. */\nexport type SupportActorKind = 'client' | 'specialist' | 'agent' | 'system';\n\n/** Append-only case audit event types. */\nexport type SupportCaseEventType =\n  | 'created'\n  | 'interaction'\n  | 'transition'\n  | 'assignment'\n  | 'ai_run'\n  | 'handoff'\n  | 'human_requested'\n  | 'escalation'\n  | 'target_scheduled'\n  | 'target_satisfied'\n  | 'target_breached'\n  | 'target_paused'\n  | 'target_resumed'\n  | 'work_linked'\n  | 'reopened'\n  | 'plan_applied'\n  | 'time_recorded'\n  | 'note';\n\n/** What kind of transport container a channel binding points at. */\nexport type SupportBindingKind = 'chat_room' | 'email_account';\n\n/** Operational Work Item link kinds carried by a {@link SupportWorkLink}. */\nexport type SupportWorkLinkKind = 'support_work_item' | 'development_work_item';\n\n/** Service Target clock types (FR-30/FR-31). */\nexport type ServiceTargetType =\n  | 'acknowledgement'\n  | 'response'\n  | 'update'\n  | 'resolution';\n\n/** Service Target clock states. */\nexport type ServiceTargetStatus =\n  | 'pending'\n  | 'paused'\n  | 'satisfied'\n  | 'breached'\n  | 'cancelled';\n\n/** Why a case was escalated. */\nexport type SupportEscalationReason =\n  | 'target_breach'\n  | 'target_risk'\n  | 'manual'\n  | 'ai_trigger';\n\n/** AI support workflow phases (FR-28a). */\nexport type SupportAiRunPhase =\n  | 'acknowledge'\n  | 'classify'\n  | 'answer'\n  | 'troubleshoot'\n  | 'resolve';\n\n/** Terminal outcome of one AI workflow phase run. */\nexport type SupportAiRunOutcome =\n  | 'completed'\n  | 'skipped'\n  | 'failed'\n  | 'handed_off';\n\n/** What triggered a Human Handoff (FR-28b). */\nexport type HumanHandoffTrigger =\n  | 'client_request'\n  | 'low_confidence'\n  | 'high_severity'\n  | 'sensitive'\n  | 'failed_resolution'\n  | 'target_risk'\n  | 'policy'\n  | 'manual';\n\n/** Service Time Entry lifecycle (FR-36). */\nexport type ServiceTimeEntryStatus =\n  | 'draft'\n  | 'submitted'\n  | 'approved'\n  | 'rejected'\n  | 'corrected';\n\n/**\n * Legal Service Time Entry status transitions. `approved → corrected` is the\n * only exit from `approved` and is reachable exclusively through the explicit\n * correction path (the approved snapshot itself stays frozen).\n */\nexport const SERVICE_TIME_ENTRY_STATUS_TRANSITIONS: Record<\n  ServiceTimeEntryStatus,\n  ServiceTimeEntryStatus[]\n> = {\n  draft: ['submitted', 'rejected'],\n  submitted: ['approved', 'rejected', 'draft'],\n  approved: ['corrected'],\n  rejected: ['draft', 'submitted'],\n  corrected: [],\n};\n\n/** How a Service Time Entry was produced (FR-40). */\nexport type ServiceTimeEntrySource = 'timer' | 'manual' | 'import' | 'agent';\n\n/** Who/what delivered the work behind a Service Time Entry. */\nexport type SupportParticipantKind = 'human' | 'agent';\n\n/** Which approval path accepted a Service Time Entry (FR-36). */\nexport type TimeEntryApprovalPath =\n  | 'automatic'\n  | 'operator'\n  | 'client'\n  | 'threshold';\n\n/** Derived commercial snapshot lifecycle (charges and compensation). */\nexport type SupportSettlementStatus =\n  | 'pending'\n  | 'final'\n  | 'corrected'\n  | 'voided';\n\n/** Support Specialist availability window kinds. */\nexport type SupportAvailabilityKind = 'weekly' | 'on_call' | 'time_off';\n\n/** Support Specialist activation state. */\nexport type SupportSpecialistStatus = 'active' | 'inactive';\n\n/** Project Support Qualification levels. */\nexport type SupportQualificationLevel = 'trainee' | 'qualified' | 'expert';\n\n/** A weekly coverage window in a plan's coverage calendar. */\nexport interface CoverageWindow {\n  /** 0 = Sunday … 6 = Saturday (JS `Date#getDay` convention). */\n  weekday: number;\n  /** Minutes from midnight, inclusive start. */\n  startMinute: number;\n  /** Minutes from midnight, exclusive end. */\n  endMinute: number;\n}\n\n/** Per-severity Service Target minutes; `null` disables that clock. */\nexport interface ServiceTargetMinutes {\n  acknowledgementMinutes: number | null;\n  responseMinutes: number | null;\n  updateMinutes: number | null;\n  resolutionMinutes: number | null;\n}\n\n/** One step of a plan's escalation policy, applied in `level` order. */\nexport interface EscalationStep {\n  level: number;\n  action: 'notify' | 'reassign';\n  /** Profile ids to notify (recorded on the escalation; delivery is app-side). */\n  notifyProfileIds?: string[];\n  /** Minutes after the previous step before this one fires (0 = immediately). */\n  delayMinutes?: number;\n}\n\n/** A severity definition entry in a plan (key → labels). */\nexport interface SeverityDefinition {\n  label: string;\n  description?: string;\n}\n\n/**\n * Default severity vocabulary used when a plan doesn't define its own.\n * `sev1` is the most severe.\n */\nexport const DEFAULT_SEVERITY_DEFINITIONS: Record<string, SeverityDefinition> =\n  {\n    sev1: { label: 'Critical', description: 'Service down or unusable' },\n    sev2: { label: 'Major', description: 'Significant degradation' },\n    sev3: { label: 'Minor', description: 'Limited impact' },\n    sev4: { label: 'Question', description: 'Question or request' },\n  };\n\n/** Time-entry approval policy carried by a Managed Support Plan (FR-36). */\nexport interface TimeApprovalPolicy {\n  /** Base path when no threshold applies. */\n  mode: 'automatic' | 'operator' | 'client';\n  /** Entries longer than this require review even under `automatic`. */\n  thresholdMinutes?: number;\n  /** Entries pricing above this amount require review even under `automatic`. */\n  thresholdAmount?: number;\n}\n\n/** One piece of work evidence attached to a Service Time Entry. */\nexport interface TimeEntryEvidence {\n  kind: string;\n  ref: string;\n  label?: string;\n}\n\n/**\n * Parse a JSON value stored as text, returning the fallback on malformed\n * input (never throws — stored JSON may predate schema changes). Accepts an\n * already-parsed value (e.g. a `type: 'json'` column that hydrated as an\n * object) and hands it back unchanged.\n */\nexport function parseJsonField<T>(raw: unknown, fallback: T): T {\n  if (!raw) {\n    return fallback;\n  }\n  // Text columns hydrate as strings; a non-string here means the caller\n  // already holds a parsed value — hand it back rather than throwing.\n  if (typeof raw !== 'string') {\n    return raw as T;\n  }\n  try {\n    const parsed = JSON.parse(raw);\n    return (parsed ?? fallback) as T;\n  } catch {\n    return fallback;\n  }\n}\n\n/** Parse a JSON array-of-strings field, tolerating malformed input. */\nexport function parseStringArrayField(\n  raw: string | null | undefined,\n): string[] {\n  const parsed = parseJsonField<unknown>(raw, []);\n  return Array.isArray(parsed)\n    ? parsed.filter((value): value is string => typeof value === 'string')\n    : [];\n}\n"],"mappings":";AA6BO,IAAM,kCAGT;CACF,KAAK;EACH;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CACA,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;CACF;CACA,UAAU;EACR;EACA;EACA;EACA;EACA;EACA;CACF;CACA,aAAa;EACX;EACA;EACA;EACA;EACA;CACF;CACA,mBAAmB;EACjB;EACA;EACA;EACA;EACA;CACF;CACA,WAAW;EACT;EACA;EACA;EACA;EACA;CACF;CACA,UAAU;EAAC;EAAU;EAAe;CAAS;CAC7C,QAAQ,CAAC,WAAW,aAAa;AACnC;AAGO,IAAM,6BAAkD;CAC7D;CACA;CACA;CACA;CACA;CACA;AACF;AA4GO,IAAM,wCAGT;CACF,OAAO,CAAC,aAAa,UAAU;CAC/B,WAAW;EAAC;EAAY;EAAY;CAAO;CAC3C,UAAU,CAAC,WAAW;CACtB,UAAU,CAAC,SAAS,WAAW;CAC/B,WAAW,CAAC;AACd;AAqEO,IAAM,+BACX;CACE,MAAM;EAAE,OAAO;EAAY,aAAa;CAA2B;CACnE,MAAM;EAAE,OAAO;EAAS,aAAa;CAA0B;CAC/D,MAAM;EAAE,OAAO;EAAS,aAAa;CAAiB;CACtD,MAAM;EAAE,OAAO;EAAY,aAAa;CAAsB;AAChE;AAyBK,SAAS,eAAkB,KAAc,UAAgB;CAC9D,IAAI,CAAC,KACH,OAAO;CAIT,IAAI,OAAO,QAAQ,UACjB,OAAO;CAET,IAAI;EAEF,OADe,KAAK,MAAM,GAClB,KAAU;CACpB,QAAQ;EACN,OAAO;CACT;AACF;AAGO,SAAS,sBACd,KACU;CACV,MAAM,SAAS,eAAwB,KAAK,CAAC,CAAC;CAC9C,OAAO,MAAM,QAAQ,MAAM,IACvB,OAAO,QAAQ,UAA2B,OAAO,UAAU,QAAQ,IACnE,CAAC;AACP"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@happyvertical/smrt-support",
+  "version": "0.39.2",
+  "description": "AI-first Support Cases: channel-neutral intake, lifecycle, routing, service targets, and service time for the SMRT framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "smrtRawPrimitives": "strict",
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json"
+  },
+  "dependencies": {
+    "@happyvertical/logger": "^0.78.0",
+    "@happyvertical/sql": "^0.78.0",
+    "@happyvertical/smrt-core": "0.39.2",
+    "@happyvertical/smrt-jobs": "0.39.2",
+    "@happyvertical/smrt-chat": "0.39.2",
+    "@happyvertical/smrt-ui": "0.39.2",
+    "@happyvertical/smrt-tenancy": "0.39.2",
+    "@happyvertical/smrt-messages": "0.39.2",
+    "@happyvertical/smrt-users": "0.39.2"
+  },
+  "peerDependencies": {
+    "svelte": "^5.56.4"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.1.2",
+    "@types/node": "24.13.2",
+    "svelte": "^5.56.4",
+    "svelte-check": "^4.7.1",
+    "typescript": "^5.9.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.9",
+    "@happyvertical/smrt-vitest": "0.39.2"
+  },
+  "keywords": [
+    "smrt",
+    "support",
+    "tickets",
+    "service-desk",
+    "sla",
+    "multi-tenant"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/support"
+  },
+  "scripts": {
+    "build": "vite build --mode library && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json",
+    "build:watch": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "dev": "vite dev",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json && node ../../scripts/svelte-check-a11y.mjs --tsconfig ./tsconfig.svelte.json",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+  }
+}