@actuarial-ts/data 0.3.0 → 0.5.0

package/README.md

@@ -1,19 +1,33 @@
 # @actuarial-ts/data
 
 Data ingestion and ASOP No. 23 data-quality review for the
-[actuarial-ts](../core) SDK. Pure functions, zero runtime dependencies
-(besides `@actuarial-ts/core`), fully typed.
+[actuarial-ts](../core) SDK. Pure functions, fully typed, with runtime schemas
+at object boundaries.
 
 - `parseCsv(text)` — minimal RFC 4180-subset CSV parser (quoted fields,
-  escaped quotes, embedded commas/newlines, BOM, CRLF/LF).
+  escaped quotes, embedded commas/newlines, BOM, CRLF/LF); the result's
+  `rowLines` gives each row's 1-based physical start line in the file.
 - `parseLossRunCsv(text)` — loss-run import to `ClaimSnapshot[]` with
-  per-row validation errors (1-based row numbers including the header).
+  per-row validation errors (errors cite 1-based physical file lines,
+  header = line 1).
+- `annualDevelopmentToClaimSnapshots(rows, options)` — converts claim
+  valuations known only to annual precision without hiding the derived-date,
+  report-year, or duplicate-row conventions.
+- `parseExposureCsv(text)` — imports earned premium and/or exposure units by
+  origin; extra source measures remain extra rather than being relabeled.
 - `triangleFromLongFormat(rows, { kind })` — pivots long-format
   `(origin, age, value)` rows into a `Triangle`.
 - `reviewClaimData(claims, { asOfDate? })` / `reviewTriangles(paid, incurred)`
   — the ASOP No. 23-oriented review; every check performed is listed in the
   report, pass or fail, so the actuary's disclosure can state what WAS
   reviewed, not just what was found.
+- `validateDiagnosticDataset(value)` /
+  `validateAndReconcileDiagnosticExposures(value)` /
+  `runValidatedMetricDiagnostics(...)` — Zod-validated boundaries plus
+  stable-key exposure reconciliation for generic diagnostic rows.
+- `reviewDiagnosticData(snapshots, exposures, options)` — quarterly aggregate,
+  exposure, layer, grouping, and cached-formula checks using the same
+  `DataReviewReport` status contract, with optional structured finding context.
 
 ## Checks
 
