@ixo/openhands-sdk 0.0.0-stage → 0.1.0

package/dist/esm/data/board/query.js

@@ -0,0 +1,67 @@
+import { isActivity, isKind, ORDERS } from "./types.js";
+import { DEFAULT_KM, DEFAULT_SIZE, MAX_KM, MAX_Q, MAX_SIZE, roundPoint } from "./url.js";
+export { DEFAULT_KM, DEFAULT_SIZE, EMPTY_QUERY, MAX_KM, MAX_Q, MAX_SIZE, queryString, roundPoint } from "./url.js";
+/**
+ * A board query to and from a URL — the one grammar the page, the app's
+ * proxy, the worker and the MCP all speak, so `?kind=photo` means the same
+ * thing wherever it is typed.
+ *
+ * Everything is bounded on the way in, whoever sent it: a query string is
+ * something a stranger writes. And a location is rounded to two decimals
+ * (about a kilometre) before it is ever put in a URL — close enough to rank
+ * by, too coarse to be where somebody lives, and coarse enough that the edge
+ * can cache one answer for everybody in the same square kilometre.
+ */
+const TAG = /^[a-z0-9-]{1,64}$/;
+const ADDRESS = /^ixo1[02-9ac-hj-np-z]{20,80}$/;
+const clampInt = (raw, fallback, low, high) => {
+    /* Absent is the default, not zero: `Number(null)` is 0, which would clamp a missing size to one row. */
+    if (raw === null || raw.trim() === "")
+        return fallback;
+    const value = Math.floor(Number(raw));
+    return Number.isFinite(value) ? Math.min(high, Math.max(low, value)) : fallback;
+};
+export function parsePoint(raw) {
+    if (!raw)
+        return null;
+    const [a, b] = raw.split(",").map((part) => Number(part.trim()));
+    if (a === undefined || b === undefined || !Number.isFinite(a) || !Number.isFinite(b))
+        return null;
+    if (Math.abs(a) > 90 || Math.abs(b) > 180)
+        return null;
+    return roundPoint({ lat: a, lon: b });
+}
+export function parseQuery(params) {
+    const kinds = (params.get("kind") ?? "")
+        .split(",")
+        .map((one) => one.trim())
+        .filter(isKind);
+    const does = (params.get("does") ?? "")
+        .split(",")
+        .map((one) => one.trim())
+        .filter(isActivity);
+    const order = params.get("order");
+    const campaign = (params.get("campaign") ?? "").trim();
+    const owner = (params.get("owner") ?? "").trim();
+    const pay = Number(params.get("pay"));
+    return {
+        near: parsePoint(params.get("near")),
+        km: clampInt(params.get("km"), DEFAULT_KM, 1, MAX_KM),
+        kinds: [...new Set(kinds)],
+        does: [...new Set(does)],
+        minPay: Number.isFinite(pay) && pay > 0 ? Math.min(pay, 1_000_000) : 0,
+        q: (params.get("q") ?? "").replace(/\s+/g, " ").trim().slice(0, MAX_Q),
+        order: ORDERS.includes(order) ? order : "best",
+        campaign: TAG.test(campaign) ? campaign : "",
+        owner: ADDRESS.test(owner) ? owner : "",
+        series: /^[a-z0-9]{1,32}$/.test(params.get("series") ?? "") ? params.get("series") : "",
+        view: params.get("view") === "rest" ? "rest" : "lead",
+        page: clampInt(params.get("page"), 1, 1, 1000),
+        size: clampInt(params.get("size"), DEFAULT_SIZE, 1, MAX_SIZE)
+    };
+}
+/** Kinds as a set, for the rail and the sheet. */
+export const kindSet = (kinds) => new Set(kinds);
+/** Activities as a set. */
+export const activitySet = (does) => new Set(does);
+//# sourceMappingURL=query.js.map

package/dist/esm/data/board/query.js.map

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

package/dist/esm/data/board/rank.d.ts

