@caido/sdk-frontend 0.57.1 → 0.57.2-beta.1

package/src/types/types/httpHistory.d.ts

@@ -1,4 +1,4 @@
-import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent, type SlotContentProps, type SlotContentPropsGroup } from "./slots";
 import { type ID, type Selection } from "./utils";
 /**
  * The slots in the HTTP History UI.
@@ -11,8 +11,12 @@ export declare const HTTPHistorySlot: {
     readonly ToolbarPrimary: "toolbar-primary";
 };
 export type HTTPHistorySlot = (typeof HTTPHistorySlot)[keyof typeof HTTPHistorySlot];
-export type HTTPHistorySlotContent = {
-    [HTTPHistorySlot.ToolbarPrimary]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+/**
+ * Content that can be added to HTTP history slots.
+ * @category HTTP History
+ */
+export type HTTPHistorySlotContent<TProps extends SlotContentPropsGroup = SlotContentProps> = {
+    [K in HTTPHistorySlot]: ButtonSlotContent | CustomSlotContent<TProps> | CommandSlotContent;
 };
 /**
  * HTTP history page context.

package/src/types/types/httpqlEditor.d.ts

@@ -0,0 +1,3 @@
+export type HTTPQLEditorProps = {
+    isReadOnly?: boolean;
+};

package/src/types/types/matchReplace.d.ts

@@ -1,4 +1,4 @@
-import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent, type SlotContentProps, type SlotContentPropsGroup } from "./slots";
 import { type HTTPQL, type ID, type Selection } from "./utils";
 /**
  * A rule in Match and Replace.
@@ -448,9 +448,8 @@ export type MatchReplaceSlot = (typeof MatchReplaceSlot)[keyof typeof MatchRepla
  * Content that can be added to match and replace slots.
  * @category Match and Replace
  */
