@crowdstrike/logscale-file-editor 1.143.0--build-1386--sha-7dd77c28f152f02d096cfff2b59838bf1e98cde4

package/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @crowdstrike/logscale-file-editor
+ *
+ * Allows you to embed an editor for files in LogScale as a WebComponent.
+ *
+ * ```ts
+ * // Importing the module defines the "logscale-file-editor" custom element as a side-effect.
+ * import {createElement, Options} from "@crowdstrike/logscale-file-editor";
+ *
+ * // See documentation for `createElement`
+ * const element : FileEditor = createElement(options);
+ * document.body.appendChild(element);
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+/** Common options shared by all LogScale Webcomponents
+ * @public
+ */
+export declare interface CommonOptions {
+    /** The current unix time as millisecs. Defaults to `Date.now` if not set. */
+    currentTime?: number;
+    /** Allows you to open the webcomponent's internal shadow DOM.
+     *
+     * This is useful for writing E2E tests where you want to inspect the internal DOM of the WebComponent.
+     * Do this sparingly, since the internal DOM elements can change between releases of
+     * the webcomponents.
+     */
+    shadowRootMode?: "open" | "closed";
+    /** Names of experimental features to be enabled. The names of features are provided by LogScale on a case-by-case basis.
+     * Should be left empty or undefined by default.
+     */
+    featureFlags?: Array<string> | Record<string, boolean>;
+}
+
+/** Helper function that creates a `logscale-file-editor` webcomponent and initializes it with the provided options.
+ *
+ * ```ts
+ * const options : Options = {
+ *   apiURL: "https://...",
+ *   theme: "dark",
+ *   // ...
+ * };
+ *
+ * const element : FileEditor = createElement(options);
+ *
+ * // FileEditor inherits from HtmlElement and can be added to the DOM:
+ * document.body.appendChild(element);
+ * ```
+ *
+ * @public
+ */
+export declare function createElement(options: Options): FileEditor;
+
+/** Custom element that embeds the LogScale file-editor.
+ * @public @sealed
+ */
+export declare class FileEditor extends WebcomponentBase<Options> {
+}
+
+/** Initialization options.
+ * @public
+ */
+export declare interface Options extends CommonOptions {
+    /** Base URL where the LogScale cluster is accessed. */
+    apiURL: string;
+    /** If provided, this token will be passed in the Authentication header as a Bearer token.
+     * This can be a user's personal API token or an OICD token.
+     *
+     * This method of setting the authentication token is not recommended, since it exposes the authorization token to be read from JavaScript.
+     * Consider using a secure HTTP-only cookie instead.
+     */
+    authToken?: string;
+    /** If provided, HTTP calls will have the "X-CSRF-Token" header set to this value. */
+    csrfToken?: string;
+    /** Will initialize the webcomponent in light or dark mode. The theme can be switched through the `setTheme()` method after initialization. */
+    theme: 'light' | 'dark';
+    /** Name of the repository or view. */
+    repoOrViewName: string;
+    /** Language to start the webcomponent in. */
+    locale?: "jp" | "en";
+    /** The file to open, must end with .csv */
+    fileName: string;
+    /** How many rows to skip. E.g. 100 to show row 101 as the first row. */
+    offset?: number;
+    /** The number of rows to display. */
+    limit?: number;
+}
+
+/** Base class for LogScale's webcomponents.
+ * @public */
+export declare abstract class WebcomponentBase<Opts extends CommonOptions> extends HTMLElement {
+    /** Initializes the webcomponent with options.
+     *
+     * This should be called only once per webcomponent.
+     * You should not need to call this if you are using the `createElement` helper function.
+     * @public
+     */
+    init(options: Opts): void;
+    /** Set the UI theme to dark or light.
+     * @public */
+    setTheme(theme: "dark" | "light"): void;
+}
+
+export { }