@konstit/dne 0.1.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.
- package/README.md +85 -352
- package/dist/address-search-index.d.ts +34 -0
- package/dist/address-search-index.js +326 -0
- package/dist/address-search-index.js.map +1 -0
- package/dist/address-search-pool-errors.d.ts +15 -0
- package/dist/address-search-pool-errors.js +25 -0
- package/dist/address-search-pool-errors.js.map +1 -0
- package/dist/address-search-pool.d.ts +40 -0
- package/dist/address-search-pool.js +215 -0
- package/dist/address-search-pool.js.map +1 -0
- package/dist/address-search-rank.d.ts +5 -0
- package/dist/address-search-rank.js +89 -0
- package/dist/address-search-rank.js.map +1 -0
- package/dist/address-search-text.d.ts +6 -0
- package/dist/address-search-text.js +16 -0
- package/dist/address-search-text.js.map +1 -0
- package/dist/address-search-worker-runtime.d.ts +41 -0
- package/dist/address-search-worker-runtime.js +38 -0
- package/dist/address-search-worker-runtime.js.map +1 -0
- package/dist/address-search-worker-source.d.ts +2 -0
- package/dist/address-search-worker-source.js +5 -0
- package/dist/address-search-worker-source.js.map +1 -0
- package/dist/address-search.d.ts +31 -0
- package/dist/address-search.js +152 -0
- package/dist/address-search.js.map +1 -0
- package/dist/bairro-runs.d.ts +20 -0
- package/dist/bairro-runs.js +202 -0
- package/dist/bairro-runs.js.map +1 -0
- package/dist/binary-db-errors.d.ts +1 -1
- package/dist/binary-db-errors.js +1 -1
- package/dist/binary-db-errors.js.map +1 -1
- package/dist/binary-db-format.d.ts +10 -2
- package/dist/binary-db-format.js +9 -1
- package/dist/binary-db-format.js.map +1 -1
- package/dist/binary-db-integrity.d.ts +4 -0
- package/dist/binary-db-integrity.js +20 -0
- package/dist/binary-db-integrity.js.map +1 -0
- package/dist/binary-db-reader.d.ts +46 -28
- package/dist/binary-db-reader.js +237 -360
- package/dist/binary-db-reader.js.map +1 -1
- package/dist/binary-db-validator.d.ts +13 -0
- package/dist/binary-db-validator.js +709 -0
- package/dist/binary-db-validator.js.map +1 -0
- package/dist/chunks/dynamic-completion-wbp85hh9-cytdw6ns.js +7 -0
- package/dist/chunks/dynamic-completion-wbp85hh9-cytdw6ns.js.map +10 -0
- package/dist/chunks/index-338dn00y.js +18 -0
- package/dist/chunks/index-338dn00y.js.map +10 -0
- package/dist/expand.d.ts +8 -0
- package/dist/expand.js +1484 -0
- package/dist/expand.js.map +1 -0
- package/dist/fsst.d.ts +18 -0
- package/dist/fsst.js +117 -0
- package/dist/fsst.js.map +1 -0
- package/dist/index.js +48 -48
- package/dist/index.js.map +30 -18
- package/dist/library.d.ts +9 -2
- package/dist/library.js +9 -2
- package/dist/library.js.map +1 -1
- package/dist/locality-runs.d.ts +18 -0
- package/dist/locality-runs.js +108 -0
- package/dist/locality-runs.js.map +1 -0
- package/dist/packed-bits.d.ts +6 -0
- package/dist/packed-bits.js +41 -0
- package/dist/packed-bits.js.map +1 -0
- package/dist/settings.d.ts +0 -2
- package/dist/settings.js +0 -2
- package/dist/settings.js.map +1 -1
- package/dist/shared-file.d.ts +2 -0
- package/dist/shared-file.js +35 -0
- package/dist/shared-file.js.map +1 -0
- package/dist/sqlite-db-reader.d.ts +13 -4
- package/dist/sqlite-db-reader.js +39 -17
- package/dist/sqlite-db-reader.js.map +1 -1
- package/dist/types.d.ts +29 -4
- package/dist/types.js +73 -4
- package/dist/types.js.map +1 -1
- package/package.json +13 -10
- package/data/dne.bin +0 -0
- package/dist/chunks/dynamic-completion-403da357-4jc4w04x.js +0 -7
- package/dist/chunks/dynamic-completion-403da357-4jc4w04x.js.map +0 -10
- package/dist/chunks/index-s0h4vdva.js +0 -17
- 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
|
|
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
|
|
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 {
|
|
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
|
package/dist/library.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"library.js","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,
|
|
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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { type BinaryRegion, type ByteWidth } from './binary-db-format.ts';
|
|
2
|
+
export type LocalityRuns = {
|
|
3
|
+
count: number;
|
|
4
|
+
directoryOffset: number;
|
|
5
|
+
startsOffset: number;
|
|
6
|
+
idsOffset: number;
|
|
7
|
+
};
|
|
8
|
+
/** Groups consecutive rows with the same municipality and locality indicators. */
|
|
9
|
+
export declare function encodeLocalityRuns(ids: Uint8Array, flags: Uint8Array, width: ByteWidth): {
|
|
10
|
+
ids: Uint8Array<ArrayBuffer>;
|
|
11
|
+
flags: Uint8Array<ArrayBuffer>;
|
|
12
|
+
};
|
|
13
|
+
/** Reads locations after the file has passed integrity verification. */
|
|
14
|
+
export declare function readLocalityRunsLayout(data: DataView, region: BinaryRegion, rows: number): LocalityRuns;
|
|
15
|
+
/** Validates run starts and the directory used to bound each row lookup. */
|
|
16
|
+
export declare function parseLocalityRuns(data: DataView, region: BinaryRegion, rows: number, width: ByteWidth): LocalityRuns;
|
|
17
|
+
/** Returns the run that contains the row; only runs touching its 256-row block are searched. */
|
|
18
|
+
export declare function findLocalityRun(data: DataView, runs: LocalityRuns, row: number): number;
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { DneBinaryDatabaseFormatError } from "./binary-db-errors.js";
|
|
2
|
+
import { readPackedInteger, writePackedInteger, } from "./binary-db-format.js";
|
|
3
|
+
const HEADER_BYTES = 8;
|
|
4
|
+
const BLOCK_SHIFT = 8;
|
|
5
|
+
const BLOCK_ROWS = 1 << BLOCK_SHIFT;
|
|
6
|
+
/** Groups consecutive rows with the same municipality and locality indicators. */
|
|
7
|
+
export function encodeLocalityRuns(ids, flags, width) {
|
|
8
|
+
const source = new DataView(ids.buffer, ids.byteOffset, ids.byteLength);
|
|
9
|
+
const starts = [];
|
|
10
|
+
const runIds = [];
|
|
11
|
+
const runFlags = [];
|
|
12
|
+
let previousId = -1;
|
|
13
|
+
let previousFlags = -1;
|
|
14
|
+
for (let row = 0; row < flags.length; row++) {
|
|
15
|
+
const id = readPackedInteger(source, row * width, width);
|
|
16
|
+
const indicators = flags[row] ?? 0;
|
|
17
|
+
if (id !== previousId || indicators !== previousFlags) {
|
|
18
|
+
starts.push(row);
|
|
19
|
+
runIds.push(id);
|
|
20
|
+
runFlags.push(indicators);
|
|
21
|
+
previousId = id;
|
|
22
|
+
previousFlags = indicators;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
const count = starts.length;
|
|
26
|
+
const blockCount = Math.ceil(flags.length / BLOCK_ROWS);
|
|
27
|
+
const startsOffset = HEADER_BYTES + (blockCount + 1) * 4;
|
|
28
|
+
const idsOffset = startsOffset + count * 4;
|
|
29
|
+
const bytes = new Uint8Array(idsOffset + count * width);
|
|
30
|
+
const data = new DataView(bytes.buffer);
|
|
31
|
+
data.setUint32(0, count, true);
|
|
32
|
+
data.setUint8(4, BLOCK_SHIFT);
|
|
33
|
+
let run = 0;
|
|
34
|
+
for (let block = 0; block < blockCount; block++) {
|
|
35
|
+
while (run + 1 < count && (starts[run + 1] ?? 0) <= block * BLOCK_ROWS) {
|
|
36
|
+
run++;
|
|
37
|
+
}
|
|
38
|
+
data.setUint32(HEADER_BYTES + block * 4, run, true);
|
|
39
|
+
}
|
|
40
|
+
data.setUint32(HEADER_BYTES + blockCount * 4, count, true);
|
|
41
|
+
for (let index = 0; index < count; index++) {
|
|
42
|
+
data.setUint32(startsOffset + index * 4, starts[index] ?? 0, true);
|
|
43
|
+
writePackedInteger(bytes, idsOffset + index * width, runIds[index] ?? 0, width);
|
|
44
|
+
}
|
|
45
|
+
return { ids: bytes, flags: Uint8Array.from(runFlags) };
|
|
46
|
+
}
|
|
47
|
+
/** Reads locations after the file has passed integrity verification. */
|
|
48
|
+
export function readLocalityRunsLayout(data, region, rows) {
|
|
49
|
+
const count = data.getUint32(region.offset, true);
|
|
50
|
+
const directoryOffset = region.offset + HEADER_BYTES;
|
|
51
|
+
const startsOffset = directoryOffset + (Math.ceil(rows / BLOCK_ROWS) + 1) * 4;
|
|
52
|
+
return { count, directoryOffset, startsOffset, idsOffset: startsOffset + count * 4 };
|
|
53
|
+
}
|
|
54
|
+
/** Validates run starts and the directory used to bound each row lookup. */
|
|
55
|
+
export function parseLocalityRuns(data, region, rows, width) {
|
|
56
|
+
if (region.length < HEADER_BYTES) {
|
|
57
|
+
throw new DneBinaryDatabaseFormatError('Binary locality runs are truncated');
|
|
58
|
+
}
|
|
59
|
+
const count = data.getUint32(region.offset, true);
|
|
60
|
+
if (count === 0 || count > rows || data.getUint32(region.offset + 4, true) !== BLOCK_SHIFT) {
|
|
61
|
+
throw new DneBinaryDatabaseFormatError('Invalid binary locality run header');
|
|
62
|
+
}
|
|
63
|
+
const blockCount = Math.ceil(rows / BLOCK_ROWS);
|
|
64
|
+
const directoryOffset = region.offset + HEADER_BYTES;
|
|
65
|
+
const startsOffset = directoryOffset + (blockCount + 1) * 4;
|
|
66
|
+
const idsOffset = startsOffset + count * 4;
|
|
67
|
+
if (idsOffset + count * width !== region.offset + region.length) {
|
|
68
|
+
throw new DneBinaryDatabaseFormatError('Invalid binary locality run length');
|
|
69
|
+
}
|
|
70
|
+
let previous = -1;
|
|
71
|
+
for (let run = 0; run < count; run++) {
|
|
72
|
+
const start = data.getUint32(startsOffset + run * 4, true);
|
|
73
|
+
if ((run === 0 && start !== 0) || start <= previous || start >= rows) {
|
|
74
|
+
throw new DneBinaryDatabaseFormatError('Invalid binary locality run boundary');
|
|
75
|
+
}
|
|
76
|
+
previous = start;
|
|
77
|
+
}
|
|
78
|
+
let run = 0;
|
|
79
|
+
for (let block = 0; block < blockCount; block++) {
|
|
80
|
+
while (run + 1 < count && data.getUint32(startsOffset + (run + 1) * 4, true) <= block * BLOCK_ROWS) {
|
|
81
|
+
run++;
|
|
82
|
+
}
|
|
83
|
+
if (data.getUint32(directoryOffset + block * 4, true) !== run) {
|
|
84
|
+
throw new DneBinaryDatabaseFormatError('Invalid binary locality run directory');
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
if (data.getUint32(directoryOffset + blockCount * 4, true) !== count) {
|
|
88
|
+
throw new DneBinaryDatabaseFormatError('Invalid binary locality run sentinel');
|
|
89
|
+
}
|
|
90
|
+
return { count, directoryOffset, startsOffset, idsOffset };
|
|
91
|
+
}
|
|
92
|
+
/** Returns the run that contains the row; only runs touching its 256-row block are searched. */
|
|
93
|
+
export function findLocalityRun(data, runs, row) {
|
|
94
|
+
const block = Math.floor(row / BLOCK_ROWS);
|
|
95
|
+
let low = data.getUint32(runs.directoryOffset + block * 4, true);
|
|
96
|
+
let high = Math.min(runs.count, data.getUint32(runs.directoryOffset + (block + 1) * 4, true) + 1);
|
|
97
|
+
while (low + 1 < high) {
|
|
98
|
+
const middle = low + ((high - low) >>> 1);
|
|
99
|
+
if (data.getUint32(runs.startsOffset + middle * 4, true) <= row) {
|
|
100
|
+
low = middle;
|
|
101
|
+
}
|
|
102
|
+
else {
|
|
103
|
+
high = middle;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
return low;
|
|
107
|
+
}
|
|
108
|
+
//# sourceMappingURL=locality-runs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"locality-runs.js","sourceRoot":"","sources":["../src/locality-runs.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/** Minimum nonzero bit width for a column containing values from zero through maxValue. */
|
|
2
|
+
export declare function integerBitWidth(maxValue: number): number;
|
|
3
|
+
/** Reads one unsigned value without decoding any preceding values. Width must be in 1..32. */
|
|
4
|
+
export declare function readPackedBits(data: DataView, offset: number, index: number, width: number): number;
|
|
5
|
+
/** Writes one unsigned value into a zero-initialized packed column. */
|
|
6
|
+
export declare function writePackedBits(bytes: Uint8Array, index: number, width: number, value: number): void;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/** Minimum nonzero bit width for a column containing values from zero through maxValue. */
|
|
2
|
+
export function integerBitWidth(maxValue) {
|
|
3
|
+
return Math.max(1, Math.ceil(Math.log2(maxValue + 1)));
|
|
4
|
+
}
|
|
5
|
+
/** Reads one unsigned value without decoding any preceding values. Width must be in 1..32. */
|
|
6
|
+
export function readPackedBits(data, offset, index, width) {
|
|
7
|
+
const bit = index * width;
|
|
8
|
+
const byte = offset + Math.floor(bit / 8);
|
|
9
|
+
const shift = bit & 7;
|
|
10
|
+
const end = shift + width;
|
|
11
|
+
let value = data.getUint8(byte);
|
|
12
|
+
if (end > 8) {
|
|
13
|
+
value |= data.getUint8(byte + 1) << 8;
|
|
14
|
+
}
|
|
15
|
+
if (end > 16) {
|
|
16
|
+
value |= data.getUint8(byte + 2) << 16;
|
|
17
|
+
}
|
|
18
|
+
if (end > 24) {
|
|
19
|
+
value |= data.getUint8(byte + 3) << 24;
|
|
20
|
+
}
|
|
21
|
+
let result = (value >>> shift) & (0xffff_ffff >>> (32 - width));
|
|
22
|
+
if (end > 32) {
|
|
23
|
+
result += (data.getUint8(byte + 4) & ((1 << (end - 32)) - 1)) * 2 ** (32 - shift);
|
|
24
|
+
}
|
|
25
|
+
return result >>> 0;
|
|
26
|
+
}
|
|
27
|
+
/** Writes one unsigned value into a zero-initialized packed column. */
|
|
28
|
+
export function writePackedBits(bytes, index, width, value) {
|
|
29
|
+
if (!Number.isInteger(value) || value < 0 || value >= 2 ** width || width < 1 || width > 32) {
|
|
30
|
+
throw new Error(`Invalid ${width}-bit column value: ${value}`);
|
|
31
|
+
}
|
|
32
|
+
const bit = index * width;
|
|
33
|
+
const byte = Math.floor(bit / 8);
|
|
34
|
+
const shift = bit & 7;
|
|
35
|
+
const shifted = value * 2 ** shift;
|
|
36
|
+
const count = Math.ceil((shift + width) / 8);
|
|
37
|
+
for (let part = 0; part < count; part++) {
|
|
38
|
+
bytes[byte + part] = (bytes[byte + part] ?? 0) | (Math.floor(shifted / 2 ** (part * 8)) & 255);
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
//# sourceMappingURL=packed-bits.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"packed-bits.js","sourceRoot":"","sources":["../src/packed-bits.ts"],"names":[],"mappings":"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"}
|
package/dist/settings.d.ts
CHANGED
|
@@ -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. */
|
package/dist/settings.js.map
CHANGED
|
@@ -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,
|
|
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,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
|
-
*
|
|
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>[];
|
package/dist/sqlite-db-reader.js
CHANGED
|
@@ -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
|
-
*
|
|
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
|
-
|
|
98
|
-
|
|
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
|
-
|
|
128
|
-
|
|
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
|
-
|
|
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
|
-
`)
|
|
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
|
-
|
|
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
|
-
`)
|
|
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.
|
|
224
|
-
|
|
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
|
|
234
|
-
truncated
|
|
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":"AAAA,OAAO,EAAE,QAAQ,
|
|
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:
|
|
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;
|