@ixo/openhands-sdk 0.2.0 → 0.4.0

package/dist/esm/data/why.js

@@ -0,0 +1,78 @@
+/**
+ * Why a claim was decided, as the oracle tells its claimant: `GET <oracle>/openhands/claims/:id/why`
+ * (openhands-oracle `src/openhands/why.ts`). Parsed strictly: any other shape, the old
+ * `verdict/gates/findings` one included, is null, and a reader says `WHY_UNREADABLE` instead.
+ * Pure and dependency-free, so it rides into a browser chunk for a few hundred bytes.
+ */
+export const WHY_UNREADABLE = "Couldn't load the reason";
+/** The result in words, for a screen reader and for the eye alike: never colour alone. */
+export const RESULT_WORD = { pass: "Passed", fail: "Failed", error: "Couldn't check", review: "Needs a person" };
+const OUTCOMES = ["approved", "rejected", "review", "pending"];
+const RESULTS = ["pass", "fail", "error", "review"];
+const GRADES = ["camera", "browser-reported", "none"];
+const text = (v, max = 600) => typeof v === "string" && v.length <= max;
+const amount = (v) => v === undefined || (typeof v === "number" && Number.isFinite(v)) || text(v, 60);
+const optional = (v, max = 600) => v === undefined || text(v, max);
+function reasonOf(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const r = raw;
+    if (!text(r.code, 120) || !text(r.label, 200) || !RESULTS.includes(r.result) || !text(r.detail))
+        return null;
+    if (!amount(r.value) || !amount(r.threshold) || !optional(r.unit, 20))
+        return null;
+    const { code, label, result, detail, value, threshold, unit } = r;
+    return { code, label, result, detail, ...(value !== undefined ? { value } : {}), ...(threshold !== undefined ? { threshold } : {}), ...(unit ? { unit } : {}) };
+}
+/** The body, or null for anything that is not exactly this shape. */
+export function parseWhy(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const w = raw;
+    if (!OUTCOMES.includes(w.outcome) || !text(w.summary, 1000) || !w.summary || !Array.isArray(w.reasons) || w.reasons.length > 50)
+        return null;
+    if (w.evidenceGrade !== undefined && !GRADES.includes(w.evidenceGrade))
+        return null;
+    if (!optional(w.reviewNote, 1000) || !optional(w.receiptCid, 200))
+        return null;
+    const reasons = w.reasons.map(reasonOf);
+    if (reasons.some((one) => !one))
+        return null;
+    const { outcome, summary, evidenceGrade, reviewNote, receiptCid } = w;
+    return { outcome, summary, reasons: reasons, ...(evidenceGrade ? { evidenceGrade } : {}), ...(reviewNote ? { reviewNote } : {}), ...(receiptCid ? { receiptCid } : {}) };
+}
+const num = (v, unit) => `${typeof v === "number" ? v.toLocaleString("en-US") : v}${unit ? `${unit === "%" ? "" : " "}${unit}` : ""}`;
+/** "2,000 m (limit 200 m)", "2,000 m", or "" when the reason carries no measure. */
+export function measureOf(reason) {
+    if (reason.value === undefined)
+        return reason.threshold === undefined ? "" : `limit ${num(reason.threshold, reason.unit)}`;
+    return reason.threshold === undefined ? num(reason.value, reason.unit) : `${num(reason.value, reason.unit)} (limit ${num(reason.threshold, reason.unit)})`;
+}
+/** What a reason adds to its label: the measure, then the detail minus anything that repeats the label, the measure or the result. */
+export function reasonText(reason) {
+    const rest = reason.detail.startsWith(`${reason.label}: `) ? reason.detail.slice(reason.label.length + 2) : reason.detail;
+    const measure = measureOf(reason);
+    const said = rest === reason.label || rest === RESULT_WORD[reason.result] || rest === "Did not pass" ? "" : rest;
+    /* The oracle's detail usually says the measure already ("100% (needs 70%)"): then it alone. */
+    const sayMeasured = reason.value !== undefined && said.startsWith(num(reason.value, reason.unit));
+    return [sayMeasured ? "" : measure, said].filter(Boolean).join(". ");
+}
+/** "Time/place: browser-reported", or null. */
+export const evidenceLine = (why) => (why.evidenceGrade ? `Time/place: ${why.evidenceGrade}` : null);
+/** The whole answer as plain lines (MCP `check_verdict`); null is the graceful message. */
+export function whyLines(why, indent = "") {
+    if (!why)
+        return [`${indent}${WHY_UNREADABLE}.`];
+    const lines = [`${indent}${why.summary}`];
+    for (const reason of why.reasons) {
+        const said = reasonText(reason);
+        lines.push(`${indent}  ${RESULT_WORD[reason.result]}: ${reason.label}${said ? ` — ${said}` : ""}`);
+    }
+    const evidence = evidenceLine(why);
+    if (evidence)
+        lines.push(`${indent}${evidence}`);
+    if (why.outcome === "review" && why.reviewNote)
+        lines.push(`${indent}${why.reviewNote}`);
+    return lines;
+}
+//# sourceMappingURL=why.js.map

