@happyvertical/smrt-support 0.39.2

package/dist/models/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Model barrel for `@happyvertical/smrt-support`.
+ */
+export { ServiceTimeEntry, ServiceTimeEntryCollection, } from './service-time-entry.js';
+export { SupportAiRun, SupportAiRunCollection, } from './support-ai-run.js';
+export { generateCaseNumber, SupportCase, SupportCaseCollection, } from './support-case.js';
+export { SupportCaseEvent, SupportCaseEventCollection, } from './support-case-event.js';
+export { SupportChannelBinding, SupportChannelBindingCollection, } from './support-channel-binding.js';
+export { SupportCompensationPlan, SupportCompensationPlanCollection, } from './support-compensation-plan.js';
+export { SupportInteraction, SupportInteractionCollection, } from './support-interaction.js';
+export { DEFAULT_TARGET_MINUTES, SupportPlan, SupportPlanCollection, } from './support-plan.js';
+export { DEFAULT_SUPPORT_POLICY, SupportPolicy, SupportPolicyCollection, } from './support-policy.js';
+export { type CheckAndEscalateResult, SupportEscalation, SupportEscalationCollection, SupportServiceTarget, SupportServiceTargetCollection, } from './support-service-target.js';
+export { SupportCharge, SupportChargeCollection, SupportCompensation, SupportCompensationCollection, } from './support-settlement.js';
+export { SupportAvailability, SupportAvailabilityCollection, SupportQualification, SupportQualificationCollection, SupportSpecialist, SupportSpecialistCollection, } from './support-specialist.js';
+export { SupportWorkLink, SupportWorkLinkCollection, } from './support-work-link.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,+BAA+B,GAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,sBAAsB,EAC3B,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,oBAAoB,EACpB,8BAA8B,EAC9B,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC"}

package/dist/models/service-time-entry.d.ts

@@ -0,0 +1,75 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { ServiceTimeEntrySource, ServiceTimeEntryStatus, SupportParticipantKind, TimeEntryEvidence } from '../types.js';
+export declare class ServiceTimeEntry extends SmrtObject {
+    tenantId: string | null;
+    /** Support Case context, when the work was support (Support Time Entry). */
+    caseId: string | null;
+    /**
+     * Polymorphic work context for non-case work (planning sessions,
+     * development work items): a qualified class name + id. Either `caseId` or
+     * a work ref (or both) should identify the context.
+     */
+    workRefType: string | null;
+    workRefId: string | null;
+    /** Specialist role record, when the deliverer is a Support Specialist. */
+    specialistId: string | null;
+    /** Whether a human or a software agent delivered the work. */
+    participantKind: SupportParticipantKind;
+    /** Delivering human Participant (Person profile), when human. */
+    participantProfileId: string | null;
+    /** Delivering agent identity (persona/agent ref), when agent. */
+    agentRef: string;
+    source: ServiceTimeEntrySource;
+    description: string;
+    /** Work period bounds (informational; `durationSeconds` is authoritative). */
+    startedAt: Date | null;
+    endedAt: Date | null;
+    /** Authoritative worked duration in seconds. */
+    durationSeconds: number;
+    /** Work evidence: JSON array of {@link TimeEntryEvidence}. */
+    evidence: string;
+    status: ServiceTimeEntryStatus;
+    submittedAt: Date | null;
+    submittedByProfileId: string | null;
+    approvedAt: Date | null;
+    approvedByProfileId: string | null;
+    /** Which approval path accepted the entry (FR-36). */
+    approvalPath: string;
+    rejectedAt: Date | null;
+    rejectedByProfileId: string | null;
+    rejectionReason: string;
+    /** The approved entry this one explicitly corrects, when a correction. */
+    correctionOfId: string | null;
+    metadata: string;
+    getEvidence(): TimeEntryEvidence[];
+    setEvidence(items: TimeEntryEvidence[]): void;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+    /** Worked duration in decimal hours (UI convenience). */
+    durationHours(): number;
+    initialize(): Promise<this>;
+    save(): Promise<this>;
+    protected assertStatusTransition(prior: ServiceTimeEntryStatus | undefined): void;
+    /**
+     * Once approved, the work-defining fields are immutable — compare against
+     * the authoritative persisted row (not just the WeakMap), so an upsert via
+     * `create({ id, _skipLoad: true })` cannot bypass the freeze.
+     */
+    protected assertApprovedImmutable(prior: {
+        status: ServiceTimeEntryStatus;
+        frozen: string | null;
+    } | undefined): void;
+    /** Authoritative prior state read from the DB row (S5 #1390 idiom). */
+    protected resolvePriorState(): Promise<{
+        status: ServiceTimeEntryStatus;
+        frozen: string | null;
+    } | undefined>;
+}
+export declare class ServiceTimeEntryCollection extends SmrtCollection<ServiceTimeEntry> {
+    static readonly _itemClass: typeof ServiceTimeEntry;
+    forCase(caseId: string): Promise<ServiceTimeEntry[]>;
+    forSpecialist(specialistId: string): Promise<ServiceTimeEntry[]>;
+    pendingApproval(): Promise<ServiceTimeEntry[]>;
+}
+export default ServiceTimeEntry;
+//# sourceMappingURL=service-time-entry.d.ts.map

