@electron-stagewright/origin-migration 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Electron Stagewright contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,95 @@
-# Temporary Holding Version
+# @electron-stagewright/origin-migration
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Moving an Electron renderer from `file://` to a custom scheme changes its storage origin, so the
+first launch on the new scheme starts with empty storage. This package copies the old data across
+once, from your app's main process.
+
+**v0 copies `localStorage` and the origin private file system (OPFS) only.** IndexedDB, cookies,
+`sessionStorage` and Cache Storage are not copied. If your app keeps data there, this package does
+not move it yet.
+
+## Guarantees
+
+- A `localStorage` key the new origin already holds is never overwritten.
+- The `file://` copy is never modified, so an older build still opens with its data.
+- OPFS files are copied in 1 MiB chunks to staging files, and moved into place only after every
+  file is staged. A copied file replaces a file of the same path on the new origin.
+- A database and its `.wal` move together, database first. A `.wal` without its database is
+  skipped. Only `<name>.wal` sidecars are grouped (DuckDB); SQLite's `-wal`, `-journal` and
+  `-shm` files are not supported yet.
+- A marker in `userData` makes the copy run once. A failed attempt is retried on the next launch,
+  three attempts in all. A crash mid-copy counts as an attempt. A marker that exists but cannot be
+  read counts as done.
+- Data the user deletes on the new origin after it was copied is never restored by a retry.
+
+## Use
+
+```ts
+import { app, BrowserWindow, protocol, session } from 'electron'
+import { blankDocumentResponse, migrateOrigin } from '@electron-stagewright/origin-migration'
+
+const BLANK_URL = 'app://example/.origin-migration/blank.html'
+
+protocol.registerSchemesAsPrivileged([
+  { scheme: 'app', privileges: { standard: true, secure: true, supportFetchAPI: true } },
+])
+
+app.whenReady().then(async () => {
+  protocol.handle('app', (request) => {
+    if (request.url === BLANK_URL) return blankDocumentResponse()
+    return serveRenderer(request) // your handler
+  })
+
+  // Create the window first: closing the migration's pages must not close the app.
+  const window = new BrowserWindow({ show: false })
+  const result = await migrateOrigin({
+    userDataDir: app.getPath('userData'),
+    BrowserWindow,
+    session: session.defaultSession,
+    targetUrl: BLANK_URL,
+    onProgress: (done, total) => window.setProgressBar(total > 0 ? done / total : -1),
+  })
+  window.setProgressBar(-1)
+  if (result.status === 'failed' && result.final) {
+    // Tell the user their old data could not be copied.
+  }
+  await window.loadURL('app://example/index.html')
+  window.show()
+})
+```
+
+`migrateOrigin` resolves with one of:
+
+| `status`   | Meaning                                                                      |
+| ---------- | ---------------------------------------------------------------------------- |
+| `skipped`  | Already done, out of attempts, or the marker is unreadable. Nothing opened.  |
+| `empty`    | Nothing was left to copy on the `file://` origin.                            |
+| `migrated` | Data was copied. `marker` has key, file and byte counts.                     |
+| `failed`   | This attempt failed. `marker.error` names the error; `final` means no retry. |
+
+Options:
+
+| Option          | Default                 | Notes                                                       |
+| --------------- | ----------------------- | ----------------------------------------------------------- |
+| `targetUrl`     | required                | An empty document on the new origin. Must not be `file://`. |
+| `session`       | required                | The session whose storage moves; partitions work.           |
+| `stores`        | both                    | `['localStorage']`, `['opfs']` or both.                     |
+| `markerFile`    | `origin-migration.json` | A file name in `userDataDir`. Keep an existing marker name. |
+| `stepTimeoutMs` | 30000                   | Bounds each page load and each page step.                   |
+| `signal`        |                         | Aborts the attempt; moves already started still finish.     |
+
+## Requirements
+
+- Electron 42 or later.
+- The release that migrates must keep the `GrantFileProtocolExtraPrivileges` fuse on. Without it a
+  `file://` page cannot read `localStorage`; the marker then records `localStorageUnreadable` and
+  only OPFS files move.
+- Call it before the renderer loads from the new origin, so the app never boots on empty settings.
+
+## Lower-level API
+
+`runOriginMigration` takes a `LegacyOriginReader` and a `TargetOriginWriter` instead of windows,
+for apps that reach the origins another way. `openLegacyOriginPage` and `openTargetOriginPage`
+build the page-backed ones `migrateOrigin` uses.
+
+See [ADR-031](../../docs/adr/031-origin-migration-library.md) for the design.

package/dist/blank.d.ts

@@ -0,0 +1,5 @@
+/** An empty document with no script, style or network access. */
+export declare const BLANK_DOCUMENT_HTML = "<!doctype html><meta charset=\"utf-8\"><meta http-equiv=\"Content-Security-Policy\" content=\"default-src 'none'\"><title></title>";
+/** The blank document as a `protocol.handle` response for the migration's target URL. */
+export declare function blankDocumentResponse(): Response;
+//# sourceMappingURL=blank.d.ts.map

package/dist/blank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blank.d.ts","sourceRoot":"","sources":["../src/blank.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,uIACkG,CAAA;AAElI,yFAAyF;AACzF,wBAAgB,qBAAqB,IAAI,QAAQ,CAEhD"}

package/dist/blank.js

@@ -0,0 +1,7 @@
+/** An empty document with no script, style or network access. */
+export const BLANK_DOCUMENT_HTML = '<!doctype html><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="default-src \'none\'"><title></title>';
+/** The blank document as a `protocol.handle` response for the migration's target URL. */
+export function blankDocumentResponse() {
+    return new Response(BLANK_DOCUMENT_HTML, { headers: { 'content-type': 'text/html' } });
+}
+//# sourceMappingURL=blank.js.map