package/dist/esm/data/why.js.map

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

package/dist/esm/data/whyReceipt.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The claimant's "why", rebuilt from the PUBLIC engine receipt, for everyone the oracle's
+ * `/openhands/claims/:id/why` cannot answer: a passkey or guest claimant (no signing key), an MCP
+ * acting for a connected person, the hosted MCP. Same `Why` shape and the same rules as the
+ * oracle's mapper (openhands-oracle `src/openhands/explain.ts`), minus what only the oracle holds:
+ * the receipt carries codes, outcomes and scores, never the frozen facts, so there are no measured
+ * distances, no AI sentence and no time/place grade here.
+ *
+ * Worker-safe: only the rubric's own public sentences and fixed words reach a detail, scrubbed of
+ * identifiers; the rubric's AI instructions are never read, nor the receipt's payee, company,
+ * digests or trace. Duplicate-photo findings say only that the photo was used before.
+ * Pure: `chain/why.ts` fetches the receipt and the verified rubric and calls this.
+ */
+import type { Why } from "./why.ts";
+export declare const PENDING_WHY: Why;
+export declare const scrub: (text: string, n?: number) => string;
+/** `SD-101-PHOTO` → "Photo", `OH-102-LENGTH` → "Length": the words a code carries when no rubric does. */
+export declare function codeLabel(code: string): string;
+/** Where the receipt's rubric is anchored, and the id its bytes must hash to; null when it names none. */
+export declare function receiptRubric(receipt: unknown): {
+    protocolDid: string;
+    rubricId: string;
+} | null;
+/**
+ * The `Why` a receipt supports, or null for anything that is not an engine receipt. `rubric` is the
+ * protocol's `#rub` document with the id its bytes hash to; its words are used only when that id is
+ * the receipt's `rubric.id`, so a protocol re-anchored since never lends the wrong labels.
+ */
+export declare function whyFromReceipt(receipt: unknown, rubric?: {
+    id: string;
+    doc: unknown;
+} | null): Why | null;
+//# sourceMappingURL=whyReceipt.d.ts.map

package/dist/esm/data/whyReceipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whyReceipt.d.ts","sourceRoot":"","sources":["../../../src/data/whyReceipt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAwB,MAAM,UAAU,CAAC;AAS1D,eAAO,MAAM,WAAW,EAAE,GAAkH,CAAC;AAa7I,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,EAAE,UAAO,KAAG,MAAyG,CAAC;AAmCxJ,0GAA0G;AAC1G,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAsFD,0GAA0G;AAC1G,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKhG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAuHzG"}

package/dist/esm/data/whyReceipt.js

