georeference 0.0.0-stage → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog / Historique
+
+## 1.0.0
+
+### English
+
+CLI-first generation: the default command generates country files directly in a target project, with automatic GeoNames download, offline source input, geographic filters and existing-destination protection. No project dependency installation is required; the snapshot SDK remains optional.
+
+Initial V1: validated geographic snapshots; country/subdivision/type selection; JSON, NDJSON, CSV, PostgreSQL SQL, SQLite, and GeoJSON adapters; manifest verification and compression; PostgreSQL seeding; local read SDK; offline GeoNames ingestion; MIT software and bilingual public documentation.
+
+This entry describes the V1 codebase. A package version in source is not evidence of an npm publication or hosted deployment. Geographic source coverage and licensing are separate from software versioning.
+
+### Français
+
+Génération par commande : le parcours par défaut génère les fichiers de pays directement dans le projet cible, avec téléchargement GeoNames, entrée hors ligne, filtres géographiques et protection des destinations existantes. Aucune dépendance à installer dans le projet ; le SDK d'instantanés reste optionnel.
+
+Première V1 : instantanés géographiques validés ; sélection par pays/subdivision/type ; adaptateurs JSON, NDJSON, CSV, SQL PostgreSQL, SQLite et GeoJSON ; manifestes vérifiables et compression ; amorçage PostgreSQL ; SDK de lecture local ; ingestion GeoNames hors ligne ; logiciel MIT et documentation publique bilingue.
+
+Cette entrée décrit le code de la V1. Un numéro de version dans le dépôt ne prouve ni une publication npm ni un déploiement hébergé. Couverture et licences géographiques restent distinctes de la version logicielle.

package/CONTRIBUTING.fr.md

@@ -0,0 +1,44 @@
+# Contribuer à GeoReference
+
+[English](CONTRIBUTING.md) · [Accueil](README.fr.md)
+
+Les contributions doivent faciliter l'usage des données géographiques tout en préservant les identifiants, la provenance et les imports reproductibles. Pour un changement important, une nouvelle source ou un format, commencez par une issue afin de préciser le besoin et la cible de compatibilité.
+
+## Installation locale
+
+Utilisez Node.js 24.18.x et npm :
+
+```sh
+npm ci
+npm run check
+```
+
+Cette vérification lance la validation TypeScript, les tests de comportement et la compilation. Les tests emploient des données fictives et des répertoires temporaires. Un test d'intégration PostgreSQL utilise `DATABASE_URL` lorsqu'elle est définie ; un test sauté ne prouve pas le fonctionnement du transport PostgreSQL. Ne pointez jamais des fixtures de tests destructives vers une base de production.
+
+## Branches et pull requests
+
+- Créez une branche de tâche ciblée depuis `dev`, par exemple `feature/country-aliases`, `fix/csv-empty-values` ou `docs/import-guide`.
+- Les pull requests de travail ciblent `dev`. Les pull requests de livraison vont du `dev` de ce dépôt vers `main`.
+- Faites des commits cohérents et vérifiés selon Conventional Commits, par exemple `fix(csv): preserve absent optional fields`. Réunissez le comportement et ses tests ; ne commitez pas une étape volontairement rouge.
+- Expliquez le problème observable, le nouveau comportement, l'impact de compatibilité et les vérifications réellement exécutées. Liez l'issue correspondante si elle existe.
+- Les vérifications requises doivent passer sur la tête exacte de la pull request. Ne forcez pas les pushes, ne supprimez pas les branches protégées et ne contournez pas les revues/vérifications.
+
+La protection repose sur les réglages du dépôt ; un fichier de workflow seul n'est pas une protection. Sa disponibilité et ses paramètres effectifs doivent être vérifiés lors de la configuration.
+
+## Tests avant les changements de comportement
+
+Écrivez un test ciblé depuis le comportement attendu ou le bug reproduit, exécutez-le et observez un échec significatif, puis implémentez et refactorisez avec les tests verts. Par exemple, un import doit démontrer qu'une seconde exécution ne modifie pas les lignes inchangées, plutôt que vérifier seulement l'appel d'un helper.
+
+Les résultats attendus sont indépendants de l'implémentation. N'adaptez pas les attentes à un code erroné. Un échec d'import de module ne prouve que l'absence de structure ; les assertions doivent aussi distinguer un résultat concret incorrect. Documentation et fichiers statiques utilisent des vérifications directes plutôt que des tests artificiels.
+
+Pour un adaptateur, couvrez IDs stables, noms non ASCII, distinction absence/null, options refusées, lisibilité de la sortie, annulation et pertes éventuelles. Les changements en base demandent une validation sémantique sur un moteur réel et un parcours d'intégration PostgreSQL. Toute dépendance d'exécution doit avoir une utilité concrète et une licence/maintenance vérifiées.
+
+## Documentation publique et exemples
+
+Actualisez les guides anglais/français correspondants dans la même pull request. Code, champs d'API, options CLI et titres de commits restent anglais. Gardez les exemples exécutables et indiquez clairement les données fictives. N'annoncez pas un format ou une version de moteur non vérifié.
+
+Séparez les licences du logiciel et des données. Enregistrez licences, attributions et révisions sources. Ne commitez ni identifiants de connexion, téléchargements de données, exports de production, bases locales, builds générés, ni données personnelles. Les plans, prompts, rapports et transmissions privés d'agents n'appartiennent pas à ce dépôt.
+
+## Avant de demander une revue
+
+Examinez le diff indexé complet, lancez les vérifications adaptées et retirez les modifications sans lien. Signalez honnêtement les limites et vérifications sautées ou impossibles. Pour une vulnérabilité, suivez [SECURITY.fr.md](SECURITY.fr.md) plutôt que publier les détails d'exploitation dans une issue publique.

