Depend on win-guid for Windows GUID conversion

lib/asf/AsfGuid.ts

@@ -0,0 +1,124 @@
+import { parseWindowsGuid, Guid } from 'win-guid';
+
+/**
+ * Ref:
+ * - https://tools.ietf.org/html/draft-fleischman-asf-01, Appendix A: ASF GUIDs
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/index.html
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ *
+ * ASF File Structure:
+ * - https://msdn.microsoft.com/en-us/library/windows/desktop/ee663575(v=vs.85).aspx
+ *
+ * ASF GUIDs:
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ * - https://github.com/dji-sdk/FFmpeg/blob/master/libavformat/asf.c
+ */
+export default class AsfGuid {
+
+  // 10.1 Top-level ASF object GUIDs
+  public static HeaderObject = new AsfGuid("75B22630-668E-11CF-A6D9-00AA0062CE6C");
+  public static DataObject = new AsfGuid("75B22636-668E-11CF-A6D9-00AA0062CE6C");
+  public static SimpleIndexObject = new AsfGuid("33000890-E5B1-11CF-89F4-00A0C90349CB");
+  public static IndexObject = new AsfGuid("D6E229D3-35DA-11D1-9034-00A0C90349BE");
+  public static MediaObjectIndexObject = new AsfGuid("FEB103F8-12AD-4C64-840F-2A1D2F7AD48C");
+  public static TimecodeIndexObject = new AsfGuid("3CB73FD0-0C4A-4803-953D-EDF7B6228F0C");
+
+  // 10.2 Header Object GUIDs
+  public static FilePropertiesObject = new AsfGuid("8CABDCA1-A947-11CF-8EE4-00C00C205365");
+  public static StreamPropertiesObject = new AsfGuid("B7DC0791-A9B7-11CF-8EE6-00C00C205365");
+  public static HeaderExtensionObject = new AsfGuid("5FBF03B5-A92E-11CF-8EE3-00C00C205365");
+  public static CodecListObject = new AsfGuid("86D15240-311D-11D0-A3A4-00A0C90348F6");
+  public static ScriptCommandObject = new AsfGuid("1EFB1A30-0B62-11D0-A39B-00A0C90348F6");
+  public static MarkerObject = new AsfGuid("F487CD01-A951-11CF-8EE6-00C00C205365");
+  public static BitrateMutualExclusionObject = new AsfGuid("D6E229DC-35DA-11D1-9034-00A0C90349BE");
+  public static ErrorCorrectionObject = new AsfGuid("75B22635-668E-11CF-A6D9-00AA0062CE6C");
+  public static ContentDescriptionObject = new AsfGuid("75B22633-668E-11CF-A6D9-00AA0062CE6C");
+  public static ExtendedContentDescriptionObject = new AsfGuid("D2D0A440-E307-11D2-97F0-00A0C95EA850");
+  public static ContentBrandingObject = new AsfGuid("2211B3FA-BD23-11D2-B4B7-00A0C955FC6E");
+  public static StreamBitratePropertiesObject = new AsfGuid("7BF875CE-468D-11D1-8D82-006097C9A2B2");
+  public static ContentEncryptionObject = new AsfGuid("2211B3FB-BD23-11D2-B4B7-00A0C955FC6E");
+  public static ExtendedContentEncryptionObject = new AsfGuid("298AE614-2622-4C17-B935-DAE07EE9289C");
+  public static DigitalSignatureObject = new AsfGuid("2211B3FC-BD23-11D2-B4B7-00A0C955FC6E");
+  public static PaddingObject = new AsfGuid("1806D474-CADF-4509-A4BA-9AABCB96AAE8");
+
+  // 10.3 Header Extension Object GUIDs
+  public static ExtendedStreamPropertiesObject = new AsfGuid("14E6A5CB-C672-4332-8399-A96952065B5A");
+  public static AdvancedMutualExclusionObject = new AsfGuid("A08649CF-4775-4670-8A16-6E35357566CD");
+  public static GroupMutualExclusionObject = new AsfGuid("D1465A40-5A79-4338-B71B-E36B8FD6C249");
+  public static StreamPrioritizationObject = new AsfGuid("D4FED15B-88D3-454F-81F0-ED5C45999E24");
+  public static BandwidthSharingObject = new AsfGuid("A69609E6-517B-11D2-B6AF-00C04FD908E9");
+  public static LanguageListObject = new AsfGuid("7C4346A9-EFE0-4BFC-B229-393EDE415C85");
+  public static MetadataObject = new AsfGuid("C5F8CBEA-5BAF-4877-8467-AA8C44FA4CCA");
+  public static MetadataLibraryObject = new AsfGuid("44231C94-9498-49D1-A141-1D134E457054");
+  public static IndexParametersObject = new AsfGuid("D6E229DF-35DA-11D1-9034-00A0C90349BE");
+  public static MediaObjectIndexParametersObject = new AsfGuid("6B203BAD-3F11-48E4-ACA8-D7613DE2CFA7");
+  public static TimecodeIndexParametersObject = new AsfGuid("F55E496D-9797-4B5D-8C8B-604DFE9BFB24");
+  public static CompatibilityObject = new AsfGuid("26F18B5D-4584-47EC-9F5F-0E651F0452C9");
+  public static AdvancedContentEncryptionObject = new AsfGuid("43058533-6981-49E6-9B74-AD12CB86D58C");
+
+  // 10.4 Stream Properties Object Stream Type GUIDs
+  public static AudioMedia = new AsfGuid("F8699E40-5B4D-11CF-A8FD-00805F5C442B");
+  public static VideoMedia = new AsfGuid("BC19EFC0-5B4D-11CF-A8FD-00805F5C442B");
+  public static CommandMedia = new AsfGuid("59DACFC0-59E6-11D0-A3AC-00A0C90348F6");
+  public static JFIF_Media = new AsfGuid("B61BE100-5B4E-11CF-A8FD-00805F5C442B");
+  public static Degradable_JPEG_Media = new AsfGuid("35907DE0-E415-11CF-A917-00805F5C442B");
+  public static FileTransferMedia = new AsfGuid("91BD222C-F21C-497A-8B6D-5AA86BFC0185");
+  public static BinaryMedia = new AsfGuid("3AFB65E2-47EF-40F2-AC2C-70A90D71D343");
+
+  public static ASF_Index_Placeholder_Object  = new AsfGuid("D9AADE20-7C17-4F9C-BC28-8555DD98E2A2");
+
+  public static fromBin(bin: Uint8Array, offset = 0) {
+    return new AsfGuid(AsfGuid.decode(bin, offset));
+  }
+
+  /**
+   * Decode GUID in format like "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
+   * @param objectId Binary GUID
+   * @param offset Read offset in bytes, default 0
+   * @returns GUID as dashed hexadecimal representation
+   */
+  public static decode(objectId: Uint8Array, offset = 0): string {
+    return new Guid(objectId.subarray(offset, offset + 16)).toString();
+  }
+
+  /**
+   * Decode stream type
+   * @param mediaType Media type GUID
+   * @returns Media type
+   */
+  public static decodeMediaType(mediaType: AsfGuid): 'audio' | 'video' | 'command' | 'degradable-jpeg' | 'file-transfer' | 'binary' | undefined {
+    switch (mediaType.str) {
+      case AsfGuid.AudioMedia.str: return 'audio';
+      case AsfGuid.VideoMedia.str: return 'video';
+      case AsfGuid.CommandMedia.str: return 'command';
+      case AsfGuid.Degradable_JPEG_Media.str: return 'degradable-jpeg';
+      case AsfGuid.FileTransferMedia.str: return 'file-transfer';
+      case AsfGuid.BinaryMedia.str: return 'binary';
+    }
+  }
+
+  /**
+   * Encode GUID
+   * @param guid GUID like: "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
+   * @returns Encoded Binary GUID
+   */
+  public static encode(guid: string): Uint8Array {
+    return parseWindowsGuid(guid);
+  }
+
+  public str: string;
+
+  public constructor(str: string) {
+    this.str = str;
+  }
+
+  public equals(guid: AsfGuid) {
+    return this.str === guid.str;
+  }
+
+  public toBin(): Uint8Array {
+    return AsfGuid.encode(this.str);
+  }
+
+}

