@ketvietlab/ketsuite 0.1.1

package/dist/modules/address/functions.js

@@ -0,0 +1,320 @@
+import { asc, defineFn, eq, from, isNull, like } from '@ketvietlab/ketjs';
+import { availableCatalogs, loadCatalog } from './loader.js';
+import { divisionPath, resolveAddress, snapshotAddress, validateAddress } from './format.js';
+const issue = (field, code, params) => ({
+    field,
+    code,
+    ...(params ? { params } : {}),
+});
+const invalid = (field, code, params) => ({
+    ok: false,
+    errors: [issue(field, code, params)],
+});
+const ISO = /^[A-Z]{2}$/;
+class CatalogConflict extends Error {
+}
+const installedEffects = [
+    'read:address.Country',
+    'write:address.Country',
+    'read:address.Catalog',
+    'write:address.Catalog',
+    'read:address.CurrentCatalog',
+    'write:address.CurrentCatalog',
+    'read:address.Division',
+    'write:address.Division',
+];
+export const functions = {
+    availableCatalogs: defineFn({
+        input: {},
+        output: { countryCode: 'text', version: 'text', recommended: 'bool' },
+        effects: [],
+        handler: () => availableCatalogs(),
+    }),
+    installCatalog: defineFn({
+        input: { countryCode: 'text', version: 'text?' },
+        output: {
+            ok: 'bool',
+            countryId: 'id?',
+            catalogId: 'id?',
+            recordCount: 'int?',
+            alreadyInstalled: 'bool?',
+            errors: 'json?',
+        },
+        effects: installedEffects,
+        exposure: 'internal',
+        idempotent: true,
+        handler: async (ctx, args) => {
+            const countryCode = String(args.countryCode).trim().toUpperCase();
+            if (!ISO.test(countryCode))
+                return invalid('countryCode', 'address.error.countryCode');
+            let bundle;
+            try {
+                bundle = await loadCatalog(countryCode, args.version ? String(args.version) : undefined);
+            }
+            catch (error) {
+                return invalid('countryCode', 'address.error.bundleInvalid', {
+                    reason: error instanceof Error ? error.message : String(error),
+                });
+            }
+            const catalogId = `${countryCode}:${bundle.catalog.version}`;
+            try {
+                return await ctx.tx(async (tx) => {
+                    const countryRow = {
+                        id: countryCode,
+                        code: countryCode,
+                        alpha3: bundle.country.alpha3 ?? null,
+                        numericCode: bundle.country.numericCode ?? null,
+                        name: bundle.country.name,
+                        officialName: bundle.country.officialName ?? null,
+                        localName: bundle.country.localName ?? null,
+                        callingCode: bundle.country.callingCode ?? null,
+                        policy: bundle.policy,
+                        active: true,
+                    };
+                    const countryInsert = await tx.db.insertIfAbsent('address.Country', countryRow);
+                    if (!('dryRun' in countryInsert) && !countryInsert.inserted)
+                        await tx.db.update('address.Country', { id: countryCode }, countryRow);
+                    const T = tx.table('address.Catalog');
+                    const existing = await tx.db.one(from(T).where(eq(T.id, catalogId)));
+                    if (existing) {
+                        if (existing.checksum !== bundle.checksum)
+                            return invalid('version', 'address.error.catalogImmutable');
+                        if (existing.status === 'active' || existing.status === 'verified') {
+                            return {
+                                ok: true,
+                                countryId: countryCode,
+                                catalogId,
+                                recordCount: Number(existing.recordCount),
+                                alreadyInstalled: true,
+                            };
+                        }
+                        return invalid('version', 'address.error.catalogBusy');
+                    }
+                    const claimed = await tx.db.insertIfAbsent('address.Catalog', {
+                        id: catalogId,
+                        countryId: countryCode,
+                        version: bundle.catalog.version,
+                        codeSystem: bundle.catalog.codeSystem,
+                        authority: bundle.catalog.authority,
+                        legalBasis: bundle.catalog.legalBasis ?? null,
+                        sourceUrl: bundle.catalog.sourceUrl ?? null,
+                        sourceAttribution: bundle.catalog.sourceAttribution ?? null,
+                        sourceFiles: bundle.catalog.sourceFiles ?? null,
+                        checksum: bundle.checksum,
+                        effectiveFrom: bundle.catalog.effectiveFrom,
+                        status: 'importing',
+                        recordCount: bundle.divisions.length,
+                        counts: bundle.catalog.divisions.counts,
+                        importedAt: null,
+                    });
+                    if (!('dryRun' in claimed) && !claimed.inserted) {
+                        const held = await tx.db.one(from(T).where(eq(T.id, catalogId)));
+                        if (held?.checksum === bundle.checksum && ['verified', 'active'].includes(String(held.status)))
+                            return {
+                                ok: true,
+                                countryId: countryCode,
+                                catalogId,
+                                recordCount: Number(held.recordCount),
+                                alreadyInstalled: true,
+                            };
+                        return invalid('version', 'address.error.catalogBusy');
+                    }
+                    const idOf = (code) => `${catalogId}:${code}`;
+                    for (const row of bundle.divisions)
+                        await tx.db.insert('address.Division', {
+                            id: idOf(row.code),
+                            countryId: countryCode,
+                            catalogId,
+                            parentId: row.parentCode ? idOf(row.parentCode) : null,
+                            code: row.code,
+                            officialName: row.officialName,
+                            shortName: row.shortName ?? null,
+                            kind: row.kind,
+                            level: row.level,
+                            active: true,
+                        });
+                    const importedAt = new Date().toISOString();
+                    await tx.db.update('address.Catalog', { id: catalogId }, { status: 'verified', importedAt });
+                    const P = tx.table('address.CurrentCatalog');
+                    const pointer = await tx.db.one(from(P).where(eq(P.countryId, countryCode)));
+                    if (!pointer) {
+                        await tx.db.insertIfAbsent('address.CurrentCatalog', {
+                            id: countryCode,
+                            countryId: countryCode,
+                            catalogId,
+                            version: 1,
+                            activatedAt: importedAt,
+                        });
+                    }
+                    else if (pointer.catalogId !== catalogId) {
+                        const changed = await tx.db.compareAndSet('address.CurrentCatalog', { id: pointer.id }, { version: pointer.version, catalogId: pointer.catalogId }, { catalogId, version: Number(pointer.version) + 1, activatedAt: importedAt });
+                        if (!('dryRun' in changed) && !changed.matched)
+                            throw new CatalogConflict();
+                        await tx.db.update('address.Catalog', { id: pointer.catalogId }, { status: 'retired' });
+                    }
+                    await tx.db.update('address.Catalog', { id: catalogId }, { status: 'active' });
+                    return {
+                        ok: true,
+                        countryId: countryCode,
+                        catalogId,
+                        recordCount: bundle.divisions.length,
+                        alreadyInstalled: false,
+                    };
+                });
+            }
+            catch (error) {
+                if (error instanceof CatalogConflict)
+                    return invalid('version', 'address.error.catalogBusy');
+                throw error;
+            }
+        },
+    }),
+    listCountries: defineFn({
+        input: { includeInactive: 'bool?' },
+        output: {
+            id: 'id',
+            code: 'text',
+            name: 'text',
+            localName: 'text?',
+            callingCode: 'text?',
+            active: 'bool',
+        },
+        effects: ['read:address.Country'],
+        agent: true,
+        handler: (ctx, args) => {
+            const C = ctx.table('address.Country');
+            let query = from(C)
+                .select(C.id, C.code, C.name, C.localName, C.callingCode, C.active)
+                .orderBy(asc(C.name));
+            if (args.includeInactive !== true)
+                query = query.where(eq(C.active, true));
+            return ctx.db.all(query);
+        },
+    }),
+    catalogStatus: defineFn({
+        input: { countryCode: 'text?' },
+        output: {
+            countryId: 'id',
+            countryName: 'text',
+            catalogId: 'id?',
+            version: 'text?',
+            status: 'text?',
+            recordCount: 'int?',
+            codeSystem: 'text?',
+            effectiveFrom: 'date?',
+        },
+        effects: ['read:address.Country', 'read:address.CurrentCatalog', 'read:address.Catalog'],
+        handler: async (ctx, args) => {
+            const C = ctx.table('address.Country');
+            let countries = await ctx.db.all(from(C).where(eq(C.active, true)).orderBy(asc(C.name)));
+            if (args.countryCode)
+                countries = countries.filter((row) => row.code === String(args.countryCode).trim().toUpperCase());
+            const P = ctx.table('address.CurrentCatalog');
+            const T = ctx.table('address.Catalog');
+            const out = [];
+            for (const country of countries) {
+                const pointer = await ctx.db.one(from(P).where(eq(P.countryId, country.id)));
+                const catalog = pointer ? await ctx.db.one(from(T).where(eq(T.id, pointer.catalogId))) : null;
+                out.push({
+                    countryId: country.id,
+                    countryName: country.localName || country.name,
+                    catalogId: catalog?.id ?? null,
+                    version: catalog?.version ?? null,
+                    status: catalog?.status ?? null,
+                    recordCount: catalog ? Number(catalog.recordCount) : null,
+                    codeSystem: catalog?.codeSystem ?? null,
+                    effectiveFrom: catalog?.effectiveFrom ?? null,
+                });
+            }
+            return out;
+        },
+    }),
+    listDivisionChildren: defineFn({
+        input: { countryCode: 'text', parentId: 'id?', search: 'text?', limit: 'int?' },
+        output: {
+            id: 'id',
+            code: 'text',
+            parentId: 'id?',
+            officialName: 'text',
+            shortName: 'text?',
+            kind: 'text',
+            level: 'int',
+        },
+        effects: ['read:address.CurrentCatalog', 'read:address.Division'],
+        agent: true,
+        handler: async (ctx, args) => {
+            const countryCode = String(args.countryCode).trim().toUpperCase();
+            const P = ctx.table('address.CurrentCatalog');
+            const pointer = await ctx.db.one(from(P).where(eq(P.countryId, countryCode)));
+            if (!pointer)
+                return [];
+            const D = ctx.table('address.Division');
+            let query = from(D)
+                .select(D.id, D.code, D.parentId, D.officialName, D.shortName, D.kind, D.level)
+                .where(eq(D.catalogId, pointer.catalogId), eq(D.active, true), args.parentId ? eq(D.parentId, args.parentId) : isNull(D.parentId))
+                .orderBy(asc(D.officialName));
+            if (args.search)
+                query = query.where(like(D.officialName, `%${String(args.search).trim()}%`));
+            query = query.limit(Math.min(Math.max(Number(args.limit ?? 500), 1), 1000));
+            return ctx.db.all(query);
+        },
+    }),
+    resolveDivisionPath: defineFn({
+        input: { id: 'id' },
+        output: { id: 'id', code: 'text', officialName: 'text', kind: 'text', level: 'int' },
+        effects: ['read:address.Division'],
+        handler: (ctx, args) => divisionPath(ctx, String(args.id)),
+    }),
+    validate: defineFn({
+        input: {
+            street1: 'text?',
+            street2: 'text?',
+            locality: 'text?',
+            postalCode: 'text?',
+            countryId: 'id',
+            divisionId: 'id?',
+        },
+        output: { ok: 'bool', errors: 'json?' },
+        effects: ['read:address.Country', 'read:address.CurrentCatalog', 'read:address.Division'],
+        handler: async (ctx, args) => {
+            const checked = await validateAddress(ctx, args);
+            return checked.issues.length ? { ok: false, errors: checked.issues } : { ok: true };
+        },
+    }),
+    format: defineFn({
+        input: {
+            street1: 'text?',
+            street2: 'text?',
+            locality: 'text?',
+            postalCode: 'text?',
+            countryId: 'id',
+            divisionId: 'id?',
+        },
+        output: { ok: 'bool', oneLine: 'text?', lines: 'json?', errors: 'json?' },
+        effects: ['read:address.Country', 'read:address.CurrentCatalog', 'read:address.Division'],
+        handler: async (ctx, args) => {
+            const resolved = await resolveAddress(ctx, args);
+            return resolved.value
+                ? { ok: true, oneLine: resolved.value.oneLine, lines: resolved.value.lines }
+                : { ok: false, errors: resolved.issues };
+        },
+    }),
+    snapshot: defineFn({
+        input: {
+            sourceAddressId: 'id?',
+            street1: 'text?',
+            street2: 'text?',
+            locality: 'text?',
+            postalCode: 'text?',
+            countryId: 'id',
+            divisionId: 'id?',
+        },
+        output: { ok: 'bool', snapshot: 'json?', errors: 'json?' },
+        effects: ['read:address.Country', 'read:address.CurrentCatalog', 'read:address.Division'],
+        handler: async (ctx, args) => {
+            const result = await snapshotAddress(ctx, { ...args, id: args.sourceAddressId });
+            return result.snapshot ? { ok: true, snapshot: result.snapshot } : { ok: false, errors: result.issues };
+        },
+    }),
+};
+//# sourceMappingURL=functions.js.map