package/CONTRIBUTING.md

@@ -0,0 +1,44 @@
+# Contributing to GeoReference
+
+[Français](CONTRIBUTING.fr.md) · [Home](README.md)
+
+Contributions should make geographic data easier to use without weakening identifiers, provenance, or repeatable imports. Start with an issue for substantial behavior changes, new sources, or new formats so the use case and compatibility target are clear.
+
+## Local setup
+
+Use Node.js 24.18.x and npm:
+
+```sh
+npm ci
+npm run check
+```
+
+The check runs TypeScript validation, behavior tests, and the build. Tests use synthetic data and temporary directories. A PostgreSQL integration test uses `DATABASE_URL` when provided; a skipped integration test is not evidence that PostgreSQL transport was verified. Never point destructive test fixtures at a production database.
+
+## Branches and pull requests
+
+- Create a focused task branch from `dev`, for example `feature/country-aliases`, `fix/csv-empty-values`, or `docs/import-guide`.
+- Open working pull requests against `dev`. Release pull requests go from this repository's `dev` to `main`.
+- Keep commits coherent and verified, using Conventional Commits such as `fix(csv): preserve absent optional fields`. Include the behavior and its tests together; do not commit an intentionally failing intermediate state.
+- Explain the observable problem, resulting behavior, compatibility impact, and checks actually run. Link the relevant issue when one exists.
+- Required checks must pass on the actual pull-request head. Do not force push protected branches, delete them, or bypass required reviews/checks.
+
+Branch protection is enforced by repository settings; a workflow file alone is not protection. Availability and effective settings must be verified when configuring the repository.
+
+## Tests before behavior changes
+
+Write a focused test from the expected behavior or reproduced bug, run it and observe a meaningful failure, then implement and refactor with tests green. For example, an import change should demonstrate the second run leaves unchanged records untouched, not merely check that a helper was called.
+
+Use independent expected values. Do not adjust expectations to fit a broken implementation. An import/module-missing failure only proves missing scaffolding; behavioral assertions must also distinguish a concrete wrong result. Documentation and static assets use direct checks rather than artificial tests.
+
+For format adapters, cover stable IDs, non-ASCII names, absent versus null fields, unsupported options, output readability, cancellation, and any representation loss. Database changes need real engine semantics and a PostgreSQL integration path. Any new runtime dependency needs a concrete purpose and a license/maintenance check.
+
+## Public documentation and examples
+
+Update matching English/French guides in the same pull request. Code, API fields, CLI options, and commit subjects remain English. Keep examples executable and mark fictional data clearly. Do not advertise a format or database version that has not been verified.
+
+Keep software and data licensing separate. Record source licenses, attribution, and revisions. Do not commit credentials, downloaded datasets, production exports, local databases, generated builds, or personal data. Private agent plans, prompts, reports, and handoffs do not belong in this repository.
+
+## Before requesting review
+
+Inspect the full staged diff, run the applicable checks, and remove unrelated changes. State limitations honestly, including checks that were skipped or could not run. For security-sensitive findings, follow [SECURITY.md](SECURITY.md) instead of posting exploit details in a public issue.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Osiris Balonga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.fr.md

