@phpsandbox/sdk 0.1.13 → 0.1.15

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) PHPSandbox
+Copyright (c) Xeviant LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -22,14 +22,10 @@ if (!token) throw new Error('Missing PHPSANDBOX_TOKEN');
 
 const client = PHPSandbox.realtime(token);
 const notebook = await client.notebook.create('standard');
-
 await notebook.files.write('hello.php', '<?php echo "Hello from PHPSandbox";');
 const result = await notebook.exec('php', ['hello.php']);
-if (result.exitCode !== 0) throw new Error(result.stderr || result.output);
 console.log(result.stdout.trim());
-
 await notebook.destroy();
-notebook.dispose();
 ```
 
 ## Authentication
@@ -97,6 +93,9 @@ Each `NotebookInstance` exposes service clients:
 - `notebook.files` (`Filesystem`)
 - `notebook.terminals` (`Terminals`)
 - `notebook.runtime` (lifecycle, configuration, logs, metrics, and ports)
+- `notebook.config` (`Config`)
+- `notebook.secrets` (runtime secrets)
+- `notebook.preview` (preview access and sessions)
 - `notebook.composer` (`Composer`)
 - `notebook.git` (`Git`)
 - `notebook.integrations` (`SandboxIntegrationApi`)
@@ -301,21 +300,21 @@ await notebook.mail.disable();
 ### Feedback
 
 ```ts
-await sandbox.feedback.configure({
+await notebook.feedback.configure({
   widget: {
     targets: ['preview', 'publication'],
     types: ['bug', 'suggestion', 'question'],
   },
 });
 
-const feedback = await sandbox.feedback.submit({
+const feedback = await notebook.feedback.submit({
   type: 'bug',
   message: 'Saving the profile failed.',
   author: { externalId: 'customer-42', email: 'ada@example.com' },
   context: { url: 'https://app.example.com/profile', path: '/profile' },
 });
 
-await sandbox.feedback.update(feedback.id, { status: 'resolved' });
+await notebook.feedback.update(feedback.id, { status: 'resolved' });
 ```
 
 The server-side SDK uses the same PHPSandbox API token as the rest of the sandbox. Set `widget: null` to remove the optional popout without disabling API ingestion.
@@ -362,20 +361,10 @@ try {
 }
 ```
 
-## Browser/CDN Usage
-
-See [Browser usage](docs/cdn-usage.md) for ESM and script-tag examples.
-
-## More Docs
-
-- Getting started walkthrough: [Getting started](docs/getting-started.md)
-- API overview: [API overview](docs/api-summary.md)
-- Examples: [Examples](examples/README.md)
-
 ## Support
 
 - Issues: https://github.com/phpsandbox/sdk/issues
-- Product docs: https://docs.phpsandbox.io
+- Product docs: https://phpsandbox.io/docs
 
 ## License
 

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

@@ -71,9 +71,10 @@ var RemoteError = class _RemoteError extends PHPSandboxError {
   }
 };
 var TransportError = class _TransportError extends PHPSandboxError {
-  constructor(message, code, cause) {
+  constructor(message, code, cause, response) {
     super(message, cause);
     this.code = code;
+    this.response = response;
   }
   static is(error51, code) {
     return error51 instanceof _TransportError && (code === void 0 || error51.code === code);
@@ -1038,7 +1039,7 @@ var Composer = class {
   }
 };
 
-// src/runtime-telemetry.ts
+// src/telemetry.ts
 var RuntimeTelemetry = class {
   constructor(okra) {
     this.okra = okra;
@@ -19733,7 +19734,7 @@ var Feedback = class {
   }
 };
 
-// src/integrations.ts
+// src/integrations/account.ts
 var IntegrationApi = class {
   constructor(client) {
     this.client = client;
@@ -19780,7 +19781,7 @@ function integrationId(integration) {
   return typeof integration === "string" ? integration : integration.id;
 }
 
-// src/sandbox-integrations.ts
+// src/integrations/sandbox.ts
 var SandboxIntegrationApi = class {
   constructor(notebookId, client) {
     this.notebookId = notebookId;
@@ -19855,6 +19856,10 @@ var NotebookApi = class {
   constructor(client) {
     this.client = client;
   }
+  async inspectImport(input) {
+    const response = await this.client.post("/notebook/imports/inspect", input);
+    return response.data;
+  }
   async create(template, input = {}) {
     const response = await this.client.post("/notebook", { template, ...input });
     return new NotebookInstance(response.data, this.client);
@@ -19920,7 +19925,7 @@ var ClientImplementation = class {
       })
     );
     if (!response.ok) {
-      throw remoteError("core", errorPayload(await responsePayload(response)), response);
+      throw await responseError(response);
     }
     if (!response.body) {
       throw new TransportError("PHPSandbox API response body is not readable.", "InvalidResponse", response);
@@ -19938,7 +19943,7 @@ var ClientImplementation = class {
       })
     );
     if (!response.ok) {
-      throw remoteError("core", errorPayload(await responsePayload(response)), response);
+      throw await responseError(response);
     }
     if (!response.body) {
       throw new TransportError("PHPSandbox API SSE response body is not readable.", "InvalidResponse", response);
@@ -19954,7 +19959,7 @@ var ClientImplementation = class {
       })
     );
     if (!response.ok) {
-      throw remoteError("core", errorPayload(await responsePayload(response)), response);
+      throw await responseError(response);
     }
     if (response.status === 204) {
       return { data: void 0 };
@@ -19987,15 +19992,21 @@ var ClientImplementation = class {
     }
   }
 };
-async function responsePayload(response) {
+async function responseError(response) {
   const body = await response.text();
-  if (body === "") {
-    return void 0;
-  }
   try {
-    return JSON.parse(body);
-  } catch (error51) {
-    throw new TransportError("PHPSandbox API returned an invalid JSON response.", "InvalidResponse", error51);
+    return remoteError("core", errorPayload(body === "" ? void 0 : JSON.parse(body)), response);
+  } catch {
+    return new TransportError(
+      `PHPSandbox API returned an invalid error response (HTTP ${response.status}).`,
+      "InvalidResponse",
+      response,
+      {
+        status: response.status,
+        statusText: response.statusText,
+        body
+      }
+    );
   }
 }
 function errorPayload(payload) {