package/dist/models/service-time-entry.d.ts.map

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

package/dist/models/support-ai-run.d.ts

@@ -0,0 +1,45 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { SupportAiRunOutcome, SupportAiRunPhase } from '../types.js';
+export declare class SupportAiRun extends SmrtObject {
+    tenantId: string | null;
+    caseId: string;
+    /** Inbound interaction that triggered this run, when applicable. */
+    interactionId: string | null;
+    phase: SupportAiRunPhase;
+    outcome: SupportAiRunOutcome;
+    /**
+     * Model-reported confidence in [0, 1] for answer/classify/resolve phases;
+     * null when the phase has no confidence semantics (e.g. acknowledge).
+     */
+    confidence: number | null;
+    /** Classification output JSON: severity, category, sentiment, sensitive. */
+    classification: string;
+    /** Outbound interaction holding the posted/drafted response, if any. */
+    responseInteractionId: string | null;
+    /** Knowledge sources consulted (JSON array of `{kind, ref, label?}`). */
+    knowledgeRefs: string;
+    /** Tool calls attempted during troubleshooting (JSON array). */
+    toolCalls: string;
+    /** Error detail when `outcome === 'failed'`. */
+    error: string;
+    /** Correlation id tying this run to AI-call telemetry / feedback signals. */
+    correlationId: string;
+    /** Model identifier used, when known. */
+    model: string;
+    startedAt: Date;
+    completedAt: Date | null;
+    metadata: string;
+    getClassification(): Record<string, unknown>;
+    setClassification(value: Record<string, unknown>): void;
+    getKnowledgeRefs(): Array<Record<string, unknown>>;
+    setKnowledgeRefs(refs: Array<Record<string, unknown>>): void;
+    getToolCalls(): Array<Record<string, unknown>>;
+    setToolCalls(calls: Array<Record<string, unknown>>): void;
+}
+export declare class SupportAiRunCollection extends SmrtCollection<SupportAiRun> {
+    static readonly _itemClass: typeof SupportAiRun;
+    /** All AI runs for a case, oldest first. */
+    forCase(caseId: string): Promise<SupportAiRun[]>;
+}
+export default SupportAiRun;
+//# sourceMappingURL=support-ai-run.d.ts.map