@@ -0,0 +1,84 @@
+# GeoReference
+
+[English](README.md) · [Prise en main](docs/getting-started.fr.md) · [Formats](docs/formats.fr.md) · [Contribuer](CONTRIBUTING.fr.md)
+
+Des données géographiques versionnées, des exports portables et un amorçage de base reproductible.
+
+GeoReference génère des fichiers de données géographiques directement dans votre projet. Exécutez la commande une fois, conservez les fichiers et utilisez-les sans dépendance GeoReference à l'exécution. Un SDK TypeScript optionnel permet aux applications de consulter des instantanés locaux.
+
+## Ce que propose la V1
+
+- Génération des pays en une commande depuis GeoNames, avec entrée hors ligne et filtrage géographique.
+- Instantanés SQLite validés et versionnés depuis du JSON/NDJSON canonique ou des fichiers texte GeoNames locaux.
+- Sélection par pays, descendants d'une subdivision et type d'entité, avec les ancêtres nécessaires inclus par défaut.
+- Inclusion indépendante des coordonnées ponctuelles et des frontières Polygon/MultiPolygon.
+- Exports JSON (plats ou hiérarchiques), NDJSON, CSV, SQL PostgreSQL, SQLite et GeoJSON.
+- Manifestes d'export avec provenance, options, nombres d'entités et sommes de contrôle SHA-256 ; compression gzip et ZIP.
+- Amorçage PostgreSQL avec aperçu par défaut, application explicite, mise à jour des champs gérés, identifiants stables et reprise par lots.
+- SDK local de lecture pour rechercher les pays/subdivisions et parcourir les localités.
+
+La commande par défaut télécharge les informations de pays GeoNames ; le dépôt contient le logiciel et un petit exemple **fictif**. Les autres couvertures dépendent des sources fournies. Les données GeoNames sont sous CC BY 4.0 ; la licence MIT du logiciel ne modifie pas celle des jeux de données.
+
+## Essayer en local
+
+Utilisez Node.js **24.18.x** et npm. Exécutez l'outil depuis votre projet :
+
+```sh
+npx georeference
+npx georeference countries --country FR,CG --format csv --output ./data/countries
+```
+
+La première commande crée `data/georeference/entities.json` et `manifest.json`. Le JSON contient `{ metadata, entities }`. `--output` désigne un nouveau dossier, pas un nom de fichier. La commande préserve les destinations existantes et ne modifie ni le manifeste du projet, ni le fichier de verrouillage, ni les dépendances. `npx` télécharge/met en cache l'outil hors du projet ; votre application lit directement les fichiers générés. Voir [la génération en une commande](docs/getting-started.fr.md) pour l'usage hors ligne et les six formats.
+
+Pour exécuter cette révision depuis les sources :
+
+```sh
+git clone https://github.com/Osiris-Balonga/georeference.git
+cd georeference
+npm ci
+npm run build
+node dist/cli.js
+```
+
+Le répertoire de destination d'un export doit être nouveau. Le [guide complet](docs/getting-started.fr.md) présente aussi l'ingestion GeoNames, l'amorçage PostgreSQL et le SDK.
+
+## SDK optionnel
+
+Seules les applications qui souhaitent utiliser l'API de consultation des instantanés ont besoin de `npm install georeference`. La génération de fichiers JSON, CSV ou autres ne nécessite pas d'ajouter cette dépendance. Voir [l'exemple SDK](docs/getting-started.fr.md#sdk-optionnel).
+
+## Trois façons d'utiliser les données
+
+| Besoin | Solution |
+|---|---|
+| Télécharger ou échanger un instantané | Exporter des fichiers accompagnés d'un manifeste |
+| Initialiser/mettre à jour une base applicative | Utiliser le seeder PostgreSQL avec une politique de mise à jour examinée |
+| Consulter le référentiel depuis une application | Utiliser le SDK de lecture sur un instantané local |
+
+Un export SQL ne suffit pas à constituer un seeder universel. L'import doit aussi gérer les clés existantes, les champs gérés, les conflits, les révisions, les transactions et la reprise. Voir [l'import en base](docs/seeding.fr.md).
+
+## Documentation
+
+| Français | English |
+|---|---|
+| [Génération en une commande](docs/generation.fr.md) | [One-shot generation](docs/generation.md) |
+| [Prise en main](docs/getting-started.fr.md) | [Getting started](docs/getting-started.md) |
+| [Formats pris en charge et limites](docs/formats.fr.md) | [Supported formats and limits](docs/formats.md) |
+| [Amorçage PostgreSQL](docs/seeding.fr.md) | [PostgreSQL seeding](docs/seeding.md) |
+| [Sources et licences des données](docs/data-sources.fr.md) | [Data sources and licenses](docs/data-sources.md) |
+| [Architecture et adaptateurs](docs/architecture.fr.md) | [Architecture and adapters](docs/architecture.md) |
+| [Contribuer](CONTRIBUTING.fr.md) | [Contributing](CONTRIBUTING.md) |
+
+Les guides publics sont maintenus dans les deux langues. Les identifiants d'API, champs et commandes restent anglais.
+
+## Développement
+
+```sh
+npm ci
+npm run check
+```
+
+Les changements de comportement commencent par les tests. Les branches de tâche ciblent `dev` ; les pull requests de livraison vont de `dev` vers `main`. Voir [CONTRIBUTING.fr.md](CONTRIBUTING.fr.md) pour le workflow et les vérifications PostgreSQL.
+
+## Licence
+
+Logiciel et exemples fictifs : [MIT](LICENSE), © 2026 Osiris Balonga. Données GeoNames : [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), avec attribution GeoNames obligatoire. Toute autre source conserve ses conditions. Lire [les licences des données](docs/data-sources.fr.md) avant de redistribuer des exports.

package/README.md