@@ -0,0 +1,22 @@
+import type { BoardOrder } from "./types.ts";
+/** Great-circle distance in kilometres. */
+export declare function distanceKm(a: {
+    lat: number;
+    lon: number;
+}, b: {
+    lat: number;
+    lon: number;
+}): number;
+export { kmWords } from "./words.ts";
+/** What the ranking reads off a card, however many asks the card stands for. */
+export interface SortKeys {
+    km?: number;
+    /** In display units. A pool pays what backers put in, which is no figure: 0. */
+    pay: number;
+    /** The newest member's collection id. */
+    newest: number;
+    /** The soonest end among members, as epoch ms; Infinity when none ends. */
+    endsAt: number;
+}
+export declare function rankKeys<T extends SortKeys>(cards: T[], order: BoardOrder, near: boolean, reach: number): T[];
+//# sourceMappingURL=rank.d.ts.map

package/dist/esm/data/board/rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../../../src/data/board/rank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkB7C,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAMnG;AAED,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAc7G"}

package/dist/esm/data/board/rank.js

@@ -0,0 +1,45 @@
+/**
+ * The order of the board, in rules a person can be told in a sentence.
+ *
+ * **Best for you**: when we know where you are, what you can reach soonest —
+ * everything within your radius, closest first; then work you can do from
+ * anywhere, best paid first; then the rest, closest first. When we do not know
+ * where you are, the newest first. Nothing else goes into it, and nothing ever
+ * will that could not be said as plainly.
+ *
+ * `newest` is the posting order — collection ids only ever grow — rather than
+ * a start date, which is whatever the poster wrote (testnet holds one dated
+ * 2027) and so no order at all.
+ */
+const EARTH_KM = 6371;
+/** Great-circle distance in kilometres. */
+export function distanceKm(a, b) {
+    const rad = Math.PI / 180;
+    const dLat = (b.lat - a.lat) * rad;
+    const dLon = (b.lon - a.lon) * rad;
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(a.lat * rad) * Math.cos(b.lat * rad) * Math.sin(dLon / 2) ** 2;
+    return 2 * EARTH_KM * Math.asin(Math.min(1, Math.sqrt(h)));
+}
+export { kmWords } from "./words.js";
+export function rankKeys(cards, order, near, reach) {
+    const tier = (card) => (card.km === undefined ? 1 : card.km <= reach ? 0 : 2);
+    const byNewest = (a, b) => b.newest - a.newest;
+    const sorted = [...cards];
+    if (order === "new")
+        return sorted.sort(byNewest);
+    if (order === "pay")
+        return sorted.sort((a, b) => b.pay - a.pay || byNewest(a, b));
+    if (order === "ending")
+        return sorted.sort((a, b) => a.endsAt - b.endsAt || byNewest(a, b));
+    if (!near)
+        return sorted.sort(byNewest);
+    return sorted.sort((a, b) => {
+        const t = tier(a) - tier(b);
+        if (t !== 0)
+            return t;
+        if (tier(a) === 1)
+            return b.pay - a.pay || byNewest(a, b);
+        return (a.km ?? 0) - (b.km ?? 0) || byNewest(a, b);
+    });
+}
+//# sourceMappingURL=rank.js.map

package/dist/esm/data/board/rank.js.map

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

package/dist/esm/data/board/read.d.ts

