@kubohiroya/sb3-toolchain 0.11.0 → 0.12.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/CHANGELOG.md +19 -4
- package/README.ja.md +17 -1
- package/README.md +17 -1
- package/dist/archive.d.ts +1 -0
- package/dist/archive.js +16 -0
- package/dist/archive.js.map +1 -0
- package/dist/assert.d.ts +2 -0
- package/dist/assert.js +11 -0
- package/dist/assert.js.map +1 -0
- package/dist/bin.d.ts +1 -0
- package/dist/bin.js +12 -0
- package/dist/bin.js.map +1 -0
- package/dist/build.d.ts +23 -0
- package/dist/build.js +111 -0
- package/dist/build.js.map +1 -0
- package/dist/cli.d.ts +87 -0
- package/dist/cli.js +544 -0
- package/dist/cli.js.map +1 -0
- package/dist/constants.d.ts +2 -0
- package/dist/constants.js +7 -0
- package/dist/constants.js.map +1 -0
- package/dist/extension-api-manifest.d.ts +46 -0
- package/dist/extension-api-manifest.js +211 -0
- package/dist/extension-api-manifest.js.map +1 -0
- package/dist/extension-bundle-archive.d.ts +36 -0
- package/dist/extension-bundle-archive.js +302 -0
- package/dist/extension-bundle-archive.js.map +1 -0
- package/dist/extension-bundle-configuration.d.ts +55 -0
- package/dist/extension-bundle-configuration.js +200 -0
- package/dist/extension-bundle-configuration.js.map +1 -0
- package/dist/extension-bundle.d.ts +39 -0
- package/dist/extension-bundle.js +580 -0
- package/dist/extension-bundle.js.map +1 -0
- package/dist/extension-dependencies.d.ts +18 -0
- package/dist/extension-dependencies.js +59 -0
- package/dist/extension-dependencies.js.map +1 -0
- package/dist/extension-id-migration.d.ts +83 -0
- package/dist/extension-id-migration.js +292 -0
- package/dist/extension-id-migration.js.map +1 -0
- package/dist/extension-sync.d.ts +111 -0
- package/dist/extension-sync.js +463 -0
- package/dist/extension-sync.js.map +1 -0
- package/dist/import.d.ts +39 -0
- package/dist/import.js +244 -0
- package/dist/import.js.map +1 -0
- package/dist/index.d.ts +31 -0
- package/dist/index.js +18 -0
- package/dist/npm-extension-source.d.ts +13 -0
- package/dist/npm-extension-source.js +63 -0
- package/dist/npm-extension-source.js.map +1 -0
- package/dist/output-safety.d.ts +29 -0
- package/dist/output-safety.js +213 -0
- package/dist/output-safety.js.map +1 -0
- package/dist/project-asset-additions.d.ts +29 -0
- package/dist/project-asset-additions.js +412 -0
- package/dist/project-asset-additions.js.map +1 -0
- package/dist/release-snapshot.d.ts +75 -0
- package/dist/release-snapshot.js +177 -0
- package/dist/release-snapshot.js.map +1 -0
- package/dist/source.d.ts +41 -0
- package/dist/source.js +282 -0
- package/dist/source.js.map +1 -0
- package/dist/turbowarp-clean-up.d.ts +18 -0
- package/dist/turbowarp-clean-up.js +266 -0
- package/dist/turbowarp-clean-up.js.map +1 -0
- package/dist/types.d.ts +80 -0
- package/package.json +22 -13
- package/bin/sb3-toolchain.mjs +0 -9
- package/src/archive.js +0 -35
- package/src/build.js +0 -188
- package/src/cli.js +0 -748
- package/src/constants.js +0 -4
- package/src/extension-api-manifest.js +0 -336
- package/src/extension-bundle-archive.js +0 -422
- package/src/extension-bundle-configuration.js +0 -265
- package/src/extension-bundle.js +0 -695
- package/src/extension-dependencies.js +0 -114
- package/src/extension-id-migration.js +0 -496
- package/src/extension-sync.js +0 -754
- package/src/import.js +0 -397
- package/src/index.js +0 -75
- package/src/npm-extension-source.js +0 -111
- package/src/output-safety.js +0 -322
- package/src/project-asset-additions.js +0 -560
- package/src/release-snapshot.js +0 -247
- package/src/source.js +0 -468
- package/src/turbowarp-clean-up.js +0 -295
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { EmbeddedExtension, ExtensionApiManifestSource } from './types';
|
|
2
|
+
export declare const extensionApiManifestFormatVersion = 1;
|
|
3
|
+
export declare const defaultExtensionApiManifestSizeLimit: number;
|
|
4
|
+
export interface ExtensionApiManifestArgument {
|
|
5
|
+
id: string;
|
|
6
|
+
menu?: string;
|
|
7
|
+
type: string;
|
|
8
|
+
}
|
|
9
|
+
export interface ExtensionApiManifestBlock {
|
|
10
|
+
arguments: ExtensionApiManifestArgument[];
|
|
11
|
+
blockType: string;
|
|
12
|
+
opcode: string;
|
|
13
|
+
}
|
|
14
|
+
export interface ExtensionApiManifestMenu {
|
|
15
|
+
acceptReporters: boolean;
|
|
16
|
+
id: string;
|
|
17
|
+
}
|
|
18
|
+
export interface ExtensionApiManifest {
|
|
19
|
+
blocks: ExtensionApiManifestBlock[];
|
|
20
|
+
formatVersion: number;
|
|
21
|
+
id: string;
|
|
22
|
+
menus: ExtensionApiManifestMenu[];
|
|
23
|
+
}
|
|
24
|
+
export interface ExtensionApiCompatibilityChange {
|
|
25
|
+
after: unknown;
|
|
26
|
+
before: unknown;
|
|
27
|
+
breaking: boolean;
|
|
28
|
+
kind: string;
|
|
29
|
+
path: string;
|
|
30
|
+
}
|
|
31
|
+
export interface ValidatedExtensionApiManifest {
|
|
32
|
+
integrity: string;
|
|
33
|
+
manifest: ExtensionApiManifest;
|
|
34
|
+
metadata: ExtensionApiManifestSource;
|
|
35
|
+
}
|
|
36
|
+
export declare function extensionApiManifestIntegrity(contents: Uint8Array | string): string;
|
|
37
|
+
export declare function extensionApiManifestLocalPath(extensionId: string): string;
|
|
38
|
+
export declare function validateExtensionApiManifestSourceMetadata(extension: EmbeddedExtension): ExtensionApiManifestSource | null;
|
|
39
|
+
export declare function parseExtensionApiManifest(contents: Uint8Array | string, { expectedId }?: {
|
|
40
|
+
expectedId?: string;
|
|
41
|
+
}): ExtensionApiManifest;
|
|
42
|
+
export declare function validateManagedExtensionApiManifest(extension: EmbeddedExtension, contents: Uint8Array | string, { expectedId }?: {
|
|
43
|
+
expectedId?: string;
|
|
44
|
+
}): ValidatedExtensionApiManifest | null;
|
|
45
|
+
export declare function compareExtensionApiManifests(installed: ExtensionApiManifest, candidate: ExtensionApiManifest): ExtensionApiCompatibilityChange[];
|
|
46
|
+
export declare function formatExtensionApiCompatibilityChanges(extensionId: string, changes: ExtensionApiCompatibilityChange[]): string;
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
import { assert, errorMessage } from "./assert.js";
|
|
2
|
+
import { validateArchiveEntryName } from "./archive.js";
|
|
3
|
+
import { createHash } from "node:crypto";
|
|
4
|
+
//#region src/extension-api-manifest.ts
|
|
5
|
+
var extensionApiManifestFormatVersion = 1;
|
|
6
|
+
var defaultExtensionApiManifestSizeLimit = 1048576;
|
|
7
|
+
function isObject(value) {
|
|
8
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
9
|
+
}
|
|
10
|
+
function assertExactProperties(value, expected, description) {
|
|
11
|
+
const expectedProperties = new Set(expected);
|
|
12
|
+
const unexpected = Object.keys(value).filter((property) => !expectedProperties.has(property));
|
|
13
|
+
assert(unexpected.length === 0, `${description} has unsupported properties: ${unexpected.join(", ")}`);
|
|
14
|
+
}
|
|
15
|
+
function assertNonEmptyString(value, description) {
|
|
16
|
+
assert(typeof value === "string" && value.length > 0, `${description} must be a non-empty string.`);
|
|
17
|
+
return value;
|
|
18
|
+
}
|
|
19
|
+
function compareIds(left, right) {
|
|
20
|
+
return left < right ? -1 : left > right ? 1 : 0;
|
|
21
|
+
}
|
|
22
|
+
function escapeJsonPointer(value) {
|
|
23
|
+
return value.replaceAll("~", "~0").replaceAll("/", "~1");
|
|
24
|
+
}
|
|
25
|
+
function extensionApiManifestIntegrity(contents) {
|
|
26
|
+
return `sha256-${createHash("sha256").update(contents).digest("base64")}`;
|
|
27
|
+
}
|
|
28
|
+
function extensionApiManifestLocalPath(extensionId) {
|
|
29
|
+
return `extensions/${extensionId}.manifest.json`;
|
|
30
|
+
}
|
|
31
|
+
function validateExtensionApiManifestSourceMetadata(extension) {
|
|
32
|
+
const metadata = extension.source?.apiManifest;
|
|
33
|
+
if (metadata === void 0) return null;
|
|
34
|
+
assert(isObject(metadata), `Managed extension API manifest metadata must be an object: ${extension.id}`);
|
|
35
|
+
assertExactProperties(metadata, [
|
|
36
|
+
"artifact",
|
|
37
|
+
"formatVersion",
|
|
38
|
+
"integrity",
|
|
39
|
+
"path"
|
|
40
|
+
], `Managed extension API manifest metadata for ${extension.id}`);
|
|
41
|
+
assert(metadata.formatVersion === 1, `Managed extension ${extension.id} requires API manifest formatVersion 1.`);
|
|
42
|
+
const artifact = assertNonEmptyString(metadata.artifact, `Managed extension ${extension.id} API manifest artifact`);
|
|
43
|
+
validateArchiveEntryName(artifact);
|
|
44
|
+
assert(!artifact.endsWith("/"), `Managed extension API manifest artifact must be a file: ${artifact}`);
|
|
45
|
+
const expectedPath = extensionApiManifestLocalPath(extension.id);
|
|
46
|
+
assert(metadata.path === expectedPath, `Managed extension API manifest path must match its ID: expected ${expectedPath}, got ${metadata.path}`);
|
|
47
|
+
assert(typeof metadata.integrity === "string" && /^sha256-[A-Za-z0-9+/]{43}=$/u.test(metadata.integrity), `Managed extension ${extension.id} API manifest requires SHA-256 integrity.`);
|
|
48
|
+
return metadata;
|
|
49
|
+
}
|
|
50
|
+
function normalizeArgument(value, blockOpcode, index, menuIds) {
|
|
51
|
+
assert(isObject(value), `API manifest block ${blockOpcode} argument ${index} must be an object.`);
|
|
52
|
+
assertExactProperties(value, [
|
|
53
|
+
"id",
|
|
54
|
+
"menu",
|
|
55
|
+
"type"
|
|
56
|
+
], `API manifest block ${blockOpcode} argument ${index}`);
|
|
57
|
+
const id = assertNonEmptyString(value.id, `API manifest block ${blockOpcode} argument ${index} ID`);
|
|
58
|
+
const type = assertNonEmptyString(value.type, `API manifest block ${blockOpcode} argument ${id} type`);
|
|
59
|
+
if (value.menu === void 0) return {
|
|
60
|
+
id,
|
|
61
|
+
type
|
|
62
|
+
};
|
|
63
|
+
const menu = assertNonEmptyString(value.menu, `API manifest block ${blockOpcode} argument ${id} menu`);
|
|
64
|
+
assert(menuIds.has(menu), `API manifest block ${blockOpcode} argument ${id} references unknown menu: ${menu}`);
|
|
65
|
+
return {
|
|
66
|
+
id,
|
|
67
|
+
menu,
|
|
68
|
+
type
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
function normalizeBlock(value, index, menuIds) {
|
|
72
|
+
assert(isObject(value), `API manifest block ${index} must be an object.`);
|
|
73
|
+
assertExactProperties(value, [
|
|
74
|
+
"arguments",
|
|
75
|
+
"blockType",
|
|
76
|
+
"opcode"
|
|
77
|
+
], `API manifest block ${index}`);
|
|
78
|
+
const opcode = assertNonEmptyString(value.opcode, `API manifest block ${index} opcode`);
|
|
79
|
+
const blockType = assertNonEmptyString(value.blockType, `API manifest block ${opcode} blockType`);
|
|
80
|
+
assert(Array.isArray(value.arguments), `API manifest block ${opcode} arguments must be an array.`);
|
|
81
|
+
const arguments_ = value.arguments.map((argument, argumentIndex) => normalizeArgument(argument, opcode, argumentIndex, menuIds));
|
|
82
|
+
const argumentIds = /* @__PURE__ */ new Set();
|
|
83
|
+
for (const argument of arguments_) {
|
|
84
|
+
assert(!argumentIds.has(argument.id), `API manifest block ${opcode} has duplicate argument ID: ${argument.id}`);
|
|
85
|
+
argumentIds.add(argument.id);
|
|
86
|
+
}
|
|
87
|
+
arguments_.sort((left, right) => compareIds(left.id, right.id));
|
|
88
|
+
return {
|
|
89
|
+
arguments: arguments_,
|
|
90
|
+
blockType,
|
|
91
|
+
opcode
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
function normalizeMenu(value, index) {
|
|
95
|
+
assert(isObject(value), `API manifest menu ${index} must be an object.`);
|
|
96
|
+
assertExactProperties(value, ["acceptReporters", "id"], `API manifest menu ${index}`);
|
|
97
|
+
const id = assertNonEmptyString(value.id, `API manifest menu ${index} ID`);
|
|
98
|
+
assert(typeof value.acceptReporters === "boolean", `API manifest menu ${id} acceptReporters must be a boolean.`);
|
|
99
|
+
return {
|
|
100
|
+
acceptReporters: value.acceptReporters,
|
|
101
|
+
id
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
function parseExtensionApiManifest(contents, { expectedId } = {}) {
|
|
105
|
+
let manifest;
|
|
106
|
+
try {
|
|
107
|
+
manifest = JSON.parse(Buffer.from(contents).toString("utf8"));
|
|
108
|
+
} catch (error) {
|
|
109
|
+
throw new Error(`Extension API manifest is not valid JSON: ${errorMessage(error)}`, { cause: error });
|
|
110
|
+
}
|
|
111
|
+
assert(isObject(manifest), "Extension API manifest must contain an object.");
|
|
112
|
+
assertExactProperties(manifest, [
|
|
113
|
+
"blocks",
|
|
114
|
+
"formatVersion",
|
|
115
|
+
"id",
|
|
116
|
+
"menus"
|
|
117
|
+
], "Extension API manifest");
|
|
118
|
+
assert(manifest.formatVersion === 1, `Unsupported extension API manifest formatVersion: ${manifest.formatVersion}`);
|
|
119
|
+
assert(typeof manifest.id === "string" && /^[a-z0-9]+$/u.test(manifest.id), `Invalid extension API manifest ID: ${JSON.stringify(manifest.id)}`);
|
|
120
|
+
if (expectedId !== void 0) assert(manifest.id === expectedId, `Extension API manifest ID mismatch: expected ${expectedId}, got ${manifest.id}`);
|
|
121
|
+
assert(Array.isArray(manifest.menus), "Extension API manifest menus must be an array.");
|
|
122
|
+
const menus = manifest.menus.map(normalizeMenu);
|
|
123
|
+
const menuIds = /* @__PURE__ */ new Set();
|
|
124
|
+
for (const menu of menus) {
|
|
125
|
+
assert(!menuIds.has(menu.id), `Extension API manifest has duplicate menu ID: ${menu.id}`);
|
|
126
|
+
menuIds.add(menu.id);
|
|
127
|
+
}
|
|
128
|
+
assert(Array.isArray(manifest.blocks), "Extension API manifest blocks must be an array.");
|
|
129
|
+
const blocks = manifest.blocks.map((block, index) => normalizeBlock(block, index, menuIds));
|
|
130
|
+
const blockOpcodes = /* @__PURE__ */ new Set();
|
|
131
|
+
for (const block of blocks) {
|
|
132
|
+
assert(!blockOpcodes.has(block.opcode), `Extension API manifest has duplicate block opcode: ${block.opcode}`);
|
|
133
|
+
blockOpcodes.add(block.opcode);
|
|
134
|
+
}
|
|
135
|
+
blocks.sort((left, right) => compareIds(left.opcode, right.opcode));
|
|
136
|
+
menus.sort((left, right) => compareIds(left.id, right.id));
|
|
137
|
+
return {
|
|
138
|
+
blocks,
|
|
139
|
+
formatVersion: 1,
|
|
140
|
+
id: manifest.id,
|
|
141
|
+
menus
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
function validateManagedExtensionApiManifest(extension, contents, { expectedId = extension.id } = {}) {
|
|
145
|
+
const metadata = validateExtensionApiManifestSourceMetadata(extension);
|
|
146
|
+
if (!metadata) return null;
|
|
147
|
+
const actualIntegrity = extensionApiManifestIntegrity(contents);
|
|
148
|
+
assert(actualIntegrity === metadata.integrity, `Managed extension API manifest integrity mismatch for ${extension.id}: expected ${metadata.integrity}, got ${actualIntegrity}`);
|
|
149
|
+
const manifest = parseExtensionApiManifest(contents, { expectedId });
|
|
150
|
+
assert(manifest.formatVersion === metadata.formatVersion, `Managed extension API manifest version mismatch for ${extension.id}.`);
|
|
151
|
+
return {
|
|
152
|
+
integrity: actualIntegrity,
|
|
153
|
+
manifest,
|
|
154
|
+
metadata
|
|
155
|
+
};
|
|
156
|
+
}
|
|
157
|
+
function addChange(changes, kind, path, before, after, breaking) {
|
|
158
|
+
changes.push({
|
|
159
|
+
after,
|
|
160
|
+
before,
|
|
161
|
+
breaking,
|
|
162
|
+
kind,
|
|
163
|
+
path
|
|
164
|
+
});
|
|
165
|
+
}
|
|
166
|
+
function compareExtensionApiManifests(installed, candidate) {
|
|
167
|
+
const changes = [];
|
|
168
|
+
const installedBlocks = new Map(installed.blocks.map((block) => [block.opcode, block]));
|
|
169
|
+
const candidateBlocks = new Map(candidate.blocks.map((block) => [block.opcode, block]));
|
|
170
|
+
for (const [opcode, block] of installedBlocks) {
|
|
171
|
+
const path = `/blocks/${escapeJsonPointer(opcode)}`;
|
|
172
|
+
const replacement = candidateBlocks.get(opcode);
|
|
173
|
+
if (!replacement) {
|
|
174
|
+
addChange(changes, "block-removed", path, block, null, true);
|
|
175
|
+
continue;
|
|
176
|
+
}
|
|
177
|
+
if (block.blockType !== replacement.blockType) addChange(changes, "block-type-changed", `${path}/blockType`, block.blockType, replacement.blockType, true);
|
|
178
|
+
const installedArguments = new Map(block.arguments.map((argument) => [argument.id, argument]));
|
|
179
|
+
const candidateArguments = new Map(replacement.arguments.map((argument) => [argument.id, argument]));
|
|
180
|
+
for (const [argumentId, argument] of installedArguments) {
|
|
181
|
+
const argumentPath = `${path}/arguments/${escapeJsonPointer(argumentId)}`;
|
|
182
|
+
const replacementArgument = candidateArguments.get(argumentId);
|
|
183
|
+
if (!replacementArgument) {
|
|
184
|
+
addChange(changes, "argument-removed", argumentPath, argument, null, true);
|
|
185
|
+
continue;
|
|
186
|
+
}
|
|
187
|
+
for (const property of ["type", "menu"]) if (argument[property] !== replacementArgument[property]) addChange(changes, `argument-${property}-changed`, `${argumentPath}/${property}`, argument[property] ?? null, replacementArgument[property] ?? null, true);
|
|
188
|
+
}
|
|
189
|
+
for (const [argumentId, argument] of candidateArguments) if (!installedArguments.has(argumentId)) addChange(changes, "argument-added", `${path}/arguments/${escapeJsonPointer(argumentId)}`, null, argument, true);
|
|
190
|
+
}
|
|
191
|
+
for (const [opcode, block] of candidateBlocks) if (!installedBlocks.has(opcode)) addChange(changes, "block-added", `/blocks/${escapeJsonPointer(opcode)}`, null, block, false);
|
|
192
|
+
const installedMenus = new Map(installed.menus.map((menu) => [menu.id, menu]));
|
|
193
|
+
const candidateMenus = new Map(candidate.menus.map((menu) => [menu.id, menu]));
|
|
194
|
+
const referencedInstalledMenus = /* @__PURE__ */ new Set();
|
|
195
|
+
for (const block of installed.blocks) for (const argument of block.arguments) if (argument.menu !== void 0) referencedInstalledMenus.add(argument.menu);
|
|
196
|
+
for (const [menuId, menu] of installedMenus) {
|
|
197
|
+
const path = `/menus/${escapeJsonPointer(menuId)}`;
|
|
198
|
+
const replacement = candidateMenus.get(menuId);
|
|
199
|
+
if (!replacement) addChange(changes, "menu-removed", path, menu, null, referencedInstalledMenus.has(menuId));
|
|
200
|
+
else if (menu.acceptReporters !== replacement.acceptReporters) addChange(changes, "menu-accept-reporters-changed", `${path}/acceptReporters`, menu.acceptReporters, replacement.acceptReporters, true);
|
|
201
|
+
}
|
|
202
|
+
for (const [menuId, menu] of candidateMenus) if (!installedMenus.has(menuId)) addChange(changes, "menu-added", `/menus/${escapeJsonPointer(menuId)}`, null, menu, false);
|
|
203
|
+
return changes.sort((left, right) => left.path === right.path ? compareIds(left.kind, right.kind) : compareIds(left.path, right.path));
|
|
204
|
+
}
|
|
205
|
+
function formatExtensionApiCompatibilityChanges(extensionId, changes) {
|
|
206
|
+
return changes.map((change) => `${extensionId} ${change.breaking ? "breaking" : "compatible"} ${change.kind} ${change.path}`).join("\n");
|
|
207
|
+
}
|
|
208
|
+
//#endregion
|
|
209
|
+
export { compareExtensionApiManifests, defaultExtensionApiManifestSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, formatExtensionApiCompatibilityChanges, parseExtensionApiManifest, validateExtensionApiManifestSourceMetadata, validateManagedExtensionApiManifest };
|
|
210
|
+
|
|
211
|
+
//# sourceMappingURL=extension-api-manifest.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"extension-api-manifest.js","names":[],"sources":["../src/extension-api-manifest.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {createHash} from 'node:crypto';\n\nimport {validateArchiveEntryName} from './archive';\nimport {assert, errorMessage} from './assert';\nimport type {EmbeddedExtension, ExtensionApiManifestSource, UnknownRecord} from './types';\n\nexport const extensionApiManifestFormatVersion = 1;\nexport const defaultExtensionApiManifestSizeLimit = 1024 * 1024;\n\nexport interface ExtensionApiManifestArgument {\n id: string;\n menu?: string;\n type: string;\n}\n\nexport interface ExtensionApiManifestBlock {\n arguments: ExtensionApiManifestArgument[];\n blockType: string;\n opcode: string;\n}\n\nexport interface ExtensionApiManifestMenu {\n acceptReporters: boolean;\n id: string;\n}\n\nexport interface ExtensionApiManifest {\n blocks: ExtensionApiManifestBlock[];\n formatVersion: number;\n id: string;\n menus: ExtensionApiManifestMenu[];\n}\n\nexport interface ExtensionApiCompatibilityChange {\n after: unknown;\n before: unknown;\n breaking: boolean;\n kind: string;\n path: string;\n}\n\nexport interface ValidatedExtensionApiManifest {\n integrity: string;\n manifest: ExtensionApiManifest;\n metadata: ExtensionApiManifestSource;\n}\n\nfunction isObject(value: unknown): value is UnknownRecord {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction assertExactProperties(\n value: UnknownRecord,\n expected: string[],\n description: string,\n): void {\n const expectedProperties = new Set(expected);\n const unexpected = Object.keys(value).filter((property) => !expectedProperties.has(property));\n assert(\n unexpected.length === 0,\n `${description} has unsupported properties: ${unexpected.join(', ')}`,\n );\n}\n\nfunction assertNonEmptyString(value: unknown, description: string): string {\n assert(\n typeof value === 'string' && value.length > 0,\n `${description} must be a non-empty string.`,\n );\n return value;\n}\n\nfunction compareIds(left: string, right: string): number {\n return left < right ? -1 : left > right ? 1 : 0;\n}\n\nfunction escapeJsonPointer(value: string): string {\n return value.replaceAll('~', '~0').replaceAll('/', '~1');\n}\n\nexport function extensionApiManifestIntegrity(contents: Uint8Array | string): string {\n return `sha256-${createHash('sha256').update(contents).digest('base64')}`;\n}\n\nexport function extensionApiManifestLocalPath(extensionId: string): string {\n return `extensions/${extensionId}.manifest.json`;\n}\n\nexport function validateExtensionApiManifestSourceMetadata(\n extension: EmbeddedExtension,\n): ExtensionApiManifestSource | null {\n const metadata: unknown = extension.source?.apiManifest;\n if (metadata === undefined) return null;\n assert(\n isObject(metadata),\n `Managed extension API manifest metadata must be an object: ${extension.id}`,\n );\n assertExactProperties(\n metadata,\n ['artifact', 'formatVersion', 'integrity', 'path'],\n `Managed extension API manifest metadata for ${extension.id}`,\n );\n assert(\n metadata.formatVersion === extensionApiManifestFormatVersion,\n `Managed extension ${extension.id} requires API manifest formatVersion ${extensionApiManifestFormatVersion}.`,\n );\n const artifact = assertNonEmptyString(\n metadata.artifact,\n `Managed extension ${extension.id} API manifest artifact`,\n );\n validateArchiveEntryName(artifact);\n assert(\n !artifact.endsWith('/'),\n `Managed extension API manifest artifact must be a file: ${artifact}`,\n );\n const expectedPath = extensionApiManifestLocalPath(extension.id);\n assert(\n metadata.path === expectedPath,\n `Managed extension API manifest path must match its ID: expected ${expectedPath}, got ${metadata.path}`,\n );\n assert(\n typeof metadata.integrity === 'string' &&\n /^sha256-[A-Za-z0-9+/]{43}=$/u.test(metadata.integrity),\n `Managed extension ${extension.id} API manifest requires SHA-256 integrity.`,\n );\n return metadata as unknown as ExtensionApiManifestSource;\n}\n\nfunction normalizeArgument(\n value: unknown,\n blockOpcode: string,\n index: number,\n menuIds: Set<string>,\n): ExtensionApiManifestArgument {\n assert(isObject(value), `API manifest block ${blockOpcode} argument ${index} must be an object.`);\n assertExactProperties(\n value,\n ['id', 'menu', 'type'],\n `API manifest block ${blockOpcode} argument ${index}`,\n );\n const id = assertNonEmptyString(\n value.id,\n `API manifest block ${blockOpcode} argument ${index} ID`,\n );\n const type = assertNonEmptyString(\n value.type,\n `API manifest block ${blockOpcode} argument ${id} type`,\n );\n if (value.menu === undefined) {\n return {id, type};\n }\n const menu = assertNonEmptyString(\n value.menu,\n `API manifest block ${blockOpcode} argument ${id} menu`,\n );\n assert(\n menuIds.has(menu),\n `API manifest block ${blockOpcode} argument ${id} references unknown menu: ${menu}`,\n );\n return {id, menu, type};\n}\n\nfunction normalizeBlock(\n value: unknown,\n index: number,\n menuIds: Set<string>,\n): ExtensionApiManifestBlock {\n assert(isObject(value), `API manifest block ${index} must be an object.`);\n assertExactProperties(value, ['arguments', 'blockType', 'opcode'], `API manifest block ${index}`);\n const opcode = assertNonEmptyString(value.opcode, `API manifest block ${index} opcode`);\n const blockType = assertNonEmptyString(value.blockType, `API manifest block ${opcode} blockType`);\n assert(\n Array.isArray(value.arguments),\n `API manifest block ${opcode} arguments must be an array.`,\n );\n const arguments_ = (value.arguments as unknown[]).map((argument, argumentIndex) =>\n normalizeArgument(argument, opcode, argumentIndex, menuIds),\n );\n const argumentIds = new Set<string>();\n for (const argument of arguments_) {\n assert(\n !argumentIds.has(argument.id),\n `API manifest block ${opcode} has duplicate argument ID: ${argument.id}`,\n );\n argumentIds.add(argument.id);\n }\n arguments_.sort((left, right) => compareIds(left.id, right.id));\n return {arguments: arguments_, blockType, opcode};\n}\n\nfunction normalizeMenu(value: unknown, index: number): ExtensionApiManifestMenu {\n assert(isObject(value), `API manifest menu ${index} must be an object.`);\n assertExactProperties(value, ['acceptReporters', 'id'], `API manifest menu ${index}`);\n const id = assertNonEmptyString(value.id, `API manifest menu ${index} ID`);\n assert(\n typeof value.acceptReporters === 'boolean',\n `API manifest menu ${id} acceptReporters must be a boolean.`,\n );\n return {acceptReporters: value.acceptReporters, id};\n}\n\nexport function parseExtensionApiManifest(\n contents: Uint8Array | string,\n {expectedId}: {expectedId?: string} = {},\n): ExtensionApiManifest {\n let manifest: unknown;\n try {\n manifest = JSON.parse(Buffer.from(contents).toString('utf8'));\n } catch (error) {\n throw new Error(`Extension API manifest is not valid JSON: ${errorMessage(error)}`, {\n cause: error,\n });\n }\n assert(isObject(manifest), 'Extension API manifest must contain an object.');\n assertExactProperties(\n manifest,\n ['blocks', 'formatVersion', 'id', 'menus'],\n 'Extension API manifest',\n );\n assert(\n manifest.formatVersion === extensionApiManifestFormatVersion,\n `Unsupported extension API manifest formatVersion: ${manifest.formatVersion}`,\n );\n assert(\n typeof manifest.id === 'string' && /^[a-z0-9]+$/u.test(manifest.id),\n `Invalid extension API manifest ID: ${JSON.stringify(manifest.id)}`,\n );\n if (expectedId !== undefined) {\n assert(\n manifest.id === expectedId,\n `Extension API manifest ID mismatch: expected ${expectedId}, got ${manifest.id}`,\n );\n }\n assert(Array.isArray(manifest.menus), 'Extension API manifest menus must be an array.');\n const menus = (manifest.menus as unknown[]).map(normalizeMenu);\n const menuIds = new Set<string>();\n for (const menu of menus) {\n assert(!menuIds.has(menu.id), `Extension API manifest has duplicate menu ID: ${menu.id}`);\n menuIds.add(menu.id);\n }\n assert(Array.isArray(manifest.blocks), 'Extension API manifest blocks must be an array.');\n const blocks = (manifest.blocks as unknown[]).map((block, index) =>\n normalizeBlock(block, index, menuIds),\n );\n const blockOpcodes = new Set<string>();\n for (const block of blocks) {\n assert(\n !blockOpcodes.has(block.opcode),\n `Extension API manifest has duplicate block opcode: ${block.opcode}`,\n );\n blockOpcodes.add(block.opcode);\n }\n blocks.sort((left, right) => compareIds(left.opcode, right.opcode));\n menus.sort((left, right) => compareIds(left.id, right.id));\n return {blocks, formatVersion: extensionApiManifestFormatVersion, id: manifest.id, menus};\n}\n\nexport function validateManagedExtensionApiManifest(\n extension: EmbeddedExtension,\n contents: Uint8Array | string,\n {expectedId = extension.id}: {expectedId?: string} = {},\n): ValidatedExtensionApiManifest | null {\n const metadata = validateExtensionApiManifestSourceMetadata(extension);\n if (!metadata) return null;\n const actualIntegrity = extensionApiManifestIntegrity(contents);\n assert(\n actualIntegrity === metadata.integrity,\n `Managed extension API manifest integrity mismatch for ${extension.id}: ` +\n `expected ${metadata.integrity}, got ${actualIntegrity}`,\n );\n const manifest = parseExtensionApiManifest(contents, {expectedId});\n assert(\n manifest.formatVersion === metadata.formatVersion,\n `Managed extension API manifest version mismatch for ${extension.id}.`,\n );\n return {integrity: actualIntegrity, manifest, metadata};\n}\n\nfunction addChange(\n changes: ExtensionApiCompatibilityChange[],\n kind: string,\n path: string,\n before: unknown,\n after: unknown,\n breaking: boolean,\n): void {\n changes.push({after, before, breaking, kind, path});\n}\n\nexport function compareExtensionApiManifests(\n installed: ExtensionApiManifest,\n candidate: ExtensionApiManifest,\n): ExtensionApiCompatibilityChange[] {\n const changes: ExtensionApiCompatibilityChange[] = [];\n const installedBlocks = new Map(installed.blocks.map((block) => [block.opcode, block]));\n const candidateBlocks = new Map(candidate.blocks.map((block) => [block.opcode, block]));\n for (const [opcode, block] of installedBlocks) {\n const path = `/blocks/${escapeJsonPointer(opcode)}`;\n const replacement = candidateBlocks.get(opcode);\n if (!replacement) {\n addChange(changes, 'block-removed', path, block, null, true);\n continue;\n }\n if (block.blockType !== replacement.blockType) {\n addChange(\n changes,\n 'block-type-changed',\n `${path}/blockType`,\n block.blockType,\n replacement.blockType,\n true,\n );\n }\n const installedArguments = new Map(block.arguments.map((argument) => [argument.id, argument]));\n const candidateArguments = new Map(\n replacement.arguments.map((argument) => [argument.id, argument]),\n );\n for (const [argumentId, argument] of installedArguments) {\n const argumentPath = `${path}/arguments/${escapeJsonPointer(argumentId)}`;\n const replacementArgument = candidateArguments.get(argumentId);\n if (!replacementArgument) {\n addChange(changes, 'argument-removed', argumentPath, argument, null, true);\n continue;\n }\n for (const property of ['type', 'menu'] as const) {\n if (argument[property] !== replacementArgument[property]) {\n addChange(\n changes,\n `argument-${property}-changed`,\n `${argumentPath}/${property}`,\n argument[property] ?? null,\n replacementArgument[property] ?? null,\n true,\n );\n }\n }\n }\n for (const [argumentId, argument] of candidateArguments) {\n if (!installedArguments.has(argumentId)) {\n addChange(\n changes,\n 'argument-added',\n `${path}/arguments/${escapeJsonPointer(argumentId)}`,\n null,\n argument,\n true,\n );\n }\n }\n }\n for (const [opcode, block] of candidateBlocks) {\n if (!installedBlocks.has(opcode)) {\n addChange(changes, 'block-added', `/blocks/${escapeJsonPointer(opcode)}`, null, block, false);\n }\n }\n\n const installedMenus = new Map(installed.menus.map((menu) => [menu.id, menu]));\n const candidateMenus = new Map(candidate.menus.map((menu) => [menu.id, menu]));\n const referencedInstalledMenus = new Set<string>();\n for (const block of installed.blocks) {\n for (const argument of block.arguments) {\n if (argument.menu !== undefined) referencedInstalledMenus.add(argument.menu);\n }\n }\n for (const [menuId, menu] of installedMenus) {\n const path = `/menus/${escapeJsonPointer(menuId)}`;\n const replacement = candidateMenus.get(menuId);\n if (!replacement) {\n addChange(changes, 'menu-removed', path, menu, null, referencedInstalledMenus.has(menuId));\n } else if (menu.acceptReporters !== replacement.acceptReporters) {\n addChange(\n changes,\n 'menu-accept-reporters-changed',\n `${path}/acceptReporters`,\n menu.acceptReporters,\n replacement.acceptReporters,\n true,\n );\n }\n }\n for (const [menuId, menu] of candidateMenus) {\n if (!installedMenus.has(menuId)) {\n addChange(changes, 'menu-added', `/menus/${escapeJsonPointer(menuId)}`, null, menu, false);\n }\n }\n return changes.sort((left, right) =>\n left.path === right.path\n ? compareIds(left.kind, right.kind)\n : compareIds(left.path, right.path),\n );\n}\n\nexport function formatExtensionApiCompatibilityChanges(\n extensionId: string,\n changes: ExtensionApiCompatibilityChange[],\n): string {\n return changes\n .map(\n (change) =>\n `${extensionId} ${change.breaking ? 'breaking' : 'compatible'} ${change.kind} ${change.path}`,\n )\n .join('\\n');\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
interface RestoreCounts {
|
|
2
|
+
extensionStorage: number;
|
|
3
|
+
extensionUrls: number;
|
|
4
|
+
opcodes: number;
|
|
5
|
+
projectExtensions: number;
|
|
6
|
+
}
|
|
7
|
+
export interface BundledSb3UnbundleOptions {
|
|
8
|
+
bundleId: string;
|
|
9
|
+
inputPath: string;
|
|
10
|
+
outputPath: string;
|
|
11
|
+
yes?: boolean;
|
|
12
|
+
}
|
|
13
|
+
export interface BundledSb3UnbundlePlan {
|
|
14
|
+
bundleId: string;
|
|
15
|
+
counts: RestoreCounts;
|
|
16
|
+
entryCount: number;
|
|
17
|
+
inputPath: string;
|
|
18
|
+
members: string[];
|
|
19
|
+
outputPath: string;
|
|
20
|
+
}
|
|
21
|
+
export declare function planBundledSb3Unbundle(options: Omit<BundledSb3UnbundleOptions, 'yes'>): Promise<BundledSb3UnbundlePlan & {
|
|
22
|
+
applied: boolean;
|
|
23
|
+
changed: boolean;
|
|
24
|
+
}>;
|
|
25
|
+
export declare function unbundleSb3({ bundleId, inputPath, outputPath, yes, }: BundledSb3UnbundleOptions): Promise<{
|
|
26
|
+
changed: boolean;
|
|
27
|
+
outputPath: string;
|
|
28
|
+
rollbackCleanupWarning: string | null;
|
|
29
|
+
bundleId: string;
|
|
30
|
+
counts: RestoreCounts;
|
|
31
|
+
entryCount: number;
|
|
32
|
+
inputPath: string;
|
|
33
|
+
members: string[];
|
|
34
|
+
applied: boolean;
|
|
35
|
+
}>;
|
|
36
|
+
export {};
|
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
import { assert, errorMessage } from "./assert.js";
|
|
2
|
+
import { validateArchiveEntryName } from "./archive.js";
|
|
3
|
+
import { extensionHeaderMetadata } from "./extension-dependencies.js";
|
|
4
|
+
import { extensionBundleRecoveryMarker } from "./extension-bundle.js";
|
|
5
|
+
import { fixedZipTimestamp } from "./source.js";
|
|
6
|
+
import { writeSb3Archive } from "./build.js";
|
|
7
|
+
import { decodeExtensionDataUrl } from "./import.js";
|
|
8
|
+
import path from "node:path";
|
|
9
|
+
import { lstat, readFile } from "node:fs/promises";
|
|
10
|
+
import { strFromU8, strToU8, unzipSync, zipSync } from "fflate";
|
|
11
|
+
//#region src/extension-bundle-archive.ts
|
|
12
|
+
function isObject(value) {
|
|
13
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
14
|
+
}
|
|
15
|
+
function arraysEqual(left, right) {
|
|
16
|
+
return JSON.stringify(left) === JSON.stringify(right);
|
|
17
|
+
}
|
|
18
|
+
function validateId(id, description) {
|
|
19
|
+
assert(typeof id === "string" && /^[a-z0-9]+$/u.test(id), `${description} must use TurboWarp's [a-z0-9]+ format: ${JSON.stringify(id)}`);
|
|
20
|
+
return id;
|
|
21
|
+
}
|
|
22
|
+
function decodeBase64Json(payload, description) {
|
|
23
|
+
assert(typeof payload === "string" && /^[A-Za-z0-9+/]*={0,2}$/u.test(payload), `${description} contains invalid base64.`);
|
|
24
|
+
const unpadded = payload.replace(/=+$/u, "");
|
|
25
|
+
assert(unpadded.length % 4 !== 1, `${description} contains invalid base64.`);
|
|
26
|
+
try {
|
|
27
|
+
return JSON.parse(Buffer.from(unpadded.padEnd(Math.ceil(unpadded.length / 4) * 4, "="), "base64").toString("utf8"));
|
|
28
|
+
} catch (error) {
|
|
29
|
+
throw new Error(`${description} contains invalid JSON: ${errorMessage(error)}`, { cause: error });
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
function recoveryPayloadFromSource(source, requiredBundleId = void 0) {
|
|
33
|
+
const prefix = `// ${extensionBundleRecoveryMarker}: `;
|
|
34
|
+
const payloads = source.split(/\r?\n/u).filter((line) => line.startsWith(prefix)).map((line) => line.slice(prefix.length));
|
|
35
|
+
if (payloads.length === 0) {
|
|
36
|
+
assert(requiredBundleId === void 0, `Extension ${requiredBundleId} has no ${extensionBundleRecoveryMarker} recovery capsule.`);
|
|
37
|
+
return null;
|
|
38
|
+
}
|
|
39
|
+
assert(payloads.length === 1, "Bundled extension contains more than one recovery capsule.");
|
|
40
|
+
return payloads[0];
|
|
41
|
+
}
|
|
42
|
+
function validateOriginalOrder(value, description, nullable = false) {
|
|
43
|
+
if (nullable && value === null) return null;
|
|
44
|
+
assert(Array.isArray(value) && value.every((id) => typeof id === "string" && id.length > 0), `Recovery capsule ${description} must be an array of IDs${nullable ? " or null" : ""}.`);
|
|
45
|
+
const ids = value;
|
|
46
|
+
assert(new Set(ids).size === ids.length, `Recovery capsule ${description} contains duplicate IDs.`);
|
|
47
|
+
return [...ids];
|
|
48
|
+
}
|
|
49
|
+
function readRecoveryCapsule(extensionId, dataUrl, required = false) {
|
|
50
|
+
assert(typeof dataUrl === "string", `Extension URL for ${extensionId} must be a string.`);
|
|
51
|
+
if (!dataUrl.startsWith("data:")) {
|
|
52
|
+
assert(!required, `Extension ${extensionId} is not embedded as a data URL.`);
|
|
53
|
+
return null;
|
|
54
|
+
}
|
|
55
|
+
const decodedBundle = decodeExtensionDataUrl(dataUrl);
|
|
56
|
+
const payload = recoveryPayloadFromSource(Buffer.from(decodedBundle.source).toString("utf8"), required ? extensionId : void 0);
|
|
57
|
+
if (payload === null) return null;
|
|
58
|
+
const capsule = decodeBase64Json(payload, `Extension ${extensionId} recovery capsule`);
|
|
59
|
+
assert(isObject(capsule), `Extension ${extensionId} recovery capsule must be an object.`);
|
|
60
|
+
assert(capsule.formatVersion === 1, `Unsupported extension bundle recovery format: ${capsule.formatVersion}`);
|
|
61
|
+
assert(isObject(capsule.bundle), `Extension ${extensionId} recovery capsule has no bundle.`);
|
|
62
|
+
const bundle = capsule.bundle;
|
|
63
|
+
const bundleId = validateId(bundle.id, "Recovery capsule bundle ID");
|
|
64
|
+
assert(bundleId === extensionId, `Recovery capsule bundle ID mismatch: expected ${extensionId}, got ${bundleId}.`);
|
|
65
|
+
assert(typeof bundle.name === "string" && bundle.name.length > 0, `Recovery capsule for ${extensionId} has no bundle name.`);
|
|
66
|
+
const bundleName = bundle.name;
|
|
67
|
+
assert(Array.isArray(capsule.components) && capsule.components.length >= 2, `Recovery capsule for ${extensionId} must contain at least two components.`);
|
|
68
|
+
const seenIds = /* @__PURE__ */ new Set();
|
|
69
|
+
const components = capsule.components.map((component, index) => {
|
|
70
|
+
assert(isObject(component), `Recovery component ${index} for ${extensionId} must be an object.`);
|
|
71
|
+
const componentId = validateId(component.id, `Recovery component ${index} ID`);
|
|
72
|
+
assert(!seenIds.has(componentId), `Recovery capsule repeats component: ${componentId}`);
|
|
73
|
+
seenIds.add(componentId);
|
|
74
|
+
const decoded = decodeExtensionDataUrl(component.dataUrl);
|
|
75
|
+
assert(decoded.mediaType === "text/javascript" || decoded.mediaType === "application/javascript", `Recovery component ${componentId} must contain JavaScript.`);
|
|
76
|
+
const metadata = extensionHeaderMetadata(decoded.source);
|
|
77
|
+
assert(metadata.id === componentId, `Recovery component header ID mismatch: expected ${componentId}, got ${metadata.id ?? "(missing)"}.`);
|
|
78
|
+
return {
|
|
79
|
+
dataUrl: component.dataUrl,
|
|
80
|
+
id: componentId
|
|
81
|
+
};
|
|
82
|
+
});
|
|
83
|
+
return {
|
|
84
|
+
bundle: {
|
|
85
|
+
id: bundleId,
|
|
86
|
+
name: bundleName
|
|
87
|
+
},
|
|
88
|
+
components,
|
|
89
|
+
members: components.map((component) => component.id),
|
|
90
|
+
originalExtensionIds: validateOriginalOrder(capsule.originalExtensionIds, "originalExtensionIds", true),
|
|
91
|
+
originalExtensionUrlIds: validateOriginalOrder(capsule.originalExtensionUrlIds, "originalExtensionUrlIds")
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
function collapseOrder(originalIds, bundles) {
|
|
95
|
+
const bundlesByMember = /* @__PURE__ */ new Map();
|
|
96
|
+
for (const bundle of bundles) for (const memberId of bundle.members) {
|
|
97
|
+
assert(!bundlesByMember.has(memberId), `Active extension bundles overlap at member: ${memberId}`);
|
|
98
|
+
bundlesByMember.set(memberId, bundle.bundle.id);
|
|
99
|
+
}
|
|
100
|
+
const emittedBundles = /* @__PURE__ */ new Set();
|
|
101
|
+
const output = [];
|
|
102
|
+
for (const id of originalIds) {
|
|
103
|
+
const bundleId = bundlesByMember.get(id);
|
|
104
|
+
if (!bundleId) output.push(id);
|
|
105
|
+
else if (!emittedBundles.has(bundleId)) {
|
|
106
|
+
emittedBundles.add(bundleId);
|
|
107
|
+
output.push(bundleId);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
return output;
|
|
111
|
+
}
|
|
112
|
+
function replaceBundledStorage(storage, target, counts) {
|
|
113
|
+
if (!isObject(storage) || !Object.hasOwn(storage, target.bundle.id)) return storage;
|
|
114
|
+
const bundleStorage = storage[target.bundle.id];
|
|
115
|
+
assert(isObject(bundleStorage) && bundleStorage.formatVersion === 1 && isObject(bundleStorage.components), `Extension storage for ${target.bundle.id} is not a reversible format 1 bundle.`);
|
|
116
|
+
assert(Object.keys(bundleStorage).every((key) => key === "formatVersion" || key === "components"), `Extension storage for ${target.bundle.id} has unsupported bundle-level fields.`);
|
|
117
|
+
const bundleComponents = bundleStorage.components;
|
|
118
|
+
const memberIds = new Set(target.members);
|
|
119
|
+
for (const componentId of Object.keys(bundleComponents)) {
|
|
120
|
+
assert(memberIds.has(componentId), `Extension storage for ${target.bundle.id} contains unknown component: ${componentId}`);
|
|
121
|
+
assert(!Object.hasOwn(storage, componentId), `Cannot restore extension storage because member ID already exists: ${componentId}`);
|
|
122
|
+
}
|
|
123
|
+
const replacement = {};
|
|
124
|
+
for (const [id, value] of Object.entries(storage)) {
|
|
125
|
+
if (id !== target.bundle.id) {
|
|
126
|
+
replacement[id] = value;
|
|
127
|
+
continue;
|
|
128
|
+
}
|
|
129
|
+
for (const memberId of target.members) if (Object.hasOwn(bundleComponents, memberId)) replacement[memberId] = bundleComponents[memberId];
|
|
130
|
+
}
|
|
131
|
+
counts.extensionStorage += 1;
|
|
132
|
+
return replacement;
|
|
133
|
+
}
|
|
134
|
+
function restoreOpcodeValues(value, target, counts) {
|
|
135
|
+
if (!value || typeof value !== "object") return;
|
|
136
|
+
if (Array.isArray(value)) {
|
|
137
|
+
for (const entry of value) restoreOpcodeValues(entry, target, counts);
|
|
138
|
+
return;
|
|
139
|
+
}
|
|
140
|
+
const record = value;
|
|
141
|
+
for (const [key, entry] of Object.entries(record)) if (key === "opcode" && typeof entry === "string") {
|
|
142
|
+
const bundlePrefix = `${target.bundle.id}_`;
|
|
143
|
+
if (!entry.startsWith(bundlePrefix)) continue;
|
|
144
|
+
const localOpcode = entry.slice(bundlePrefix.length);
|
|
145
|
+
const memberId = target.members.find((id) => localOpcode.startsWith(`${id}__`));
|
|
146
|
+
assert(memberId, `Bundle opcode cannot be assigned to a recovery component: ${entry}`);
|
|
147
|
+
record[key] = `${memberId}_${localOpcode.slice(memberId.length + 2)}`;
|
|
148
|
+
counts.opcodes += 1;
|
|
149
|
+
} else restoreOpcodeValues(entry, target, counts);
|
|
150
|
+
}
|
|
151
|
+
function collectRemainingBundleReferences(value, bundleId) {
|
|
152
|
+
const references = [];
|
|
153
|
+
const prefix = `${bundleId}_`;
|
|
154
|
+
function visit(current, pointer) {
|
|
155
|
+
if (typeof current === "string") {
|
|
156
|
+
if (current.startsWith(prefix)) references.push(pointer || "/");
|
|
157
|
+
return;
|
|
158
|
+
}
|
|
159
|
+
if (!current || typeof current !== "object") return;
|
|
160
|
+
if (Array.isArray(current)) {
|
|
161
|
+
current.forEach((entry, index) => visit(entry, `${pointer}/${index}`));
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
164
|
+
for (const [key, entry] of Object.entries(current)) visit(entry, `${pointer}/${key}`);
|
|
165
|
+
}
|
|
166
|
+
visit(value, "");
|
|
167
|
+
return references;
|
|
168
|
+
}
|
|
169
|
+
function restoreProject(project, target, activeBundles) {
|
|
170
|
+
const restored = structuredClone(project);
|
|
171
|
+
const counts = {
|
|
172
|
+
extensionStorage: 0,
|
|
173
|
+
extensionUrls: 0,
|
|
174
|
+
opcodes: 0,
|
|
175
|
+
projectExtensions: 0
|
|
176
|
+
};
|
|
177
|
+
const remainingBundles = activeBundles.filter((bundle) => bundle.bundle.id !== target.bundle.id);
|
|
178
|
+
assert(isObject(restored.extensionURLs), "SB3 project.json extensionURLs must be an object.");
|
|
179
|
+
const existingUrls = restored.extensionURLs;
|
|
180
|
+
const currentUrlIds = Object.keys(existingUrls);
|
|
181
|
+
const expectedUrlIds = collapseOrder(target.originalExtensionUrlIds, activeBundles);
|
|
182
|
+
assert(arraysEqual(currentUrlIds, expectedUrlIds), `Cannot safely restore extension URL order. Expected ${JSON.stringify(expectedUrlIds)}, got ${JSON.stringify(currentUrlIds)}.`);
|
|
183
|
+
const restoredUrlIds = collapseOrder(target.originalExtensionUrlIds, remainingBundles);
|
|
184
|
+
const componentUrls = new Map(target.components.map((component) => [component.id, component.dataUrl]));
|
|
185
|
+
restored.extensionURLs = Object.fromEntries(restoredUrlIds.map((id) => [id, componentUrls.has(id) ? componentUrls.get(id) : existingUrls[id]]));
|
|
186
|
+
counts.extensionUrls = target.members.length + 1;
|
|
187
|
+
if (target.originalExtensionIds === null) assert(restored.extensions === void 0, "Cannot safely restore project.extensions because it was added after bundling.");
|
|
188
|
+
else {
|
|
189
|
+
assert(Array.isArray(restored.extensions), "SB3 project.json extensions must be an array.");
|
|
190
|
+
const expectedIds = collapseOrder(target.originalExtensionIds, activeBundles);
|
|
191
|
+
assert(arraysEqual(restored.extensions, expectedIds), `Cannot safely restore project.extensions order. Expected ${JSON.stringify(expectedIds)}, got ${JSON.stringify(restored.extensions)}.`);
|
|
192
|
+
restored.extensions = collapseOrder(target.originalExtensionIds, remainingBundles);
|
|
193
|
+
counts.projectExtensions = target.members.length + 1;
|
|
194
|
+
}
|
|
195
|
+
restored.extensionStorage = replaceBundledStorage(restored.extensionStorage, target, counts);
|
|
196
|
+
for (const targetEntry of restored.targets ?? []) if (isObject(targetEntry)) targetEntry.extensionStorage = replaceBundledStorage(targetEntry.extensionStorage, target, counts);
|
|
197
|
+
restoreOpcodeValues(restored.targets, target, counts);
|
|
198
|
+
restoreOpcodeValues(restored.monitors, target, counts);
|
|
199
|
+
const remainingReferences = collectRemainingBundleReferences(restored, target.bundle.id);
|
|
200
|
+
assert(remainingReferences.length === 0, `Bundle ${target.bundle.id} has unsupported references at: ` + remainingReferences.slice(0, 8).join(", "));
|
|
201
|
+
return {
|
|
202
|
+
counts,
|
|
203
|
+
project: restored
|
|
204
|
+
};
|
|
205
|
+
}
|
|
206
|
+
function parseProject(projectEntry) {
|
|
207
|
+
try {
|
|
208
|
+
const project = JSON.parse(strFromU8(projectEntry));
|
|
209
|
+
assert(isObject(project), "SB3 project.json must contain an object.");
|
|
210
|
+
return project;
|
|
211
|
+
} catch (error) {
|
|
212
|
+
if (errorMessage(error) === "SB3 project.json must contain an object.") throw error;
|
|
213
|
+
throw new Error(`SB3 project.json is invalid JSON: ${errorMessage(error)}`, { cause: error });
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
async function createArchiveUnbundlePlan({ bundleId, inputPath, outputPath }) {
|
|
217
|
+
validateId(bundleId, "Extension bundle ID");
|
|
218
|
+
assert(typeof inputPath === "string", "Input SB3 path is required.");
|
|
219
|
+
assert(typeof outputPath === "string", "Unbundled SB3 output path is required.");
|
|
220
|
+
const resolvedInputPath = path.resolve(inputPath);
|
|
221
|
+
const resolvedOutputPath = path.resolve(outputPath);
|
|
222
|
+
assert(path.extname(resolvedInputPath).toLowerCase() === ".sb3", `Input path must use the .sb3 extension: ${resolvedInputPath}`);
|
|
223
|
+
assert(path.extname(resolvedOutputPath).toLowerCase() === ".sb3", `Output path must use the .sb3 extension: ${resolvedOutputPath}`);
|
|
224
|
+
const stats = await lstat(resolvedInputPath);
|
|
225
|
+
assert(stats.isFile() && !stats.isSymbolicLink(), `Input SB3 must be a regular file, not a symbolic link: ${resolvedInputPath}`);
|
|
226
|
+
const archiveEntries = unzipSync(new Uint8Array(await readFile(resolvedInputPath)));
|
|
227
|
+
const entries = Object.entries(archiveEntries);
|
|
228
|
+
assert(entries.length > 0, "SB3 archive is empty.");
|
|
229
|
+
for (const [entryName] of entries) {
|
|
230
|
+
validateArchiveEntryName(entryName);
|
|
231
|
+
assert(!/^(?:0|[1-9][0-9]*)$/u.test(entryName), `Integer-like ZIP entry names cannot preserve archive order: ${entryName}`);
|
|
232
|
+
}
|
|
233
|
+
assert(archiveEntries["project.json"], "SB3 archive does not contain project.json.");
|
|
234
|
+
const project = parseProject(archiveEntries["project.json"]);
|
|
235
|
+
assert(isObject(project.extensionURLs), "SB3 project.json extensionURLs must be an object.");
|
|
236
|
+
const activeBundles = [];
|
|
237
|
+
for (const [extensionId, dataUrl] of Object.entries(project.extensionURLs)) {
|
|
238
|
+
const recovery = readRecoveryCapsule(extensionId, dataUrl, extensionId === bundleId);
|
|
239
|
+
if (recovery) activeBundles.push(recovery);
|
|
240
|
+
}
|
|
241
|
+
const target = activeBundles.find((bundle) => bundle.bundle.id === bundleId);
|
|
242
|
+
assert(target, `Reversible extension bundle was not found: ${bundleId}`);
|
|
243
|
+
const restored = restoreProject(project, target, activeBundles);
|
|
244
|
+
const outputEntries = Object.fromEntries(entries.map(([entryName, contents]) => [entryName, entryName === "project.json" ? strToU8(`${JSON.stringify(restored.project)}\n`) : contents]));
|
|
245
|
+
return {
|
|
246
|
+
archive: zipSync(outputEntries, {
|
|
247
|
+
level: 6,
|
|
248
|
+
mtime: fixedZipTimestamp
|
|
249
|
+
}),
|
|
250
|
+
bundleId,
|
|
251
|
+
counts: restored.counts,
|
|
252
|
+
entryCount: entries.length,
|
|
253
|
+
inputPath: resolvedInputPath,
|
|
254
|
+
members: [...target.members],
|
|
255
|
+
outputPath: resolvedOutputPath
|
|
256
|
+
};
|
|
257
|
+
}
|
|
258
|
+
function publicArchivePlan(plan) {
|
|
259
|
+
return {
|
|
260
|
+
bundleId: plan.bundleId,
|
|
261
|
+
counts: plan.counts,
|
|
262
|
+
entryCount: plan.entryCount,
|
|
263
|
+
inputPath: plan.inputPath,
|
|
264
|
+
members: plan.members,
|
|
265
|
+
outputPath: plan.outputPath
|
|
266
|
+
};
|
|
267
|
+
}
|
|
268
|
+
async function planBundledSb3Unbundle(options) {
|
|
269
|
+
return {
|
|
270
|
+
applied: false,
|
|
271
|
+
changed: true,
|
|
272
|
+
...publicArchivePlan(await createArchiveUnbundlePlan(options))
|
|
273
|
+
};
|
|
274
|
+
}
|
|
275
|
+
async function unbundleSb3({ bundleId, inputPath, outputPath, yes = false }) {
|
|
276
|
+
const plan = await createArchiveUnbundlePlan({
|
|
277
|
+
bundleId,
|
|
278
|
+
inputPath,
|
|
279
|
+
outputPath
|
|
280
|
+
});
|
|
281
|
+
const publicPlan = publicArchivePlan(plan);
|
|
282
|
+
if (!yes) return {
|
|
283
|
+
applied: false,
|
|
284
|
+
changed: true,
|
|
285
|
+
...publicPlan,
|
|
286
|
+
rollbackCleanupWarning: null
|
|
287
|
+
};
|
|
288
|
+
const written = await writeSb3Archive({
|
|
289
|
+
archive: plan.archive,
|
|
290
|
+
outputPath: plan.outputPath,
|
|
291
|
+
yes
|
|
292
|
+
});
|
|
293
|
+
return {
|
|
294
|
+
applied: true,
|
|
295
|
+
...publicPlan,
|
|
296
|
+
...written
|
|
297
|
+
};
|
|
298
|
+
}
|
|
299
|
+
//#endregion
|
|
300
|
+
export { planBundledSb3Unbundle, unbundleSb3 };
|
|
301
|
+
|
|
302
|
+
//# sourceMappingURL=extension-bundle-archive.js.map
|