vastlint 0.2.6 → 0.3.1

package/index.cjs

@@ -13,6 +13,8 @@ module.exports = {
   validate: wasm.validate,
   validateWithOptions: wasm.validateWithOptions,
   rules: wasm.rules,
+  fix: wasm.fix,
+  fixWithOptions: wasm.fixWithOptions,
   validateFiltered(xml, minSeverity = 'error') {
     const order = { error: 2, warning: 1, info: 0 };
     const min = order[minSeverity] ?? 0;

package/index.d.ts

@@ -89,3 +89,41 @@ export declare function validateFiltered(
  * Returns the full catalog of all known validation rules.
  */
 export declare function rules(): RuleMeta[];
+
+/** A single fix that was automatically applied to the document. */
+export interface AppliedFix {
+  /** The rule ID this fix addresses, e.g. `"VAST-2.0-mediafile-https"`. */
+  rule_id: string;
+  /** Human-readable description of what was changed. */
+  description: string;
+  /** XPath-like path to the element that was modified. */
+  path: string;
+}
+
+export interface FixResult {
+  /** The repaired VAST XML string. */
+  xml: string;
+  /** All fixes that were successfully applied, in document order. */
+  applied: AppliedFix[];
+  /** Issues that remain after all fixes were applied (require manual intervention). */
+  remaining: Issue[];
+}
+
+/**
+ * Fix a VAST XML string using default settings.
+ * Upgrades http:// URLs to https:// and removes deprecated attributes.
+ *
+ * @example
+ * import { fix } from 'vastlint';
+ * const result = fix(xml);
+ * console.log(result.xml);           // repaired XML
+ * console.log(result.applied);       // what was changed
+ * console.log(result.remaining);     // issues that need manual attention
+ */
+export declare function fix(xml: string): FixResult;
+
+/**
+ * Fix a VAST XML string with caller-supplied options.
+ * Accepts the same options object as `validateWithOptions`.
+ */
+export declare function fixWithOptions(xml: string, options: ValidateOptions): FixResult;

package/index.js

@@ -17,7 +17,7 @@
 // wasm-pack generates vastlint_wasm.js (ESM glue) and vastlint_wasm_bg.wasm.
 // assemble.js copies both to the package root during the build.
 import * as _wasm from './vastlint_wasm.js';
-export const { validate, validateWithOptions, rules } = _wasm;
+export const { validate, validateWithOptions, rules, fix, fixWithOptions } = _wasm;
 
 /**
  * Validate a VAST XML string and return only issues at or above a minimum severity.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vastlint",
-  "version": "0.2.6",
+  "version": "0.3.1",
   "description": "VAST XML validator — checks ad tags against IAB VAST 2.0 through 4.3",
   "license": "Apache-2.0",
   "author": "Alex Sekowski <alex@vastlint.org>",

package/vastlint_wasm.d.ts

@@ -1,6 +1,39 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * Fix common VAST issues and return the repaired XML alongside a report.
+ *
+ * Returns a plain JavaScript object shaped like:
+ * ```ts
+ * {
+ *   xml: string,           // repaired VAST XML
+ *   applied: Array<{
+ *     rule_id: string,
+ *     description: string,
+ *     path: string,
+ *   }>,
+ *   remaining: Array<{    // issues that could not be auto-fixed
+ *     id: string,
+ *     severity: "error" | "warning" | "info",
+ *     message: string,
+ *     path: string | null,
+ *     spec_ref: string,
+ *     line: number | null,
+ *     col: number | null,
+ *   }>,
+ * }
+ * ```
+ */
+export function fix(xml: string): any;
+
+/**
+ * Fix a VAST XML string with caller-supplied options.
+ *
+ * Accepts the same `options` object as `validateWithOptions`.
+ */
+export function fixWithOptions(xml: string, options: any): any;
+
 /**
  * Returns the full rule catalog as a JS array.
  *

package/vastlint_wasm.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./vastlint_wasm_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    rules, validate, validateWithOptions
+    fix, fixWithOptions, rules, validate, validateWithOptions
 } from "./vastlint_wasm_bg.js";

package/vastlint_wasm_bg.js

@@ -1,3 +1,57 @@
+/**
+ * Fix common VAST issues and return the repaired XML alongside a report.
+ *
+ * Returns a plain JavaScript object shaped like:
+ * ```ts
+ * {
+ *   xml: string,           // repaired VAST XML
+ *   applied: Array<{
+ *     rule_id: string,
+ *     description: string,
+ *     path: string,
+ *   }>,
+ *   remaining: Array<{    // issues that could not be auto-fixed
+ *     id: string,
+ *     severity: "error" | "warning" | "info",
+ *     message: string,
+ *     path: string | null,
+ *     spec_ref: string,
+ *     line: number | null,
+ *     col: number | null,
+ *   }>,
+ * }
+ * ```
+ * @param {string} xml
+ * @returns {any}
+ */
+export function fix(xml) {
+    const ptr0 = passStringToWasm0(xml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.fix(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Fix a VAST XML string with caller-supplied options.
+ *
+ * Accepts the same `options` object as `validateWithOptions`.
+ * @param {string} xml
+ * @param {any} options
+ * @returns {any}
+ */
+export function fixWithOptions(xml, options) {
+    const ptr0 = passStringToWasm0(xml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.fixWithOptions(ptr0, len0, options);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Returns the full rule catalog as a JS array.
  *

package/vastlint_wasm_bg.wasm.d.ts

@@ -1,6 +1,8 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const fix: (a: number, b: number) => [number, number, number];
+export const fixWithOptions: (a: number, b: number, c: any) => [number, number, number];
 export const rules: () => [number, number, number];
 export const validate: (a: number, b: number) => [number, number, number];
 export const validateWithOptions: (a: number, b: number, c: any) => [number, number, number];

package/vastlint_wasm_cjs.js

@@ -1,5 +1,61 @@
 /* @ts-self-types="./vastlint_wasm.d.ts" */
 
+/**
+ * Fix common VAST issues and return the repaired XML alongside a report.
+ *
+ * Returns a plain JavaScript object shaped like:
+ * ```ts
+ * {
+ *   xml: string,           // repaired VAST XML
+ *   applied: Array<{
+ *     rule_id: string,
+ *     description: string,
+ *     path: string,
+ *   }>,
+ *   remaining: Array<{    // issues that could not be auto-fixed
+ *     id: string,
+ *     severity: "error" | "warning" | "info",
+ *     message: string,
+ *     path: string | null,
+ *     spec_ref: string,
+ *     line: number | null,
+ *     col: number | null,
+ *   }>,
+ * }
+ * ```
+ * @param {string} xml
+ * @returns {any}
+ */
+function fix(xml) {
+    const ptr0 = passStringToWasm0(xml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.fix(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+exports.fix = fix;
+
+/**
+ * Fix a VAST XML string with caller-supplied options.
+ *
+ * Accepts the same `options` object as `validateWithOptions`.
+ * @param {string} xml
+ * @param {any} options
+ * @returns {any}
+ */
+function fixWithOptions(xml, options) {
+    const ptr0 = passStringToWasm0(xml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.fixWithOptions(ptr0, len0, options);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+exports.fixWithOptions = fixWithOptions;
+
 /**
  * Returns the full rule catalog as a JS array.
  *