@supapower/worker 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Aboviq AB
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,9 @@
+Supapower Worker
+Copyright 2026 Aboviq AB
+
+This product includes software developed at Aboviq AB (https://www.aboviq.com/).
+
+This product includes software developed by ElectricSQL
+(https://github.com/electric-sql/pglite), licensed under the Apache License,
+Version 2.0. Portions of src/shared-worker.ts are derived from
+packages/pglite/src/worker/index.ts and have been modified.

package/README.md

@@ -0,0 +1,112 @@
+# `@supapower/worker`
+
+A more stable drop-in replacement for PGlite's built-in
+[multi-tab worker](https://pglite.dev/docs/multi-tab-worker): one `SharedWorker` hosts the
+[PGlite](https://pglite.dev/) database for every tab, so the database is never owned by a particular
+tab and never has to be handed over when one closes, with PGlite's own dedicated-worker setup as an
+automatic fallback for browsers without `SharedWorker` (or where it fails to start). Works with plain
+PGlite - [Supapower](https://github.com/aboviq/supapower/tree/main/packages/supapower#readme) is not
+required.
+
+> **Status:** Below 1.0.0. The public API may still change.
+
+## Installation
+
+```bash
+npm install @supapower/worker @electric-sql/pglite
+```
+
+`@electric-sql/pglite` is a peer dependency - install it alongside this package. The peer range is
+`>=0.5.8 <0.6.0`: this package depends on PGlite's _internal_ worker handshake, which is only
+guaranteed to stay compatible within a minor version.
+
+(of course, you can use the package manager of your choice, e.g. `bun` or `pnpm`)
+
+## Usage
+
+### 1. Write the worker script
+
+```ts
+// ./pglite-worker.ts
+import { worker } from '@supapower/worker/worker';
+import { PGlite } from '@electric-sql/pglite';
+
+worker({
+  async init(options) {
+    return await PGlite.create(options);
+  },
+});
+```
+
+`worker()` detects at runtime whether it is running as a `SharedWorker` or a dedicated `Worker` and
+speaks the right protocol for each - the same script works for both, so there is only ever one
+worker file to write.
+
+### 2. Connect from the tab
+
+```ts
+// ./pglite.ts
+import { createPGliteWorker } from '@supapower/worker';
+
+export const pg = await createPGliteWorker(
+  {
+    shared: () =>
+      new SharedWorker(new URL('./pglite-worker.ts', import.meta.url), { type: 'module' }),
+    fallback: () => new Worker(new URL('./pglite-worker.ts', import.meta.url), { type: 'module' }),
+  },
+  { id: 'my-app' },
+);
+
+console.log('Transport:', pg.transport); // 'shared-worker' or 'worker'
+```
+
+`id` is **required**. It is the only value that makes both transports agree on one election lock and
+one broadcast channel - `PGliteWorker`'s own default id is derived from _its own_ `import.meta.url`,
+which differs between the shared and the fallback worker scripts and would otherwise let the two open
+the same `dataDir` as if they were unrelated databases. Pick one stable id per database your app
+opens.
+
+The returned `pg` **is** a [`PGliteWorker`](https://pglite.dev/docs/multi-tab-worker) - every method,
+extension and the `live` query API work exactly as documented there, and any code written against
+PGlite's own multi-tab worker keeps working unchanged. `pg.transport` reports which side actually
+won: `'shared-worker'` when the `SharedWorker` started within `sharedWorkerTimeout` (10 seconds by
+default), `'worker'` otherwise.
+
+### 3. (Optional) Sync with Supapower
+
+Nothing above needs [Supapower](https://github.com/aboviq/supapower/tree/main/packages/supapower#readme) -
+`pg` is a plain `PGliteWorker` and works with any PGlite extension. Apps that do use it wire it up the
+same way as with PGlite's own worker:
+
+```ts
+import { extensions } from '@supapower/vue'; // or `@supapower/react`, or plain `supapower`
+
+export const pg = await createPGliteWorker(
+  { shared: () => new SharedWorker(/* … */), fallback: () => new Worker(/* … */) },
+  { id: 'my-app', extensions },
+);
+
+const sync = await pg.supapower.sync({ supabase, tables: ['todos'] });
+```
+
+`extensions` goes on this, the client side, call - not inside the worker's `init()` - the same rule
+as `PGliteWorker.create` itself, since `createPGliteWorker` strips `extensions` before forwarding the
+rest of the options to the worker.
+
+## What differs from PGlite's own multi-tab worker
+
+- **One worker instance for every tab.** PGlite's dedicated-worker transport elects one _tab_ to host
+  the database and hands it over when that tab closes. A `SharedWorker` is not owned by any tab, so
+  there is nothing to hand over - it simply outlives every tab until the last one disconnects.
+- **`pg.isLeader` is always `false` on the shared transport.** There is only ever one `SharedWorker`
+  instance per database, so there is nothing to elect a leader among. Code that reads `isLeader` to
+  decide who does work needs a different signal on this transport - Supapower's own outgoing-sync
+  leadership already handles this by electing on tab visibility instead, see
+  [Multi-tab behavior](https://github.com/aboviq/supapower/tree/main/packages/supapower#multi-tab-behavior)
+  in its README.
+- **Safari ignores the `SharedWorker` constructor's `name` option.** Separate two databases by using
+  a different worker script URL and a different `id`, not by `name`.
+
+## License
+
+Apache-2.0

package/dist/connect.d.ts

@@ -0,0 +1,21 @@
+/** Which side actually ended up hosting the database. */
+export type WorkerTransport = 'shared-worker' | 'worker';
+export interface WorkerFactories {
+    /** Tried first. Build the SharedWorker at the call site so bundlers can see it. */
+    shared: () => SharedWorker;
+    /** Used when SharedWorker is missing or fails to start. */
+    fallback: () => Worker;
+}
+export interface WorkerConnection<T> {
+    transport: WorkerTransport;
+    db: T;
+}
+/**
+ * Connects through a `SharedWorker`, falling back to a dedicated `Worker`
+ * when the shared transport is unavailable or fails to start in time.
+ *
+ * @param timeout Milliseconds allowed for the SharedWorker's script load and
+ *   handshake, not for the database itself to finish booting.
+ */
+export declare function connectWithFallback<T>(workers: WorkerFactories, connect: (worker: Worker) => Promise<T>, timeout: number): Promise<WorkerConnection<T>>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,MAAM,EAAE,MAAM,YAAY,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,SAAS,EAAE,eAAe,CAAC;IAC3B,EAAE,EAAE,CAAC,CAAC;CACP;AA+CD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CA8B9B"}

package/dist/connect.js

@@ -0,0 +1,67 @@
+/** A `Worker`-shaped facade over one `SharedWorker` client port. */
+function portAsWorker(port) {
+    let started = false;
+    const ensureStarted = () => {
+        if (!started) {
+            started = true;
+            // Deferred to the first listener, so no message dispatched by the
+            // SharedWorker before `PGliteWorker` is listening is ever dropped.
+            port.start();
+        }
+    };
+    return {
+        addEventListener(...args) {
+            ensureStarted();
+            port.addEventListener(...args);
+        },
+        removeEventListener(...args) {
+            port.removeEventListener(...args);
+        },
+        postMessage(...args) {
+            port.postMessage(...args);
+        },
+        terminate() {
+            // Closes only this tab's port - the other tabs, and the shared
+            // database, are unaffected.
+            port.close();
+        },
+    };
+}
+function rejectAfter(ms) {
+    let timer;
+    const promise = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => reject(new Error(`Timed out waiting for the SharedWorker after ${ms}ms`)), ms);
+    });
+    return { promise, cancel: () => clearTimeout(timer) };
+}
+/**
+ * Connects through a `SharedWorker`, falling back to a dedicated `Worker`
+ * when the shared transport is unavailable or fails to start in time.
+ *
+ * @param timeout Milliseconds allowed for the SharedWorker's script load and
+ *   handshake, not for the database itself to finish booting.
+ */
+export async function connectWithFallback(workers, connect, timeout) {
+    let sw;
+    try {
+        // `workers.shared()` throws synchronously when `SharedWorker` is
+        // undefined, so there is no separate feature test to do first.
+        sw = workers.shared();
+        const failed = new Promise((_resolve, reject) => {
+            sw?.addEventListener('error', () => reject(new Error('SharedWorker failed to load')), {
+                once: true,
+            });
+        });
+        const shim = portAsWorker(sw.port);
+        const timedOut = rejectAfter(timeout);
+        const db = await Promise.race([connect(shim), failed, timedOut.promise]).finally(() => timedOut.cancel());
+        return { transport: 'shared-worker', db };
+    }
+    catch {
+        // Falling back is the point of this function - never rethrow here.
+        sw?.port.close();
+    }
+    const worker = workers.fallback();
+    return { transport: 'worker', db: await connect(worker) };
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAeA,oEAAoE;AACpE,SAAS,YAAY,CAAC,IAAiB;IACrC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC;YACf,kEAAkE;YAClE,mEAAmE;YACnE,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,gBAAgB,CAAC,GAAG,IAAiD;YACnE,aAAa,EAAE,CAAC;YAChB,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,mBAAmB,CAAC,GAAG,IAAoD;YACzE,IAAI,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,WAAW,CAAC,GAAG,IAA4C;YACzD,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,SAAS;YACP,+DAA+D;YAC/D,4BAA4B;YAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;KACmB,CAAC;AACzB,CAAC;AAED,SAAS,WAAW,CAAC,EAAU;IAC7B,IAAI,KAAoC,CAAC;IAEzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACtD,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gDAAgD,EAAE,IAAI,CAAC,CAAC,EAC/E,EAAE,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAwB,EACxB,OAAuC,EACvC,OAAe;IAEf,IAAI,EAA4B,CAAC;IAEjC,IAAI,CAAC;QACH,iEAAiE;QACjE,+DAA+D;QAC/D,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAEtB,MAAM,MAAM,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACrD,EAAE,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,EAAE;gBACpF,IAAI,EAAE,IAAI;aACX,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CACpF,QAAQ,CAAC,MAAM,EAAE,CAClB,CAAC;QAEF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAElC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import type { Extensions, PGliteInterfaceExtensions } from '@electric-sql/pglite';
+import type { PGliteWorker, PGliteWorkerOptions } from '@electric-sql/pglite/worker';
+import { type WorkerFactories, type WorkerTransport } from './connect.js';
+export type { WorkerFactories, WorkerTransport } from './connect.js';
+export interface SupapowerWorkerOptions<E extends Extensions = Extensions> extends PGliteWorkerOptions<E> {
+    /** Required: groups every tab of this database across both transports. */
+    id: string;
+    /**
+     * Milliseconds to wait for the SharedWorker handshake before falling back
+     * to PGlite's dedicated worker.
+     *
+     * @default 10000
+     */
+    sharedWorkerTimeout?: number;
+}
+/** What {@link createPGliteWorker} resolves to. */
+export type SupapowerWorker<O extends SupapowerWorkerOptions> = PGliteWorker & PGliteInterfaceExtensions<O['extensions']> & {
+    readonly transport: WorkerTransport;
+};
+/**
+ * Opens a multi-tab PGlite database over a `SharedWorker`, falling back to
+ * PGlite's own dedicated-worker transport when the browser has no
+ * `SharedWorker`, or the shared one fails to start in time.
+ *
+ * `id` is required: it is the only value that makes both transports agree on
+ * one election lock and one broadcast channel. PGlite's own default id is
+ * derived from *its own* `import.meta.url`, which differs between the shared
+ * and the fallback worker scripts and would let the two open the same
+ * `dataDir` as if they were unrelated databases.
+ */
+export declare function createPGliteWorker<O extends SupapowerWorkerOptions>(workers: WorkerFactories, options: O): Promise<SupapowerWorker<O>>;
+//# 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,KAAK,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAErF,OAAO,EAAuB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/F,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,sBAAsB,CACrC,CAAC,SAAS,UAAU,GAAG,UAAU,CACjC,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAC9B,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,mDAAmD;AACnD,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,sBAAsB,IAAI,YAAY,GACxE,yBAAyB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC;AAEzF;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,sBAAsB,EACvE,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAiB7B"}

package/dist/index.js

@@ -0,0 +1,24 @@
+import { connectWithFallback } from './connect.js';
+/**
+ * Opens a multi-tab PGlite database over a `SharedWorker`, falling back to
+ * PGlite's own dedicated-worker transport when the browser has no
+ * `SharedWorker`, or the shared one fails to start in time.
+ *
+ * `id` is required: it is the only value that makes both transports agree on
+ * one election lock and one broadcast channel. PGlite's own default id is
+ * derived from *its own* `import.meta.url`, which differs between the shared
+ * and the fallback worker scripts and would let the two open the same
+ * `dataDir` as if they were unrelated databases.
+ */
+export async function createPGliteWorker(workers, options) {
+    // Dynamic: loading `@electric-sql/pglite/worker`'s runtime code is deferred
+    // to the call, not module scope, so this module stays importable under
+    // Node/Bun (SSR, `bun test`) without pulling in browser worker plumbing.
+    // Hoisted ahead of `connectWithFallback` so the `connect` callback below,
+    // which is invoked synchronously inside it, already has `PGliteWorker`.
+    const { PGliteWorker: PGliteWorkerClass } = await import('@electric-sql/pglite/worker');
+    const { transport, db } = await connectWithFallback(workers, (worker) => PGliteWorkerClass.create(worker, options), options.sharedWorkerTimeout ?? 10_000);
+    Object.defineProperty(db, 'transport', { value: transport, enumerable: true });
+    return db;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAA8C,MAAM,cAAc,CAAC;AAsB/F;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAwB,EACxB,OAAU;IAEV,4EAA4E;IAC5E,uEAAuE;IACvE,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IACxE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;IAExF,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,MAAM,mBAAmB,CACjD,OAAO,EACP,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,OAAO,CAAC,mBAAmB,IAAI,MAAM,CACtC,CAAC;IAEF,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/E,OAAO,EAAwB,CAAC;AAClC,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The wire protocol identifiers `PGliteWorker` itself expects, keyed by the
+ * `id` option the client sent. Both transports - the SharedWorker and
+ * PGlite's own dedicated worker - use these same names, which is what lets a
+ * client fall back from one to the other without the two ever colliding.
+ */
+/** The lock a leader-election-style worker holds for as long as it runs. */
+export declare function electionLockId(id: string): string;
+/** The broadcast channel every tab of a group listens on. */
+export declare function broadcastChannelId(id: string): string;
+/** The channel a single tab receives RPC responses and notifications on. */
+export declare function tabChannelId(tabId: string): string;
+/** Held by a tab for as long as it is open, so its worker side can detect closure. */
+export declare function tabCloseLockId(tabId: string): string;
+/**
+ * Resolves once the named lock is granted; the returned function releases it.
+ *
+ * PGlite's own worker helper, retyped so the release function is never
+ * `undefined` - the promise inside `request`'s callback never resolves until
+ * `release` has been captured.
+ */
+export declare function acquireLock(name: string): Promise<() => void>;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAOD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAY7D"}

package/dist/protocol.js

@@ -0,0 +1,38 @@
+/**
+ * The wire protocol identifiers `PGliteWorker` itself expects, keyed by the
+ * `id` option the client sent. Both transports - the SharedWorker and
+ * PGlite's own dedicated worker - use these same names, which is what lets a
+ * client fall back from one to the other without the two ever colliding.
+ */
+/** The lock a leader-election-style worker holds for as long as it runs. */
+export function electionLockId(id) {
+    return `pglite-election-lock:${id}`;
+}
+/** The broadcast channel every tab of a group listens on. */
+export function broadcastChannelId(id) {
+    return `pglite-broadcast:${id}`;
+}
+/** The channel a single tab receives RPC responses and notifications on. */
+export function tabChannelId(tabId) {
+    return `pglite-tab:${tabId}`;
+}
+/** Held by a tab for as long as it is open, so its worker side can detect closure. */
+export function tabCloseLockId(tabId) {
+    return `pglite-tab-close:${tabId}`;
+}
+/**
+ * Resolves once the named lock is granted; the returned function releases it.
+ *
+ * PGlite's own worker helper, retyped so the release function is never
+ * `undefined` - the promise inside `request`'s callback never resolves until
+ * `release` has been captured.
+ */
+export function acquireLock(name) {
+    const { navigator } = globalThis;
+    return new Promise((resolve) => {
+        void navigator.locks.request(name, () => new Promise((release) => {
+            resolve(release);
+        }));
+    });
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,wBAAwB,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,OAAO,oBAAoB,EAAE,EAAE,CAAC;AAClC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,cAAc,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,oBAAoB,KAAK,EAAE,CAAC;AACrC,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAmD,CAAC;IAE1E,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;QACzC,KAAK,SAAS,CAAC,KAAK,CAAC,OAAO,CAC1B,IAAI,EACJ,GAAG,EAAE,CACH,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,CAAC,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/shared-worker.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The SharedWorker side of a multi-tab PGlite database: one instance serves
+ * every tab of one browser context, so the database is never owned by a
+ * particular tab and is never handed over when one closes.
+ *
+ * `connectTab` and `makeWorkerApi` below are derived from
+ * `@electric-sql/pglite`'s `packages/pglite/src/worker/index.ts`
+ * (Apache-2.0, copyright ElectricSQL) and have been modified to use this
+ * package's id helpers. Everything else - the per-port handshake in
+ * {@link createConnectHandler} and {@link sharedWorker} - is new: it
+ * replaces upstream's `postMessage`-based single-client handshake and
+ * leader election, neither of which apply here since exactly one
+ * SharedWorker already exists per origin and database id.
+ */
+import type { WorkerOptions } from '@electric-sql/pglite/worker';
+/**
+ * Builds the per-port connection handler for one database group.
+ *
+ * The database boots once, on the first port to send `init`; every port -
+ * including ones that connect long after that - gets `here` then `ready`.
+ */
+export declare function createConnectHandler(options: WorkerOptions): (port: MessagePort) => void;
+/** Runs a `WorkerOptions.init`-configured PGlite database as a SharedWorker. */
+export declare function sharedWorker(options: WorkerOptions): void;
+//# sourceMappingURL=shared-worker.d.ts.map

package/dist/shared-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-worker.d.ts","sourceRoot":"","sources":["../src/shared-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AA+NjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CA2ExF;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAYzD"}

package/dist/shared-worker.js

@@ -0,0 +1,236 @@
+/**
+ * The SharedWorker side of a multi-tab PGlite database: one instance serves
+ * every tab of one browser context, so the database is never owned by a
+ * particular tab and is never handed over when one closes.
+ *
+ * `connectTab` and `makeWorkerApi` below are derived from
+ * `@electric-sql/pglite`'s `packages/pglite/src/worker/index.ts`
+ * (Apache-2.0, copyright ElectricSQL) and have been modified to use this
+ * package's id helpers. Everything else - the per-port handshake in
+ * {@link createConnectHandler} and {@link sharedWorker} - is new: it
+ * replaces upstream's `postMessage`-based single-client handshake and
+ * leader election, neither of which apply here since exactly one
+ * SharedWorker already exists per origin and database id.
+ */
+import { acquireLock, broadcastChannelId, electionLockId, tabChannelId, tabCloseLockId, } from './protocol.js';
+function connectTab(tabId, pg, connectedTabs) {
+    if (connectedTabs.has(tabId)) {
+        return;
+    }
+    connectedTabs.add(tabId);
+    const tabChannel = new BroadcastChannel(tabChannelId(tabId));
+    // The tab-close lock is held by the client for as long as it is open, so
+    // it becomes available the moment the tab (or its `PGliteWorker`) closes.
+    // oxlint-disable-next-line promise/always-return -- fire-and-forget cleanup, nothing to chain onto.
+    void acquireLock(tabCloseLockId(tabId)).then(() => {
+        tabChannel.close();
+        connectedTabs.delete(tabId);
+    });
+    const api = makeWorkerApi(tabId, pg);
+    tabChannel.addEventListener('message', async (event) => {
+        const msg = event.data;
+        if (msg.type !== 'rpc-call') {
+            return;
+        }
+        await pg.waitReady;
+        const { callId, method, args } = msg;
+        try {
+            // @ts-ignore no apparent reason why it fails
+            const result = (await api[method](...args));
+            tabChannel.postMessage({
+                type: 'rpc-return',
+                callId,
+                result,
+            });
+        }
+        catch (error) {
+            // oxlint-disable-next-line no-console
+            console.error(error);
+            tabChannel.postMessage({
+                type: 'rpc-error',
+                callId,
+                error: { message: error.message },
+            });
+        }
+    });
+    // Send a message to the tab to let it know it's connected
+    tabChannel.postMessage({ type: 'connected' });
+}
+function makeWorkerApi(tabId, db) {
+    let queryLockRelease = null;
+    let transactionLockRelease = null;
+    // If the tab is closed while it is holding a lock, release the locks and
+    // roll back any pending transaction.
+    // oxlint-disable-next-line promise/always-return -- fire-and-forget cleanup, nothing to chain onto.
+    void acquireLock(tabCloseLockId(tabId)).then(() => {
+        if (transactionLockRelease) {
+            void db.exec('ROLLBACK');
+        }
+        queryLockRelease?.();
+        transactionLockRelease?.();
+    });
+    return {
+        async getDebugLevel() {
+            return db.debug;
+        },
+        async close() {
+            await db.close();
+        },
+        async execProtocol(message) {
+            const { messages, data } = await db.execProtocol(message);
+            if (data.byteLength !== data.buffer.byteLength) {
+                const buffer = new ArrayBuffer(data.byteLength);
+                const dataCopy = new Uint8Array(buffer);
+                dataCopy.set(data);
+                return { messages, data: dataCopy };
+            }
+            return { messages, data };
+        },
+        async execProtocolStream(message) {
+            return await db.execProtocolStream(message);
+        },
+        async execProtocolRawStream(message, options) {
+            return await db.execProtocolRawStream(message, options);
+        },
+        async execProtocolRaw(message) {
+            const result = await db.execProtocolRaw(message);
+            if (result.byteLength !== result.buffer.byteLength) {
+                // The data is a slice of a larger buffer, potentially the whole
+                // memory of the WASM module - copy it out before it is sent.
+                const buffer = new ArrayBuffer(result.byteLength);
+                const resultCopy = new Uint8Array(buffer);
+                resultCopy.set(result);
+                return resultCopy;
+            }
+            return result;
+        },
+        async dumpDataDir(compression) {
+            return await db.dumpDataDir(compression);
+        },
+        async syncToFs() {
+            return await db.syncToFs();
+        },
+        // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+        async _handleBlob(blob) {
+            // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+            return await db._handleBlob(blob);
+        },
+        // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+        async _getWrittenBlob() {
+            // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+            return await db._getWrittenBlob();
+        },
+        // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+        async _cleanupBlob() {
+            // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+            return await db._cleanupBlob();
+        },
+        // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+        async _checkReady() {
+            // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+            return await db._checkReady();
+        },
+        async _acquireQueryLock() {
+            return new Promise((resolve) => {
+                // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+                void db._runExclusiveQuery(() => new Promise((release) => {
+                    queryLockRelease = release;
+                    resolve();
+                }));
+            });
+        },
+        async _releaseQueryLock() {
+            queryLockRelease?.();
+            queryLockRelease = null;
+        },
+        async _acquireTransactionLock() {
+            return new Promise((resolve) => {
+                // oxlint-disable-next-line no-underscore-dangle -- PGlite's own method name.
+                void db._runExclusiveTransaction(() => new Promise((release) => {
+                    transactionLockRelease = release;
+                    resolve();
+                }));
+            });
+        },
+        async _releaseTransactionLock() {
+            transactionLockRelease?.();
+            transactionLockRelease = null;
+        },
+    };
+}
+/**
+ * Builds the per-port connection handler for one database group.
+ *
+ * The database boots once, on the first port to send `init`; every port -
+ * including ones that connect long after that - gets `here` then `ready`.
+ */
+export function createConnectHandler(options) {
+    const scope = globalThis;
+    let idResolve;
+    const idPromise = new Promise((resolve) => {
+        idResolve = resolve;
+    });
+    let started = false;
+    let dbPromise;
+    const connectedTabs = new Set();
+    const start = async (id, initOptions) => {
+        // Guards the case where a tab already fell back to a dedicated worker
+        // and owns this database: this worker then simply waits here forever,
+        // while its own clients still reach the real owner over the broadcast
+        // channel, because both transports speak the same protocol under the
+        // same ids.
+        await acquireLock(electionLockId(id));
+        dbPromise = options.init(initOptions);
+        const channel = new BroadcastChannel(broadcastChannelId(id));
+        channel.addEventListener('message', (event) => {
+            const msg = event.data;
+            if (msg.type === 'tab-here') {
+                void dbPromise?.then((db) => connectTab(msg.id, db, connectedTabs));
+            }
+        });
+        // Tabs left over from a previous worker generation reset and re-announce
+        // themselves - `PGliteWorker` re-sends `tab-here` every 16ms until it is
+        // connected - so this goes out before the database has finished booting.
+        channel.postMessage({ type: 'leader-here', id });
+        const db = await dbPromise;
+        db.onNotification((notifyChannel, payload) => {
+            channel.postMessage({ type: 'notify', channel: notifyChannel, payload });
+        });
+    };
+    return (port) => {
+        port.start();
+        port.postMessage({ type: 'here' });
+        let initialized = false;
+        port.addEventListener('message', (event) => {
+            const msg = event.data;
+            if (msg.type !== 'init' || initialized) {
+                return;
+            }
+            initialized = true;
+            if (!started) {
+                started = true;
+                const initOptions = msg.options;
+                const id = initOptions.id ?? `${scope.location.href}:${initOptions.dataDir ?? ''}`;
+                idResolve(id);
+                void start(id, initOptions);
+            }
+            // oxlint-disable-next-line promise/always-return -- fire-and-forget reply, nothing to chain onto.
+            void idPromise.then((id) => {
+                port.postMessage({ type: 'ready', id });
+            });
+        });
+    };
+}
+/** Runs a `WorkerOptions.init`-configured PGlite database as a SharedWorker. */
+export function sharedWorker(options) {
+    const scope = globalThis;
+    const handleConnect = createConnectHandler(options);
+    // oxlint-disable-next-line unicorn/prefer-add-event-listener -- the standard SharedWorker handshake API.
+    scope.onconnect = (event) => {
+        const port = event.ports[0];
+        if (port) {
+            handleConnect(port);
+        }
+    };
+}
+//# sourceMappingURL=shared-worker.js.map

package/dist/shared-worker.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,11 @@
+import type { WorkerOptions } from '@electric-sql/pglite/worker';
+/**
+ * The one worker entry point for `@supapower/worker`.
+ *
+ * Runs as a `SharedWorker` when the script is loaded as one - PGlite's own
+ * `worker()` calls the global `postMessage`, which does not exist in a
+ * SharedWorker scope, so the branch below is required, not cosmetic - and
+ * falls back to PGlite's own dedicated worker otherwise.
+ */
+export declare function worker(options: WorkerOptions): Promise<void>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBlE"}

package/dist/worker.js

@@ -0,0 +1,23 @@
+/**
+ * The one worker entry point for `@supapower/worker`.
+ *
+ * Runs as a `SharedWorker` when the script is loaded as one - PGlite's own
+ * `worker()` calls the global `postMessage`, which does not exist in a
+ * SharedWorker scope, so the branch below is required, not cosmetic - and
+ * falls back to PGlite's own dedicated worker otherwise.
+ */
+export async function worker(options) {
+    if ('SharedWorkerGlobalScope' in globalThis) {
+        // Dynamic: `./shared-worker.js` touches `BroadcastChannel`/`navigator.locks`
+        // at import time in some bundlers' eager-eval mode, so it must load lazily
+        // to keep this module importable from Node/Bun outside a worker.
+        const { sharedWorker } = await import('./shared-worker.js');
+        sharedWorker(options);
+        return;
+    }
+    // Dynamic for the same reason: PGlite's dedicated-worker entry point pulls
+    // in browser-only worker plumbing that must not run outside a worker scope.
+    const { worker: dedicatedWorker } = await import('@electric-sql/pglite/worker');
+    await dedicatedWorker(options);
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAsB;IACjD,IAAI,yBAAyB,IAAI,UAAU,EAAE,CAAC;QAC5C,6EAA6E;QAC7E,2EAA2E;QAC3E,iEAAiE;QACjE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAE5D,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,OAAO;IACT,CAAC;IAED,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;IAEhF,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@supapower/worker",
+  "version": "0.1.0",
+  "description": "A more stable drop-in replacement for PGlite's built-in multi-tab worker, using a SharedWorker with automatic fallback",
+  "keywords": [
+    "local-first",
+    "multi-tab",
+    "pglite",
+    "shared-worker",
+    "supapower",
+    "worker"
+  ],
+  "homepage": "https://github.com/aboviq/supapower/tree/main/packages/worker#readme",
+  "bugs": {
+    "url": "https://github.com/aboviq/supapower/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "Aboviq AB",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aboviq/supapower.git",
+    "directory": "packages/worker"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./worker": {
+      "types": "./dist/worker.d.ts",
+      "default": "./dist/worker.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc --project tsconfig.json"
+  },
+  "devDependencies": {
+    "@electric-sql/pglite": "^0.5.8"
+  },
+  "peerDependencies": {
+    "@electric-sql/pglite": ">=0.5.8 <0.6.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}