trainbud 0.5.0

package/dist/promptApi.js

@@ -0,0 +1,328 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { getProfile } from "./profile.js";
+import { recordAiUsage, assertWithinBudget, } from "./usage.js";
+import { randomBytes } from "node:crypto";
+import { DateTime } from "luxon";
+import { createPromptJob, deleteSetting, getPromptJob, getSetting, listSettingKeys, setSetting, updatePromptJob, } from "./appDb.js";
+import { appConfig } from "./config.js";
+import { buildWatchSummary } from "./watchApi.js";
+import { describeFindingsCoverage, runDetectors } from "./detect/index.js";
+import { activeContext } from "./history/context.js";
+import { logger } from "./utils/logger.js";
+// SECTION: Prompt API — Claude integration
+// The model and the answer length are no longer constants here. Both are
+// profile settings now (`ai.model`, `ai.length`), because the person paying for
+// the tokens is the person who should decide how many of them to buy. The
+// default is still the cheapest current model, for the same reason it always
+// was: these answers are two or three sentences read on a watch.
+const INSIGHT_PREFIX = "daily_insight:";
+/**
+ * The dashboard writes the key to the settings table, but the server only
+ * copied it into process.env at startup — so a key saved from the dashboard did
+ * nothing until the server was restarted. Resolving on every call fixes that.
+ * The stored value wins because it is the one the user set most recently
+ * through the UI; the environment is the fallback for headless setups.
+ */
+function resolveAnthropicKey() {
+    return getSetting("anthropic_api_key") ?? appConfig.anthropicApiKey ?? "";
+}
+/** True when AI features are usable, from either source. */
+export function isAiConfigured() {
+    return resolveAnthropicKey().length > 0;
+}
+function buildJobId() {
+    return randomBytes(12).toString("hex");
+}
+/**
+ * What the model is told before it writes a sentence.
+ *
+ * This used to be four current numbers, which is why the daily insight read
+ * like a horoscope: with nothing but today's figures there was nothing to say
+ * that the numbers did not already say themselves. Findings refer to things
+ * that happened -- a run of days, a deficit against a personal median -- and
+ * context says who it is happening to.
+ *
+ * Cold start is stated explicitly. Handed an empty findings list with no
+ * explanation, a model will confidently reassure the user out of no data at all.
+ */
+export function formatFindingsContext(result, context) {
+    const lines = [];
+    // The same three-way classification every other surface reads. It used to be
+    // re-derived here from `staleDays > 3`, which is how three sibling surfaces
+    // went on printing the cold-start sentence at a 74-day store: the knowledge
+    // lived in one `if` in one file.
+    const coverageState = describeFindingsCoverage(result.coverage).state;
+    if (coverageState === "stale") {
+        // The record has plenty of days and stops weeks ago. Saying "nothing stands
+        // out" here is a claim about days that were never recorded, and it is the
+        // single most misleading thing this prompt can contain: the model repeats it
+        // as reassurance.
+        lines.push(`The stored record has ${result.coverage.days} days but ENDS ON ${result.coverage.throughDate}, which is ${result.coverage.staleDays} days ago. Nothing is known about the days since. Do not reassure the user that things look fine, and do not describe today: say the record is out of date and that running \`trainbud backfill\` will bring it current.`);
+    }
+    else if (coverageState === "cold") {
+        lines.push(`Still gathering data: only ${result.coverage.days} days of history are stored, which is not yet enough to compare anything against a baseline. Say so rather than reassuring the user.`);
+    }
+    else if (result.findings.length === 0) {
+        lines.push(`Across ${result.coverage.days} days of history, nothing stands out against this user's own baselines.`);
+    }
+    else {
+        lines.push(`What stands out, from ${result.coverage.days} days of history:`);
+        for (const finding of result.findings) {
+            lines.push(`- [${finding.severity}] ${finding.headline}`);
+        }
+    }
+    if (context.length === 0) {
+        lines.push("Nothing on record about this user's goals, races or injuries.");
+    }
+    else {
+        lines.push("On record about this user:");
+        for (const entry of context) {
+            lines.push(`- ${entry.kind}: ${entry.text}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatHealthContext(summary) {
+    const lines = [];
+    if (summary.recovery) {
+        lines.push(`- Recovery: ${summary.recovery.score}/100 (${summary.recovery.label})`);
+    }
+    if (summary.sleep) {
+        lines.push(`- Sleep last night: ${summary.sleep.hours}h${summary.sleep.score ? `, score ${summary.sleep.score}` : ""} (${summary.sleep.label})`);
+    }
+    if (summary.stress) {
+        lines.push(`- Avg stress (7d): ${summary.stress.avg} (${summary.stress.label})`);
+    }
+    if (summary.vo2max) {
+        lines.push(`- VO2 Max: ${summary.vo2max.value} (${summary.vo2max.trend})`);
+    }
+    if (summary.heart_rate) {
+        lines.push(`- Resting HR: ${summary.heart_rate.resting} bpm`);
+    }
+    if (summary.activity) {
+        lines.push(`- Last activity: ${summary.activity.name}${summary.activity.duration_min ? `, ${summary.activity.duration_min}min` : ""}${summary.activity.distance_km ? `, ${summary.activity.distance_km}km` : ""}`);
+    }
+    // The week and the calendar, which change what today's numbers mean.
+    //
+    // Without these the model answers every question as though the user exists
+    // only today: a falling load ratio reads as detraining even when it is a
+    // deliberate taper, and "should I train today" gets the same answer three
+    // days before a race as it does in January. Both facts are in the store and
+    // neither was ever passed to the model.
+    if (summary.week && summary.week.ready) {
+        const week = summary.week;
+        const parts = [`${week.sessions} session(s) this week vs ${week.previous_sessions} last week`];
+        if (week.load_delta_pct !== null) {
+            parts.push(`training load ${week.load_delta_pct >= 0 ? "up" : "down"} ${Math.abs(week.load_delta_pct)}%`);
+        }
+        if (week.forecast_verdict !== "unknown" && week.forecast_ratio !== null) {
+            parts.push(`if this week repeats, the acute:chronic load ratio lands at ${week.forecast_ratio} (${week.forecast_verdict.replace(/_/g, " ")})`);
+        }
+        if (week.sleep_debt_h !== null && Math.abs(week.sleep_debt_h) >= 1) {
+            parts.push(`${Math.abs(week.sleep_debt_h)}h of sleep ${week.sleep_debt_h > 0 ? "debt" : "surplus"} against their own usual night`);
+        }
+        if (week.sleep_consistency !== "unknown" && week.sleep_consistency !== "steady") {
+            parts.push(`sleep timing is ${week.sleep_consistency}`);
+        }
+        lines.push(`- This week: ${parts.join("; ")}.`);
+    }
+    if (summary.race) {
+        lines.push(`- Next race: ${summary.race.text} in ${summary.race.days_away} day(s). Training phase: ${summary.race.phase.replace(/_/g, " ")}. A falling load in a taper is intended, not a lapse.`);
+    }
+    // An empty section headed "Current health snapshot:" is worse than no section.
+    //
+    // Every field above comes from a live Garmin call, and when that call fails --
+    // an expired session, a rate limit, no network -- all of them are null. The
+    // header was printed unconditionally, so the model received a heading with
+    // nothing under it and correctly concluded it had been given no data about the
+    // user. What the user then reads is "the AI cannot see my data", which is true,
+    // and infers "the app is broken", which is a different thing from "Garmin did
+    // not answer just now".
+    //
+    // Say which it is, and point the model at the stored history above, which is
+    // real and still worth reasoning about.
+    if (lines.length === 0) {
+        return [
+            "No live metrics are available right now: the request to Garmin did not return today's figures. This is a connection problem, not an absence of data about this user.",
+            "Say that today's numbers could not be fetched, then answer from the stored history above if it supports an answer. Never invent current values, and do not tell the user you have no access to their data.",
+        ].join("\n");
+    }
+    return ["Current health snapshot:", ...lines].join("\n");
+}
+/**
+ * How the answer should sound, and how long it is allowed to be.
+ *
+ * Length is two settings in one: the sentence instruction the model reads, and
+ * the `max_tokens` ceiling that stops a run-on answer costing more than it is
+ * worth. They have to move together -- raising the ceiling without changing
+ * the instruction just pays for the same three sentences.
+ */
+const LENGTH_SPEC = {
+    short: { sentences: "2-3 short sentences maximum", maxTokens: 300 },
+    normal: { sentences: "4-5 sentences maximum", maxTokens: 500 },
+    detailed: { sentences: "up to two short paragraphs", maxTokens: 900 },
+};
+const TONE_SPEC = {
+    direct: "Be direct and actionable. No hedging, no encouragement padding.",
+    supportive: "Be warm and encouraging while still being specific and honest.",
+    technical: "Use precise physiological terms and name the metric behind each claim.",
+};
+/**
+ * Who the answer is for.
+ *
+ * Everything here comes from the profile rather than from Garmin, because
+ * Garmin has none of it. The same load ratio means something different to a
+ * lifter and a marathoner, and a model told neither will average the two.
+ */
+function audienceContext(profile) {
+    const parts = [];
+    if (profile.displayName) {
+        parts.push(`The user's name is ${profile.displayName}.`);
+    }
+    if (profile.primarySport) {
+        parts.push(`Their primary sport is ${profile.primarySport}.`);
+    }
+    if (profile.weeklyGoal.sessions !== null) {
+        parts.push(`They aim for ${profile.weeklyGoal.sessions} sessions a week.`);
+    }
+    if (profile.weeklyGoal.minutes !== null) {
+        parts.push(`They aim for ${profile.weeklyGoal.minutes} minutes of training a week.`);
+    }
+    parts.push(profile.units === "imperial"
+        ? "Use imperial units (miles, pounds)."
+        : "Use metric units (kilometres, kilograms).");
+    return parts.join(" ");
+}
+async function callClaude(prompt, healthContext, meta) {
+    const apiKey = resolveAnthropicKey();
+    if (!apiKey) {
+        throw new Error("ANTHROPIC_API_KEY not configured. Set it in the dashboard or .env file.");
+    }
+    // The cap is checked before the request, not after it. Recording an
+    // overspend that already happened is bookkeeping; refusing the request is
+    // the feature. No cap set means this never throws.
+    assertWithinBudget();
+    const profile = getProfile();
+    const model = profile.ai.model;
+    const length = LENGTH_SPEC[profile.ai.length];
+    const client = new Anthropic({ apiKey });
+    const message = await client.messages.create({
+        model,
+        max_tokens: length.maxTokens,
+        system: `You are a concise fitness coach assistant shown on a small smartwatch screen.
+Answer in ${length.sentences}. ${TONE_SPEC[profile.ai.tone]} No markdown formatting.
+${audienceContext(profile)}
+Give general training and wellness guidance only. Do not diagnose conditions or give
+medical advice; if asked something medical, say it is outside what you can advise on.
+${healthContext}`,
+        messages: [{ role: "user", content: prompt }],
+    });
+    // Recorded before the content check: the tokens were spent whether or not
+    // the shape of the reply was what this code expected, and a meter that only
+    // counts successes under-reports exactly the calls worth investigating.
+    recordAiUsage({
+        kind: meta.kind,
+        source: meta.source,
+        model,
+        inputTokens: message.usage.input_tokens,
+        outputTokens: message.usage.output_tokens,
+        cacheReadTokens: message.usage.cache_read_input_tokens ?? 0,
+        cacheWriteTokens: message.usage.cache_creation_input_tokens ?? 0,
+    });
+    const block = message.content[0];
+    if (block?.type !== "text") {
+        throw new Error("Unexpected response type from Claude");
+    }
+    return block.text.trim();
+}
+export function submitPrompt(prompt) {
+    const id = buildJobId();
+    createPromptJob(id, prompt);
+    // Fire-and-forget — process asynchronously
+    processPromptJob(id, prompt).catch((err) => {
+        logger.error({ err, id }, "Prompt job processing failed unexpectedly");
+    });
+    return { job_id: id };
+}
+async function processPromptJob(id, prompt) {
+    updatePromptJob(id, { status: "running" });
+    try {
+        const summary = await buildWatchSummary();
+        const detection = runDetectors();
+        const context = activeContext(DateTime.local().toISODate() ?? "");
+        const healthContext = [
+            formatFindingsContext(detection, context),
+            "",
+            formatHealthContext(summary),
+        ].join("\n");
+        const result = await callClaude(prompt, healthContext, { kind: "ask", source: "watch" });
+        updatePromptJob(id, { status: "done", result });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error({ err, id }, "Prompt job failed");
+        updatePromptJob(id, { status: "error", error: message });
+    }
+}
+export function getPromptStatus(id) {
+    const job = getPromptJob(id);
+    if (!job)
+        return null;
+    return {
+        status: job.status,
+        result: job.result ?? undefined,
+        error: job.error ?? undefined,
+    };
+}
+/**
+ * The daily insight used to be generated inline on every /api/watch request, so
+ * a cold fetch blocked the watch for a full Claude round trip and spent API
+ * credit on every sync. It is now generated once per local day and cached in the
+ * settings table.
+ */
+export async function generateDailyInsight(summary, options = {}) {
+    const apiKey = resolveAnthropicKey();
+    if (!apiKey)
+        return null;
+    const cacheKey = `${INSIGHT_PREFIX}${DateTime.local().toISODate()}`;
+    if (!options.force) {
+        const cached = getSetting(cacheKey);
+        if (cached)
+            return cached;
+    }
+    try {
+        // Both: the findings say what changed, the snapshot says where things stand.
+        const detection = runDetectors();
+        const context = activeContext(DateTime.local().toISODate() ?? "");
+        const healthContext = [
+            formatFindingsContext(detection, context),
+            "",
+            formatHealthContext(summary),
+        ].join("\n");
+        const result = await callClaude("Give me one sentence of actionable advice for today. Refer to what actually stands out rather than restating the numbers.", healthContext, { kind: "insight", source: "server" });
+        setSetting(cacheKey, result);
+        pruneOldInsights(cacheKey);
+        return result;
+    }
+    catch (err) {
+        logger.warn({ err }, "Daily insight generation failed");
+        // Fall back to an earlier insight rather than showing nothing on the watch.
+        return getSetting(cacheKey);
+    }
+}
+/** Returns today's cached insight without contacting the API. */
+export function getCachedDailyInsight() {
+    return getSetting(`${INSIGHT_PREFIX}${DateTime.local().toISODate()}`);
+}
+/** Drops today's cached insight so the next request regenerates it. */
+export function clearDailyInsight() {
+    deleteSetting(`${INSIGHT_PREFIX}${DateTime.local().toISODate()}`);
+}
+function pruneOldInsights(keepKey) {
+    for (const key of listSettingKeys(INSIGHT_PREFIX)) {
+        if (key !== keepKey) {
+            deleteSetting(key);
+        }
+    }
+}
+//# sourceMappingURL=promptApi.js.map

package/dist/promptApi.js.map

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

package/dist/promptSuggestions.d.ts

@@ -0,0 +1,16 @@
+import { type DetectionResult } from "./detect/index.js";
+import type { ContextEntry } from "./history/context.js";
+/**
+ * Always exactly five. The watch lays out a fixed menu and a short list would
+ * leave it rendering stale entries from its cache.
+ */
+export declare function buildPromptSuggestions(result: DetectionResult, context?: ContextEntry[], custom?: readonly string[]): string[];
+/**
+ * Exported for the test that keeps every prompt inside the watch's width, and
+ * for the profile schema, which refuses to store a question the menu could
+ * never show. This file owns both numbers: the menu is what they describe.
+ */
+export declare const PROMPT_MAX_LENGTH = 32;
+/** How many the watch draws. Also the cap on how many the user may write. */
+export declare const PROMPT_SLOTS = 5;
+//# sourceMappingURL=promptSuggestions.d.ts.map

package/dist/promptSuggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptSuggestions.d.ts","sourceRoot":"","sources":["../src/promptSuggestions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA0HzD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,YAAY,EAAO,EAC5B,MAAM,GAAE,SAAS,MAAM,EAAO,GAC7B,MAAM,EAAE,CA+BV;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,KAAa,CAAC;AAE5C,6EAA6E;AAC7E,eAAO,MAAM,YAAY,IAAe,CAAC"}

package/dist/promptSuggestions.js

@@ -0,0 +1,141 @@
+import { describeFindingsCoverage } from "./detect/index.js";
+// SECTION: Ask prompts
+//
+// The watch's Ask menu is five hardcoded strings in strings.xml -- "Should I
+// train today?", "Am I overtraining?" -- and they would read exactly the same
+// on an app with no memory at all. Generated from what actually fired they
+// become questions only this app could have known to offer, which makes the
+// menu the demo rather than a nicety.
+//
+// Pure: same input, same five prompts. The watch caches the summary and shows
+// them again from storage, so a list that reshuffled would look like the data
+// had changed when it had not.
+/** Anything longer wraps or clips on a 390 px round screen. */
+const MAX_LENGTH = 32;
+const PROMPT_COUNT = 5;
+const FROM_FINDING = {
+    rhr_elevated: "Why is my resting HR up?",
+    sleep_debt: "How do I clear sleep debt?",
+    hrv_trend_break: "Why is my HRV dropping?",
+    load_ratio_high: "Am I ramping up too fast?",
+    load_ratio_low: "Have I lost fitness?",
+};
+/**
+ * Ordered by how often they are worth asking with nothing else to go on. These
+ * fill the menu out; they never displace a question raised by real data.
+ */
+const GENERIC = [
+    "Should I train today?",
+    "How is my recovery?",
+    "Summarize my week",
+    "How is my sleep trending?",
+    "What should I focus on?",
+];
+const COLD_START = [
+    "How much data do you have?",
+    "What can you tell me yet?",
+    "Should I train today?",
+    "How is my recovery?",
+    "Summarize my week",
+];
+/**
+ * A store with months in it that stopped three weeks ago is not a cold start,
+ * and offering "What can you tell me yet?" to someone with 74 days of history
+ * misdescribes their own data back to them. The useful questions here are about
+ * the record itself and about the period it does cover -- both of which this app
+ * can answer perfectly well without a single live request.
+ */
+const STALE = [
+    "Why is my data out of date?",
+    "How was my last month?",
+    "How is my sleep trending?",
+    "Have I lost fitness?",
+    "What should I focus on?",
+];
+function contextPrompt(entries) {
+    const race = entries.find((entry) => entry.kind === "race");
+    if (race) {
+        return "How is my race prep going?";
+    }
+    const injury = entries.find((entry) => entry.kind === "injury");
+    if (injury) {
+        return "Is my injury affecting this?";
+    }
+    const goal = entries.find((entry) => entry.kind === "goal");
+    if (goal) {
+        return "Am I on track for my goal?";
+    }
+    return null;
+}
+/**
+ * The user's questions, reduced to what the menu can actually show.
+ *
+ * `profile.ts` refuses a blank, an over-wide or a sixth question on write, so
+ * in practice nothing is dropped here. It is done anyway because the watch
+ * payload must not depend on when a stored row happened to be written: this
+ * field existed in the schema from 0.5.0 with nothing reading or validating it,
+ * and a row saved by hand or by an older build still has to render.
+ */
+function usableCustom(custom) {
+    const chosen = [];
+    for (const raw of custom) {
+        const prompt = raw.trim();
+        if (!prompt || prompt.length > MAX_LENGTH || chosen.includes(prompt)) {
+            continue;
+        }
+        chosen.push(prompt);
+        if (chosen.length >= PROMPT_COUNT) {
+            break;
+        }
+    }
+    return chosen;
+}
+function fill(seed, pool) {
+    const chosen = [...seed];
+    for (const candidate of pool) {
+        if (chosen.length >= PROMPT_COUNT) {
+            break;
+        }
+        if (!chosen.includes(candidate)) {
+            chosen.push(candidate);
+        }
+    }
+    return chosen.slice(0, PROMPT_COUNT);
+}
+/**
+ * Always exactly five. The watch lays out a fixed menu and a short list would
+ * leave it rendering stale entries from its cache.
+ */
+export function buildPromptSuggestions(result, context = [], custom = []) {
+    // The user's own questions lead, in every state. A question someone took the
+    // trouble to write is a better use of one of five slots than one this file
+    // guessed -- and on a cold start it is the only question here that is not
+    // about data the app does not have yet.
+    const own = usableCustom(custom);
+    if (!result.coverage.ready) {
+        return fill(own, describeFindingsCoverage(result.coverage).state === "stale" ? STALE : COLD_START);
+    }
+    const fromFindings = result.findings
+        .map((finding) => FROM_FINDING[finding.kind])
+        .filter((prompt) => typeof prompt === "string");
+    const seed = [...own];
+    for (const prompt of fromFindings) {
+        if (!seed.includes(prompt)) {
+            seed.push(prompt);
+        }
+    }
+    const fromContext = contextPrompt(context);
+    if (fromContext && !seed.includes(fromContext)) {
+        seed.push(fromContext);
+    }
+    return fill(seed, GENERIC);
+}
+/**
+ * Exported for the test that keeps every prompt inside the watch's width, and
+ * for the profile schema, which refuses to store a question the menu could
+ * never show. This file owns both numbers: the menu is what they describe.
+ */
+export const PROMPT_MAX_LENGTH = MAX_LENGTH;
+/** How many the watch draws. Also the cap on how many the user may write. */
+export const PROMPT_SLOTS = PROMPT_COUNT;
+//# sourceMappingURL=promptSuggestions.js.map

package/dist/promptSuggestions.js.map

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

package/dist/selfTest.d.ts

@@ -0,0 +1,53 @@
+/** Mirrors Fail.mc on the watch, so both surfaces name a failure the same way. */
+export type ReachClass = "ok" | "unreachable" | "not_server" | "unauthorized" | "refused" | "not_configured";
+export interface CheckLine {
+    name: string;
+    ok: boolean;
+    /** True for something that is not wrong yet but will bite. */
+    warning?: boolean;
+    detail: string;
+    /** The single next action, when there is one. */
+    fix?: string;
+}
+export interface SelfTestResult {
+    reach: ReachClass;
+    publicUrl: string;
+    checks: CheckLine[];
+    ok: boolean;
+}
+export interface ProbeOutcome {
+    reach: ReachClass;
+    status: number | null;
+    contentType: string | null;
+    bodyStart: string;
+    error?: string;
+}
+/**
+ * Fetches `${baseUrl}/health` the way the watch would.
+ *
+ * Injectable fetch so the tests never touch the network -- the previous
+ * generation of tests in this project reached real services and a real
+ * database, and both cost a debugging session.
+ */
+export declare function probePublicUrl(baseUrl: string, fetchImpl?: typeof fetch): Promise<ProbeOutcome>;
+export interface HistoryCoverage {
+    days: number;
+    ready: boolean;
+    throughDate: string | null;
+    staleDays: number;
+}
+/**
+ * Fourteen days is the threshold every detector uses before it will compare a
+ * day against a baseline. Depth alone is not the whole test, and reading only
+ * `days` here reproduced the exact bug `ready` was added to prevent: a store
+ * holding 74 days that stops on 08-21 answered "enough to compare a day against
+ * your own baselines" on 09-03. Every detector then correctly found nothing --
+ * because there was nothing recent to find -- and the one command whose job is
+ * to say what is wrong said everything was fine.
+ *
+ * Extracted so this can be tested without standing up a history database; the
+ * version that shipped the bug was only reachable through one.
+ */
+export declare function describeHistoryCoverage(coverage: HistoryCoverage): CheckLine;
+export declare function runSelfTest(fetchImpl?: typeof fetch): Promise<SelfTestResult>;
+//# sourceMappingURL=selfTest.d.ts.map

package/dist/selfTest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfTest.d.ts","sourceRoot":"","sources":["../src/selfTest.ts"],"names":[],"mappings":"AAsBA,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAClB,IAAI,GACJ,aAAa,GACb,YAAY,GACZ,cAAc,GACd,SAAS,GACT,gBAAgB,CAAC;AAErB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;CACb;AAuBD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,YAAY,CAAC,CA2CvB;AA4CD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAkB5E;AAED,wBAAsB,WAAW,CAC/B,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,cAAc,CAAC,CAyFzB"}