@@ -1,3 +1,84 @@
-# Temporary Holding Version
+# GeoReference
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[Français](README.fr.md) · [Getting started](docs/getting-started.md) · [Formats](docs/formats.md) · [Contributing](CONTRIBUTING.md)
+
+Versioned geographic datasets, portable exports, and repeatable database seeding.
+
+GeoReference generates geographic data files directly in your project. Run the CLI once, keep the generated files, and use them without a GeoReference runtime dependency. An optional TypeScript SDK supports applications that want to query local snapshots.
+
+## What V1 provides
+
+- One-command country generation from GeoNames, with offline input and geographic filtering.
+- Validated, versioned SQLite snapshots from canonical JSON/NDJSON or local GeoNames text files.
+- Selection by country, subdivision descendants, and entity type, with required ancestors included by default.
+- Independent inclusion of point coordinates and polygon/multipolygon boundaries.
+- JSON (flat or hierarchical), NDJSON, CSV, PostgreSQL SQL, SQLite, and GeoJSON exports.
+- Export manifests with provenance, request options, entity counts, and SHA-256 file checksums; gzip and ZIP packaging.
+- PostgreSQL seeding with a preview by default, explicit apply, managed-field updates, stable identifiers, and resumable batches.
+- A local read SDK with country/subdivision lookups and locality iteration.
+
+The default command downloads GeoNames country information; the repository itself ships software and a small **synthetic** example. Other geographic coverage depends on your input sources. GeoNames data is CC BY 4.0; the MIT software license does not change dataset licenses.
+
+## Try it locally
+
+Use Node.js **24.18.x** and npm. Run the tool from your project:
+
+```sh
+npx georeference
+npx georeference countries --country FR,CG --format csv --output ./data/countries
+```
+
+The first command creates `data/georeference/entities.json` and `manifest.json`. JSON contains `{ metadata, entities }`. `--output` is a new directory, not a filename. The CLI preserves existing destinations and does not edit your package manifest, lockfile, or dependencies. `npx` downloads/caches the tool outside the project; your application reads the generated files directly. See [one-shot generation](docs/getting-started.md) for offline use and all six formats.
+
+To run this revision from source:
+
+```sh
+git clone https://github.com/Osiris-Balonga/georeference.git
+cd georeference
+npm ci
+npm run build
+node dist/cli.js
+```
+
+Export output directories must be new. Start with the [complete guide](docs/getting-started.md) for GeoNames ingestion, PostgreSQL seeding, and SDK usage.
+
+## Optional SDK
+
+Only applications that want the snapshot query API need `npm install georeference`. Generating JSON, CSV, or other files does not require adding that dependency. See the [SDK example](docs/getting-started.md#optional-sdk).
+
+## Three ways to use the data
+
+| Need | Use |
+|---|---|
+| Download or exchange a snapshot | Export files with a manifest |
+| Initialize/update an application database | Use the PostgreSQL seeder with a reviewed update policy |
+| Query reference data from application code | Use the read SDK over a local snapshot |
+
+An SQL export is not a universal seeder. Seeding also deals with existing keys, field ownership, conflicts, revisions, transactions, and recovery. See [database import](docs/seeding.md).
+
+## Documentation
+
+| English | Français |
+|---|---|
+| [One-shot generation](docs/generation.md) | [Génération en une commande](docs/generation.fr.md) |
+| [Getting started](docs/getting-started.md) | [Prise en main](docs/getting-started.fr.md) |
+| [Supported formats and limits](docs/formats.md) | [Formats pris en charge et limites](docs/formats.fr.md) |
+| [PostgreSQL seeding](docs/seeding.md) | [Amorçage PostgreSQL](docs/seeding.fr.md) |
+| [Data sources and licenses](docs/data-sources.md) | [Sources et licences des données](docs/data-sources.fr.md) |
+| [Architecture and adapters](docs/architecture.md) | [Architecture et adaptateurs](docs/architecture.fr.md) |
+| [Contributing](CONTRIBUTING.md) | [Contribuer](CONTRIBUTING.fr.md) |
+
+Public guides are maintained in both languages. API identifiers, fields, and commands stay English.
+
+## Development
+
+```sh
+npm ci
+npm run check
+```
+
+Behavior changes use tests first. Task branches target `dev`; release pull requests go from `dev` to `main`. See [CONTRIBUTING.md](CONTRIBUTING.md) for the workflow and PostgreSQL integration checks.
+
+## License
+
+Software and synthetic examples: [MIT](LICENSE), © 2026 Osiris Balonga. GeoNames data: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), with required GeoNames attribution. Any other source keeps its own terms. Read [data licensing](docs/data-sources.md) before redistributing exports.

package/SECURITY.fr.md

@@ -0,0 +1,9 @@
+# Signaler une vulnérabilité
+
+[English](SECURITY.md)
+
+Ne publiez pas d'identifiants de connexion, de jeux de données privés ni de procédure d'exploitation dans une issue publique. Si le signalement privé GitHub est activé pour ce dépôt, utilisez **Security → Report a vulnerability**. S'il ne l'est pas, ouvrez une issue demandant au mainteneur d'activer un canal privé, sans inclure les détails d'exploitation.
+
+Dans le rapport privé, indiquez la révision concernée, une reproduction fictive minimale, le résultat attendu/observé et l'impact constaté. Aucun délai de réponse ni période de support n'est promis ici. Les bugs ordinaires sans impact sensible passent par les issues habituelles.
+
+Traitez données téléchargées et paquets comme non fiables. Conservez manifestes et licences, utilisez des permissions locales adaptées et ne lancez jamais des tests d'import sur une base de production.

package/SECURITY.md

