plist 4.0.0 → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +176 -111
- package/dist/build-binary.d.ts +6 -0
- package/dist/build-binary.d.ts.map +1 -0
- package/dist/build-binary.js +284 -0
- package/dist/build-binary.js.map +1 -0
- package/dist/build.browser.d.ts +16 -0
- package/dist/build.browser.d.ts.map +1 -0
- package/dist/build.browser.js +101 -0
- package/dist/build.browser.js.map +1 -0
- package/dist/build.d.ts +16 -0
- package/dist/build.d.ts.map +1 -0
- package/dist/build.js +94 -0
- package/dist/build.js.map +1 -0
- package/dist/index.browser.d.ts +7 -0
- package/dist/index.browser.d.ts.map +1 -0
- package/dist/index.browser.js +6 -0
- package/dist/index.browser.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +6 -0
- package/dist/index.js.map +1 -0
- package/dist/parse-binary.d.ts +6 -0
- package/dist/parse-binary.d.ts.map +1 -0
- package/dist/parse-binary.js +130 -0
- package/dist/parse-binary.js.map +1 -0
- package/dist/parse-openstep.d.ts +6 -0
- package/dist/parse-openstep.d.ts.map +1 -0
- package/dist/parse-openstep.js +197 -0
- package/dist/parse-openstep.js.map +1 -0
- package/dist/parse.browser.d.ts +11 -0
- package/dist/parse.browser.d.ts.map +1 -0
- package/dist/parse.browser.js +208 -0
- package/dist/parse.browser.js.map +1 -0
- package/dist/parse.d.ts +11 -0
- package/dist/parse.d.ts.map +1 -0
- package/dist/parse.js +209 -0
- package/dist/parse.js.map +1 -0
- package/package.json +27 -8
- package/index.js +0 -2
- package/lib/build.js +0 -147
- package/lib/parse.js +0 -213
package/lib/build.js
DELETED
|
@@ -1,147 +0,0 @@
|
|
|
1
|
-
import xmlbuilder from 'xmlbuilder';
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Encode a Uint8Array into a base64 string.
|
|
5
|
-
*
|
|
6
|
-
* @param {Uint8Array} bytes
|
|
7
|
-
* @returns {String} base64 encoded string
|
|
8
|
-
* @api private
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
function uint8ArrayToBase64(bytes) {
|
|
12
|
-
let binary = '';
|
|
13
|
-
for (let i = 0; i < bytes.length; i++) {
|
|
14
|
-
binary += String.fromCharCode(bytes[i]);
|
|
15
|
-
}
|
|
16
|
-
return btoa(binary);
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
/**
|
|
20
|
-
* Accepts a `Date` instance and returns an ISO date string.
|
|
21
|
-
*
|
|
22
|
-
* @param {Date} d - Date instance to serialize
|
|
23
|
-
* @returns {String} ISO date string representation of `d`
|
|
24
|
-
* @api private
|
|
25
|
-
*/
|
|
26
|
-
|
|
27
|
-
function ISODateString(d){
|
|
28
|
-
function pad(n){
|
|
29
|
-
return n < 10 ? '0' + n : n;
|
|
30
|
-
}
|
|
31
|
-
return d.getUTCFullYear()+'-'
|
|
32
|
-
+ pad(d.getUTCMonth()+1)+'-'
|
|
33
|
-
+ pad(d.getUTCDate())+'T'
|
|
34
|
-
+ pad(d.getUTCHours())+':'
|
|
35
|
-
+ pad(d.getUTCMinutes())+':'
|
|
36
|
-
+ pad(d.getUTCSeconds())+'Z';
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
/**
|
|
40
|
-
* Returns the internal "type" of `obj` via the
|
|
41
|
-
* `Object.prototype.toString()` trick.
|
|
42
|
-
*
|
|
43
|
-
* @param {Mixed} obj - any value
|
|
44
|
-
* @returns {String} the internal "type" name
|
|
45
|
-
* @api private
|
|
46
|
-
*/
|
|
47
|
-
|
|
48
|
-
const toString = Object.prototype.toString;
|
|
49
|
-
function type (obj) {
|
|
50
|
-
const m = toString.call(obj).match(/\[object (.*)\]/);
|
|
51
|
-
return m ? m[1] : m;
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
/**
|
|
55
|
-
* Generate an XML plist string from the input object `obj`.
|
|
56
|
-
*
|
|
57
|
-
* @param {Object} obj - the object to convert
|
|
58
|
-
* @param {Object} [opts] - optional options object
|
|
59
|
-
* @returns {String} converted plist XML string
|
|
60
|
-
* @api public
|
|
61
|
-
*/
|
|
62
|
-
|
|
63
|
-
export function build (obj, opts) {
|
|
64
|
-
const XMLHDR = {
|
|
65
|
-
version: '1.0',
|
|
66
|
-
encoding: 'UTF-8'
|
|
67
|
-
};
|
|
68
|
-
|
|
69
|
-
const XMLDTD = {
|
|
70
|
-
pubid: '-//Apple//DTD PLIST 1.0//EN',
|
|
71
|
-
sysid: 'http://www.apple.com/DTDs/PropertyList-1.0.dtd'
|
|
72
|
-
};
|
|
73
|
-
|
|
74
|
-
const doc = xmlbuilder.create('plist');
|
|
75
|
-
|
|
76
|
-
doc.dec(XMLHDR.version, XMLHDR.encoding, XMLHDR.standalone);
|
|
77
|
-
doc.dtd(XMLDTD.pubid, XMLDTD.sysid);
|
|
78
|
-
doc.att('version', '1.0');
|
|
79
|
-
|
|
80
|
-
walk_obj(obj, doc);
|
|
81
|
-
|
|
82
|
-
if (!opts) opts = {};
|
|
83
|
-
// default `pretty` to `true`
|
|
84
|
-
opts.pretty = opts.pretty !== false;
|
|
85
|
-
return doc.end(opts);
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* depth first, recursive traversal of a javascript object. when complete,
|
|
90
|
-
* next_child contains a reference to the build XML object.
|
|
91
|
-
*
|
|
92
|
-
* @api private
|
|
93
|
-
*/
|
|
94
|
-
|
|
95
|
-
function walk_obj(next, next_child) {
|
|
96
|
-
const name = type(next);
|
|
97
|
-
|
|
98
|
-
if ('Undefined' == name) {
|
|
99
|
-
return;
|
|
100
|
-
} else if (Array.isArray(next)) {
|
|
101
|
-
next_child = next_child.ele('array');
|
|
102
|
-
for (let i = 0; i < next.length; i++) {
|
|
103
|
-
walk_obj(next[i], next_child);
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
} else if (next instanceof ArrayBuffer) {
|
|
107
|
-
next_child.ele('data').raw(uint8ArrayToBase64(new Uint8Array(next)));
|
|
108
|
-
|
|
109
|
-
} else if (ArrayBuffer.isView(next)) {
|
|
110
|
-
// Handles Uint8Array, Buffer, and all typed arrays
|
|
111
|
-
const bytes = next instanceof Uint8Array
|
|
112
|
-
? next
|
|
113
|
-
: new Uint8Array(next.buffer, next.byteOffset, next.byteLength);
|
|
114
|
-
next_child.ele('data').raw(uint8ArrayToBase64(bytes));
|
|
115
|
-
|
|
116
|
-
} else if ('Object' == name) {
|
|
117
|
-
next_child = next_child.ele('dict');
|
|
118
|
-
for (const prop in next) {
|
|
119
|
-
if (next.hasOwnProperty(prop)) {
|
|
120
|
-
next_child.ele('key').txt(prop);
|
|
121
|
-
walk_obj(next[prop], next_child);
|
|
122
|
-
}
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
} else if ('Number' == name) {
|
|
126
|
-
// detect if this is an integer or real
|
|
127
|
-
// TODO: add an ability to force one way or another via a "cast"
|
|
128
|
-
const tag_type = (next % 1 === 0) ? 'integer' : 'real';
|
|
129
|
-
next_child.ele(tag_type).txt(next.toString());
|
|
130
|
-
|
|
131
|
-
} else if ('BigInt' == name) {
|
|
132
|
-
next_child.ele('integer').txt(next);
|
|
133
|
-
|
|
134
|
-
} else if ('Date' == name) {
|
|
135
|
-
next_child.ele('date').txt(ISODateString(new Date(next)));
|
|
136
|
-
|
|
137
|
-
} else if ('Boolean' == name) {
|
|
138
|
-
next_child.ele(next ? 'true' : 'false');
|
|
139
|
-
|
|
140
|
-
} else if ('String' == name) {
|
|
141
|
-
next_child.ele('string').txt(next);
|
|
142
|
-
|
|
143
|
-
} else if ('Null' === name) {
|
|
144
|
-
next_child.ele('null').txt('');
|
|
145
|
-
|
|
146
|
-
}
|
|
147
|
-
}
|
package/lib/parse.js
DELETED
|
@@ -1,213 +0,0 @@
|
|
|
1
|
-
import { DOMParser } from '@xmldom/xmldom';
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Decode a base64 string into a Uint8Array.
|
|
5
|
-
*
|
|
6
|
-
* @param {String} base64 - base64 encoded string
|
|
7
|
-
* @returns {Uint8Array}
|
|
8
|
-
* @api private
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
function base64ToUint8Array(base64) {
|
|
12
|
-
const binary = atob(base64);
|
|
13
|
-
const bytes = new Uint8Array(binary.length);
|
|
14
|
-
for (let i = 0; i < binary.length; i++) {
|
|
15
|
-
bytes[i] = binary.charCodeAt(i);
|
|
16
|
-
}
|
|
17
|
-
return bytes;
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
const TEXT_NODE = 3;
|
|
21
|
-
const CDATA_NODE = 4;
|
|
22
|
-
const COMMENT_NODE = 8;
|
|
23
|
-
|
|
24
|
-
/**
|
|
25
|
-
* We ignore raw text (usually whitespace), <!-- xml comments -->,
|
|
26
|
-
* and raw CDATA nodes.
|
|
27
|
-
*
|
|
28
|
-
* @param {Element} node
|
|
29
|
-
* @returns {Boolean}
|
|
30
|
-
* @api private
|
|
31
|
-
*/
|
|
32
|
-
|
|
33
|
-
function shouldIgnoreNode(node) {
|
|
34
|
-
return (
|
|
35
|
-
node.nodeType === TEXT_NODE ||
|
|
36
|
-
node.nodeType === COMMENT_NODE ||
|
|
37
|
-
node.nodeType === CDATA_NODE
|
|
38
|
-
);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* Check if the node is empty. Some plist file has such node:
|
|
43
|
-
* <key />
|
|
44
|
-
* this node shoud be ignored.
|
|
45
|
-
*
|
|
46
|
-
* @see https://github.com/TooTallNate/plist.js/issues/66
|
|
47
|
-
* @param {Element} node
|
|
48
|
-
* @returns {Boolean}
|
|
49
|
-
* @api private
|
|
50
|
-
*/
|
|
51
|
-
function isEmptyNode(node) {
|
|
52
|
-
if (!node.childNodes || node.childNodes.length === 0) {
|
|
53
|
-
return true;
|
|
54
|
-
} else {
|
|
55
|
-
return false;
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
function invariant(test, message) {
|
|
60
|
-
if (!test) {
|
|
61
|
-
throw new Error(message);
|
|
62
|
-
}
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
/**
|
|
66
|
-
* Parses a Plist XML string. Returns an Object.
|
|
67
|
-
*
|
|
68
|
-
* @param {String} xml - the XML String to decode
|
|
69
|
-
* @returns {Mixed} the decoded value from the Plist XML
|
|
70
|
-
* @api public
|
|
71
|
-
*/
|
|
72
|
-
|
|
73
|
-
export function parse(xml) {
|
|
74
|
-
const doc = new DOMParser().parseFromString(xml, "text/xml");
|
|
75
|
-
invariant(
|
|
76
|
-
doc.documentElement.nodeName === "plist",
|
|
77
|
-
"malformed document. First element should be <plist>",
|
|
78
|
-
);
|
|
79
|
-
let plist = parsePlistXML(doc.documentElement);
|
|
80
|
-
|
|
81
|
-
// the root <plist> node gets interpreted as an Array,
|
|
82
|
-
// so pull out the inner data first
|
|
83
|
-
if (plist.length == 1) plist = plist[0];
|
|
84
|
-
|
|
85
|
-
return plist;
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* Convert an XML based plist document into a JSON representation.
|
|
90
|
-
*
|
|
91
|
-
* @param {Object} xml_node - current XML node in the plist
|
|
92
|
-
* @returns {Mixed} built up JSON object
|
|
93
|
-
* @api private
|
|
94
|
-
*/
|
|
95
|
-
|
|
96
|
-
function parsePlistXML(node) {
|
|
97
|
-
if (!node) return null;
|
|
98
|
-
|
|
99
|
-
if (node.nodeName === "plist") {
|
|
100
|
-
const new_arr = [];
|
|
101
|
-
if (isEmptyNode(node)) {
|
|
102
|
-
return new_arr;
|
|
103
|
-
}
|
|
104
|
-
for (let i = 0; i < node.childNodes.length; i++) {
|
|
105
|
-
if (!shouldIgnoreNode(node.childNodes[i])) {
|
|
106
|
-
new_arr.push(parsePlistXML(node.childNodes[i]));
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
return new_arr;
|
|
110
|
-
} else if (node.nodeName === "dict") {
|
|
111
|
-
const new_obj = {};
|
|
112
|
-
let key = null;
|
|
113
|
-
let counter = 0;
|
|
114
|
-
if (isEmptyNode(node)) {
|
|
115
|
-
return new_obj;
|
|
116
|
-
}
|
|
117
|
-
for (let i = 0; i < node.childNodes.length; i++) {
|
|
118
|
-
if (shouldIgnoreNode(node.childNodes[i])) continue;
|
|
119
|
-
if (counter % 2 === 0) {
|
|
120
|
-
invariant(
|
|
121
|
-
node.childNodes[i].nodeName === "key",
|
|
122
|
-
"Missing key while parsing <dict/>.",
|
|
123
|
-
);
|
|
124
|
-
key = parsePlistXML(node.childNodes[i]);
|
|
125
|
-
} else {
|
|
126
|
-
invariant(
|
|
127
|
-
node.childNodes[i].nodeName !== "key",
|
|
128
|
-
'Unexpected key "' +
|
|
129
|
-
parsePlistXML(node.childNodes[i]) +
|
|
130
|
-
'" while parsing <dict/>.',
|
|
131
|
-
);
|
|
132
|
-
new_obj[key] = parsePlistXML(node.childNodes[i]);
|
|
133
|
-
}
|
|
134
|
-
counter += 1;
|
|
135
|
-
}
|
|
136
|
-
if (counter % 2 === 1) {
|
|
137
|
-
new_obj[key] = "";
|
|
138
|
-
}
|
|
139
|
-
|
|
140
|
-
return new_obj;
|
|
141
|
-
} else if (node.nodeName === "array") {
|
|
142
|
-
const new_arr = [];
|
|
143
|
-
if (isEmptyNode(node)) {
|
|
144
|
-
return new_arr;
|
|
145
|
-
}
|
|
146
|
-
for (let i = 0; i < node.childNodes.length; i++) {
|
|
147
|
-
if (!shouldIgnoreNode(node.childNodes[i])) {
|
|
148
|
-
const res = parsePlistXML(node.childNodes[i]);
|
|
149
|
-
if (null != res) new_arr.push(res);
|
|
150
|
-
}
|
|
151
|
-
}
|
|
152
|
-
return new_arr;
|
|
153
|
-
} else if (node.nodeName === "#text") {
|
|
154
|
-
// TODO: what should we do with text types? (CDATA sections)
|
|
155
|
-
} else if (node.nodeName === "key") {
|
|
156
|
-
if (isEmptyNode(node)) {
|
|
157
|
-
return "";
|
|
158
|
-
}
|
|
159
|
-
|
|
160
|
-
invariant(
|
|
161
|
-
node.childNodes[0].nodeValue !== "__proto__",
|
|
162
|
-
"__proto__ keys can lead to prototype pollution. More details on CVE-2022-22912",
|
|
163
|
-
);
|
|
164
|
-
|
|
165
|
-
return node.childNodes[0].nodeValue;
|
|
166
|
-
} else if (node.nodeName === "string") {
|
|
167
|
-
let res = "";
|
|
168
|
-
if (isEmptyNode(node)) {
|
|
169
|
-
return res;
|
|
170
|
-
}
|
|
171
|
-
for (let i = 0; i < node.childNodes.length; i++) {
|
|
172
|
-
const type = node.childNodes[i].nodeType;
|
|
173
|
-
if (type === TEXT_NODE || type === CDATA_NODE) {
|
|
174
|
-
res += node.childNodes[i].nodeValue;
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
return res;
|
|
178
|
-
} else if (node.nodeName === "integer") {
|
|
179
|
-
invariant(!isEmptyNode(node), 'Cannot parse "" as integer.');
|
|
180
|
-
return parseInt(node.childNodes[0].nodeValue, 10);
|
|
181
|
-
} else if (node.nodeName === "real") {
|
|
182
|
-
invariant(!isEmptyNode(node), 'Cannot parse "" as real.');
|
|
183
|
-
let res = "";
|
|
184
|
-
for (let i = 0; i < node.childNodes.length; i++) {
|
|
185
|
-
if (node.childNodes[i].nodeType === TEXT_NODE) {
|
|
186
|
-
res += node.childNodes[i].nodeValue;
|
|
187
|
-
}
|
|
188
|
-
}
|
|
189
|
-
return parseFloat(res);
|
|
190
|
-
} else if (node.nodeName === "data") {
|
|
191
|
-
let res = "";
|
|
192
|
-
if (isEmptyNode(node)) {
|
|
193
|
-
return base64ToUint8Array(res);
|
|
194
|
-
}
|
|
195
|
-
for (let i = 0; i < node.childNodes.length; i++) {
|
|
196
|
-
if (node.childNodes[i].nodeType === TEXT_NODE) {
|
|
197
|
-
res += node.childNodes[i].nodeValue.replace(/\s+/g, "");
|
|
198
|
-
}
|
|
199
|
-
}
|
|
200
|
-
return base64ToUint8Array(res);
|
|
201
|
-
} else if (node.nodeName === "date") {
|
|
202
|
-
invariant(!isEmptyNode(node), 'Cannot parse "" as Date.');
|
|
203
|
-
return new Date(node.childNodes[0].nodeValue);
|
|
204
|
-
} else if (node.nodeName === "null") {
|
|
205
|
-
return null;
|
|
206
|
-
} else if (node.nodeName === "true") {
|
|
207
|
-
return true;
|
|
208
|
-
} else if (node.nodeName === "false") {
|
|
209
|
-
return false;
|
|
210
|
-
} else {
|
|
211
|
-
throw new Error("Invalid PLIST tag " + node.nodeName);
|
|
212
|
-
}
|
|
213
|
-
}
|