@dotrino/geo 0.2.2 → 0.7.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dotrino/geo",
-  "version": "0.2.2",
-  "description": "Cliente del índice geo de Dotrino (geo.dotrino.com): pins georreferenciados firmados con el vault, consulta por radio (PostGIS)",
+  "version": "0.7.0",
+  "description": "Dotrino geo index client (geo.dotrino.com): vault-signed georeferenced pins, radius queries (PostGIS)",
   "type": "module",
   "main": "src/index.js",
   "module": "src/index.js",

package/src/index.js

@@ -30,17 +30,20 @@ const DEFAULT_TTL_MS = 10 * 60 * 1000 // 10 min: pins efímeros por diseño
  * Crea un cliente del índice geo.
  *
  * @param {object} opts
- * @param {(data:object)=>Promise<string>} opts.signData   firma canónica → base64 (del vault)
- * @param {()=>Promise<string>} opts.getPublicKeyJwk        pubkey JWK string (del vault)
+ * @param {(data:object)=>Promise<{signature:string, publickey:string, chain:object[]}>} opts.signData
+ *   Firma del vault. Devuelve el paquete: quién firmó y la cadena que lo prueba.
+ * @param {()=>Promise<string>} opts.getPublicKeyJwk
+ *   MI IDENTIDAD (`profileId`), no la llave de este aparato: si pasas la del aparato,
+ *   publicar desde el teléfono y desde el PC crea dos autores distintos.
  * @param {string} [opts.baseUrl]                           default https://geo.dotrino.com
  * @param {typeof fetch} [opts.fetch]                       fetch inyectable (tests/SSR)
  */
 export function createGeoClient ({ signData, getPublicKeyJwk, baseUrl = DEFAULT_BASE, fetch: f } = {}) {
   if (typeof signData !== 'function' || typeof getPublicKeyJwk !== 'function') {
-    throw new Error('dotrino-geo: signData y getPublicKeyJwk son requeridos (inyectalos desde el vault de identidad)')
+    throw new Error('dotrino-geo: signData and getPublicKeyJwk are required (inject them from the identity vault)')
   }
   const doFetch = f || (typeof fetch !== 'undefined' ? fetch.bind(globalThis) : null)
-  if (!doFetch) throw new Error('dotrino-geo: no hay fetch disponible; inyectalo en opts.fetch')
+  if (!doFetch) throw new Error('dotrino-geo: no fetch available; inject it in opts.fetch')
   const base = baseUrl.replace(/\/+$/, '')
 
   /**
@@ -58,6 +61,9 @@ export function createGeoClient ({ signData, getPublicKeyJwk, baseUrl = DEFAULT_
    */
   async function publishPin ({ lat, lng, payload = {}, tags, ttlMs = DEFAULT_TTL_MS, geohashPrecision = 7, now } = {}) {
     assertLatLng(lat, lng)
+    // `publickey` ES LA IDENTIDAD, no la llave del aparato que firma. Antes se ponía la
+    // del aparato, así que publicar desde el teléfono y desde el PC creaba dos «autores»
+    // distintos para la misma persona — y quien mirara el mapa vería dos.
     const publickey = await getPublicKeyJwk()
     const ts = now ?? Date.now()
     const data = {
@@ -71,11 +77,16 @@ export function createGeoClient ({ signData, getPublicKeyJwk, baseUrl = DEFAULT_
     }
     const cleanTags = normalizeTags(tags)
     if (cleanTags.length) data.tags = cleanTags
-    const signature = await signData(data)
+    const firma = await signData(data)
+    // Un vault viejo devuelve solo la firma; uno nuevo, el paquete con quién firmó y la
+    // cadena que prueba que ese firmante habla por esta identidad.
+    const sobre = typeof firma === 'string'
+      ? { data, signature: firma }
+      : { data, signature: firma.signature, ...(firma.publickey ? { signer: firma.publickey } : {}), ...(firma.chain?.length ? { chain: firma.chain } : {}) }
     const res = await doFetch(`${base}/pins`, {
       method: 'PUT',
       headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ data, signature })
+      body: JSON.stringify(sobre)
     })
     return handle(res)
   }
@@ -94,7 +105,7 @@ export function createGeoClient ({ signData, getPublicKeyJwk, baseUrl = DEFAULT_
    */
   async function queryRadius ({ lat, lng, radiusMeters, limit = 50, filter, tags } = {}) {
     assertLatLng(lat, lng)
-    if (!(radiusMeters > 0)) throw new Error('dotrino-geo: radiusMeters debe ser > 0')
+    if (!(radiusMeters > 0)) throw new Error('dotrino-geo: radiusMeters must be > 0')
     const params = new URLSearchParams({
       lat: String(lat), lng: String(lng), r: String(radiusMeters), limit: String(limit)
     })
@@ -127,8 +138,8 @@ export function createGeoClient ({ signData, getPublicKeyJwk, baseUrl = DEFAULT_
 // ----- helpers -----------------------------------------------------------
 
 function assertLatLng (lat, lng) {
-  if (typeof lat !== 'number' || lat < -90 || lat > 90) throw new Error('dotrino-geo: lat inválida')
-  if (typeof lng !== 'number' || lng < -180 || lng > 180) throw new Error('dotrino-geo: lng inválida')
+  if (typeof lat !== 'number' || lat < -90 || lat > 90) throw new Error('dotrino-geo: invalid lat')
+  if (typeof lng !== 'number' || lng < -180 || lng > 180) throw new Error('dotrino-geo: invalid lng')
 }
 
 function round (n, decimals) {