@run0/jiki 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,19 @@
+MIT License
+
+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

@@ -0,0 +1,37 @@
+<div align="center">
+  <a href="https://jiki.sh">
+    <img src="../../apps/website/public/favicon.svg" alt="Jiki" width="120" />
+  </a>
+
+<a href="https://jiki.sh"><img alt="jiki logo" src="https://img.shields.io/badge/MADE%20For%20the%20browser-000000.svg?style=for-the-badge"></a>
+<a href="https://www.npmjs.com/package/@run0/jiki"><img alt="NPM version" src="https://img.shields.io/npm/v/@run0/jiki.svg?style=for-the-badge&labelColor=000000"></a>
+<a href="https://github.com/run0/jiki/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/npm/l/@run0/jiki.svg?style=for-the-badge&labelColor=000000"></a>
+<a href="https://jiki.sh/docs"><img alt="jiki logo" src="https://img.shields.io/badge/docs-000000.svg?style=for-the-badge"></a>
+
+</div>
+
+---
+
+A sandboxed Node.js runtime that runs entirely client-side. Filesystem, shell, npm / pnpm, and dev servers. No backend required. 
+
+## A few lines is all it takes
+
+```ts
+import { boot } from "@run0/jiki";
+
+const container = boot();
+container.writeFile("/index.js", 'console.log("Hello from the browser!")');
+await container.run("node index.js");
+// → Hello from the browser!
+```
+
+## Learn more
+
+- [Website](https://jiki.sh)
+- [Documentation](https://jiki.sh/docs)
+- [API Reference](http://localhost:4321/docs/api/boot)
+- [Examples](./examples)
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@run0/jiki",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Lightweight browser-based Node.js runtime with virtual filesystem, npm support, and dev servers.",
   "type": "module",
   "license": "MIT",
@@ -33,6 +33,9 @@
     "src",
     "dist"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "sideEffects": false,
   "dependencies": {
     "acorn": "^8.14.0",

package/src/service-worker.ts

@@ -7,7 +7,13 @@
  * in ServerBridge.initServiceWorker() (default: /__sw__.js).
  */
 
-declare const self: ServiceWorkerGlobalScope;
+// Service Worker global — typed as `any` because TypeScript's standard libs
+// don't include ServiceWorkerGlobalScope without a dedicated tsconfig.
+const sw = self as unknown as {
+  skipWaiting(): Promise<void>;
+  clients: { claim(): Promise<void>; matchAll(): Promise<Client[]> };
+  addEventListener(type: string, listener: (event: any) => void): void;
+};
 
 let mainPort: MessagePort | null = null;
 let requestId = 0;
@@ -29,15 +35,15 @@ function base64ToUint8(base64: string): Uint8Array {
   return bytes;
 }
 
-self.addEventListener("install", () => {
-  (self as unknown as { skipWaiting(): Promise<void> }).skipWaiting();
+sw.addEventListener("install", () => {
+  sw.skipWaiting();
 });
 
-self.addEventListener("activate", event => {
-  event.waitUntil((self as unknown as { clients: Clients }).clients.claim());
+sw.addEventListener("activate", (event: { waitUntil(p: Promise<void>): void }) => {
+  event.waitUntil(sw.clients.claim());
 });
 
-self.addEventListener("message", (event: ExtendableMessageEvent) => {
+sw.addEventListener("message", (event: MessageEvent) => {
   if (event.data?.type === "init" && event.data.port) {
     mainPort = event.data.port as MessagePort;
     mainPort.onmessage = handleMainMessage;
@@ -62,7 +68,7 @@ function handleMainMessage(event: MessageEvent): void {
     const { statusCode, statusMessage, headers, bodyBase64 } = data;
     const body = bodyBase64 ? base64ToUint8(bodyBase64) : new Uint8Array(0);
     pending.resolve(
-      new Response(body, {
+      new Response(body as unknown as BodyInit, {
         status: statusCode,
         statusText: statusMessage,
         headers,
@@ -92,18 +98,21 @@ function handleMainMessage(event: MessageEvent): void {
   }
 }
 
-self.addEventListener("fetch", (event: FetchEvent) => {
+interface SWFetchEvent {
+  request: Request;
+  respondWith(response: Response | Promise<Response>): void;
+}
+
+sw.addEventListener("fetch", (event: SWFetchEvent) => {
   const url = new URL(event.request.url);
   if (!url.pathname.startsWith(VIRTUAL_PREFIX)) return;
 
   if (!mainPort) {
-    (self as unknown as { clients: Clients }).clients
-      .matchAll()
-      .then((clients: readonly Client[]) => {
-        for (const client of clients) {
-          client.postMessage({ type: "sw-needs-init" });
-        }
-      });
+    sw.clients.matchAll().then((clients: Client[]) => {
+      for (const client of clients) {
+        client.postMessage({ type: "sw-needs-init" });
+      }
+    });
     event.respondWith(
       new Response("Service Worker not connected", { status: 503 }),
     );