@phpsandbox/sdk 0.0.2

package/dist/auth.d.ts

@@ -0,0 +1,14 @@
+import { Action, NotebookInstance } from './index.js';
+export interface AuthActions {
+    'auth.login': Action<{
+        newConnectionData: string;
+    }, boolean>;
+    'auth.logout': Action<null>;
+}
+export default class Auth {
+    protected okra: NotebookInstance;
+    constructor(okra: NotebookInstance);
+    logout(): Promise<void>;
+    login(newConnectionData: string): Promise<boolean>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,OAAO,IAAI;IACX,SAAS,CAAC,IAAI,EAAE,gBAAgB;gBAAtB,IAAI,EAAE,gBAAgB;IAErC,MAAM;IAIN,KAAK,CAAC,iBAAiB,EAAE,MAAM;CAGvC"}

package/dist/auth.js

@@ -0,0 +1,12 @@
+export default class Auth {
+    constructor(okra) {
+        this.okra = okra;
+    }
+    logout() {
+        return this.okra.invoke('auth.logout');
+    }
+    login(newConnectionData) {
+        return this.okra.invoke('auth.login', { newConnectionData });
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,OAAO,OAAO,IAAI;IACvB,YAAsB,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEzC,MAAM;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,iBAAyB;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/beacon/index.d.ts

@@ -0,0 +1,169 @@
+import { Disposable } from '../types.js';
+import { BeaconActions, BeaconEvents, BeaconOptions, DebugInfo, ConsoleEvent, BeaconErrorEvent, DebugRequest, DebugResult, FetchRequest, FetchResult } from './types.js';
+import { Navigator } from './navigator.js';
+export * from './types.js';
+export { Navigator } from './navigator.js';
+/**
+ * BeaconError for beacon-specific errors
+ */
+export declare class BeaconError extends Error {
+    code?: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * BeaconTimeoutError for timeout-specific errors
+ */
+export declare class BeaconTimeoutError extends BeaconError {
+    constructor(operation: string, timeoutMs: number);
+}
+/**
+ * BeaconConnectionError for connection-specific errors
+ */
+export declare class BeaconConnectionError extends BeaconError {
+    constructor(message: string);
+}
+/**
+ * Beacon SDK for communicating with beacon instances in iframes
+ */
+export declare class Beacon implements BeaconActions {
+    readonly iframe: HTMLIFrameElement;
+    private options;
+    private messageHandlers;
+    private eventEmitter;
+    private isBeaconReady;
+    private readyPromise;
+    private isStarted;
+    private disposables;
+    private messageChannel;
+    private port;
+    private channelEstablished;
+    readonly navigator: Navigator;
+    constructor(iframe: HTMLIFrameElement, options?: BeaconOptions);
+    /**
+     * Setup communication channel using MessagePort
+     */
+    private setupMessageChannel;
+    /**
+     * Establish MessagePort communication channel
+     */
+    private establishChannel;
+    /**
+     * Handle incoming beacon messages
+     */
+    private handleBeaconMessage;
+    /**
+     * Wait for beacon to be ready - simplified approach
+     */
+    private waitForBeaconReady;
+    /**
+     * Send a message to the beacon via MessagePort
+     */
+    private sendMessage;
+    /**
+     * Send a message and wait for a specific response with retry logic
+     */
+    private sendAndWaitFor;
+    /**
+     * Generate a unique ID for messages
+     */
+    private generateId;
+    /**
+     * Event emitter methods (both private and public for navigator access)
+     */
+    emit(event: string, payload: any): void;
+    /**
+     * Start the beacon initialization process
+     */
+    start(): Promise<void>;
+    /**
+     * Wait for the beacon to be ready
+     */
+    ready(): Promise<void>;
+    /**
+     * Check if beacon is ready
+     */
+    get isReady(): boolean;
+    /**
+     * Listen for beacon events
+     */
+    on<K extends keyof BeaconEvents>(event: K, handler: (payload: BeaconEvents[K]) => void): Disposable;
+    /**
+     * Listen for beacon events (one-time)
+     */
+    once<K extends keyof BeaconEvents>(event: K, handler: (payload: BeaconEvents[K]) => void): void;
+    /**
+     * Ping the beacon to check if it's responsive
+     */
+    ping(): Promise<boolean>;
+    /**
+     * Get debug information from the beacon
+     */
+    getDebugInfo(): Promise<DebugInfo>;
+    /**
+     * Get console events from the beacon
+     */
+    getConsoleEvents(): Promise<ConsoleEvent[]>;
+    /**
+     * Get error events from the beacon
+     */
+    getErrorEvents(): Promise<BeaconErrorEvent[]>;
+    /**
+     * Clear console events in the beacon
+     */
+    clearConsole(): Promise<void>;
+    /**
+     * Clear error events in the beacon
+     */
+    clearErrors(): Promise<void>;
+    /**
+     * Execute code in the beacon context
+     */
+    executeCode(code: string): Promise<{
+        success: boolean;
+        result?: any;
+        error?: string;
+    }>;
+    /**
+     * Inspect an element in the beacon context
+     */
+    inspectElement(selector: string): Promise<{
+        success: boolean;
+        element?: any;
+        error?: string;
+    }>;
+    /**
+     * Fetch a URL in the beacon context
+     */
+    fetch<T extends unknown>(request: FetchRequest): Promise<FetchResult<T>>;
+    /**
+     * Debug a page (navigate and capture debug information). It loads
+     * the page fresh in the IFRAME so that we can capture the latest state.
+     */
+    debug(request: DebugRequest, waitSeconds?: number): Promise<DebugResult>;
+    private wait;
+    /**
+     * Navigate the iframe to a new URL
+     */
+    navigate(url: string): void;
+    /**
+     * Get current iframe URL
+     */
+    get url(): string;
+    /**
+     * Get the iframe element
+     */
+    get element(): HTMLIFrameElement;
+    /**
+     * Dispose of all resources
+     */
+    dispose(): void;
+}
+/**
+ * Factory function to create a beacon instance for an iframe
+ */
+export declare function createBeacon(iframe: HTMLIFrameElement, options?: BeaconOptions): Beacon;
+/**
+ * Check if the current environment supports the Beacon SDK
+ */
+export declare function isBeaconSupported(): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/beacon/index.d.ts.map

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