@loaders.gl/archives 0.0.0-stage → 5.0.0-alpha.13

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 (167) hide show
  1. package/README.md +4 -2
  2. package/dist/dist.dev.js +5101 -0
  3. package/dist/dist.min.js +9 -0
  4. package/dist/index.cjs +2982 -0
  5. package/dist/index.cjs.map +6 -0
  6. package/dist/index.d.ts +11 -0
  7. package/dist/index.d.ts.map +1 -0
  8. package/dist/index.js +11 -0
  9. package/dist/index.js.map +1 -0
  10. package/dist/tar/index.cjs +576 -0
  11. package/dist/tar/index.cjs.map +6 -0
  12. package/dist/tar/index.d.ts +8 -0
  13. package/dist/tar/index.d.ts.map +1 -0
  14. package/dist/tar/index.js +9 -0
  15. package/dist/tar/index.js.map +1 -0
  16. package/dist/tar/lib/header.d.ts +9 -0
  17. package/dist/tar/lib/header.d.ts.map +1 -0
  18. package/dist/tar/lib/header.js +76 -0
  19. package/dist/tar/lib/header.js.map +1 -0
  20. package/dist/tar/lib/tar.d.ts +29 -0
  21. package/dist/tar/lib/tar.d.ts.map +1 -0
  22. package/dist/tar/lib/tar.js +136 -0
  23. package/dist/tar/lib/tar.js.map +1 -0
  24. package/dist/tar/lib/types.d.ts +48 -0
  25. package/dist/tar/lib/types.d.ts.map +1 -0
  26. package/dist/tar/lib/types.js +5 -0
  27. package/dist/tar/lib/types.js.map +1 -0
  28. package/dist/tar/lib/utils.d.ts +23 -0
  29. package/dist/tar/lib/utils.d.ts.map +1 -0
  30. package/dist/tar/lib/utils.js +52 -0
  31. package/dist/tar/lib/utils.js.map +1 -0
  32. package/dist/tar/tar-archive.d.ts +4 -0
  33. package/dist/tar/tar-archive.d.ts.map +1 -0
  34. package/dist/tar/tar-archive.js +97 -0
  35. package/dist/tar/tar-archive.js.map +1 -0
  36. package/dist/tar/tar-builder.d.ts +28 -0
  37. package/dist/tar/tar-builder.d.ts.map +1 -0
  38. package/dist/tar/tar-builder.js +38 -0
  39. package/dist/tar/tar-builder.js.map +1 -0
  40. package/dist/tar/tar-format.d.ts +12 -0
  41. package/dist/tar/tar-format.d.ts.map +1 -0
  42. package/dist/tar/tar-format.js +15 -0
  43. package/dist/tar/tar-format.js.map +1 -0
  44. package/dist/tar/tar-loader-types.d.ts +15 -0
  45. package/dist/tar/tar-loader-types.d.ts.map +1 -0
  46. package/dist/tar/tar-loader-types.js +20 -0
  47. package/dist/tar/tar-loader-types.js.map +1 -0
  48. package/dist/tar/tar-loader.cjs +285 -0
  49. package/dist/tar/tar-loader.cjs.map +6 -0
  50. package/dist/tar/tar-loader.d.ts +3 -0
  51. package/dist/tar/tar-loader.d.ts.map +1 -0
  52. package/dist/tar/tar-loader.js +12 -0
  53. package/dist/tar/tar-loader.js.map +1 -0
  54. package/dist/tar/tar-writer.cjs +114 -0
  55. package/dist/tar/tar-writer.cjs.map +6 -0
  56. package/dist/tar/tar-writer.d.ts +20 -0
  57. package/dist/tar/tar-writer.d.ts.map +1 -0
  58. package/dist/tar/tar-writer.js +94 -0
  59. package/dist/tar/tar-writer.js.map +1 -0
  60. package/dist/zip/filesystems/IndexedArchive.d.ts +40 -0
  61. package/dist/zip/filesystems/IndexedArchive.d.ts.map +1 -0
  62. package/dist/zip/filesystems/IndexedArchive.js +99 -0
  63. package/dist/zip/filesystems/IndexedArchive.js.map +1 -0
  64. package/dist/zip/filesystems/zip-filesystem.d.ts +53 -0
  65. package/dist/zip/filesystems/zip-filesystem.d.ts.map +1 -0
  66. package/dist/zip/filesystems/zip-filesystem.js +231 -0
  67. package/dist/zip/filesystems/zip-filesystem.js.map +1 -0
  68. package/dist/zip/hash-file-utility.d.ts +20 -0
  69. package/dist/zip/hash-file-utility.d.ts.map +1 -0
  70. package/dist/zip/hash-file-utility.js +83 -0
  71. package/dist/zip/hash-file-utility.js.map +1 -0
  72. package/dist/zip/index.cjs +4614 -0
  73. package/dist/zip/index.cjs.map +6 -0
  74. package/dist/zip/index.d.ts +18 -0
  75. package/dist/zip/index.d.ts.map +1 -0
  76. package/dist/zip/index.js +14 -0
  77. package/dist/zip/index.js.map +1 -0
  78. package/dist/zip/indexed-zip-writer.cjs +1211 -0
  79. package/dist/zip/indexed-zip-writer.cjs.map +6 -0
  80. package/dist/zip/indexed-zip-writer.d.ts +46 -0
  81. package/dist/zip/indexed-zip-writer.d.ts.map +1 -0
  82. package/dist/zip/indexed-zip-writer.js +229 -0
  83. package/dist/zip/indexed-zip-writer.js.map +1 -0
  84. package/dist/zip/lib/zip-composition.d.ts +37 -0
  85. package/dist/zip/lib/zip-composition.d.ts.map +1 -0
  86. package/dist/zip/lib/zip-composition.js +157 -0
  87. package/dist/zip/lib/zip-composition.js.map +1 -0
  88. package/dist/zip/lib/zip-entry-metadata.d.ts +34 -0
  89. package/dist/zip/lib/zip-entry-metadata.d.ts.map +1 -0
  90. package/dist/zip/lib/zip-entry-metadata.js +132 -0
  91. package/dist/zip/lib/zip-entry-metadata.js.map +1 -0
  92. package/dist/zip/lib/zip-serialization.d.ts +36 -0
  93. package/dist/zip/lib/zip-serialization.d.ts.map +1 -0
  94. package/dist/zip/lib/zip-serialization.js +148 -0
  95. package/dist/zip/lib/zip-serialization.js.map +1 -0
  96. package/dist/zip/lib/zip64-extra-field.d.ts +20 -0
  97. package/dist/zip/lib/zip64-extra-field.d.ts.map +1 -0
  98. package/dist/zip/lib/zip64-extra-field.js +53 -0
  99. package/dist/zip/lib/zip64-extra-field.js.map +1 -0
  100. package/dist/zip/zip-archive-types.d.ts +56 -0
  101. package/dist/zip/zip-archive-types.d.ts.map +1 -0
  102. package/dist/zip/zip-archive-types.js +5 -0
  103. package/dist/zip/zip-archive-types.js.map +1 -0
  104. package/dist/zip/zip-archive.d.ts +101 -0
  105. package/dist/zip/zip-archive.d.ts.map +1 -0
  106. package/dist/zip/zip-archive.js +593 -0
  107. package/dist/zip/zip-archive.js.map +1 -0
  108. package/dist/zip/zip-encode-types.d.ts +41 -0
  109. package/dist/zip/zip-encode-types.d.ts.map +1 -0
  110. package/dist/zip/zip-encode-types.js +5 -0
  111. package/dist/zip/zip-encode-types.js.map +1 -0
  112. package/dist/zip/zip-encode.cjs +1154 -0
  113. package/dist/zip/zip-encode.cjs.map +6 -0
  114. package/dist/zip/zip-encode.d.ts +15 -0
  115. package/dist/zip/zip-encode.d.ts.map +1 -0
  116. package/dist/zip/zip-encode.js +312 -0
  117. package/dist/zip/zip-encode.js.map +1 -0
  118. package/dist/zip/zip-format.d.ts +14 -0
  119. package/dist/zip/zip-format.d.ts.map +1 -0
  120. package/dist/zip/zip-format.js +17 -0
  121. package/dist/zip/zip-format.js.map +1 -0
  122. package/dist/zip/zip-loader-types.d.ts +15 -0
  123. package/dist/zip/zip-loader-types.d.ts.map +1 -0
  124. package/dist/zip/zip-loader-types.js +20 -0
  125. package/dist/zip/zip-loader-types.js.map +1 -0
  126. package/dist/zip/zip-loader.cjs +2681 -0
  127. package/dist/zip/zip-loader.cjs.map +6 -0
  128. package/dist/zip/zip-loader.d.ts +3 -0
  129. package/dist/zip/zip-loader.d.ts.map +1 -0
  130. package/dist/zip/zip-loader.js +38 -0
  131. package/dist/zip/zip-loader.js.map +1 -0
  132. package/dist/zip/zip-writer.cjs +1208 -0
  133. package/dist/zip/zip-writer.cjs.map +6 -0
  134. package/dist/zip/zip-writer.d.ts +40 -0
  135. package/dist/zip/zip-writer.d.ts.map +1 -0
  136. package/dist/zip/zip-writer.js +48 -0
  137. package/dist/zip/zip-writer.js.map +1 -0
  138. package/package.json +88 -4
  139. package/src/index.ts +14 -0
  140. package/src/tar/index.ts +11 -0
  141. package/src/tar/lib/header.ts +82 -0
  142. package/src/tar/lib/tar.ts +160 -0
  143. package/src/tar/lib/types.ts +51 -0
  144. package/src/tar/lib/utils.ts +55 -0
  145. package/src/tar/tar-archive.ts +98 -0
  146. package/src/tar/tar-builder.ts +47 -0
  147. package/src/tar/tar-format.ts +17 -0
  148. package/src/tar/tar-loader-types.ts +36 -0
  149. package/src/tar/tar-loader.ts +17 -0
  150. package/src/tar/tar-writer.ts +102 -0
  151. package/src/zip/filesystems/IndexedArchive.ts +110 -0
  152. package/src/zip/filesystems/zip-filesystem.ts +244 -0
  153. package/src/zip/hash-file-utility.ts +109 -0
  154. package/src/zip/index.ts +38 -0
  155. package/src/zip/indexed-zip-writer.ts +345 -0
  156. package/src/zip/lib/zip-composition.ts +243 -0
  157. package/src/zip/lib/zip-entry-metadata.ts +157 -0
  158. package/src/zip/lib/zip-serialization.ts +206 -0
  159. package/src/zip/lib/zip64-extra-field.ts +84 -0
  160. package/src/zip/zip-archive-types.ts +64 -0
  161. package/src/zip/zip-archive.ts +733 -0
  162. package/src/zip/zip-encode-types.ts +53 -0
  163. package/src/zip/zip-encode.ts +370 -0
  164. package/src/zip/zip-format.ts +19 -0
  165. package/src/zip/zip-loader-types.ts +36 -0
  166. package/src/zip/zip-loader.ts +43 -0
  167. package/src/zip/zip-writer.ts +73 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tar-loader-types.d.ts","sourceRoot":"","sources":["../../src/tar/tar-loader-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,aAAa,EAAC,MAAM,+BAA+B,CAAC;AAMzE,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAErD,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC7C,GAAG,CAAC,EAAE;QACJ,qDAAqD;QACrD,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,6DAA6D;QAC7D,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,SAAS,KAW0C,CAAC"}
