@happyvertical/smrt-support 0.39.2

package/dist/svelte/components/__tests__/TimeEntryApprovalQueue.test.js

@@ -0,0 +1,105 @@
+// @vitest-environment jsdom
+/**
+ * Component coverage for TimeEntryApprovalQueue via the shared S11 harness
+ * (#1416): rendering, the approve/reject callbacks (reject collects a
+ * reason first), and accessibility.
+ */
+import { expectNoA11yViolations, render, screen, userEvent, } from '@happyvertical/smrt-vitest/svelte';
+import { describe, expect, it, vi } from 'vitest';
+import TimeEntryApprovalQueue from '../TimeEntryApprovalQueue.svelte';
+function entryView(overrides = {}) {
+    return {
+        id: 'te-1',
+        date: '2026-07-01',
+        hours: 1.5,
+        description: 'Debugged the login loop',
+        status: 'submitted',
+        amount: 180,
+        workerName: 'Ada',
+        hourlyRate: 120,
+        source: 'timer',
+        participantKind: 'human',
+        caseId: 'case-1',
+        ...overrides,
+    };
+}
+describe('TimeEntryApprovalQueue', () => {
+    it('renders date, hours, description, worker, status, and amount', async () => {
+        const { container } = render(TimeEntryApprovalQueue, {
+            props: { entries: [entryView()] },
+        });
+        expect(screen.getByText('2026-07-01')).toBeInTheDocument();
+        expect(screen.getByText('1.5h')).toBeInTheDocument();
+        expect(screen.getByText('Debugged the login loop')).toBeInTheDocument();
+        expect(screen.getByText('Ada')).toBeInTheDocument();
+        expect(screen.getByText('submitted')).toBeInTheDocument();
+        expect(screen.getByText('180.00')).toBeInTheDocument();
+        await expectNoA11yViolations(container);
+    });
+    it('omits the amount when no charge has derived yet', () => {
+        render(TimeEntryApprovalQueue, {
+            props: { entries: [entryView({ amount: undefined })] },
+        });
+        expect(screen.queryByText('180.00')).not.toBeInTheDocument();
+    });
+    it('invokes onapprove with the entry id', async () => {
+        const onapprove = vi.fn();
+        render(TimeEntryApprovalQueue, {
+            props: { entries: [entryView()], onapprove },
+        });
+        await userEvent.click(screen.getByRole('button', {
+            name: 'Approve time entry: Debugged the login loop',
+        }));
+        expect(onapprove).toHaveBeenCalledWith('te-1');
+    });
+    it('collects a reason before invoking onreject', async () => {
+        const onreject = vi.fn();
+        const { container } = render(TimeEntryApprovalQueue, {
+            props: { entries: [entryView()], onreject },
+        });
+        await userEvent.click(screen.getByRole('button', {
+            name: 'Reject time entry: Debugged the login loop',
+        }));
+        const confirmButton = screen.getByRole('button', {
+            name: 'Confirm rejection of: Debugged the login loop',
+        });
+        expect(confirmButton).toBeDisabled();
+        await userEvent.type(screen.getByRole('textbox', {
+            name: 'Rejection reason for: Debugged the login loop',
+        }), 'duplicate entry');
+        await expectNoA11yViolations(container);
+        await userEvent.click(confirmButton);
+        expect(onreject).toHaveBeenCalledWith('te-1', 'duplicate entry');
+    });
+    it('cancelling a rejection restores the actions without firing onreject', async () => {
+        const onreject = vi.fn();
+        render(TimeEntryApprovalQueue, {
+            props: { entries: [entryView()], onreject },
+        });
+        await userEvent.click(screen.getByRole('button', {
+            name: 'Reject time entry: Debugged the login loop',
+        }));
+        await userEvent.click(screen.getByRole('button', {
+            name: 'Cancel rejecting: Debugged the login loop',
+        }));
+        expect(onreject).not.toHaveBeenCalled();
+        expect(screen.getByRole('button', {
+            name: 'Approve time entry: Debugged the login loop',
+        })).toBeInTheDocument();
+    });
+    it('shows no actions on rows that are not submitted', () => {
+        render(TimeEntryApprovalQueue, {
+            props: {
+                entries: [entryView({ id: 'te-2', status: 'approved' })],
+                onapprove: vi.fn(),
+            },
+        });
+        expect(screen.queryByRole('button')).not.toBeInTheDocument();
+    });
+    it('shows the empty message when there are no entries', () => {
+        render(TimeEntryApprovalQueue, {
+            props: { entries: [], emptyMessage: 'Nothing awaiting review' },
+        });
+        expect(screen.getByText('Nothing awaiting review')).toBeInTheDocument();
+    });
+});

