From 062d982faf979c90f8dfa7ef1573076c0e981bd0 Mon Sep 17 00:00:00 2001 From: Casey Occhialini <1508707+littlespex@users.noreply.github.com> Date: Sun, 7 Nov 2021 01:44:55 -0500 Subject: [PATCH] Doc update (#24) --- README.md | 37 +++++++++++++++++++------------------ package-lock.json | 4 ++-- package.json | 4 ++-- 3 files changed, 23 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index c4ed3e3..686a337 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ npm i cmcd.js ``` ## Usage -The top level `Cmcd` object contains references to all the CMCD data properties. Properties that are not filled out, or have `null` or `undefined` values, will not be serialized. +All CMCD properties are optional. Properties that are with nullish values will not be serialized. ```typescript import { @@ -18,22 +18,23 @@ import { toHeaders, toJson, toQuery -} from 'cmcd-ts'; - -const data = new Cmcd(); -data.sid = '9f7f349b-baba-43d7-bbe7-b0dc8a65af0d'; -data.sf = CmcdStreamingFormat.DASH; -data.st = CmcdStreamType.VOD; -data.su = false; -data.mtp = 10000; -data.bs = true; -data.br = 200; -data.ot = CmcdObjectType.MANIFEST; +} 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%2Csid%3D%229f7f349b-baba-43d7-bbe7-b0dc8a65af0d%22%2Cst%3Dv' +'CMCD=br%3D200%2Cbs%2Cmtp%3D10000%2Cot%3Dm%2Csf%3Dd%2Ccid%3D%229f7f349b-baba-43d7-bbe7-b0dc8a65af0d%22%2Cst%3Dv' */ const headers = toHeaders(data); @@ -42,7 +43,7 @@ console.log(headers); { 'cmcd-request': 'mtp=10000', 'cmcd-object': 'br=200,ot=m', - 'cmcd-session': 'sf=d,sid="9f7f349b-baba-43d7-bbe7-b0dc8a65af0d",st=v', + 'cmcd-session': 'sf=d,cid="9f7f349b-baba-43d7-bbe7-b0dc8a65af0d",st=v', 'cmcd-status': 'bs', } */ @@ -50,13 +51,13 @@ console.log(headers); const json = toJson(data); console.log(json); /* -'{"mtp":10000,"su":false,"br":200,"ot":"m","sf":"d","sid":"9f7f349b-baba-43d7-bbe7-b0dc8a65af0d","st":"v","bs":true}' +'{"mtp":10000,"su":false,"br":200,"ot":"m","sf":"d","cid":"9f7f349b-baba-43d7-bbe7-b0dc8a65af0d","st":"v","bs":true}' */ ``` +## 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 - -## Docs -https://littlespex.github.io/cmcd.js/ diff --git a/package-lock.json b/package-lock.json index 44eb5d0..f928b47 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "cmcd.js", - "version": "0.5.0", + "version": "0.5.1", "lockfileVersion": 2, "requires": true, "packages": { "": { "name": "cmcd.js", - "version": "0.5.0", + "version": "0.5.1", "license": "ISC", "devDependencies": { "@types/jest": "27.0.2", diff --git a/package.json b/package.json index 253fe8d..7041357 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "cmcd.js", - "version": "0.5.0", - "description": "CMCD (Common Media Client Data) Library with Typescript definitions", + "version": "0.5.1", + "description": "CMCD (Common Media Client Data) library with Typescript definitions", "main": "dist/cmcd.min.js", "types": "dist/types/index.d.ts", "type": "module",