@konstit/dne 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/README.md +42 -35
  2. package/dist/address-search-index.d.ts +34 -0
  3. package/dist/address-search-index.js +326 -0
  4. package/dist/address-search-index.js.map +1 -0
  5. package/dist/address-search-pool-errors.d.ts +15 -0
  6. package/dist/address-search-pool-errors.js +25 -0
  7. package/dist/address-search-pool-errors.js.map +1 -0
  8. package/dist/address-search-pool.d.ts +40 -0
  9. package/dist/address-search-pool.js +215 -0
  10. package/dist/address-search-pool.js.map +1 -0
  11. package/dist/address-search-rank.d.ts +5 -0
  12. package/dist/address-search-rank.js +89 -0
  13. package/dist/address-search-rank.js.map +1 -0
  14. package/dist/address-search-text.d.ts +6 -0
  15. package/dist/address-search-text.js +16 -0
  16. package/dist/address-search-text.js.map +1 -0
  17. package/dist/address-search-worker-runtime.d.ts +41 -0
  18. package/dist/address-search-worker-runtime.js +38 -0
  19. package/dist/address-search-worker-runtime.js.map +1 -0
  20. package/dist/address-search-worker-source.d.ts +2 -0
  21. package/dist/address-search-worker-source.js +5 -0
  22. package/dist/address-search-worker-source.js.map +1 -0
  23. package/dist/address-search.d.ts +31 -0
  24. package/dist/address-search.js +152 -0
  25. package/dist/address-search.js.map +1 -0
  26. package/dist/binary-db-errors.d.ts +1 -1
  27. package/dist/binary-db-errors.js +1 -1
  28. package/dist/binary-db-errors.js.map +1 -1
  29. package/dist/binary-db-reader.d.ts +18 -12
  30. package/dist/binary-db-reader.js +64 -43
  31. package/dist/binary-db-reader.js.map +1 -1
  32. package/dist/binary-db-validator.js +3 -6
  33. package/dist/binary-db-validator.js.map +1 -1
  34. package/dist/chunks/dynamic-completion-wbp85hh9-cytdw6ns.js +7 -0
  35. package/dist/chunks/dynamic-completion-wbp85hh9-cytdw6ns.js.map +10 -0
  36. package/dist/chunks/index-338dn00y.js +18 -0
  37. package/dist/chunks/index-338dn00y.js.map +10 -0
  38. package/dist/expand.d.ts +8 -0
  39. package/dist/expand.js +1484 -0
  40. package/dist/expand.js.map +1 -0
  41. package/dist/fsst.d.ts +1 -1
  42. package/dist/index.js +48 -48
  43. package/dist/index.js.map +25 -20
  44. package/dist/library.d.ts +9 -2
  45. package/dist/library.js +9 -2
  46. package/dist/library.js.map +1 -1
  47. package/dist/settings.d.ts +0 -2
  48. package/dist/settings.js +0 -2
  49. package/dist/settings.js.map +1 -1
  50. package/dist/shared-file.d.ts +2 -0
  51. package/dist/shared-file.js +35 -0
  52. package/dist/shared-file.js.map +1 -0
  53. package/dist/sqlite-db-reader.d.ts +13 -4
  54. package/dist/sqlite-db-reader.js +39 -17
  55. package/dist/sqlite-db-reader.js.map +1 -1
  56. package/dist/types.d.ts +29 -4
  57. package/dist/types.js +73 -4
  58. package/dist/types.js.map +1 -1
  59. package/package.json +13 -10
  60. package/data/dne.bin +0 -0
  61. package/dist/chunks/dynamic-completion-403da357-4jc4w04x.js +0 -7
  62. package/dist/chunks/dynamic-completion-403da357-4jc4w04x.js.map +0 -10
  63. package/dist/chunks/index-s0h4vdva.js +0 -17
  64. package/dist/chunks/index-s0h4vdva.js.map +0 -10