@@ -0,0 +1,284 @@
+/**
+ * The claimant's "why", rebuilt from the PUBLIC engine receipt, for everyone the oracle's
+ * `/openhands/claims/:id/why` cannot answer: a passkey or guest claimant (no signing key), an MCP
+ * acting for a connected person, the hosted MCP. Same `Why` shape and the same rules as the
+ * oracle's mapper (openhands-oracle `src/openhands/explain.ts`), minus what only the oracle holds:
+ * the receipt carries codes, outcomes and scores, never the frozen facts, so there are no measured
+ * distances, no AI sentence and no time/place grade here.
+ *
+ * Worker-safe: only the rubric's own public sentences and fixed words reach a detail, scrubbed of
+ * identifiers; the rubric's AI instructions are never read, nor the receipt's payee, company,
+ * digests or trace. Duplicate-photo findings say only that the photo was used before.
+ * Pure: `chain/why.ts` fetches the receipt and the verified rubric and calls this.
+ */
+const str = (v) => (typeof v === "string" && v ? v : undefined);
+const obj = (v) => (v && typeof v === "object" && !Array.isArray(v) ? v : undefined);
+const list = (v) => (Array.isArray(v) ? v.map(obj).filter((x) => !!x) : []);
+export const PENDING_WHY = { outcome: "pending", summary: "Not decided yet: the checks on your claim are still running.", reasons: [] };
+/* ---- scrubbing: a rubric is public text, but a detail must never carry an identifier ---- */
+const HIDDEN = "[hidden]";
+const SCRUB = [
+    /\b(?:https?:\/\/|www\.)\S+/gi,
+    /[\w.+-]+@[\w-]+(?:\.[\w-]+)+/g,
+    /\bdid:[a-z0-9]+:[^\s,;)]+/gi,
+    /\bixo1[a-z0-9]{38,58}\b/g,
+    /\b(?:baf[a-z2-7]{20,}|[A-Za-z0-9]{30,})\b/g
+];
+const capped = (s, n = 160) => (s.length > n ? `${s.slice(0, n - 1).trimEnd()}…` : s);
+export const scrub = (text, n = 280) => capped(SCRUB.reduce((out, re) => out.replace(re, HIDDEN), text).replace(/\s+/g, " ").trim(), n);
+/* ---- labels, as the oracle words them ---- */
+const FACT_LABELS = {
+    withinRadius: "Distance to the place",
+    withinAskRadius: "Distance to the boat",
+    located: "Location reported",
+    beforeAfter: "Before and after photos",
+    notAlreadyMapped: "Not already reported here",
+    cooldown: "Not reported here recently",
+    daylight: "Light matches the time",
+    weather: "Weather matches",
+    reMeasure: "Status re-measured",
+    openhandsSite: "Site marker",
+    notElsewhere: "Photo taken at the place",
+    notMarkedGenerated: "Photo not AI-generated",
+    photoShape: "Photo shape",
+    atPoint: "At the point",
+    mappedGrid: "Mapped area",
+    jobStillOpen: "Job still open",
+    freshPhoto: "Fresh after photo",
+    barnaclesGone: "Cleanliness",
+    sameBoat: "Same boat in both photos"
+};
+const humanise = (s) => s
+    .replace(/^\$/, "")
+    .replace(/([a-z])([A-Z])/g, "$1 $2")
+    .replace(/[._-]+/g, " ")
+    .trim()
+    .replace(/^./, (c) => c.toUpperCase())
+    .replace(/(?<=\s)([A-Z])(?=[a-z])/g, (c) => c.toLowerCase());
+/** `SD-101-PHOTO` → "Photo", `OH-102-LENGTH` → "Length": the words a code carries when no rubric does. */
+export function codeLabel(code) {
+    const words = /^[A-Z0-9]+-\d+-([A-Z0-9-]+)$/.exec(code)?.[1];
+    return words ? humanise(words.toLowerCase()) : humanise(code);
+}
+function leaves(node, out = []) {
+    if (Array.isArray(node))
+        for (const n of node)
+            leaves(n, out);
+    else if (node && typeof node === "object") {
+        const o = node;
+        if (typeof o.field === "string")
+            out.push(o);
+        for (const [k, v] of Object.entries(o))
+            if (k !== "value")
+                leaves(v, out);
+    }
+    return out;
+}
+/** The facts a condition reads, each once, with the `.score` it must reach where it compares one. */
+function factRefs(...nodes) {
+    const refs = new Map();
+    for (const leaf of nodes.flatMap((n) => leaves(n))) {
+        const m = /^(ext|ai)\.([A-Za-z0-9_]+)\.(valid|score)$/.exec(leaf.field);
+        if (!m)
+            continue;
+        const key = `${m[1]}.${m[2]}`;
+        const ref = refs.get(key) ?? { lane: m[1], name: m[2] };
+        if (m[3] === "score" && typeof leaf.value === "number" && /^>=?$/.test(String(leaf.op)))
+            ref.threshold = Math.max(ref.threshold ?? 0, leaf.value);
+        refs.set(key, ref);
+    }
+    return [...refs.values()];
+}
+function factLabel(ref, rubricReason) {
+    const known = FACT_LABELS[ref.name] ?? FACT_LABELS[ref.name.replace(/\d+$/, "")];
+    if (known)
+        return known;
+    if (ref.lane === "ai" && rubricReason)
+        return capped(rubricReason);
+    return humanise(ref.name);
+}
+function fieldLabel(when, rubricReason) {
+    const ops = leaves(when);
+    const op = String(ops[0]?.op ?? "");
+    const fields = [...new Set(ops.map((l) => String(l.field)))];
+    const what = fields.length === 1 ? humanise(fields[0] ?? "") : "Files";
+    if (op === "present")
+        return `${what} handed in`;
+    if (op === "mediaTypeIn")
+        return `${what === "Files" ? "File" : what} type`;
+    if (op === "maxSizeMB")
+        return `${what === "Files" ? "File" : what} size`;
+    return rubricReason ? capped(rubricReason) : what;
+}
+function viewOf(doc) {
+    const rubric = obj(obj(doc)?.rubric);
+    if (!rubric)
+        return null;
+    const unique = obj(rubric.unique);
+    const frequency = obj(rubric.frequency);
+    return {
+        gates: list(rubric.gates).flatMap((g) => (str(g.code) ? [{ code: g.code, reason: str(g.reason), when: obj(g.when) }] : [])),
+        criteria: list(obj(rubric.scoring)?.criteria).flatMap((c) => str(c.code) ? [{ code: c.code, reason: str(c.reason), appliesWhen: obj(c.appliesWhen), score: obj(c.score) }] : []),
+        ...(unique ? { unique: { label: str(unique.label) } } : {}),
+        ...(frequency ? { frequency: { label: str(frequency.label), max: typeof frequency.max === "number" ? frequency.max : undefined, per: str(frequency.per) } } : {})
+    };
+}
+/* ---- the mapper ---- */
+const GATE_RESULT = { passed: "pass", failed: "fail", unevaluated: "error" };
+const UNCHECKED = "could not be checked automatically";
+const sentence = (s) => (/[.!?…]$/.test(s) ? s : `${s}.`);
+const fmt = (n) => n.toLocaleString("en-US", { maximumFractionDigits: 2 });
+/** The receipt's evaluation block and its address: a bare v3 credential, the engine's `?format=json` wrapper, or a legacy v2 payload. */
+function evaluationOf(doc) {
+    const outer = obj(doc);
+    const claimset = obj(outer?.payload) ?? outer;
+    const subject = obj(claimset?.credentialSubject);
+    const evaluation = obj(subject?.evaluation) ?? obj(claimset?.ixo);
+    return evaluation ? { evaluation, decision: obj(subject?.decision), cid: str(outer?.cid) } : null;
+}
+/** Where the receipt's rubric is anchored, and the id its bytes must hash to; null when it names none. */
+export function receiptRubric(receipt) {
+    const evaluation = evaluationOf(receipt)?.evaluation;
+    const protocolDid = str(evaluation?.protocolDid);
+    const rubricId = str(obj(evaluation?.rubric)?.id);
+    return protocolDid && rubricId ? { protocolDid, rubricId } : null;
+}
+/**
+ * The `Why` a receipt supports, or null for anything that is not an engine receipt. `rubric` is the
+ * protocol's `#rub` document with the id its bytes hash to; its words are used only when that id is
+ * the receipt's `rubric.id`, so a protocol re-anchored since never lends the wrong labels.
+ */
+export function whyFromReceipt(receipt, rubric) {
+    const found = evaluationOf(receipt);
+    if (!found)
+        return null;
+    const { evaluation, cid } = found;
+    const verdict = str(evaluation.verdict);
+    if (!verdict)
+        return null;
+    const receiptCid = cid ? { receiptCid: cid } : {};
+    if (evaluation.status === "unusable") {
+        return { ...PENDING_WHY, summary: "Not decided yet: your claim could not be checked automatically. Nothing is needed from you.", ...receiptCid };
+    }
+    const resOutcome = obj(evaluation.res)?.outcome;
+    const outcome = verdict === "review" || resOutcome === 5 ? "review" : verdict === "approve" || verdict === "partial" ? "approved" : verdict === "reject" ? "rejected" : "pending";
+    const rubricId = str(obj(evaluation.rubric)?.id);
+    const view = rubric && rubricId && rubric.id.toLowerCase() === rubricId.toLowerCase() ? viewOf(rubric.doc) : null;
+    /* "held for a person" only when one is: a check that could not run on a rejected claim was not held. */
+    const held = outcome === "review" ? `${UNCHECKED}: held for a person` : UNCHECKED;
+    const reasons = [];
+    const seen = new Set();
+    const covered = new Set();
+    const push = (r) => {
+        const clean = { ...r, label: scrub(r.label, 200), detail: scrub(r.detail) };
+        /* Said once: the same answer, or a bare pass/fail on a check already said (a criterion restating its gate). */
+        const key = `${clean.result}|${clean.label}`;
+        const bare = clean.detail === "Passed" || clean.detail === "Did not pass";
+        if (seen.has(`${key}|${clean.detail}`) || (bare && seen.has(key)))
+            return;
+        seen.add(key).add(`${key}|${clean.detail}`);
+        reasons.push(clean);
+    };
+    const special = (code, result) => {
+        if (code.startsWith("unique:")) {
+            push({ code: code.slice(7), label: view?.unique?.label ?? "Photo not used before", result, detail: result === "fail" ? "This photo was already used in another claim" : "Passed" });
+            return true;
+        }
+        if (code.startsWith("frequency:")) {
+            const f = view?.frequency;
+            push({
+                code: code.slice(10),
+                label: f?.label ?? "Claim limit",
+                result,
+                detail: result !== "fail" ? "Passed" : f?.max !== undefined && f.per ? `Limit reached: at most ${fmt(f.max)} claims a ${f.per}` : "Limit reached",
+                ...(f?.max !== undefined ? { threshold: f.max } : {})
+            });
+            return true;
+        }
+        return false;
+    };
+    const checks = list(evaluation.checks);
+    const checkOf = (ref) => checks.find((c) => c.kind === ref.lane && c.name === ref.name);
+    /** One gate or criterion read through the single fact it tests (the oracle's `factReason`, without the fact). */
+    const throughFact = (code, result, ref, reason, criterion = false) => {
+        covered.add(`${ref.lane}.${ref.name}`);
+        const label = factLabel(ref, reason);
+        /* An ext score the receipt records (basis points, as the rubric compares it): said as the oracle says it. */
+        const scored = ref.lane === "ext" && ref.threshold !== undefined && (result === "pass" || result === "fail") ? Number(checkOf(ref)?.verdict) : NaN;
+        if (Number.isFinite(scored) && scored >= 0 && scored <= 10_000) {
+            const value = Math.round(scored / 100);
+            const threshold = Math.round(ref.threshold / 100);
+            return push({ code, label, result, detail: `${label}: ${value}% (needs ${threshold}%)`, value, threshold, unit: "%" });
+        }
+        push({ code, label, result, detail: result === "error" ? `${label}: ${held}` : result === "review" ? `${label}: a person is checking this` : result === "pass" ? "Passed" : criterion ? "Did not pass" : (reason ?? "Did not pass") });
+    };
+    for (const gate of list(evaluation.gates)) {
+        const code = str(gate.code);
+        const result = GATE_RESULT[String(gate.outcome)];
+        if (!code || !result || special(code, result))
+            continue;
+        const spec = view?.gates.find((g) => g.code === code);
+        const refs = factRefs(spec?.when);
+        if (refs.length === 1)
+            throughFact(code, result, refs[0], spec?.reason);
+        else {
+            const label = spec ? fieldLabel(spec.when, spec.reason) : codeLabel(code);
+            push({ code, label, result, detail: result === "pass" ? "Passed" : result === "fail" ? (spec?.reason ?? "Did not pass") : `${label}: ${held}` });
+        }
+    }
+    for (const c of list(evaluation.criteria)) {
+        const code = str(c.code);
+        if (!code)
+            continue;
+        /* A criterion still pending on a claim already decided waits on nobody: not said. */
+        const result = c.pending === true ? (outcome === "review" ? "review" : null) : typeof c.scoreBps !== "number" ? null : c.scoreBps >= 5000 ? "pass" : "fail";
+        if (!result)
+            continue;
+        const spec = view?.criteria.find((s) => s.code === code);
+        const refs = factRefs(spec?.appliesWhen, spec?.score);
+        if (refs.length === 1 && result !== "review")
+            throughFact(code, result, refs[0], spec?.reason, true);
+        else {
+            const label = spec?.reason ? capped(spec.reason) : codeLabel(code);
+            push({ code, label, result, detail: result === "review" ? "A person is checking this" : result === "pass" ? "Passed" : "Did not pass" });
+        }
+    }
+    /* A check no gate or criterion above spoke for, said only when it failed or could not run. */
+    for (const check of checks) {
+        const name = str(check.name);
+        const kind = str(check.kind);
+        if (!name || !kind)
+            continue;
+        const errored = check.status === "error";
+        const failed = check.verdict === "fail" || check.verdict === "false" || (kind === "frequency" && check.verdict !== "ok" && check.verdict !== "pass");
+        if (!errored && !failed)
+            continue;
+        const result = errored ? "error" : "fail";
+        if (kind === "unique" || kind === "frequency") {
+            special(name.includes(":") ? name : `${kind}:${name}`, result);
+            continue;
+        }
+        if ((kind !== "ai" && kind !== "ext") || covered.has(`${kind}.${name}`))
+            continue;
+        const ref = { lane: kind, name };
+        const spec = [...(view?.gates.map((g) => ({ reason: g.reason, refs: factRefs(g.when) })) ?? []), ...(view?.criteria.map((s) => ({ reason: s.reason, refs: factRefs(s.appliesWhen, s.score) })) ?? [])].find((one) => one.refs.some((r) => r.lane === kind && r.name === name));
+        throughFact(`${kind}.${name}`, result, ref, spec?.reason);
+    }
+    if (outcome === "review" && !reasons.some((r) => r.result === "error" || r.result === "review")) {
+        push({ code: "review", label: "Checked by a person", result: "review", detail: "A person is checking your claim" });
+    }
+    return { outcome, summary: summaryOf(outcome, verdict, reasons), reasons, ...receiptCid };
+}
+function summaryOf(outcome, verdict, reasons) {
+    if (outcome === "approved")
+        return verdict === "partial" ? "Approved in part: some checks fell short." : "Approved: every check passed.";
+    if (outcome === "rejected") {
+        const first = reasons.find((r) => r.result === "fail");
+        return first ? `Rejected. ${first.detail === "Did not pass" ? `${first.label} did not pass.` : sentence(first.detail)}` : "Rejected.";
+    }
+    if (outcome === "pending")
+        return PENDING_WHY.summary;
+    const held = reasons.find((r) => r.result === "error" || r.result === "review");
+    return held ? `Held for a person to check. ${sentence(held.result === "review" ? held.label : held.detail)}` : "Held for a person to check.";
+}
+//# sourceMappingURL=whyReceipt.js.map