package/dist/models/support-ai-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-ai-run.d.ts","sourceRoot":"","sources":["../../src/models/support-ai-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,qBAOa,YAAa,SAAQ,UAAU;IAE1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,MAAM,EAAE,MAAM,CAAM;IAEpB,oEAAoE;IAEpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGpC,KAAK,EAAE,iBAAiB,CAAiB;IAGzC,OAAO,EAAE,mBAAmB,CAAe;IAE3C;;;OAGG;IAEH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEjC,4EAA4E;IAE5E,cAAc,EAAE,MAAM,CAAQ;IAE9B,wEAAwE;IAExE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5C,yEAAyE;IAEzE,aAAa,EAAE,MAAM,CAAQ;IAE7B,gEAAgE;IAEhE,SAAS,EAAE,MAAM,CAAQ;IAEzB,gDAAgD;IAEhD,KAAK,EAAE,MAAM,CAAM;IAEnB,6EAA6E;IAE7E,aAAa,EAAE,MAAM,CAAM;IAE3B,yCAAyC;IAEzC,KAAK,EAAE,MAAM,CAAM;IAEnB,SAAS,EAAE,IAAI,CAAc;IAE7B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGhC,QAAQ,EAAE,MAAM,CAAQ;IAExB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5C,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,gBAAgB,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIlD,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAI5D,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI9C,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;CAG1D;AAED,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,YAAY,CAAC;IACtE,MAAM,CAAC,QAAQ,CAAC,UAAU,sBAAgB;IAE1C,4CAA4C;IACtC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAGvD;AAED,eAAe,YAAY,CAAC"}

package/dist/models/support-case-event.d.ts

@@ -0,0 +1,25 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { SupportActorKind, SupportCaseEventType } from '../types.js';
+export declare class SupportCaseEvent extends SmrtObject {
+    tenantId: string | null;
+    caseId: string;
+    eventType: SupportCaseEventType;
+    actorKind: SupportActorKind;
+    actorProfileId: string | null;
+    occurredAt: Date;
+    /** One-line human-readable summary for the case timeline. */
+    summary: string;
+    /** Structured event payload (transition from/to, rationale, evidence, …). */
+    payload: string;
+    getPayload(): Record<string, unknown>;
+    setPayload(value: Record<string, unknown>): void;
+}
+export declare class SupportCaseEventCollection extends SmrtCollection<SupportCaseEvent> {
+    static readonly _itemClass: typeof SupportCaseEvent;
+    /** All events for a case, oldest first. */
+    forCase(caseId: string, options?: {
+        eventType?: SupportCaseEventType;
+    }): Promise<SupportCaseEvent[]>;
+}
+export default SupportCaseEvent;
+//# sourceMappingURL=support-case-event.d.ts.map

package/dist/models/support-case-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-case-event.d.ts","sourceRoot":"","sources":["../../src/models/support-case-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAIL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AAErB,qBAOa,gBAAiB,SAAQ,UAAU;IAE9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,MAAM,EAAE,MAAM,CAAM;IAGpB,SAAS,EAAE,oBAAoB,CAAU;IAGzC,SAAS,EAAE,gBAAgB,CAAY;IAGvC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAErC,UAAU,EAAE,IAAI,CAAc;IAE9B,6DAA6D;IAE7D,OAAO,EAAE,MAAM,CAAM;IAErB,6EAA6E;IAE7E,OAAO,EAAE,MAAM,CAAQ;IAEvB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIrC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGjD;AAED,qBAAa,0BAA2B,SAAQ,cAAc,CAAC,gBAAgB,CAAC;IAC9E,MAAM,CAAC,QAAQ,CAAC,UAAU,0BAAoB;IAE9C,2CAA2C;IACrC,OAAO,CACX,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,oBAAoB,CAAA;KAAO,GACjD,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAO/B;AAED,eAAe,gBAAgB,CAAC"}

package/dist/models/support-case.d.ts