@@ -0,0 +1,9 @@
+# Reporting security issues
+
+[Français](SECURITY.fr.md)
+
+Please do not publish credentials, private datasets, or exploit instructions in a public issue. If GitHub private vulnerability reporting is enabled for this repository, use the repository's **Security → Report a vulnerability** entry. If it is unavailable, open a public issue asking the maintainer to enable a private reporting channel, without including exploit details.
+
+For a private report, include the affected revision, a minimal synthetic reproduction, expected/actual behavior, and the impact you observed. No response-time commitment or support window is promised here. General bugs without sensitive impact belong in the normal issue tracker.
+
+Treat downloaded data and packages as untrusted. Preserve manifests and source licenses, use appropriate local file permissions, and never run import tests against production databases.

package/dist/adapters/common.d.ts

@@ -0,0 +1,5 @@
+import type { AdapterContext, Entity, ExportRequest } from '../types.ts';
+export declare function validateOptions(request: ExportRequest, hierarchical?: boolean): void;
+export declare function project(entity: Entity, request: ExportRequest): Entity;
+export declare function writeChunks(context: AdapterContext, filename: string, chunks: Iterable<string> | AsyncIterable<string>): Promise<void>;
+export declare function jsonArray(values: Iterable<unknown>): Generator<string>;

package/dist/adapters/common.js

@@ -0,0 +1,37 @@
+import { createWriteStream } from 'node:fs';
+import { join } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+export function validateOptions(request, hierarchical = false) {
+    if (request.layout === 'hierarchical' && !hierarchical)
+        throw new Error(`${request.format} does not support hierarchical layout`);
+    if (request.format !== 'sql-postgres' && (request.schemaMode !== undefined || request.sqlMode !== undefined)) {
+        throw new Error('SQL options are only supported by sql-postgres');
+    }
+    if (request.format !== 'csv' && request.spreadsheetSafe !== undefined)
+        throw new Error('spreadsheetSafe is only supported by CSV');
+}
+export function project(entity, request) {
+    const result = { ...entity };
+    if (!request.coordinates)
+        delete result.coordinates;
+    if (!request.boundaries)
+        delete result.boundary;
+    return result;
+}
+export async function writeChunks(context, filename, chunks) {
+    context.signal?.throwIfAborted();
+    await pipeline(Readable.from(chunks), createWriteStream(join(context.directory, filename), { flags: 'wx' }), context.signal ? { signal: context.signal } : {});
+}
+export function* jsonArray(values) {
+    yield '[';
+    let first = true;
+    for (const value of values) {
+        if (!first)
+            yield ',';
+        yield JSON.stringify(value);
+        first = false;
+    }
+    yield ']';
+}
+//# sourceMappingURL=common.js.map

package/dist/adapters/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/adapters/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,MAAM,UAAU,eAAe,CAAC,OAAsB,EAAE,YAAY,GAAG,KAAK;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,uCAAuC,CAAC,CAAC;IAClI,IAAI,OAAO,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,EAAE,CAAC;QAC7G,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AACrI,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,OAAsB;IAC5D,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC,WAAW,CAAC;IACpD,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAuB,EAAE,QAAgB,EAAE,MAAgD;IAC3H,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjK,CAAC;AAED,MAAM,SAAS,CAAC,CAAC,SAAS,CAAC,MAAyB;IAClD,MAAM,GAAG,CAAC;IACV,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,MAAM,GAAG,CAAC;QACtB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5B,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;IACD,MAAM,GAAG,CAAC;AACZ,CAAC","sourcesContent":["import { createWriteStream } from 'node:fs';\nimport { join } from 'node:path';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream/promises';\nimport type { AdapterContext, Entity, ExportRequest } from '../types.ts';\n\nexport function validateOptions(request: ExportRequest, hierarchical = false): void {\n  if (request.layout === 'hierarchical' && !hierarchical) throw new Error(`${request.format} does not support hierarchical layout`);\n  if (request.format !== 'sql-postgres' && (request.schemaMode !== undefined || request.sqlMode !== undefined)) {\n    throw new Error('SQL options are only supported by sql-postgres');\n  }\n  if (request.format !== 'csv' && request.spreadsheetSafe !== undefined) throw new Error('spreadsheetSafe is only supported by CSV');\n}\n\nexport function project(entity: Entity, request: ExportRequest): Entity {\n  const result = { ...entity };\n  if (!request.coordinates) delete result.coordinates;\n  if (!request.boundaries) delete result.boundary;\n  return result;\n}\n\nexport async function writeChunks(context: AdapterContext, filename: string, chunks: Iterable<string> | AsyncIterable<string>): Promise<void> {\n  context.signal?.throwIfAborted();\n  await pipeline(Readable.from(chunks), createWriteStream(join(context.directory, filename), { flags: 'wx' }), context.signal ? { signal: context.signal } : {});\n}\n\nexport function* jsonArray(values: Iterable<unknown>): Generator<string> {\n  yield '[';\n  let first = true;\n  for (const value of values) {\n    if (!first) yield ',';\n    yield JSON.stringify(value);\n    first = false;\n  }\n  yield ']';\n}\n"]}

package/dist/adapters/csv.d.ts

@@ -0,0 +1,2 @@
+import type { ExportAdapter } from '../types.ts';
+export declare const csvAdapter: ExportAdapter;

package/dist/adapters/csv.js

