@onkernel/sdk 0.1.0-alpha.12 → 0.1.0-alpha.13

package/src/resources/apps/deployments.ts

@@ -2,9 +2,12 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { Stream } from '../../core/streaming';
 import { type Uploadable } from '../../core/uploads';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { multipartFormRequestOptions } from '../../internal/uploads';
+import { path } from '../../internal/utils/path';
 
 export class Deployments extends APIResource {
   /**
@@ -21,6 +24,24 @@ export class Deployments extends APIResource {
   create(body: DeploymentCreateParams, options?: RequestOptions): APIPromise<DeploymentCreateResponse> {
     return this._client.post('/deploy', multipartFormRequestOptions({ body, ...options }, this._client));
   }
+
+  /**
+   * Establishes a Server-Sent Events (SSE) stream that delivers real-time logs and
+   * status updates for a deployed application. The stream terminates automatically
+   * once the application reaches a terminal state.
+   *
+   * @example
+   * ```ts
+   * const response = await client.apps.deployments.follow('id');
+   * ```
+   */
+  follow(id: string, options?: RequestOptions): APIPromise<Stream<DeploymentFollowResponse>> {
+    return this._client.get(path`/apps/${id}/events`, {
+      ...options,
+      headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
+      stream: true,
+    }) as APIPromise<Stream<DeploymentFollowResponse>>;
+  }
 }
 
 export interface DeploymentCreateResponse {
@@ -68,6 +89,77 @@ export namespace DeploymentCreateResponse {
   }
 }
 
+/**
+ * A stream of application events (state updates and logs) in SSE format.
+ */
+export type DeploymentFollowResponse = Array<
+  | DeploymentFollowResponse.StateEvent
+  | DeploymentFollowResponse.StateUpdateEvent
+  | DeploymentFollowResponse.LogEvent
+>;
+
+export namespace DeploymentFollowResponse {
+  /**
+   * Initial state of the application, emitted once when subscribing.
+   */
+  export interface StateEvent {
+    /**
+     * Event type identifier (always "state").
+     */
+    event: 'state';
+
+    /**
+     * Current application state (e.g., "deploying", "running", "succeeded", "failed").
+     */
+    state: string;
+
+    /**
+     * Time the state was reported.
+     */
+    timestamp?: string;
+  }
+
+  /**
+   * An update emitted when the application's state changes.
+   */
+  export interface StateUpdateEvent {
+    /**
+     * Event type identifier (always "state_update").
+     */
+    event: 'state_update';
+
+    /**
+     * New application state (e.g., "running", "succeeded", "failed").
+     */
+    state: string;
+
+    /**
+     * Time the state change occurred.
+     */
+    timestamp?: string;
+  }
+
+  /**
+   * A log entry from the application.
+   */
+  export interface LogEvent {
+    /**
+     * Event type identifier (always "log").
+     */
+    event: 'log';
+
+    /**
+     * Log message text.
+     */
+    message: string;
+
+    /**
+     * Time the log entry was produced.
+     */
+    timestamp?: string;
+  }
+}
+
 export interface DeploymentCreateParams {
   /**
    * Relative path to the entrypoint of the application
@@ -104,6 +196,7 @@ export interface DeploymentCreateParams {
 export declare namespace Deployments {
   export {
     type DeploymentCreateResponse as DeploymentCreateResponse,
+    type DeploymentFollowResponse as DeploymentFollowResponse,
     type DeploymentCreateParams as DeploymentCreateParams,
   };
 }

package/src/resources/apps/index.ts

@@ -1,7 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Apps } from './apps';
-export { Deployments, type DeploymentCreateResponse, type DeploymentCreateParams } from './deployments';
+export { Apps, type AppListResponse, type AppListParams } from './apps';
+export {
+  Deployments,
+  type DeploymentCreateResponse,
+  type DeploymentFollowResponse,
+  type DeploymentCreateParams,
+} from './deployments';
 export {
   Invocations,
   type InvocationCreateResponse,

package/src/resources/index.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Apps } from './apps/apps';
+export { Apps, type AppListResponse, type AppListParams } from './apps/apps';
 export {
   Browsers,
   type BrowserCreateResponse,

package/src/streaming.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/streaming instead */
+export * from './core/streaming';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.12'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.13'; // x-release-please-version

package/streaming.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/streaming.mjs";
+//# sourceMappingURL=streaming.d.mts.map

package/streaming.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.mts","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":""}

package/streaming.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/streaming.js";
+//# sourceMappingURL=streaming.d.ts.map

package/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":""}

package/streaming.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/streaming instead */
+tslib_1.__exportStar(require("./core/streaming.js"), exports);
+//# sourceMappingURL=streaming.js.map

package/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,8DAAiC"}

package/streaming.mjs

@@ -0,0 +1,2 @@
+export * from "./core/streaming.mjs";
+//# sourceMappingURL=streaming.mjs.map

package/streaming.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.mjs","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":""}

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.12";
+export declare const VERSION = "0.1.0-alpha.13";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.12";
+export declare const VERSION = "0.1.0-alpha.13";
 //# 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.1.0-alpha.12'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.13'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0-alpha.12'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.13'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map