@@ -57,6 +71,74 @@ const { paid, incurred } = buildTriangles(claims, {
 const triangleReview = reviewTriangles(paid, incurred);
 ```
 
+### Annual-precision claim data
+
+Do not label a source year as an exact accident or evaluation date. Normalize
+the source fields to annual rows, then let the adapter derive calendar-year-end
+compatibility dates and return the convention as a disclosure finding:
+
+```ts
+import { annualDevelopmentToClaimSnapshots } from "@actuarial-ts/data";
+
+const conversion = annualDevelopmentToClaimSnapshots(
+  [{
+    claimId: "1995-000001",
+    originYear: 1995,
+    evaluationYear: 1996,
+    paidToDate: 100,
+    incurredToDate: 140,
+    status: "open",
+  }],
+  { duplicatePolicy: "reject" },
+);
+
+console.log(conversion.conventions.derivedDateConvention); // calendar-year-end
+console.log(conversion.findings); // date and inferred-report-year disclosures
+```
+
+The default duplicate policy is `reject`. Selecting `combine` is an explicit
+judgment: same-claim/same-year paid and incurred values are summed, and the
+combined record is open if any component is open. The adapter reports how many
+groups and rows were combined.
+
+### Exposure data
+
+`parseExposureCsv` requires `origin` plus `earned_premium`, `exposure_units`,
+or both. Each numeric measure may be blank independently. For example, a
+source containing insurance-years and gross written premium should expose only
+the insurance-years to the SDK unless an earned-premium transformation has
+actually been performed:
+
+```csv
+origin,exposure_units,gross_written_premium
+2024,125000,42000000
+```
+
+The extra GWP column is retained in the source file but ignored by the parser;
+it is never silently loaded as `earnedPremium`.
+
+### Quarterly diagnostic review
+
+`reviewDiagnosticData` lists all 19 stable codes in
+`DIAGNOSTIC_REVIEW_CHECK_CODES`. The suite covers duplicate aggregate and
+exposure keys; invalid or mismatched development ages; valuation-before-origin;
+count identities; paid/incurred and cumulative movement checks; reopen
+signals; layer ordering and control totals; both sides of the loss/exposure
+join; zero/incomplete exposure; grouping consistency; and lightweight cached
+formula provenance.
+
+The existing `DataCheck.details: string[]` field is unchanged. New checks also
+populate `DataCheck.findings` with optional `origin`, `valuation`, `ageMonths`,
+`group`, `sourceFile`, and `sourceRow` context so consumers need not parse
+prose. Severities and numeric tolerances are caller-configurable. Optional
+checks without configuration report `not-evaluated`, never a misleading pass.
+
+For unknown objects, call `validateDiagnosticDataset` (or the convenience
+`runValidatedMetricDiagnostics`) before the core analysis. For workbook input,
+extract rows with the host's spreadsheet tooling and pass cached formula
+metadata to the review; this package deliberately does not add a heavyweight
+XLSX dependency.
+
 These utilities are designed to support the actuary's compliance with
 ASOP No. 23; responsibility for compliance remains with the credentialed
 actuary.

package/dist/annualDevelopment.d.ts

@@ -0,0 +1,94 @@
+import type { ClaimSnapshot } from "@actuarial-ts/core";
+import { z } from "zod";
+/**
+ * A claim valuation known only to annual precision.
+ *
+ * `incurredToDate` is deliberately named for the interpretation already made
+ * by the caller. Source-specific adapters must document how their fields were
+ * mapped to paid and incurred before calling this function.
+ */
+export declare const annualClaimDevelopmentRowSchema: z.ZodEffects<z.ZodObject<{
+    claimId: z.ZodString;
+    originYear: z.ZodNumber;
+    reportYear: z.ZodOptional<z.ZodNumber>;
+    evaluationYear: z.ZodNumber;
+    paidToDate: z.ZodNumber;
+    incurredToDate: z.ZodNumber;
+    status: z.ZodEnum<["open", "closed"]>;
+}, "strict", z.ZodTypeAny, {
+    claimId: string;
+    originYear: number;
+    evaluationYear: number;
+    paidToDate: number;
+    incurredToDate: number;
+    status: "open" | "closed";
+    reportYear?: number | undefined;
+}, {
+    claimId: string;
+    originYear: number;
+    evaluationYear: number;
+    paidToDate: number;
+    incurredToDate: number;
+    status: "open" | "closed";
+    reportYear?: number | undefined;
+}>, {
+    claimId: string;
+    originYear: number;
+    evaluationYear: number;
+    paidToDate: number;
+    incurredToDate: number;
+    status: "open" | "closed";
+    reportYear?: number | undefined;
+}, {
+    claimId: string;
+    originYear: number;
+    evaluationYear: number;
+    paidToDate: number;
+    incurredToDate: number;
+    status: "open" | "closed";
+    reportYear?: number | undefined;
+}>;
+export type AnnualClaimDevelopmentRow = z.infer<typeof annualClaimDevelopmentRowSchema>;
+export type AnnualDuplicatePolicy = "reject" | "combine";
+export interface AnnualDevelopmentOptions {
+    /**
+     * Same-claim, same-year records are ambiguous. The safe default rejects
+     * them. `combine` treats them as components of one dollar stream: paid and
+     * incurred are summed and the combined record is open when any component is
+     * open. The returned finding makes that judgment visible.
+     */
+    duplicatePolicy?: AnnualDuplicatePolicy;
+}
+export type AnnualDevelopmentFindingCode = "annual-dates-derived" | "report-year-inferred" | "duplicate-snapshots-combined";
+export interface AnnualDevelopmentFinding {
+    code: AnnualDevelopmentFindingCode;
+    severity: "disclosure" | "warning";
+    message: string;
+    affectedClaims?: number;
+    affectedGroups?: number;
+    affectedRows?: number;
+}
+export interface AnnualDevelopmentConventions {
+    sourceDatePrecision: "year";
+    derivedDateConvention: "calendar-year-end";
+    missingReportYearConvention: "earliest-evaluation-year";
+    duplicatePolicy: AnnualDuplicatePolicy;
+}
+export interface AnnualDevelopmentConversion {
+    claims: ClaimSnapshot[];
+    findings: AnnualDevelopmentFinding[];
+    conventions: AnnualDevelopmentConventions;
+    sourceRowCount: number;
+}
+/**
+ * Converts year-precision claim valuations into the exact-date
+ * `ClaimSnapshot` contract without pretending the source supplied exact
+ * dates. Every derived date uses calendar year-end, and the convention is
+ * returned alongside the claims for disclosure.
+ *
+ * Missing report years are inferred as the earliest evaluation year for the
+ * claim. Duplicate claim/evaluation-year rows are rejected unless the caller
+ * explicitly selects the auditable `combine` policy.
+ */
+export declare function annualDevelopmentToClaimSnapshots(input: readonly AnnualClaimDevelopmentRow[], options?: AnnualDevelopmentOptions): AnnualDevelopmentConversion;
+//# sourceMappingURL=annualDevelopment.d.ts.map

package/dist/annualDevelopment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annualDevelopment.d.ts","sourceRoot":"","sources":["../src/annualDevelopment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCxC,CAAC;AAEL,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAMD,MAAM,MAAM,4BAA4B,GACpC,sBAAsB,GACtB,sBAAsB,GACtB,8BAA8B,CAAC;AAEnC,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,4BAA4B,CAAC;IACnC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,mBAAmB,CAAC;IAC3C,2BAA2B,EAAE,0BAA0B,CAAC;IACxD,eAAe,EAAE,qBAAqB,CAAC;CACxC;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,WAAW,EAAE,4BAA4B,CAAC;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,SAAS,yBAAyB,EAAE,EAC3C,OAAO,GAAE,wBAA6B,GACrC,2BAA2B,CAyJ7B"}

package/dist/annualDevelopment.js

@@ -0,0 +1,188 @@
+import { ReservingError } from "@actuarial-ts/core";
+import { z } from "zod";
+/**
+ * A claim valuation known only to annual precision.
+ *
+ * `incurredToDate` is deliberately named for the interpretation already made
+ * by the caller. Source-specific adapters must document how their fields were
+ * mapped to paid and incurred before calling this function.
+ */
+export const annualClaimDevelopmentRowSchema = z
+    .object({
+    claimId: z.string().trim().min(1),
+    originYear: z.number().int().min(1).max(9999),
+    reportYear: z.number().int().min(1).max(9999).optional(),
+    evaluationYear: z.number().int().min(1).max(9999),
+    paidToDate: z.number().finite(),
+    incurredToDate: z.number().finite(),
+    status: z.enum(["open", "closed"]),
+})
+    .strict()
+    .superRefine((row, ctx) => {
+    if (row.evaluationYear < row.originYear) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["evaluationYear"],
+            message: "evaluationYear must not precede originYear",
+        });
+    }
+    if (row.reportYear !== undefined && row.reportYear < row.originYear) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["reportYear"],
+            message: "reportYear must not precede originYear",
+        });
+    }
+    if (row.reportYear !== undefined && row.evaluationYear < row.reportYear) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["evaluationYear"],
+            message: "evaluationYear must not precede reportYear",
+        });
+    }
+});
+const annualDevelopmentOptionsSchema = z
+    .object({ duplicatePolicy: z.enum(["reject", "combine"]).default("reject") })
+    .strict();
+function yearEnd(year) {
+    return `${String(year).padStart(4, "0")}-12-31`;
+}
+function issueMessage(error) {
+    return error.issues
+        .map((issue) => {
+        const path = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
+        return `${path}${issue.message}`;
+    })
+        .join("; ");
+}
+/**
+ * Converts year-precision claim valuations into the exact-date
+ * `ClaimSnapshot` contract without pretending the source supplied exact
+ * dates. Every derived date uses calendar year-end, and the convention is
+ * returned alongside the claims for disclosure.
+ *
+ * Missing report years are inferred as the earliest evaluation year for the
+ * claim. Duplicate claim/evaluation-year rows are rejected unless the caller
+ * explicitly selects the auditable `combine` policy.
+ */
+export function annualDevelopmentToClaimSnapshots(input, options = {}) {
+    const parsedOptions = annualDevelopmentOptionsSchema.safeParse(options);
+    if (!parsedOptions.success) {
+        throw new ReservingError("UNSUPPORTED_VALUE", `Invalid annual development options: ${issueMessage(parsedOptions.error)}`);
+    }
+    const { duplicatePolicy } = parsedOptions.data;
+    const rows = input.map((candidate, inputIndex) => {
+        const parsed = annualClaimDevelopmentRowSchema.safeParse(candidate);
+        if (!parsed.success) {
+            throw new ReservingError("SHAPE", `Annual claim development row ${inputIndex + 1}: ${issueMessage(parsed.error)}`);
+        }
+        return parsed.data;
+    });
+    const byClaim = new Map();
+    for (const row of rows) {
+        const existing = byClaim.get(row.claimId);
+        if (existing === undefined) {
+            byClaim.set(row.claimId, {
+                originYear: row.originYear,
+                reportYears: new Set(row.reportYear === undefined ? [] : [row.reportYear]),
+                rows: [row],
+            });
+            continue;
+        }
+        if (existing.originYear !== row.originYear) {
+            throw new ReservingError("SHAPE", `Claim ${row.claimId} has conflicting origin years ${existing.originYear} and ${row.originYear}`);
+        }
+        if (row.reportYear !== undefined)
+            existing.reportYears.add(row.reportYear);
+        existing.rows.push(row);
+    }
+    const findings = [
+        {
+            code: "annual-dates-derived",
+            severity: "disclosure",
+            affectedRows: rows.length,
+            message: "The source supplies calendar years, not exact dates; accident, report and evaluation dates were derived at calendar year-end.",
+        },
+    ];
+    const claims = [];
+    let inferredReportYears = 0;
+    let duplicateGroups = 0;
+    let duplicateRows = 0;
+    for (const [claimId, group] of byClaim) {
+        if (group.reportYears.size > 1) {
+            throw new ReservingError("SHAPE", `Claim ${claimId} has conflicting report years ${[...group.reportYears].sort((a, b) => a - b).join(", ")}`);
+        }
+        const firstEvaluationYear = group.rows.reduce((earliest, row) => Math.min(earliest, row.evaluationYear), group.rows[0].evaluationYear);
+        const suppliedReportYear = group.reportYears.values().next().value;
+        const reportYear = suppliedReportYear ?? firstEvaluationYear;
+        if (suppliedReportYear === undefined)
+            inferredReportYears += 1;
+        if (reportYear > firstEvaluationYear) {
+            throw new ReservingError("SHAPE", `Claim ${claimId} has report year ${reportYear} after its first evaluation year ${firstEvaluationYear}`);
+        }
+        const byEvaluationYear = new Map();
+        for (const row of group.rows) {
+            const sameYear = byEvaluationYear.get(row.evaluationYear);
+            if (sameYear === undefined)
+                byEvaluationYear.set(row.evaluationYear, [row]);
+            else
+                sameYear.push(row);
+        }
+        for (const evaluationYear of [...byEvaluationYear.keys()].sort((a, b) => a - b)) {
+            const sameYear = byEvaluationYear.get(evaluationYear);
+            if (sameYear.length > 1) {
+                duplicateGroups += 1;
+                duplicateRows += sameYear.length;
+                if (duplicatePolicy === "reject") {
+                    throw new ReservingError("SHAPE", `Claim ${claimId} has ${sameYear.length} snapshots in evaluation year ${evaluationYear}; choose duplicatePolicy "combine" only after reviewing the source ambiguity`);
+                }
+            }
+            const paidToDate = sameYear.reduce((sum, row) => sum + row.paidToDate, 0);
+            const incurredToDate = sameYear.reduce((sum, row) => sum + row.incurredToDate, 0);
+            const caseReserve = incurredToDate - paidToDate;
+            if (!Number.isFinite(paidToDate) ||
+                !Number.isFinite(incurredToDate) ||
+                !Number.isFinite(caseReserve)) {
+                throw new ReservingError("SHAPE", `Claim ${claimId} evaluation year ${evaluationYear}: combined paid, incurred, and case reserve must remain finite`);
+            }
+            claims.push({
+                claimId,
+                accidentDate: yearEnd(group.originYear),
+                reportDate: yearEnd(reportYear),
+                evaluationDate: yearEnd(evaluationYear),
+                paidToDate,
+                caseReserve,
+                status: sameYear.some((row) => row.status === "open") ? "open" : "closed",
+            });
+        }
+    }
+    if (inferredReportYears > 0) {
+        findings.push({
+            code: "report-year-inferred",
+            severity: "disclosure",
+            affectedClaims: inferredReportYears,
+            message: "Report year was absent and was inferred as each claim's earliest evaluation year.",
+        });
+    }
+    if (duplicateGroups > 0) {
+        findings.push({
+            code: "duplicate-snapshots-combined",
+            severity: "warning",
+            affectedGroups: duplicateGroups,
+            affectedRows: duplicateRows,
+            message: "Same-claim, same-year rows were combined by summing paid and incurred; the combined status is open when any component is open.",
+        });
+    }
+    return {
+        claims,
+        findings,
+        conventions: {
+            sourceDatePrecision: "year",
+            derivedDateConvention: "calendar-year-end",
+            missingReportYearConvention: "earliest-evaluation-year",
+            duplicatePolicy,
+        },
+        sourceRowCount: rows.length,
+    };
+}
+//# sourceMappingURL=annualDevelopment.js.map

package/dist/annualDevelopment.js.map

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

package/dist/csv.d.ts

@@ -4,7 +4,9 @@
  * Supported: comma delimiter, quoted fields, doubled quotes ("") as escaped
  * quotes inside quoted fields, commas and newlines inside quoted fields,
  * CRLF and LF row endings, a leading UTF-8 BOM, and a tolerated trailing
- * newline. Lines that are completely empty outside quotes are skipped.
+ * newline. Lines that are completely empty outside quotes are skipped —
+ * skipped lines still advance the physical line count reported in
+ * `rowLines`, so later rows' reported start lines stay correct.
  *
  * Deliberately NOT here: header handling, type coercion, and shape
  * validation. Ragged rows are preserved as-is — validation is the caller's
@@ -13,6 +15,14 @@
 export interface CsvParseResult {
     /** The parsed grid (rows x columns). Ragged rows preserved as-is. */
     rows: string[][];
+    /**
+     * Physical 1-based line number in the input where each row of `rows`
+     * STARTS. Parallel to `rows`. Differs from index+1 whenever blank lines
+     * were skipped or a quoted field contains newlines — callers reporting
+     * row-level problems must use this, not the grid index, or their
+     * diagnostics point at the wrong line of the file.
+     */
+    rowLines: number[];
     /**
      * Structural problems the parser recovered from. Content is still parsed
      * leniently — a warning here means the OUTPUT may not mean what the file's

package/dist/csv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAwFrD"}
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA6FrD"}

package/dist/csv.js

@@ -4,7 +4,9 @@
  * Supported: comma delimiter, quoted fields, doubled quotes ("") as escaped
  * quotes inside quoted fields, commas and newlines inside quoted fields,
  * CRLF and LF row endings, a leading UTF-8 BOM, and a tolerated trailing
- * newline. Lines that are completely empty outside quotes are skipped.
+ * newline. Lines that are completely empty outside quotes are skipped —
+ * skipped lines still advance the physical line count reported in
+ * `rowLines`, so later rows' reported start lines stay correct.
  *
  * Deliberately NOT here: header handling, type coercion, and shape
  * validation. Ragged rows are preserved as-is — validation is the caller's
@@ -16,12 +18,14 @@ export function parseCsv(text) {
     if (s.length > 0 && s.charCodeAt(0) === 0xfeff)
         s = s.slice(1);
     const rows = [];
+    const rowLines = [];
     const warnings = [];
     let row = [];
     let field = "";
     let inQuotes = false;
     let fieldWasQuoted = false;
     let line = 1;
+    let rowStartLine = 1;
     let quoteOpenedAtLine = 0;
     const endField = () => {
         row.push(field);
@@ -35,6 +39,7 @@ export function parseCsv(text) {
             return;
         endField();
         rows.push(row);
+        rowLines.push(rowStartLine);
         row = [];
     };
     let i = 0;
@@ -74,12 +79,14 @@ export function parseCsv(text) {
                 i++;
             endRow();
             line++;
+            rowStartLine = line;
             i++;
             continue;
         }
         if (ch === "\n") {
             endRow();
             line++;
+            rowStartLine = line;
             i++;
             continue;
         }
@@ -96,6 +103,6 @@ export function parseCsv(text) {
             "input was consumed into a single field; check the file for a stray or unescaped quote");
     }
     endRow();
-    return { rows, warnings };
+    return { rows, rowLines, warnings };
 }
 //# sourceMappingURL=csv.js.map

package/dist/csv.js.map

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

package/dist/diagnosticInput.d.ts

@@ -0,0 +1,14 @@
+import { type DiagnosticExposureRow, type DiagnosticLossRow, type MetricDiagnosticsResult, type ReconciledDiagnosticExposures, type RunMetricDiagnosticsInput } from "@actuarial-ts/core";
+export interface ValidatedDiagnosticDataset {
+    losses: DiagnosticLossRow[];
+    /** Omitted when the caller did not supply exposure data. */
+    exposures?: DiagnosticExposureRow[];
+}
+/** Zod-validates unknown diagnostic rows at the data package boundary. */
+export declare function validateDiagnosticDataset(value: unknown): ValidatedDiagnosticDataset;
+/** Validates unknown exposure rows, then applies core's stable-key reconciliation. */
+export declare function validateAndReconcileDiagnosticExposures(value: unknown): ReconciledDiagnosticExposures;
+export type ValidatedMetricDiagnosticsOptions = Omit<RunMetricDiagnosticsInput, "losses" | "exposures">;
+/** Convenience boundary: validate unknown rows, then run the dependency-free core engine. */
+export declare function runValidatedMetricDiagnostics(dataset: unknown, options: ValidatedMetricDiagnosticsOptions): MetricDiagnosticsResult;
+//# sourceMappingURL=diagnosticInput.d.ts.map

package/dist/diagnosticInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticInput.d.ts","sourceRoot":"","sources":["../src/diagnosticInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC/B,MAAM,oBAAoB,CAAC;AA+B5B,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CAYpF;AAED,sFAAsF;AACtF,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,OAAO,GACb,6BAA6B,CAG/B;AAED,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC,yBAAyB,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;AAExG,6FAA6F;AAC7F,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,iCAAiC,GACzC,uBAAuB,CAGzB"}

package/dist/diagnosticInput.js

@@ -0,0 +1,51 @@
+import { ReservingError, reconcileDiagnosticExposureKeys, runMetricDiagnostics, } from "@actuarial-ts/core";
+import { z } from "zod";
+const measuresSchema = z.record(z.number().nullable());
+const diagnosticLossRowSchema = z.object({
+    id: z.string().min(1),
+    group: z.string().min(1),
+    origin: z.string().min(1),
+    valuation: z.string().min(1),
+    ageMonths: z.number(),
+    policyPeriod: z.string().min(1).optional(),
+    dimensions: z.unknown().optional(),
+    measures: measuresSchema,
+}).strict();
+const diagnosticExposureRowSchema = z.object({
+    key: z.string().min(1),
+    group: z.string().min(1),
+    origin: z.string().min(1),
+    valuation: z.string().min(1).optional(),
+    measures: measuresSchema,
+    complete: z.boolean().optional(),
+    dimensions: z.unknown().optional(),
+}).strict();
+const diagnosticDatasetSchema = z.object({
+    losses: z.array(diagnosticLossRowSchema),
+    exposures: z.array(diagnosticExposureRowSchema).optional(),
+}).strict();
+/** Zod-validates unknown diagnostic rows at the data package boundary. */
+export function validateDiagnosticDataset(value) {
+    const parsed = diagnosticDatasetSchema.safeParse(value);
+    if (!parsed.success) {
+        const details = parsed.error.issues
+            .map((issue) => `${issue.path.length > 0 ? issue.path.join(".") : "$"}: ${issue.message}`)
+            .join("; ");
+        throw new ReservingError("SHAPE", `Invalid diagnostic dataset: ${details}`);
+    }
+    return {
+        losses: parsed.data.losses,
+        ...(parsed.data.exposures !== undefined ? { exposures: parsed.data.exposures } : {}),
+    };
+}
+/** Validates unknown exposure rows, then applies core's stable-key reconciliation. */
+export function validateAndReconcileDiagnosticExposures(value) {
+    const validated = validateDiagnosticDataset({ losses: [], exposures: value });
+    return reconcileDiagnosticExposureKeys(validated.exposures ?? []);
+}
+/** Convenience boundary: validate unknown rows, then run the dependency-free core engine. */
+export function runValidatedMetricDiagnostics(dataset, options) {
+    const validated = validateDiagnosticDataset(dataset);
+    return runMetricDiagnostics({ ...options, ...validated });
+}
+//# sourceMappingURL=diagnosticInput.js.map

package/dist/diagnosticInput.js.map

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