package/dist/blank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blank.js","sourceRoot":"","sources":["../src/blank.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAC9B,gIAAgI,CAAA;AAElI,yFAAyF;AACzF,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,CAAC,CAAA;AACxF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { BLANK_DOCUMENT_HTML, blankDocumentResponse } from './blank.js';
+export { migrateOrigin, type MigrateOriginOptions } from './migrate-origin.js';
+export { ORIGIN_MIGRATION_CHUNK_BYTES, ORIGIN_MIGRATION_MARKER, ORIGIN_MIGRATION_MAX_ATTEMPTS, ORIGIN_STORES, runOriginMigration, type LegacyOriginReader, type OriginFile, type OriginMigrationDeps, type OriginMigrationMarker, type OriginMigrationResult, type OriginStore, type TargetOriginWriter, } from './migration.js';
+export { openLegacyOriginPage, openTargetOriginPage, ORIGIN_PAGE_STEP_TIMEOUT_MS, type OriginPageOptions, type WindowFactory, } from './pages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC9E,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,EACb,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { BLANK_DOCUMENT_HTML, blankDocumentResponse } from './blank.js';
+export { migrateOrigin } from './migrate-origin.js';
+export { ORIGIN_MIGRATION_CHUNK_BYTES, ORIGIN_MIGRATION_MARKER, ORIGIN_MIGRATION_MAX_ATTEMPTS, ORIGIN_STORES, runOriginMigration, } from './migration.js';
+export { openLegacyOriginPage, openTargetOriginPage, ORIGIN_PAGE_STEP_TIMEOUT_MS, } from './pages.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAA;AAC9E,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,EACb,kBAAkB,GAQnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,GAG5B,MAAM,YAAY,CAAA"}

package/dist/migrate-origin.d.ts

@@ -0,0 +1,28 @@
+import type { Session } from 'electron';
+import { type OriginMigrationResult, type OriginStore } from './migration.js';
+import { type WindowFactory } from './pages.js';
+export interface MigrateOriginOptions {
+    /** `app.getPath('userData')`; the marker lives here. */
+    userDataDir: string;
+    /** Electron's `BrowserWindow`, used for two hidden, sandboxed pages. */
+    BrowserWindow: WindowFactory;
+    /** The session whose storage moves, usually `session.defaultSession`. */
+    session: Session;
+    /** An empty document on the new origin, served by the app's protocol handler. */
+    targetUrl: string;
+    /** Default both. */
+    stores?: readonly OriginStore[];
+    /** A file name inside `userDataDir`. Default `origin-migration.json`. */
+    markerFile?: string;
+    /** Bounds each page load and page step. Default 30 s. */
+    stepTimeoutMs?: number;
+    onProgress?: (done: number, total: number) => void;
+    signal?: AbortSignal;
+}
+/**
+ * Copies localStorage and the origin private file system from `file://` to the origin of
+ * `targetUrl`, once. Resolves with the outcome; an attempt that fails is retried on later
+ * launches, up to three attempts in all.
+ */
+export declare function migrateOrigin(options: MigrateOriginOptions): Promise<OriginMigrationResult>;
+//# sourceMappingURL=migrate-origin.d.ts.map

package/dist/migrate-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-origin.d.ts","sourceRoot":"","sources":["../src/migrate-origin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEvC,OAAO,EAAsB,KAAK,qBAAqB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjG,OAAO,EAA8C,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAE3F,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,aAAa,EAAE,aAAa,CAAA;IAC5B,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAA;IAChB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAA;IACjB,oBAAoB;IACpB,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmBjG"}

package/dist/migrate-origin.js

@@ -0,0 +1,28 @@
+import { runOriginMigration } from './migration.js';
+import { openLegacyOriginPage, openTargetOriginPage } from './pages.js';
+/**
+ * Copies localStorage and the origin private file system from `file://` to the origin of
+ * `targetUrl`, once. Resolves with the outcome; an attempt that fails is retried on later
+ * launches, up to three attempts in all.
+ */
+export async function migrateOrigin(options) {
+    if (new URL(options.targetUrl).protocol === 'file:') {
+        throw new TypeError('targetUrl must be on the new origin, not file://');
+    }
+    const pageOptions = {
+        session: options.session,
+        ...(options.signal ? { signal: options.signal } : {}),
+        ...(options.stepTimeoutMs ? { stepTimeoutMs: options.stepTimeoutMs } : {}),
+    };
+    return runOriginMigration({
+        userDataDir: options.userDataDir,
+        openLegacy: () => openLegacyOriginPage(options.BrowserWindow, pageOptions),
+        openTarget: () => openTargetOriginPage(options.BrowserWindow, options.targetUrl, pageOptions),
+        flush: () => options.session.flushStorageData(),
+        ...(options.markerFile ? { markerFile: options.markerFile } : {}),
+        ...(options.stores ? { stores: options.stores } : {}),
+        ...(options.onProgress ? { onProgress: options.onProgress } : {}),
+        ...(options.signal ? { signal: options.signal } : {}),
+    });
+}
+//# sourceMappingURL=migrate-origin.js.map

package/dist/migrate-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-origin.js","sourceRoot":"","sources":["../src/migrate-origin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAgD,MAAM,gBAAgB,CAAA;AACjG,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAsB,MAAM,YAAY,CAAA;AAqB3F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA6B;IAC/D,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAA;IACzE,CAAC;IACD,MAAM,WAAW,GAAG;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAA;IACD,OAAO,kBAAkB,CAAC;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC;QAC1E,UAAU,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;QAC7F,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE;QAC/C,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAA;AACJ,CAAC"}