-export type MatchReplaceSlotContent = {
-    [MatchReplaceSlot.UpdateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
-    [MatchReplaceSlot.CreateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+export type MatchReplaceSlotContent<TProps extends SlotContentPropsGroup = SlotContentProps> = {
+    [K in MatchReplaceSlot]: ButtonSlotContent | CustomSlotContent<TProps> | CommandSlotContent;
 };
 /**
  * Event fired when the current match and replace rule changes.

package/src/types/types/replay.d.ts

@@ -1,5 +1,7 @@
-import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
-import { type ID, type Selection } from "./utils";
+import type { RequestFull } from "./request";
+import type { ResponseFull } from "./response";
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent, type SlotContentProps, type SlotContentPropsGroup } from "./slots";
+import { type AddIndicatorOptions, type ID, type Selection } from "./utils";
 /**
  * The connection information to use for the request.
  * @category Replay
@@ -42,10 +44,12 @@ export declare const ReplaySlot: {
     readonly Topbar: "topbar";
 };
 export type ReplaySlot = (typeof ReplaySlot)[keyof typeof ReplaySlot];
-export type ReplaySlotContent = {
-    [ReplaySlot.SessionToolbarPrimary]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
-    [ReplaySlot.SessionToolbarSecondary]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
-    [ReplaySlot.Topbar]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+/**
+ * Content that can be added to replay slots.
+ * @category Replay
+ */
+export type ReplaySlotContent<TProps extends SlotContentPropsGroup = SlotContentProps> = {
+    [K in ReplaySlot]: ButtonSlotContent | CustomSlotContent<TProps> | CommandSlotContent;
 };
 /**
  * Options for opening a tab.
@@ -108,6 +112,35 @@ export type ReplayEntry = {
      */
     requestId?: ID;
 };
+/**
+ * The currently selected Replay exchange.
+ * @category Replay
+ */
+export type ReplaySelectedExchange = {
+    kind: typeof ReplaySessionKind.Http;
+    entryId: ID;
+    sessionId: ID;
+    request: RequestFull;
+    response?: ResponseFull;
+} | {
+    kind: typeof ReplaySessionKind.Ws;
+    entryId: ID;
+    sessionId: ID;
+    streamId?: ID;
+    activeTab: "http-upgrade" | "messages";
+    upgradeRequest?: RequestFull;
+    upgradeResponse?: ResponseFull;
+    message?: ReplayWebSocketMessage;
+};
+/**
+ * The currently edited WebSocket message in Replay.
+ * @category Replay
+ */
+export type ReplayWebSocketMessage = {
+    raw: string;
+    direction: "CLIENT" | "SERVER";
+    format: "BINARY" | "CLOSE" | "PING" | "PONG" | "TEXT";
+};
 /**
  * A collection in Replay.
  * @category Replay
@@ -206,6 +239,35 @@ export type ReplayPageContext = {
     kind: "Replay";
     selection: Selection<ReplaySessionId>;
 };
+/**
+ * Options for adding an indicator to a replay session.
+ * @category Replay
+ */
+export type AddSessionIndicatorOptions = AddIndicatorOptions & {
+    /**
+     * Includes the indicator icon on the session's replay tab.
+     * @default false
+     */
+    showTabIcon?: boolean;
+};
+/**
+ * Options for adding an indicator to a replay collection.
+ * @category Replay
+ */
+export type AddCollectionIndicatorOptions = AddIndicatorOptions;
+/**
+ * The kind of a replay session.
+ * @category Replay
+ */
+export declare const ReplaySessionKind: {
+    readonly Http: "HTTP";
+    readonly Ws: "WS";
+};
+/**
+ * The kind of a replay session.
+ * @category Replay
+ */
+export type ReplaySessionKind = (typeof ReplaySessionKind)[keyof typeof ReplaySessionKind];
 /**
  * A unique replay session identifier.
  * @category Replay

package/src/types/types/request.d.ts

@@ -1,3 +1,5 @@
+import { type EditorView } from "@codemirror/view";
+import { type API } from "../sdks";
 import { type As, type ComponentDefinition, type ID, type Prettify } from "./utils";
 /**
  * A draft request that has not yet been saved to the database.
@@ -38,11 +40,47 @@ export type RequestFull = Prettify<As<"RequestFull"> & {
     streamId: ID | undefined;
     raw: string;
 }>;
+/**
+ * The internal props for the request read-only view mode.
+ * @category Request
+ */
+export type RequestReadableViewModePropsInternal = {
+    request: RequestFull;
+    view: EditorView;
+};
+/**
+ * The internal props for the request writable view mode.
+ * @category Request
+ */
+export type RequestWritableViewModePropsInternal = {
+    request: RequestFull | undefined;
+    draft: RequestDraft;
+    view: EditorView;
+};
+/**
+ * The props for the request writable view mode.
+ * @category Request
+ */
+export type RequestWritableViewModeProps = RequestWritableViewModePropsInternal & {
+    sdk: API;
+};
+/**
+ * The props for the request read-only view mode.
+ * @category Request
+ */
+export type RequestReadableViewModeProps = RequestReadableViewModePropsInternal & {
+    sdk: API;
+};
+/**
+ * The props group for the request view mode.
+ * @category Request
+ */
+export type RequestViewModeProps = RequestReadableViewModeProps | RequestWritableViewModeProps | RequestReadableViewModePropsInternal | RequestWritableViewModePropsInternal;
 /**
  * Options for defining a custom request view mode.
  * @category Request
  */
-export type RequestViewModeOptions = {
+export type RequestViewModeOptions<TProps extends RequestViewModeProps> = {
     /**
      * The label of the view mode.
      */
@@ -50,7 +88,7 @@ export type RequestViewModeOptions = {
     /**
      * The component to render when the view mode is selected.
      */
-    view: ComponentDefinition;
+    view: ComponentDefinition<TProps>;
     /**
      * A function that determines if the view mode should be shown for a given request.
      */

package/src/types/types/response.d.ts

@@ -1,3 +1,5 @@
+import { type EditorView } from "@codemirror/view";
+import { type API } from "../sdks";
 import type { RequestFull, RequestMeta } from "./request";
 import type { As, ComponentDefinition, ID, Prettify } from "./utils";
 /**
@@ -12,11 +14,26 @@ export type ResponseFull = Prettify<As<"ResponseFull"> & {
     length: number;
     createdAt: Date;
 }>;
+/**
+ * The internal props for the response view mode.
+ * @category Response
+ */
+export type ResponseViewModePropsInternal = {
+    response: ResponseFull;
+    view: EditorView;
+};
+/**
+ * The props for the response view mode.
+ * @category Response
+ */
+export type ResponseViewModeProps = ResponseViewModePropsInternal & {
+    sdk: API;
+};
 /**
  * Options for defining a custom response view mode.
  * @category Response
  */
-export type ResponseViewModeOptions = {
+export type ResponseViewModeOptions<TProps extends ResponseViewModeProps | ResponseViewModePropsInternal> = {
     /**
      * The label of the view mode.
      */
@@ -24,7 +41,7 @@ export type ResponseViewModeOptions = {
     /**
      * The component to render when the view mode is selected.
      */
-    view: ComponentDefinition;
+    view: ComponentDefinition<TProps>;
     /**
      * A function that determines if the view mode should be shown for a given response.
      */

package/src/types/types/scopes.d.ts

@@ -1,4 +1,4 @@
-import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent, type SlotContentProps, type SlotContentPropsGroup } from "./slots";
 import { type ID, type Selection } from "./utils";
 /**
  * Represents a scope.
@@ -37,9 +37,12 @@ export declare const ScopeSlot: {
     readonly CreateHeader: "create-header";
 };
 export type ScopeSlot = (typeof ScopeSlot)[keyof typeof ScopeSlot];
-export type ScopeSlotContent = {
-    [ScopeSlot.UpdateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
-    [ScopeSlot.CreateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+/**
+ * Content that can be added to scope slots.
+ * @category Scopes
+ */
+export type ScopeSlotContent<TProps extends SlotContentPropsGroup = SlotContentProps> = {
+    [K in ScopeSlot]: ButtonSlotContent | CustomSlotContent<TProps> | CommandSlotContent;
 };
 /**
  * Event fired when the current scope changes.

package/src/types/types/search.d.ts

@@ -1,4 +1,4 @@
-import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent, type SlotContentProps, type SlotContentPropsGroup } from "./slots";
 /**
  * The slots in the Search UI.
  * @category Search
@@ -10,8 +10,12 @@ export declare const SearchSlot: {
     readonly ToolbarPrimary: "search-toolbar-primary";
 };
 export type SearchSlot = (typeof SearchSlot)[keyof typeof SearchSlot];
-export type SearchSlotContent = {
-    [SearchSlot.ToolbarPrimary]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+/**
+ * Content that can be added to search slots.
+ * @category Search
+ */
+export type SearchSlotContent<TProps extends SlotContentPropsGroup = SlotContentProps> = {
+    [K in SearchSlot]: ButtonSlotContent | CustomSlotContent<TProps> | CommandSlotContent;
 };
 /**
  * Search page context.

package/src/types/types/slots.d.ts

@@ -1,8 +1,26 @@
+import { type API } from "../sdks";
 import { type CommandID } from "./commands";
 import { type ComponentDefinition, type Prettify } from "./utils";
 type DefineSlotContent<TType extends string, P extends Record<string, unknown>> = Prettify<{
     type: TType;
 } & P>;
+/**
+ * The internal props for a slot content.
+ * @category Slots
+ */
+export type SlotContentPropsInternal = {};
+/**
+ * The props for a slot content.
+ * @category Slots
+ */
+export type SlotContentProps = SlotContentPropsInternal & {
+    sdk: API;
+};
+/**
+ * The props group for a slot content.
+ * @category Slots
+ */
+export type SlotContentPropsGroup = SlotContentProps | SlotContentPropsInternal;
 /**
  * Content for a button slot.
  * @category Slots
@@ -16,8 +34,8 @@ export type ButtonSlotContent = DefineSlotContent<"Button", {
  * Content for a custom component slot.
  * @category Slots
  */
-export type CustomSlotContent = DefineSlotContent<"Custom", {
-    definition: ComponentDefinition;
+export type CustomSlotContent<TProps extends SlotContentPropsGroup = SlotContentProps> = DefineSlotContent<"Custom", {
+    definition: ComponentDefinition<TProps>;
 }>;
 /**
  * Content for a command slot.
@@ -31,7 +49,7 @@ export type CommandSlotContent = DefineSlotContent<"Command", {
  * Union type of all possible slot content types.
  * @category Slots
  */
-export type SlotContent = ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+export type SlotContent<TProps extends SlotContentPropsGroup = SlotContentProps> = ButtonSlotContent | CustomSlotContent<TProps> | CommandSlotContent;
 /**
  * A function type for adding content to slots.
  * @category Slots

package/src/types/types/utils.d.ts

@@ -1,4 +1,5 @@
 import { type Component as VueComponent } from "vue";
+import { type API } from "../index";
 /**
  * A unique Caido identifier per type.
  * @category Utils
@@ -37,13 +38,25 @@ export type QueryInput = HTTPQL | StreamQL;
 export type Icon = string & {
     __icon?: never;
 };
+/**
+ * A set of properties that can be passed to a component.
+ * @category Utils
+ */
+export type ComponentProps = Record<string, unknown>;
+/**
+ * A set of properties that can be passed to a component definition with the SDK.
+ * @category Utils
+ */
+export type ComponentPropsWithSdk<TProps extends ComponentProps> = TProps & {
+    sdk: API;
+};
 /**
  * A custom component that will be rendered in the UI.
  * @category Utils
  */
-export type ComponentDefinition = {
-    component: VueComponent;
-    props?: Record<string, unknown>;
+export type ComponentDefinition<TProps = ComponentProps> = {
+    component: VueComponent<TProps>;
+    props?: ComponentProps;
     events?: Record<string, (...args: unknown[]) => void>;
 };
 /**

package/src/types/types/websocket.d.ts

@@ -1,4 +1,5 @@
-import type { As, ComponentDefinition, ID, Prettify } from "./utils";
+import { type EditorView } from "@codemirror/view";
+import type { As, ComponentDefinition, ComponentPropsWithSdk, ID, Prettify } from "./utils";
 /**
  * Certificate page context.
  * @category Websockets
@@ -21,11 +22,24 @@ export type StreamWsMessageMeta = Prettify<As<"StreamWsMessageMeta"> & {
         createdAt: Date;
     };
 }>;
+/**
+ * The internal props for the message view mode.
+ * @category Websockets
+ */
+export type MessageViewModePropsInternal = {
+    message: StreamWsMessageMeta;
+    view: EditorView;
+};
+/**
+ * The props for the message view mode.
+ * @category Websockets
+ */
+export type MessageViewModeProps = ComponentPropsWithSdk<MessageViewModePropsInternal>;
 /**
  * Options for defining a custom message view mode.
  * @category Websockets
  */
-export type MessageViewModeOptions = {
+export type MessageViewModeOptions<TProps extends MessageViewModeProps | MessageViewModePropsInternal> = {
     /**
      * The label of the view mode.
      */
@@ -33,7 +47,7 @@ export type MessageViewModeOptions = {
     /**
      * The component to render when the view mode is selected.
      */
-    view: ComponentDefinition;
+    view: ComponentDefinition<TProps>;
     /**
      * A function that determines if the view mode should be shown for a given message.
      */

package/src/types/types/window.d.ts

@@ -15,6 +15,7 @@ import type { ReplayPageContext } from "./replay";
 import type { ScopePageContext } from "./scopes";
 import type { SearchPageContext } from "./search";
 import type { SitemapPageContext } from "./sitemap";
+import type { ComponentDefinition, ComponentProps, ComponentPropsWithSdk } from "./utils";
 import { type WebsocketPageContext } from "./websocket";
 import type { WorkflowsPageContext } from "./workflows";
 /**
@@ -29,6 +30,11 @@ export type DialogOptions = {
     modal?: boolean;
     position?: "left" | "right" | "top" | "bottom" | "center" | "topleft" | "topright" | "bottomleft" | "bottomright";
 };
+/**
+ * The component definition for a dialog.
+ * @category Window
+ */
+export type DialogComponent = ComponentDefinition<ComponentPropsWithSdk<ComponentProps>>;
 /**
  * A dialog instance that can be closed programmatically.
  * @category Window