@collective-intelligence/external-apps-server-sdk 0.1.18 → 0.1.21

package/dist/runtime/web.d.ts

@@ -747,6 +747,22 @@ export type CiResourcesOptions = Readonly<{
 	policy?: UserAuthScopePolicy;
 	tenantUrl: string;
 }>;
+export type RealtimeTicketOptions = Readonly<{
+	auth: Pick<ApplicationUserAuth, "getAccessToken">;
+	/** The CI organization the signed-in users belong to. */
+	organizationId: string;
+	/** The CI origin that mints tickets. */
+	tenantUrl: string;
+	/** The origin the browser opens the event stream on; defaults to `tenantUrl`. */
+	host?: string;
+	fetch?: typeof globalThis.fetch;
+}>;
+/** The ticket route answer: a single-use ticket and the stream it opens. */
+export type RealtimeTicketResponse = Readonly<{
+	ticket: string;
+	expiresAt: string;
+	streamUrl: string;
+}>;
 export type BffResourceMount = Readonly<{
 	basePath: string;
 	handler: (request: Request) => Promise<Response>;
@@ -759,12 +775,17 @@ export type ExternalApplicationBffCapabilities = Readonly<{
 }> & (Readonly<{
 	authentication?: never;
 }> | ServiceCapabilityAuthorization);
+/** The realtime ticket route `POST {basePath}/realtime/ticket`; `basePath` defaults to `/api`. */
+export type ExternalApplicationBffRealtime = Omit<RealtimeTicketOptions, "auth"> & Readonly<{
+	basePath?: string;
+}>;
 export type ExternalApplicationBffOptions = Readonly<{
 	auth: ApplicationUserAuth;
 	authBasePath?: string;
 	capabilities?: ExternalApplicationBffCapabilities;
 	ciResources?: Omit<CiResourcesOptions, "auth">;
 	publicOrigin: string;
+	realtime?: ExternalApplicationBffRealtime;
 	resources?: readonly BffResourceMount[];
 }>;
 export type ExternalApplicationBff = (request: Request) => Promise<Response>;
@@ -792,6 +813,6 @@ export type GatewayRuntimeKernel = Pick<GatewayKernel, "handle">;
 export declare const cookies: (request: Request) => string | null, createCiResourceMounts: (options: CiResourcesOptions) => {
 	basePath: string;
 	handler: (request: Request) => Promise<Response>;
-}[], createExternalApplicationBff: (options: ExternalApplicationBffOptions) => ExternalApplicationBff, createFixedWorkflowRoute: <Input, Params = Record<string, never>>(options: FixedWorkflowRouteOptions<Input, Params>) => ((request: Request, params: Params) => Promise<Response>), createGatewayWebHandler: (kernel: GatewayRuntimeKernel) => GatewayWebHandler, headers: (request: Request) => Headers, publicOriginFromHeaders: (headerList: Headers, fallbackOrigin: string) => string, requestWithPublicOrigin: (request: Request, publicOrigin: string) => Request;
+}[], createExternalApplicationBff: (options: ExternalApplicationBffOptions) => ExternalApplicationBff, createFixedWorkflowRoute: <Input, Params = Record<string, never>>(options: FixedWorkflowRouteOptions<Input, Params>) => ((request: Request, params: Params) => Promise<Response>), createRealtimeTicketHandler: (options: RealtimeTicketOptions) => ((request: Request) => Promise<Response>), createGatewayWebHandler: (kernel: GatewayRuntimeKernel) => GatewayWebHandler, headers: (request: Request) => Headers, publicOriginFromHeaders: (headerList: Headers, fallbackOrigin: string) => string, requestWithPublicOrigin: (request: Request, publicOrigin: string) => Request;
 
 export {};