@@ -0,0 +1,102 @@
+import type { ThreadListItem } from "../threads.ts";
+import { type BoardGroup, type CampaignMembers } from "./assemble.ts";
+import type { CoverageAnswer, CoveragePlacesAnswer } from "./coverage.ts";
+import { type BoardAnswer, type BoardQuery, type BoardRow, type CatalogAsk, type ClustersAnswer, type Screen, type Trust } from "./types.ts";
+/**
+ * The board, read by the app's server — from the worker's catalogue, or, when
+ * the worker does not answer, from the index directly, the way the board
+ * always read it. Server-only: this pulls the index client. Client code
+ * imports `board/types` and `board/query`, never this.
+ *
+ * **Degraded is normal, not exceptional** (PRODUCT.md). A worker that is
+ * down, not deployed yet, or deployed without its migration answers 503 or
+ * nothing at all, and the page renders from the fallback: fewer rows (the
+ * newest thirty plus forty of ours), no trust figures, no folds it cannot
+ * compute — but never a blank board.
+ */
+export interface WorkerRead {
+    /** The worker's base URL. Empty: go straight to the fallback. */
+    workerUrl: string;
+    /**
+     * The app's proxy secret, so the worker can tell its own app from a stranger.
+     *
+     * The only thing a read may carry (scale review 2026-10, A10): it used to
+     * take arbitrary headers and was handed the caller's address, and Next's
+     * fetch cache keys on headers — one cache entry per visitor. A secret is
+     * the same on every read, so the cache stays shared; a caller is not
+     * representable here at all.
+     */
+    proxySecret?: string;
+    /** How long to wait for the worker before the fallback. Default 2.5 s: an interactive read (B13). */
+    timeoutMs?: number;
+    /** Injected in tests; `loadThreads` + `gateGranters` otherwise. */
+    fallback?: () => Promise<CatalogAsk[]>;
+    fetchImpl?: typeof fetch;
+}
+/** What waits for the worker before the fallback, unless the reader says otherwise. */
+export declare const WORKER_TIMEOUT_MS = 2500;
+/** The headers a worker read carries: what it accepts, and the proxy secret when there is one. Never a caller. */
+export declare const workerHeaders: (read: Pick<WorkerRead, "proxySecret">) => Record<string, string>;
+/** Today's recency read, as catalogue rows. No owner, so no trust and no poster cap beyond the escrow account. */
+export declare function catalogFromThreads(threads: ThreadListItem[], granted: ReadonlySet<string>): CatalogAsk[];
+export declare function loadBoard(query: BoardQuery, read: WorkerRead): Promise<BoardAnswer>;
+export declare function loadClusters(query: BoardQuery, view: {
+    south: number;
+    west: number;
+    north: number;
+    east: number;
+    zoom: number;
+}, read: WorkerRead): Promise<ClustersAnswer>;
+export interface SeriesAnswer {
+    v: 1;
+    key: string;
+    title: string;
+    rows: BoardRow[];
+    open: number;
+    count: number;
+    trust: Trust;
+}
+export declare function loadSeries(key: string, query: BoardQuery, read: WorkerRead): Promise<SeriesAnswer | null>;
+export interface TripAnswer {
+    v: 1;
+    lead: string;
+    title: string;
+    rows: BoardRow[];
+    open: number;
+}
+/** A trip's open members (Part E) — the catalogue's, or drawn here from the index when the worker cannot answer. */
+export declare function loadTrip(lead: string, query: BoardQuery, read: WorkerRead): Promise<TripAnswer | null>;
+export interface CampaignGroupAnswer extends CampaignMembers {
+    v: 1;
+    tag: string;
+}
+/**
+ * One campaign's page (IXO-5270): the worker's catalogue, or — where the
+ * worker has not been deployed with the route yet — the index directly, the
+ * way `loadSeries` falls back.
+ */
+export declare function loadCampaignGroup(tag: string, query: BoardQuery, read: WorkerRead): Promise<CampaignGroupAnswer | null>;
+/**
+ * The group an ask folds into, for its page's way back (IXO-5271). The worker
+ * only: a nicety is never worth reading the whole index for, and the ask page
+ * falls back to the campaign its own terms name.
+ */
+/**
+ * Where one ask sits on the board — the group it folds into, and what the
+ * screen made of it (Part C) — or null when the worker could not say.
+ */
+export declare function loadAskOnBoard(id: string, read: WorkerRead): Promise<{
+    group: BoardGroup | null;
+    screen: Screen | null;
+} | null>;
+/** How many asks agents posted here through our MCP in the last week, or null when the worker cannot say (Part D). */
+export declare function loadAgentWeek(read: WorkerRead): Promise<number | null>;
+/** How the asks near a point were answered over ninety days (Part G), or null when the worker cannot say. */
+export declare function loadCoverage(near: {
+    lat: number;
+    lon: number;
+}, km: number, read: WorkerRead): Promise<CoverageAnswer | null>;
+/** The busiest places' figures, for the agents page (Part G), or null when the worker cannot say. */
+export declare function loadCoveragePlaces(read: WorkerRead): Promise<CoveragePlacesAnswer | null>;
+export declare function loadGroupOf(id: string, read: WorkerRead): Promise<BoardGroup | null>;
+//# sourceMappingURL=read.d.ts.map

