@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
package/dist/library.d.ts CHANGED
@@ -1,10 +1,17 @@
1
+ /// <reference lib="esnext.disposable" preserve="true" />
2
+ /** Optional address autocomplete and its database-bound index builder. */
3
+ export { buildAddressSearchIndex } from './address-search-index.ts';
4
+ export { DneAddressSearchPoolClosedError, DneAddressSearchQueueFullError, DneAddressSearchWorkerError, } from './address-search-pool-errors.ts';
5
+ export { type AddressSearchAsyncOptions, type AddressSearchPoolOptions, DneAddressSearchPool } from './address-search-pool.ts';
6
+ export { type AddressSearchOptions, DneAddressSearch } from './address-search.ts';
1
7
  /** Public binary reader, format constants, file helpers, errors, and neighborhood types. */
2
- export * from './binary-db-reader.ts';
8
+ export { BINARY_DATABASE_HEADER_SIZE, BINARY_DATABASE_VERSION, type DneBairro, DneBinaryDatabaseClosedError, DneBinaryDatabaseError, type DneBinaryDatabaseErrorCode, DneBinaryDatabaseFormatError, DneBinaryDatabaseIOError, DneBinaryDatabaseReader, DneBinaryDatabaseVersionError, type DneFaixaCep, isBinaryDatabase, readBinaryDatabaseMetadata, } from './binary-db-reader.ts';
3
9
  /** SQLite reader and its typed errors. */
4
10
  export { DneDatabaseClosedError, DneDatabaseDataError, DneDatabaseError, type DneDatabaseErrorCode, DneDatabaseIOError, DneDatabaseQueryError, DneDatabaseReader, DneDatabaseSchemaError, } from './sqlite-db-reader.ts';
5
11
  /** CEP helpers and address records shared by both readers. */
6
12
  export { CEP_RANGES, cepToU32, formatCep, normalizeCep, ufForCep } from './cep.ts';
13
+ export { expand as expandAddress } from './expand.ts';
7
14
  export type { DneRow, LoadMetadata, UF } from './types.ts';
8
- export { parseUF } from './types.ts';
15
+ export { ALL_UFS, parseUF, stateCodeToUF, stateNameToUF, ufToStateCode, ufToStateName } from './types.ts';
9
16
  /** Descriptive locality classification and postal coding status returned by CEP lookups. */
10
17
  export type { LocalidadeSituacao, LocalidadeTipo } from './schema.ts';
package/dist/library.js CHANGED
@@ -1,8 +1,15 @@
1
+ /// <reference lib="esnext.disposable" preserve="true" />
2
+ /** Optional address autocomplete and its database-bound index builder. */
3
+ export { buildAddressSearchIndex } from "./address-search-index.js";
4
+ export { DneAddressSearchPoolClosedError, DneAddressSearchQueueFullError, DneAddressSearchWorkerError, } from "./address-search-pool-errors.js";
5
+ export { DneAddressSearchPool } from "./address-search-pool.js";
6
+ export { DneAddressSearch } from "./address-search.js";
1
7
  /** Public binary reader, format constants, file helpers, errors, and neighborhood types. */
2
- export * from "./binary-db-reader.js";
8
+ export { BINARY_DATABASE_HEADER_SIZE, BINARY_DATABASE_VERSION, DneBinaryDatabaseClosedError, DneBinaryDatabaseError, DneBinaryDatabaseFormatError, DneBinaryDatabaseIOError, DneBinaryDatabaseReader, DneBinaryDatabaseVersionError, isBinaryDatabase, readBinaryDatabaseMetadata, } from "./binary-db-reader.js";
3
9
  /** SQLite reader and its typed errors. */
4
10
  export { DneDatabaseClosedError, DneDatabaseDataError, DneDatabaseError, DneDatabaseIOError, DneDatabaseQueryError, DneDatabaseReader, DneDatabaseSchemaError, } from "./sqlite-db-reader.js";
5
11
  /** CEP helpers and address records shared by both readers. */
6
12
  export { CEP_RANGES, cepToU32, formatCep, normalizeCep, ufForCep } from "./cep.js";
7
- export { parseUF } from "./types.js";
13
+ export { expand as expandAddress } from "./expand.js";
14
+ export { ALL_UFS, parseUF, stateCodeToUF, stateNameToUF, ufToStateCode, ufToStateName } from "./types.js";
8
15
  //# sourceMappingURL=library.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"library.js","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,cAAc,uBAAuB,CAAC;AACtC,0CAA0C;AAC1C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAEhB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEnF,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"library.js","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,0EAA0E;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAiE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC/H,OAAO,EAA6B,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClF,4FAA4F;AAC5F,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EAEvB,4BAA4B,EAC5B,sBAAsB,EAEtB,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAE7B,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,0CAA0C;AAC1C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAEhB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
@@ -16,8 +16,6 @@ export declare const SQLITE_PAGE_SIZE = 32768;
16
16
  export declare const SQLITE_CACHE_SIZE = -200000;
17
17
  /** Maximum number of CEP rows bound in one batched INSERT statement. */
18
18
  export declare const SQLITE_INSERT_BATCH_SIZE = 1000;
19
- /** Default Correios e-DNE source archive URL. */
20
- export declare const EDNE_DOWNLOAD_URL = "https://www2.correios.com.br/sistemas/edne/download/eDNE_Basico.zip";
21
19
  /** Maximum number of simultaneous byte-range download workers. */
22
20
  export declare const HTTP_FETCH_CONCURRENCY = 8;
23
21
  /** Target byte-range size in bytes for parallel downloads. */
package/dist/settings.js CHANGED
@@ -16,8 +16,6 @@ export const SQLITE_PAGE_SIZE = 32768; // 32KiB
16
16
  export const SQLITE_CACHE_SIZE = -200000; // ~195 MiB; negative means cache size in KiB not pages
17
17
  /** Maximum number of CEP rows bound in one batched INSERT statement. */
18
18
  export const SQLITE_INSERT_BATCH_SIZE = 1000;
