@kubohiroya/sb3-toolchain 0.12.0 → 0.13.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 CHANGED
@@ -1,5 +1,16 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.13.0 - 2026-09-14
4
+
5
+ - Add `tryParseExtensionApiManifest`, which returns `{manifest, error}` instead of throwing.
6
+ `parseExtensionApiManifest` aborts on the first problem, so a caller auditing several published
7
+ manifests could only report one failure per run; the new entry point lets it collect every
8
+ failure and report them together.
9
+ - Export `ExtensionApiManifestParseResult` and its `ExtensionApiManifestParseSuccess` /
10
+ `ExtensionApiManifestParseFailure` members from the package entry point.
11
+
12
+ Rollback: pin `@kubohiroya/sb3-toolchain@0.12.0`.
13
+
3
14
  ## 0.12.0 - 2026-09-10
4
15
 
5
16
  - Ignore `.claude/**` in the ESLint config: flat config does not read `.gitignore`, so `eslint .`
package/README.ja.md CHANGED
@@ -31,7 +31,7 @@ Scratch 3およびTurboWarpの`.sb3`プロジェクトを、Gitで差分を確
31
31
  再現可能なインストールのため、検証済みのnpmバージョンを固定します。
32
32
 
33
33
  ```bash
34
- pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.12.0
34
+ pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.13.0
35
35
  ```
36
36
 
37
37
  ## クイックスタート
package/README.md CHANGED
@@ -32,7 +32,7 @@ expanded sources and rebuilding bit-for-bit identical SB3 files from the same in
32
32
  Pin the verified npm version for reproducible installation.
33
33
 
34
34
  ```bash
35
- pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.12.0
35
+ pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.13.0
36
36
  ```
37
37
 
38
38
  ## Quick start
package/dist/bin.js CHANGED
File without changes
@@ -1,2 +1,2 @@
1
1
  export declare const packageName = "@kubohiroya/sb3-toolchain";
2
- export declare const packageVersion = "0.12.0";
2
+ export declare const packageVersion = "0.13.0";
package/dist/constants.js CHANGED
@@ -1,6 +1,6 @@
1
1
  //#region src/constants.ts
2
2
  var packageName = "@kubohiroya/sb3-toolchain";
3
- var packageVersion = "0.12.0";
3
+ var packageVersion = "0.13.0";
4
4
  //#endregion
5
5
  export { packageName, packageVersion };
6
6
 
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nexport const packageName = '@kubohiroya/sb3-toolchain';\nexport const packageVersion = '0.12.0';\n"],"mappings":";AAEA,IAAa,cAAc;AAC3B,IAAa,iBAAiB"}
1
+ {"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nexport const packageName = '@kubohiroya/sb3-toolchain';\nexport const packageVersion = '0.13.0';\n"],"mappings":";AAEA,IAAa,cAAc;AAC3B,IAAa,iBAAiB"}
@@ -33,12 +33,31 @@ export interface ValidatedExtensionApiManifest {
33
33
  manifest: ExtensionApiManifest;
34
34
  metadata: ExtensionApiManifestSource;
35
35
  }
36
+ export interface ExtensionApiManifestParseSuccess {
37
+ error: null;
38
+ manifest: ExtensionApiManifest;
39
+ }
40
+ export interface ExtensionApiManifestParseFailure {
41
+ error: string;
42
+ manifest: null;
43
+ }
44
+ export type ExtensionApiManifestParseResult = ExtensionApiManifestParseSuccess | ExtensionApiManifestParseFailure;
36
45
  export declare function extensionApiManifestIntegrity(contents: Uint8Array | string): string;
37
46
  export declare function extensionApiManifestLocalPath(extensionId: string): string;
38
47
  export declare function validateExtensionApiManifestSourceMetadata(extension: EmbeddedExtension): ExtensionApiManifestSource | null;
39
48
  export declare function parseExtensionApiManifest(contents: Uint8Array | string, { expectedId }?: {
40
49
  expectedId?: string;
41
50
  }): ExtensionApiManifest;
51
+ /**
52
+ * Parse an extension API manifest without throwing.
53
+ *
54
+ * `parseExtensionApiManifest` aborts on the first problem, which suits callers
55
+ * that treat an invalid manifest as fatal. Callers that audit several manifests
56
+ * and report every failure together need the error as a value instead.
57
+ */
58
+ export declare function tryParseExtensionApiManifest(contents: Uint8Array | string, options?: {
59
+ expectedId?: string;
60
+ }): ExtensionApiManifestParseResult;
42
61
  export declare function validateManagedExtensionApiManifest(extension: EmbeddedExtension, contents: Uint8Array | string, { expectedId }?: {
43
62
  expectedId?: string;
44
63
  }): ValidatedExtensionApiManifest | null;