package/dist/modules/address/functions.js.map

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

package/dist/modules/address/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: import("@ketvietlab/ketjs").KetModule;
+export default _default;
+export { availableCatalogs, loadCatalog } from './loader.ts';
+export { divisionPath, resolveAddress, snapshotAddress, validateAddress } from './format.ts';
+export type { AddressInput, AddressIssue, ResolvedAddress } from './format.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/address/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/address/index.ts"],"names":[],"mappings":";;AAmBA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC5F,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/modules/address/index.js

@@ -0,0 +1,20 @@
+import { defineModule } from '@ketvietlab/ketjs';
+import { functions } from './functions.js';
+import { messages } from './messages.js';
+import { models } from './models.js';
+import { relations } from './relations.js';
+export default defineModule({
+    name: 'address',
+    version: '0.1.0',
+    app: true,
+    title: 'Địa chỉ',
+    summary: 'Quốc gia, catalog địa giới có phiên bản và định dạng địa chỉ.',
+    category: 'Danh bạ',
+    models,
+    relations,
+    functions,
+    messages,
+});
+export { availableCatalogs, loadCatalog } from './loader.js';
+export { divisionPath, resolveAddress, snapshotAddress, validateAddress } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/address/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/address/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;IAChB,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,+DAA+D;IACxE,QAAQ,EAAE,SAAS;IACnB,MAAM;IACN,SAAS;IACT,SAAS;IACT,QAAQ;CACT,CAAC,CAAA;AAEF,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/modules/address/loader.d.ts

