@ixo/openhands-sdk 0.0.0-stage → 0.2.0

package/dist/esm/campaign/fold.js

@@ -0,0 +1,403 @@
+/**
+ * The campaign, folded once and read many times.
+ *
+ * `campaignCollections` used to be a walk: every claim collection since the
+ * campaign began, paged from the index, and a terms document fetched for
+ * each to learn whether it belonged here and what kind of ask it was — per
+ * request, per instance, inside a budget it ran out of most evenings, at
+ * which point which asks made it into the fold depended on how fast the
+ * index felt. When the mapping ask was among the ones it dropped, the map
+ * had no pins.
+ *
+ * The terms are content-addressed and never change, so the classification
+ * is a fact worth writing down once. The worker does that (workers/src/fold)
+ * and publishes the folded shape; this module is the two halves everybody
+ * else needs: the one classifier, so the walk, the worker's posting hook and
+ * the reader can never disagree about what an ask is, and the reader that
+ * turns a published fold back into `CampaignCollections`.
+ *
+ * Nothing here imports `spots.ts` at runtime: `spots.ts` imports this.
+ */
+import { VERDICT } from "../data/verdict.js";
+import { givenConfig } from "../given.js";
+import { firstSet, hasEnv } from "../envRead.js";
+/**
+ * What an ask is, from its terms — the rule the walk always applied, in one
+ * place. A document that names no campaign is nobody's; a deliverable type
+ * decides the bucket; a `clears` with no recognised type is a cleanup.
+ */
+export function classifyTerms(terms) {
+    const doc = terms && typeof terms === "object" ? terms : null;
+    const campaign = typeof doc?.campaign === "string" && doc.campaign ? doc.campaign : null;
+    if (!doc || !campaign)
+        return { campaign, kind: "other", clears: null };
+    const type = doc.deliverable?.type;
+    if (type === "mess-report" || type === "field-report" || type === "commitment")
+        return { campaign, kind: type, clears: null };
+    if (typeof doc.clears === "string" && doc.clears)
+        return { campaign, kind: "cleanup", clears: doc.clears };
+    return { campaign, kind: "other", clears: null };
+}
+/** An ask is open while its deadline stands and its state says so — the same rule every surface uses. */
+export const askOpen = (node, now = Date.now()) => {
+    const ends = node.endDate ? Date.parse(node.endDate) : NaN;
+    return node.state === 0 && (!Number.isFinite(ends) || ends > now);
+};
+/** A fold as the apps consume it. `open` is a function of the clock, so it is decided here, not when the fold was written. */
+export function fromFold(body, now = Date.now()) {
+    return {
+        mapping: body.mapping ?? [],
+        cleanups: (body.cleanups ?? []).map((one) => ({ node: one.node, clears: one.clears, open: askOpen(one.node, now) })),
+        reports: body.reports ?? [],
+        commitments: body.commitments ?? []
+    };
+}
+const isFold = (value) => {
+    const body = value;
+    return Boolean(body && typeof body === "object" && typeof body.campaign === "string" && Array.isArray(body.mapping) && Array.isArray(body.cleanups));
+};
+let source = null;
+export function useCampaignFold(reader) {
+    source = reader;
+    /* Another source is another truth: what the last one said is not kept for it. */
+    lastFold.clear();
+}
+/*
+ * The last fold this process read, per campaign.
+ *
+ * "No fold" sends the reader to walk the index, and on mainnet that walk runs
+ * out of its budget across thousands of other projects' collections and comes
+ * back empty — so one slow fetch of the fold (a cold worker after a deploy, a
+ * six-second timeout) blanked the map for everybody (2026-09-19, 22:07). A
+ * fold that was read a minute ago is a far better answer than that walk: the
+ * asks of a campaign do not vanish, and the pins are read live on top of it
+ * (`liveMapping`). Kept for the life of the process and no longer; a campaign
+ * that has never been folded here still reads as null, and still walks.
+ */
+const lastFold = new Map();
+/** The campaign worker: `configure({ workerUrl })`, else `WORKER_URL` or `NEXT_PUBLIC_WORKER_URL`, else "". */
+export const workerUrl = () => (givenConfig().workerUrl ?? (hasEnv() ? firstSet(process.env.WORKER_URL, process.env.NEXT_PUBLIC_WORKER_URL) : undefined) ?? "").replace(/\/$/, "");
+/** Where the published fold is read: `configure({ campaignFoldUrl })`, else `CAMPAIGN_FOLD_URL`, else the worker. */
+export const campaignFoldUrl = () => (givenConfig().campaignFoldUrl ?? (hasEnv() ? firstSet(process.env.CAMPAIGN_FOLD_URL) : undefined) ?? workerUrl()).replace(/\/$/, "");
+const foldUrl = campaignFoldUrl;
+export const FOLD_TIMEOUT_MS = 6_000;
+/** The worker's published fold, or null for any reason — a missing address, a 404, a slow answer, a body that is not a fold. */
+export async function fetchCampaignFold(campaign, fetchImpl = fetch) {
+    const base = foldUrl();
+    if (!base)
+        return null;
+    /* The campaign as rows, read as a difference (below). A worker that does
+       not serve rows yet answers 404 there, and the whole body is read as
+       before — so the apps and the worker can be released in either order. */
+    const rows = await syncNodes(base, campaign, fetchImpl);
+    if (rows !== "unsupported")
+        return rows;
+    try {
+        const response = await fetchImpl(`${base}/campaign/${encodeURIComponent(campaign)}/collections`, {
+            signal: AbortSignal.timeout(FOLD_TIMEOUT_MS),
+            next: { revalidate: 30 }
+        });
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        return isFold(body) && body.campaign === campaign ? body : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The registered source first, the worker's endpoint otherwise. */
+export async function readCampaignFold(campaign) {
+    try {
+        const body = source ? await source(campaign) : await fetchCampaignFold(campaign);
+        if (body) {
+            lastFold.set(campaign, body);
+            return body;
+        }
+    }
+    catch {
+        /* fall through to what was read before */
+    }
+    return lastFold.get(campaign) ?? null;
+}
+export const COLLECTION_FIELDS = `id state endDate entity admin quota evaluated payments
+          claimsByCollectionId { nodes { claimId submissionDate agentAddress evaluationByClaimId { status evaluationDate } } }`;
+/**
+ * How many of a mapping ask's claims the live read takes: the newest.
+ *
+ * Read whole, a mapping ask with two thousand claims is half a megabyte every
+ * thirty seconds, per server — to find the one pin mapped since the last
+ * publish. The worker already holds every older pin as a row
+ * (`readCampaignPins`); what only the index knows is what is NEW, and new is
+ * the head of this list. A claim submitted long ago and approved just now is
+ * not in it, and is picked up by the worker's next publish instead.
+ */
+export const LIVE_CLAIMS = 100;
+const LIVE_FIELDS = COLLECTION_FIELDS.replace("claimsByCollectionId {", `claimsByCollectionId(first: ${LIVE_CLAIMS}, orderBy: SUBMISSION_DATE_DESC) {`);
+/** The index's own copy of these collections, a hundred ids to a query. */
+export const liveNodes = async (ids) => {
+    if (ids.length === 0)
+        return [];
+    const { gql } = await import("../data/gql.js");
+    const nodes = [];
+    for (let at = 0; at < ids.length; at += 100) {
+        const data = await gql(`query { claimCollections(filter: {id: {in: ${JSON.stringify(ids.slice(at, at + 100))}}}) { nodes { ${LIVE_FIELDS} } } }`, 5);
+        nodes.push(...(data.claimCollections?.nodes ?? []));
+    }
+    return nodes;
+};
+/** The same campaign, its mapping asks as the index has them now. Order kept; a failed read changes nothing. */
+export async function liveMapping(collections, read = liveNodes) {
+    if (collections.mapping.length === 0)
+        return collections;
+    try {
+        const fresh = new Map((await read(collections.mapping.map((node) => node.id))).map((node) => [node.id, node]));
+        return { ...collections, mapping: collections.mapping.map((node) => fresh.get(node.id) ?? node) };
+    }
+    catch {
+        return collections;
+    }
+}
+/* ── the nudge ───────────────────────────────────────────────────────────── */
+/**
+ * Pins approved a moment ago that no cleanup ask clears yet.
+ *
+ * The campaign posts a cleanup ask for every approved pin, on its pass. A pin
+ * in this list is one the pass still owes — which is the only reason a nudge
+ * is allowed to ask for a pass ahead of the clock. Bounded to recent
+ * approvals on purpose: a pin the campaign decided not to fund (gone,
+ * hazardous, for professionals) is owed nothing, and must not keep asking.
+ */
+export function owedPins(body, now = Date.now(), windowMs = 30 * 60_000) {
+    const cleared = new Set((body.cleanups ?? []).map((one) => one.clears));
+    const claims = (body.mapping ?? []).flatMap((node) => (node.claimsByCollectionId?.nodes ?? []).map((claim) => ({ claimId: claim.claimId, status: claim.evaluationByClaimId?.status ?? null, decidedAt: claim.evaluationByClaimId?.evaluationDate ?? null })));
+    return owedAmong(claims, cleared, now, windowMs);
+}
+/** The index writes UTC without saying so ("2026-09-19T19:42:39.642"). */
+const utcMs = (at) => Date.parse(/[zZ]$|[+-]\d\d:?\d\d$/.test(at) ? at : `${at}Z`);
+/** `owedPins`, over plain claim facts — what the rows publisher has in hand, which is not a fold body. */
+export function owedAmong(claims, cleared, now = Date.now(), windowMs = 30 * 60_000) {
+    const owed = [];
+    for (const claim of claims) {
+        if (claim.status !== VERDICT.APPROVED || cleared.has(claim.claimId) || !claim.decidedAt)
+            continue;
+        const decided = utcMs(claim.decidedAt);
+        if (Number.isFinite(decided) && now - decided <= windowMs)
+            owed.push(claim.claimId);
+    }
+    return owed;
+}
+export const NUDGE_TIMEOUT_MS = 2_500;
+/**
+ * Tell the worker the campaign just changed, so it publishes now rather than
+ * at its next tick. Best-effort by design: the clock still folds every ten
+ * minutes, so a nudge that is lost costs minutes and never correctness. It
+ * never throws and never waits long — it is called from a poll.
+ */
+export async function nudgeCampaignFold(campaign, fetchImpl = fetch, proxy = {}) {
+    const base = foldUrl();
+    if (!base || !campaign)
+        return false;
+    try {
+        const response = await fetchImpl(`${base}/campaign/${encodeURIComponent(campaign)}/refresh`, {
+            method: "POST",
+            cache: "no-store",
+            /*
+             * Who is really asking (final review 2026-10, WN9e #7). The worker brakes
+             * refreshes per caller, and without these every phone behind the youth
+             * app arrived as the app's own address — one bucket for a whole campaign,
+             * so one busy minute braked everyone's nudge. `proxy` is the caller's
+             * proxy pair (`x-openhands-proxy` + `x-openhands-client-ip`, the youth
+             * app's `asProxy`), which the worker honours only with the secret. Taken
+             * as headers rather than built from `board/read`'s `workerHeaders`:
+             * this module ships to the browser (the fold hooks) and that one pulls
+             * the index client. A POST, never cached, so naming a caller costs no
+             * shared cache entry.
+             */
+            headers: { accept: "application/json", ...proxy },
+            signal: AbortSignal.timeout(NUDGE_TIMEOUT_MS)
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export const ROWS_PAGE = 500;
+export const SYNC_OVERLAP_MS = 10_000;
+/** A read that pages for ever is a bug somewhere, and must not become a hung request. */
+const MAX_PAGES = 200;
+const numeric = (id) => (/^\d+$/.test(id) ? Number(id) : 0);
+/** The fold the apps consume, from its rows — newest ask first, as the walk always had it. */
+export function bodyFromNodes(campaign, foldedAt, nodes) {
+    const body = { campaign, foldedAt, mapping: [], cleanups: [], reports: [], commitments: [] };
+    for (const one of [...nodes].sort((a, b) => numeric(b.id) - numeric(a.id))) {
+        if (one.kind === "mess-report")
+            body.mapping.push(one.node);
+        else if (one.kind === "field-report")
+            body.reports.push(one.node);
+        else if (one.kind === "commitment")
+            body.commitments.push(one.node);
+        else if (one.kind === "cleanup" && one.clears)
+            body.cleanups.push({ node: one.node, clears: one.clears });
+    }
+    return body;
+}
+const rewound = (through) => {
+    const at = through ? Date.parse(through) : NaN;
+    return Number.isFinite(at) ? new Date(at - SYNC_OVERLAP_MS).toISOString() : null;
+};
+/** Every page of one read, or "unsupported" (no such door on this worker), or null (the door said no, or broke). */
+async function pagesOf(url, fetchImpl, isPage) {
+    const pages = [];
+    let after = null;
+    try {
+        for (let page = 0; page < MAX_PAGES; page++) {
+            const response = await fetchImpl(url(after), { cache: "no-store", signal: AbortSignal.timeout(FOLD_TIMEOUT_MS) });
+            if (response.status === 404 && page === 0) {
+                const said = (await response.json().catch(() => null));
+                /* A worker that serves rows says why; one that has never heard of this door does not answer in JSON. */
+                return said?.error === "not folded" ? null : "unsupported";
+            }
+            if (!response.ok)
+                return null;
+            const body = (await response.json().catch(() => null));
+            /* Something answered 200 and it is not a page of rows: a worker (or a
+               proxy in front of one) that does not speak this. First page only —
+               half-way through a read it is simply a broken read. */
+            if (!isPage(body))
+                return page === 0 ? "unsupported" : null;
+            pages.push(body);
+            if (!body.next)
+                return pages;
+            after = body.next;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+const isNodesPage = (value) => {
+    const page = value;
+    return Boolean(page && typeof page === "object" && typeof page.campaign === "string" && typeof page.through === "string" && Array.isArray(page.rows));
+};
+const isPinsPage = (value) => {
+    const page = value;
+    return Boolean(page && typeof page === "object" && typeof page.campaign === "string" && typeof page.through === "string" && Array.isArray(page.rows));
+};
+const nodesHeld = new Map();
+const pinsHeld = new Map();
+/** For tests: forget everything this process has synced. */
+export function forgetSyncedRows() {
+    nodesHeld.clear();
+    pinsHeld.clear();
+}
+async function syncNodes(base, campaign, fetchImpl) {
+    const held = nodesHeld.get(`${base}|${campaign}`);
+    const since = rewound(held?.through ?? null);
+    const door = `${base}/campaign/${encodeURIComponent(campaign)}/nodes?limit=${ROWS_PAGE}${since ? `&since=${encodeURIComponent(since)}` : ""}`;
+    const pages = await pagesOf((after) => (after ? `${door}&after=${encodeURIComponent(after)}` : door), fetchImpl, isNodesPage);
+    if (pages === "unsupported")
+        return "unsupported";
+    if (!pages || pages.some((page) => page.campaign !== campaign))
+        return null;
+    const nodes = new Map(held?.nodes ?? []);
+    for (const page of pages)
+        for (const row of page.rows)
+            if (row && typeof row.id === "string" && row.node)
+                nodes.set(row.id, row);
+    const first = pages[0];
+    nodesHeld.set(`${base}|${campaign}`, { nodes, through: first.through, foldedAt: first.foldedAt });
+    return bodyFromNodes(campaign, first.foldedAt, nodes.values());
+}
+let pinSource = null;
+/** Register where this process reads pins from (the worker: its own D1), or null to fetch the worker's door. */
+export function useCampaignPins(reader) {
+    pinSource = reader;
+    pinsHeld.clear();
+}
+export async function fetchCampaignPins(campaign, fetchImpl = fetch) {
+    const base = foldUrl();
+    if (!base)
+        return null;
+    const key = `${base}|${campaign}`;
+    const held = pinsHeld.get(key);
+    const since = rewound(held?.through ?? null);
+    const door = `${base}/campaign/${encodeURIComponent(campaign)}/pins?limit=${ROWS_PAGE}${since ? `&since=${encodeURIComponent(since)}` : ""}`;
+    const pages = await pagesOf((after) => (after ? `${door}&after=${encodeURIComponent(after)}` : door), fetchImpl, isPinsPage);
+    /* No such door, the door said no, or it broke: what was synced before still
+       stands (pins do not vanish); with nothing synced, the caller reads bodies. */
+    if (!pages || pages === "unsupported" || pages.some((page) => page.campaign !== campaign))
+        return held?.pins ?? null;
+    const pins = new Map(held?.pins ?? []);
+    for (const page of pages) {
+        for (const row of page.rows) {
+            if (!row || typeof row.claimId !== "string")
+                continue;
+            if (row.approved && row.pin)
+                pins.set(row.claimId, row.pin);
+            else
+                pins.delete(row.claimId);
+        }
+    }
+    pinsHeld.set(key, { pins, through: pages[0].through });
+    return pins;
+}
+export async function readCampaignPins(campaign) {
+    try {
+        return pinSource ? await pinSource(campaign) : await fetchCampaignPins(campaign);
+    }
+    catch {
+        return null;
+    }
+}
+/** The Next.js cache tag on every standings read, so a switch-off can drop them at once. */
+export const STANDINGS_TAG = "standings";
+export async function fetchStandings(campaign, init = {}) {
+    const base = foldUrl();
+    if (!base || !campaign)
+        return null;
+    try {
+        const answer = await fetch(`${base}/campaign/${encodeURIComponent(campaign)}/standings`, {
+            signal: AbortSignal.timeout(init.timeoutMs ?? 6000),
+            next: { revalidate: init.revalidate ?? 60, tags: [STANDINGS_TAG] }
+        });
+        if (!answer.ok)
+            return null;
+        return (await answer.json());
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Send somebody's name preference for the board to the worker:
+ * `POST <fold>/campaign/<campaign>/name` with `body` as JSON.
+ *
+ * The body is the worker's contract, not this function's — it passes it on
+ * untouched. What comes back is the status and whatever JSON the worker said
+ * (null when it said none), so a caller can tell a refusal from a success
+ * and show the worker's reason. Null only when the worker could not be
+ * reached at all: none configured, the network, or the timeout.
+ */
+export async function postNamePref(campaign, body, fetchImpl = fetch, timeoutMs = FOLD_TIMEOUT_MS) {
+    const base = foldUrl();
+    if (!base || !campaign)
+        return null;
+    try {
+        const answer = await fetchImpl(`${base}/campaign/${encodeURIComponent(campaign)}/name`, {
+            method: "POST",
+            cache: "no-store",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(timeoutMs)
+        });
+        const json = await answer.json().catch(() => null);
+        return { status: answer.status, json };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=fold.js.map

package/dist/esm/campaign/fold.js.map

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

package/dist/esm/campaign/funding.d.ts

@@ -0,0 +1,153 @@
+import { pledgedFor, type Pledge, type PledgeLedger } from "./pledges.ts";
+import { type Assessment } from "./bands.ts";
+import type { CampaignRule } from "./rule.ts";
+/**
+ * Turning pledges into a posted cleanup — the moment money first moves.
+ *
+ * **This is the shared half.** It lived in the worker while only the worker
+ * could post; then a page had to draw a funding bar, and a bar that computes
+ * differently from the round is a bar that lies. Both apps and the worker now
+ * import exactly these functions, so what a backer is shown and what the pass
+ * will draw are the same arithmetic over the same reads. The half that stayed
+ * behind is the half that needs the worker's own identity: who checks, and
+ * which gate lets strangers in.
+ *
+ * Everything here is arranged around one property: **a pledge that cannot be
+ * drawn must cost nobody anything.** Draws ride inside the same transaction
+ * that opens the ask, so a revoked or overwritten allowance fails the whole
+ * posting rather than half-funding a spot; and because the chain's own
+ * `spendLimit` decrements as draws land, the caps are re-read here rather
+ * than trusted from the ledger.
+ *
+ * The other property, quieter but just as load-bearing: **the target comes
+ * from the assessment frozen into the approved mapping claim**, never from a
+ * live re-read. A spot's price is what it was when somebody stood in front of
+ * it and said so, and no later opinion — including a growth claim — moves it.
+ */
+/** What a backer can actually cover, in base units. The caller decides where
+ *  that number comes from — the chain, a fixture, or a page's own cache. */
+export type Reader = (granter: string, grantee: string) => Promise<number>;
+/** The optional second look, for saying WHY a pledge could not be drawn. */
+export type Diagnose = (granter: string, grantee: string) => Promise<{
+    allowance: number;
+    balance: number;
+}>;
+export interface Spot {
+    /** The mapping claim: the pin's identity everywhere. */
+    claimId: string;
+    lat: number;
+    lon: number;
+    place?: string | null;
+    /** Frozen at approval. The only input to the price. */
+    assessment: Assessment;
+    /**
+     * When the pin was reported. The clock an ongoing campaign down-bands by —
+     * absent on a campaign that has a deadline instead, and absent is simply a
+     * spot with no age, which never down-bands early.
+     */
+    mappedAt?: string | null;
+}
+/**
+ * A chain child's fundable unit: the approved answer itself. No assessment —
+ * the chain's own fixed target is the only price, and `planFor` refuses to
+ * walk one without it rather than invent a band that was never assessed.
+ */
+export interface ChainSpot {
+    claimId: string;
+    lat: number | null;
+    lon: number | null;
+    place?: string | null;
+    assessment?: undefined;
+}
+export interface Plan {
+    spot: Spot;
+    targetBase: number;
+    /** Verified against the chain, in the order they pledged. */
+    draws: {
+        address: string;
+        amountBase: string;
+    }[];
+    gapBase: number;
+    dropped: {
+        address: string;
+        amountBase: number;
+        why: string;
+    }[];
+}
+/**
+ * What the checker is paid per verdict, in base units.
+ *
+ * It lives here rather than in the worker's config because the bill is now
+ * computed in three places — the pass that posts, the page that draws the
+ * bar, and the youth app that says how much more is needed — and a leg that
+ * differed between them would be a target nobody could agree on. The worker's
+ * config re-exports this one, so there is still exactly one number.
+ */
+export declare const DEFAULT_CHECK_REWARD_BASE = 100000;
+/** `configure({ checkRewardBase })`, else `QI_CHECK_REWARD_BASE` read strictly, else 100000. */
+export declare const checkRewardBase: () => number;
+/**
+ * What the whole bill is: the work, plus whoever checks it.
+ *
+ * `checkBase` is the checker's flat reward (`QI_CHECK_REWARD_BASE`, read
+ * strictly in `config.ts`, or `configure({ checkRewardBase })`) unless the
+ * caller names one.
+ *
+ * The judge's address is a placeholder here on purpose. `checkerLegBase`
+ * prices the leg from the terms' *shape* — how many criteria, of which kinds
+ * — and never from who signs them, so the bill is the same number before
+ * anybody has been named. The posting path fills in the real checker.
+ */
+export declare function billFor(spot: Spot, denom?: string, checkBase?: number): {
+    workBase: number;
+    legBase: number;
+    targetBase: number;
+};
+/**
+ * Which pledges can actually be drawn, and how far they get.
+ *
+ * Reads every backer's remaining allowance from the chain and takes them in
+ * pledge order until the target is met. A pledge the allowance only partly
+ * covers is **drawn to the covered part** — the first rule here said "half a
+ * pledge is a decision nobody made" and dropped it whole, and the first real
+ * backer took it apart with one question: they had decided twice, a pledged
+ * intention and a signed allowance, and the drop honoured neither, counting
+ * 5 where the chain covered 12. The allowance is the bound, the pledge is
+ * the intent, and the draw is the largest number both decisions agree on.
+ * Only a pledge the chain covers not at all is dropped, and named, so the
+ * caller can say whose money went and why the gap exists.
+ */
+export declare function planFor(ledger: PledgeLedger, spot: Spot, agent: string, read: Reader, overrideTargetBase?: number, diagnose?: Diagnose): Promise<Plan>;
+export declare function planFor(ledger: PledgeLedger, spot: ChainSpot, agent: string, read: Reader, overrideTargetBase: number, diagnose?: Diagnose): Promise<Omit<Plan, "spot"> & {
+    spot: ChainSpot;
+}>;
+/**
+ * Is this spot ready to post, under the campaign's rule?
+ *
+ * Two ways to be ready. Fully funded is the ordinary one. The other is
+ * **down-banding**: posting for less than the whole bill, because a spot that
+ * has stood a long time with most of its money is better cleaned partly than
+ * left standing — and the cleanup terms are sized to what actually arrives.
+ *
+ * A one-day campaign down-bands at its deadline. An ongoing one has no
+ * deadline to reach, so it uses a clock: how long this pin has stood, and how
+ * much of its bill is covered. Both numbers come from the rule, never from
+ * here — the estate's own line is that a campaign's judgement belongs in a
+ * document somebody published, not in a constant somebody compiled.
+ */
+export declare function fundable(plan: Plan, rule: CampaignRule, opts: {
+    confirmed: boolean;
+    deadlinePassed: boolean;
+    /** How long the pin has stood, for a campaign whose rule keeps a clock. */
+    ageDays?: number;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    why: string;
+};
+/** For the log line, and for the map's gap sentence. */
+export declare const gapSentence: (plan: Pick<Plan, "gapBase" | "dropped">) => string;
+export declare const pledgedAgainst: typeof pledgedFor;
+export type { Pledge };
+//# sourceMappingURL=funding.d.ts.map

package/dist/esm/campaign/funding.d.ts.map

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