@kubohiroya/turbowarp-extension-loader 0.5.1 → 0.6.0

package/README.ja.md

@@ -223,6 +223,12 @@ Manifest は `uri` を持てます。その作品をダウンロードできる
 するたびに変わるので、ブラウザーのキャッシュも開く人の選択の記録も、触るたびに同じ作品を別名で
 綴じてしまいます。住所は中身が変わっても変わりません。
 
+`prepareCatalogExtensionChanges` と `prepareExtensionAddition` は `uri` を受け取ります。作品が
+最初の住所を得るのも、作者が選んだ住所へ移るのも、この経路です。何も言わなければ作品が持って
+いる住所がそのまま残り、`readProjectAuthoringState` がその住所を報告するので、ホストは初回保存
+かどうかを決める前に見分けられます。割り当てるかどうかはホストの判断です。作者が住所を選んだ
+のか、既定が必要な初回保存なのかを知っているのはホストだけだからです。
+
 `./project-authoring` の `createProjectUUID` と `defaultProjectURI` が、作者が住所を選んで
 いないときに与える住所を組みます。
 

package/README.md

@@ -226,6 +226,13 @@ fingerprint changes on every save, so a browser cache and a record of what the o
 file one work under a new name each time it was touched. An address does not change when the bytes
 do.
 
+`prepareCatalogExtensionChanges` and `prepareExtensionAddition` take a `uri` option, which is how
+a project gets its first address and how it moves to one the author chose. Saying nothing keeps
+the address the project already has, and `readProjectAuthoringState` reports that address, so a
+host can tell a first save from a later one before deciding. Whether to assign one is the host's
+call: only the host knows whether the author chose an address or whether this is a first save
+that needs a default.
+
 `createProjectUUID` and `defaultProjectURI` in `./project-authoring` build the address a project
 is given when its author has not chosen one:
 

package/dist/project-authoring.d.ts

@@ -23,6 +23,16 @@ export interface ExtensionAdditionOptions {
     signal?: AbortSignal;
     loaderOptions?: LoaderOptions;
     archiveOptions?: ArchiveLimits;
+    /**
+     * The address to give this project, or nothing to keep the one it has.
+     *
+     * Whether to assign one is the host's call, not this function's: only the host knows whether
+     * the author chose an address or whether this is a first save that needs a default. So this
+     * sets what it is given and leaves the existing address alone when it is given nothing —
+     * `readProjectAuthoringState` reports what a project already carries, so the host can tell
+     * the two apart before deciding.
+     */
+    uri?: string;
 }
 export interface PreparedExtensionAddition {
     readonly projectBytes: Uint8Array;

package/dist/project-authoring.js

@@ -21,7 +21,7 @@ function snapshotProject(input) {
  * Add a file-backed Embedded or URL-backed Remote extension without evaluating it.
  * A host approval is required before the candidate is returned; the original is untouched.
  */
-export async function prepareExtensionAddition(input, request, ports, { zip: Zip, signal: externalSignal, loaderOptions = {}, archiveOptions } = {}) {
+export async function prepareExtensionAddition(input, request, ports, { zip: Zip, signal: externalSignal, loaderOptions = {}, archiveOptions, uri } = {}) {
     if (typeof Zip !== 'function' || typeof Zip.loadAsync !== 'function')
         throw new TypeError('A compatible JSZip constructor is required');
     if (!plainObject(request) || Object.keys(request).some(key => !['id', 'source', 'bytes', 'execution'].includes(key))) {
@@ -95,8 +95,10 @@ export async function prepareExtensionAddition(input, request, ports, { zip: Zip
             fail('INVALID_PROJECT', 'Project extensionURLs must be an object');
         const previous = prepared.manifest?.extensions || [];
         // Carried through every rebuild below: an address that changed when an extension was
-        // added would not be an address.
-        const carried = prepared.manifest?.uri === undefined ? {} : { uri: prepared.manifest.uri };
+        // added would not be an address. The host may set one, which is how a project gets its
+        // first; saying nothing keeps what is there.
+        const address = uri ?? prepared.manifest?.uri;
+        const carried = address === undefined ? {} : { uri: address };
         if (previous.some(spec => spec.id === draft.id) || (project.extensions || []).includes(draft.id) ||
             Object.hasOwn(project.extensionURLs || {}, draft.id))
             fail('DUPLICATE_EXTENSION', 'This extension ID already belongs to the project', draft.id);

package/dist/project-catalog.d.ts

@@ -23,6 +23,16 @@ export interface CatalogOptions {
     signal?: AbortSignal;
     loaderOptions?: LoaderOptions;
     archiveOptions?: ArchiveLimits;
+    /**
+     * The address to give this project, or nothing to keep the one it has.
+     *
+     * Whether to assign one is the host's call, not this function's: only the host knows whether
+     * the author chose an address or whether this is a first save that needs a default. So this
+     * sets what it is given and leaves the existing address alone when it is given nothing —
+     * `readProjectAuthoringState` reports what a project already carries, so the host can tell
+     * the two apart before deciding.
+     */
+    uri?: string;
 }
 export type CatalogPorts = Pick<LoaderPorts, 'fetcher' | 'trustProvider' | 'cache' | 'diagnostics'>;
 /** Read project-owned distribution requests; these records never grant execution permission. */

package/dist/project-catalog.js

@@ -19,7 +19,7 @@ export async function readProjectAuthoringState(input, { zip, signal, archiveOpt
     const prepared = await io.prepare(input, { signal });
     return prepared.manifest;
 }
-export async function prepareCatalogExtensionChanges(input, requests, ports, { zip: Zip, signal: externalSignal, loaderOptions = {}, archiveOptions } = {}) {
+export async function prepareCatalogExtensionChanges(input, requests, ports, { zip: Zip, signal: externalSignal, loaderOptions = {}, archiveOptions, uri } = {}) {
     const limits = { ...DEFAULT_LOADER_LIMITS, ...loaderOptions };
     for (const key of ['maxExtensions', 'maxBytes', 'maxTotalBytes', 'timeoutMs']) {
         if (!Number.isSafeInteger(limits[key]) || limits[key] < 1)
@@ -176,8 +176,10 @@ export async function prepareCatalogExtensionChanges(input, requests, ports, { z
         // The project's own address survives a change to its extensions. Rebuilding the manifest
         // without it would file the same work under a new name the next time it was saved, which
         // is the one thing an address is for.
-        const manifest = validateManifest({ schemaVersion: 1, ...(prepared.manifest?.uri === undefined ?
-                {} : { uri: prepared.manifest.uri }), extensions: [...extensions.values()] }, loaderOptions);
+        const address = uri ?? prepared.manifest?.uri;
+        const manifest = validateManifest({ schemaVersion: 1,
+            ...(address === undefined ? {} : { uri: address }),
+            extensions: [...extensions.values()] }, loaderOptions);
         for (const spec of manifest.extensions)
             if (spec.source.type === 'embedded-file')
                 replacedPaths.delete(spec.source.path);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubohiroya/turbowarp-extension-loader",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Host-independent verified TurboWarp Plus extension loading core",
   "keywords": [
     "turbowarp",