package/dist/migration.d.ts

@@ -0,0 +1,82 @@
+/**
+ * One-time copy of renderer storage from one origin to another; Chromium keys storage by origin.
+ * The legacy copy is left on disk. Keys the new origin holds are never overwritten. Files are
+ * staged, then moved database-first with any old target WAL removed. A database and its WAL count
+ * as copied only after both moves succeed; until then, a retry copies both again over files the
+ * app created after a failed attempt. The marker's progress keeps retries from restoring a
+ * completed group the user deleted since.
+ */
+export declare const ORIGIN_MIGRATION_MARKER = "origin-migration.json";
+export declare const ORIGIN_MIGRATION_MAX_ATTEMPTS = 3;
+export declare const ORIGIN_MIGRATION_CHUNK_BYTES: number;
+export type OriginStore = 'localStorage' | 'opfs';
+export declare const ORIGIN_STORES: readonly OriginStore[];
+export interface OriginFile {
+    readonly path: string[];
+    readonly size: number;
+}
+export interface LegacyOriginReader {
+    /** Null when Chromium denies the page its localStorage, as for file:// without the fuse. */
+    readLocalStorage: () => Promise<Array<[string, string]> | null>;
+    listFiles: () => Promise<OriginFile[]>;
+    readChunk: (path: readonly string[], offset: number, length: number) => Promise<Uint8Array>;
+    close: () => void;
+}
+export interface TargetOriginWriter {
+    /** Sets each key the origin does not hold yet; resolves with how many it set. */
+    writeLocalStorage: (entries: Array<[string, string]>) => Promise<number>;
+    fileSize: (path: readonly string[]) => Promise<number | null>;
+    beginFile: (path: readonly string[]) => Promise<void>;
+    writeChunk: (bytes: Uint8Array) => Promise<void>;
+    endFile: () => Promise<void>;
+    abortFile: () => Promise<void>;
+    /** Moves a staged file over `name` in the same folder, replacing what is there. */
+    commitFile: (path: readonly string[], name: string) => Promise<void>;
+    /** Removes a file; a missing one is not an error. */
+    removeFile: (path: readonly string[]) => Promise<void>;
+    close: () => void;
+}
+export interface OriginMigrationMarker {
+    version: 1;
+    state: 'done' | 'failed';
+    attempts: number;
+    localStorageKeys: number;
+    files: number;
+    fileBytes: number;
+    durationMs: number;
+    error?: string;
+    localStorageCopied: boolean;
+    localStorageUnreadable?: boolean;
+    /** Paths joined with `/`. */
+    copiedFiles: string[];
+}
+export type OriginMigrationResult = {
+    status: 'skipped';
+} | {
+    status: 'empty' | 'migrated';
+    marker: OriginMigrationMarker;
+}
+/** `final` when no attempt is left, so the next launch skips the copy. */
+ | {
+    status: 'failed';
+    marker: OriginMigrationMarker;
+    final: boolean;
+};
+export interface OriginMigrationDeps {
+    userDataDir: string;
+    openLegacy: () => Promise<LegacyOriginReader>;
+    openTarget: () => Promise<TargetOriginWriter>;
+    /** Writes pending localStorage to disk before the marker records success. */
+    flush: () => Promise<void> | void;
+    /** A file name inside `userDataDir`. Default `origin-migration.json`. */
+    markerFile?: string;
+    /** Default both. */
+    stores?: readonly OriginStore[];
+    /** Bytes staged so far out of the bytes this attempt copies. */
+    onProgress?: (done: number, total: number) => void;
+    signal?: AbortSignal;
+    now?: () => number;
+}
+/** Runs one attempt with injected origin access. Never rejects once the marker path is valid. */
+export declare function runOriginMigration(deps: OriginMigrationDeps): Promise<OriginMigrationResult>;
+//# sourceMappingURL=migration.d.ts.map

package/dist/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"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"}

package/dist/migration.js

