@phpsandbox/sdk 0.0.30 → 0.0.33

package/README.md

@@ -79,12 +79,20 @@ await fetched.ready();
 
 const forked = await created.fork();
 await forked.delete();
+
+const persistent = await client.notebook.create('laravel', {
+  title: 'Persistent Laravel',
+  persistent: true,
+});
+
+console.log(persistent.data.policy);
 ```
 
 Notes:
 
 - `create()` and `fork()` initialize automatically.
 - `open()` and `get()` return a notebook instance; call `await notebook.ready()` before using tools.
+- API notebook creates are ephemeral by default. `persistent: true` requires an entitled account.
 
 ## Services At A Glance
 
@@ -103,6 +111,12 @@ Each `NotebookInstance` exposes service clients:
 - `notebook.log` (`Log`)
 - `notebook.services` (`Services`)
 
+Notes:
+
+- `terminal.spawn()` and `shell.exec()` are part of the current okra websocket action set. `terminal.start` currently is not.
+- `notebook.repl.eval()` is part of the current okra websocket action set. `repl.start` is currently not.
+- `notebook.laravel` is exposed by the SDK, but the current okra websocket action set does not expose Laravel maintenance actions.
+
 ## Common Operations
 
 ### Files
@@ -148,9 +162,14 @@ console.log(result.output);
 ### Services
 
 ```ts
+import { notebookBuiltinServices } from '@phpsandbox/sdk';
+
 const services = await notebook.services.list();
 
+console.log(notebookBuiltinServices); // ['redis']
+
 await notebook.services.run('redis');
+await notebook.services.run('queue', 'php artisan queue:work');
 
 const snapshot = await notebook.services.logs('redis', { tail: 50 });
 console.log(snapshot);

package/dist/browser/phpsandbox-sdk.esm.js

@@ -639,19 +639,30 @@ var Terminal = class {
       },
       close: dispose
     });
+    let controller = null;
     const output = new ReadableStream({
-      start: (controller) => {
+      start: (_controller) => {
+        controller = _controller;
         disposables.add(
           this.listen(`terminal.output.${id}`, (data) => {
-            controller.enqueue(data.output);
+            controller?.enqueue(data.output);
           })
         );
       },
-      cancel: dispose
+      cancel: () => {
+        controller = null;
+        dispose();
+      }
     });
     const exit = new Promise((resolve) => {
       disposables.add(
         this.listen(`terminal.close.${id}`, (data) => {
+          if (controller) {
+            try {
+              controller.close();
+            } catch {
+            }
+          }
           dispose();
           resolve(data.exitCode);
         })
@@ -1027,6 +1038,8 @@ var Shell = class {
 };
 
 // src/services.ts
+var notebookBuiltinServices = ["redis"];
+var notebookKnownServices = ["start", "nginx", ...notebookBuiltinServices];
 var Services = class {
   constructor(okra) {
     this.okra = okra;
@@ -1034,8 +1047,11 @@ var Services = class {
   list() {
     return this.okra.invoke("service.list");
   }
-  run(name) {
-    return this.okra.invoke("service.run", { name });
+  run(name, command) {
+    return this.okra.invoke("service.run", {
+      name,
+      command
+    });
   }
   stop(name) {
     return this.okra.invoke("service.stop", { name });
@@ -3177,7 +3193,7 @@ var Transport = class {
     this.connectionStats.connectionStartTime = Date.now();
     const startClosed = options.startClosed !== false;
     this.rws = new reconnecting_websocket_mjs_default(this.url.toString(), [], {
-      WebSocket: globalThis.WebSocket ?? browser_default,
+      WebSocket: options.webSocket ?? globalThis.WebSocket ?? browser_default,
       connectionTimeout: options.connectionTimeout,
       maxReconnectionDelay: 2e3,
       minReconnectionDelay: 200,
@@ -3232,7 +3248,19 @@ var Transport = class {
   async registerWatchers() {
     const onMessage = (ev) => {
       if (!(ev.data instanceof Blob)) {
-        throw new Error("Unexpected message type: " + typeof ev.data);
+        const error = new Error("Unexpected message type: " + typeof ev.data);
+        this.connectionStats.totalErrors++;
+        this.log("error", "Unexpected WebSocket message type", {
+          error: error.message,
+          messageType: typeof ev.data
+        });
+        this.eventEmitter.emit("transport.error", {
+          type: "message_type_error",
+          error,
+          rawMessage: ev.data,
+          timestamp: Date.now()
+        });
+        return;
       }
       ev.data.arrayBuffer().then((buffer) => {
         if (buffer.byteLength === 0) {
@@ -3240,7 +3268,19 @@ var Transport = class {
           return;
         }
         try {
-          this.handleRawMessage(decode(buffer));
+          void this.handleRawMessage(decode(buffer)).catch((error) => {
+            this.connectionStats.totalErrors++;
+            this.log("error", "Failed to process WebSocket frame", {
+              error: error instanceof Error ? error.message : String(error),
+              byteLength: buffer.byteLength
+            });
+            this.eventEmitter.emit("transport.error", {
+              type: "message_handle_error",
+              error,
+              rawMessage: buffer,
+              timestamp: Date.now()
+            });
+          });
         } catch (error) {
           this.connectionStats.totalErrors++;
           this.log("error", "Failed to decode WebSocket frame", {
@@ -3264,6 +3304,10 @@ var Transport = class {
     });
   }
   async handleRawMessage(ev) {
+    if (this.closed) {
+      this.log("debug", "Ignoring message received after transport was closed");
+      return;
+    }
     if (typeof ev !== "object" || ev === null) {
       this.log("debug", "Received invalid message format", { ev });
       return;
@@ -4925,7 +4969,8 @@ var NotebookInstance = class {
     this.emitter = EventManager.createInstance();
     this.socket = new Transport(data.okraUrl, this.emitter, {
       debug: client.options.debug,
-      startClosed: client.options.startClosed
+      startClosed: client.options.startClosed,
+      webSocket: client.options.webSocket
     });
     this.watchConnection();
     __privateSet(this, _initPromise, __privateMethod(this, _NotebookInstance_instances, init_fn).call(this));
@@ -5093,6 +5138,8 @@ init_fn = function() {
       reject(error);
     });
   }));
+  void __privateGet(this, _initPromise).catch(() => {
+  });
   return __privateGet(this, _initPromise);
 };
 var NotebookSecrets = class {
@@ -5144,6 +5191,8 @@ export {
   Transport,
   createBeacon,
   isBeaconSupported,
+  notebookBuiltinServices,
+  notebookKnownServices,
   once,
   timeout
 };