@@ -0,0 +1,20 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+ import { TarFormat } from "./tar-format.js";
5
+ // @ts-ignore TS2304: Cannot find name '__VERSION__'.
6
+ const VERSION = typeof "5.0.0-alpha.13" !== 'undefined' ? "5.0.0-alpha.13" : 'latest';
7
+ /** Metadata-only TAR loader. */
8
+ export const TarLoader = {
9
+ ...TarFormat,
10
+ version: VERSION,
11
+ dataType: null,
12
+ batchType: null,
13
+ options: { tar: { maxEntries: 100000, maxTotalDecodedBytes: 64 * 1024 * 1024 } },
14
+ /** Loads the parser through the installed package subpath. */
15
+ async preload() {
16
+ const { TarLoaderWithParser } = await import('@loaders.gl/archives/tar/tar-loader');
17
+ return TarLoaderWithParser;
18
+ }
19
+ };
20
+ //# sourceMappingURL=tar-loader-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tar-loader-types.js","sourceRoot":"","sources":["../../src/tar/tar-loader-types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,SAAS,EAAC,wBAAqB;AAEvC,qDAAqD;AACrD,MAAM,OAAO,GAAG,uBAAkB,KAAK,WAAW,CAAC,CAAC,kBAAa,CAAC,CAAC,QAAQ,CAAC;AAe5E,gCAAgC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,GAAG,SAAS;IACZ,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,IAA6B;IACvC,SAAS,EAAE,IAAwB;IACnC,OAAO,EAAE,EAAC,GAAG,EAAE,EAAC,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAC,EAAC;IAC5E,8DAA8D;IAC9D,KAAK,CAAC,OAAO;QACX,MAAM,EAAC,mBAAmB,EAAC,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;QAClF,OAAO,mBAAmB,CAAC;IAC7B,CAAC;CAC6D,CAAC"}
@@ -0,0 +1,285 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __esm = (fn, res, err) => function __init() {
7
+ if (err) throw err[0];
8
+ try {
9
+ return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
10
+ } catch (e) {
11
+ throw err = [e], e;
12
+ }
13
+ };
14
+ var __export = (target, all) => {
15
+ for (var name in all)
16
+ __defProp(target, name, { get: all[name], enumerable: true });
17
+ };
18
+ var __copyProps = (to, from, except, desc) => {
19
+ if (from && typeof from === "object" || typeof from === "function") {
20
+ for (let key of __getOwnPropNames(from))
21
+ if (!__hasOwnProp.call(to, key) && key !== except)
22
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
23
+ }
24
+ return to;
25
+ };
26
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
27
+
28
+ // src/tar/tar-format.ts
29
+ var TarFormat2;
30
+ var init_tar_format = __esm({
31
+ "src/tar/tar-format.ts"() {
32
+ "use strict";
33
+ TarFormat2 = {
34
+ name: "TAR Archive",
35
+ id: "tar",
36
+ module: "archives",
37
+ format: "tar",
38
+ extensions: ["tar"],
39
+ mimeTypes: ["application/x-tar"],
40
+ category: "archive",
41
+ binary: true
42
+ };
43
+ }
44
+ });
45
+
46
+ // src/tar/tar-loader-types.ts
47
+ var VERSION, TarLoader;
48
+ var init_tar_loader_types = __esm({
49
+ "src/tar/tar-loader-types.ts"() {
50
+ "use strict";
51
+ init_tar_format();
52
+ VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : "latest";
53
+ TarLoader = {
54
+ ...TarFormat2,
55
+ version: VERSION,
56
+ dataType: null,
57
+ batchType: null,
58
+ options: { tar: { maxEntries: 1e5, maxTotalDecodedBytes: 64 * 1024 * 1024 } },
59
+ /** Loads the parser through the installed package subpath. */
60
+ async preload() {
61
+ const { TarLoaderWithParser: TarLoaderWithParser3 } = await Promise.resolve().then(() => (init_tar_loader(), tar_loader_exports));
62
+ return TarLoaderWithParser3;
63
+ }
64
+ };
65
+ }
66
+ });
67
+
68
+ // src/tar/tar-archive.ts
69
+ function readString(bytes) {
70
+ const end = bytes.indexOf(0);
71
+ return decoder.decode(end === -1 ? bytes : bytes.subarray(0, end));
72
+ }
73
+ function readOctal(bytes) {
74
+ const value = readString(bytes).trim();
75
+ if (!value || !/^[0-7]+$/.test(value)) throw new Error("Invalid TAR numeric field");
76
+ const number = Number.parseInt(value, 8);
77
+ if (!Number.isSafeInteger(number)) throw new RangeError("TAR numeric field exceeds safe range");
78
+ return number;
79
+ }
80
+ function normalizePath(path, directory) {
81
+ if (!path || path.startsWith("/") || path.includes("\\") || path.includes("\0") || /^[A-Za-z]:/.test(path)) {
82
+ throw new Error(`Unsafe TAR path: ${path}`);
83
+ }
84
+ const components = path.split("/").filter((part) => part && part !== ".");
85
+ if (components.includes("..")) throw new Error(`Unsafe TAR path: ${path}`);
86
+ if (/^[A-Za-z]:/.test(components[0] ?? "")) throw new Error(`Unsafe TAR path: ${path}`);
87
+ if (!components.length) {
88
+ if (directory) return null;
89
+ throw new Error(`Unsafe TAR path: ${path}`);
90
+ }
91
+ return components.join("/");
92
+ }
93
+ function readTarArchive(input, options = {}) {
94
+ var _a, _b;
95
+ const bytes = input instanceof ArrayBuffer ? new Uint8Array(input) : new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
96
+ const maxEntries = ((_a = options.tar) == null ? void 0 : _a.maxEntries) ?? 1e5;
97
+ const maxBytes = ((_b = options.tar) == null ? void 0 : _b.maxTotalDecodedBytes) ?? 64 * 1024 * 1024;
98
+ if (!Number.isSafeInteger(maxEntries) || maxEntries < 0 || !Number.isSafeInteger(maxBytes) || maxBytes < 0) {
99
+ throw new RangeError("Invalid TAR limits");
100
+ }
101
+ const files = /* @__PURE__ */ Object.create(null);
102
+ let offset = 0;
103
+ let entries = 0;
104
+ let totalBytes = 0;
105
+ while (offset + BLOCK_SIZE <= bytes.length) {
106
+ const header = bytes.subarray(offset, offset + BLOCK_SIZE);
107
+ if (header.every((byte) => byte === 0)) return files;
108
+ const storedChecksum = readOctal(header.subarray(148, 156));
109
+ let checksum = 0;
110
+ for (let index = 0; index < BLOCK_SIZE; index++) {
111
+ checksum += index >= 148 && index < 156 ? 32 : header[index];
112
+ }
113
+ if (checksum !== storedChecksum) throw new Error("Invalid TAR header checksum");
114
+ if (++entries > maxEntries) throw new RangeError("TAR entry limit exceeded");
115
+ const name = readString(header.subarray(0, 100));
116
+ const prefix = readString(header.subarray(345, 500));
117
+ const type = header[156];
118
+ const path = normalizePath(prefix ? `${prefix}/${name}` : name, type === 53);
119
+ const size = readOctal(header.subarray(124, 136));
120
+ const dataOffset = offset + BLOCK_SIZE;
121
+ if (size > bytes.length - dataOffset) throw new Error("Truncated TAR entry");
122
+ if (type === 0 || type === 48) {
123
+ totalBytes += size;
124
+ if (totalBytes > maxBytes) throw new RangeError("TAR decoded-byte limit exceeded");
125
+ if (path === null) throw new Error("Invalid TAR file path");
126
+ if (Object.hasOwn(files, path)) throw new Error(`Duplicate TAR path: ${path}`);
127
+ files[path] = bytes.slice(dataOffset, dataOffset + size).buffer;
128
+ } else if (type !== 53) {
129
+ throw new Error(`Unsupported TAR entry type: ${String.fromCharCode(type)}`);
130
+ }
131
+ offset = dataOffset + Math.ceil(size / BLOCK_SIZE) * BLOCK_SIZE;
132
+ }
133
+ throw new Error("Truncated TAR archive");
134
+ }
135
+ var BLOCK_SIZE, decoder;
136
+ var init_tar_archive = __esm({
137
+ "src/tar/tar-archive.ts"() {
138
+ "use strict";
139
+ BLOCK_SIZE = 512;
140
+ decoder = new TextDecoder();
141
+ }
142
+ });
143
+
144
+ // src/tar/tar-loader.ts
145
+ var tar_loader_exports = {};
146
+ __export(tar_loader_exports, {
147
+ TarLoaderWithParser: () => TarLoaderWithParser
148
+ });
149
+ var _preload, metadata, TarLoaderWithParser;
150
+ var init_tar_loader = __esm({
151
+ "src/tar/tar-loader.ts"() {
152
+ "use strict";
153
+ init_tar_loader_types();
154
+ init_tar_archive();
155
+ ({ preload: _preload, ...metadata } = TarLoader);
156
+ TarLoaderWithParser = {
157
+ ...metadata,
158
+ parse: async (input, options) => readTarArchive(input, options)
159
+ };
160
+ }
161
+ });
162
+
163
+ // dist/tar/tar-loader.js
164
+ var tar_loader_exports2 = {};
165
+ __export(tar_loader_exports2, {
166
+ TarLoaderWithParser: () => TarLoaderWithParser2
167
+ });
168
+ module.exports = __toCommonJS(tar_loader_exports2);
169
+
170
+ // dist/tar/tar-format.js
171
+ var TarFormat = {
172
+ name: "TAR Archive",
173
+ id: "tar",
174
+ module: "archives",
175
+ format: "tar",
176
+ extensions: ["tar"],
177
+ mimeTypes: ["application/x-tar"],
178
+ category: "archive",
179
+ binary: true
180
+ };
181
+
182
+ // dist/tar/tar-loader-types.js
183
+ var VERSION2 = true ? "5.0.0-alpha.13" : "latest";
184
+ var TarLoader2 = {
185
+ ...TarFormat,
186
+ version: VERSION2,
187
+ dataType: null,
188
+ batchType: null,
189
+ options: { tar: { maxEntries: 1e5, maxTotalDecodedBytes: 64 * 1024 * 1024 } },
190
+ /** Loads the parser through the installed package subpath. */
191
+ async preload() {
192
+ const { TarLoaderWithParser: TarLoaderWithParser3 } = await Promise.resolve().then(() => (init_tar_loader(), tar_loader_exports));
193
+ return TarLoaderWithParser3;
194
+ }
195
+ };
196
+
197
+ // dist/tar/tar-archive.js
198
+ var BLOCK_SIZE2 = 512;
199
+ var decoder2 = new TextDecoder();
200
+ function readString2(bytes) {
201
+ const end = bytes.indexOf(0);
202
+ return decoder2.decode(end === -1 ? bytes : bytes.subarray(0, end));
203
+ }
204
+ function readOctal2(bytes) {
205
+ const value = readString2(bytes).trim();
206
+ if (!value || !/^[0-7]+$/.test(value))
207
+ throw new Error("Invalid TAR numeric field");
208
+ const number = Number.parseInt(value, 8);
209
+ if (!Number.isSafeInteger(number))
210
+ throw new RangeError("TAR numeric field exceeds safe range");
211
+ return number;
212
+ }
213
+ function normalizePath2(path, directory) {
214
+ if (!path || path.startsWith("/") || path.includes("\\") || path.includes("\0") || /^[A-Za-z]:/.test(path)) {
215
+ throw new Error(`Unsafe TAR path: ${path}`);
216
+ }
217
+ const components = path.split("/").filter((part) => part && part !== ".");
218
+ if (components.includes(".."))
219
+ throw new Error(`Unsafe TAR path: ${path}`);
220
+ if (/^[A-Za-z]:/.test(components[0] ?? ""))
221
+ throw new Error(`Unsafe TAR path: ${path}`);
222
+ if (!components.length) {
223
+ if (directory)
224
+ return null;
225
+ throw new Error(`Unsafe TAR path: ${path}`);
226
+ }
227
+ return components.join("/");
228
+ }
229
+ function readTarArchive2(input, options = {}) {
230
+ var _a, _b;
231
+ const bytes = input instanceof ArrayBuffer ? new Uint8Array(input) : new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
232
+ const maxEntries = ((_a = options.tar) == null ? void 0 : _a.maxEntries) ?? 1e5;
233
+ const maxBytes = ((_b = options.tar) == null ? void 0 : _b.maxTotalDecodedBytes) ?? 64 * 1024 * 1024;
234
+ if (!Number.isSafeInteger(maxEntries) || maxEntries < 0 || !Number.isSafeInteger(maxBytes) || maxBytes < 0) {
235
+ throw new RangeError("Invalid TAR limits");
236
+ }
237
+ const files = /* @__PURE__ */ Object.create(null);
238
+ let offset = 0;
239
+ let entries = 0;
240
+ let totalBytes = 0;
241
+ while (offset + BLOCK_SIZE2 <= bytes.length) {
242
+ const header = bytes.subarray(offset, offset + BLOCK_SIZE2);
243
+ if (header.every((byte) => byte === 0))
244
+ return files;
245
+ const storedChecksum = readOctal2(header.subarray(148, 156));
246
+ let checksum = 0;
247
+ for (let index = 0; index < BLOCK_SIZE2; index++) {
248
+ checksum += index >= 148 && index < 156 ? 32 : header[index];
249
+ }
250
+ if (checksum !== storedChecksum)
251
+ throw new Error("Invalid TAR header checksum");
252
+ if (++entries > maxEntries)
253
+ throw new RangeError("TAR entry limit exceeded");
254
+ const name = readString2(header.subarray(0, 100));
255
+ const prefix = readString2(header.subarray(345, 500));
256
+ const type = header[156];
257
+ const path = normalizePath2(prefix ? `${prefix}/${name}` : name, type === 53);
258
+ const size = readOctal2(header.subarray(124, 136));
259
+ const dataOffset = offset + BLOCK_SIZE2;
260
+ if (size > bytes.length - dataOffset)
261
+ throw new Error("Truncated TAR entry");
262
+ if (type === 0 || type === 48) {
263
+ totalBytes += size;
264
+ if (totalBytes > maxBytes)
265
+ throw new RangeError("TAR decoded-byte limit exceeded");
266
+ if (path === null)
267
+ throw new Error("Invalid TAR file path");
268
+ if (Object.hasOwn(files, path))
269
+ throw new Error(`Duplicate TAR path: ${path}`);
270
+ files[path] = bytes.slice(dataOffset, dataOffset + size).buffer;
271
+ } else if (type !== 53) {
272
+ throw new Error(`Unsupported TAR entry type: ${String.fromCharCode(type)}`);
273
+ }
274
+ offset = dataOffset + Math.ceil(size / BLOCK_SIZE2) * BLOCK_SIZE2;
275
+ }
276
+ throw new Error("Truncated TAR archive");
277
+ }
278
+
279
+ // dist/tar/tar-loader.js
280
+ var { preload: _preload2, ...metadata2 } = TarLoader2;
281
+ var TarLoaderWithParser2 = {
282
+ ...metadata2,
283
+ parse: async (input, options) => readTarArchive2(input, options)
284
+ };
285
+ //# sourceMappingURL=tar-loader.cjs.map
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/tar/tar-format.ts", "../../src/tar/tar-loader-types.ts", "../../src/tar/tar-archive.ts", "../../src/tar/tar-loader.ts", "../../src/tar/tar-loader.ts", "../../src/tar/tar-format.ts", "../../src/tar/tar-loader-types.ts", "../../src/tar/tar-archive.ts"],
4
+ "mappings": "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",
5
+ "names": ["TarFormat", "TarFormat", "TarLoaderWithParser", "tar_loader_exports", "TarLoaderWithParser", "VERSION", "TarLoader", "TarLoaderWithParser", "BLOCK_SIZE", "decoder", "readString", "readOctal", "normalizePath", "readTarArchive", "_preload", "metadata", "TarLoader", "TarLoaderWithParser", "readTarArchive"]
6
+ }
@@ -0,0 +1,3 @@
1
+ /** Parser-bearing TAR loader. */
2
+ export declare const TarLoaderWithParser: any;
3
+ //# sourceMappingURL=tar-loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tar-loader.d.ts","sourceRoot":"","sources":["../../src/tar/tar-loader.ts"],"names":[],"mappings":"AAWA,iCAAiC;AACjC,eAAO,MAAM,mBAAmB,KAI0C,CAAC"}
@@ -0,0 +1,12 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+ import { TarLoader } from "./tar-loader-types.js";
5
+ import { readTarArchive } from "./tar-archive.js";
6
+ const { preload: _preload, ...metadata } = TarLoader;
7
+ /** Parser-bearing TAR loader. */
8
+ export const TarLoaderWithParser = {
9
+ ...metadata,
10
+ parse: async (input, options) => readTarArchive(input, options)
11
+ };
12
+ //# sourceMappingURL=tar-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tar-loader.js","sourceRoot":"","sources":["../../src/tar/tar-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,SAAS,EAAC,8BAA2B;AAE7C,OAAO,EAAC,cAAc,EAAC,yBAAsB;AAE7C,MAAM,EAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAC,GAAG,SAAS,CAAC;AAEnD,iCAAiC;AACjC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,QAAQ;IACX,KAAK,EAAE,KAAK,EAAE,KAAkB,EAAE,OAA0B,EAAuB,EAAE,CACnF,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC;CACwC,CAAC"}
@@ -0,0 +1,114 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // dist/tar/tar-writer.js
21
+ var tar_writer_exports = {};
22
+ __export(tar_writer_exports, {
23
+ TarWriter: () => TarWriter,
24
+ encodeTar: () => encodeTar
25
+ });
26
+ module.exports = __toCommonJS(tar_writer_exports);
27
+
28
+ // dist/tar/tar-format.js
29
+ var TarFormat = {
30
+ name: "TAR Archive",
31
+ id: "tar",
32
+ module: "archives",
33
+ format: "tar",
34
+ extensions: ["tar"],
35
+ mimeTypes: ["application/x-tar"],
36
+ category: "archive",
37
+ binary: true
38
+ };
39
+
40
+ // dist/tar/tar-writer.js
41
+ var VERSION = true ? "5.0.0-alpha.13" : "latest";
42
+ var BLOCK_SIZE = 512;
43
+ var encoder = new TextEncoder();
44
+ function writeOctal(header, offset, width, value) {
45
+ const digits = value.toString(8);
46
+ if (!Number.isSafeInteger(value) || value < 0 || digits.length > width - 1) {
47
+ throw new RangeError("TAR numeric field exceeds header capacity");
48
+ }
49
+ header.set(encoder.encode(digits.padStart(width - 1, "0")), offset);
50
+ header[offset + width - 1] = 0;
51
+ }
52
+ function splitPath(path) {
53
+ const components = path.split("/").filter((part) => part && part !== ".");
54
+ if (!path || path.startsWith("/") || path.includes("\\") || path.includes("\0") || /^[A-Za-z]:/.test(components[0] ?? "") || components.includes("..")) {
55
+ throw new Error(`Unsafe TAR path: ${path}`);
56
+ }
57
+ const bytes = encoder.encode(path);
58
+ if (bytes.length <= 100)
59
+ return { name: bytes, prefix: new Uint8Array(0) };
60
+ for (let index = path.lastIndexOf("/"); index > 0; index = path.lastIndexOf("/", index - 1)) {
61
+ const prefix = encoder.encode(path.slice(0, index));
62
+ const name = encoder.encode(path.slice(index + 1));
63
+ if (prefix.length <= 155 && name.length > 0 && name.length <= 100)
64
+ return { name, prefix };
65
+ }
66
+ throw new RangeError(`TAR path exceeds ustar header capacity: ${path}`);
67
+ }
68
+ async function encodeTar(files) {
69
+ const entries = Object.keys(files).sort().map((path) => [path, files[path]]);
70
+ const prepared = entries.map(([path, value]) => {
71
+ const directory = path.endsWith("/");
72
+ const bytes = typeof value === "string" ? encoder.encode(value) : value instanceof Uint8Array ? value : new Uint8Array(value);
73
+ if (directory && bytes.length)
74
+ throw new Error(`TAR directory has file data: ${path}`);
75
+ return { path, directory, bytes, ...splitPath(path) };
76
+ });
77
+ let length = BLOCK_SIZE * 2;
78
+ for (const entry of prepared) {
79
+ length += BLOCK_SIZE + Math.ceil(entry.bytes.length / BLOCK_SIZE) * BLOCK_SIZE;
80
+ if (!Number.isSafeInteger(length))
81
+ throw new RangeError("TAR archive exceeds safe size");
82
+ }
83
+ const archive = new Uint8Array(length);
84
+ let offset = 0;
85
+ for (const entry of prepared) {
86
+ const header = archive.subarray(offset, offset + BLOCK_SIZE);
87
+ header.set(entry.name, 0);
88
+ writeOctal(header, 100, 8, entry.directory ? 493 : 420);
89
+ writeOctal(header, 108, 8, 0);
90
+ writeOctal(header, 116, 8, 0);
91
+ writeOctal(header, 124, 12, entry.bytes.length);
92
+ writeOctal(header, 136, 12, 0);
93
+ header.fill(32, 148, 156);
94
+ header[156] = entry.directory ? 53 : 48;
95
+ header.set(encoder.encode("ustar\0"), 257);
96
+ header.set(encoder.encode("00"), 263);
97
+ header.set(entry.prefix, 345);
98
+ let checksum = 0;
99
+ for (const byte of header)
100
+ checksum += byte;
101
+ header.set(encoder.encode(checksum.toString(8).padStart(6, "0") + "\0 "), 148);
102
+ offset += BLOCK_SIZE;
103
+ archive.set(entry.bytes, offset);
104
+ offset += Math.ceil(entry.bytes.length / BLOCK_SIZE) * BLOCK_SIZE;
105
+ }
106
+ return archive.buffer;
107
+ }
108
+ var TarWriter = {
109
+ ...TarFormat,
110
+ version: VERSION,
111
+ options: {},
112
+ encode: async (files, _options) => encodeTar(files)
113
+ };
114
+ //# sourceMappingURL=tar-writer.cjs.map
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/tar/tar-writer.ts", "../../src/tar/tar-format.ts"],
4
+ "mappings": "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",
5
+ "names": []
6
+ }
@@ -0,0 +1,20 @@
1
+ import type { WriterOptions } from '@loaders.gl/core/loader-utils';
2
+ /** Named files to encode as an uncompressed TAR archive. A trailing slash denotes a directory. */
3
+ export type TarWriterFiles = Readonly<Record<string, string | ArrayBuffer | Uint8Array>>;
4
+ /** Encodes named files with UTF-8 ustar names and deterministic metadata. */
5
+ export declare function encodeTar(files: TarWriterFiles): Promise<ArrayBuffer>;
6
+ /** Buffered UTF-8 ustar writer. */
7
+ export declare const TarWriter: {
8
+ readonly version: any;
9
+ readonly options: {};
10
+ readonly encode: (files: TarWriterFiles, _options?: WriterOptions) => Promise<ArrayBuffer>;
11
+ readonly name: "TAR Archive";
12
+ readonly id: "tar";
13
+ readonly module: "archives";
14
+ readonly format: "tar";
15
+ readonly extensions: ["tar"];
16
+ readonly mimeTypes: ["application/x-tar"];
17
+ readonly category: "archive";
18
+ readonly binary: true;
19
+ };
20
+ //# sourceMappingURL=tar-writer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tar-writer.d.ts","sourceRoot":"","sources":["../../src/tar/tar-writer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,aAAa,EAAC,MAAM,+BAA+B,CAAC;AAQpF,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC;AAmCzF,6EAA6E;AAC7E,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CA2C3E;AAED,mCAAmC;AACnC,eAAO,MAAM,SAAS;;;6BAIE,cAAc,aAAa,aAAa,KAAG,OAAO,CAAC,WAAW,CAAC;;;;;;;;;CAEX,CAAC"}
@@ -0,0 +1,94 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+ import { TarFormat } from "./tar-format.js";
5
+ // @ts-ignore TS2304: Cannot find name '__VERSION__'.
6
+ const VERSION = typeof "5.0.0-alpha.13" !== 'undefined' ? "5.0.0-alpha.13" : 'latest';
7
+ const BLOCK_SIZE = 512;
8
+ const encoder = new TextEncoder();
9
+ /** Encodes an unsigned octal value into a fixed-width TAR header field. */
10
+ function writeOctal(header, offset, width, value) {
11
+ const digits = value.toString(8);
12
+ if (!Number.isSafeInteger(value) || value < 0 || digits.length > width - 1) {
13
+ throw new RangeError('TAR numeric field exceeds header capacity');
14
+ }
15
+ header.set(encoder.encode(digits.padStart(width - 1, '0')), offset);
16
+ header[offset + width - 1] = 0;
17
+ }
18
+ /** Splits a UTF-8 path at a slash for the ustar name and prefix fields. */
19
+ function splitPath(path) {
20
+ const components = path.split('/').filter(part => part && part !== '.');
21
+ if (!path ||
22
+ path.startsWith('/') ||
23
+ path.includes('\\') ||
24
+ path.includes('\0') ||
25
+ /^[A-Za-z]:/.test(components[0] ?? '') ||
26
+ components.includes('..')) {
27
+ throw new Error(`Unsafe TAR path: ${path}`);
28
+ }
29
+ const bytes = encoder.encode(path);
30
+ if (bytes.length <= 100)
31
+ return { name: bytes, prefix: new Uint8Array(0) };
32
+ for (let index = path.lastIndexOf('/'); index > 0; index = path.lastIndexOf('/', index - 1)) {
33
+ const prefix = encoder.encode(path.slice(0, index));
34
+ const name = encoder.encode(path.slice(index + 1));
35
+ if (prefix.length <= 155 && name.length > 0 && name.length <= 100)
36
+ return { name, prefix };
37
+ }
38
+ throw new RangeError(`TAR path exceeds ustar header capacity: ${path}`);
39
+ }
40
+ /** Encodes named files with UTF-8 ustar names and deterministic metadata. */
41
+ export async function encodeTar(files) {
42
+ const entries = Object.keys(files)
43
+ .sort()
44
+ .map(path => [path, files[path]]);
45
+ const prepared = entries.map(([path, value]) => {
46
+ const directory = path.endsWith('/');
47
+ const bytes = typeof value === 'string'
48
+ ? encoder.encode(value)
49
+ : value instanceof Uint8Array
50
+ ? value
51
+ : new Uint8Array(value);
52
+ if (directory && bytes.length)
53
+ throw new Error(`TAR directory has file data: ${path}`);
54
+ return { path, directory, bytes, ...splitPath(path) };
55
+ });
56
+ let length = BLOCK_SIZE * 2;
57
+ for (const entry of prepared) {
58
+ length += BLOCK_SIZE + Math.ceil(entry.bytes.length / BLOCK_SIZE) * BLOCK_SIZE;
59
+ if (!Number.isSafeInteger(length))
60
+ throw new RangeError('TAR archive exceeds safe size');
61
+ }
62
+ const archive = new Uint8Array(length);
63
+ let offset = 0;
64
+ for (const entry of prepared) {
65
+ const header = archive.subarray(offset, offset + BLOCK_SIZE);
66
+ header.set(entry.name, 0);
67
+ writeOctal(header, 100, 8, entry.directory ? 0o755 : 0o644);
68
+ writeOctal(header, 108, 8, 0);
69
+ writeOctal(header, 116, 8, 0);
70
+ writeOctal(header, 124, 12, entry.bytes.length);
71
+ writeOctal(header, 136, 12, 0);
72
+ header.fill(32, 148, 156);
73
+ header[156] = entry.directory ? 53 : 48;
74
+ header.set(encoder.encode('ustar\0'), 257);
75
+ header.set(encoder.encode('00'), 263);
76
+ header.set(entry.prefix, 345);
77
+ let checksum = 0;
78
+ for (const byte of header)
79
+ checksum += byte;
80
+ header.set(encoder.encode(checksum.toString(8).padStart(6, '0') + '\0 '), 148);
81
+ offset += BLOCK_SIZE;
82
+ archive.set(entry.bytes, offset);
83
+ offset += Math.ceil(entry.bytes.length / BLOCK_SIZE) * BLOCK_SIZE;
84
+ }
85
+ return archive.buffer;
86
+ }
87
+ /** Buffered UTF-8 ustar writer. */
88
+ export const TarWriter = {
89
+ ...TarFormat,
90
+ version: VERSION,
91
+ options: {},
92
+ encode: async (files, _options) => encodeTar(files)
93
+ };
94
+ //# sourceMappingURL=tar-writer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tar-writer.js","sourceRoot":"","sources":["../../src/tar/tar-writer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import type { ReadableFile } from '@loaders.gl/core/loader-utils';
2
+ import { type ZipArchive } from "../zip-archive.js";
3
+ import type { ZipArchiveOptions } from "../zip-archive-types.js";
4
+ /** Base transport for formats with a final MD5 path/local-offset index. */
5
+ export declare abstract class IndexedArchive {
6
+ /** Independent reader budgets captured for lazy initialization. */
7
+ private readonly options;
8
+ /** Owned random-access archive source. */
9
+ readonly file: ReadableFile;
10
+ /** Optional resource URL prefix. */
11
+ readonly fileName?: string;
12
+ /** Format-provided path hashes, or a directory-derived fallback. */
13
+ protected hashTable?: Record<string, bigint>;
14
+ /** Cancellation for metadata initialization and indexed reads. */
15
+ private readonly controller;
16
+ /** Shared lazy ZIP reader and directory cache. */
17
+ private readerPromise?;
18
+ /** Idempotent release even when no reader has been opened. */
19
+ private closePromise?;
20
+ /** Captures the source and an optional already-loaded format index. */
21
+ constructor(file: ReadableFile, hashTable?: Record<string, bigint>, fileName?: string,
22
+ /** Independent reader budgets captured for lazy initialization. */
23
+ options?: ZipArchiveOptions);
24
+ /** Reads a format resource; adapters retain aliases and content-level decoding. */
25
+ abstract getFile(path: string, mode?: string): Promise<ArrayBuffer>;
26
+ /**
27
+ * Loads a final index when present, otherwise hashes validated directory entries.
28
+ * The format supplies the reserved name and fallback path-case policy. Returns true for an index.
29
+ */
30
+ initializeIndex(indexPath: string, lowercasePaths?: boolean): Promise<boolean>;
31
+ /** Closes the reader/transport exactly once and rejects subsequent resource reads. */
32
+ close(): Promise<void>;
33
+ /** Reads and verifies a complete ZIP entry, retaining direct indexed local-header access. */
34
+ protected readZipEntry(path: string): Promise<ArrayBuffer | undefined>;
35
+ /** Compatibility helper for adapters with no path index. */
36
+ protected getFileWithoutHash(path: string): Promise<ArrayBuffer>;
37
+ /** Initializes container metadata once without reading unrelated payloads. */
38
+ getZipArchive(): Promise<ZipArchive>;
39
+ }
40
+ //# sourceMappingURL=IndexedArchive.d.ts.map