@imferno/wasm 3.0.2-fix-working-group-resolutions.b60b447 → 3.0.2-fix-napi-typescript-types.043fc9b

package/codes.d.ts

@@ -3,11 +3,6 @@ export declare const codes: {
   readonly ST429_9_2014: {
     readonly VolindexMissing: "ST429-9:2014:7/VolindexMissing";
     readonly MalformedXml: "ST429-9:2014:7/MalformedXml";
-    readonly PathNotRelative: "ST429-9:2014:A.2/PathNotRelative";
-    readonly PathCharacters: "ST429-9:2014:A.2/PathCharacters";
-    readonly PathTooLong: "ST429-9:2014:A.2/PathTooLong";
-    readonly PathTooManySegments: "ST429-9:2014:A.2/PathTooManySegments";
-    readonly PathDuplicate: "ST429-9:2014:A.2/PathDuplicate";
   };
   readonly ST377_1_2011: {
     readonly NotMxf: "ST377-1:2011:5/NotMxf";
@@ -17,7 +12,6 @@ export declare const codes: {
     readonly NonHeaderFirstPartition: "ST377-1:2011:6.4/NonHeaderFirstPartition";
     readonly HeaderPartitionOpen: "ST377-1:2011:8.3.3/HeaderPartitionOpen";
     readonly MissingHeaderMetadata: "ST377-1:2011:8.3.3/MissingHeaderMetadata";
-    readonly StructuralComponentDurationMissing: "ST377-1:2011:B.8/StructuralComponentDurationMissing";
   };
   readonly ST2067_2_2020: {
     readonly AssetMap: "ST2067-2:2020:7/AssetMap";
@@ -28,7 +22,6 @@ export declare const codes: {
     readonly FileNotFound: "ST2067-2:2020:8.3/FileNotFound";
     readonly ChecksumMismatch: "ST2067-2:2020:8.3/ChecksumMismatch";
     readonly UnresolvedUuid: "ST2067-2:2020:7/UnresolvedUuid";
-    readonly TrackFileNotInPackage: "ST2067-2:2020:7.1/TrackFileNotInPackage";
     readonly DuplicateUuid: "ST2067-2:2020:7/DuplicateUuid";
     readonly IoError: "IMF:General/IoError";
     readonly EssenceDescriptorList: "ST2067-2:2020:6.4.2/EssenceDescriptorList";
@@ -394,8 +387,6 @@ export declare const codes: {
     readonly J2CLayout: "ST2067-21:2026:7.5.2/J2CLayout";
     readonly J2KExtendedCapabilities: "ST2067-21:2026:7.5.1/J2KExtendedCapabilities";
     readonly JPEG2000SubDescriptor: "ST2067-21:2026:7.5.1/JPEG2000SubDescriptor";
-    readonly HTIRVParameterBMax: "ST2067-21:2026:H/HT-IRV-ParameterB-Max";
-    readonly HTIRVParameterBRecommended: "ST2067-21:2026:H/HT-IRV-ParameterB-Recommended";
     readonly J2K4KResolution: "ST2067-21:2026:7.2.5/J2K-4K-Resolution";
     readonly J2K2KResolution: "ST2067-21:2026:7.2.5/J2K-2K-Resolution";
     readonly J2KBCPResolution: "ST2067-21:2026:7.2.5/J2K-BCP-Resolution";
@@ -477,6 +468,5 @@ export declare const codes: {
     readonly ReadDirError: "IMFERNO:Package/ReadDirError";
     readonly DirEntryError: "IMFERNO:Package/DirEntryError";
     readonly PathTraversal: "IMFERNO:Package/PathTraversal";
-    readonly ApplicationProfileNotValidated: "IMFERNO:Package/ApplicationProfileNotValidated";
   }
 };

package/codes.js

@@ -3,11 +3,6 @@ export const codes = {
   ST429_9_2014: {
     VolindexMissing: "ST429-9:2014:7/VolindexMissing",
     MalformedXml: "ST429-9:2014:7/MalformedXml",
-    PathNotRelative: "ST429-9:2014:A.2/PathNotRelative",
-    PathCharacters: "ST429-9:2014:A.2/PathCharacters",
-    PathTooLong: "ST429-9:2014:A.2/PathTooLong",
-    PathTooManySegments: "ST429-9:2014:A.2/PathTooManySegments",
-    PathDuplicate: "ST429-9:2014:A.2/PathDuplicate",
   },
   ST377_1_2011: {
     NotMxf: "ST377-1:2011:5/NotMxf",
@@ -17,7 +12,6 @@ export const codes = {
     NonHeaderFirstPartition: "ST377-1:2011:6.4/NonHeaderFirstPartition",
     HeaderPartitionOpen: "ST377-1:2011:8.3.3/HeaderPartitionOpen",
     MissingHeaderMetadata: "ST377-1:2011:8.3.3/MissingHeaderMetadata",
-    StructuralComponentDurationMissing: "ST377-1:2011:B.8/StructuralComponentDurationMissing",
   },
   ST2067_2_2020: {
     AssetMap: "ST2067-2:2020:7/AssetMap",
@@ -28,7 +22,6 @@ export const codes = {
     FileNotFound: "ST2067-2:2020:8.3/FileNotFound",
     ChecksumMismatch: "ST2067-2:2020:8.3/ChecksumMismatch",
     UnresolvedUuid: "ST2067-2:2020:7/UnresolvedUuid",
-    TrackFileNotInPackage: "ST2067-2:2020:7.1/TrackFileNotInPackage",
     DuplicateUuid: "ST2067-2:2020:7/DuplicateUuid",
     IoError: "IMF:General/IoError",
     EssenceDescriptorList: "ST2067-2:2020:6.4.2/EssenceDescriptorList",
@@ -394,8 +387,6 @@ export const codes = {
     J2CLayout: "ST2067-21:2026:7.5.2/J2CLayout",
     J2KExtendedCapabilities: "ST2067-21:2026:7.5.1/J2KExtendedCapabilities",
     JPEG2000SubDescriptor: "ST2067-21:2026:7.5.1/JPEG2000SubDescriptor",
-    HTIRVParameterBMax: "ST2067-21:2026:H/HT-IRV-ParameterB-Max",
-    HTIRVParameterBRecommended: "ST2067-21:2026:H/HT-IRV-ParameterB-Recommended",
     J2K4KResolution: "ST2067-21:2026:7.2.5/J2K-4K-Resolution",
     J2K2KResolution: "ST2067-21:2026:7.2.5/J2K-2K-Resolution",
     J2KBCPResolution: "ST2067-21:2026:7.2.5/J2K-BCP-Resolution",
@@ -477,6 +468,5 @@ export const codes = {
     ReadDirError: "IMFERNO:Package/ReadDirError",
     DirEntryError: "IMFERNO:Package/DirEntryError",
     PathTraversal: "IMFERNO:Package/PathTraversal",
-    ApplicationProfileNotValidated: "IMFERNO:Package/ApplicationProfileNotValidated",
   }
 };

package/imferno_wasm.d.ts

@@ -237,10 +237,6 @@ export interface J2CLayout {
     RGBAComponent?: RGBALayoutComponent[];
 }
 
-export interface J2KCcapi {
-    UInt16?: number[];
-}
-
 export interface J2KComponentSizing {
     Ssiz?: number | null;
     XRSiz?: number | null;
@@ -249,7 +245,6 @@ export interface J2KComponentSizing {
 
 export interface J2KExtendedCapabilities {
     Pcap?: number | null;
-    Ccapi?: J2KCcapi | null;
 }
 
 export interface JPEG2000SubDescriptor {

package/index.d.ts

@@ -1,59 +1,49 @@
 /**
- * Auto-initializing IMF Parser TypeScript Definitions
+ * Auto-initializing imferno WASM bindings.
  *
- * All functions automatically handle WASM initialization.
+ * Every function initialises the WASM module on first use, so all of them
+ * return Promises. Value types (`ValidationResult`, `Imferno`, `ImfReport`,
+ * `ValidateOptions`, ...) live in ./types.d.ts, generated from the Rust types
+ * by `cargo xtask generate-types-ts` and shared verbatim with @imferno/node.
  */
 
-/** Parse ASSETMAP.xml content */
-export function parseAssetmapTyped(xmlContent: string): Promise<any>;
+import type { ImfReport, Imferno, ValidateOptions, ValidationResult } from './types.js';
 
-/** Parse CPL XML content */
-export function parseCplTyped(xmlContent: string): Promise<any>;
+export * from './types.js';
 
-/** Parse PKL XML content */
-export function parsePklTyped(xmlContent: string): Promise<any>;
-
-/** Parse VOLINDEX.xml content */
-export function parseVolindexTyped(xmlContent: string): Promise<any>;
-
-/** Options for the validate function */
-export interface ValidateOptions {
-    /** Core constraints spec version: "auto" | "v2013" | "v2016" | "v2020" */
-    coreSpec?: "auto" | "v2013" | "v2016" | "v2020";
-    /** Application profile version: "auto" | "none" | "v2014" | "v2016" | "v2020" | "v2023" | "v2026" */
-    app2eSpec?: "auto" | "none" | "v2014" | "v2016" | "v2020" | "v2023" | "v2026";
-    /** ESLint-style rules configuration */
-    rules?: Record<string, string>;
-}
+/**
+ * Parse and validate an IMF package. This is the recommended entry point.
+ *
+ * Parse failures are reported as findings in `validation`, not thrown.
+ * @param files Object mapping filenames to XML string content
+ * @param options Optional validation options (spec selection, rules)
+ * @returns `{ package, validation }` — the full parsed package and all findings.
+ */
+export function validate(
+    files: Record<string, string>,
+    options?: ValidateOptions | null,
+): Promise<ValidationResult>;
 
-/** Result returned by the validate function */
-export interface ValidateResult {
-    /** Validation report with issues, compliance status, and profile */
-    report: any;
-    /** Parsed Composition Playlists */
-    cpls: any[];
-    /** Parsed AssetMap (null if parsing failed) */
-    assetMap: any | null;
-    /** Parsed Packing Lists */
-    packingLists: any[];
-    /** Parsed Volume Index (null if parsing failed) */
-    volumeIndex: any | null;
-    /** Assets in the AssetMap with no CPL or SCM reference */
-    unreferencedAssets: { id: string; path: string }[];
-    /** Sidecar assets declared in SCMs */
-    declaredSidecars: { id: string; cplIds: string[] }[];
-}
+/**
+ * Parse an IMF package without validating it.
+ * @param files Object mapping filenames to XML string content
+ * @returns The full parsed package. Rejects if the package cannot be parsed.
+ */
+export function parsePackage(files: Record<string, string>): Promise<Imferno>;
 
 /**
- * Validate a full IMF package and return both validation report and parsed data.
+ * Legacy: validate and return the lossy `ImfReport` summary. Prefer `validate`.
  * @param files Object mapping filenames to XML string content
  * @param options Optional validation options (spec selection, rules)
- * @returns Validation report + parsed package data
+ * @returns Rejects if the package cannot be parsed.
  */
-export function validate(
+export function buildReport(
     files: Record<string, string>,
-    options?: ValidateOptions,
-): Promise<ValidateResult>;
+    options?: ValidateOptions | null,
+): Promise<ImfReport>;
+
+/** Pretty-print an `ImfReport` as a human-readable string. */
+export function formatReport(report: ImfReport): Promise<string>;
 
 /** Get the library version */
 export function getVersion(): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imferno/wasm",
-  "version": "3.0.2-fix-working-group-resolutions.b60b447",
+  "version": "3.0.2-fix-napi-typescript-types.043fc9b",
   "description": "Fast, type-safe SMPTE ST 2067 IMF parser for JavaScript and TypeScript",
   "main": "index.js",
   "types": "index.d.ts",
@@ -14,6 +14,7 @@
     "codes.d.ts",
     "index.js",
     "index.d.ts",
+    "types.d.ts",
     "README.md",
     "LICENSE"
   ],
@@ -58,6 +59,8 @@
   },
   "devDependencies": {
     "ajv": "^8.18.0",
+    "ts-json-schema-generator": "2.9.0",
+    "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   }
 }