@vepler/sdk 2.164.0 → 3.0.0

package/dist/esm/address-search/__tests__/controller.test.js

@@ -0,0 +1,327 @@
+import { describe, expect, it } from "vitest";
+import { createAddressSearch } from "../controller.js";
+/** Deterministic clock + timer harness injected in place of real timers. */
+function createTimerHarness() {
+    let now = 0;
+    let nextId = 1;
+    const scheduled = new Map();
+    return {
+        timers: {
+            now: () => now,
+            setTimeout: (callback, ms) => {
+                const id = nextId++;
+                scheduled.set(id, { at: now + ms, callback });
+                return id;
+            },
+            clearTimeout: (handle) => {
+                scheduled.delete(handle);
+            },
+        },
+        advance(ms) {
+            now += ms;
+            for (const [id, task] of [...scheduled]) {
+                if (task.at <= now) {
+                    scheduled.delete(id);
+                    task.callback();
+                }
+            }
+        },
+    };
+}
+/** Let promise continuations queued by the transports run. */
+function flush() {
+    return new Promise((resolve) => setTimeout(resolve, 0));
+}
+function suggestion(uprn, title) {
+    return { id: `addr-${uprn}`, title, uprn, source: "address", matchedSubstrings: [], raw: { uprn, title } };
+}
+/** Same rows the server's candidate-set narrowing tests use. */
+const FIXTURE_ROWS = [
+    suggestion("100", "31 Christopher Court, Cherry Lane, Beverley, HU17 9TB"),
+    suggestion("101", "31 Christie Avenue, Beverley, HU17 9TB"),
+    suggestion("102", "112 Green Lane, York, YO42 2RW"),
+];
+const COMPLETE_SET = {
+    suggestions: FIXTURE_ROWS,
+    searchId: "set-1",
+    setComplete: true,
+    billing: null,
+};
+const TIERED_RESULT = {
+    suggestions: [suggestion("900", "Beverley, East Riding of Yorkshire")],
+    searchId: null,
+    setComplete: false,
+    billing: null,
+};
+function createSuggestMock(handler) {
+    const calls = [];
+    const transport = async (request) => {
+        calls.push(request);
+        return handler(request);
+    };
+    return { calls, transport };
+}
+function createRetrieveMock(handler) {
+    const calls = [];
+    return {
+        calls,
+        transport: async (request) => {
+            calls.push(request);
+            return handler(request);
+        },
+    };
+}
+function setup(suggestHandler, overrides = {}) {
+    const harness = createTimerHarness();
+    const suggest = createSuggestMock(suggestHandler);
+    const retrieve = createRetrieveMock(({ suggestion: picked }) => ({
+        record: { uprn: picked.uprn ?? "" },
+    }));
+    const controller = createAddressSearch({
+        suggest: suggest.transport,
+        retrieve: retrieve.transport,
+        timers: harness.timers,
+        ...overrides,
+    });
+    return { controller, suggestCalls: suggest.calls, retrieveCalls: retrieve.calls, advance: harness.advance };
+}
+describe("debounce and minimum length", () => {
+    it("coalesces a fast typing burst into one fetch for the final query", async () => {
+        const { controller, suggestCalls, advance } = setup(() => COMPLETE_SET);
+        for (const text of ["31 c", "31 ch", "31 chr", "31 chri"]) {
+            controller.input(text);
+            advance(100); // faster than the 250ms debounce
+        }
+        advance(250);
+        await flush();
+        expect(suggestCalls).toHaveLength(1);
+        expect(suggestCalls[0]?.query).toBe("31 chri");
+        expect(controller.getState().status).toBe("ready");
+    });
+    it("never fetches below three characters and clears suggestions", async () => {
+        const { controller, suggestCalls, advance } = setup(() => COMPLETE_SET);
+        controller.input("31 chri");
+        advance(300);
+        await flush();
+        expect(controller.getState().suggestions.length).toBeGreaterThan(0);
+        controller.input("31");
+        advance(1000);
+        await flush();
+        expect(suggestCalls).toHaveLength(1); // no second fetch
+        expect(controller.getState().status).toBe("idle");
+        expect(controller.getState().suggestions).toEqual([]);
+    });
+});
+describe("candidate-set protocol", () => {
+    it("holds a complete set and narrows extending keystrokes locally — zero further fetches", async () => {
+        const { controller, suggestCalls, advance } = setup(() => COMPLETE_SET);
+        controller.input("31 chri");
+        advance(300);
+        await flush();
+        expect(suggestCalls).toHaveLength(1);
+        controller.input("31 chris");
+        expect(controller.getState().status).toBe("ready");
+        expect(controller.getState().suggestions.map((s) => s.uprn)).toEqual(["100", "101"]);
+        controller.input("31 christo");
+        expect(controller.getState().suggestions.map((s) => s.uprn)).toEqual(["100"]);
+        expect(controller.getState().searchId).toBe("set-1");
+        expect(controller.getState().setComplete).toBe(true);
+        advance(1000);
+        await flush();
+        expect(suggestCalls).toHaveLength(1); // both narrows were local
+    });
+    it("re-queries WITHOUT a search_id when the local narrow empties (set exhaustion)", async () => {
+        const { controller, suggestCalls, advance } = setup(() => COMPLETE_SET);
+        controller.input("31 chri");
+        advance(300);
+        await flush();
+        controller.input("31 christopher zzz"); // extends the trigger but matches nothing held
+        expect(controller.getState().status).toBe("debouncing");
+        advance(250);
+        await flush();
+        expect(suggestCalls).toHaveLength(2);
+        expect(suggestCalls[1]?.query).toBe("31 christopher zzz");
+        expect(suggestCalls[1]?.searchId).toBeNull();
+    });
+    it("re-queries when the input no longer extends the trigger prefix (backspace past it)", async () => {
+        const { controller, suggestCalls, advance } = setup(() => COMPLETE_SET);
+        controller.input("31 chri");
+        advance(300);
+        await flush();
+        controller.input("31 ch"); // backspace past the trigger
+        advance(250);
+        await flush();
+        expect(suggestCalls).toHaveLength(2);
+        expect(suggestCalls[1]?.query).toBe("31 ch");
+        expect(suggestCalls[1]?.searchId).toBeNull();
+    });
+    it("issues at most 2 data fetches across a 10-keystroke chain", async () => {
+        const { controller, suggestCalls, advance } = setup(({ query }) => query.startsWith("31 chri") ? COMPLETE_SET : TIERED_RESULT);
+        const chain = [
+            "31 c",
+            "31 ch",
+            "31 chr",
+            "31 chri", // pause here → fetch 1 returns the complete set
+            "31 chris",
+            "31 christ",
+            "31 christo",
+            "31 christop",
+            "31 christoph",
+            "31 christophz", // typo exhausts the set → fetch 2
+        ];
+        for (const text of chain) {
+            controller.input(text);
+            advance(text === "31 chri" || text === "31 christophz" ? 300 : 100);
+            await flush();
+        }
+        expect(suggestCalls.length).toBeLessThanOrEqual(2);
+        expect(suggestCalls.map((c) => c.query)).toEqual(["31 chri", "31 christophz"]);
+    });
+    it("serves a repeated query from the cache without a fetch and re-adopts its set", async () => {
+        const { controller, suggestCalls, advance } = setup(({ query }) => query.startsWith("31 chri") ? COMPLETE_SET : TIERED_RESULT);
+        controller.input("31 chri");
+        advance(300);
+        await flush();
+        controller.input("beverley town"); // unrelated query displaces the held set context
+        advance(300);
+        await flush();
+        expect(suggestCalls).toHaveLength(2);
+        controller.input("31 chri"); // cache hit — instant, no fetch
+        expect(controller.getState().status).toBe("ready");
+        expect(controller.getState().searchId).toBe("set-1");
+        controller.input("31 christo"); // and the re-adopted set narrows locally
+        expect(controller.getState().suggestions.map((s) => s.uprn)).toEqual(["100"]);
+        advance(1000);
+        await flush();
+        expect(suggestCalls).toHaveLength(2);
+    });
+});
+describe("cancellation and stale responses", () => {
+    it("aborts the in-flight request when a new fetch supersedes it", async () => {
+        let release;
+        const { controller, suggestCalls, advance } = setup(({ query }) => query === "31 chri"
+            ? new Promise((resolve) => {
+                release = resolve;
+            })
+            : TIERED_RESULT);
+        controller.input("31 chri");
+        advance(250); // fetch 1 in flight, unresolved
+        controller.input("112 green");
+        advance(250); // fetch 2 supersedes
+        await flush();
+        expect(suggestCalls).toHaveLength(2);
+        expect(suggestCalls[0]?.signal.aborted).toBe(true);
+        expect(controller.getState().query).toBe("112 green");
+        expect(controller.getState().status).toBe("ready");
+        release?.(COMPLETE_SET); // the stale response finally lands…
+        await flush();
+        expect(controller.getState().suggestions).toEqual(TIERED_RESULT.suggestions); // …and is ignored
+    });
+});
+describe("select", () => {
+    it("fires the retrieve exactly once per selection, with the session id attached", async () => {
+        const { controller, retrieveCalls, advance } = setup(() => COMPLETE_SET);
+        controller.input("31 chri");
+        advance(300);
+        await flush();
+        const picked = controller.getState().suggestions[0];
+        expect(picked).toBeDefined();
+        if (picked === undefined)
+            return;
+        const [first, second] = await Promise.all([controller.select(picked), controller.select(picked)]);
+        expect(retrieveCalls).toHaveLength(1);
+        expect(retrieveCalls[0]?.searchId).toBe("set-1");
+        expect(retrieveCalls[0]?.suggestion.uprn).toBe("100");
+        expect(first).toEqual(second);
+        await controller.select(picked); // later re-selects also reuse the settled retrieve
+        expect(retrieveCalls).toHaveLength(1);
+    });
+    it("clears the idempotency guard when a retrieve fails, so it can be retried", async () => {
+        const harness = createTimerHarness();
+        const suggest = createSuggestMock(() => COMPLETE_SET);
+        let attempts = 0;
+        const controller = createAddressSearch({
+            suggest: suggest.transport,
+            retrieve: async ({ suggestion: picked }) => {
+                attempts += 1;
+                if (attempts === 1)
+                    throw new Error("transient");
+                return { record: { uprn: picked.uprn ?? "" } };
+            },
+            timers: harness.timers,
+        });
+        controller.input("31 chri");
+        harness.advance(300);
+        await flush();
+        const picked = controller.getState().suggestions[0];
+        expect(picked).toBeDefined();
+        if (picked === undefined)
+            return;
+        await expect(controller.select(picked)).rejects.toThrow("transient");
+        await expect(controller.select(picked)).resolves.toEqual({ record: { uprn: "100" } }.record);
+        expect(attempts).toBe(2);
+    });
+});
+describe("billing metadata", () => {
+    it("surfaces suggest billing headers on the state and the billing property", async () => {
+        const billing = { creditsCharged: 0, creditsBalance: 4200, alreadyCharged: false };
+        const { controller, advance } = setup(() => ({ ...COMPLETE_SET, billing }));
+        controller.input("31 chri");
+        advance(300);
+        await flush();
+        expect(controller.getState().billing).toEqual({ ...billing, receivedAt: 300 });
+        expect(controller.billing).toEqual({ ...billing, receivedAt: 300 });
+    });
+    it("updates billing from the retrieve response after a selection", async () => {
+        const harness = createTimerHarness();
+        const suggest = createSuggestMock(() => COMPLETE_SET);
+        const controller = createAddressSearch({
+            suggest: suggest.transport,
+            retrieve: async ({ suggestion: picked }) => ({
+                record: { uprn: picked.uprn ?? "" },
+                billing: { creditsCharged: 4, creditsBalance: 4196, alreadyCharged: false },
+            }),
+            timers: harness.timers,
+        });
+        controller.input("31 chri");
+        harness.advance(300);
+        await flush();
+        const picked = controller.getState().suggestions[0];
+        expect(picked).toBeDefined();
+        if (picked === undefined)
+            return;
+        await controller.select(picked);
+        expect(controller.billing).toEqual({
+            creditsCharged: 4,
+            creditsBalance: 4196,
+            alreadyCharged: false,
+            receivedAt: 300,
+        });
+    });
+});
+describe("subscription surface", () => {
+    it("notifies subscribers on every state change and stops after unsubscribe", async () => {
+        const { controller, advance } = setup(() => COMPLETE_SET);
+        const statuses = [];
+        const unsubscribe = controller.subscribe((state) => statuses.push(state.status));
+        controller.input("31 chri");
+        advance(300);
+        await flush();
+        expect(statuses).toEqual(["debouncing", "loading", "ready"]);
+        unsubscribe();
+        controller.input("31 christo");
+        expect(statuses).toHaveLength(3);
+    });
+    it("dispose cancels pending work and ignores further input", async () => {
+        const { controller, suggestCalls, advance } = setup(() => COMPLETE_SET);
+        controller.input("31 chri");
+        controller.dispose();
+        advance(1000);
+        await flush();
+        controller.input("31 christo");
+        advance(1000);
+        await flush();
+        expect(suggestCalls).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=controller.test.js.map

package/dist/esm/address-search/__tests__/controller.test.js.map

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

package/dist/esm/address-search/__tests__/default-transports.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=default-transports.test.d.ts.map

package/dist/esm/address-search/__tests__/default-transports.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-transports.test.d.ts","sourceRoot":"","sources":["../../../../src/address-search/__tests__/default-transports.test.ts"],"names":[],"mappings":""}

package/dist/esm/address-search/__tests__/default-transports.test.js

@@ -0,0 +1,159 @@
+import { describe, expect, it } from "vitest";
+import { createSuggestTransport, createUprnRetrieveTransport, parseBillingHeaders, } from "../default-transports.js";
+import { AddressSearchError } from "../errors.js";
+function fakeFetch(body, options = {}) {
+    const captured = [];
+    const status = options.status ?? 200;
+    const headerMap = new Map(Object.entries(options.headers ?? {}).map(([k, v]) => [k.toLowerCase(), v]));
+    const response = {
+        ok: status >= 200 && status < 300,
+        status,
+        headers: { get: (name) => headerMap.get(name.toLowerCase()) ?? null },
+        json: async () => body,
+    };
+    return {
+        captured,
+        fetch: async (url, init) => {
+            captured.push({ url, headers: init.headers, signal: init.signal });
+            return response;
+        },
+    };
+}
+const SERVER_ROW = {
+    id: "addr-100023336956",
+    title: "10 Downing Street, London, SW1A 2AA",
+    main_text: "10 Downing Street, London, SW1A 2AA",
+    type: "address",
+    source: "address",
+    score: 5,
+    relevanceScore: 1,
+    uprn: "100023336956",
+    matched_substrings: [{ offset: 0, length: 10 }],
+    main_text_matched_substrings: [{ offset: 0, length: 10 }],
+};
+describe("createSuggestTransport", () => {
+    it("requests /v1/search/suggest with the query, page cap, version header and api key", async () => {
+        const { fetch, captured } = fakeFetch({ object: "list", data: [], search_id: null, set_complete: false });
+        const transport = createSuggestTransport({ baseUrl: "https://api.example.com/", apiKey: "sk-test", fetch });
+        await transport({ query: "10 downing", searchId: null, signal: new AbortController().signal });
+        expect(captured).toHaveLength(1);
+        const request = captured[0];
+        expect(request?.url).toBe("https://api.example.com/v1/search/suggest?q=10+downing&limit=100");
+        expect(request?.headers["X-API-Version"]).toBe("2");
+        expect(request?.headers["x-api-key"]).toBe("sk-test");
+    });
+    it("passes search_id through when the caller narrows server-side", async () => {
+        const { fetch, captured } = fakeFetch({ data: [], search_id: "s-1", set_complete: true });
+        const transport = createSuggestTransport({ fetch });
+        await transport({ query: "10 downing st", searchId: "s-1", signal: new AbortController().signal });
+        expect(captured[0]?.url).toContain("search_id=s-1");
+    });
+    it("lifts rows, search_id, set_complete and billing headers out of the response", async () => {
+        const { fetch } = fakeFetch({ object: "list", data: [SERVER_ROW], search_id: "s-9", set_complete: true }, { headers: { "X-Credits-Charged": "0", "X-Credits-Balance": "4200", "X-Already-Charged": "false" } });
+        const transport = createSuggestTransport({ fetch });
+        const result = await transport({ query: "10 downing", searchId: null, signal: new AbortController().signal });
+        expect(result.searchId).toBe("s-9");
+        expect(result.setComplete).toBe(true);
+        expect(result.suggestions).toHaveLength(1);
+        expect(result.suggestions[0]).toMatchObject({
+            id: "addr-100023336956",
+            title: "10 Downing Street, London, SW1A 2AA",
+            uprn: "100023336956",
+            source: "address",
+            matchedSubstrings: [{ offset: 0, length: 10 }],
+        });
+        expect(result.suggestions[0]?.raw).toBe(SERVER_ROW);
+        expect(result.billing).toEqual({ creditsCharged: 0, creditsBalance: 4200, alreadyCharged: false });
+    });
+    it("parses the legacy envelope's result array and rows without a UPRN", async () => {
+        const { fetch } = fakeFetch({
+            success: true,
+            result: [{ id: "street-1", title: "Cherry Lane", source: "address" }],
+        });
+        const transport = createSuggestTransport({ fetch });
+        const result = await transport({ query: "cherry", searchId: null, signal: new AbortController().signal });
+        expect(result.suggestions).toEqual([
+            {
+                id: "street-1",
+                title: "Cherry Lane",
+                uprn: null,
+                source: "address",
+                matchedSubstrings: [],
+                raw: expect.anything(),
+            },
+        ]);
+        expect(result.searchId).toBeNull();
+        expect(result.setComplete).toBe(false);
+    });
+    it("throws an AddressSearchError on a non-2xx response", async () => {
+        const { fetch } = fakeFetch({ error: "nope" }, { status: 429 });
+        const transport = createSuggestTransport({ fetch });
+        await expect(transport({ query: "10 downing", searchId: null, signal: new AbortController().signal })).rejects.toThrow(AddressSearchError);
+    });
+});
+describe("parseBillingHeaders", () => {
+    const headersOf = (entries) => {
+        const map = new Map(Object.entries(entries).map(([k, v]) => [k.toLowerCase(), v]));
+        return { get: (name) => map.get(name.toLowerCase()) ?? null };
+    };
+    it("returns null when no billing header is present", () => {
+        expect(parseBillingHeaders(headersOf({}))).toBeNull();
+    });
+    it("parses partial header sets, leaving absent values null", () => {
+        expect(parseBillingHeaders(headersOf({ "X-Credits-Charged": "3" }))).toEqual({
+            creditsCharged: 3,
+            creditsBalance: null,
+            alreadyCharged: null,
+        });
+    });
+    it("accepts both boolean spellings of X-Already-Charged", () => {
+        expect(parseBillingHeaders(headersOf({ "X-Already-Charged": "true" }))?.alreadyCharged).toBe(true);
+        expect(parseBillingHeaders(headersOf({ "X-Already-Charged": "1" }))?.alreadyCharged).toBe(true);
+        expect(parseBillingHeaders(headersOf({ "X-Already-Charged": "false" }))?.alreadyCharged).toBe(false);
+    });
+    it("parses non-numeric header values to null rather than NaN", () => {
+        expect(parseBillingHeaders(headersOf({ "X-Credits-Balance": "unlimited" }))?.creditsBalance).toBeNull();
+    });
+});
+describe("createUprnRetrieveTransport", () => {
+    const fakeClient = {};
+    const record = { uprn: "100023336956" };
+    const pickedSuggestion = {
+        id: "addr-100023336956",
+        title: "10 Downing Street, London, SW1A 2AA",
+        uprn: "100023336956",
+        source: "address",
+        matchedSubstrings: [],
+        raw: null,
+    };
+    it("resolves the suggestion's UPRN through the injected lookup", async () => {
+        const requests = [];
+        const transport = createUprnRetrieveTransport(fakeClient, {
+            lookup: async (_client, request) => {
+                requests.push(request.uprn);
+                return { ok: true, value: record };
+            },
+        });
+        const result = await transport({ suggestion: pickedSuggestion, searchId: "s-1" });
+        expect(requests).toEqual(["100023336956"]);
+        expect(result.record).toBe(record);
+    });
+    it("throws the lookup's error when the lookup fails", async () => {
+        const transport = createUprnRetrieveTransport(fakeClient, {
+            lookup: async () => ({ ok: false, error: new Error("boom") }),
+        });
+        await expect(transport({ suggestion: pickedSuggestion, searchId: null })).rejects.toThrow("boom");
+    });
+    it("rejects suggestions without a UPRN before any request is made", async () => {
+        let called = false;
+        const transport = createUprnRetrieveTransport(fakeClient, {
+            lookup: async () => {
+                called = true;
+                return { ok: true, value: record };
+            },
+        });
+        await expect(transport({ suggestion: { ...pickedSuggestion, uprn: null }, searchId: null })).rejects.toThrow(AddressSearchError);
+        expect(called).toBe(false);
+    });
+});
+//# sourceMappingURL=default-transports.test.js.map

package/dist/esm/address-search/__tests__/default-transports.test.js.map

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

package/dist/esm/address-search/__tests__/narrow.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=narrow.test.d.ts.map

package/dist/esm/address-search/__tests__/narrow.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrow.test.d.ts","sourceRoot":"","sources":["../../../../src/address-search/__tests__/narrow.test.ts"],"names":[],"mappings":""}

package/dist/esm/address-search/__tests__/narrow.test.js

@@ -0,0 +1,61 @@
+import { describe, expect, it } from "vitest";
+import { extendsTriggerPrefix, narrowSuggestions, normaliseQuery } from "../narrow.js";
+/**
+ * Client-side narrowing must agree with the server's candidate-set narrowing
+ * (apps/api search suggest, `narrowCandidates`) on the same fixtures — a
+ * divergence would make client and server disagree about which rows survive
+ * a keystroke. Fixture rows and expectations are copied verbatim from the
+ * server's candidate-set unit tests.
+ */
+const ROWS = [
+    { uprn: "100", title: "31 Christopher Court, Cherry Lane, Beverley, HU17 9TB" },
+    { uprn: "101", title: "31 Christie Avenue, Beverley, HU17 9TB" },
+    { uprn: "102", title: "112 Green Lane, York, YO42 2RW" },
+];
+describe("narrowSuggestions — mirrors the server's narrowing semantics", () => {
+    it("keeps rows where every query token prefix-matches a title token, case-insensitively", () => {
+        const narrowed = narrowSuggestions(ROWS, "31 chri");
+        expect(narrowed.map((r) => r.uprn)).toEqual(["100", "101"]);
+    });
+    it("narrows further as the prefix grows (monotone: longer prefix, never more rows)", () => {
+        const narrowed = narrowSuggestions(ROWS, "31 christo");
+        expect(narrowed.map((r) => r.uprn)).toEqual(["100"]);
+    });
+    it("requires EVERY query token to match — one stray token empties the result", () => {
+        expect(narrowSuggestions(ROWS, "31 christopher zzz")).toEqual([]);
+    });
+    it("treats punctuation as separators on both sides (commas in titles never block a match)", () => {
+        expect(narrowSuggestions(ROWS, "cherry lane beverley").map((r) => r.uprn)).toEqual(["100"]);
+    });
+    it("matches mid-title tokens (a postcode prefix narrows to that postcode's rows)", () => {
+        expect(narrowSuggestions(ROWS, "hu17").map((r) => r.uprn)).toEqual(["100", "101"]);
+    });
+    it("returns the whole set for an empty or separator-only query", () => {
+        expect(narrowSuggestions(ROWS, "")).toHaveLength(3);
+        expect(narrowSuggestions(ROWS, " , ")).toHaveLength(3);
+    });
+    it("preserves the served order", () => {
+        const narrowed = narrowSuggestions(ROWS, "beverley");
+        expect(narrowed.map((r) => r.uprn)).toEqual(["100", "101"]);
+    });
+});
+describe("extendsTriggerPrefix — when local narrowing stays sound", () => {
+    it("accepts a query that extends the trigger prefix", () => {
+        expect(extendsTriggerPrefix("31 chris", "31 chri")).toBe(true);
+    });
+    it("accepts case and whitespace variants of the trigger itself", () => {
+        expect(extendsTriggerPrefix("31  CHRI", "31 chri")).toBe(true);
+    });
+    it("rejects a backspace past the trigger prefix", () => {
+        expect(extendsTriggerPrefix("31 ch", "31 chri")).toBe(false);
+    });
+    it("rejects an edit inside the trigger prefix", () => {
+        expect(extendsTriggerPrefix("32 chri", "31 chri")).toBe(false);
+    });
+});
+describe("normaliseQuery — the cache and prefix key form", () => {
+    it("lower-cases, collapses whitespace runs and trims", () => {
+        expect(normaliseQuery("  31  Christopher   Court ")).toBe("31 christopher court");
+    });
+});
+//# sourceMappingURL=narrow.test.js.map

package/dist/esm/address-search/__tests__/narrow.test.js.map

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

package/dist/esm/address-search/controller.d.ts

@@ -0,0 +1,14 @@
+import type { AddressSearchController, AddressSearchOptions } from "./types.js";
+/**
+ * Headless address autocomplete controller (SV2-C1). Framework-agnostic: no
+ * DOM access, no framework dependencies — feed keystrokes to `input()`,
+ * render from `subscribe()`/`getState()`, resolve a pick with `select()`.
+ *
+ * The point of the controller is the candidate-set protocol: once a response
+ * arrives with `set_complete: true`, further keystrokes that extend the
+ * fetched prefix narrow the held set locally — no request, no new royalty
+ * transaction. The server is consulted again only when the local narrow
+ * empties (set exhaustion) or the input stops extending the trigger prefix.
+ */
+export declare function createAddressSearch<TRecord = unknown>(options: AddressSearchOptions<TRecord>): AddressSearchController<TRecord>;
+//# sourceMappingURL=controller.d.ts.map

package/dist/esm/address-search/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/address-search/controller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EAEvB,oBAAoB,EAOrB,MAAM,YAAY,CAAC;AA6BpB;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACnD,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,GACrC,uBAAuB,CAAC,OAAO,CAAC,CAoKlC"}