@@ -0,0 +1,265 @@
+import { open, readFile, rename } from 'node:fs/promises';
+import path from 'node:path';
+import { STAGING_SUFFIX } from './scripts.js';
+/**
+ * One-time copy of renderer storage from one origin to another; Chromium keys storage by origin.
+ * The legacy copy is left on disk. Keys the new origin holds are never overwritten. Files are
+ * staged, then moved database-first with any old target WAL removed. A database and its WAL count
+ * as copied only after both moves succeed; until then, a retry copies both again over files the
+ * app created after a failed attempt. The marker's progress keeps retries from restoring a
+ * completed group the user deleted since.
+ */
+export const ORIGIN_MIGRATION_MARKER = 'origin-migration.json';
+export const ORIGIN_MIGRATION_MAX_ATTEMPTS = 3;
+export const ORIGIN_MIGRATION_CHUNK_BYTES = 1 << 20;
+export const ORIGIN_STORES = ['localStorage', 'opfs'];
+/** Null only when no marker exists; any marker this version cannot read counts as final. */
+async function readMarker(markerPath) {
+    let text;
+    try {
+        text = await readFile(markerPath, 'utf8');
+    }
+    catch (error) {
+        return error.code === 'ENOENT' ? null : 'unreadable';
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed?.version !== 1 || (parsed.state !== 'done' && parsed.state !== 'failed')) {
+            return 'unreadable';
+        }
+        return {
+            ...parsed,
+            attempts: Number.isInteger(parsed.attempts) ? parsed.attempts : 1,
+            localStorageCopied: parsed.localStorageCopied === true,
+            copiedFiles: Array.isArray(parsed.copiedFiles)
+                ? parsed.copiedFiles.filter((entry) => typeof entry === 'string')
+                : [],
+        };
+    }
+    catch {
+        return 'unreadable';
+    }
+}
+async function writeMarker(markerPath, marker) {
+    const temporary = `${markerPath}.tmp`;
+    const handle = await open(temporary, 'w', 0o600);
+    try {
+        await handle.writeFile(`${JSON.stringify(marker, null, 2)}\n`);
+        // Flushed before the rename, so a power loss cannot leave a truncated marker in place.
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    await rename(temporary, markerPath);
+}
+/** An error name or code, never a message: messages can carry paths. */
+function errorCode(error) {
+    if (error && typeof error === 'object') {
+        const { code, name } = error;
+        if (typeof code === 'string' && /^[\w-]{1,64}$/.test(code))
+            return code;
+        if (typeof name === 'string' && /^\w{1,64}$/.test(name))
+            return name;
+    }
+    return 'unknown';
+}
+const WAL_SUFFIX = '.wal';
+/** Where the target's own WAL waits while the legacy database moves in. */
+const PREVIOUS_SUFFIX = '.origin-migration-previous';
+const keyOf = (file) => file.path.join('/');
+const nameOf = (file) => file.path.at(-1) ?? '';
+const siblingPath = (file, suffix) => [
+    ...file.path.slice(0, -1),
+    `${nameOf(file)}${suffix}`,
+];
+const stagingPath = (file) => siblingPath(file, STAGING_SUFFIX);
+/**
+ * A database and its WAL share retry ownership, regardless of listing order. A WAL whose database
+ * is gone is never copied: it is useless alone and could replay onto another database.
+ */
+function fileGroups(files) {
+    const byKey = new Map(files.map((file) => [keyOf(file), file]));
+    const groups = [];
+    for (const file of files) {
+        const key = keyOf(file);
+        if (key.endsWith(WAL_SUFFIX))
+            continue;
+        const wal = byKey.get(`${key}${WAL_SUFFIX}`);
+        groups.push(wal ? [file, wal] : [file]);
+    }
+    return groups;
+}
+/**
+ * Moves one staged group in, database first. The target's own WAL is set aside rather than
+ * deleted, so a failed database move leaves the target pair intact; once the legacy database
+ * lands, that WAL no longer matches and goes.
+ */
+async function commitGroup(target, group) {
+    const [database, wal] = group;
+    const targetWal = siblingPath(database, WAL_SUFFIX);
+    const aside = siblingPath(database, `${WAL_SUFFIX}${PREVIOUS_SUFFIX}`);
+    const hadWal = (await target.fileSize(targetWal)) !== null;
+    if (hadWal)
+        await target.commitFile(targetWal, aside.at(-1) ?? '');
+    try {
+        await target.commitFile(stagingPath(database), nameOf(database));
+    }
+    catch (error) {
+        if (hadWal) {
+            await target.commitFile(aside, `${nameOf(database)}${WAL_SUFFIX}`).catch(() => undefined);
+        }
+        throw error;
+    }
+    // Unconditional: a crash after the set-aside but before this move leaves an aside behind.
+    await target.removeFile(aside).catch(() => undefined);
+    if (wal)
+        await target.commitFile(stagingPath(wal), nameOf(wal));
+}
+async function stageFile(legacy, target, file, onChunk, signal) {
+    const staging = stagingPath(file);
+    await target.beginFile(staging);
+    try {
+        for (let offset = 0; offset < file.size;) {
+            signal?.throwIfAborted();
+            const length = Math.min(ORIGIN_MIGRATION_CHUNK_BYTES, file.size - offset);
+            const bytes = await legacy.readChunk(file.path, offset, length);
+            if (bytes.byteLength !== length) {
+                throw Object.assign(new Error('Legacy file changed during migration'), { code: 'ESIZE' });
+            }
+            await target.writeChunk(bytes);
+            offset += length;
+            onChunk(length);
+        }
+        await target.endFile();
+    }
+    catch (error) {
+        await target.abortFile().catch(() => undefined);
+        throw error;
+    }
+    if ((await target.fileSize(staging)) !== file.size) {
+        throw Object.assign(new Error('Copied file size differs'), { code: 'ESIZE' });
+    }
+}
+/** Runs one attempt with injected origin access. Never rejects once the marker path is valid. */
+export async function runOriginMigration(deps) {
+    const markerFile = deps.markerFile ?? ORIGIN_MIGRATION_MARKER;
+    if (!markerFile ||
+        markerFile !== path.basename(markerFile) ||
+        markerFile === '.' ||
+        markerFile === '..') {
+        throw new TypeError('markerFile must be a file name, not a path');
+    }
+    const stores = new Set(deps.stores ?? ORIGIN_STORES);
+    const now = deps.now ?? Date.now;
+    const markerPath = path.join(deps.userDataDir, markerFile);
+    const previous = await readMarker(markerPath);
+    if (previous === 'unreadable' ||
+        (previous && (previous.state === 'done' || previous.attempts >= ORIGIN_MIGRATION_MAX_ATTEMPTS))) {
+        return { status: 'skipped' };
+    }
+    const started = now();
+    // Recorded as interrupted up front, so a crash mid-copy still spends an attempt.
+    const marker = {
+        version: 1,
+        state: 'failed',
+        error: 'interrupted',
+        attempts: (previous?.attempts ?? 0) + 1,
+        localStorageKeys: previous?.localStorageKeys ?? 0,
+        files: previous?.files ?? 0,
+        fileBytes: previous?.fileBytes ?? 0,
+        durationMs: 0,
+        localStorageCopied: previous?.localStorageCopied ?? false,
+        ...(previous?.localStorageUnreadable ? { localStorageUnreadable: true } : {}),
+        copiedFiles: [...(previous?.copiedFiles ?? [])],
+    };
+    // No disk probe: Chromium creates Local Storage before any page loads, so only the legacy
+    // origin itself can say whether it holds data.
+    let legacy;
+    let target;
+    try {
+        await writeMarker(markerPath, marker);
+        legacy = await deps.openLegacy();
+        // Settings go first, so a failed file step cannot leave the app to boot on defaults.
+        if (stores.has('localStorage') && !marker.localStorageCopied) {
+            const entries = await legacy.readLocalStorage();
+            if (entries === null)
+                marker.localStorageUnreadable = true;
+            if (entries && entries.length > 0) {
+                target = await deps.openTarget();
+                marker.localStorageKeys = await target.writeLocalStorage(entries);
+                await deps.flush();
+            }
+            marker.localStorageCopied = true;
+            await writeMarker(markerPath, marker);
+        }
+        const copied = new Set(marker.copiedFiles);
+        const listed = stores.has('opfs') ? await legacy.listFiles() : [];
+        const pendingGroups = fileGroups(listed).filter((group) => group.some((file) => !copied.has(keyOf(file))));
+        const files = pendingGroups.flat();
+        if (files.length > 0)
+            target ??= await deps.openTarget();
+        const empty = !target;
+        if (target) {
+            const writer = target;
+            const reader = legacy;
+            const staged = [];
+            const total = files.reduce((sum, file) => sum + file.size, 0);
+            let done = 0;
+            const onChunk = (length) => deps.onProgress?.((done += length), total);
+            try {
+                for (const file of files) {
+                    deps.signal?.throwIfAborted();
+                    staged.push(file);
+                    await stageFile(reader, writer, file, onChunk, deps.signal);
+                }
+                // Past this point a started move runs to the end, so an abort cannot split a database from its WAL.
+                deps.signal?.throwIfAborted();
+            }
+            catch (error) {
+                await Promise.all(staged.map((file) => writer.removeFile(stagingPath(file)).catch(() => undefined)));
+                throw error;
+            }
+            let committed = 0;
+            try {
+                for (const group of pendingGroups) {
+                    await commitGroup(writer, group);
+                    committed += 1;
+                    // Recorded per group, so a crash after it never restores this group over later changes.
+                    // An older failed marker may already name one of its files; that one is not counted twice.
+                    for (const file of group) {
+                        if (copied.has(keyOf(file)))
+                            continue;
+                        copied.add(keyOf(file));
+                        marker.files += 1;
+                        marker.fileBytes += file.size;
+                        marker.copiedFiles.push(keyOf(file));
+                    }
+                    await writeMarker(markerPath, marker);
+                }
+            }
+            catch (error) {
+                const left = pendingGroups.slice(committed).flat();
+                await Promise.all(left.map((file) => writer.removeFile(stagingPath(file)).catch(() => undefined)));
+                throw error;
+            }
+        }
+        marker.state = 'done';
+        delete marker.error;
+        marker.durationMs = Math.round(now() - started);
+        await writeMarker(markerPath, marker);
+        return { status: empty ? 'empty' : 'migrated', marker };
+    }
+    catch (error) {
+        marker.state = 'failed';
+        marker.error = errorCode(error);
+        marker.durationMs = Math.round(now() - started);
+        await writeMarker(markerPath, marker).catch(() => undefined);
+        return { status: 'failed', marker, final: marker.attempts >= ORIGIN_MIGRATION_MAX_ATTEMPTS };
+    }
+    finally {
+        legacy?.close();
+        target?.close();
+    }
+}
+//# sourceMappingURL=migration.js.map

package/dist/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"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"}

