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