@@ -0,0 +1,32 @@
+import { stringify } from 'csv-stringify/sync';
+import { project, validateOptions, writeChunks } from "./common.js";
+function spreadsheetCell(value, enabled) {
+    return enabled && /^[\s]*[=+\-@\t\r\n]/u.test(value) ? `'${value}` : value;
+}
+export const csvAdapter = {
+    format: 'csv', version: '1.0.0',
+    validate: validateOptions,
+    async write(context) {
+        const { request } = context.plan;
+        const columns = ['id', 'entityType', 'name', 'countryId', 'parentId', 'codes', 'names', 'level'];
+        if (request.coordinates)
+            columns.push('coordinates');
+        if (request.boundaries)
+            columns.push('boundary');
+        await writeChunks(context, 'entities.csv', (function* () {
+            yield stringify([columns], { record_delimiter: '\r\n' });
+            for (const original of context.plan.entities()) {
+                const entity = project(original, request);
+                const cells = {
+                    id: spreadsheetCell(entity.id, request.spreadsheetSafe), entityType: entity.entityType,
+                    name: spreadsheetCell(entity.name, request.spreadsheetSafe), countryId: spreadsheetCell(entity.countryId, request.spreadsheetSafe),
+                    parentId: JSON.stringify(entity.parentId), codes: JSON.stringify(entity.codes) ?? '', names: JSON.stringify(entity.names) ?? '',
+                    level: JSON.stringify(entity.level) ?? '', coordinates: JSON.stringify(entity.coordinates) ?? '', boundary: JSON.stringify(entity.boundary) ?? '',
+                };
+                yield stringify([columns.map(column => cells[column])], { record_delimiter: '\r\n' });
+            }
+        })());
+        return ['entities.csv'];
+    },
+};
+//# sourceMappingURL=csv.js.map

package/dist/adapters/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../src/adapters/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEpE,SAAS,eAAe,CAAC,KAAa,EAAE,OAA4B;IAClE,OAAO,OAAO,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO;IAC/B,QAAQ,EAAE,eAAe;IACzB,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;QACjC,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjG,IAAI,OAAO,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,UAAU;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,QAAQ,CAAC;YACnD,MAAM,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;YACzD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC1C,MAAM,KAAK,GAA2B;oBACpC,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU;oBACtF,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC;oBAClI,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC/H,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;iBAClJ,CAAC;gBACF,MAAM,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC,CAAC,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;YACzF,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC","sourcesContent":["import { stringify } from 'csv-stringify/sync';\nimport type { ExportAdapter } from '../types.ts';\nimport { project, validateOptions, writeChunks } from './common.ts';\n\nfunction spreadsheetCell(value: string, enabled: boolean | undefined): string {\n  return enabled && /^[\\s]*[=+\\-@\\t\\r\\n]/u.test(value) ? `'${value}` : value;\n}\n\nexport const csvAdapter: ExportAdapter = {\n  format: 'csv', version: '1.0.0',\n  validate: validateOptions,\n  async write(context) {\n    const { request } = context.plan;\n    const columns = ['id', 'entityType', 'name', 'countryId', 'parentId', 'codes', 'names', 'level'];\n    if (request.coordinates) columns.push('coordinates');\n    if (request.boundaries) columns.push('boundary');\n    await writeChunks(context, 'entities.csv', (function* () {\n      yield stringify([columns], { record_delimiter: '\\r\\n' });\n      for (const original of context.plan.entities()) {\n        const entity = project(original, request);\n        const cells: Record<string, string> = {\n          id: spreadsheetCell(entity.id, request.spreadsheetSafe), entityType: entity.entityType,\n          name: spreadsheetCell(entity.name, request.spreadsheetSafe), countryId: spreadsheetCell(entity.countryId, request.spreadsheetSafe),\n          parentId: JSON.stringify(entity.parentId), codes: JSON.stringify(entity.codes) ?? '', names: JSON.stringify(entity.names) ?? '',\n          level: JSON.stringify(entity.level) ?? '', coordinates: JSON.stringify(entity.coordinates) ?? '', boundary: JSON.stringify(entity.boundary) ?? '',\n        };\n        yield stringify([columns.map(column => cells[column]!)], { record_delimiter: '\\r\\n' });\n      }\n    })());\n    return ['entities.csv'];\n  },\n};\n"]}

package/dist/adapters/geojson.d.ts

@@ -0,0 +1,2 @@
+import type { ExportAdapter } from '../types.ts';
+export declare const geojsonAdapter: ExportAdapter;

package/dist/adapters/geojson.js