package/dist/svelte/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @happyvertical/smrt-support/svelte
+ *
+ * Reusable Svelte 5 surfaces for Managed Support: a case queue and case
+ * detail view (issue #1926), Service Target clocks and the explainable
+ * routing ranking (issue #1929), and a time-entry approval queue (issue
+ * #1930). Presentational only — hosts load data through the package services
+ * and adapt models with the exported view mappers.
+ *
+ * @packageDocumentation
+ */
+import type { ComponentProps } from 'svelte';
+import CaseDetail from './components/CaseDetail.svelte';
+import CaseQueue from './components/CaseQueue.svelte';
+import RoutingRationale from './components/RoutingRationale.svelte';
+import TargetList from './components/TargetList.svelte';
+import TimeEntryApprovalQueue from './components/TimeEntryApprovalQueue.svelte';
+export { CaseDetail, CaseQueue, RoutingRationale, TargetList, TimeEntryApprovalQueue, };
+export type CaseQueueProps = ComponentProps<typeof CaseQueue>;
+export type CaseDetailProps = ComponentProps<typeof CaseDetail>;
+export type TargetListProps = ComponentProps<typeof TargetList>;
+export type RoutingRationaleProps = ComponentProps<typeof RoutingRationale>;
+export type TimeEntryApprovalQueueProps = ComponentProps<typeof TimeEntryApprovalQueue>;
+export { type CaseTimelineItemView, caseStatusBadgeKey, humanizeStatus, priorityBadgeKey, type RankedSpecialistView, type ServiceTargetView, type SupportCaseView, type SupportTimeEntryView, type SupportWorkLinkView, targetStatusBadgeKey, timeEntryStatusBadgeKey, toCaseTimelineItemView, toServiceTargetView, toSupportCaseView, toSupportTimeEntryView, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,UAAU,MAAM,gCAAgC,CAAC;AACxD,OAAO,SAAS,MAAM,+BAA+B,CAAC;AACtD,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AACpE,OAAO,UAAU,MAAM,gCAAgC,CAAC;AACxD,OAAO,sBAAsB,MAAM,4CAA4C,CAAC;AAEhF,OAAO,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,sBAAsB,GACvB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5E,MAAM,MAAM,2BAA2B,GAAG,cAAc,CACtD,OAAO,sBAAsB,CAC9B,CAAC;AAEF,OAAO,EACL,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,18 @@
+/**
+ * @happyvertical/smrt-support/svelte
+ *
+ * Reusable Svelte 5 surfaces for Managed Support: a case queue and case
+ * detail view (issue #1926), Service Target clocks and the explainable
+ * routing ranking (issue #1929), and a time-entry approval queue (issue
+ * #1930). Presentational only — hosts load data through the package services
+ * and adapt models with the exported view mappers.
+ *
+ * @packageDocumentation
+ */
+import CaseDetail from './components/CaseDetail.svelte';
+import CaseQueue from './components/CaseQueue.svelte';
+import RoutingRationale from './components/RoutingRationale.svelte';
+import TargetList from './components/TargetList.svelte';
+import TimeEntryApprovalQueue from './components/TimeEntryApprovalQueue.svelte';
+export { CaseDetail, CaseQueue, RoutingRationale, TargetList, TimeEntryApprovalQueue, };
+export { caseStatusBadgeKey, humanizeStatus, priorityBadgeKey, targetStatusBadgeKey, timeEntryStatusBadgeKey, toCaseTimelineItemView, toServiceTargetView, toSupportCaseView, toSupportTimeEntryView, } from './types.js';

package/dist/svelte/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Serializable view types for the support Svelte surfaces.
+ *
+ * Components take plain view objects (not model instances) so hosts can pass
+ * data across the server/client boundary; `toSupportCaseView` /
+ * `toCaseTimelineItemView` adapt the models. Explicit interfaces (not inline
+ * intersections) keep Svelte 5 prop type evaluation cheap.
+ */
+import type { ServiceTimeEntry } from '../models/service-time-entry.js';
+import type { SupportCase } from '../models/support-case.js';
+import type { SupportServiceTarget } from '../models/support-service-target.js';
+import type { SupportCharge } from '../models/support-settlement.js';
+import type { CaseTimelineItem } from '../services/support-case-service.js';
+export interface SupportCaseView {
+    id: string;
+    caseNumber: string;
+    subject: string;
+    status: string;
+    priority: string;
+    severity: string;
+    channelKind: string;
+    clientProfileId: string | null;
+    projectId: string | null;
+    assignedSpecialistId: string | null;
+    assignedSpecialistName: string | null;
+    reopenCount: number;
+    createdAt: string | null;
+    updatedAt: string | null;
+    resolutionSummary: string;
+}
+export interface CaseTimelineItemView {
+    kind: 'interaction' | 'event';
+    occurredAt: string;
+    actorKind: string;
+    summary: string;
+    body: string;
+    direction: string | null;
+    channelKind: string | null;
+    eventType: string | null;
+}
+export interface SupportWorkLinkView {
+    id: string;
+    linkKind: string;
+    targetLabel: string;
+    externalUrl: string;
+    status: string;
+}
+/**
+ * View shape for a Service Time Entry in approval/review surfaces. The first
+ * eight fields deliberately match `smrt-projects`' presentation `TimeEntry`
+ * contract (`packages/projects/src/svelte/utils.ts`) — smrt-support promotes
+ * that presentation-only shape into persisted models, so hosts can reuse
+ * either package's time surfaces over the same view rows.
+ */
+export interface SupportTimeEntryView {
+    id: string;
+    /** ISO date part (`YYYY-MM-DD`) of the work period start. */
+    date: string;
+    /** Worked duration in decimal hours, rounded to 2 decimals. */
+    hours: number;
+    description: string;
+    status: string;
+    /** Client charge amount, when a derived {@link SupportCharge} is supplied. */
+    amount?: number;
+    workerName?: string;
+    /** Hourly rate from the charge's frozen `rateSnapshot`, when supplied. */
+    hourlyRate?: number;
+    source: string;
+    participantKind: string;
+    caseId: string | null;
+}
+/** Adapt a SupportCase model to the queue/detail view shape. */
+export declare function toSupportCaseView(supportCase: SupportCase, options?: {
+    assignedSpecialistName?: string | null;
+}): SupportCaseView;
+/** Adapt one merged timeline item (interaction or event) to its view. */
+export declare function toCaseTimelineItemView(item: CaseTimelineItem): CaseTimelineItemView;
+/**
+ * Map a case status onto smrt-ui `StatusBadge`'s default color-scheme keys
+ * (`active` | `inactive` | `pending` | `error` | `success` | `warning`); pass
+ * the real status as the badge `label`.
+ */
+export declare function caseStatusBadgeKey(status: string): string;
+/** Map a case priority onto `StatusBadge` default color-scheme keys. */
+export declare function priorityBadgeKey(priority: string): string;
+/** Human-readable label for a snake_case status value. */
+export declare function humanizeStatus(value: string): string;
+/** Adapt a ServiceTimeEntry model (plus its optional charge) to the view. */
+export declare function toSupportTimeEntryView(entry: ServiceTimeEntry, opts?: {
+    charge?: SupportCharge | null;
+    workerName?: string | null;
+}): SupportTimeEntryView;
+/** Map a time-entry status onto `StatusBadge` default color-scheme keys. */
+export declare function timeEntryStatusBadgeKey(status: string): string;
+/** Serializable Service Target clock view for `TargetList` (#1929). */
+export interface ServiceTargetView {
+    id: string;
+    targetType: string;
+    cycle: number;
+    status: string;
+    severity: string;
+    baseMinutes: number;
+    startedAt: string | null;
+    dueAt: string | null;
+    satisfiedAt: string | null;
+    breachedAt: string | null;
+    /** Whether the clock is currently frozen by the plan's pause rules. */
+    paused: boolean;
+}
+/** Adapt a SupportServiceTarget model to the `TargetList` view shape. */
+export declare function toServiceTargetView(target: SupportServiceTarget): ServiceTargetView;
+/**
+ * Map a Service Target status onto smrt-ui `StatusBadge` default
+ * color-scheme keys: running/paused clocks read as attention-colored,
+ * satisfied as success, breached as error.
+ */
+export declare function targetStatusBadgeKey(status: string): string;
+/**
+ * Serializable ranked-specialist view for `RoutingRationale` (#1929) —
+ * mirrors the routing service's `RankedSpecialist` result shape.
+ */
+export interface RankedSpecialistView {
+    specialistId: string;
+    displayName: string;
+    score: number;
+    eligible: boolean;
+    factors: Record<string, number | string | boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/svelte/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/svelte/types.ts"],"names":[],"mappings":"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"}

package/dist/svelte/types.js

@@ -0,0 +1,182 @@
+/**
+ * Serializable view types for the support Svelte surfaces.
+ *
+ * Components take plain view objects (not model instances) so hosts can pass
+ * data across the server/client boundary; `toSupportCaseView` /
+ * `toCaseTimelineItemView` adapt the models. Explicit interfaces (not inline
+ * intersections) keep Svelte 5 prop type evaluation cheap.
+ */
+function toIso(value) {
+    if (!value)
+        return null;
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString();
+}
+/** Adapt a SupportCase model to the queue/detail view shape. */
+export function toSupportCaseView(supportCase, options = {}) {
+    return {
+        id: supportCase.id ?? '',
+        caseNumber: supportCase.caseNumber,
+        subject: supportCase.subject,
+        status: supportCase.status,
+        priority: supportCase.priority,
+        severity: supportCase.severity,
+        channelKind: supportCase.channelKind,
+        clientProfileId: supportCase.clientProfileId,
+        projectId: supportCase.projectId,
+        assignedSpecialistId: supportCase.assignedSpecialistId,
+        assignedSpecialistName: options.assignedSpecialistName ?? null,
+        reopenCount: supportCase.reopenCount,
+        createdAt: toIso(supportCase.created_at),
+        updatedAt: toIso(supportCase.updated_at),
+        resolutionSummary: supportCase.resolutionSummary,
+    };
+}
+/** Adapt one merged timeline item (interaction or event) to its view. */
+export function toCaseTimelineItemView(item) {
+    if (item.kind === 'interaction' && item.interaction) {
+        const interaction = item.interaction;
+        return {
+            kind: 'interaction',
+            occurredAt: toIso(interaction.occurredAt) ?? '',
+            actorKind: interaction.actorKind,
+            summary: `${interaction.direction} ${interaction.channelKind}`,
+            body: interaction.body,
+            direction: interaction.direction,
+            channelKind: interaction.channelKind,
+            eventType: null,
+        };
+    }
+    const event = item.event;
+    return {
+        kind: 'event',
+        occurredAt: toIso(event.occurredAt) ?? '',
+        actorKind: event.actorKind,
+        summary: event.summary,
+        body: '',
+        direction: null,
+        channelKind: null,
+        eventType: event.eventType,
+    };
+}
+/**
+ * Map a case status onto smrt-ui `StatusBadge`'s default color-scheme keys
+ * (`active` | `inactive` | `pending` | `error` | `success` | `warning`); pass
+ * the real status as the badge `label`.
+ */
+export function caseStatusBadgeKey(status) {
+    switch (status) {
+        case 'new':
+        case 'triaged':
+            return 'pending';
+        case 'assigned':
+        case 'in_progress':
+            return 'active';
+        case 'waiting_on_client':
+            return 'warning';
+        case 'escalated':
+            return 'error';
+        case 'resolved':
+            return 'success';
+        case 'closed':
+            return 'inactive';
+        default:
+            return 'pending';
+    }
+}
+/** Map a case priority onto `StatusBadge` default color-scheme keys. */
+export function priorityBadgeKey(priority) {
+    switch (priority) {
+        case 'urgent':
+            return 'error';
+        case 'high':
+            return 'warning';
+        case 'low':
+            return 'inactive';
+        default:
+            return 'active';
+    }
+}
+/** Human-readable label for a snake_case status value. */
+export function humanizeStatus(value) {
+    return (value ?? '').replace(/_/g, ' ');
+}
+/** Adapt a ServiceTimeEntry model (plus its optional charge) to the view. */
+export function toSupportTimeEntryView(entry, opts = {}) {
+    const startIso = toIso(entry.startedAt ?? entry.created_at ?? null);
+    const view = {
+        id: entry.id ?? '',
+        date: startIso ? startIso.slice(0, 10) : '',
+        hours: Math.round((entry.durationSeconds / 3600) * 100) / 100,
+        description: entry.description,
+        status: entry.status,
+        source: entry.source,
+        participantKind: entry.participantKind,
+        caseId: entry.caseId,
+    };
+    if (opts.charge) {
+        view.amount = opts.charge.amount;
+        const hourlyRate = opts.charge.getRateSnapshot().hourlyRate;
+        if (typeof hourlyRate === 'number') {
+            view.hourlyRate = hourlyRate;
+        }
+    }
+    if (opts.workerName) {
+        view.workerName = opts.workerName;
+    }
+    return view;
+}
+/** Map a time-entry status onto `StatusBadge` default color-scheme keys. */
+export function timeEntryStatusBadgeKey(status) {
+    switch (status) {
+        case 'draft':
+            return 'inactive';
+        case 'submitted':
+            return 'pending';
+        case 'approved':
+            return 'success';
+        case 'rejected':
+            return 'error';
+        case 'corrected':
+            return 'warning';
+        default:
+            return 'pending';
+    }
+}
+/** Adapt a SupportServiceTarget model to the `TargetList` view shape. */
+export function toServiceTargetView(target) {
+    return {
+        id: target.id ?? '',
+        targetType: target.targetType,
+        cycle: target.cycle,
+        status: target.status,
+        severity: target.severity,
+        baseMinutes: target.baseMinutes,
+        startedAt: toIso(target.startedAt),
+        dueAt: toIso(target.dueAt),
+        satisfiedAt: toIso(target.satisfiedAt),
+        breachedAt: toIso(target.breachedAt),
+        paused: target.status === 'paused',
+    };
+}
+/**
+ * Map a Service Target status onto smrt-ui `StatusBadge` default
+ * color-scheme keys: running/paused clocks read as attention-colored,
+ * satisfied as success, breached as error.
+ */
+export function targetStatusBadgeKey(status) {
+    switch (status) {
+        case 'pending':
+            return 'pending';
+        case 'paused':
+            return 'warning';
+        case 'satisfied':
+            return 'success';
+        case 'breached':
+            return 'error';
+        case 'cancelled':
+            return 'inactive';
+        default:
+            return 'pending';
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Shared types, enums, and lifecycle maps for `@happyvertical/smrt-support`.
+ *
+ * Domain language follows the HappyVertical support glossary: a **Support
+ * Case** is the canonical record of a client support request; **Support
+ * Interactions** are channel transports attached to it; **Service Targets**
+ * are operational clocks (not contractual SLAs); a **Managed Support Plan**
+ * carries the client-facing terms while a **Support Compensation Plan**
+ * carries the provider-facing terms — the two are never merged.
+ */
+/** Support Case lifecycle states (FR-29b). */
+export type SupportCaseStatus = 'new' | 'triaged' | 'assigned' | 'in_progress' | 'waiting_on_client' | 'escalated' | 'resolved' | 'closed';
+/**
+ * Legal Support Case status transitions, enforced at save time by
+ * {@link SupportCase} (S5 guarded-lifecycle idiom — raw mass-assignment on a
+ * generated route cannot skip states). Reopening (`resolved`/`closed` back to
+ * an active state) is legal here; the reopen bookkeeping (count, history
+ * event) is layered by `SupportCaseService.reopen()`.
+ */
+export declare const SUPPORT_CASE_STATUS_TRANSITIONS: Record<SupportCaseStatus, SupportCaseStatus[]>;
+/** Case statuses considered "open" for create-or-join intake dedup. */
+export declare const OPEN_SUPPORT_CASE_STATUSES: SupportCaseStatus[];
+/** Client-facing priority (ordering/urgency inside a queue). */
+export type SupportCasePriority = 'low' | 'normal' | 'high' | 'urgent';
+/** Transport kind a Support Interaction arrived through. */
+export type SupportChannelKind = 'chat' | 'email' | 'phone' | 'voice' | 'web' | 'api';
+/** Direction of a Support Interaction relative to the Client. */
+export type SupportInteractionDirection = 'inbound' | 'outbound' | 'internal';
+/** Who performed an interaction or case event. */
+export type SupportActorKind = 'client' | 'specialist' | 'agent' | 'system';
+/** Append-only case audit event types. */
+export type SupportCaseEventType = 'created' | 'interaction' | 'transition' | 'assignment' | 'ai_run' | 'handoff' | 'human_requested' | 'escalation' | 'target_scheduled' | 'target_satisfied' | 'target_breached' | 'target_paused' | 'target_resumed' | 'work_linked' | 'reopened' | 'plan_applied' | 'time_recorded' | 'note';
+/** What kind of transport container a channel binding points at. */
+export type SupportBindingKind = 'chat_room' | 'email_account';
+/** Operational Work Item link kinds carried by a {@link SupportWorkLink}. */
+export type SupportWorkLinkKind = 'support_work_item' | 'development_work_item';
+/** Service Target clock types (FR-30/FR-31). */
+export type ServiceTargetType = 'acknowledgement' | 'response' | 'update' | 'resolution';
+/** Service Target clock states. */
+export type ServiceTargetStatus = 'pending' | 'paused' | 'satisfied' | 'breached' | 'cancelled';
+/** Why a case was escalated. */
+export type SupportEscalationReason = 'target_breach' | 'target_risk' | 'manual' | 'ai_trigger';
+/** AI support workflow phases (FR-28a). */
+export type SupportAiRunPhase = 'acknowledge' | 'classify' | 'answer' | 'troubleshoot' | 'resolve';
+/** Terminal outcome of one AI workflow phase run. */
+export type SupportAiRunOutcome = 'completed' | 'skipped' | 'failed' | 'handed_off';
+/** What triggered a Human Handoff (FR-28b). */
+export type HumanHandoffTrigger = 'client_request' | 'low_confidence' | 'high_severity' | 'sensitive' | 'failed_resolution' | 'target_risk' | 'policy' | 'manual';
+/** Service Time Entry lifecycle (FR-36). */
+export type ServiceTimeEntryStatus = 'draft' | 'submitted' | 'approved' | 'rejected' | 'corrected';
+/**
+ * Legal Service Time Entry status transitions. `approved → corrected` is the
+ * only exit from `approved` and is reachable exclusively through the explicit
+ * correction path (the approved snapshot itself stays frozen).
+ */
+export declare const SERVICE_TIME_ENTRY_STATUS_TRANSITIONS: Record<ServiceTimeEntryStatus, ServiceTimeEntryStatus[]>;
+/** How a Service Time Entry was produced (FR-40). */
+export type ServiceTimeEntrySource = 'timer' | 'manual' | 'import' | 'agent';
+/** Who/what delivered the work behind a Service Time Entry. */
+export type SupportParticipantKind = 'human' | 'agent';
+/** Which approval path accepted a Service Time Entry (FR-36). */
+export type TimeEntryApprovalPath = 'automatic' | 'operator' | 'client' | 'threshold';
+/** Derived commercial snapshot lifecycle (charges and compensation). */
+export type SupportSettlementStatus = 'pending' | 'final' | 'corrected' | 'voided';
+/** Support Specialist availability window kinds. */
+export type SupportAvailabilityKind = 'weekly' | 'on_call' | 'time_off';
+/** Support Specialist activation state. */
+export type SupportSpecialistStatus = 'active' | 'inactive';
+/** Project Support Qualification levels. */
+export type SupportQualificationLevel = 'trainee' | 'qualified' | 'expert';
+/** A weekly coverage window in a plan's coverage calendar. */
+export interface CoverageWindow {
+    /** 0 = Sunday … 6 = Saturday (JS `Date#getDay` convention). */
+    weekday: number;
+    /** Minutes from midnight, inclusive start. */
+    startMinute: number;
+    /** Minutes from midnight, exclusive end. */
+    endMinute: number;
+}
+/** Per-severity Service Target minutes; `null` disables that clock. */
+export interface ServiceTargetMinutes {
+    acknowledgementMinutes: number | null;
+    responseMinutes: number | null;
+    updateMinutes: number | null;
+    resolutionMinutes: number | null;
+}
+/** One step of a plan's escalation policy, applied in `level` order. */
+export interface EscalationStep {
+    level: number;
+    action: 'notify' | 'reassign';
+    /** Profile ids to notify (recorded on the escalation; delivery is app-side). */
+    notifyProfileIds?: string[];
+    /** Minutes after the previous step before this one fires (0 = immediately). */
+    delayMinutes?: number;
+}
+/** A severity definition entry in a plan (key → labels). */
+export interface SeverityDefinition {
+    label: string;
+    description?: string;
+}
+/**
+ * Default severity vocabulary used when a plan doesn't define its own.
+ * `sev1` is the most severe.
+ */
+export declare const DEFAULT_SEVERITY_DEFINITIONS: Record<string, SeverityDefinition>;
+/** Time-entry approval policy carried by a Managed Support Plan (FR-36). */
+export interface TimeApprovalPolicy {
+    /** Base path when no threshold applies. */
+    mode: 'automatic' | 'operator' | 'client';
+    /** Entries longer than this require review even under `automatic`. */
+    thresholdMinutes?: number;
+    /** Entries pricing above this amount require review even under `automatic`. */
+    thresholdAmount?: number;
+}
+/** One piece of work evidence attached to a Service Time Entry. */
+export interface TimeEntryEvidence {
+    kind: string;
+    ref: string;
+    label?: string;
+}
+/**
+ * Parse a JSON value stored as text, returning the fallback on malformed
+ * input (never throws — stored JSON may predate schema changes). Accepts an
+ * already-parsed value (e.g. a `type: 'json'` column that hydrated as an
+ * object) and hands it back unchanged.
+ */
+export declare function parseJsonField<T>(raw: unknown, fallback: T): T;
+/** Parse a JSON array-of-strings field, tolerating malformed input. */
+export declare function parseStringArrayField(raw: string | null | undefined): string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}