package/dist/esm/data/board/read.d.ts.map

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

package/dist/esm/data/board/read.js

@@ -0,0 +1,163 @@
+import { assembleBoard, campaignMembers, clustersOf, seriesMembers, tripMembers } from "./assemble.js";
+import { queryString } from "./query.js";
+import { kindOf } from "./types.js";
+/** What waits for the worker before the fallback, unless the reader says otherwise. */
+export const WORKER_TIMEOUT_MS = 2_500;
+/** The headers a worker read carries: what it accepts, and the proxy secret when there is one. Never a caller. */
+export const workerHeaders = (read) => ({
+    accept: "application/json",
+    ...(read.proxySecret ? { "x-openhands-proxy": read.proxySecret } : {})
+});
+/* `seen` hears the worker's response before its body is read — how a reader learns a header such as
+   `x-board-truncated` without every caller of this helper changing shape. */
+async function fromWorker(path, read, seen) {
+    if (!read.workerUrl)
+        return null;
+    try {
+        const response = await (read.fetchImpl ?? fetch)(`${read.workerUrl.replace(/\/$/, "")}${path}`, {
+            headers: workerHeaders(read),
+            signal: AbortSignal.timeout(read.timeoutMs ?? WORKER_TIMEOUT_MS),
+            /* Fifteen seconds, the board's own clock: the page stays statically
+               revalidated rather than rendering per visitor. `next` is Next's own
+               addition to RequestInit, absent from the plain lib. */
+            next: { revalidate: 15 }
+        });
+        if (!response.ok)
+            return null;
+        seen?.(response);
+        return (await response.json());
+    }
+    catch {
+        return null;
+    }
+}
+/** A symbol back to its base denom, for the fallback's rows. Six decimals, as every coin this board pays in has. */
+const denomFor = (symbol) => `u${symbol.toLowerCase()}`;
+/** Today's recency read, as catalogue rows. No owner, so no trust and no poster cap beyond the escrow account. */
+export function catalogFromThreads(threads, granted) {
+    return threads.map((thread) => ({
+        id: thread.id,
+        title: thread.title,
+        named: thread.named,
+        admin: thread.admin,
+        owner: null,
+        state: thread.state,
+        payDenom: thread.pays ? denomFor(thread.pays.symbol) : null,
+        payBase: thread.pool ? 1 : thread.pays ? Math.round(thread.pays.value * 1_000_000) : 0,
+        pool: Boolean(thread.pool),
+        quota: Number(thread.quota) || 0,
+        count: thread.count,
+        approved: thread.approved,
+        disputed: thread.disputed,
+        startDate: thread.lastEventAt,
+        endDate: thread.endDate,
+        lastEventAt: thread.lastEventAt,
+        lastEventLine: thread.lastEventLine,
+        lastEventActor: thread.lastEventActor ?? null,
+        deliverable: thread.deliverable ?? null,
+        kind: kindOf(thread.deliverable),
+        campaign: thread.campaign ?? null,
+        series: null,
+        place: thread.place ?? null,
+        ours: granted.has(thread.admin)
+    }));
+}
+async function defaultFallback() {
+    const [{ loadThreads }, { gateGranters }] = await Promise.all([import("../threads.js"), import("../granters.js")]);
+    const [threads, granted] = await Promise.all([loadThreads(), gateGranters().catch(() => [])]);
+    return catalogFromThreads(threads, new Set(granted));
+}
+const fallbackOf = (read) => read.fallback ?? defaultFallback;
+const none = new Map();
+export async function loadBoard(query, read) {
+    /* The worker says `x-board-truncated: 1` when the open set held more asks than one read
+       loads; the app read it nowhere (final review 2026-10, WN9e #8). Carried on the
+       payload so the list can say it shows the newest, rather than imply it shows all. */
+    let truncated = false;
+    const answer = await fromWorker(`/board${queryString(query)}`, read, (response) => {
+        truncated = response.headers.get("x-board-truncated") === "1";
+    });
+    if (answer?.v === 1)
+        return { ...answer, source: "catalogue", ...(truncated ? { truncated: true } : {}) };
+    const catalog = await fallbackOf(read)().catch(() => []);
+    return { ...assembleBoard(catalog, none, query, new Date(), { posterCap: 0 }), source: "fallback" };
+}
+export async function loadClusters(query, view, read) {
+    const bbox = `bbox=${[view.south, view.west, view.north, view.east].map((one) => Math.round(one * 1000) / 1000).join(",")}&zoom=${Math.floor(view.zoom)}`;
+    const search = queryString(query);
+    const answer = await fromWorker(`/board/clusters${search ? `${search}&` : "?"}${bbox}`, read);
+    if (answer?.v === 1)
+        return { ...answer, source: "catalogue" };
+    const catalog = await fallbackOf(read)().catch(() => []);
+    return { ...clustersOf(catalog, none, query, view), source: "fallback" };
+}
+export async function loadSeries(key, query, read) {
+    if (!/^[a-z0-9]{1,32}$/.test(key))
+        return null;
+    const answer = await fromWorker(`/board/series/${key}${queryString(query)}`, read);
+    if (answer?.v === 1)
+        return answer;
+    const catalog = await fallbackOf(read)().catch(() => []);
+    const found = seriesMembers(catalog, none, key, query, new Date());
+    return found ? { v: 1, key, ...found } : null;
+}
+/** A trip's open members (Part E) — the catalogue's, or drawn here from the index when the worker cannot answer. */
+export async function loadTrip(lead, query, read) {
+    if (!/^\d{1,12}$/.test(lead))
+        return null;
+    const answer = await fromWorker(`/board/trip/${lead}${queryString(query)}`, read);
+    if (answer?.v === 1)
+        return answer;
+    const catalog = await fallbackOf(read)().catch(() => []);
+    const found = tripMembers(catalog, none, lead, query, new Date());
+    return found ? { v: 1, lead, ...found } : null;
+}
+/**
+ * One campaign's page (IXO-5270): the worker's catalogue, or — where the
+ * worker has not been deployed with the route yet — the index directly, the
+ * way `loadSeries` falls back.
+ */
+export async function loadCampaignGroup(tag, query, read) {
+    if (!/^[a-z0-9-]{1,64}$/.test(tag))
+        return null;
+    const answer = await fromWorker(`/board/campaign/${tag}${queryString(query)}`, read);
+    if (answer?.v === 1)
+        return answer;
+    const catalog = await fallbackOf(read)().catch(() => []);
+    const found = campaignMembers(catalog, none, tag, query, new Date());
+    return found ? { v: 1, tag, ...found } : null;
+}
+/**
+ * The group an ask folds into, for its page's way back (IXO-5271). The worker
+ * only: a nicety is never worth reading the whole index for, and the ask page
+ * falls back to the campaign its own terms name.
+ */
+/**
+ * Where one ask sits on the board — the group it folds into, and what the
+ * screen made of it (Part C) — or null when the worker could not say.
+ */
+export async function loadAskOnBoard(id, read) {
+    if (!/^\d{1,12}$/.test(id))
+        return null;
+    const answer = await fromWorker(`/board/of/${id}`, read);
+    return answer?.v === 1 ? { group: answer.group, screen: answer.screen ?? null } : null;
+}
+/** How many asks agents posted here through our MCP in the last week, or null when the worker cannot say (Part D). */
+export async function loadAgentWeek(read) {
+    const answer = await fromWorker("/board/agents", read);
+    return answer?.v === 1 && typeof answer.asked === "number" ? answer.asked : null;
+}
+/** How the asks near a point were answered over ninety days (Part G), or null when the worker cannot say. */
+export async function loadCoverage(near, km, read) {
+    const answer = await fromWorker(`/board/coverage?near=${near.lat},${near.lon}&km=${km}`, read);
+    return answer?.v === 1 && typeof answer.asked === "number" ? answer : null;
+}
+/** The busiest places' figures, for the agents page (Part G), or null when the worker cannot say. */
+export async function loadCoveragePlaces(read) {
+    const answer = await fromWorker("/board/coverage/places", read);
+    return answer?.v === 1 && Array.isArray(answer.places) ? answer : null;
+}
+export async function loadGroupOf(id, read) {
+    return (await loadAskOnBoard(id, read))?.group ?? null;
+}
+//# sourceMappingURL=read.js.map