@@ -0,0 +1,36 @@
+import { jsonArray, project, validateOptions, writeChunks } from "./common.js";
+function* collection(context, layer) {
+    yield '{"type":"FeatureCollection","features":';
+    yield* jsonArray((function* () {
+        for (const original of context.plan.entities()) {
+            const entity = project(original, context.plan.request);
+            const { coordinates, boundary, ...properties } = entity;
+            const geometry = layer === 'points'
+                ? coordinates ? { type: 'Point', coordinates: [coordinates.longitude, coordinates.latitude] } : null
+                : boundary ?? null;
+            yield { type: 'Feature', id: entity.id, properties, geometry };
+        }
+    })());
+    yield '}\n';
+}
+export const geojsonAdapter = {
+    format: 'geojson', version: '1.0.0',
+    validate(request) {
+        validateOptions(request);
+        if (!request.coordinates && !request.boundaries)
+            throw new Error('GeoJSON requires coordinates and/or boundaries');
+    },
+    async write(context) {
+        const files = [];
+        if (context.plan.request.coordinates) {
+            await writeChunks(context, 'points.geojson', collection(context, 'points'));
+            files.push('points.geojson');
+        }
+        if (context.plan.request.boundaries) {
+            await writeChunks(context, 'boundaries.geojson', collection(context, 'boundaries'));
+            files.push('boundaries.geojson');
+        }
+        return files;
+    },
+};
+//# sourceMappingURL=geojson.js.map

package/dist/adapters/geojson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geojson.js","sourceRoot":"","sources":["../../src/adapters/geojson.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/E,QAAQ,CAAC,CAAC,UAAU,CAAC,OAAuB,EAAE,KAA8B;IAC1E,MAAM,yCAAyC,CAAC;IAChD,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;YACxD,MAAM,QAAQ,GAAG,KAAK,KAAK,QAAQ;gBACjC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;gBACpG,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC;YACrB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;QACjE,CAAC;IACH,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,MAAM,KAAK,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO;IACnC,QAAQ,CAAC,OAAO;QACd,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACrH,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACpC,MAAM,WAAW,CAAC,OAAO,EAAE,oBAAoB,EAAE,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;YACpF,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC","sourcesContent":["import type { AdapterContext, ExportAdapter } from '../types.ts';\nimport { jsonArray, project, validateOptions, writeChunks } from './common.ts';\n\nfunction* collection(context: AdapterContext, layer: 'points' | 'boundaries'): Generator<string> {\n  yield '{\"type\":\"FeatureCollection\",\"features\":';\n  yield* jsonArray((function* () {\n    for (const original of context.plan.entities()) {\n      const entity = project(original, context.plan.request);\n      const { coordinates, boundary, ...properties } = entity;\n      const geometry = layer === 'points'\n        ? coordinates ? { type: 'Point', coordinates: [coordinates.longitude, coordinates.latitude] } : null\n        : boundary ?? null;\n      yield { type: 'Feature', id: entity.id, properties, geometry };\n    }\n  })());\n  yield '}\\n';\n}\n\nexport const geojsonAdapter: ExportAdapter = {\n  format: 'geojson', version: '1.0.0',\n  validate(request) {\n    validateOptions(request);\n    if (!request.coordinates && !request.boundaries) throw new Error('GeoJSON requires coordinates and/or boundaries');\n  },\n  async write(context) {\n    const files: string[] = [];\n    if (context.plan.request.coordinates) {\n      await writeChunks(context, 'points.geojson', collection(context, 'points'));\n      files.push('points.geojson');\n    }\n    if (context.plan.request.boundaries) {\n      await writeChunks(context, 'boundaries.geojson', collection(context, 'boundaries'));\n      files.push('boundaries.geojson');\n    }\n    return files;\n  },\n};\n"]}

package/dist/adapters/index.d.ts

@@ -0,0 +1,3 @@
+import type { ExportAdapter } from '../types.ts';
+/** A static registry keeps format dependencies separate from selection and identity rules. */
+export declare function getBuiltinAdapters(): ExportAdapter[];

package/dist/adapters/index.js

