pixellint 0.27.0 → 0.29.0

package/README.md

@@ -10,7 +10,7 @@ npm install pixellint
 ```
 
 ```js
-import { validate, isOk } from "pixellint";
+import { validate, isOk, validateMany } from "pixellint";
 
 const pixel = validate("https://www.facebook.com/tr?ev=Purchase");
 isOk(pixel); // false: missing Pixel ID
@@ -22,6 +22,12 @@ const capi = validate(
   { kind: "json" },
 );
 isOk(capi); // false: event_time is milliseconds, Meta wants seconds
+
+const document = validateMany([
+  "https://example.com/pixel?id=1#frag",
+  "https://example.com/pixel?id=1#frag",
+]);
+document.summary.unique_artifacts; // 1
 ```
 
 Every finding carries a stable `code`, a `severity`, a `fix_hint`, the byte
@@ -41,7 +47,7 @@ finding.targets[0];       // { component: "whole_url", start: 0, end: 46, ... }
 - URL conformance, transport, credentials, fragments, and ad-tech macro handling
 - IAB consent signals: TCF `gdpr` and `gdpr_consent`, the deprecated US Privacy
   string, and GPP `gpp` and `gpp_sid`
-- Vendor parameter contracts for 128 endpoint families, including Meta
+- Vendor parameter contracts for 129 endpoint families, including Meta
   Conversions API, TikTok Events API, Reddit CAPI, and the browser pixels
 - Endpoint attribution for 119 vendor rows, so an unrecognized pixel still gets a name.
 
@@ -50,6 +56,7 @@ finding.targets[0];       // { component: "whole_url", start: 0, end: 46, ... }
 | Function | Returns |
 | --- | --- |
 | `validate(artifact, options?)` | The full validation summary |
+| `validateMany(document)` | Document report for extracted artifacts |
 | `isOk(summary)` | `false` when any error-severity finding is present |
 | `rulepacks()` | Every rulepack with its evidence level |
 | `vendors()` | The vendor endpoint directory |

package/index.cjs

@@ -10,6 +10,10 @@ function validate(artifact, options = {}) {
   return wasm.validate(kind, artifact, state, vendor);
 }
 
+function validateMany(document) {
+  return wasm.validate_many(JSON.stringify(document));
+}
+
 function isOk(summary) {
   return summary.reports.every((report) =>
     report.violations.every((violation) => violation.severity !== "error"),
@@ -18,6 +22,7 @@ function isOk(summary) {
 
 module.exports = {
   validate,
+  validateMany,
   isOk,
   rulepacks: () => wasm.rulepacks(),
   vendors: () => wasm.vendors(),

package/index.d.ts

@@ -83,6 +83,45 @@ export interface ValidateOptions {
 /** Validate a measurement artifact against every applicable rulepack. */
 export function validate(artifact: string, options?: ValidateOptions): ValidationSummary;
 
+export interface FindingCounts {
+  artifacts_total?: number;
+  unique_artifacts?: number;
+  errors: number;
+  warnings: number;
+  infos: number;
+}
+
+export interface ArtifactOccurrence {
+  occurrence_id?: string | null;
+  source_kind?: string | null;
+  path?: string | null;
+  line?: number | null;
+  column?: number | null;
+  context_label?: string | null;
+}
+
+export interface AggregatedArtifact {
+  artifact_id: string;
+  dedupe_key: string;
+  artifact_kind: ArtifactKind;
+  raw_artifact: string;
+  normalized_artifact: string;
+  ok: boolean;
+  summary: FindingCounts;
+  reports: ValidationReport[];
+  occurrences: ArtifactOccurrence[];
+}
+
+export interface DocumentReport {
+  document_kind: string;
+  extractor?: { id: string; version?: string | null };
+  summary: FindingCounts;
+  artifacts: AggregatedArtifact[];
+}
+
+/** Validate extracted artifacts as one document. The caller already extracted URLs. */
+export function validateMany(document: object | string[]): DocumentReport;
+
 /** True when no error-severity finding is present. */
 export function isOk(summary: ValidationSummary): boolean;
 

package/index.mjs

@@ -22,6 +22,14 @@ export function validate(artifact, options = {}) {
   return wasm.validate(kind, artifact, state, vendor);
 }
 
+/**
+ * Validate extracted artifacts as one document.
+ * @param {object|Array} document - MULTI_ARTIFACT_SCHEMA object, or an array of URL strings.
+ */
+export function validateMany(document) {
+  return wasm.validate_many(JSON.stringify(document));
+}
+
 /** Rulepacks this build ships, with their evidence levels. */
 export function rulepacks() {
   return wasm.rulepacks();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixellint",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Validator for pixels, postbacks, conversion API payloads, and tracking URLs: Meta CAPI, Facebook pixel, GTM, and vendor rulepacks",
   "license": "Apache-2.0",
   "author": "Aleks <aleks@vastlint.org>",

package/wasm/pixellint.d.ts

@@ -12,6 +12,12 @@ export function rulepacks(): any;
  */
 export function validate(artifact_kind: string, artifact: string, expansion_state?: string | null, claimed_vendor?: string | null): any;
 
+/**
+ * Validates extracted artifacts as one document. The caller already pulled
+ * tracking URLs out. A JSON array of URL strings is a list of `url` artifacts.
+ */
+export function validate_many(document_json: string): any;
+
 /**
  * Validates a URL artifact with default options, the common case.
  */

package/wasm/pixellint.js

@@ -39,6 +39,23 @@ function validate(artifact_kind, artifact, expansion_state, claimed_vendor) {
 }
 exports.validate = validate;
 
+/**
+ * Validates extracted artifacts as one document. The caller already pulled
+ * tracking URLs out. A JSON array of URL strings is a list of `url` artifacts.
+ * @param {string} document_json
+ * @returns {any}
+ */
+function validate_many(document_json) {
+    const ptr0 = passStringToWasm0(document_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.validate_many(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+exports.validate_many = validate_many;
+
 /**
  * Validates a URL artifact with default options, the common case.
  * @param {string} artifact

package/wasm/pixellint_bg.wasm.d.ts

@@ -3,6 +3,7 @@
 export const memory: WebAssembly.Memory;
 export const rulepacks: () => [number, number, number];
 export const validate: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number];
+export const validate_many: (a: number, b: number) => [number, number, number];
 export const validate_url: (a: number, b: number) => [number, number, number];
 export const vendor_for_host: (a: number, b: number) => [number, number, number];
 export const vendors: () => [number, number, number];