@onkernel/sdk 0.8.2 → 0.9.0

package/src/resources/browsers/fs/fs.ts

@@ -0,0 +1,385 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as WatchAPI from './watch';
+import {
+  Watch,
+  WatchEventsParams,
+  WatchEventsResponse,
+  WatchStartParams,
+  WatchStartResponse,
+  WatchStopParams,
+} from './watch';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Fs extends APIResource {
+  watch: WatchAPI.Watch = new WatchAPI.Watch(this._client);
+
+  /**
+   * Create a new directory
+   *
+   * @example
+   * ```ts
+   * await client.browsers.fs.createDirectory('id', {
+   *   path: '/J!',
+   * });
+   * ```
+   */
+  createDirectory(id: string, body: FCreateDirectoryParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.put(path`/browsers/${id}/fs/create_directory`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Delete a directory
+   *
+   * @example
+   * ```ts
+   * await client.browsers.fs.deleteDirectory('id', {
+   *   path: '/J!',
+   * });
+   * ```
+   */
+  deleteDirectory(id: string, body: FDeleteDirectoryParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.put(path`/browsers/${id}/fs/delete_directory`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Delete a file
+   *
+   * @example
+   * ```ts
+   * await client.browsers.fs.deleteFile('id', { path: '/J!' });
+   * ```
+   */
+  deleteFile(id: string, body: FDeleteFileParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.put(path`/browsers/${id}/fs/delete_file`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get information about a file or directory
+   *
+   * @example
+   * ```ts
+   * const response = await client.browsers.fs.fileInfo('id', {
+   *   path: '/J!',
+   * });
+   * ```
+   */
+  fileInfo(id: string, query: FFileInfoParams, options?: RequestOptions): APIPromise<FFileInfoResponse> {
+    return this._client.get(path`/browsers/${id}/fs/file_info`, { query, ...options });
+  }
+
+  /**
+   * List files in a directory
+   *
+   * @example
+   * ```ts
+   * const response = await client.browsers.fs.listFiles('id', {
+   *   path: '/J!',
+   * });
+   * ```
+   */
+  listFiles(id: string, query: FListFilesParams, options?: RequestOptions): APIPromise<FListFilesResponse> {
+    return this._client.get(path`/browsers/${id}/fs/list_files`, { query, ...options });
+  }
+
+  /**
+   * Move or rename a file or directory
+   *
+   * @example
+   * ```ts
+   * await client.browsers.fs.move('id', {
+   *   dest_path: '/J!',
+   *   src_path: '/J!',
+   * });
+   * ```
+   */
+  move(id: string, body: FMoveParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.put(path`/browsers/${id}/fs/move`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Read file contents
+   *
+   * @example
+   * ```ts
+   * const response = await client.browsers.fs.readFile('id', {
+   *   path: '/J!',
+   * });
+   *
+   * const content = await response.blob();
+   * console.log(content);
+   * ```
+   */
+  readFile(id: string, query: FReadFileParams, options?: RequestOptions): APIPromise<Response> {
+    return this._client.get(path`/browsers/${id}/fs/read_file`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: 'application/octet-stream' }, options?.headers]),
+      __binaryResponse: true,
+    });
+  }
+
+  /**
+   * Set file or directory permissions/ownership
+   *
+   * @example
+   * ```ts
+   * await client.browsers.fs.setFilePermissions('id', {
+   *   mode: '0611',
+   *   path: '/J!',
+   * });
+   * ```
+   */
+  setFilePermissions(
+    id: string,
+    body: FSetFilePermissionsParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.put(path`/browsers/${id}/fs/set_file_permissions`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Write or create a file
+   *
+   * @example
+   * ```ts
+   * await client.browsers.fs.writeFile(
+   *   'id',
+   *   fs.createReadStream('path/to/file'),
+   *   { path: '/J!' },
+   * );
+   * ```
+   */
+  writeFile(
+    id: string,
+    contents: string | ArrayBuffer | ArrayBufferView | Blob | DataView,
+    params: FWriteFileParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { path: path_, mode } = params;
+    return this._client.put(path`/browsers/${id}/fs/write_file`, {
+      body: contents,
+      query: { path: path_, mode },
+      ...options,
+      headers: buildHeaders([
+        { 'Content-Type': 'application/octet-stream', Accept: '*/*' },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface FFileInfoResponse {
+  /**
+   * Whether the path is a directory.
+   */
+  is_dir: boolean;
+
+  /**
+   * Last modification time.
+   */
+  mod_time: string;
+
+  /**
+   * File mode bits (e.g., "drwxr-xr-x" or "-rw-r--r--").
+   */
+  mode: string;
+
+  /**
+   * Base name of the file or directory.
+   */
+  name: string;
+
+  /**
+   * Absolute path.
+   */
+  path: string;
+
+  /**
+   * Size in bytes. 0 for directories.
+   */
+  size_bytes: number;
+}
+
+/**
+ * Array of file or directory information entries.
+ */
+export type FListFilesResponse = Array<FListFilesResponse.FListFilesResponseItem>;
+
+export namespace FListFilesResponse {
+  export interface FListFilesResponseItem {
+    /**
+     * Whether the path is a directory.
+     */
+    is_dir: boolean;
+
+    /**
+     * Last modification time.
+     */
+    mod_time: string;
+
+    /**
+     * File mode bits (e.g., "drwxr-xr-x" or "-rw-r--r--").
+     */
+    mode: string;
+
+    /**
+     * Base name of the file or directory.
+     */
+    name: string;
+
+    /**
+     * Absolute path.
+     */
+    path: string;
+
+    /**
+     * Size in bytes. 0 for directories.
+     */
+    size_bytes: number;
+  }
+}
+
+export interface FCreateDirectoryParams {
+  /**
+   * Absolute directory path to create.
+   */
+  path: string;
+
+  /**
+   * Optional directory mode (octal string, e.g. 755). Defaults to 755.
+   */
+  mode?: string;
+}
+
+export interface FDeleteDirectoryParams {
+  /**
+   * Absolute path to delete.
+   */
+  path: string;
+}
+
+export interface FDeleteFileParams {
+  /**
+   * Absolute path to delete.
+   */
+  path: string;
+}
+
+export interface FFileInfoParams {
+  /**
+   * Absolute path of the file or directory.
+   */
+  path: string;
+}
+
+export interface FListFilesParams {
+  /**
+   * Absolute directory path.
+   */
+  path: string;
+}
+
+export interface FMoveParams {
+  /**
+   * Absolute destination path.
+   */
+  dest_path: string;
+
+  /**
+   * Absolute source path.
+   */
+  src_path: string;
+}
+
+export interface FReadFileParams {
+  /**
+   * Absolute file path to read.
+   */
+  path: string;
+}
+
+export interface FSetFilePermissionsParams {
+  /**
+   * File mode bits (octal string, e.g. 644).
+   */
+  mode: string;
+
+  /**
+   * Absolute path whose permissions are to be changed.
+   */
+  path: string;
+
+  /**
+   * New group name or GID.
+   */
+  group?: string;
+
+  /**
+   * New owner username or UID.
+   */
+  owner?: string;
+}
+
+export interface FWriteFileParams {
+  /**
+   * Query param: Destination absolute file path.
+   */
+  path: string;
+
+  /**
+   * Query param: Optional file mode (octal string, e.g. 644). Defaults to 644.
+   */
+  mode?: string;
+}
+
+Fs.Watch = Watch;
+
+export declare namespace Fs {
+  export {
+    type FFileInfoResponse as FFileInfoResponse,
+    type FListFilesResponse as FListFilesResponse,
+    type FCreateDirectoryParams as FCreateDirectoryParams,
+    type FDeleteDirectoryParams as FDeleteDirectoryParams,
+    type FDeleteFileParams as FDeleteFileParams,
+    type FFileInfoParams as FFileInfoParams,
+    type FListFilesParams as FListFilesParams,
+    type FMoveParams as FMoveParams,
+    type FReadFileParams as FReadFileParams,
+    type FSetFilePermissionsParams as FSetFilePermissionsParams,
+    type FWriteFileParams as FWriteFileParams,
+  };
+
+  export {
+    Watch as Watch,
+    type WatchEventsResponse as WatchEventsResponse,
+    type WatchStartResponse as WatchStartResponse,
+    type WatchEventsParams as WatchEventsParams,
+    type WatchStartParams as WatchStartParams,
+    type WatchStopParams as WatchStopParams,
+  };
+}

package/src/resources/browsers/fs/index.ts

@@ -0,0 +1,24 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Fs,
+  type FFileInfoResponse,
+  type FListFilesResponse,
+  type FCreateDirectoryParams,
+  type FDeleteDirectoryParams,
+  type FDeleteFileParams,
+  type FFileInfoParams,
+  type FListFilesParams,
+  type FMoveParams,
+  type FReadFileParams,
+  type FSetFilePermissionsParams,
+  type FWriteFileParams,
+} from './fs';
+export {
+  Watch,
+  type WatchEventsResponse,
+  type WatchStartResponse,
+  type WatchEventsParams,
+  type WatchStartParams,
+  type WatchStopParams,
+} from './watch';

package/src/resources/browsers/fs/watch.ts

@@ -0,0 +1,135 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { Stream } from '../../../core/streaming';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Watch extends APIResource {
+  /**
+   * Stream filesystem events for a watch
+   *
+   * @example
+   * ```ts
+   * const response = await client.browsers.fs.watch.events(
+   *   'watch_id',
+   *   { id: 'id' },
+   * );
+   * ```
+   */
+  events(
+    watchID: string,
+    params: WatchEventsParams,
+    options?: RequestOptions,
+  ): APIPromise<Stream<WatchEventsResponse>> {
+    const { id } = params;
+    return this._client.get(path`/browsers/${id}/fs/watch/${watchID}/events`, {
+      ...options,
+      headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
+      stream: true,
+    }) as APIPromise<Stream<WatchEventsResponse>>;
+  }
+
+  /**
+   * Watch a directory for changes
+   *
+   * @example
+   * ```ts
+   * const response = await client.browsers.fs.watch.start(
+   *   'id',
+   *   { path: 'path' },
+   * );
+   * ```
+   */
+  start(id: string, body: WatchStartParams, options?: RequestOptions): APIPromise<WatchStartResponse> {
+    return this._client.post(path`/browsers/${id}/fs/watch`, { body, ...options });
+  }
+
+  /**
+   * Stop watching a directory
+   *
+   * @example
+   * ```ts
+   * await client.browsers.fs.watch.stop('watch_id', {
+   *   id: 'id',
+   * });
+   * ```
+   */
+  stop(watchID: string, params: WatchStopParams, options?: RequestOptions): APIPromise<void> {
+    const { id } = params;
+    return this._client.delete(path`/browsers/${id}/fs/watch/${watchID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * Filesystem change event.
+ */
+export interface WatchEventsResponse {
+  /**
+   * Absolute path of the file or directory.
+   */
+  path: string;
+
+  /**
+   * Event type.
+   */
+  type: 'CREATE' | 'WRITE' | 'DELETE' | 'RENAME';
+
+  /**
+   * Whether the affected path is a directory.
+   */
+  is_dir?: boolean;
+
+  /**
+   * Base name of the file or directory affected.
+   */
+  name?: string;
+}
+
+export interface WatchStartResponse {
+  /**
+   * Unique identifier for the directory watch
+   */
+  watch_id?: string;
+}
+
+export interface WatchEventsParams {
+  /**
+   * Browser session ID
+   */
+  id: string;
+}
+
+export interface WatchStartParams {
+  /**
+   * Directory to watch.
+   */
+  path: string;
+
+  /**
+   * Whether to watch recursively.
+   */
+  recursive?: boolean;
+}
+
+export interface WatchStopParams {
+  /**
+   * Browser session ID
+   */
+  id: string;
+}
+
+export declare namespace Watch {
+  export {
+    type WatchEventsResponse as WatchEventsResponse,
+    type WatchStartResponse as WatchStartResponse,
+    type WatchEventsParams as WatchEventsParams,
+    type WatchStartParams as WatchStartParams,
+    type WatchStopParams as WatchStopParams,
+  };
+}

package/src/resources/browsers/fs.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './fs/index';

package/src/resources/browsers/index.ts

@@ -9,6 +9,20 @@ export {
   type BrowserCreateParams,
   type BrowserDeleteParams,
 } from './browsers';
+export {
+  Fs,
+  type FFileInfoResponse,
+  type FListFilesResponse,
+  type FCreateDirectoryParams,
+  type FDeleteDirectoryParams,
+  type FDeleteFileParams,
+  type FFileInfoParams,
+  type FListFilesParams,
+  type FMoveParams,
+  type FReadFileParams,
+  type FSetFilePermissionsParams,
+  type FWriteFileParams,
+} from './fs/index';
 export {
   Replays,
   type ReplayListResponse,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.8.2'; // x-release-please-version
+export const VERSION = '0.9.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.8.2";
+export declare const VERSION = "0.9.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.8.2";
+export declare const VERSION = "0.9.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.8.2'; // x-release-please-version
+exports.VERSION = '0.9.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.8.2'; // x-release-please-version
+export const VERSION = '0.9.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map