@@ -0,0 +1,10 @@
+import { csvAdapter } from "./csv.js";
+import { geojsonAdapter } from "./geojson.js";
+import { jsonAdapter, ndjsonAdapter } from "./json.js";
+import { postgresAdapter } from "./postgres.js";
+import { sqliteAdapter } from "./sqlite.js";
+/** A static registry keeps format dependencies separate from selection and identity rules. */
+export function getBuiltinAdapters() {
+    return [jsonAdapter, ndjsonAdapter, csvAdapter, postgresAdapter, sqliteAdapter, geojsonAdapter];
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,8FAA8F;AAC9F,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;AAClG,CAAC","sourcesContent":["import type { ExportAdapter } from '../types.ts';\nimport { csvAdapter } from './csv.ts';\nimport { geojsonAdapter } from './geojson.ts';\nimport { jsonAdapter, ndjsonAdapter } from './json.ts';\nimport { postgresAdapter } from './postgres.ts';\nimport { sqliteAdapter } from './sqlite.ts';\n\n/** A static registry keeps format dependencies separate from selection and identity rules. */\nexport function getBuiltinAdapters(): ExportAdapter[] {\n  return [jsonAdapter, ndjsonAdapter, csvAdapter, postgresAdapter, sqliteAdapter, geojsonAdapter];\n}\n"]}

package/dist/adapters/json.d.ts

@@ -0,0 +1,3 @@
+import type { ExportAdapter } from '../types.ts';
+export declare const jsonAdapter: ExportAdapter;
+export declare const ndjsonAdapter: ExportAdapter;

package/dist/adapters/json.js

@@ -0,0 +1,48 @@
+import { jsonArray, project, validateOptions, writeChunks } from "./common.js";
+function* flatDocument(context) {
+    yield `{"metadata":${JSON.stringify(context.plan.metadata)},"entities":`;
+    yield* jsonArray((function* () { for (const entity of context.plan.entities())
+        yield project(entity, context.plan.request); })());
+    yield '}\n';
+}
+function hierarchy(context) {
+    if (context.plan.count > 50_000)
+        throw new Error('Hierarchical JSON is limited to 50,000 entities; use flat JSON or partitions');
+    const nodes = new Map();
+    for (const entity of context.plan.entities())
+        nodes.set(entity.id, { ...project(entity, context.plan.request), children: [] });
+    const roots = [];
+    for (const node of nodes.values()) {
+        const parent = node.parentId === null ? undefined : nodes.get(node.parentId);
+        if (parent)
+            parent.children.push(node);
+        else
+            roots.push(node);
+    }
+    return roots;
+}
+export const jsonAdapter = {
+    format: 'json', version: '1.0.0',
+    validate(request) { validateOptions(request, true); },
+    async write(context) {
+        if (context.plan.request.layout === 'hierarchical') {
+            const entities = hierarchy(context);
+            await writeChunks(context, 'entities.json', [JSON.stringify({ metadata: context.plan.metadata, entities }) + '\n']);
+        }
+        else
+            await writeChunks(context, 'entities.json', flatDocument(context));
+        return ['entities.json'];
+    },
+};
+export const ndjsonAdapter = {
+    format: 'ndjson', version: '1.0.0',
+    validate: validateOptions,
+    async write(context) {
+        await writeChunks(context, 'entities.ndjson', (function* () {
+            for (const entity of context.plan.entities())
+                yield JSON.stringify(project(entity, context.plan.request)) + '\n';
+        })());
+        return ['entities.ndjson'];
+    },
+};
+//# sourceMappingURL=json.js.map

package/dist/adapters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/adapters/json.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AdapterContext, Entity, ExportAdapter } from '../types.ts';\nimport { jsonArray, project, validateOptions, writeChunks } from './common.ts';\n\ninterface TreeEntity extends Entity { children: TreeEntity[] }\n\nfunction* flatDocument(context: AdapterContext): Generator<string> {\n  yield `{\"metadata\":${JSON.stringify(context.plan.metadata)},\"entities\":`;\n  yield* jsonArray((function* () { for (const entity of context.plan.entities()) yield project(entity, context.plan.request); })());\n  yield '}\\n';\n}\n\nfunction hierarchy(context: AdapterContext): TreeEntity[] {\n  if (context.plan.count > 50_000) throw new Error('Hierarchical JSON is limited to 50,000 entities; use flat JSON or partitions');\n  const nodes = new Map<string, TreeEntity>();\n  for (const entity of context.plan.entities()) nodes.set(entity.id, { ...project(entity, context.plan.request), children: [] });\n  const roots: TreeEntity[] = [];\n  for (const node of nodes.values()) {\n    const parent = node.parentId === null ? undefined : nodes.get(node.parentId);\n    if (parent) parent.children.push(node);\n    else roots.push(node);\n  }\n  return roots;\n}\n\nexport const jsonAdapter: ExportAdapter = {\n  format: 'json', version: '1.0.0',\n  validate(request) { validateOptions(request, true); },\n  async write(context) {\n    if (context.plan.request.layout === 'hierarchical') {\n      const entities = hierarchy(context);\n      await writeChunks(context, 'entities.json', [JSON.stringify({ metadata: context.plan.metadata, entities }) + '\\n']);\n    } else await writeChunks(context, 'entities.json', flatDocument(context));\n    return ['entities.json'];\n  },\n};\n\nexport const ndjsonAdapter: ExportAdapter = {\n  format: 'ndjson', version: '1.0.0',\n  validate: validateOptions,\n  async write(context) {\n    await writeChunks(context, 'entities.ndjson', (function* () {\n      for (const entity of context.plan.entities()) yield JSON.stringify(project(entity, context.plan.request)) + '\\n';\n    })());\n    return ['entities.ndjson'];\n  },\n};\n"]}

package/dist/adapters/postgres.d.ts

@@ -0,0 +1,3 @@
+import type { ExportAdapter } from '../types.ts';
+export declare const POSTGRES_SCHEMA = "CREATE TABLE IF NOT EXISTS \"georeference_entities\" (\n  \"id\" TEXT PRIMARY KEY,\n  \"entity_type\" TEXT NOT NULL,\n  \"name\" TEXT NOT NULL,\n  \"country_id\" TEXT NOT NULL,\n  \"parent_id\" TEXT REFERENCES \"georeference_entities\"(\"id\") DEFERRABLE INITIALLY DEFERRED,\n  \"codes\" JSONB NOT NULL DEFAULT '{}',\n  \"names\" JSONB NOT NULL DEFAULT '{}',\n  \"level\" INTEGER,\n  \"coordinates\" JSONB,\n  \"boundary\" JSONB\n);\nCREATE INDEX IF NOT EXISTS \"georeference_entities_parent_idx\" ON \"georeference_entities\" (\"parent_id\");\n";
+export declare const postgresAdapter: ExportAdapter;