package/dist/pages.d.ts

@@ -0,0 +1,16 @@
+import type { BrowserWindow, BrowserWindowConstructorOptions, Session } from 'electron';
+import type { LegacyOriginReader, TargetOriginWriter } from './migration.js';
+/** Bounds each page load and script; a stalled step fails the attempt instead of the launch. */
+export declare const ORIGIN_PAGE_STEP_TIMEOUT_MS = 30000;
+export type WindowFactory = new (options: BrowserWindowConstructorOptions) => BrowserWindow;
+export interface OriginPageOptions {
+    /** The session whose storage moves. Default: Electron's default session. */
+    session?: Session;
+    signal?: AbortSignal;
+    stepTimeoutMs?: number;
+}
+/** Reads the file:// origin through an empty page written to a private temp folder. */
+export declare function openLegacyOriginPage(Window: WindowFactory, options?: OriginPageOptions): Promise<LegacyOriginReader>;
+/** Writes the new origin through `blankUrl`, an empty document the app's handler serves. */
+export declare function openTargetOriginPage(Window: WindowFactory, blankUrl: string, options?: OriginPageOptions): Promise<TargetOriginWriter>;
+//# sourceMappingURL=pages.d.ts.map

package/dist/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA+B,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAGvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAgB5E,gGAAgG;AAChG,eAAO,MAAM,2BAA2B,QAAS,CAAA;AAEjD,MAAM,MAAM,aAAa,GAAG,KAAK,OAAO,EAAE,+BAA+B,KAAK,aAAa,CAAA;AAE3F,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAmGD,uFAAuF;AACvF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;AAED,4FAA4F;AAC5F,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAwB7B"}

package/dist/pages.js