@@ -141,6 +141,26 @@ function parseExtensionApiManifest(contents, { expectedId } = {}) {
141
141
  menus
142
142
  };
143
143
  }
144
+ /**
145
+ * Parse an extension API manifest without throwing.
146
+ *
147
+ * `parseExtensionApiManifest` aborts on the first problem, which suits callers
148
+ * that treat an invalid manifest as fatal. Callers that audit several manifests
149
+ * and report every failure together need the error as a value instead.
150
+ */
151
+ function tryParseExtensionApiManifest(contents, options = {}) {
152
+ try {
153
+ return {
154
+ error: null,
155
+ manifest: parseExtensionApiManifest(contents, options)
156
+ };
157
+ } catch (error) {
158
+ return {
159
+ error: errorMessage(error),
160
+ manifest: null
161
+ };
162
+ }
163
+ }
144
164
  function validateManagedExtensionApiManifest(extension, contents, { expectedId = extension.id } = {}) {
145
165
  const metadata = validateExtensionApiManifestSourceMetadata(extension);
146
166
  if (!metadata) return null;
@@ -206,6 +226,6 @@ function formatExtensionApiCompatibilityChanges(extensionId, changes) {
206
226
  return changes.map((change) => `${extensionId} ${change.breaking ? "breaking" : "compatible"} ${change.kind} ${change.path}`).join("\n");
207
227
  }
208
228
  //#endregion
209
- export { compareExtensionApiManifests, defaultExtensionApiManifestSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, formatExtensionApiCompatibilityChanges, parseExtensionApiManifest, validateExtensionApiManifestSourceMetadata, validateManagedExtensionApiManifest };
229
+ export { compareExtensionApiManifests, defaultExtensionApiManifestSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, formatExtensionApiCompatibilityChanges, parseExtensionApiManifest, tryParseExtensionApiManifest, validateExtensionApiManifestSourceMetadata, validateManagedExtensionApiManifest };
210
230
 
211
231
  //# sourceMappingURL=extension-api-manifest.js.map
@@ -1 +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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"}
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\nexport interface ExtensionApiManifestParseSuccess {\n error: null;\n manifest: ExtensionApiManifest;\n}\n\nexport interface ExtensionApiManifestParseFailure {\n error: string;\n manifest: null;\n}\n\nexport type ExtensionApiManifestParseResult =\n ExtensionApiManifestParseSuccess | ExtensionApiManifestParseFailure;\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\n/**\n * Parse an extension API manifest without throwing.\n *\n * `parseExtensionApiManifest` aborts on the first problem, which suits callers\n * that treat an invalid manifest as fatal. Callers that audit several manifests\n * and report every failure together need the error as a value instead.\n */\nexport function tryParseExtensionApiManifest(\n contents: Uint8Array | string,\n options: {expectedId?: string} = {},\n): ExtensionApiManifestParseResult {\n try {\n return {error: null, manifest: parseExtensionApiManifest(contents, options)};\n } catch (error) {\n return {error: errorMessage(error), manifest: null};\n }\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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"}
package/dist/index.d.ts CHANGED
@@ -4,7 +4,7 @@ export { validateArchiveEntryName } from './archive';
4
4
  export { buildSb3 } from './build';
5
5
  export { packageName, packageVersion } from './constants';
6
6
  export { extensionHeaderId, extensionHeaderMetadata, extensionIntegrity, validateExtensionSourceMetadata, validateManagedExtensionContents, } from './extension-dependencies';
7
- export { compareExtensionApiManifests, defaultExtensionApiManifestSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, formatExtensionApiCompatibilityChanges, parseExtensionApiManifest, validateExtensionApiManifestSourceMetadata, validateManagedExtensionApiManifest, } from './extension-api-manifest';
7
+ export { compareExtensionApiManifests, defaultExtensionApiManifestSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, formatExtensionApiCompatibilityChanges, parseExtensionApiManifest, tryParseExtensionApiManifest, validateExtensionApiManifestSourceMetadata, validateManagedExtensionApiManifest, } from './extension-api-manifest';
8
8
  export { bundleExtensions, planExtensionBundle, planExtensionUnbundle, unbundleExtensions, } from './extension-bundle-configuration';
9
9
  export { planBundledSb3Unbundle, unbundleSb3 } from './extension-bundle-archive';
10
10
  export { buildExtensionBundles, createStaticExtensionBundle, extensionBundleRecoveryMarker, validateExtensionBundleConfigurations, } from './extension-bundle';
@@ -18,7 +18,7 @@ export { assertSb3ReleaseSnapshotMetadata, computeReleaseSourceIdentity, createS
18
18
  export { cleanUpTurboWarpBlocks, turboWarpCleanUpLayout } from './turbowarp-clean-up';
19
19
  export type { BuildSb3Options, WriteSb3ArchiveOptions, WriteSb3ArchiveResult } from './build';
20
20
  export type { CliOptions } from './cli';
21
- export type { ExtensionApiCompatibilityChange, ExtensionApiManifest, ExtensionApiManifestArgument, ExtensionApiManifestBlock, ExtensionApiManifestMenu, } from './extension-api-manifest';
21
+ export type { ExtensionApiCompatibilityChange, ExtensionApiManifest, ExtensionApiManifestArgument, ExtensionApiManifestBlock, ExtensionApiManifestMenu, ExtensionApiManifestParseFailure, ExtensionApiManifestParseResult, ExtensionApiManifestParseSuccess, } from './extension-api-manifest';
22
22
  export type { BuildExtensionBundlesResult, ExtensionBundleComponent, ExtensionBundleCounts, ExtensionBundlePlan, } from './extension-bundle';
23
23
  export type { BundledSb3UnbundlePlan } from './extension-bundle-archive';
24
24
  export type { ExtensionIdMigrationCounts, ExtensionIdReference, RewriteExtensionIdDocumentsResult, } from './extension-id-migration';
package/dist/index.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { assert } from "./assert.js";
2
2
  import { compareDirectories, inspectGitOutputState, validateOutputDirectoryPath } from "./output-safety.js";
3
3
  import { validateArchiveEntryName } from "./archive.js";
4
- import { compareExtensionApiManifests, defaultExtensionApiManifestSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, formatExtensionApiCompatibilityChanges, parseExtensionApiManifest, validateExtensionApiManifestSourceMetadata, validateManagedExtensionApiManifest } from "./extension-api-manifest.js";
4
+ import { compareExtensionApiManifests, defaultExtensionApiManifestSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, formatExtensionApiCompatibilityChanges, parseExtensionApiManifest, tryParseExtensionApiManifest, validateExtensionApiManifestSourceMetadata, validateManagedExtensionApiManifest } from "./extension-api-manifest.js";
5
5
  import { extensionHeaderId, extensionHeaderMetadata, extensionIntegrity, validateExtensionSourceMetadata, validateManagedExtensionContents } from "./extension-dependencies.js";
6
6
  import { buildExtensionBundles, createStaticExtensionBundle, extensionBundleRecoveryMarker, validateExtensionBundleConfigurations } from "./extension-bundle.js";
7
7
  import { applyProjectAssetAdditions, projectAssetAdditionsFormatVersion } from "./project-asset-additions.js";
@@ -15,4 +15,4 @@ import { bundleExtensions, planExtensionBundle, planExtensionUnbundle, unbundleE
15
15
  import { migrateExtensionId, planExtensionIdMigration, validateNewExtensionId } from "./extension-id-migration.js";
16
16
  import { defaultExtensionArtifactSizeLimit, extensionStatus, syncExtensions, updateExtensions } from "./extension-sync.js";
17
17
  import { assertSb3ReleaseSnapshotMetadata, computeReleaseSourceIdentity, createSb3ReleaseSnapshot, createSb3ReleaseSnapshotMetadata, freezeSb3ReleaseSnapshot, readSb3ReleaseSnapshotMetadata, recordPublishedSb3ReleaseSnapshot, verifySb3ReleaseSnapshot, writeSb3ReleaseCandidate } from "./release-snapshot.js";
18
- export { applyProjectAssetAdditions, assert, assertSb3ReleaseSnapshotMetadata, buildExtensionBundles, buildSb3, bundleExtensions, cleanUpTurboWarpBlocks, compareDirectories, compareExtensionApiManifests, computeReleaseSourceIdentity, createDeterministicSb3, createSb3ReleaseSnapshot, createSb3ReleaseSnapshotMetadata, createStaticExtensionBundle, decodeExtensionDataUrl, defaultExtensionApiManifestSizeLimit, defaultExtensionArtifactSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, extensionBundleRecoveryMarker, extensionHeaderId, extensionHeaderMetadata, extensionIntegrity, extensionStatus, fixedZipTimestamp, formatExtensionApiCompatibilityChanges, freezeSb3ReleaseSnapshot, importSb3, inspectGitOutputState, migrateExtensionId, packageName, packageVersion, parseExtensionApiManifest, planBundledSb3Unbundle, planExtensionBundle, planExtensionIdMigration, planExtensionUnbundle, projectAssetAdditionsFormatVersion, readSb3ReleaseSnapshotMetadata, recordPublishedSb3ReleaseSnapshot, sourceFormatVersion, syncExtensions, turboWarpCleanUpLayout, unbundleExtensions, unbundleSb3, updateExtensions, validateArchiveEntryName, validateExtensionApiManifestSourceMetadata, validateExtensionBundleConfigurations, validateExtensionSourceMetadata, validateManagedExtensionApiManifest, validateManagedExtensionContents, validateNewExtensionId, validateOutputDirectoryPath, validateSb3Source, verifySb3ReleaseSnapshot, writeSb3ReleaseCandidate };
18
+ export { applyProjectAssetAdditions, assert, assertSb3ReleaseSnapshotMetadata, buildExtensionBundles, buildSb3, bundleExtensions, cleanUpTurboWarpBlocks, compareDirectories, compareExtensionApiManifests, computeReleaseSourceIdentity, createDeterministicSb3, createSb3ReleaseSnapshot, createSb3ReleaseSnapshotMetadata, createStaticExtensionBundle, decodeExtensionDataUrl, defaultExtensionApiManifestSizeLimit, defaultExtensionArtifactSizeLimit, extensionApiManifestFormatVersion, extensionApiManifestIntegrity, extensionApiManifestLocalPath, extensionBundleRecoveryMarker, extensionHeaderId, extensionHeaderMetadata, extensionIntegrity, extensionStatus, fixedZipTimestamp, formatExtensionApiCompatibilityChanges, freezeSb3ReleaseSnapshot, importSb3, inspectGitOutputState, migrateExtensionId, packageName, packageVersion, parseExtensionApiManifest, planBundledSb3Unbundle, planExtensionBundle, planExtensionIdMigration, planExtensionUnbundle, projectAssetAdditionsFormatVersion, readSb3ReleaseSnapshotMetadata, recordPublishedSb3ReleaseSnapshot, sourceFormatVersion, syncExtensions, tryParseExtensionApiManifest, turboWarpCleanUpLayout, unbundleExtensions, unbundleSb3, updateExtensions, validateArchiveEntryName, validateExtensionApiManifestSourceMetadata, validateExtensionBundleConfigurations, validateExtensionSourceMetadata, validateManagedExtensionApiManifest, validateManagedExtensionContents, validateNewExtensionId, validateOutputDirectoryPath, validateSb3Source, verifySb3ReleaseSnapshot, writeSb3ReleaseCandidate };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kubohiroya/sb3-toolchain",
3
- "version": "0.12.0",
3
+ "version": "0.13.0",
4
4
  "description": "Git-friendly source management and deterministic builds for Scratch 3 and TurboWarp SB3 projects",
5
5
  "type": "module",
6
6
  "license": "MPL-2.0",
@@ -36,6 +36,21 @@
36
36
  "access": "public",
37
37
  "registry": "https://registry.npmjs.org/"
38
38
  },
39
+ "packageManager": "pnpm@11.11.0",
40
+ "scripts": {
41
+ "build": "vite build",
42
+ "lint": "eslint .",
43
+ "format": "prettier --check .github docs scripts src test CHANGELOG.md eslint.config.ts package.json README.md README.ja.md repo-policy.json tsconfig.json vite.config.ts",
44
+ "format:write": "prettier --write .github docs scripts src test CHANGELOG.md eslint.config.ts package.json README.md README.ja.md repo-policy.json tsconfig.json vite.config.ts",
45
+ "typecheck": "tsc --project tsconfig.json",
46
+ "test": "vitest run",
47
+ "test:watch": "vitest",
48
+ "pack:check": "npm pack --dry-run --ignore-scripts",
49
+ "release:check": "npm publish --dry-run --access public",
50
+ "repo:check": "node --experimental-strip-types scripts/check-repo.ts",
51
+ "check": "pnpm run lint && pnpm run format && pnpm run typecheck && pnpm run test && pnpm run build && pnpm run repo:check && pnpm run pack:check",
52
+ "prepack": "pnpm run check"
53
+ },
39
54
  "dependencies": {
40
55
  "fflate": "0.8.3",
41
56
  "music-metadata": "11.14.0",
@@ -62,18 +77,5 @@
62
77
  "turbowarp",
63
78
  "source-control",
64
79
  "reproducible-builds"
65
- ],
66
- "scripts": {
67
- "build": "vite build",
68
- "lint": "eslint .",
69
- "format": "prettier --check .github docs scripts src test CHANGELOG.md eslint.config.ts package.json README.md README.ja.md repo-policy.json tsconfig.json vite.config.ts",
70
- "format:write": "prettier --write .github docs scripts src test CHANGELOG.md eslint.config.ts package.json README.md README.ja.md repo-policy.json tsconfig.json vite.config.ts",
71
- "typecheck": "tsc --project tsconfig.json",
72
- "test": "vitest run",
73
- "test:watch": "vitest",
74
- "pack:check": "npm pack --dry-run --ignore-scripts",
75
- "release:check": "npm publish --dry-run --access public",
76
- "repo:check": "node --experimental-strip-types scripts/check-repo.ts",
77
- "check": "pnpm run lint && pnpm run format && pnpm run typecheck && pnpm run test && pnpm run build && pnpm run repo:check && pnpm run pack:check"
78
- }
79
- }
80
+ ]
81
+ }