@@ -0,0 +1,125 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { SupportCaseStatus } from '../types.js';
+/** Generate a short human-facing case number (unique enough per tenant). */
+export declare function generateCaseNumber(now?: Date): string;
+export declare class SupportCase extends SmrtObject {
+    tenantId: string | null;
+    /** Human-facing case reference (e.g. `SUP-…`), generated at open time. */
+    caseNumber: string;
+    /** Short client-facing summary of the request. */
+    subject: string;
+    /** Initial request text (the first inbound interaction's body). */
+    description: string;
+    status: SupportCaseStatus;
+    /** Queue ordering priority: `low` | `normal` | `high` | `urgent`. */
+    priority: string;
+    /**
+     * Severity key resolved against the plan's severity definitions (e.g.
+     * `sev1`…`sev4`). Empty until triage/classification assigns one.
+     */
+    severity: string;
+    /** Classification category (AI- or human-assigned). Free vocabulary. */
+    category: string;
+    /** Whether the subject matter was flagged sensitive (handoff trigger). */
+    sensitive: boolean;
+    /** Origin transport kind (`chat` | `email` | …). */
+    channelKind: string;
+    /**
+     * The Client this Case belongs to (FR-29) — a `Person` or `Organization`
+     * Profile. Nullable so unmatched inbound email can park a Case for triage;
+     * intake marks those with `metadata.unresolvedClient`.
+     */
+    clientProfileId: string | null;
+    /** The person who opened the request, when distinct from the Client. */
+    openedByProfileId: string | null;
+    /**
+     * App-defined Project reference (a client initiative, not a repo board).
+     * Deliberately a plain string — the consuming app owns the Project concept.
+     */
+    projectId: string | null;
+    /** Channel binding that created this case, when intake-created. */
+    bindingId: string | null;
+    /**
+     * Deterministic conversation key used by create-or-join intake dedup
+     * (e.g. `chat:<roomId>[:<threadId>]` or `email:<rfc-message-id>`).
+     */
+    threadKey: string;
+    /** Managed Support Plan governing this case, when one applies. */
+    planId: string | null;
+    /**
+     * JSON snapshot of the plan terms captured when the plan was applied, so
+     * later plan edits never rewrite the terms a case was handled under.
+     * Read through {@link getPlanSnapshot}.
+     */
+    planSnapshot: string;
+    assignedSpecialistId: string | null;
+    assignedAt: Date | null;
+    /** Client/plan preferred specialist considered first by routing (FR-30). */
+    preferredSpecialistId: string | null;
+    /** Current escalation level (0 = never escalated). */
+    escalationLevel: number;
+    escalatedAt: Date | null;
+    /** First outbound acknowledgement of any kind (starts as `null`). */
+    acknowledgedAt: Date | null;
+    /** First substantive outbound response (specialist or agent). */
+    firstRespondedAt: Date | null;
+    /** Set when the client explicitly requested a human (FR-28b). */
+    humanRequestedAt: Date | null;
+    resolvedAt: Date | null;
+    resolvedByProfileId: string | null;
+    /** How the case was resolved: `automated` | `human` | `delivery`. */
+    resolutionKind: string;
+    resolutionSummary: string;
+    closedAt: Date | null;
+    /** Times this case was reopened; prior resolutions live in case events. */
+    reopenCount: number;
+    lastReopenedAt: Date | null;
+    /** Per-case escape hatch: disable the AI workflow for this case only. */
+    aiEnabled: boolean;
+    metadata: string;
+    /** Whether the case is in an open (not resolved/closed) state. */
+    isOpen(): boolean;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+    updateMetadata(patch: Record<string, unknown>): void;
+    getPlanSnapshot(): Record<string, unknown>;
+    setPlanSnapshot(value: Record<string, unknown>): void;
+    /**
+     * Capture the status the row was loaded with so the save-time guard can
+     * reject illegal flips made via raw field assignment.
+     */
+    initialize(): Promise<this>;
+    /** Validate the status transition before persisting, then save. */
+    save(): Promise<this>;
+    protected assertStatusTransition(prior: SupportCaseStatus | undefined): void;
+    /**
+     * Resolve the AUTHORITATIVE prior status. The WeakMap only covers rows
+     * hydrated through {@link initialize}; a `create({ id, _skipLoad: true })`
+     * upsert would otherwise look brand-new and skip the guard, so when the
+     * instance carries an id, read the persisted row directly (S5 #1390 idiom).
+     */
+    protected resolvePriorStatus(): Promise<SupportCaseStatus | undefined>;
+}
+export declare class SupportCaseCollection extends SmrtCollection<SupportCase> {
+    static readonly _itemClass: typeof SupportCase;
+    /**
+     * Find the open case an inbound interaction should join, by conversation
+     * key (create-or-join dedup, FR-28). Returns the most recently updated open
+     * case for the key, or `null` when a new case should be created.
+     */
+    findOpenByThreadKey(threadKey: string, options?: {
+        bindingId?: string | null;
+    }): Promise<SupportCase | null>;
+    /** Queue listing with common filters, newest first. */
+    findQueue(options?: {
+        status?: SupportCaseStatus | SupportCaseStatus[];
+        assignedSpecialistId?: string | null;
+        clientProfileId?: string;
+        projectId?: string;
+        openOnly?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<SupportCase[]>;
+}
+export default SupportCase;
+//# sourceMappingURL=support-case.d.ts.map

package/dist/models/support-case.d.ts.map

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

package/dist/models/support-channel-binding.d.ts

@@ -0,0 +1,47 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { SupportBindingKind, SupportChannelKind } from '../types.js';
+export declare class SupportChannelBinding extends SmrtObject {
+    tenantId: string | null;
+    /** Operator-facing binding name (inherited `name` is the display label). */
+    name: string;
+    bindingKind: SupportBindingKind;
+    /** Channel kind interactions from this binding are recorded as. */
+    channelKind: SupportChannelKind;
+    /**
+     * Qualified class of the bound container, e.g.
+     * `@happyvertical/smrt-chat:ChatRoom` or
+     * `@happyvertical/smrt-messages:EmailAccount`.
+     */
+    targetType: string;
+    /** Id of the bound container row. */
+    targetId: string;
+    /**
+     * Default Client for cases created from this binding (e.g. a dedicated
+     * client support room). When null, intake resolves the client from the
+     * interaction author (chat) or sender lookup (email).
+     */
+    clientProfileId: string | null;
+    /** Default app-defined Project reference for cases from this binding. */
+    projectId: string | null;
+    /** Managed Support Plan applied to cases created from this binding. */
+    planId: string | null;
+    enabled: boolean;
+    /**
+     * Addresses belonging to the provider side of an email binding — inbound
+     * sync skips messages sent FROM these (they are our own outbound mail).
+     * JSON array of e-mail addresses, matched case-insensitively.
+     */
+    selfAddresses: string;
+    metadata: string;
+    getSelfAddresses(): string[];
+    setSelfAddresses(addresses: string[]): void;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+}
+export declare class SupportChannelBindingCollection extends SmrtCollection<SupportChannelBinding> {
+    static readonly _itemClass: typeof SupportChannelBinding;
+    /** Find the enabled binding for a transport container, if any. */
+    findForTarget(targetType: string, targetId: string): Promise<SupportChannelBinding | null>;
+}
+export default SupportChannelBinding;
+//# sourceMappingURL=support-channel-binding.d.ts.map

package/dist/models/support-channel-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-channel-binding.d.ts","sourceRoot":"","sources":["../../src/models/support-channel-binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAIL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,qBAQa,qBAAsB,SAAQ,UAAU;IAEnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAM;IAGlB,WAAW,EAAE,kBAAkB,CAAe;IAE9C,mEAAmE;IAEnE,WAAW,EAAE,kBAAkB,CAAU;IAEzC;;;;OAIG;IAEH,UAAU,EAAE,MAAM,CAAM;IAExB,qCAAqC;IAErC,QAAQ,EAAE,MAAM,CAAM;IAEtB;;;;OAIG;IAEH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtC,yEAAyE;IAEzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEhC,uEAAuE;IAEvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG7B,OAAO,EAAE,OAAO,CAAQ;IAExB;;;;OAIG;IAEH,aAAa,EAAE,MAAM,CAAQ;IAG7B,QAAQ,EAAE,MAAM,CAAQ;IAExB,gBAAgB,IAAI,MAAM,EAAE;IAM5B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAI3C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAItC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlD;AAED,qBAAa,+BAAgC,SAAQ,cAAc,CAAC,qBAAqB,CAAC;IACxF,MAAM,CAAC,QAAQ,CAAC,UAAU,+BAAyB;IAEnD,kEAAkE;IAC5D,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAOzC;AAED,eAAe,qBAAqB,CAAC"}

package/dist/models/support-compensation-plan.d.ts

@@ -0,0 +1,42 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+export declare class SupportCompensationPlan extends SmrtObject {
+    tenantId: string | null;
+    /** Specialist this plan compensates; null = tenant default plan. */
+    specialistId: string | null;
+    /** Display name (inherited `name`; uniqueness comes from conflictColumns). */
+    name: string;
+    /** Hourly earning rate for delivered support time. */
+    hourlyRate: number;
+    currency: string;
+    /** Effective-dating: null bounds mean open-ended. */
+    effectiveFrom: Date | null;
+    effectiveTo: Date | null;
+    /** `active` | `archived`. */
+    status: string;
+    /** Additional agreement terms (JSON object; free-form, snapshotted). */
+    terms: string;
+    getTerms(): Record<string, unknown>;
+    setTerms(value: Record<string, unknown>): void;
+    /** Whether the plan is effective at the given instant. */
+    isEffectiveAt(at?: Date): boolean;
+}
+export declare class SupportCompensationPlanCollection extends SmrtCollection<SupportCompensationPlan> {
+    static readonly _itemClass: typeof SupportCompensationPlan;
+    /**
+     * Resolve the plan compensating a specialist at a work instant:
+     * specialist-specific first, then the tenant default. Ties (overlapping
+     * effective ranges) prefer an exact tenant match over a global
+     * (NULL-tenant) plan, then the latest `effectiveFrom`.
+     *
+     * Pass `options.tenantId` (the work's tenant) whenever resolution may run
+     * without an ambient tenant context (system/job paths list across
+     * tenants): candidates are then limited to that tenant's plans plus
+     * global NULL-tenant plans, so another tenant's default can never price
+     * this tenant's work.
+     */
+    resolveForSpecialist(specialistId: string, at?: Date, options?: {
+        tenantId?: string | null;
+    }): Promise<SupportCompensationPlan | null>;
+}
+export default SupportCompensationPlan;
+//# sourceMappingURL=support-compensation-plan.d.ts.map

package/dist/models/support-compensation-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-compensation-plan.d.ts","sourceRoot":"","sources":["../../src/models/support-compensation-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAGL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAOlC,qBAQa,uBAAwB,SAAQ,UAAU;IAErD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,oEAAoE;IAEpE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAM;IAElB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAO;IAGzB,QAAQ,EAAE,MAAM,CAAS;IAEzB,qDAAqD;IACrD,aAAa,EAAE,IAAI,GAAG,IAAI,CAAQ;IAElC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAEhC,6BAA6B;IAE7B,MAAM,EAAE,MAAM,CAAY;IAE1B,wEAAwE;IAExE,KAAK,EAAE,MAAM,CAAQ;IAErB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9C,0DAA0D;IAC1D,aAAa,CAAC,EAAE,GAAE,IAAiB,GAAG,OAAO;CAM9C;AAED,qBAAa,iCAAkC,SAAQ,cAAc,CAAC,uBAAuB,CAAC;IAC5F,MAAM,CAAC,QAAQ,CAAC,UAAU,iCAA2B;IAErD;;;;;;;;;;;OAWG;IACG,oBAAoB,CACxB,YAAY,EAAE,MAAM,EACpB,EAAE,GAAE,IAAiB,EACrB,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAO,GACzC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;CA6B3C;AAED,eAAe,uBAAuB,CAAC"}

package/dist/models/support-interaction.d.ts

@@ -0,0 +1,49 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { SupportActorKind, SupportChannelKind, SupportInteractionDirection } from '../types.js';
+export declare class SupportInteraction extends SmrtObject {
+    tenantId: string | null;
+    caseId: string;
+    direction: SupportInteractionDirection;
+    channelKind: SupportChannelKind;
+    actorKind: SupportActorKind;
+    /** Author identity when known (client contact, specialist, bot profile). */
+    authorProfileId: string | null;
+    /** When the exchange happened on its channel (not when it was ingested). */
+    occurredAt: Date;
+    /** Denormalized text body for the case timeline (source stays canonical). */
+    body: string;
+    /**
+     * Qualified class of the source transport record, e.g.
+     * `@happyvertical/smrt-chat:ChatMessage` or
+     * `@happyvertical/smrt-messages:Email`. Null for manual notes.
+     */
+    sourceType: string | null;
+    /** Id of the source transport record. Null for manual notes. */
+    sourceId: string | null;
+    /**
+     * Globally unique idempotency key for intake dedup (`conflictColumns`):
+     * `chat:<messageId>`, `email:<emailId>`, or `manual:<uuid>` for
+     * service-authored notes.
+     */
+    sourceKey: string;
+    /**
+     * RFC 822 Message-ID for email interactions — a first-class column so
+     * reply threading (`In-Reply-To` joins) is a keyed lookup instead of a
+     * bounded metadata scan. Empty for non-email interactions.
+     */
+    rfcMessageId: string;
+    metadata: string;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+}
+export declare class SupportInteractionCollection extends SmrtCollection<SupportInteraction> {
+    static readonly _itemClass: typeof SupportInteraction;
+    /** All interactions for a case in channel chronology (oldest first). */
+    forCase(caseId: string): Promise<SupportInteraction[]>;
+    /** Look up an interaction by its idempotency key. */
+    bySourceKey(sourceKey: string): Promise<SupportInteraction | null>;
+    /** Keyed lookup of an email interaction by its RFC 822 Message-ID. */
+    byRfcMessageId(rfcMessageId: string): Promise<SupportInteraction | null>;
+}
+export default SupportInteraction;
+//# sourceMappingURL=support-interaction.d.ts.map

package/dist/models/support-interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-interaction.d.ts","sourceRoot":"","sources":["../../src/models/support-interaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAIL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAErB,qBAQa,kBAAmB,SAAQ,UAAU;IAEhD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,MAAM,EAAE,MAAM,CAAM;IAGpB,SAAS,EAAE,2BAA2B,CAAa;IAGnD,WAAW,EAAE,kBAAkB,CAAU;IAGzC,SAAS,EAAE,gBAAgB,CAAY;IAEvC,4EAA4E;IAE5E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtC,4EAA4E;IAC5E,UAAU,EAAE,IAAI,CAAc;IAE9B,6EAA6E;IAE7E,IAAI,EAAE,MAAM,CAAM;IAElB;;;;OAIG;IAEH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEjC,gEAAgE;IAEhE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;;OAIG;IAEH,SAAS,EAAE,MAAM,CAAM;IAEvB;;;;OAIG;IAEH,YAAY,EAAE,MAAM,CAAM;IAG1B,QAAQ,EAAE,MAAM,CAAQ;IAExB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAItC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlD;AAED,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IAClF,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAAsB;IAEhD,wEAAwE;IAClE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAO5D,qDAAqD;IAC/C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAKxE,sEAAsE;IAChE,cAAc,CAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAOtC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/models/support-plan.d.ts

@@ -0,0 +1,92 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { CoverageWindow, EscalationStep, ServiceTargetMinutes, SeverityDefinition, TimeApprovalPolicy } from '../types.js';
+/** Default target minutes applied when a plan omits a severity's targets. */
+export declare const DEFAULT_TARGET_MINUTES: ServiceTargetMinutes;
+export declare class SupportPlan extends SmrtObject {
+    tenantId: string | null;
+    /** Natural key, unique per tenant (`conflictColumns`). */
+    planKey: string;
+    /** Display name (inherited `name` field). */
+    name: string;
+    description: string;
+    /** `draft` | `active` | `archived`. */
+    status: string;
+    /** Channels this plan covers (JSON array of channel kinds). */
+    channels: string;
+    /** IANA timezone the coverage calendar is expressed in. */
+    timezone: string;
+    /**
+     * Coverage calendar: JSON array of {@link CoverageWindow}. Empty array
+     * means 24×7 coverage (clocks always run).
+     */
+    coverage: string;
+    /** Holiday dates excluded from coverage (JSON array of `YYYY-MM-DD`). */
+    holidays: string;
+    /**
+     * Severity vocabulary for this plan: JSON map of severity key →
+     * {@link SeverityDefinition}. Empty object falls back to
+     * `DEFAULT_SEVERITY_DEFINITIONS`.
+     */
+    severityDefinitions: string;
+    /**
+     * Service Targets per severity: JSON map of severity key →
+     * {@link ServiceTargetMinutes}. Missing severities fall back to
+     * `DEFAULT_TARGET_MINUTES`; explicit `null` minutes disable that clock.
+     */
+    targets: string;
+    /**
+     * Case statuses that pause Service Target clocks (FR-29b: waiting periods
+     * pause clocks only when the plan says so). JSON array of statuses.
+     */
+    pauseStatuses: string;
+    /** Escalation policy: JSON array of {@link EscalationStep}, level order. */
+    escalationPolicy: string;
+    /** Recurring availability/retainer fee (0.0 = pure hourly support). */
+    availabilityFeeAmount: number;
+    currency: string;
+    /** Included support minutes per period (0 = none included). */
+    includedMinutes: number;
+    /** Metered hourly rate for time beyond the included minutes. */
+    overageHourlyRate: number;
+    /** Premium hourly rate for on-call work (0.0 = use overage rate). */
+    onCallHourlyRate: number;
+    /**
+     * Time-entry approval policy for work under this plan (FR-36): JSON
+     * {@link TimeApprovalPolicy}. Empty object = operator approval.
+     */
+    timeApprovalPolicy: string;
+    /** Optional `@happyvertical/smrt-subscriptions` plan natural key binding. */
+    subscriptionPlanKey: string;
+    metadata: string;
+    getChannels(): string[];
+    setChannels(channels: string[]): void;
+    getCoverage(): CoverageWindow[];
+    setCoverage(windows: CoverageWindow[]): void;
+    getHolidays(): string[];
+    setHolidays(dates: string[]): void;
+    getSeverityDefinitions(): Record<string, SeverityDefinition>;
+    setSeverityDefinitions(defs: Record<string, SeverityDefinition>): void;
+    getTargets(): Record<string, Partial<ServiceTargetMinutes>>;
+    setTargets(targets: Record<string, Partial<ServiceTargetMinutes>>): void;
+    /** Effective target minutes for a severity, with defaults applied. */
+    targetsForSeverity(severity: string): ServiceTargetMinutes;
+    getPauseStatuses(): string[];
+    setPauseStatuses(statuses: string[]): void;
+    getEscalationPolicy(): EscalationStep[];
+    setEscalationPolicy(steps: EscalationStep[]): void;
+    getTimeApprovalPolicy(): TimeApprovalPolicy;
+    setTimeApprovalPolicy(policy: TimeApprovalPolicy): void;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+    /**
+     * The plan terms captured onto a case at apply time (`planSnapshot`), so
+     * later plan edits never rewrite the terms a case was handled under.
+     */
+    snapshotTerms(): Record<string, unknown>;
+}
+export declare class SupportPlanCollection extends SmrtCollection<SupportPlan> {
+    static readonly _itemClass: typeof SupportPlan;
+    byPlanKey(planKey: string): Promise<SupportPlan | null>;
+}
+export default SupportPlan;
+//# sourceMappingURL=support-plan.d.ts.map

package/dist/models/support-plan.d.ts.map

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