@@ -0,0 +1,114 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { BLANK_DOCUMENT_HTML } from './blank.js';
+import { ABORT_FILE, BEGIN_FILE, call, COMMIT_FILE, END_FILE, FILE_SIZE, LIST_FILES, READ_CHUNK, READ_LOCAL_STORAGE, REMOVE_FILE, WRITE_CHUNK, WRITE_LOCAL_STORAGE, } from './scripts.js';
+/** Bounds each page load and script; a stalled step fails the attempt instead of the launch. */
+export const ORIGIN_PAGE_STEP_TIMEOUT_MS = 30_000;
+function withTimeout(promise, timeoutMs, signal) {
+    return new Promise((resolve, reject) => {
+        const fail = (reason) => {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+            reject(reason);
+        };
+        const onAbort = () => fail(signal?.reason);
+        const timer = setTimeout(() => fail(Object.assign(new Error('Origin migration step timed out'), { code: 'ETIMEDOUT' })), timeoutMs);
+        signal?.addEventListener('abort', onAbort, { once: true });
+        if (signal?.aborted)
+            onAbort();
+        promise.then((value) => {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, fail);
+    });
+}
+async function openStoragePage(Window, load, cleanup, options) {
+    const timeoutMs = options.stepTimeoutMs ?? ORIGIN_PAGE_STEP_TIMEOUT_MS;
+    let window;
+    try {
+        window = new Window({
+            show: false,
+            webPreferences: {
+                sandbox: true,
+                contextIsolation: true,
+                nodeIntegration: false,
+                webSecurity: true,
+                spellcheck: false,
+                backgroundThrottling: false,
+                ...(options.session ? { session: options.session } : {}),
+            },
+        });
+    }
+    catch (error) {
+        cleanup();
+        throw error;
+    }
+    window.webContents.setWindowOpenHandler(() => ({ action: 'deny' }));
+    window.webContents.on('will-navigate', (event) => event.preventDefault());
+    window.webContents.on('will-redirect', (event) => event.preventDefault());
+    const close = () => {
+        if (!window.isDestroyed())
+            window.destroy();
+        cleanup();
+    };
+    try {
+        await withTimeout(load(window), timeoutMs, options.signal);
+    }
+    catch (error) {
+        close();
+        throw error;
+    }
+    return {
+        evaluate: (script) => runSettled(window, script, timeoutMs, options.signal),
+        evaluateToEnd: (script) => runSettled(window, script, timeoutMs),
+        close,
+    };
+}
+async function runSettled(window, script, timeoutMs, signal) {
+    const result = await withTimeout(window.webContents.executeJavaScript(settled(script)), timeoutMs, signal);
+    if ('value' in result)
+        return result.value;
+    throw Object.assign(new Error('Origin page step failed'), { name: result.name });
+}
+// executeJavaScript rejects with neither name nor message, so the page reports the error name.
+function settled(script) {
+    return `(async () => { try { return { value: await (${script}) }; } catch (error) { return { name: String((error && error.name) || 'Error') }; } })()`;
+}
+/** Reads the file:// origin through an empty page written to a private temp folder. */
+export async function openLegacyOriginPage(Window, options = {}) {
+    const folder = await mkdtemp(path.join(os.tmpdir(), 'origin-migration-'));
+    const document = path.join(folder, 'blank.html');
+    const removeFolder = () => void rm(folder, { recursive: true, force: true }).catch(() => { });
+    try {
+        await writeFile(document, BLANK_DOCUMENT_HTML);
+    }
+    catch (error) {
+        removeFolder();
+        throw error;
+    }
+    const page = await openStoragePage(Window, (w) => w.loadFile(document), removeFolder, options);
+    return {
+        readLocalStorage: () => page.evaluate(READ_LOCAL_STORAGE),
+        listFiles: () => page.evaluate(LIST_FILES),
+        readChunk: (filePath, offset, length) => page.evaluate(call(READ_CHUNK, filePath, offset, length)),
+        close: page.close,
+    };
+}
+/** Writes the new origin through `blankUrl`, an empty document the app's handler serves. */
+export async function openTargetOriginPage(Window, blankUrl, options = {}) {
+    const page = await openStoragePage(Window, (w) => w.loadURL(blankUrl), () => { }, options);
+    return {
+        writeLocalStorage: (entries) => page.evaluate(call(WRITE_LOCAL_STORAGE, entries)),
+        fileSize: (filePath) => page.evaluate(call(FILE_SIZE, filePath)),
+        beginFile: (filePath) => page.evaluate(call(BEGIN_FILE, filePath)),
+        writeChunk: (bytes) => page.evaluate(call(WRITE_CHUNK, Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString('base64'))),
+        endFile: () => page.evaluate(END_FILE),
+        abortFile: () => page.evaluateToEnd(ABORT_FILE),
+        commitFile: (filePath, name) => page.evaluateToEnd(call(COMMIT_FILE, filePath, name)),
+        removeFile: (filePath) => page.evaluateToEnd(call(REMOVE_FILE, filePath)),
+        close: page.close,
+    };
+}
+//# sourceMappingURL=pages.js.map

package/dist/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"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"}

