Zafirox SDK
SDK 1.1.0 Cuentas Empezar

CDN y versiones

Rutas del CDN del SDK, canales, versiones inmutables, manifiesto con hashes de integridad y cabeceras de caché.

El CDN de sdk.joyeriazafirox.com distribuye cada versión compilada del SDK con sus tipos y su tarball npm. La lista viva está en /cdn y en /cdn/manifest.json.

Rutas

RutaContenidoCaché
/cdn/<versión>/index.jsPunto de entrada ESM de esa versión (por ejemplo 2.0.3)public, max-age=31536000, immutable
/cdn/<versión>/index.d.tsTipos TypeScriptinmutable
/cdn/<versión>/generated/order-policy.generated.jsMódulo de política requerido por SDK 2.xinmutable
/cdn/<versión>/zafirox-client-sdk-<versión>.tgzPaquete instalable con npm install <url>inmutable
/cdn/v1/…Última versión 1.x publicadamax-age=300 + X-Sdk-Version
/cdn/v2/…Última versión 2.x publicadamax-age=300 + X-Sdk-Version
/cdn/latest/…Última versión de cualquier líneamax-age=300 + X-Sdk-Version
/cdn/manifest.jsonVersiones, canales, archivos, tamaños e integridadmax-age=300

Cada versión contiene los módulos ESM, sus .d.ts y mapas de fuente. La línea 2.x incluye generated/order-policy.generated.js y sus tipos. Los import internos son relativos y cada dependencia se sirve desde la misma versión.

Manifiesto

El ejemplo refleja el manifiesto con SDK 2.0.3 en los canales v2 y latest; las versiones anteriores conservan sus entradas y sus archivos inmutables.

{
  "package": "@zafirox/client-sdk",
  "channels": { "latest": "2.0.3", "v1": "1.1.0", "v2": "2.0.3" },
  "versions": {
    "2.0.3": {
      "published_at": "<fecha UTC de la publicación>",
      "entry": "index.js",
      "types": "index.d.ts",
      "files": {
        "index.js": { "size": 1004, "sha384": "…", "integrity": "sha384-…" }
      }
    }
  }
}

Cabeceras

  • Access-Control-Allow-Origin: *, Cross-Origin-Resource-Policy: cross-origin y Timing-Allow-Origin: *: el CDN puede importarse desde cualquier origen.
  • ETag por archivo; If-None-Match devuelve 304.
  • Content-Type: text/javascript; charset=utf-8 para módulos; application/json para el manifiesto y los mapas.
  • X-Content-Type-Options: nosniff en todo.

Política de versiones

  • Una versión publicada no cambia nunca. Una corrección se publica como versión nueva.
  • Los canales (v1, v2, latest) avanzan sólo hacia versiones mayores o iguales dentro de su línea.
  • Las versiones antiguas permanecen disponibles; la retirada de una línea mayor se anuncia en el registro de cambios con antelación.

Recomendación por entorno

EntornoRuta
Desarrollo y pruebas de creación v2Canal v2
Producción en navegadorVersión exacta + verificación del hash del manifiesto
Producción en Node.jsTarball de versión exacta en package.json ("@zafirox/client-sdk": "https://sdk.joyeriazafirox.com/cdn/2.0.3/zafirox-client-sdk-2.0.3.tgz")