19
- /** Default Correios e-DNE source archive URL. */
20
- export const EDNE_DOWNLOAD_URL = 'https://www2.correios.com.br/sistemas/edne/download/eDNE_Basico.zip';
21
19
  /** Maximum number of simultaneous byte-range download workers. */
22
20
  export const HTTP_FETCH_CONCURRENCY = 8;
23
21
  /** Target byte-range size in bytes for parallel downloads. */
@@ -1 +1 @@
1
- {"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AACnD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,+BAA+B,GAAG,eAAe,CAAC;AAC/D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAG,eAAe,CAAC;AAC1D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,QAAQ;AAC/C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAC,CAAC,uDAAuD;AACjG,wEAAwE;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,qEAAqE,CAAC;AAEvG,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;AAC5D,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,yDAAyD;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAClD,yDAAyD;AACzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC;AACnD,iFAAiF;AACjF,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC"}
1
+ {"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AACnD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,+BAA+B,GAAG,eAAe,CAAC;AAC/D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAG,eAAe,CAAC;AAC1D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,QAAQ;AAC/C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAC,CAAC,uDAAuD;AACjG,wEAAwE;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;AAC5D,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,yDAAyD;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAClD,yDAAyD;AACzD,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC;AACnD,iFAAiF;AACjF,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC"}
@@ -0,0 +1,2 @@
1
+ /** Reads into shared storage, copying once for Bun's embedded files. Publish only after this function returns. */
2
+ export declare function readSharedFile(path: string): SharedArrayBuffer;
@@ -0,0 +1,35 @@
1
+ import { closeSync, fstatSync, openSync, readFileSync, readSync } from 'node:fs';
2
+ /** Reads into shared storage, copying once for Bun's embedded files. Publish only after this function returns. */
3
+ export function readSharedFile(path) {
4
+ let fd;
5
+ try {
6
+ fd = openSync(path, 'r');
7
+ }
8
+ catch (error) {
9
+ if (error.code !== 'ENOENT') {
10
+ throw error;
11
+ }
12
+ // Bun's virtual assets support readFileSync but do not expose OS file descriptors.
13
+ const bytes = readFileSync(path);
14
+ const buffer = new SharedArrayBuffer(bytes.byteLength);
15
+ new Uint8Array(buffer).set(bytes);
16
+ return buffer;
17
+ }
18
+ try {
19
+ const buffer = new SharedArrayBuffer(fstatSync(fd).size);
20
+ const bytes = new Uint8Array(buffer);
21
+ let offset = 0;
22
+ while (offset < bytes.byteLength) {
23
+ const count = readSync(fd, bytes, offset, bytes.byteLength - offset, offset);
24
+ if (count === 0) {
25
+ throw new Error(`File ended while loading shared snapshot: ${path}`);
26
+ }
27
+ offset += count;
28
+ }
29
+ return buffer;
30
+ }
31
+ finally {
32
+ closeSync(fd);
33
+ }
34
+ }
35
+ //# sourceMappingURL=shared-file.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared-file.js","sourceRoot":"","sources":["../src/shared-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjF,kHAAkH;AAClH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,EAAU,CAAC;IACf,IAAI,CAAC;QACH,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,mFAAmF;QACnF,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7E,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC"}
@@ -5,11 +5,15 @@ export type { DneBairro, DneFaixaCep } from './bairro.ts';
5
5
  export { DneDatabaseClosedError, DneDatabaseDataError, DneDatabaseError, type DneDatabaseErrorCode, DneDatabaseIOError, DneDatabaseQueryError, DneDatabaseSchemaError, } from './sqlite-db-errors.ts';
6
6
  export type { DneRow, LoadMetadata } from './types.ts';
7
7
  /** Read-only SQLite access for CEP lookup, schema inspection, metadata, and bounded SQL queries. */