package/dist/scripts.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Scripts main runs in the hidden migration pages. They stay strings so a bundler's minifier
+ * cannot rename or wrap what runs in another realm. Arguments are spliced in with `call`, as JSON.
+ */
+export declare const STAGING_SUFFIX = ".origin-migration-staging";
+/** Every key and value of the page's localStorage, or null when the page may not read it. */
+export declare const READ_LOCAL_STORAGE = "(() => {\n  try {\n    void localStorage.length;\n  } catch {\n    return null;\n  }\n  const entries = [];\n  for (let index = 0; index < localStorage.length; index += 1) {\n    const key = localStorage.key(index);\n    const value = key === null ? null : localStorage.getItem(key);\n    if (key !== null && value !== null) entries.push([key, value]);\n  }\n  return entries;\n})()";
+/** Sets each key the page does not hold yet; resolves with how many it set. */
+export declare const WRITE_LOCAL_STORAGE = "((entries) => {\n  let written = 0;\n  for (const [key, value] of entries) {\n    if (localStorage.getItem(key) !== null) continue;\n    localStorage.setItem(key, value);\n    written += 1;\n  }\n  return written;\n})";
+/** Every file in the origin private file system, with its size. Skips swap and staging files. */
+export declare const LIST_FILES: string;
+/** `length` bytes of a file from `offset`. */
+export declare const READ_CHUNK = "(async (path, offset, length) => {\n  const create = false;\n  let dir = await navigator.storage.getDirectory();\n  for (const name of path.slice(0, -1)) dir = await dir.getDirectoryHandle(name, { create });\n  const file = await (await dir.getFileHandle(path[path.length - 1])).getFile();\n  return new Uint8Array(await file.slice(offset, offset + length).arrayBuffer());\n})";
+/** A file's size, or null when the page has no file at that path. */
+export declare const FILE_SIZE = "(async (path) => {\n  const create = false;\n  try {\n    let dir = await navigator.storage.getDirectory();\n  for (const name of path.slice(0, -1)) dir = await dir.getDirectoryHandle(name, { create });\n    return (await (await dir.getFileHandle(path[path.length - 1])).getFile()).size;\n  } catch (error) {\n    if (error && error.name === 'NotFoundError') return null;\n    throw error;\n  }\n})";
+export declare const BEGIN_FILE = "(async (path) => {\n  const create = true;\n  let dir = await navigator.storage.getDirectory();\n  for (const name of path.slice(0, -1)) dir = await dir.getDirectoryHandle(name, { create });\n  const handle = await dir.getFileHandle(path[path.length - 1], { create: true });\n  globalThis.__originMigrationWritable = await handle.createWritable({ keepExistingData: false });\n})";
+export declare const WRITE_CHUNK = "(async (data) => {\n  let bytes;\n  if (typeof Uint8Array.fromBase64 === 'function') {\n    bytes = Uint8Array.fromBase64(data);\n  } else {\n    const binary = atob(data);\n    bytes = new Uint8Array(binary.length);\n    for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);\n  }\n  await globalThis.__originMigrationWritable.write(bytes);\n})";
+export declare const END_FILE = "(async () => {\n  const writable = globalThis.__originMigrationWritable;\n  globalThis.__originMigrationWritable = undefined;\n  await writable.close();\n})()";
+export declare const ABORT_FILE = "(async () => {\n  const writable = globalThis.__originMigrationWritable;\n  globalThis.__originMigrationWritable = undefined;\n  if (writable) await writable.abort();\n})()";
+export declare const COMMIT_FILE = "(async (path, name) => {\n  const create = false;\n  let dir = await navigator.storage.getDirectory();\n  for (const name of path.slice(0, -1)) dir = await dir.getDirectoryHandle(name, { create });\n  await (await dir.getFileHandle(path[path.length - 1])).move(name);\n})";
+export declare const REMOVE_FILE = "(async (path) => {\n  const create = false;\n  try {\n    let dir = await navigator.storage.getDirectory();\n  for (const name of path.slice(0, -1)) dir = await dir.getDirectoryHandle(name, { create });\n    await dir.removeEntry(path[path.length - 1]);\n  } catch (error) {\n    if (!error || error.name !== 'NotFoundError') throw error;\n  }\n})";
+/** A call of one of the function scripts above. */
+export declare function call(script: string, ...args: unknown[]): string;
+//# sourceMappingURL=scripts.d.ts.map

package/dist/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../src/scripts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,cAAc,8BAA8B,CAAA;AAEzD,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,mYAa1B,CAAA;AAEL,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,8NAQ7B,CAAA;AAEH,iGAAiG;AACjG,eAAO,MAAM,UAAU,QAWlB,CAAA;AAKL,8CAA8C;AAC9C,eAAO,MAAM,UAAU,6XAKpB,CAAA;AAEH,qEAAqE;AACrE,eAAO,MAAM,SAAS,mZASnB,CAAA;AAGH,eAAO,MAAM,UAAU,+XAKpB,CAAA;AAEH,eAAO,MAAM,WAAW,uYAUrB,CAAA;AAEH,eAAO,MAAM,QAAQ,mKAIhB,CAAA;AAEL,eAAO,MAAM,UAAU,iLAIlB,CAAA;AAEL,eAAO,MAAM,WAAW,oRAIrB,CAAA;AAEH,eAAO,MAAM,WAAW,gWAQrB,CAAA;AAEH,mDAAmD;AACnD,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAE/D"}

package/dist/scripts.js