@@ -0,0 +1,40 @@
1
+ import type { AddressSearchOptions } from './address-search.ts';
2
+ import type { DneRow } from './types.ts';
3
+ /** Native Bun workers share immutable database/index bytes and own their search workspaces. */
4
+ export type AddressSearchPoolOptions = {
5
+ /** Path to the binary database. Relative paths use the caller's current directory at open(). */
6
+ databasePath: string;
7
+ /** Path to the prebuilt index matching the database. */
8
+ indexPath: string;
9
+ /** Positive integer. Defaults to 1; additional workers consume additional memory. */
10
+ workers?: number;
11
+ /** Maximum waiting searches, excluding running searches. Defaults to 64; 0 disables waiting. */
12
+ maxQueue?: number;
13
+ };
14
+ export type AddressSearchAsyncOptions = AddressSearchOptions & {
15
+ /** Rejects with signal.reason. Running calculations finish, but their results are discarded. */
16
+ signal?: AbortSignal;
17
+ };
18
+ /** Persistent workers keep synchronous address searches off the HTTP thread. Close the pool when the application stops. */
19
+ export declare class DneAddressSearchPool {
20
+ private readonly maxQueue;
21
+ private readonly slots;
22
+ private readonly queue;
23
+ private readonly drained;
24
+ private accepting;
25
+ private terminating;
26
+ private closing?;
27
+ private failure?;
28
+ private constructor();
29
+ /** Resolves only after every worker has loaded and validated its database and index. Cleans up all workers on failure. */
30
+ static open(options: AddressSearchPoolOptions): Promise<DneAddressSearchPool>;
31
+ /** Matches the synchronous API's results and ranking. All failures are promise rejections. */
32
+ searchAddresses(text: string, options?: AddressSearchAsyncOptions): Promise<DneRow[]>;
33
+ /** Stops admission, drains accepted searches (including cancelled calculations), then waits for every worker to exit. Idempotent. */
34
+ close(): Promise<void>;
35
+ private spawn;
36
+ private dispatch;
37
+ private receive;
38
+ private finishDrain;
39
+ private fail;
40
+ }
@@ -0,0 +1,215 @@
1
+ import { resolve } from 'node:path';
2
+ import { DneAddressSearchPoolClosedError, DneAddressSearchQueueFullError, DneAddressSearchWorkerError, } from "./address-search-pool-errors.js";
3
+ import workerSource from "./address-search-worker-source.js";
4
+ /** Persistent workers keep synchronous address searches off the HTTP thread. Close the pool when the application stops. */
5
+ export class DneAddressSearchPool {
6
+ maxQueue;
7
+ slots = [];
8
+ queue = [];
9
+ drained = Promise.withResolvers();
10
+ accepting = true;
11
+ terminating = false;
12
+ closing;
13
+ failure;
14
+ constructor(maxQueue) {
15
+ this.maxQueue = maxQueue;
16
+ }
17
+ /** Resolves only after every worker has loaded and validated its database and index. Cleans up all workers on failure. */
18
+ static async open(options) {
19
+ const { workers = 1, maxQueue = 64 } = options;
20
+ if (!Number.isSafeInteger(workers) || workers < 1 || !Number.isSafeInteger(maxQueue) || maxQueue < 0) {
21
+ throw new RangeError('Address search pool requires a positive worker count and a nonnegative queue size');
22
+ }
23
+ if (typeof options.indexPath !== 'string' || !options.indexPath.trim()
24
+ || typeof options.databasePath !== 'string' || !options.databasePath.trim()) {
25
+ throw new TypeError('Address search pool requires nonempty file paths');
26
+ }
27
+ const pool = new DneAddressSearchPool(maxQueue);
28
+ try {
29
+ const data = {
30
+ type: 'load',
31
+ databasePath: resolve(options.databasePath),
32
+ indexPath: resolve(options.indexPath),
33
+ };
34
+ const snapshot = await pool.spawn(data);
35
+ await Promise.all(Array.from({ length: workers - 1 }, () => pool.spawn({ type: 'init', snapshot: snapshot })));
36
+ return pool;
37
+ }
38
+ catch (error) {
39
+ pool.fail(error);
40
+ await pool.close();
41
+ throw pool.failure;
42
+ }
43
+ }
44
+ /** Matches the synchronous API's results and ranking. All failures are promise rejections. */
45
+ async searchAddresses(text, options = {}) {
46
+ if (!this.accepting) {
47
+ throw this.failure ?? new DneAddressSearchPoolClosedError();
48
+ }
49
+ const { signal, uf, municipioCodIbge, limit } = options;
50
+ if (signal?.aborted) {
51
+ throw signal.reason;
52
+ }
53
+ const idle = this.slots.find((slot) => !slot.current);
54
+ if (!idle && this.queue.length >= this.maxQueue) {
55
+ throw new DneAddressSearchQueueFullError();
56
+ }
57
+ return new Promise((resolve, reject) => {
58
+ const abort = () => {
59
+ const position = this.queue.indexOf(job);
60
+ if (position !== -1) {
61
+ this.queue.splice(position, 1);
62
+ }
63
+ job.cleanup();
64
+ reject(signal?.reason);
65
+ // An aborted running job still occupies its worker until the reply arrives.
66
+ this.finishDrain();
67
+ };
68
+ const job = {
69
+ request: { type: 'search', text, options: { uf, municipioCodIbge, limit } },
70
+ resolve,
71
+ reject,
72
+ cleanup: () => signal?.removeEventListener('abort', abort),
73
+ };
74
+ signal?.addEventListener('abort', abort, { once: true });
75
+ if (idle) {
76
+ this.dispatch(idle, job);
77
+ }
78
+ else {
79
+ this.queue.push(job);
80
+ }
81
+ });
82
+ }
83
+ /** Stops admission, drains accepted searches (including cancelled calculations), then waits for every worker to exit. Idempotent. */
84
+ close() {
85
+ this.accepting = false;
86
+ this.closing ??= this.drained.promise.then(async () => {
87
+ this.terminating = true;
88
+ await Promise.all(this.slots.map((slot) => {
89
+ if (!slot.hasClosed) {
90
+ if (this.failure) {
91
+ slot.worker.terminate();
92
+ }
93
+ else {
94
+ try {
95
+ slot.worker.postMessage({ type: 'close' });
96
+ }
97
+ catch {
98
+ slot.worker.terminate();
99
+ }
100
+ }
101
+ }
102
+ return slot.closed.promise;
103
+ }));
104
+ // Readiness promises retain the published snapshot until these slots are released.
105
+ this.slots.length = 0;
106
+ });
107
+ this.finishDrain();
108
+ return this.closing;
109
+ }
110
+ async spawn(data) {
111
+ const url = URL.createObjectURL(new Blob([workerSource], { type: 'application/javascript' }));
112
+ let worker;
113
+ try {
114
+ worker = new Worker(url);
115
+ }
116
+ catch (error) {
117
+ URL.revokeObjectURL(url);
118
+ throw error;
119
+ }
120
+ const slot = {
121
+ worker,
122
+ ready: Promise.withResolvers(),
123
+ closed: Promise.withResolvers(),
124
+ hasClosed: false,
125
+ };
126
+ this.slots.push(slot);
127
+ worker.addEventListener('message', (event) => this.receive(slot, event.data));
128
+ worker.addEventListener('error', (event) => {
129
+ event.preventDefault();
130
+ this.fail(event.error ?? new Error(event.message));
131
+ });
132
+ worker.addEventListener('close', (event) => {
133
+ URL.revokeObjectURL(url);
134
+ slot.hasClosed = true;
135
+ slot.closed.resolve();
136
+ if (!this.terminating) {
137
+ this.fail(new Error(`Address search worker exited unexpectedly with code ${event.code}`));
138
+ }
139
+ });
140
+ try {
141
+ worker.postMessage(data);
142
+ }
143
+ catch (error) {
144
+ this.fail(error);
145
+ }
146
+ return slot.ready.promise;
147
+ }
148
+ dispatch(slot, job) {
149
+ slot.current = job;
150
+ try {
151
+ slot.worker.postMessage(job.request);
152
+ }
153
+ catch (error) {
154
+ this.fail(error);
155
+ }
156
+ }
157
+ receive(slot, reply) {
158
+ if (this.failure) {
159
+ return;
160
+ }
161
+ if (reply.type === 'ready') {
162
+ slot.ready.resolve(reply.snapshot);
163
+ return;
164
+ }
165
+ if (reply.type === 'failed') {
166
+ const error = new Error(reply.error.message);
167
+ error.name = reply.error.name;
168
+ this.fail(error);
169
+ return;
170
+ }
171
+ const job = slot.current;
172
+ slot.current = undefined;
173
+ job.cleanup();
174
+ if (reply.type === 'result') {
175
+ job.resolve(reply.rows);
176
+ }
177
+ else {
178
+ const { name, message } = reply.error;
179
+ const error = name === 'RangeError' ? new RangeError(message) : name === 'TypeError' ? new TypeError(message) : new Error(message);
180
+ error.name = name;
181
+ job.reject(error);
182
+ }
183
+ const next = this.queue.shift();
184
+ if (next) {
185
+ this.dispatch(slot, next);
186
+ }
187
+ this.finishDrain();
188
+ }
189
+ finishDrain() {
190
+ if (!this.accepting && this.queue.length === 0 && this.slots.every((slot) => !slot.current)) {
191
+ this.drained.resolve();
192
+ }
193
+ }
194
+ fail(cause) {
195
+ if (this.failure || this.terminating) {
196
+ return;
197
+ }
198
+ const error = new DneAddressSearchWorkerError(cause);
199
+ this.failure = error;
200
+ for (const slot of this.slots) {
201
+ slot.ready.reject(error);
202
+ if (slot.current) {
203
+ slot.current.cleanup();
204
+ slot.current.reject(error);
205
+ slot.current = undefined;
206
+ }
207
+ }
208
+ for (const job of this.queue.splice(0)) {
209
+ job.cleanup();
210
+ job.reject(error);
211
+ }
212
+ void this.close();
213
+ }
214
+ }
215
+ //# sourceMappingURL=address-search-pool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"address-search-pool.js","sourceRoot":"","sources":["../src/address-search-pool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import type { AddressSearchIndex } from './address-search-index.ts';
2
+ /** Finds a word boundary in the sorted ASCII vocabulary. */
3
+ export declare function findSearchTerm(terms: readonly string[], term: string): number;
4
+ /** Ranks numeric fields and word positions; no address strings are decoded. */
5
+ export declare function createIndexedAddressRanker(index: AddressSearchIndex, query: readonly string[], cache?: Uint16Array): (row: number) => number;
@@ -0,0 +1,89 @@
1
+ import { hasSearchableWords, isAddressStreetType, } from "./address-search-text.js";
2
+ import { readPackedInteger } from "./binary-db-format.js";
3
+ /** Finds a word boundary in the sorted ASCII vocabulary. */
4
+ export function findSearchTerm(terms, term) {
5
+ let low = 0;
6
+ let high = terms.length;
7
+ while (low < high) {
8
+ const middle = low + ((high - low) >>> 1);
9
+ if (terms[middle] < term) {
10
+ low = middle + 1;
11
+ }
12
+ else {
13
+ high = middle;
14
+ }
15
+ }
16
+ return low;
17
+ }
18
+ /** Ranks numeric fields and word positions; no address strings are decoded. */
19
+ export function createIndexedAddressRanker(index, query, cache = new Uint16Array(index.fieldCount)) {
20
+ const words = query.map((word) => {
21
+ const low = findSearchTerm(index.terms, word);
22
+ return {
23
+ exact: index.terms[low] === word ? low : -1,
24
+ low,
25
+ high: findSearchTerm(index.terms, `${word}\uffff`),
26
+ significant: hasSearchableWords([word]),
27
+ };
28
+ });
29
+ // Scores are at most 30,128 for the public 256-character query limit. Zero means uncached.
30
+ cache.fill(0);
31
+ return (row) => {
32
+ let rank = 0;
33
+ for (let column = 0; column < 4; column++) {
34
+ const field = readPackedInteger(index.data, index.rowFields + (row * 4 + column) * index.fieldWidth, index.fieldWidth);
35
+ let score = cache[field];
36
+ if (!score) {
37
+ const start = index.data.getUint32(index.fieldOffsets + field * 4, true);
38
+ const end = index.data.getUint32(index.fieldOffsets + (field + 1) * 4, true);
39
+ let exactWords = 0;
40
+ for (const word of words) {
41
+ if (!word.significant) {
42
+ continue;
43
+ }
44
+ for (let position = start; position < end; position++) {
45
+ if (fieldToken(index, position) === word.exact) {
46
+ exactWords++;
47
+ break;
48
+ }
49
+ }
50
+ }
51
+ let quality = 0;
52
+ for (let position = start; position <= end - words.length; position++) {
53
+ let phrase = true;
54
+ let exact = true;
55
+ for (let id = 0; id < words.length; id++) {
56
+ const word = words[id];
57
+ const token = fieldToken(index, position + id);
58
+ exact &&= token === word.exact;
59
+ if (id === words.length - 1 ? token < word.low || token >= word.high : token !== word.exact) {
60
+ phrase = false;
61
+ break;
62
+ }
63
+ }
64
+ if (phrase) {
65
+ quality = 20_000;
66
+ const wholeName = end - start === words.length || (position === start + 1 && end - start === words.length + 1
67
+ && isAddressStreetType(index.terms[fieldToken(index, start)]));
68
+ if (wholeName && exact) {
69
+ quality = 30_000;
70
+ break;
71
+ }
72
+ }
73
+ }
74
+ score = quality + exactWords + 1;
75
+ cache[field] = score;
76
+ }
77
+ score--;
78
+ const quality = score >= 30_000 ? 30_000 : score >= 20_000 ? 20_000 : 0;
79
+ const exactWords = score - quality;
80
+ const weight = 4 - column;
81
+ rank = Math.max(rank, quality ? quality + weight * 100 + exactWords : exactWords * weight);
82
+ }
83
+ return rank;
84
+ };
85
+ }
86
+ function fieldToken(index, position) {
87
+ return readPackedInteger(index.data, index.fieldTokens + position * index.tokenWidth, index.tokenWidth);
88
+ }
89
+ //# sourceMappingURL=address-search-rank.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"address-search-rank.js","sourceRoot":"","sources":["../src/address-search-rank.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /** Normalizes text without changing the original address or losing numeric street names. */
2
+ export declare function addressTokens(text: string): string[];
3
+ /** Avoids national searches made entirely of street types and connective words. */
4
+ export declare function hasSearchableWords(tokens: readonly string[]): boolean;
5
+ /** Identifies the optional leading road type used by exact-name ranking. */
6
+ export declare function isAddressStreetType(token: string): boolean;
@@ -0,0 +1,16 @@
1
+ import { expand } from "./expand.js";
2
+ const common = new Set(['rua', 'avenida', 'rodovia', 'travessa', 'de', 'da', 'do', 'das', 'dos']);
3
+ const streetTypes = new Set(['rua', 'avenida', 'rodovia', 'travessa', 'alameda', 'praca', 'estrada', 'largo', 'viela']);
4
+ /** Normalizes text without changing the original address or losing numeric street names. */
5
+ export function addressTokens(text) {
6
+ return expand(text).toLowerCase().match(/[a-z0-9]+/g) ?? [];
7
+ }
8
+ /** Avoids national searches made entirely of street types and connective words. */
9
+ export function hasSearchableWords(tokens) {
10
+ return tokens.some((token) => !common.has(token));
11
+ }
12
+ /** Identifies the optional leading road type used by exact-name ranking. */
13
+ export function isAddressStreetType(token) {
14
+ return streetTypes.has(token);
15
+ }
16
+ //# sourceMappingURL=address-search-text.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"address-search-text.js","sourceRoot":"","sources":["../src/address-search-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAClG,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAExH,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}
@@ -0,0 +1,41 @@
1
+ import { type AddressSearchOptions } from './address-search.ts';
2
+ import type { DneRow } from './types.ts';
3
+ /** Finish writing before publication; every consumer must treat these buffers as immutable. */
4
+ export type AddressSearchSnapshot = {
5
+ database: SharedArrayBuffer;
6
+ index: SharedArrayBuffer;
7
+ };
8
+ export type AddressSearchWorkerData = {
9
+ type: 'load';
10
+ databasePath: string;
11
+ indexPath: string;
12
+ } | {
13
+ type: 'init';
14
+ snapshot: AddressSearchSnapshot;
15
+ };
16
+ export type AddressSearchWorkerRequest = {
17
+ type: 'search';
18
+ text: string;
19
+ options: AddressSearchOptions;
20
+ } | {
21
+ type: 'close';
22
+ };
23
+ export type AddressSearchWorkerReply = {
24
+ type: 'ready';
25
+ snapshot?: AddressSearchSnapshot;
26
+ } | {
27
+ type: 'result';
28
+ rows: DneRow[];
29
+ } | {
30
+ type: 'error' | 'failed';
31
+ error: {
32
+ name: string;
33
+ message: string;
34
+ };
35
+ };
36
+ export type AddressSearchWorkerScope = {
37
+ postMessage(reply: AddressSearchWorkerReply): void;
38
+ onmessage: ((event: MessageEvent<AddressSearchWorkerRequest>) => void) | null;
39
+ };
40
+ /** Loads files only in the first worker; every worker validates its views and owns its mutable caches. */
41
+ export declare function startAddressSearchWorker(scope: AddressSearchWorkerScope, data: AddressSearchWorkerData): void;
@@ -0,0 +1,38 @@
1
+ import { DneAddressSearch, } from "./address-search.js";
2
+ import { DneBinaryDatabaseReader, readBinaryDatabaseBytes } from "./binary-db-reader.js";
3
+ import { readSharedFile } from "./shared-file.js";
4
+ /** Loads files only in the first worker; every worker validates its views and owns its mutable caches. */
5
+ export function startAddressSearchWorker(scope, data) {
6
+ const snapshot = data.type === 'load'
7
+ ? { database: readBinaryDatabaseBytes(data.databasePath, true).buffer, index: readSharedFile(data.indexPath) }
8
+ : data.snapshot;
9
+ const database = new DneBinaryDatabaseReader(snapshot.database);
10
+ let search;
11
+ try {
12
+ search = new DneAddressSearch(database, snapshot.index);
13
+ }
14
+ catch (error) {
15
+ database.close();
16
+ throw error;
17
+ }
18
+ scope.onmessage = ({ data: request }) => {
19
+ if (request.type === 'close') {
20
+ search.close();
21
+ database.close();
22
+ // Removing the last listener lets Bun end the worker after this handler returns.
23
+ scope.onmessage = null;
24
+ return;
25
+ }
26
+ let reply;
27
+ try {
28
+ reply = { type: 'result', rows: search.searchAddresses(request.text, request.options) };
29
+ }
30
+ catch (error) {
31
+ const failure = error;
32
+ reply = { type: 'error', error: { name: failure.name, message: failure.message } };
33
+ }
34
+ scope.postMessage(reply);
35
+ };
36
+ scope.postMessage({ type: 'ready', snapshot: data.type === 'load' ? snapshot : undefined });
37
+ }
38
+ //# sourceMappingURL=address-search-worker-runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"address-search-worker-runtime.js","sourceRoot":"","sources":["../src/address-search-worker-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAoBlD,0GAA0G;AAC1G,MAAM,UAAU,wBAAwB,CAAC,KAA+B,EAAE,IAA6B;IACrG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM;QACnC,CAAC,CAAC,EAAE,QAAQ,EAAE,uBAAuB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,MAA2B,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;QACnI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAA4C,EAAE,EAAE;QAChF,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,iFAAiF;YACjF,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,KAA+B,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAc,CAAC;YAC/B,KAAK,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACrF,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAqC,CAAC,CAAC;AACjI,CAAC"}
@@ -0,0 +1,2 @@
1
+ declare const workerSource: string;
2
+ export default workerSource;