package/dist/esm/data/whyReceipt.js.map

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

package/dist/esm/geo/exifcarry.d.ts

@@ -28,4 +28,13 @@ export declare function exifSegment(bytes: Uint8Array): Uint8Array | null;
  * it meets. One photograph, one answer about where it was taken.
  */
 export declare function withExifSegment(jpeg: Uint8Array, segment: Uint8Array): Uint8Array;
+/**
+ * The same segment, saying Orientation = 1.
+ *
+ * After a canvas redraw the pixels already stand the right way up (the decode
+ * applies the tag), so carrying the camera's 6 or 8 makes every viewer turn
+ * the picture a second time. Same length, one value changed: every other tag,
+ * DateTimeOriginal and GPS included, stays byte for byte.
+ */
+export declare function uprightSegment(segment: Uint8Array): Uint8Array;
 //# sourceMappingURL=exifcarry.d.ts.map

package/dist/esm/geo/exifcarry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exifcarry.d.ts","sourceRoot":"","sources":["../../../src/geo/exifcarry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAiBhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAqBjF"}
+{"version":3,"file":"exifcarry.d.ts","sourceRoot":"","sources":["../../../src/geo/exifcarry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAiBhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAqBjF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAqB9D"}

package/dist/esm/geo/exifcarry.js

@@ -74,4 +74,38 @@ export function withExifSegment(jpeg, segment) {
     out.set(jpeg.slice(at), 2 + segment.length + kept.length);
     return out;
 }
+/**
+ * The same segment, saying Orientation = 1.
+ *
+ * After a canvas redraw the pixels already stand the right way up (the decode
+ * applies the tag), so carrying the camera's 6 or 8 makes every viewer turn
+ * the picture a second time. Same length, one value changed: every other tag,
+ * DateTimeOriginal and GPS included, stays byte for byte.
+ */
+export function uprightSegment(segment) {
+    const out = segment.slice();
+    const tiff = 10;
+    if (out.length < tiff + 8)
+        return out;
+    const view = new DataView(out.buffer, out.byteOffset, out.byteLength);
+    const order = view.getUint16(tiff, false);
+    if (order !== 0x4949 && order !== 0x4d4d)
+        return out;
+    const little = order === 0x4949;
+    const ifd0 = tiff + view.getUint32(tiff + 4, little);
+    if (ifd0 + 2 > out.length)
+        return out;
+    const count = view.getUint16(ifd0, little);
+    for (let index = 0; index < count; index += 1) {
+        const entry = ifd0 + 2 + index * 12;
+        if (entry + 12 > out.length)
+            break;
+        /* SHORT, count 1: the value sits inline in the entry's first two bytes. */
+        if (view.getUint16(entry, little) === 0x0112 && view.getUint16(entry + 2, little) === 3) {
+            view.setUint16(entry + 8, 1, little);
+            break;
+        }
+    }
+    return out;
+}
 //# sourceMappingURL=exifcarry.js.map

package/dist/esm/geo/exifcarry.js.map

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

package/dist/esm/geo/geohash.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Geohash, for where a person says they are most days.
+ *
+ * Ask the World keeps a person's home as a coarse cell, never a point: six
+ * characters is a cell about 1.2 km × 0.6 km, enough to know who is near an
+ * ask and too coarse to find a front door. The registry stores the cell; the
+ * matcher reads its centre. Standard base-32 geohash, so any tool can read it.
+ */
+import type { GeoPoint } from "./box.ts";
+/** The cell a point falls in, `precision` characters long (6 by default). */
+export declare function geohashEncode(point: GeoPoint, precision?: number): string;
+/** The centre of a cell, or null when the string is not a geohash. */
+export declare function geohashCentre(hash: string): GeoPoint | null;
+/**
+ * The cells to look in for everything within `reachM` of a point: the cell
+ * the point falls in and its eight neighbours, at the finest precision (up to
+ * `maxPrecision`) whose cells are wider and taller than the reach there. A
+ * point within reach can then never fall outside the block, however near an
+ * edge of its own cell the point sits. Any cell of `maxPrecision` characters
+ * or fewer that holds such a point starts with one of the returned cells.
+ *
+ * A reach over a pole needs every longitude: the 32 one-character cells.
+ */
+export declare function geohashesAround(point: GeoPoint, reachM: number, maxPrecision?: number): string[];
+//# sourceMappingURL=geohash.d.ts.map

package/dist/esm/geo/geohash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geohash.d.ts","sourceRoot":"","sources":["../../../src/geo/geohash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAIzC,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,SAAI,GAAG,MAAM,CA0BpE;AAqBD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAG3D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,MAAM,EAAE,CA2B3F"}