package/dist/esm/data/board/read.js.map

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

package/dist/esm/data/board/series.d.ts

@@ -0,0 +1,50 @@
+import type { CatalogAsk } from "./types.ts";
+/**
+ * What a series is (D4 of docs/verified-work-board-volume-plan.md).
+ *
+ * An agent that needs two hundred storefronts photographed posts two hundred
+ * asks, one per address — each its own escrow, each paid on its own approval.
+ * On a board that is two hundred cards saying the same sentence with a
+ * different number in it, which is not a market, it is a wall. So asks that
+ * are plainly one job fold into one card, in one of two ways:
+ *
+ * - **Explicitly**: whoever posted them froze the same `terms.series` tag into
+ *   each (the MCP's `post_ask` takes it). Two or more open members fold.
+ * - **By shape**: `min` or more asks from one poster, of one kind, paying the
+ *   same amount, whose sentences are the same once the numbers and the place
+ *   are taken out, posted within a day of each other. A batch is a batch
+ *   whether or not its poster thought to say so.
+ *
+ * A series card says the same words either way. The key is stable across
+ * requests (it is what `/board/series/<key>` names), and says nothing about
+ * the poster: a short hash, not an address.
+ */
+export declare const SERIES_MIN = 5;
+/** Consecutive members further apart than this are two batches, not one. */
+export declare const BATCH_GAP_MS: number;
+/** FNV-1a over UTF-16 units, as eight hex digits. Stable, dependency-free, not a secret. */
+export declare function shortHash(text: string): string;
+/**
+ * A sentence with its particulars taken out: lower case, no digits, and
+ * nothing from the first place-clause on ("…at Trubarjeva cesta 12",
+ * "…, within 150 m of…", "… — near …"). What is left is the job.
+ */
+export declare function normalizedTitle(title: string): string;
+/**
+ * A series card's own sentence: the words every member starts with, cut back
+ * to a whole word and past any dangling preposition. Falls back to the first
+ * member's sentence when the members share too little to say anything.
+ */
+export declare function seriesTitle(titles: string[]): string;
+/** The part of a member's sentence that the series title does not already say — its address, usually. */
+export declare function memberLabel(title: string, series: string): string;
+/**
+ * Asks grouped into series, and the rest. `asks` may be any set — the open
+ * ones for the board, every known one for a series' own count — and the keys
+ * come out the same for the same members.
+ */
+export declare function groupSeries(asks: CatalogAsk[], min?: number): {
+    groups: Map<string, CatalogAsk[]>;
+    loose: CatalogAsk[];
+};
+//# sourceMappingURL=series.d.ts.map

package/dist/esm/data/board/series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"series.d.ts","sourceRoot":"","sources":["../../../../src/data/board/series.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,4EAA4E;AAC5E,eAAO,MAAM,YAAY,QAAmB,CAAC;AAE7C,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBpD;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjE;AAQD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,GAAE,MAAmB,GAAG;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAqDpI"}