@@ -0,0 +1,74 @@
+export type CountryBundle = {
+    code: string;
+    alpha3?: string;
+    numericCode?: string;
+    name: string;
+    officialName?: string;
+    localName?: string;
+    callingCode?: string;
+};
+export type DivisionBundle = {
+    code: string;
+    parentCode: string | null;
+    level: number;
+    kind: string;
+    officialName: string;
+    shortName?: string;
+};
+export type AddressPolicy = {
+    schemaVersion: number;
+    countryCode: string;
+    postalCode: {
+        required: boolean;
+        pattern?: string;
+    };
+    divisionLevels: Array<{
+        level: number;
+        labelKey: string;
+        allowedKinds: string[];
+        required: boolean;
+    }>;
+    format: {
+        lines: string[][];
+    };
+};
+type Chunk = {
+    path: string;
+    count: number;
+    sha256: string;
+};
+type CatalogBundle = {
+    version: string;
+    codeSystem: string;
+    authority: string;
+    legalBasis?: string;
+    effectiveFrom: string;
+    sourceUrl?: string;
+    sourceAttribution?: unknown;
+    sourceFiles?: unknown[];
+    policy: {
+        path: string;
+        sha256: string;
+    };
+    divisions: {
+        totalCount: number;
+        counts: Record<string, number>;
+        chunks: Chunk[];
+    };
+};
+export type LoadedCatalog = {
+    country: CountryBundle;
+    catalog: CatalogBundle;
+    policy: AddressPolicy;
+    divisions: DivisionBundle[];
+    checksum: string;
+};
+export declare const availableCatalogs: () => Promise<Array<{
+    countryCode: string;
+    version: string;
+    recommended: boolean;
+}>>;
+export declare const loadCatalogFrom: (data: URL, countryInput: string, versionInput?: string) => Promise<LoadedCatalog>;
+export declare const loadCatalog: (countryInput: string, versionInput?: string) => Promise<LoadedCatalog>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/modules/address/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/address/loader.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,cAAc,EAAE,KAAK,CAAC;QACpB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,EAAE,MAAM,EAAE,CAAA;QACtB,QAAQ,EAAE,OAAO,CAAA;KAClB,CAAC,CAAA;IACF,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAA;KAAE,CAAA;CAC9B,CAAA;AAED,KAAK,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAC5D,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,WAAW,CAAC,EAAE,OAAO,EAAE,CAAA;IACvB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,SAAS,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,EAAE,KAAK,EAAE,CAAA;KAAE,CAAA;CACnF,CAAA;AAkBD,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,aAAa,CAAA;IACtB,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAgFD,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAChD,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAYtE,CAAA;AAED,eAAO,MAAM,eAAe,SACpB,GAAG,gBACK,MAAM,iBACL,MAAM,KACpB,OAAO,CAAC,aAAa,CA8CvB,CAAA;AAED,eAAO,MAAM,WAAW,iBAAkB,MAAM,iBAAiB,MAAM,KAAG,OAAO,CAAC,aAAa,CAC5C,CAAA"}