@@ -0,0 +1,110 @@
+/**
+ * Scripts main runs in the hidden migration pages. They stay strings so a bundler's minifier
+ * cannot rename or wrap what runs in another realm. Arguments are spliced in with `call`, as JSON.
+ */
+export const STAGING_SUFFIX = '.origin-migration-staging';
+/** Every key and value of the page's localStorage, or null when the page may not read it. */
+export const READ_LOCAL_STORAGE = `(() => {
+  try {
+    void localStorage.length;
+  } catch {
+    return null;
+  }
+  const entries = [];
+  for (let index = 0; index < localStorage.length; index += 1) {
+    const key = localStorage.key(index);
+    const value = key === null ? null : localStorage.getItem(key);
+    if (key !== null && value !== null) entries.push([key, value]);
+  }
+  return entries;
+})()`;
+/** Sets each key the page does not hold yet; resolves with how many it set. */
+export const WRITE_LOCAL_STORAGE = `((entries) => {
+  let written = 0;
+  for (const [key, value] of entries) {
+    if (localStorage.getItem(key) !== null) continue;
+    localStorage.setItem(key, value);
+    written += 1;
+  }
+  return written;
+})`;
+/** Every file in the origin private file system, with its size. Skips swap and staging files. */
+export const LIST_FILES = `(async () => {
+  const files = [];
+  const pending = [{ dir: await navigator.storage.getDirectory(), path: [] }];
+  while (pending.length > 0) {
+    const { dir, path } = pending.pop();
+    for await (const [name, handle] of dir.entries()) {
+      if (handle.kind === 'directory') pending.push({ dir: handle, path: [...path, name] });
+      else if (!name.endsWith('.crswap') && !name.endsWith(${JSON.stringify(STAGING_SUFFIX)})) files.push({ path: [...path, name], size: (await handle.getFile()).size });
+    }
+  }
+  return files;
+})()`;
+const OPEN_PARENT = `let dir = await navigator.storage.getDirectory();
+  for (const name of path.slice(0, -1)) dir = await dir.getDirectoryHandle(name, { create });`;
+/** `length` bytes of a file from `offset`. */
+export const READ_CHUNK = `(async (path, offset, length) => {
+  const create = false;
+  ${OPEN_PARENT}
+  const file = await (await dir.getFileHandle(path[path.length - 1])).getFile();
+  return new Uint8Array(await file.slice(offset, offset + length).arrayBuffer());
+})`;
+/** A file's size, or null when the page has no file at that path. */
+export const FILE_SIZE = `(async (path) => {
+  const create = false;
+  try {
+    ${OPEN_PARENT}
+    return (await (await dir.getFileHandle(path[path.length - 1])).getFile()).size;
+  } catch (error) {
+    if (error && error.name === 'NotFoundError') return null;
+    throw error;
+  }
+})`;
+// The writable commits on close, so an interrupted copy never leaves partial content.
+export const BEGIN_FILE = `(async (path) => {
+  const create = true;
+  ${OPEN_PARENT}
+  const handle = await dir.getFileHandle(path[path.length - 1], { create: true });
+  globalThis.__originMigrationWritable = await handle.createWritable({ keepExistingData: false });
+})`;
+export const WRITE_CHUNK = `(async (data) => {
+  let bytes;
+  if (typeof Uint8Array.fromBase64 === 'function') {
+    bytes = Uint8Array.fromBase64(data);
+  } else {
+    const binary = atob(data);
+    bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+  }
+  await globalThis.__originMigrationWritable.write(bytes);
+})`;
+export const END_FILE = `(async () => {
+  const writable = globalThis.__originMigrationWritable;
+  globalThis.__originMigrationWritable = undefined;
+  await writable.close();
+})()`;
+export const ABORT_FILE = `(async () => {
+  const writable = globalThis.__originMigrationWritable;
+  globalThis.__originMigrationWritable = undefined;
+  if (writable) await writable.abort();
+})()`;
+export const COMMIT_FILE = `(async (path, name) => {
+  const create = false;
+  ${OPEN_PARENT}
+  await (await dir.getFileHandle(path[path.length - 1])).move(name);
+})`;
+export const REMOVE_FILE = `(async (path) => {
+  const create = false;
+  try {
+    ${OPEN_PARENT}
+    await dir.removeEntry(path[path.length - 1]);
+  } catch (error) {
+    if (!error || error.name !== 'NotFoundError') throw error;
+  }
+})`;
+/** A call of one of the function scripts above. */
+export function call(script, ...args) {
+    return `${script}(${args.map((arg) => JSON.stringify(arg)).join(', ')})`;
+}
+//# sourceMappingURL=scripts.js.map

package/dist/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../src/scripts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,2BAA2B,CAAA;AAEzD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;KAa7B,CAAA;AAEL,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;GAQhC,CAAA;AAEH,iGAAiG;AACjG,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;6DAOmC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;;;KAItF,CAAA;AAEL,MAAM,WAAW,GAAG;8FAC0E,CAAA;AAE9F,8CAA8C;AAC9C,MAAM,CAAC,MAAM,UAAU,GAAG;;IAEtB,WAAW;;;GAGZ,CAAA;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,SAAS,GAAG;;;MAGnB,WAAW;;;;;;GAMd,CAAA;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,UAAU,GAAG;;IAEtB,WAAW;;;GAGZ,CAAA;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;GAUxB,CAAA;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;KAInB,CAAA;AAEL,MAAM,CAAC,MAAM,UAAU,GAAG;;;;KAIrB,CAAA;AAEL,MAAM,CAAC,MAAM,WAAW,GAAG;;IAEvB,WAAW;;GAEZ,CAAA;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;;;MAGrB,WAAW;;;;;GAKd,CAAA;AAEH,mDAAmD;AACnD,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,GAAG,IAAe;IACrD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA;AAC1E,CAAC"}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@electron-stagewright/origin-migration",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "One-time copy of an Electron renderer's localStorage and origin private file system from the file:// origin to a custom-scheme origin, safe to interrupt and retry.",
+  "type": "module",
+  "license": "MIT",
+  "author": "johnny4young <johnny.iv.young@gmail.com>",
+  "homepage": "https://electron-stagewright.github.io/electron-stagewright/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/electron-stagewright/electron-stagewright.git",
+    "directory": "packages/origin-migration"
+  },
+  "bugs": {
+    "url": "https://github.com/electron-stagewright/electron-stagewright/issues"
+  },
+  "keywords": [
+    "electron",
+    "custom-protocol",
+    "localstorage",
+    "opfs",
+    "migration",
+    "file-protocol"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "electron": ">=42.0.0"
+  },
+  "peerDependenciesMeta": {
+    "electron": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "electron": "^42.11.10",
+    "@electron-stagewright/core": "0.9.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }