@ressjs/platform 0.6.0-rc.0 → 0.6.0-rc.1

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { detectPlatform } from './compat';
 export { DETECTION_LAYERS } from './detect/layers';
 export type { DetectionInput, DetectionLayer } from './detect/layers';
 export { createPlatformRegistry, defaultPlatformRegistry } from './registry/create';
-export { parseVariantSuffix } from './registry/parse';
+export { parseVariantSuffix, PlatformTokenError } from './registry/parse';
 export { ALL_AXES, DEFAULT_AXIS_PRECEDENCE, DEFAULT_VALUES, RETIRED_TOKENS, } from './registry/defaults';
 export { DEFAULT_RULES } from './rules/user-agent';
 export { EDGE_PRESETS, readEdgeHeaders } from './rules/edge';

package/dist/index.js

@@ -8,7 +8,7 @@
  * de nada.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializePlatform = exports.platformScriptTag = exports.isWebView = exports.isTV = exports.isHandheld = exports.hasCapability = exports.DEFAULT_PLATFORM = exports.varyHeadersForAxes = exports.HEADERS_BY_AXIS = exports.PLATFORM_VARY_HEADERS = exports.PLATFORM_REQUEST_HEADERS = exports.HEADERS_V2 = exports.HEADERS_LEGACY = exports.HEADERS_CLIENT_HINTS = exports.HEADER_OVERRIDE = exports.readEdgeHeaders = exports.EDGE_PRESETS = exports.DEFAULT_RULES = exports.RETIRED_TOKENS = exports.DEFAULT_VALUES = exports.DEFAULT_AXIS_PRECEDENCE = exports.ALL_AXES = exports.parseVariantSuffix = exports.defaultPlatformRegistry = exports.createPlatformRegistry = exports.DETECTION_LAYERS = exports.detectPlatform = exports.detect = void 0;
+exports.serializePlatform = exports.platformScriptTag = exports.isWebView = exports.isTV = exports.isHandheld = exports.hasCapability = exports.DEFAULT_PLATFORM = exports.varyHeadersForAxes = exports.HEADERS_BY_AXIS = exports.PLATFORM_VARY_HEADERS = exports.PLATFORM_REQUEST_HEADERS = exports.HEADERS_V2 = exports.HEADERS_LEGACY = exports.HEADERS_CLIENT_HINTS = exports.HEADER_OVERRIDE = exports.readEdgeHeaders = exports.EDGE_PRESETS = exports.DEFAULT_RULES = exports.RETIRED_TOKENS = exports.DEFAULT_VALUES = exports.DEFAULT_AXIS_PRECEDENCE = exports.ALL_AXES = exports.PlatformTokenError = exports.parseVariantSuffix = exports.defaultPlatformRegistry = exports.createPlatformRegistry = exports.DETECTION_LAYERS = exports.detectPlatform = exports.detect = void 0;
 var pipeline_1 = require("./detect/pipeline");
 Object.defineProperty(exports, "detect", { enumerable: true, get: function () { return pipeline_1.detect; } });
 var compat_1 = require("./compat");
@@ -20,6 +20,7 @@ Object.defineProperty(exports, "createPlatformRegistry", { enumerable: true, get
 Object.defineProperty(exports, "defaultPlatformRegistry", { enumerable: true, get: function () { return create_1.defaultPlatformRegistry; } });
 var parse_1 = require("./registry/parse");
 Object.defineProperty(exports, "parseVariantSuffix", { enumerable: true, get: function () { return parse_1.parseVariantSuffix; } });
+Object.defineProperty(exports, "PlatformTokenError", { enumerable: true, get: function () { return parse_1.PlatformTokenError; } });
 var defaults_1 = require("./registry/defaults");
 Object.defineProperty(exports, "ALL_AXES", { enumerable: true, get: function () { return defaults_1.ALL_AXES; } });
 Object.defineProperty(exports, "DEFAULT_AXIS_PRECEDENCE", { enumerable: true, get: function () { return defaults_1.DEFAULT_AXIS_PRECEDENCE; } });

package/dist/registry/parse.d.ts

@@ -1,4 +1,32 @@
 import type { PlatformRegistry, VariantTag } from './types';
+/**
+ * Un token de plataforma del nombre de un archivo no se pudo clasificar.
+ *
+ * Lleva los datos además del texto, para que quien lo muestre (la CLI) pueda
+ * darle el formato de sus demás errores sin interpretar el mensaje.
+ */
+export declare class PlatformTokenError extends Error {
+    /** Estable: lo reconocen quienes no pueden importar esta clase. */
+    readonly code: "RESS_PLATFORM_TOKEN";
+    readonly kind: 'retired' | 'unknown';
+    readonly token: string;
+    readonly origin?: string;
+    /** Sólo `retired`: con qué se reemplaza y por qué se retiró. */
+    readonly replacement?: string;
+    readonly reason?: string;
+    /** Sólo `unknown`: el token válido más parecido. */
+    readonly suggestion?: string;
+    readonly valid: readonly string[];
+    constructor(message: string, details: {
+        kind: 'retired' | 'unknown';
+        token: string;
+        origin?: string;
+        replacement?: string;
+        reason?: string;
+        suggestion?: string;
+        valid: readonly string[];
+    });
+}
 /**
  * Convierte el sufijo de un archivo de variante en tags clasificados.
  *

package/dist/registry/parse.js

@@ -1,6 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformTokenError = void 0;
 exports.parseVariantSuffix = parseVariantSuffix;
+/**
+ * Un token de plataforma del nombre de un archivo no se pudo clasificar.
+ *
+ * Lleva los datos además del texto, para que quien lo muestre (la CLI) pueda
+ * darle el formato de sus demás errores sin interpretar el mensaje.
+ */
+class PlatformTokenError extends Error {
+    /** Estable: lo reconocen quienes no pueden importar esta clase. */
+    code = 'RESS_PLATFORM_TOKEN';
+    kind;
+    token;
+    origin;
+    /** Sólo `retired`: con qué se reemplaza y por qué se retiró. */
+    replacement;
+    reason;
+    /** Sólo `unknown`: el token válido más parecido. */
+    suggestion;
+    valid;
+    constructor(message, details) {
+        super(message);
+        this.name = 'PlatformTokenError';
+        this.kind = details.kind;
+        this.token = details.token;
+        this.origin = details.origin;
+        this.replacement = details.replacement;
+        this.reason = details.reason;
+        this.suggestion = details.suggestion;
+        this.valid = details.valid;
+    }
+}
+exports.PlatformTokenError = PlatformTokenError;
 /**
  * Convierte el sufijo de un archivo de variante en tags clasificados.
  *
@@ -40,17 +72,17 @@ function parseVariantSuffix(suffix, registry, origin) {
  * desconocido con la lista de válidos y la sugerencia más cercana.
  */
 function unknownToken(token, registry, origin) {
+    const valid = allTokens(registry);
     const retired = registry.retired(token);
     if (retired) {
-        return new Error(`[ress] El token de plataforma "${token}"${where(origin)} ya no existe. ` +
+        return new PlatformTokenError(`[ress] El token de plataforma "${token}"${where(origin)} ya no existe. ` +
             `Usá ${retired.replacement}.\n` +
-            `Se retiró porque ${retired.reason}.`);
+            `Se retiró porque ${retired.reason}.`, { kind: 'retired', token, origin, replacement: retired.replacement, reason: retired.reason, valid });
     }
-    const valid = allTokens(registry);
     const suggestion = closest(token, valid);
-    return new Error(`[ress] Token de plataforma desconocido: "${token}"${where(origin)}.` +
+    return new PlatformTokenError(`[ress] Token de plataforma desconocido: "${token}"${where(origin)}.` +
         (suggestion ? ` ¿Quisiste decir "${suggestion}"?` : '') +
-        `\nTokens válidos: ${valid.join(', ')}.`);
+        `\nTokens válidos: ${valid.join(', ')}.`, { kind: 'unknown', token, origin, suggestion, valid });
 }
 const where = (origin) => (origin ? ` en "${origin}"` : '');
 function allTokens(registry) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ressjs/platform",
-  "version": "0.6.0-rc.0",
+  "version": "0.6.0-rc.1",
   "description": "Modelo de plataforma de ress.js: registro de tokens y detección del cliente. Sin dependencias.",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",