package/dist/modules/address/loader.js

@@ -0,0 +1,144 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+const DATA = new URL('./data/', import.meta.url);
+const ISO = /^[A-Z]{2}$/;
+const VERSION = /^\d{4}-\d{2}-\d{2}$/;
+const SHA256 = /^[a-f0-9]{64}$/;
+const digest = (value) => createHash('sha256').update(value).digest('hex');
+const safeRelative = (value) => !!value && !value.startsWith('/') && !value.includes('\\') && !value.split('/').includes('..');
+let indexPromise = null;
+const readIndex = (data) => readFile(new URL('index.json', data)).then((bytes) => {
+    const parsed = JSON.parse(bytes.toString('utf8'));
+    if (parsed.schemaVersion !== 1 || !parsed.countries || typeof parsed.countries !== 'object')
+        throw new Error('address data index has an unsupported schema');
+    return parsed;
+});
+const indexOf = () => {
+    indexPromise ??= readIndex(DATA);
+    return indexPromise;
+};
+const readVerified = async (url, expected) => {
+    if (!SHA256.test(expected))
+        throw new Error(`invalid SHA-256 for ${url.pathname}`);
+    const bytes = await readFile(url);
+    if (digest(bytes) !== expected)
+        throw new Error(`checksum mismatch for ${url.pathname}`);
+    return bytes;
+};
+const object = (value, label) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`${label} must be an object`);
+    return value;
+};
+const validateDivision = (value, index) => {
+    const row = object(value, `division ${index}`);
+    const known = new Set(['code', 'parentCode', 'level', 'kind', 'officialName', 'shortName']);
+    const unknown = Object.keys(row).filter((key) => !known.has(key));
+    if (unknown.length)
+        throw new Error(`division ${index} has unknown fields: ${unknown.join(', ')}`);
+    if (typeof row.code !== 'string' || !row.code)
+        throw new Error(`division ${index} has no code`);
+    if (row.parentCode !== null && typeof row.parentCode !== 'string')
+        throw new Error(`division ${row.code} has an invalid parentCode`);
+    if (!Number.isInteger(row.level) || Number(row.level) < 1 || Number(row.level) > 16)
+        throw new Error(`division ${row.code} has an invalid level`);
+    for (const field of ['kind', 'officialName'])
+        if (typeof row[field] !== 'string' || !String(row[field]).trim())
+            throw new Error(`division ${row.code} has an invalid ${field}`);
+    if (row.shortName != null && typeof row.shortName !== 'string')
+        throw new Error(`division ${row.code} has an invalid shortName`);
+    return row;
+};
+const validateTree = (rows, expectedCount) => {
+    if (rows.length !== expectedCount)
+        throw new Error(`expected ${expectedCount} divisions, got ${rows.length}`);
+    const byCode = new Map();
+    for (const row of rows) {
+        if (byCode.has(row.code))
+            throw new Error(`duplicate division code ${row.code}`);
+        byCode.set(row.code, row);
+    }
+    for (const row of rows) {
+        if (row.parentCode === null) {
+            if (row.level !== 1)
+                throw new Error(`root division ${row.code} must be level 1`);
+            continue;
+        }
+        const parent = byCode.get(row.parentCode);
+        if (!parent)
+            throw new Error(`division ${row.code} has unknown parent ${row.parentCode}`);
+        if (parent.level + 1 !== row.level)
+            throw new Error(`division ${row.code} skips an administrative level`);
+        const seen = new Set([row.code]);
+        let cursor = parent;
+        for (let depth = 0; cursor; depth++) {
+            if (depth >= 16 || seen.has(cursor.code))
+                throw new Error(`division ${row.code} has a cycle`);
+            seen.add(cursor.code);
+            cursor = cursor.parentCode ? byCode.get(cursor.parentCode) : undefined;
+        }
+    }
+};
+export const availableCatalogs = async () => {
+    const index = await indexOf();
+    return Object.entries(index.countries)
+        .flatMap(([countryCode, entry]) => Object.keys(entry.catalogs).map((version) => ({
+        countryCode,
+        version,
+        recommended: version === entry.recommendedCatalog,
+    })))
+        .sort((a, b) => a.countryCode.localeCompare(b.countryCode) || a.version.localeCompare(b.version));
+};
+export const loadCatalogFrom = async (data, countryInput, versionInput) => {
+    const countryCode = countryInput.trim().toUpperCase();
+    if (!ISO.test(countryCode))
+        throw new Error('countryCode must be ISO 3166-1 alpha-2');
+    const index = data.href === DATA.href ? await indexOf() : await readIndex(data);
+    const country = index.countries[countryCode];
+    if (!country)
+        throw new Error(`no bundled address catalog for ${countryCode}`);
+    const version = versionInput ?? country.recommendedCatalog;
+    if (!VERSION.test(version))
+        throw new Error('catalog version must be YYYY-MM-DD');
+    const entry = country.catalogs[version];
+    if (!entry || !safeRelative(entry.manifest) || !entry.manifest.startsWith(`${countryCode}/`))
+        throw new Error(`no bundled address catalog for ${countryCode} ${version}`);
+    const manifestUrl = new URL(entry.manifest, data);
+    const manifestBytes = await readVerified(manifestUrl, entry.sha256);
+    const manifest = JSON.parse(manifestBytes.toString('utf8'));
+    if (manifest.schemaVersion !== 1 ||
+        manifest.country?.code !== countryCode ||
+        manifest.recommendedCatalog !== country.recommendedCatalog)
+        throw new Error('address manifest does not match its index entry');
+    const catalog = manifest.catalogs.find((item) => item.version === version);
+    if (!catalog)
+        throw new Error(`manifest has no catalog ${version}`);
+    if (!safeRelative(catalog.policy.path))
+        throw new Error('address policy path is unsafe');
+    const policyUrl = new URL(catalog.policy.path, manifestUrl);
+    const policyBytes = await readVerified(policyUrl, catalog.policy.sha256);
+    const policy = JSON.parse(policyBytes.toString('utf8'));
+    if (policy.schemaVersion !== 1 || policy.countryCode !== countryCode)
+        throw new Error('address policy does not match its country');
+    const divisions = [];
+    for (const chunk of catalog.divisions.chunks) {
+        if (!safeRelative(chunk.path))
+            throw new Error('address division path is unsafe');
+        const bytes = await readVerified(new URL(chunk.path, manifestUrl), chunk.sha256);
+        const raw = JSON.parse(bytes.toString('utf8'));
+        if (!Array.isArray(raw) || raw.length !== chunk.count)
+            throw new Error(`address division chunk ${chunk.path} has the wrong count`);
+        for (const value of raw)
+            divisions.push(validateDivision(value, divisions.length));
+    }
+    validateTree(divisions, catalog.divisions.totalCount);
+    const actualCounts = divisions.reduce((out, row) => {
+        out[row.kind] = (out[row.kind] ?? 0) + 1;
+        return out;
+    }, {});
+    if (JSON.stringify(actualCounts) !== JSON.stringify(catalog.divisions.counts))
+        throw new Error('address division kind counts do not match the manifest');
+    return { country: manifest.country, catalog, policy, divisions, checksum: entry.sha256 };
+};
+export const loadCatalog = (countryInput, versionInput) => loadCatalogFrom(DATA, countryInput, versionInput);
+//# sourceMappingURL=loader.js.map

package/dist/modules/address/loader.js.map

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