lib/asf/AsfObject.ts

@@ -5,7 +5,7 @@ import type { IGetToken, ITokenizer } from 'strtok3';
 
 import * as util from '../common/Util.js';
 import type { AnyTagValue, IPicture, ITag } from '../type.js';
-import GUID from './GUID.js';
+import AsfGuid from './AsfGuid.js';
 import { getParserForAttr, parseUnicodeAttr } from './AsfUtil.js';
 import { AttachedPictureType } from '../id3v2/ID3v2Token.js';
 import { makeUnexpectedFileContentError } from '../ParseError.js';
@@ -52,7 +52,7 @@ export interface IAsfObjectHeader {
   /**
    * A GUID that identifies the object. 128 bits
    */
-  objectId: GUID,
+  objectId: AsfGuid,
 
   /**
    * The size of the object (64-bits)
@@ -78,7 +78,7 @@ export const TopLevelHeaderObjectToken: IGetToken<IAsfTopLevelObjectHeader, Uint
 
   get: (buf, off): IAsfTopLevelObjectHeader => {
     return {
-      objectId: GUID.fromBin(buf, off),
+      objectId: AsfGuid.fromBin(buf, off),
       objectSize: Number(Token.UINT64_LE.get(buf, off + 16)),
       numberOfHeaderObjects: Token.UINT32_LE.get(buf, off + 24)
       // Reserved: 2 bytes
@@ -96,7 +96,7 @@ export const HeaderObjectToken: IGetToken<IAsfObjectHeader, Uint8Array> = {
 
   get: (buf, off): IAsfObjectHeader => {
     return {
-      objectId: GUID.fromBin(buf, off),
+      objectId: AsfGuid.fromBin(buf, off),
       objectSize: Number(Token.UINT64_LE.get(buf, off + 16))
     };
   }
@@ -145,7 +145,7 @@ export interface IFilePropertiesObject {
    * The value of this field shall be regenerated every time the file is modified in any way.
    * The value of this field shall be identical to the value of the File ID field of the Data Object.
    */
-  fileId: GUID,
+  fileId: AsfGuid,
 
   /**
    * Specifies the size, in bytes, of the entire file.
@@ -239,12 +239,12 @@ export interface IFilePropertiesObject {
  */
 export class FilePropertiesObject extends State<IFilePropertiesObject> {
 
-  public static guid = GUID.FilePropertiesObject;
+  public static guid = AsfGuid.FilePropertiesObject;
 
   public get(buf: Uint8Array, off: number): IFilePropertiesObject {
 
     return {
-      fileId: GUID.fromBin(buf, off),
+      fileId: AsfGuid.fromBin(buf, off),
       fileSize: Token.UINT64_LE.get(buf, off + 16),
       creationDate: Token.UINT64_LE.get(buf, off + 24),
       dataPacketsCount: Token.UINT64_LE.get(buf, off + 32),
@@ -276,7 +276,7 @@ export interface IStreamPropertiesObject {
   /**
    * Error Correction Type
    */
-  errorCorrectionType: GUID,
+  errorCorrectionType: AsfGuid,
 
 }
 
@@ -286,20 +286,20 @@ export interface IStreamPropertiesObject {
  */
 export class StreamPropertiesObject extends State<IStreamPropertiesObject> {
 
-  public static guid = GUID.StreamPropertiesObject;
+  public static guid = AsfGuid.StreamPropertiesObject;
 
   public get(buf: Uint8Array, off: number): IStreamPropertiesObject {
 
     return {
-      streamType: GUID.decodeMediaType(GUID.fromBin(buf, off)),
-      errorCorrectionType: GUID.fromBin(buf, off + 8)
+      streamType: AsfGuid.decodeMediaType(AsfGuid.fromBin(buf, off)),
+      errorCorrectionType: AsfGuid.fromBin(buf, off + 8)
       // ToDo
     };
   }
 }
 
 export interface IHeaderExtensionObject {
-  reserved1: GUID,
+  reserved1: AsfGuid,
   reserved2: number,
   extensionDataSize: number
 }
@@ -310,7 +310,7 @@ export interface IHeaderExtensionObject {
  */
 export class HeaderExtensionObject implements IGetToken<IHeaderExtensionObject> {
 
-  public static guid = GUID.HeaderExtensionObject;
+  public static guid = AsfGuid.HeaderExtensionObject;
 
   public len: number;
 
@@ -321,7 +321,7 @@ export class HeaderExtensionObject implements IGetToken<IHeaderExtensionObject>
   public get(buf: Uint8Array, off: number): IHeaderExtensionObject {
     const view = new DataView(buf.buffer, off);
     return {
-      reserved1: GUID.fromBin(buf, off),
+      reserved1: AsfGuid.fromBin(buf, off),
       reserved2: view.getUint16(16, true),
       extensionDataSize: view.getUint16(18, true)
     };
@@ -407,7 +407,7 @@ async function readCodecEntry(tokenizer: ITokenizer): Promise<ICodecEntry> {
  */
 export class ContentDescriptionObjectState extends State<ITag[]> {
 
-  public static guid = GUID.ContentDescriptionObject;
+  public static guid = AsfGuid.ContentDescriptionObject;
 
   private static contentDescTags = ['Title', 'Author', 'Copyright', 'Description', 'Rating'];
 
@@ -435,7 +435,7 @@ export class ContentDescriptionObjectState extends State<ITag[]> {
  */
 export class ExtendedContentDescriptionObjectState extends State<ITag[]> {
 
-  public static guid = GUID.ExtendedContentDescriptionObject;
+  public static guid = AsfGuid.ExtendedContentDescriptionObject;
 
   public get(buf: Uint8Array, off: number): ITag[] {
     const tags: ITag[] = [];
@@ -499,7 +499,7 @@ export interface IExtendedStreamPropertiesObject {
  */
 export class ExtendedStreamPropertiesObjectState extends State<IExtendedStreamPropertiesObject> {
 
-  public static guid = GUID.ExtendedStreamPropertiesObject;
+  public static guid = AsfGuid.ExtendedStreamPropertiesObject;
 
   public get(buf: Uint8Array, off: number): IExtendedStreamPropertiesObject {
     const view = new DataView(buf.buffer, off);
@@ -536,7 +536,7 @@ export class ExtendedStreamPropertiesObjectState extends State<IExtendedStreamPr
  */
 export class MetadataObjectState extends State<ITag[]> {
 
-  public static guid = GUID.MetadataObject;
+  public static guid = AsfGuid.MetadataObject;
 
   public get(uint8Array: Uint8Array, off: number): ITag[] {
     const tags: ITag[] = [];
@@ -566,7 +566,7 @@ export class MetadataObjectState extends State<ITag[]> {
 
 export class MetadataLibraryObjectState extends MetadataObjectState {
 
-  public static guid = GUID.MetadataLibraryObject;
+  public static guid = AsfGuid.MetadataLibraryObject;
 }
 
 export interface IWmPicture extends IPicture {

lib/asf/AsfParser.ts

@@ -1,7 +1,7 @@
 import initDebug from 'debug';
 
 import { type ITag, TrackType } from '../type.js';
-import GUID from './GUID.js';
+import AsfGuid from './AsfGuid.js';
 import * as AsfObject from './AsfObject.js';
 import { BasicParser } from '../common/BasicParser.js';
 import { AsfContentParseError } from './AsfObject.js';
@@ -24,7 +24,7 @@ export class AsfParser extends BasicParser {
 
   public async parse() {
     const header = await this.tokenizer.readToken<AsfObject.IAsfTopLevelObjectHeader>(AsfObject.TopLevelHeaderObjectToken);
-    if (!header.objectId.equals(GUID.HeaderObject)) {
+    if (!header.objectId.equals(AsfGuid.HeaderObject)) {
       throw new AsfContentParseError(`expected asf header; but was not found; got: ${header.objectId.str}`);
     }
     try {
@@ -72,7 +72,7 @@ export class AsfParser extends BasicParser {
           await this.addTags(tags);
           break;
 
-        case GUID.CodecListObject.str: {
+        case AsfGuid.CodecListObject.str: {
           const codecs = await AsfObject.readCodecEntries(this.tokenizer);
           codecs.forEach(codec => {
             this.metadata.addStreamInfo({
@@ -85,12 +85,12 @@ export class AsfParser extends BasicParser {
           break;
         }
 
-        case GUID.StreamBitratePropertiesObject.str:
+        case AsfGuid.StreamBitratePropertiesObject.str:
           // ToDo?
           await this.tokenizer.ignore(header.objectSize - AsfObject.HeaderObjectToken.len);
           break;
 
-        case GUID.PaddingObject.str:
+        case AsfGuid.PaddingObject.str:
           // ToDo: register bytes pad
           debug('Padding: %s bytes', header.objectSize - AsfObject.HeaderObjectToken.len);
           await this.tokenizer.ignore(header.objectSize - AsfObject.HeaderObjectToken.len);
@@ -134,16 +134,16 @@ export class AsfParser extends BasicParser {
           break;
         }
 
-        case GUID.PaddingObject.str:
+        case AsfGuid.PaddingObject.str:
           // ToDo: register bytes pad
           await this.tokenizer.ignore(remaining);
           break;
 
-        case GUID.CompatibilityObject.str:
+        case AsfGuid.CompatibilityObject.str:
           await this.tokenizer.ignore(remaining);
           break;
 
-        case GUID.ASF_Index_Placeholder_Object.str:
+        case AsfGuid.ASF_Index_Placeholder_Object.str:
           await this.tokenizer.ignore(remaining);
           break;