Skip to content
This repository has been archived by the owner on May 3, 2023. It is now read-only.

littlespex/cmcd.js

Repository files navigation

Warning This repository has been archived. Please use @svta.org/common-media-library.

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,
  CmcdHeader,
  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=200,bs,cid="9f7f349b-baba-43d7-bbe7-b0dc8a65af0d",mtp=10000,ot=m,sf=d,st=v'
*/

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

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

/**
 * Custom Fields 
 */

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

console.log(toQuery(data));
/*
'CMCD=br=200,bs,cid="9f7f349b-baba-43d7-bbe7-b0dc8a65af0d",com.example-a="hello",com.example-b=1234,com.example-c,com.example-d=s,mtp=10000,ot=m,sf=d,st=v'
*/

/**
 * Custom fields can be mapped to specific headers by providing a mapping 
 * object to the `toHeader` function. Unmapped custom fields are added to 
 * the CMCD-Request header.
 */
const headerMap = {
  ['com.example-a']: CmcdHeader.Object,
  ['com.example-b']: CmcdHeader.Session,
  ['com.example-c']: CmcdHeader.Status,
};

console.log(toHeaders(data, headerMap));
/*
{
  'CMCD-Object': 'br=200,com.example-a="hello",ot=m',
  'CMCD-Request': 'com.example-d=s,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

About

CMCD (Common Media Client Data) Typescript definitions.

Resources

License

Stars

Watchers

Forks

Packages

No packages published