@phpsandbox/sdk 0.1.10 → 0.1.12

package/dist/http.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cloudflare Workers does not support `redirect: "error"`, while `follow` can
+ * forward authorization headers across redirects. Handle redirects manually so
+ * authenticated requests never follow them.
+ */
+export declare function authenticatedRequest(input: URL | string, init: RequestInit): Request;

package/dist/http.js

@@ -0,0 +1,11 @@
+/**
+ * Cloudflare Workers does not support `redirect: "error"`, while `follow` can
+ * forward authorization headers across redirects. Handle redirects manually so
+ * authenticated requests never follow them.
+ */
+export function authenticatedRequest(input, init) {
+    return new Request(input, {
+        ...init,
+        redirect: 'manual',
+    });
+}

package/dist/index.js

@@ -30,6 +30,7 @@ import { RestRuntimeInvoker } from './runtime/rest.js';
 import { Feedback } from './feedback.js';
 import { IntegrationApi } from './integrations.js';
 import { SandboxIntegrationApi } from './sandbox-integrations.js';
+import { authenticatedRequest } from './http.js';
 export { LspConnection } from './lsp.js';
 export { FileChangeFilter, FileChangeType, FileType, } from './filesystem.js';
 export { notebookBuiltinServices, notebookKnownServices } from './services.js';
@@ -105,10 +106,9 @@ class ClientImplementation {
         return this.makeRequest('PATCH', path, { body: body === undefined ? undefined : JSON.stringify(body) });
     }
     async stream(path) {
-        const response = await this.fetchResponse(new Request(new URL(path.replace(/^\//, ''), this.baseUrl), {
+        const response = await this.fetchResponse(authenticatedRequest(new URL(path.replace(/^\//, ''), this.baseUrl), {
             method: 'GET',
             headers: this.headers,
-            redirect: 'error',
         }));
         if (!response.ok) {
             throw remoteError('core', errorPayload(await responsePayload(response)), response);
@@ -119,9 +119,8 @@ class ClientImplementation {
         return response.body;
     }
     async sse(url) {
-        const response = await this.fetchResponse(new Request(url, {
+        const response = await this.fetchResponse(authenticatedRequest(url, {
             method: 'GET',
-            redirect: 'error',
             headers: {
                 ...this.headers,
                 'Accept': 'text/event-stream',
@@ -136,11 +135,10 @@ class ClientImplementation {
         return response.body;
     }
     async makeRequest(method, path, init) {
-        const response = await this.fetchResponse(new Request(new URL(path.replace(/^\//, ''), this.baseUrl), {
+        const response = await this.fetchResponse(authenticatedRequest(new URL(path.replace(/^\//, ''), this.baseUrl), {
             method,
             ...init,
             headers: this.headers,
-            redirect: 'error',
         }));
         if (!response.ok) {
             throw remoteError('core', errorPayload(await responsePayload(response)), response);

package/dist/ports.d.ts

@@ -6,5 +6,6 @@ export default class Ports {
     private readonly telemetry;
     constructor(okra: NotebookInstance, telemetry: RuntimeTelemetry);
     list(): Promise<PortInfo[]>;
+    resolve(port: number): Promise<PortInfo>;
     watch(options?: RuntimeWatchOptions): ReadableStream<PortInfo[]>;
 }

package/dist/ports.js

@@ -7,6 +7,9 @@ export default class Ports {
     list() {
         return this.okra.invoke('container.opened-ports');
     }
+    resolve(port) {
+        return this.okra.invoke('container.resolve-port', { port });
+    }
     watch(options = {}) {
         return watchRuntimeTelemetry(this.okra, this.telemetry, 'ports', 'container.ports', (ports) => ports, options);
     }

package/dist/runtime/rest.js

@@ -1,4 +1,5 @@
 import { PHPSandboxError, RemoteError, TransportError, remoteError } from '../errors/index.js';
+import { authenticatedRequest } from '../http.js';
 const restActionRoutes = {
     'runtime.ready': { method: 'GET', path: '/runtime' },
     'config.get': { method: 'GET', path: '/runtime/config' },
@@ -8,6 +9,7 @@ const restActionRoutes = {
     'container.stop': { method: 'POST', path: '/runtime/container/stop' },
     'container.set-php': { method: 'PUT', path: '/runtime/container/php' },
     'container.opened-ports': { method: 'GET', path: '/runtime/container/ports' },
+    'container.resolve-port': { method: 'POST', path: '/runtime/container/ports/resolve' },
     'container.stats': { method: 'GET', path: '/runtime/container/stats' },
     'terminal.list': { method: 'GET', path: '/runtime/terminals' },
     'shell.exec': { method: 'POST', path: '/runtime/executions' },
@@ -119,12 +121,11 @@ export class RestRuntimeInvoker {
             Authorization: `Bearer ${this.ticket}`,
         };
         const body = runtimeActionRequestBody(action, data, url, headers);
-        return new Request(url, {
+        return authenticatedRequest(url, {
             method: route.method,
             headers,
             body: route.method === 'GET' ? undefined : body,
             signal,
-            redirect: 'error',
         });
     }
     async refreshAuthorization() {

package/dist/runtime.d.ts

@@ -28,6 +28,9 @@ export interface RuntimeActions {
     'container.restart': Action<{}, void>;
     'container.stop': Action<{}, void>;
     'container.opened-ports': Action<{}, PortInfo[]>;
+    'container.resolve-port': Action<{
+        port: number;
+    }, PortInfo>;
     'container.stats': Action<{}, RuntimeStats | null>;
     'container.set-php': Action<{
         version: string;
@@ -54,6 +57,7 @@ export declare class RuntimePorts {
     private readonly ports;
     constructor(ports: Ports);
     list(): Promise<PortInfo[]>;
+    resolve(port: number): Promise<PortInfo>;
     watch(options?: RuntimeWatchOptions): ReadableStream<PortInfo[]>;
 }
 export default class Runtime {

package/dist/runtime.js

@@ -28,6 +28,9 @@ export class RuntimePorts {
     list() {
         return this.ports.list();
     }
+    resolve(port) {
+        return this.ports.resolve(port);
+    }
     watch(options = {}) {
         return this.ports.watch(options);
     }

package/docs/api-summary.md

@@ -62,6 +62,7 @@ Connection lifecycle methods, streaming actions, and event subscriptions require
 
 - `notebook.runtime.logs.follow({ signal? })` returns `ReadableStream<RuntimeLogEntry>`
 - `notebook.runtime.ports.list()` returns the current preview ports
+- `notebook.runtime.ports.resolve(port)` returns preview routing information even when the port is not open
 - `notebook.runtime.ports.watch({ signal? })` returns `ReadableStream<PortInfo[]>`
 - `notebook.runtime.metrics.current()` returns the current CPU, memory, and disk sample
 - `notebook.runtime.metrics.watch({ signal? })` returns `ReadableStream<RuntimeStats>`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phpsandbox/sdk",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "A comprehensive TypeScript SDK for interacting with cloud-based PHP development environments",
   "main": "./dist/index.js",
   "module": "./dist/index.js",