8
- export declare class DneDatabaseReader {
8
+ export declare class DneDatabaseReader implements Disposable {
9
9
  private readonly databasePath;
10
10
  private readonly db;
11
11
  private closed;
12
12
  private normalizedSchemaReady;
13
+ private cepStatement;
14
+ private neighborhoodStatement;
15
+ private neighborhoodByCepStatement;
16
+ private neighborhoodCepRangesStatement;
13
17
  /**
14
18
  * Opens an existing SQLite database in read-only mode with a 30-second busy timeout.
15
19
  * @param databasePath - Path to the SQLite database.
@@ -17,10 +21,15 @@ export declare class DneDatabaseReader {
17
21
  */
18
22
  constructor(databasePath: string);
19
23
  /**
20
- * Closes the SQLite connection. Repeated calls are safe; subsequent reads throw.
24
+ * Finalizes retained statements and closes the SQLite connection. Repeated calls are safe; subsequent reads throw.
21
25
  * @throws {DneDatabaseIOError} If SQLite cannot close the connection.
22
26
  */
23
27
  close(): void;
28
+ /**
29
+ * Calls close() when a using declaration leaves its scope. Repeated calls are safe.
30
+ * @throws {DneDatabaseIOError} If SQLite cannot close the connection.
31
+ */
32
+ [Symbol.dispose](): void;
24
33
  /**
25
34
  * Checks whether a named table exists in the database catalog.
26
35
  * @param tableName - Physical table name.
@@ -93,10 +102,10 @@ export declare class DneDatabaseReader {
93
102
  /**
94
103
  * Executes caller-supplied SQL on the read-only connection, retaining a bounded result.
95
104
  * @param sql - A statement accepted by SQLite; this method does not apply the CLI's statement filter.
96
- * @param limit - Positive maximum number of rows to retain.
105
+ * @param limit - Positive safe integer specifying the maximum number of rows to retain.
97
106
  * @returns Rows plus a flag indicating whether at least one additional row was available.
98
107
  * @throws {DneDatabaseClosedError} If the reader is closed, including for invalid input.
99
- * @throws {DneDatabaseQueryError} If SQLite cannot prepare or execute the read.
108
+ * @throws {DneDatabaseQueryError} If the limit is invalid or SQLite cannot prepare or execute the read.
100
109
  */
101
110
  querySql(sql: string, limit: number): {
102
111
  rows: Record<string, unknown>[];
@@ -12,6 +12,10 @@ export class DneDatabaseReader {
12
12
  db;
13
13
  closed = false;
14
14
  normalizedSchemaReady = false;
15
+ cepStatement;
16
+ neighborhoodStatement;
17
+ neighborhoodByCepStatement;
18
+ neighborhoodCepRangesStatement;
15
19
  /**
16
20
  * Opens an existing SQLite database in read-only mode with a 30-second busy timeout.
17
21
  * @param databasePath - Path to the SQLite database.
@@ -36,7 +40,7 @@ export class DneDatabaseReader {
36
40
  }
37
41
  }
38
42
  /**
39
- * Closes the SQLite connection. Repeated calls are safe; subsequent reads throw.
43
+ * Finalizes retained statements and closes the SQLite connection. Repeated calls are safe; subsequent reads throw.
40
44
  * @throws {DneDatabaseIOError} If SQLite cannot close the connection.
41
45
  */
42
46
  close() {
@@ -44,13 +48,24 @@ export class DneDatabaseReader {
44
48
  return;
45
49
  }
46
50
  try {
47
- this.db.close();
51
+ this.db.close(true);
52
+ this.cepStatement = undefined;
53
+ this.neighborhoodStatement = undefined;
54
+ this.neighborhoodByCepStatement = undefined;
55
+ this.neighborhoodCepRangesStatement = undefined;
48
56
  this.closed = true;
49
57
  }
50
58
  catch (cause) {
51
59
  throw new DneDatabaseIOError(this.databasePath, { cause });
52
60
  }
53
61
  }
62
+ /**
63
+ * Calls close() when a using declaration leaves its scope. Repeated calls are safe.
64
+ * @throws {DneDatabaseIOError} If SQLite cannot close the connection.
65
+ */
66
+ [Symbol.dispose]() {
67
+ this.close();
68
+ }
54
69
  /**
55
70
  * Checks whether a named table exists in the database catalog.
56
71
  * @param tableName - Physical table name.
@@ -94,8 +109,8 @@ export class DneDatabaseReader {
94
109
  return undefined;
95
110
  }
96
111
  this.requireCurrentSchema();
97
- const row = this.db.query(`SELECT * FROM ${quoteIdent(cepViewName(SQLITE_CEP_TABLE_NAME))} WHERE cep = ?`)
98
- .get(cep.length === 8 ? cep : `${cep.slice(0, 5)}${cep.slice(6)}`);
112
+ this.cepStatement ??= this.db.prepare(`SELECT * FROM ${quoteIdent(cepViewName(SQLITE_CEP_TABLE_NAME))} WHERE cep = ?`);
113
+ const row = this.cepStatement.get(cep.length === 8 ? cep : `${cep.slice(0, 5)}${cep.slice(6)}`);
99
114
  if (!row) {
100
115
  return undefined;
101
116
  }
@@ -124,8 +139,8 @@ export class DneDatabaseReader {
124
139
  return undefined;
125
140
  }
126
141
  this.requireCurrentSchema();
127
- const row = this.db.query(`SELECT * FROM ${quoteIdent(SQLITE_BAIRROS_TABLE_NAME)} WHERE bairro_id = ?`)
128
- .get(neighborhoodId);
142
+ this.neighborhoodStatement ??= this.db.prepare(`SELECT * FROM ${quoteIdent(SQLITE_BAIRROS_TABLE_NAME)} WHERE bairro_id = ?`);
143
+ const row = this.neighborhoodStatement.get(neighborhoodId);
129
144
  return row ?? undefined;
130
145
  });
131
146
  }
@@ -143,11 +158,12 @@ export class DneDatabaseReader {
143
158
  return undefined;
144
159
  }
145
160
  this.requireCurrentSchema();
146
- const row = this.db.query(`
161
+ this.neighborhoodByCepStatement ??= this.db.prepare(`
147
162
  SELECT b.* FROM ${quoteIdent(SQLITE_CEP_TABLE_NAME)} d
148
163
  JOIN ${quoteIdent(SQLITE_BAIRROS_TABLE_NAME)} b ON b.bairro_id = d.bairro_id
149
164
  WHERE d.cep = ?
150
- `).get(cep.replace('-', ''));
165
+ `);
166
+ const row = this.neighborhoodByCepStatement.get(cep.replace('-', ''));
151
167
  return row ?? undefined;
152
168
  });
153
169
  }
@@ -165,16 +181,17 @@ export class DneDatabaseReader {
165
181
  return [];
166
182
  }
167
183
  this.requireCurrentSchema();
168
- return this.db.query(`
184
+ this.neighborhoodCepRangesStatement ??= this.db.prepare(`
169
185
  SELECT cep_inicial, cep_final FROM ${quoteIdent(SQLITE_BAIRRO_FAIXAS_TABLE_NAME)}
170
186
  WHERE bairro_id = ? ORDER BY cep_inicial, cep_final
171
- `).all(neighborhoodId);
187
+ `);
188
+ return this.neighborhoodCepRangesStatement.all(neighborhoodId);
172
189
  });
173
190
  }
174
191
  requireCurrentSchema() {
175
192
  if (!this.normalizedSchemaReady) {
176
193
  this.normalizedSchemaReady = Boolean(this.db.query('SELECT 1 FROM sqlite_master WHERE type = \'view\' AND name = ?')
177
- .get(cepViewName(SQLITE_CEP_TABLE_NAME)));
194
+ .get(cepViewName(SQLITE_CEP_TABLE_NAME))) && this.hasTable(SQLITE_BAIRROS_TABLE_NAME) && this.hasTable(SQLITE_BAIRRO_FAIXAS_TABLE_NAME);
178
195
  }
179
196
  if (!this.normalizedSchemaReady) {
180
197
  throw new DneDatabaseSchemaError('Database schema lacks normalized neighborhoods. Rebuild the database with build --force.');
@@ -209,29 +226,34 @@ export class DneDatabaseReader {
209
226
  /**
210
227
  * Executes caller-supplied SQL on the read-only connection, retaining a bounded result.
211
228
  * @param sql - A statement accepted by SQLite; this method does not apply the CLI's statement filter.
212
- * @param limit - Positive maximum number of rows to retain.
229
+ * @param limit - Positive safe integer specifying the maximum number of rows to retain.
213
230
  * @returns Rows plus a flag indicating whether at least one additional row was available.
214
231
  * @throws {DneDatabaseClosedError} If the reader is closed, including for invalid input.
215
- * @throws {DneDatabaseQueryError} If SQLite cannot prepare or execute the read.
232
+ * @throws {DneDatabaseQueryError} If the limit is invalid or SQLite cannot prepare or execute the read.
216
233
  */
217
234
  querySql(sql, limit) {
218
235
  return this.readSafely(() => {
236
+ if (!Number.isSafeInteger(limit) || limit <= 0) {
237
+ throw new DneDatabaseQueryError('SQL row limit must be a positive safe integer.');
238
+ }
219
239
  const rows = [];
240
+ let truncated = false;
220
241
  const statement = this.db.query(sql);
221
242
  try {
222
243
  for (const value of statement.iterate()) {
223
- rows.push(value);
224
- if (rows.length > limit) {
244
+ if (rows.length === limit) {
245
+ truncated = true;
225
246
  break;
226
247
  }
248
+ rows.push(value);
227
249
  }
228
250
  }
229
251
  finally {
230
252
  statement.finalize();
231
253
  }
232
254
  return {
233
- rows: rows.slice(0, limit),
234
- truncated: rows.length > limit,
255
+ rows,
256
+ truncated,
235
257
  };
236
258
  });
237
259
  }
@@ -1 +1 @@
1
- {"version":3,"file":"sqlite-db-reader.js","sourceRoot":"","sources":["../src/sqlite-db-reader.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sqlite-db-reader.js","sourceRoot":"","sources":["../src/sqlite-db-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkB,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,UAAU,GAGX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,UAAU,GACX,MAAM,uBAAuB,CAAC;AAS/B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAEhB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,oGAAoG;AACpG,MAAM,OAAO,iBAAiB;IAcC;IAbZ,EAAE,CAAW;IACtB,MAAM,GAAG,KAAK,CAAC;IACf,qBAAqB,GAAG,KAAK,CAAC;IAC9B,YAAY,CAAgD;IAC5D,qBAAqB,CAA6C;IAClE,0BAA0B,CAA6C;IACvE,8BAA8B,CAA+C;IAErF;;;;OAIG;IACH,YAA6B,YAAoB;QAApB,iBAAY,GAAZ,YAAY,CAAQ;QAC/C,IAAI,EAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,EAAE,GAAG,IAAI,QAAQ,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,EAAE,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YACtC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,EAAE,EAAE,KAAK,EAAE,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,sDAAsD;YACxD,CAAC;YACD,MAAM,IAAI,kBAAkB,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;YACvC,IAAI,CAAC,0BAA0B,GAAG,SAAS,CAAC;YAC5C,IAAI,CAAC,8BAA8B,GAAG,SAAS,CAAC;YAChD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAClH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;gBAC/C,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,0BAA0B,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,GAAG,EAG/F,CAAC;YACJ,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5B,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,EAAE,CAAC,OAAO,CACnC,iBAAiB,UAAU,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,gBAAgB,CAChF,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,GAAG,CAAC,mBAAmB,KAAK,SAAS,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;gBAC/E,MAAM,IAAI,sBAAsB,CAAC,qFAAqF,CAAC,CAAC;YAC1H,CAAC;YACD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,gBAAgB,CAAC,uBAAuB,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;YACpF,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjD,MAAM,IAAI,oBAAoB,CAAC,yFAAyF,CAAC,CAAC;YAC5H,CAAC;YACD,OAAO,EAAE,GAAG,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,cAAsB;QACtC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAChC,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5B,IAAI,CAAC,qBAAqB,KAAK,IAAI,CAAC,EAAE,CAAC,OAAO,CAC5C,iBAAiB,UAAU,CAAC,yBAAyB,CAAC,sBAAsB,CAC7E,CAAC;YACF,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC3D,OAAO,GAAG,IAAI,SAAS,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,sBAAsB,CAAC,GAAW;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAChC,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5B,IAAI,CAAC,0BAA0B,KAAK,IAAI,CAAC,EAAE,CAAC,OAAO,CAAsB;0BACrD,UAAU,CAAC,qBAAqB,CAAC;eAC5C,UAAU,CAAC,yBAAyB,CAAC;;OAE7C,CAAC,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;YACtE,OAAO,GAAG,IAAI,SAAS,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,0BAA0B,CAAC,cAAsB;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAChC,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5B,IAAI,CAAC,8BAA8B,KAAK,IAAI,CAAC,EAAE,CAAC,OAAO,CAAwB;6CACxC,UAAU,CAAC,+BAA+B,CAAC;;OAEjF,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,8BAA8B,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,oBAAoB;QAC1B,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAClC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,gEAAgE,CAAC;iBAC5E,GAAG,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,IAAI,sBAAsB,CAAC,0FAA0F,CAAC,CAAC;QAC/H,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,iCAAiC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,GAAG,EAAwB,CAAC;YAChH,OAAO,GAAG,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC,GAAG,CAAC,SAAS,CAEpG,CAAC;YACT,OAAO,GAAG,EAAE,GAAG,IAAI,SAAS,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAW,EAAE,KAAa;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,qBAAqB,CAAC,gDAAgD,CAAC,CAAC;YACpF,CAAC;YACD,MAAM,IAAI,GAA8B,EAAE,CAAC;YAC3C,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAErC,IAAI,CAAC;gBACH,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;oBACxC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;wBAC1B,SAAS,GAAG,IAAI,CAAC;wBACjB,MAAM;oBACR,CAAC;oBACD,IAAI,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,SAAS,CAAC,QAAQ,EAAE,CAAC;YACvB,CAAC;YAED,OAAO;gBACL,IAAI;gBACJ,SAAS;aACV,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAAI,IAAa;QACjC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,sBAAsB,EAAE,CAAC;QACrC,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;gBACtC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,qBAAqB,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,YAAoB;IAC7D,IAAI,YAAY,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QAC5E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,YAAoB,EAAE,SAAiB;IACpE,IAAI,YAAY,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}
package/dist/types.d.ts CHANGED
@@ -32,7 +32,7 @@ export declare const stateCodes: {
32
32
  /** A Brazilian federative-unit abbreviation supported by the geocoder. */
33
33
  export type UF = keyof typeof stateCodes;
34
34
  /** All supported Brazilian federative units in `stateCodes` order. */
35
- export declare const ALL_UFS: ("RO" | "AC" | "AM" | "RR" | "PA" | "AP" | "TO" | "MA" | "PI" | "CE" | "RN" | "PB" | "PE" | "AL" | "SE" | "BA" | "MG" | "ES" | "RJ" | "SP" | "PR" | "SC" | "RS" | "MS" | "MT" | "GO" | "DF")[];
35
+ export declare const ALL_UFS: UF[];
36
36
  /** String-valued provenance and quality metadata stored alongside the imported CEP rows. */
37
37
  export type LoadMetadata = Record<string, string> & {
38
38
  /** Version of the package that performed the import. */
@@ -49,6 +49,8 @@ export type LoadMetadata = Record<string, string> & {
49
49
  source_last_modified?: string;
50
50
  /** Remote source URL used for validator comparisons. */
51
51
  source_url?: string;
52
+ /** JSON array of selected ZIP entry filenames, uncompressed sizes, and CRC32 values. */
53
+ source_zip_entries?: string;
52
54
  };
53
55
  /** Unified address returned by CEP lookups in current SQLite and binary databases. */
54
56
  export type DneRow = {
@@ -84,7 +86,30 @@ export type StoredDneRow = Omit<DneRow, 'localidade_situacao' | 'localidade_tipo
84
86
  * Parsing is case-insensitive and returns the canonical uppercase value.
85
87
  *
86
88
  * @param value Federative-unit abbreviation, for example `MG`.
87
- * @returns The canonical supported state abbreviation.
88
- * @throws {Error} If `value` is not a supported federative unit.
89
+ * @returns The canonical supported state abbreviation, or `undefined` for an unknown value.
89
90
  */
90
- export declare function parseUF(value: string): UF;
91
+ export declare function parseUF(value: string): UF | undefined;
92
+ /**
93
+ * Resolves a federative-unit abbreviation to its accented Portuguese name.
94
+ * @param uf - State abbreviation, matched case-insensitively after trimming whitespace.
95
+ * @returns The state name, or `undefined` for an invalid abbreviation.
96
+ */
97
+ export declare function ufToStateName(uf: UF | string): string | undefined;
98
+ /**
99
+ * Resolves a Portuguese state name to its canonical abbreviation.
100
+ * @param name - State name, matched without case or accent distinctions after trimming whitespace.
101
+ * @returns The state abbreviation, or `undefined` for an unknown name.
102
+ */
103
+ export declare function stateNameToUF(name: string): UF | undefined;
104
+ /**
105
+ * Resolves a federative-unit abbreviation to its two-digit IBGE code.
106
+ * @param uf - State abbreviation, matched case-insensitively after trimming whitespace.
107
+ * @returns The numeric state code, or `undefined` for an invalid abbreviation.
108
+ */
109
+ export declare function ufToStateCode(uf: UF | string): number | undefined;
110
+ /**
111
+ * Resolves a numeric IBGE state code to its canonical abbreviation.
112
+ * @param code - Two-digit IBGE state code.
113
+ * @returns The state abbreviation, or `undefined` for an invalid code.
114
+ */
115
+ export declare function stateCodeToUF(code: number): UF | undefined;
package/dist/types.js CHANGED
@@ -29,21 +29,90 @@ export const stateCodes = {
29
29
  DF: 53,
30
30
  };
31
31
  /** All supported Brazilian federative units in `stateCodes` order. */
32
- export const ALL_UFS = Object.keys(stateCodes).map(parseUF);
32
+ export const ALL_UFS = Object.keys(stateCodes);
33
+ const stateNames = {
34
+ RO: 'Rondônia',
35
+ AC: 'Acre',
36
+ AM: 'Amazonas',
37
+ RR: 'Roraima',
38
+ PA: 'Pará',
39
+ AP: 'Amapá',
40
+ TO: 'Tocantins',
41
+ MA: 'Maranhão',
42
+ PI: 'Piauí',
43
+ CE: 'Ceará',
44
+ RN: 'Rio Grande do Norte',
45
+ PB: 'Paraíba',
46
+ PE: 'Pernambuco',
47
+ AL: 'Alagoas',
48
+ SE: 'Sergipe',
49
+ BA: 'Bahia',
50
+ MG: 'Minas Gerais',
51
+ ES: 'Espírito Santo',
52
+ RJ: 'Rio de Janeiro',
53
+ SP: 'São Paulo',
54
+ PR: 'Paraná',
55
+ SC: 'Santa Catarina',
56
+ RS: 'Rio Grande do Sul',
57
+ MS: 'Mato Grosso do Sul',
58
+ MT: 'Mato Grosso',
59
+ GO: 'Goiás',
60
+ DF: 'Distrito Federal',
61
+ };
62
+ const stateUfsByName = new Map(ALL_UFS.map((uf) => [normalizeStateName(stateNames[uf]), uf]));
63
+ const stateUfsByCode = new Map(ALL_UFS.map((uf) => [stateCodes[uf], uf]));
33
64
  /**
34
65
  * Parses a federative-unit abbreviation.
35
66
  *
36
67
  * Parsing is case-insensitive and returns the canonical uppercase value.
37
68
  *
38
69
  * @param value Federative-unit abbreviation, for example `MG`.
39
- * @returns The canonical supported state abbreviation.
40
- * @throws {Error} If `value` is not a supported federative unit.
70
+ * @returns The canonical supported state abbreviation, or `undefined` for an unknown value.
41
71
  */
42
72
  export function parseUF(value) {
43
73
  const state = value.trim().toUpperCase();
44
74
  if (!Object.hasOwn(stateCodes, state)) {
45
- throw new Error(`Unknown UF: ${value}`);
75
+ return undefined;
46
76
  }
47
77
  return state;
48
78
  }
79
+ /**
80
+ * Resolves a federative-unit abbreviation to its accented Portuguese name.
81
+ * @param uf - State abbreviation, matched case-insensitively after trimming whitespace.
82
+ * @returns The state name, or `undefined` for an invalid abbreviation.
83
+ */
84
+ // oxlint-disable-next-line typescript/no-redundant-type-constituents -- Preserve the requested public UF | string signature.
85
+ export function ufToStateName(uf) {
86
+ const state = parseUF(uf);
87
+ return state === undefined ? undefined : stateNames[state];
88
+ }
89
+ /**
90
+ * Resolves a Portuguese state name to its canonical abbreviation.
91
+ * @param name - State name, matched without case or accent distinctions after trimming whitespace.
92
+ * @returns The state abbreviation, or `undefined` for an unknown name.
93
+ */
94
+ export function stateNameToUF(name) {
95
+ return stateUfsByName.get(normalizeStateName(name));
96
+ }
97
+ /**
98
+ * Resolves a federative-unit abbreviation to its two-digit IBGE code.
99
+ * @param uf - State abbreviation, matched case-insensitively after trimming whitespace.
100
+ * @returns The numeric state code, or `undefined` for an invalid abbreviation.
101
+ */
102
+ // oxlint-disable-next-line typescript/no-redundant-type-constituents -- Preserve the requested public UF | string signature.
103
+ export function ufToStateCode(uf) {
104
+ const state = parseUF(uf);
105
+ return state === undefined ? undefined : stateCodes[state];
106
+ }
107
+ /**
108
+ * Resolves a numeric IBGE state code to its canonical abbreviation.
109
+ * @param code - Two-digit IBGE state code.
110
+ * @returns The state abbreviation, or `undefined` for an invalid code.
111
+ */
112
+ export function stateCodeToUF(code) {
113
+ return stateUfsByCode.get(code);
114
+ }
115
+ function normalizeStateName(name) {
116
+ return name.trim().normalize('NFD').replace(/\p{M}/gu, '').toUpperCase();
117
+ }
49
118
  //# sourceMappingURL=types.js.map
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;CACE,CAAC;AAKX,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAkD5D;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAW,CAAC;AACrB,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@konstit/dne",
3
- "version": "0.2.0",
4
- "description": "Query bundled Brazilian postal codes or build and update local SQLite and binary databases.",
3
+ "version": "0.3.0",
4
+ "description": "Build, update, and query local Brazilian postal code databases from DNE sources.",
5
5
  "repository": {
6
6
  "type": "git",
7
7
  "url": "git+https://github.com/Konstit-Engenharia/konstit-dne.git"
@@ -38,14 +38,15 @@
38
38
  },
39
39
  "files": [
40
40
  "dist",
41
- "data/dne.bin",
42
41
  "README.md",
43
42
  "LICENSE"
44
43
  ],
45
44
  "scripts": {
46
- "build:database": "bun run src/index.ts build",
47
- "build:package-database": "bun run scripts/build-package-database.ts",
48
- "prepack": "bun run build >&2 && bun run build:package-database >&2",
45
+ "build:database": "bun run scripts/build-database.ts",
46
+ "build:search-index": "bun run scripts/build-search-index.ts",
47
+ "benchmark:search": "bun run bench/address-search.bench.ts",
48
+ "benchmark:search-http": "bun run bench/address-search-http.bench.ts",
49
+ "prepack": "bun run build >&2",
49
50
  "get": "bun run src/index.ts get",
50
51
  "test": "bun test --dots --parallel",
51
52
  "benchmark": "bun run bench/benchmark.ts",
@@ -64,17 +65,19 @@
64
65
  "audit": "bun audit",
65
66
  "check": "bun run coverage && bun run --parallel tsc lint:biome lint:oxlint build audit",
66
67
  "build": "bun run build:artifacts",
67
- "build:artifacts": "bun run build:clean && bun run --parallel build:js build:library",
68
+ "build:artifacts": "bun run build:worker && bun run build:clean && bun run --parallel build:js build:library",
69
+ "build:worker": "bun run scripts/build-address-search-worker.ts",
68
70
  "build:clean": "rm -rf ./dist",
69
71
  "build:js": "bun build ./src/index.ts --outdir ./dist --target=bun --format=esm --sourcemap=external --minify --keep-names --splitting --chunk-naming 'chunks/[name]-[hash].[ext]'",
70
- "build:library": "bunx --bun tsc -p tsconfig.build.json"
72
+ "build:library": "bunx --bun tsc -p tsconfig.build.json",
73
+ "cli": "bun run src/index.ts"
71
74
  },
72
75
  "dependencies": {
73
- "@konstit/cli": "0.0.4"
76
+ "@konstit/cli": "0.0.6"
74
77
  },
75
78
  "devDependencies": {
76
79
  "@biomejs/biome": "2.5.9",
77
- "@types/bun": "1.4.2",
80
+ "@types/bun": "1.4.4",
78
81
  "dprint": "^0.56.0",
79
82
  "mitata": "^1.0.34",
80
83
  "oxlint": "^1.79.0",
package/data/dne.bin DELETED
Binary file
@@ -1,7 +0,0 @@
1
- // @bun
2
- import{b as q,g as F,h as N,i as B,j as D,k as y,l as M,m as L,n as R}from"./index-s0h4vdva.js";async function z(e,t,i={}){let a=i.cursor??(t.length===0?0:t.length-1);G(a,t.length);let n=Object.freeze([...t]),r=n[a]??"",o=i.filter??!0,l=_(R(e));Y(l,n.slice(0,a));let s=Z(l,r);if(s!==void 0)return k(l,s,n,a,o);let u=[];if(r.length===0||r.startsWith("-"))u.push(...ie(l));if(!r.startsWith("-")){u.push(...ae(l));let d=p(l);if(d!==void 0){let g=await k(l,{argument:d,current:r,outputPrefix:""},n,a,o);return u.push(...g.candidates),b({candidates:h(u,r,o),commandPath:l.commandPath,current:r,argument:d,...g.valueHint===void 0?{}:{valueHint:g.valueHint}})}}return b({candidates:h(u,r,o),commandPath:l.commandPath,current:r})}async function C(e,t={}){let i=await z(e,t.argv??Bun.argv.slice(2),t.cursor===void 0?{}:{cursor:t.cursor});if(i.candidates.length>0){let a=`${i.candidates.map(({value:n,description:r})=>`${E(n)} ${E(r??"")}`).join(`
3
- `)}
4
- `;(t.stdout??((n)=>process.stdout.write(n)))(a)}return 0}function G(e,t){if(!Number.isSafeInteger(e)||e<0||e>t)throw RangeError("The completion cursor must be an argv index or argv.length")}function _(e){let t={command:e,commandPath:[e.name],inheritedGlobals:[],positionalIndex:0,optionsEnabled:!0,pending:void 0,values:{},rawValues:{},cliProvided:new Set};return A(e.arguments,t),t}function A(e,t){for(let i of e){if(i.color)t.values[i.name]=Bun.env.NO_COLOR===void 0&&process.stdout.isTTY===!0&&Bun.env.TERM!=="dumb";else if(i.repeatable||i.trailingVarArg)t.values[i.name]=[];else if(i.presence==="default")t.values[i.name]=i.defaultValue;else t.values[i.name]=void 0;let a=i.env===void 0?void 0:Bun.env[i.env];if(a!==void 0)if(i.kind==="flag")t.values[i.name]=i.color?!1:i.action===q.SetTrue;else if(i.kind==="count"){let n=Number(a);if(Number.isSafeInteger(n)&&n>=0)t.values[i.name]=n}else c(i,v(i,a),t,!1)}}function Y(e,t){let i=0;while(i<t.length){let a=t[i];if(a===void 0)break;if(e.pending!==void 0){if(a===e.pending.argument.valueTerminator){w(e.pending,e),e.pending=void 0,i+=1;continue}if(!T(e,e.pending.argument,a)){Q(e,e.pending,a),i+=1;continue}w(e.pending,e),e.pending=void 0}if(e.optionsEnabled&&a==="--"){e.optionsEnabled=!1,i+=1;continue}let n=e.optionsEnabled&&W(e,a);if(e.optionsEnabled&&!n&&a.startsWith("--")&&a.length>2){J(e,a),i+=1;continue}if(e.optionsEnabled&&!n&&a.startsWith("-")&&a!=="-"){K(e,a),i+=1;continue}if(e.optionsEnabled&&!n){let o=S(e.command,a);if(o!==void 0){X(e,o),i+=1;continue}}let r=p(e);if(r!==void 0)if(a===r.valueTerminator)e.positionalIndex+=1;else{let o=c(r,v(r,a),e);if(!r.repeatable&&r.maxValues!==null&&o>=r.maxValues)e.positionalIndex+=1;if(r.trailingVarArg)e.optionsEnabled=!1}i+=1}}function V(e){return[...e.command.arguments,...e.inheritedGlobals]}function P(e,t){return V(e).find((i)=>i.kind!=="positional"&&F(i).includes(t))}function x(e,t){return V(e).find((i)=>i.kind!=="positional"&&i.short===t)}function J(e,t){let{name:i,inlineValue:a}=N(t),n=P(e,i);if(n===void 0)return;if(n.kind==="flag"||n.kind==="count"){I(n,e,n.negativeLong===i?!1:void 0);return}if(a===void 0&&n.requireEquals){O(n,e);return}let r=a===void 0?[]:y(n,a);if(r.length>0)c(n,r,e);let o=r.length;H(e,n,o)}function K(e,t){let i=B(t);for(let a=0;a<i.length;a+=1){let n=i[a];if(n===void 0)break;let r=x(e,n);if(r===void 0)return;if(r.kind==="flag"||r.kind==="count"){I(r,e);continue}let o=i.slice(a+1).join(""),l=o.length>0,s=o;if(s.startsWith("="))s=s.slice(1);if(!l&&r.requireEquals){O(r,e);return}let u=l?v(r,s):[];if(u.length>0)c(r,u,e);let d=u.length;H(e,r,d);return}}function H(e,t,i){if(t.maxValues===null||i<t.maxValues)e.pending={argument:t,consumed:i};else e.pending=void 0}function w(e,t){if(e.consumed===0)O(e.argument,t)}function O(e,t){if(!e.hasDefaultMissingValue)return;if(!t.cliProvided.has(e.name))t.cliProvided.add(e.name),t.rawValues[e.name]=[],t.values[e.name]=f(e)?[]:void 0;if(f(e)){let i=t.values[e.name];t.values[e.name]=[...Array.isArray(i)?i:[],e.defaultMissingValue]}else t.values[e.name]=e.defaultMissingValue}function Q(e,t,i){let a=v(t.argument,i);if(c(t.argument,a,e),t.consumed+=a.length,t.argument.maxValues!==null&&t.consumed>=t.argument.maxValues)e.pending=void 0}function T(e,t,i){if(M(t,i))return!0;return e.optionsEnabled&&t.minValues<=(e.pending?.consumed??0)&&S(e.command,i)!==void 0}function W(e,t){let i=p(e);if(i===void 0||t==="--"||t==="-"||!t.startsWith("-")||U(e,t))return!1;return i.allowHyphenValues||i.allowNegativeNumbers&&D(t)}function U(e,t){if(t.startsWith("--")){let a=t.indexOf("="),n=t.slice(2,a<0?void 0:a);return P(e,n)!==void 0||!e.command.disableHelpFlag&&t==="--help"||!e.command.disableVersionFlag&&e.command.version!==void 0&&t==="--version"}let i=t[1];return i!==void 0&&(x(e,i)!==void 0||!e.command.disableHelpFlag&&t==="-h"||!e.command.disableVersionFlag&&e.command.version!==void 0&&t==="-V")}function v(e,t){return y(e,t)}function c(e,t,i,a=!0){if(a&&!i.cliProvided.has(e.name))i.cliProvided.add(e.name),i.rawValues[e.name]=[],i.values[e.name]=f(e)?[]:void 0;let n=i.rawValues[e.name]??[];n.push(...t),i.rawValues[e.name]=n;let r=[];for(let o of t)try{r.push(e.parser?.parse(o)??o)}catch{}if(r.length===0)return n.length;if(f(e)){let o=i.values[e.name];i.values[e.name]=[...Array.isArray(o)?o:[],...r]}else i.values[e.name]=r.at(-1);return n.length}function f(e){return e.repeatable||e.trailingVarArg||e.maxValues===null||e.maxValues!==1}function I(e,t,i){let a=!t.cliProvided.has(e.name);if(t.cliProvided.add(e.name),e.kind==="flag"){let n=i??e.action!=="setFalse";t.values[e.name]=e.color&&Bun.env.NO_COLOR!==void 0?!1:n}else{let n=t.values[e.name];t.values[e.name]=!a&&typeof n==="number"?n+1:1}}function S(e,t){let i=L(e,t);return i.kind==="exact"||i.kind==="unique"?i.command:void 0}function X(e,t){e.inheritedGlobals=[...e.inheritedGlobals,...e.command.arguments.filter(({global:i})=>i)],e.command=t,e.commandPath.push(t.name),e.positionalIndex=0,e.pending=void 0,A(t.arguments,e)}function p(e){return e.command.arguments.filter(({kind:t})=>t==="positional")[e.positionalIndex]}function Z(e,t){if(e.pending!==void 0&&!T(e,e.pending.argument,t))return m(e.pending.argument,t,"");if(!e.optionsEnabled)return j(e,t);if(W(e,t))return j(e,t);if(t.startsWith("--")){let i=t.indexOf("=");if(i>=0){let a=P(e,t.slice(2,i));if(a?.kind==="option")return m(a,t.slice(i+1),t.slice(0,i+1))}return}if(t.startsWith("-")&&t!=="-"){let i=t.slice(1);for(let a=0;a<i.length;a+=1){let n=i[a];if(n===void 0)break;let r=x(e,n);if(r===void 0)break;if(r.kind!=="option")continue;let o=i[a+1]==="="?a+3:a+2,l=t.slice(0,o);return m(r,t.slice(o),l)}return}return}function j(e,t){let i=p(e);return i===void 0?void 0:m(i,t,"")}function m(e,t,i){if(e.valueDelimiter===void 0)return{argument:e,current:t,outputPrefix:i};let a=t.lastIndexOf(e.valueDelimiter);if(a<0)return{argument:e,current:t,outputPrefix:i};return{argument:e,current:t.slice(a+e.valueDelimiter.length),outputPrefix:`${i}${t.slice(0,a+1)}`}}async function k(e,t,i,a,n){let r=Object.freeze({argv:i,cursor:a,current:t.current,commandPath:Object.freeze([...e.commandPath]),command:e.command,argument:t.argument,values:ne(e.values),rawValues:re(e.rawValues)}),o=t.argument.completion,l=o===void 0?t.argument.parser?.completions??[]:await ee(o,r),s=te(l).map((d)=>Object.freeze({...d,value:`${t.outputPrefix}${d.value}`})),u=t.argument.completionHint??t.argument.parser?.completionHint;return b({candidates:h(s,`${t.outputPrefix}${t.current}`,n),commandPath:e.commandPath,current:t.current,argument:t.argument,...u===void 0?{}:{valueHint:u}})}async function ee(e,t){let i=await e(t);if(typeof i==="string"||i===null||typeof i!=="object")throw TypeError("A completion provider must return an iterable of candidates");let a=[];if(Symbol.asyncIterator in i)for await(let n of i)a.push(n);else if(Symbol.iterator in i)for(let n of i)a.push(n);else throw TypeError("A completion provider must return an iterable of candidates");return a}function te(e){return e.map((t)=>{let i=typeof t==="string"?{value:t}:t;if(i.value.length===0||i.value.includes("\x00")||i.value.includes(`
5
- `)||i.value.includes("\r")||i.value.includes("\t"))throw TypeError("A completion candidate must be a non-empty single-line value without tabs");return Object.freeze({value:i.value,...i.description===void 0?{}:{description:i.description}})})}function ie(e){let t=V(e).filter(({hidden:i,kind:a})=>!i&&a!=="positional").flatMap((i)=>[...i.short===void 0?[]:[`-${i.short}`],...i.long===void 0?[]:[`--${i.long}`],...i.negativeLong===void 0?[]:[`--${i.negativeLong}`],...i.aliases.map((a)=>`--${a}`)].map((a)=>({value:a,...i.help===void 0?{}:{description:i.help}})));if(!e.command.disableHelpFlag)t.push({value:"-h",description:"Print help"}),t.push({value:"--help",description:"Print help"});if(e.command.version!==void 0&&!e.command.disableVersionFlag)t.push({value:"-V",description:"Print version"}),t.push({value:"--version",description:"Print version"});return t}function ae(e){return e.command.subcommands.filter(({hidden:t})=>!t).flatMap((t)=>[t.name,...t.aliases.filter(({visible:i})=>i).map(({name:i})=>i)].map((i)=>({value:i,...t.about===void 0?{}:{description:t.about}})))}function h(e,t,i){let a=new Set;return Object.freeze(e.filter(({value:n})=>{if(i&&!n.startsWith(t))return!1;if(a.has(n))return!1;return a.add(n),!0}).map((n)=>Object.freeze({...n})))}function ne(e){return Object.freeze(Object.fromEntries(Object.entries(e).map(([t,i])=>[t,Array.isArray(i)?Object.freeze([...i]):i])))}function re(e){return Object.freeze(Object.fromEntries(Object.entries(e).map(([t,i])=>[t,Object.freeze([...i])])))}function b(e){return Object.freeze({...e,candidates:Object.freeze([...e.candidates]),commandPath:Object.freeze([...e.commandPath])})}function E(e){return Buffer.from(e).toString("hex")}export{z as resolveDynamicCompletion,C as runDynamicCompletionRequest};
6
-
7
- //# debugId=A2F89EFA953574B564756E2164756E21