fesm5.js 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352
  1. /*!
  2. MIT License
  3. Copyright (c) 2018 Arturas Molcanovas <a.molcanovas@gmail.com>
  4. Permission is hereby granted, free of charge, to any person obtaining a copy
  5. of this software and associated documentation files (the "Software"), to deal
  6. in the Software without restriction, including without limitation the rights
  7. to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  8. copies of the Software, and to permit persons to whom the Software is
  9. furnished to do so, subject to the following conditions:
  10. The above copyright notice and this permission notice shall be included in all
  11. copies or substantial portions of the Software.
  12. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  13. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  14. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  15. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  16. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  17. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  18. SOFTWARE.
  19. */
  20. import { __values } from 'tslib';
  21. /**
  22. * Abstracts constructing a Blob object, so it also works in older
  23. * browsers that don't support the native Blob constructor. (i.e.
  24. * old QtWebKit versions, at least).
  25. * Abstracts constructing a Blob object, so it also works in older
  26. * browsers that don't support the native Blob constructor. (i.e.
  27. * old QtWebKit versions, at least).
  28. *
  29. * @param parts
  30. * @param properties
  31. */
  32. function createBlob(parts, properties) {
  33. /* global BlobBuilder,MSBlobBuilder,MozBlobBuilder,WebKitBlobBuilder */
  34. parts = parts || [];
  35. properties = properties || {};
  36. try {
  37. return new Blob(parts, properties);
  38. }
  39. catch (e) {
  40. if (e.name !== 'TypeError') {
  41. throw e;
  42. }
  43. //tslint:disable-next-line:variable-name
  44. var Builder = typeof BlobBuilder !== 'undefined' ? BlobBuilder
  45. : typeof MSBlobBuilder !== 'undefined' ? MSBlobBuilder
  46. : typeof MozBlobBuilder !== 'undefined' ? MozBlobBuilder
  47. : WebKitBlobBuilder;
  48. var builder = new Builder();
  49. for (var i = 0; i < parts.length; i += 1) {
  50. builder.append(parts[i]);
  51. }
  52. return builder.getBlob(properties.type);
  53. }
  54. }
  55. var BLOB_TYPE_PREFIX_REGEX = /^~~local_forage_type~([^~]+)~/;
  56. var SERIALIZED_MARKER_LENGTH = "__lfsc__:" /* SERIALIZED_MARKER */.length;
  57. var TYPE_SERIALIZED_MARKER_LENGTH = SERIALIZED_MARKER_LENGTH + "arbf" /* TYPE_ARRAYBUFFER */.length;
  58. //tslint:disable:no-magic-numbers no-bitwise prefer-switch no-unbound-method
  59. var toString = Object.prototype.toString;
  60. function stringToBuffer(serializedString) {
  61. // Fill the string into a ArrayBuffer.
  62. var bufferLength = serializedString.length * 0.75;
  63. var len = serializedString.length;
  64. if (serializedString[serializedString.length - 1] === '=') {
  65. bufferLength--;
  66. if (serializedString[serializedString.length - 2] === '=') {
  67. bufferLength--;
  68. }
  69. }
  70. var buffer = new ArrayBuffer(bufferLength);
  71. var bytes = new Uint8Array(buffer);
  72. for (var i = 0, p = 0; i < len; i += 4) {
  73. var encoded1 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" /* BASE_CHARS */.indexOf(serializedString[i]);
  74. var encoded2 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" /* BASE_CHARS */.indexOf(serializedString[i + 1]);
  75. var encoded3 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" /* BASE_CHARS */.indexOf(serializedString[i + 2]);
  76. var encoded4 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" /* BASE_CHARS */.indexOf(serializedString[i + 3]);
  77. bytes[p++] = (encoded1 << 2) | (encoded2 >> 4);
  78. bytes[p++] = ((encoded2 & 15) << 4) | (encoded3 >> 2);
  79. bytes[p++] = ((encoded3 & 3) << 6) | (encoded4 & 63);
  80. }
  81. return buffer;
  82. }
  83. /**
  84. * Converts a buffer to a string to store, serialized, in the backend
  85. * storage library.
  86. */
  87. function bufferToString(buffer) {
  88. // base64-arraybuffer
  89. var bytes = new Uint8Array(buffer);
  90. var base64String = '';
  91. for (var i = 0; i < bytes.length; i += 3) {
  92. /*jslint bitwise: true */
  93. base64String += "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" /* BASE_CHARS */[bytes[i] >> 2];
  94. base64String += "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" /* BASE_CHARS */[((bytes[i] & 3) << 4) | (bytes[i + 1] >> 4)];
  95. base64String +=
  96. "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" /* BASE_CHARS */[((bytes[i + 1] & 15) << 2) | (bytes[i + 2] >> 6)];
  97. base64String += "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" /* BASE_CHARS */[bytes[i + 2] & 63];
  98. }
  99. if (bytes.length % 3 === 2) {
  100. base64String = base64String.substring(0, base64String.length - 1) + '=';
  101. }
  102. else if (bytes.length % 3 === 1) {
  103. base64String = base64String.substring(0, base64String.length - 2) + '==';
  104. }
  105. return base64String;
  106. }
  107. /**
  108. * Serialize a value, afterwards executing a callback (which usually
  109. * instructs the `setItem()` callback/promise to be executed). This is how
  110. * we store binary data with localStorage.
  111. * @param value
  112. * @param callback
  113. */
  114. function serialize(value, callback) {
  115. var valueType = '';
  116. if (value) {
  117. valueType = toString.call(value);
  118. }
  119. // Cannot use `value instanceof ArrayBuffer` or such here, as these
  120. // checks fail when running the tests using casper.js...
  121. if (value && (valueType === '[object ArrayBuffer]' ||
  122. (value.buffer && toString.call(value.buffer) === '[object ArrayBuffer]'))) {
  123. // Convert binary arrays to a string and prefix the string with
  124. // a special marker.
  125. var buffer = void 0;
  126. var marker = "__lfsc__:" /* SERIALIZED_MARKER */;
  127. if (value instanceof ArrayBuffer) {
  128. buffer = value;
  129. marker += "arbf" /* TYPE_ARRAYBUFFER */;
  130. }
  131. else {
  132. buffer = value.buffer;
  133. if (valueType === '[object Int8Array]') {
  134. marker += "si08" /* TYPE_INT8ARRAY */;
  135. }
  136. else if (valueType === '[object Uint8Array]') {
  137. marker += "ui08" /* TYPE_UINT8ARRAY */;
  138. }
  139. else if (valueType === '[object Uint8ClampedArray]') {
  140. marker += "uic8" /* TYPE_UINT8CLAMPEDARRAY */;
  141. }
  142. else if (valueType === '[object Int16Array]') {
  143. marker += "si16" /* TYPE_INT16ARRAY */;
  144. }
  145. else if (valueType === '[object Uint16Array]') {
  146. marker += "ur16" /* TYPE_UINT16ARRAY */;
  147. }
  148. else if (valueType === '[object Int32Array]') {
  149. marker += "si32" /* TYPE_INT32ARRAY */;
  150. }
  151. else if (valueType === '[object Uint32Array]') {
  152. marker += "ui32" /* TYPE_UINT32ARRAY */;
  153. }
  154. else if (valueType === '[object Float32Array]') {
  155. marker += "fl32" /* TYPE_FLOAT32ARRAY */;
  156. }
  157. else if (valueType === '[object Float64Array]') {
  158. marker += "fl64" /* TYPE_FLOAT64ARRAY */;
  159. }
  160. else {
  161. callback(new Error('Failed to get type for BinaryArray'));
  162. }
  163. }
  164. callback(marker + bufferToString(buffer));
  165. }
  166. else if (valueType === '[object Blob]') {
  167. // Convert the blob to a binaryArray and then to a string.
  168. var fileReader = new FileReader();
  169. fileReader.onload = function () {
  170. // Backwards-compatible prefix for the blob type.
  171. //tslint:disable-next-line:restrict-plus-operands
  172. var str = "~~local_forage_type~" /* BLOB_TYPE_PREFIX */ + value.type + "~" + bufferToString(this.result);
  173. callback("__lfsc__:" /* SERIALIZED_MARKER */ + "blob" /* TYPE_BLOB */ + str);
  174. };
  175. fileReader.readAsArrayBuffer(value);
  176. }
  177. else {
  178. try {
  179. callback(JSON.stringify(value));
  180. }
  181. catch (e) {
  182. console.error('Couldn\'t convert value into a JSON string: ', value);
  183. callback(null, e);
  184. }
  185. }
  186. }
  187. /**
  188. * Deserialize data we've inserted into a value column/field. We place
  189. * special markers into our strings to mark them as encoded; this isn't
  190. * as nice as a meta field, but it's the only sane thing we can do whilst
  191. * keeping localStorage support intact.
  192. *
  193. * Oftentimes this will just deserialize JSON content, but if we have a
  194. * special marker (SERIALIZED_MARKER, defined above), we will extract
  195. * some kind of arraybuffer/binary data/typed array out of the string.
  196. * @param value
  197. */
  198. function deserialize(value) {
  199. // If we haven't marked this string as being specially serialized (i.e.
  200. // something other than serialized JSON), we can just return it and be
  201. // done with it.
  202. if (value.substring(0, SERIALIZED_MARKER_LENGTH) !== "__lfsc__:" /* SERIALIZED_MARKER */) {
  203. return JSON.parse(value);
  204. }
  205. // The following code deals with deserializing some kind of Blob or
  206. // TypedArray. First we separate out the type of data we're dealing
  207. // with from the data itself.
  208. var serializedString = value.substring(TYPE_SERIALIZED_MARKER_LENGTH);
  209. var type = value.substring(SERIALIZED_MARKER_LENGTH, TYPE_SERIALIZED_MARKER_LENGTH);
  210. var blobType;
  211. // Backwards-compatible blob type serialization strategy.
  212. // DBs created with older versions of localForage will simply not have the blob type.
  213. if (type === "blob" /* TYPE_BLOB */ && BLOB_TYPE_PREFIX_REGEX.test(serializedString)) {
  214. var matcher = serializedString.match(BLOB_TYPE_PREFIX_REGEX);
  215. blobType = matcher[1];
  216. serializedString = serializedString.substring(matcher[0].length);
  217. }
  218. var buffer = stringToBuffer(serializedString);
  219. // Return the right type based on the code/type set during
  220. // serialization.
  221. switch (type) {
  222. case "arbf" /* TYPE_ARRAYBUFFER */:
  223. return buffer;
  224. case "blob" /* TYPE_BLOB */:
  225. return createBlob([buffer], { type: blobType });
  226. case "si08" /* TYPE_INT8ARRAY */:
  227. return new Int8Array(buffer);
  228. case "ui08" /* TYPE_UINT8ARRAY */:
  229. return new Uint8Array(buffer);
  230. case "uic8" /* TYPE_UINT8CLAMPEDARRAY */:
  231. return new Uint8ClampedArray(buffer);
  232. case "si16" /* TYPE_INT16ARRAY */:
  233. return new Int16Array(buffer);
  234. case "ur16" /* TYPE_UINT16ARRAY */:
  235. return new Uint16Array(buffer);
  236. case "si32" /* TYPE_INT32ARRAY */:
  237. return new Int32Array(buffer);
  238. case "ui32" /* TYPE_UINT32ARRAY */:
  239. return new Uint32Array(buffer);
  240. case "fl32" /* TYPE_FLOAT32ARRAY */:
  241. return new Float32Array(buffer);
  242. case "fl64" /* TYPE_FLOAT64ARRAY */:
  243. return new Float64Array(buffer);
  244. default:
  245. throw new Error('Unkown type: ' + type);
  246. }
  247. }
  248. function clone(obj) {
  249. var e_1, _a;
  250. if (obj === null || typeof (obj) !== 'object' || 'isActiveClone' in obj) {
  251. return obj;
  252. }
  253. var temp = obj instanceof Date ? new Date(obj) : (obj.constructor());
  254. try {
  255. for (var _b = __values(Object.keys(obj)), _c = _b.next(); !_c.done; _c = _b.next()) {
  256. var key = _c.value;
  257. if (Object.prototype.hasOwnProperty.call(obj, key)) {
  258. obj['isActiveClone'] = null;
  259. temp[key] = clone(obj[key]);
  260. delete obj['isActiveClone'];
  261. }
  262. }
  263. }
  264. catch (e_1_1) { e_1 = { error: e_1_1 }; }
  265. finally {
  266. try {
  267. if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
  268. }
  269. finally { if (e_1) throw e_1.error; }
  270. }
  271. return temp;
  272. }
  273. function getKeyPrefix(options, defaultConfig) {
  274. return (options.name || defaultConfig.name) + "/" + (options.storeName || defaultConfig.storeName) + "/";
  275. }
  276. function executeCallback(promise, callback) {
  277. if (callback) {
  278. promise.then(function (result) {
  279. callback(null, result);
  280. }, function (error) {
  281. callback(error);
  282. });
  283. }
  284. }
  285. function getCallback() {
  286. var _args = [];
  287. for (var _i = 0; _i < arguments.length; _i++) {
  288. _args[_i] = arguments[_i];
  289. }
  290. if (arguments.length && typeof arguments[arguments.length - 1] === 'function') {
  291. return arguments[arguments.length - 1];
  292. }
  293. }
  294. //tslint:disable-next-line:no-ignored-initial-value
  295. function dropInstanceCommon(options, callback) {
  296. var _this = this;
  297. callback = getCallback.apply(this, arguments);
  298. options = (typeof options !== 'function' && options) || {};
  299. if (!options.name) {
  300. var currentConfig = this.config();
  301. options.name = options.name || currentConfig.name;
  302. options.storeName = options.storeName || currentConfig.storeName;
  303. }
  304. var promise;
  305. if (!options.name) {
  306. promise = Promise.reject('Invalid arguments');
  307. }
  308. else {
  309. promise = new Promise(function (resolve) {
  310. if (!options.storeName) {
  311. resolve(options.name + "/");
  312. }
  313. else {
  314. resolve(getKeyPrefix(options, _this._defaultConfig));
  315. }
  316. });
  317. }
  318. return { promise: promise, callback: callback };
  319. }
  320. function normaliseKey(key) {
  321. // Cast the key to a string, as that's all we can set as a key.
  322. if (typeof key !== 'string') {
  323. console.warn(key + " used as a key, but it is not a string.");
  324. key = String(key);
  325. }
  326. return key;
  327. }
  328. var serialiser = {
  329. bufferToString: bufferToString,
  330. deserialize: deserialize,
  331. serialize: serialize,
  332. stringToBuffer: stringToBuffer
  333. };
  334. export { serialiser, clone, getKeyPrefix, executeCallback, getCallback, dropInstanceCommon, normaliseKey };
  335. //# sourceMappingURL=fesm5.js.map