cmcd.js

cmcd.js

CMCD (Common Media Client Data) library with Typescript definitions.

Install

npm i cmcd.js

Usage

All CMCD properties are optional. Properties that with nullish values will not be serialized.

import {
  Cmcd,
  CmcdHeaader,
  CmcdObjectType,
  CmcdStreamingFormat,
  CmcdStreamType,
  toHeaders,
  toJson,
  toQuery
} from 'cmcd.js';

const data: Cmcd = {
  cid: '9f7f349b-baba-43d7-bbe7-b0dc8a65af0d',
  sf: CmcdStreamingFormat.DASH,
  st: CmcdStreamType.VOD,
  su: false,
  mtp: 10000,
  bs: true,
  br: 200,
  ot: CmcdObjectType.MANIFEST,
};

const query = toQuery(data);
console.log(query);
/* 
'CMCD=br%3D200%2Cbs%2Cmtp%3D10000%2Cot%3Dm%2Csf%3Dd%2Ccid%3D%229f7f349b-baba-43d7-bbe7-b0dc8a65af0d%22%2Cst%3Dv'
*/

const headers = toHeaders(data);
console.log(headers);
/*
{
  'CMCD-Object': 'br=200,ot=m',
  'CMCD-Request': 'mtp=10000',
  'CMCD-Session': 'sf=d,cid="9f7f349b-baba-43d7-bbe7-b0dc8a65af0d",st=v',
  'CMCD-Status': 'bs',
}
*/

const json = toJson(data);
console.log(json);
/*
'{"mtp":10000,"su":false,"br":200,"ot":"m","sf":"d","cid":"9f7f349b-baba-43d7-bbe7-b0dc8a65af0d","st":"v","bs":true}'
*/

/* Custom Fields */
data['com.example-a'] = 'hello';
data['com.example-b']: 1234;
data['com.example-c']: true;
data['com.example-d']: Symbol('s');

const headerMap = {
  ['com.example-a']: CmcdHeader.Object,
  ['com.example-b']: CmcdHeader.Session,
  ['com.example-c']: CmcdHeader.Status,
  // Unmapped custom fields are added to the CMCD-Request header
};

const headers = toHeaders(data, headerMap);
console.log(headers);
/*
{
  'CMCD-Object': 'br=200,com.example-a="hello",ot=m',
  'CMCD-Request': 'mtp=10000',
  'CMCD-Session': 'cid="9f7f349b-baba-43d7-bbe7-b0dc8a65af0d",com.example-b=1234,sf=d,st=v',
  'CMCD-Status': 'bs,com.example-c',
}
*/

API Docs

https://littlespex.github.io/cmcd.js/

References

• Spec: https://cdn.cta.tech/cta/media/media/resources/standards/pdfs/cta-5004-final.pdf
• Overview: https://www.youtube.com/watch?v=sWuQ3RZ6R5w&list=PLVztGGxiGfIhBmyFhixteZKJvWC3KlaSf&index=5