lib-e2e-cypress-for-dummys-ts 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,431 @@
+type Lang = 'es' | 'en' | 'fr' | 'it' | 'de';
+declare const SUPPORTED_LANGS: Lang[];
+declare function isLang(value: string): value is Lang;
+
+declare const INPUT_TYPES: readonly ["text", "password", "email", "search", "tel", "url", "number", "textarea"];
+type InputType = (typeof INPUT_TYPES)[number];
+
+interface DBStoreIndex {
+    name: string;
+    keyPath: string;
+    unique: boolean;
+}
+interface DBStore {
+    name: string;
+    keyPath: string;
+    autoIncrement: boolean;
+    indexes: DBStoreIndex[];
+}
+interface DBSchema {
+    name: string;
+    version: number;
+    stores: DBStore[];
+}
+declare const DB_SCHEMA: DBSchema;
+declare const DB_STORE_NAMES: ["tests", "commands", "interceptors", "configuration"];
+
+declare class TranslationService {
+    private lang;
+    private readonly translations;
+    constructor();
+    setLang(lang: Lang): void;
+    getLang(): Lang;
+    translate(key: string): string;
+    detectLang(): Lang;
+}
+declare const translationService: TranslationService;
+
+declare class TransformationService {
+    toLang(lang: string): Lang;
+    generateItDescription(description: string, commands: string[]): string;
+}
+declare const transformationService: TransformationService;
+
+interface DirectoryNode {
+    name: string;
+    kind: 'directory';
+    children: (DirectoryNode | FileNode)[];
+}
+interface FileNode {
+    name: string;
+    kind: 'file';
+}
+declare class AdvancedTestTransformationService {
+    insertBeforeEach(content: string, interceptors: string, alertFn?: (msg: string) => void): string;
+    insertItBlock(content: string, itBlock: string, alertFn?: (msg: string) => void): string;
+    isFile(file: unknown): boolean;
+    scanDirectory(dirHandle: FileSystemDirectoryHandle): Promise<DirectoryNode>;
+}
+declare const advancedTestTransformationService: AdvancedTestTransformationService;
+
+declare class Subject<T> {
+    private _value;
+    private listeners;
+    constructor(initialValue: T);
+    next(value: T): void;
+    getValue(): T;
+    subscribe(fn: (v: T) => void): () => void;
+}
+
+type SelectorStrategy = 'data-cy' | 'data-testid' | 'aria-label' | 'id';
+declare class RecordingService {
+    private readonly commands$;
+    private readonly interceptors$;
+    private readonly isRecording$;
+    private readonly isPaused$;
+    private readonly selectorNotFound$;
+    private readonly inputDebounceTimers;
+    private readonly abort;
+    selectorStrategy: SelectorStrategy;
+    private readonly origPushState;
+    private readonly origReplaceState;
+    constructor();
+    startRecording(): void;
+    stopRecording(): void;
+    toggleRecording(): void;
+    pauseRecording(): void;
+    resumeRecording(): void;
+    togglePause(): void;
+    addCommand(cmd: string): void;
+    /** Appends a command regardless of recording/paused state (e.g. assertions added manually). */
+    appendCommand(cmd: string): void;
+    removeCommand(index: number): void;
+    moveCommand(from: number, to: number): void;
+    removeInterceptor(index: number): void;
+    registerInterceptor(method: string, url: string, alias: string): void;
+    clearCommands(): void;
+    clearInterceptors(): void;
+    getCommandsSnapshot(): string[];
+    getInterceptorsSnapshot(): string[];
+    getPausedSnapshot(): boolean;
+    onCommandsChange(fn: (cmds: string[]) => void): () => void;
+    onInterceptorsChange(fn: (ints: string[]) => void): () => void;
+    onRecordingChange(fn: (isRecording: boolean) => void): () => void;
+    onPauseChange(fn: (isPaused: boolean) => void): () => void;
+    onSelectorNotFound(fn: (target: HTMLElement, action: 'click') => void): () => void;
+    destroy(): void;
+    private listenToClicks;
+    private listenToInput;
+    private listenToSelect;
+    private listenToRouteChanges;
+    private handleClickEvent;
+    private handleMatOptionClick;
+    private handleInputEvent;
+    private handleSelectEvent;
+    private addGenericCommand;
+    private getReliableSelector;
+    private isInteractiveElement;
+    private isOwnSelector;
+    private isOwnElement;
+    private urlToWildcard;
+}
+
+interface TestRecord {
+    id: number;
+    name: string;
+    createdAt: number;
+    tags?: string[];
+}
+interface CommandRecord {
+    id: number;
+    command: string;
+    testId: number;
+    createdAt: number;
+}
+interface InterceptorRecord {
+    id: number;
+    interceptor: string;
+    testId: number;
+    createdAt: number;
+}
+interface ConfigRecord {
+    id: number;
+    [key: string]: unknown;
+}
+interface TestWithDetails extends TestRecord {
+    commands: string[];
+    interceptors: string[];
+}
+interface TestDetail extends TestWithDetails {
+    cypressCommands: string[];
+    itBlock: string;
+    interceptorsBlock: string;
+}
+declare class PersistenceService {
+    private readonly dbName;
+    private _db;
+    constructor(dbName?: string);
+    private getDB;
+    insertTest(name: string, commands?: string[], interceptors?: string[], tags?: string[]): Promise<number>;
+    getAllTests(): Promise<TestWithDetails[]>;
+    getTestById(testId: number): Promise<TestDetail | null>;
+    deleteTest(id: number): Promise<void>;
+    insertCommands(commands: string[], testId: number): Promise<void>;
+    getCommandsByTestId(testId: number): Promise<CommandRecord[]>;
+    private getCommandStrings;
+    private deleteCommandsByTestId;
+    insertInterceptors(interceptors: string[], testId: number): Promise<void>;
+    getInterceptorsByTestId(testId: number): Promise<InterceptorRecord[]>;
+    private getInterceptorStrings;
+    deleteInterceptorsByTestId(testId: number): Promise<void>;
+    setConfig(config: Record<string, unknown>): Promise<void>;
+    setConfigKey(key: string, value: unknown): Promise<void>;
+    getConfig(key: string): Promise<Record<string, unknown> | null>;
+    getGeneralConfig(): Promise<ConfigRecord | null>;
+    clearAllData(): Promise<void>;
+    ingestFileData(tests: Record<string, unknown>[], interceptors: Record<string, unknown>[]): Promise<void>;
+    requestDirectoryPermissions(): Promise<void>;
+    private bulkInsertWithoutId;
+}
+declare const persistenceService: PersistenceService;
+
+declare function generateAlias(method: string, url: string): string;
+declare class HttpMonitor {
+    private readonly recording;
+    private originalFetch;
+    private originalXHR;
+    constructor(recording: RecordingService);
+    install(): void;
+    uninstall(): void;
+    isExtendedHttpEnabled(): boolean;
+    private installFetch;
+    private uninstallFetch;
+    private installXhr;
+    private uninstallXhr;
+    private handleFetchInterception;
+    private handleXhrInterception;
+}
+
+declare const SCROLLBAR_STYLES = "\n.swal2-popup::-webkit-scrollbar,\n.swal2-html-container::-webkit-scrollbar,\n.swal2-content::-webkit-scrollbar,\n.swal2-container::-webkit-scrollbar {\n  width: 5px;\n  height: 5px;\n  background: transparent;\n}\n.swal2-popup::-webkit-scrollbar-thumb,\n.swal2-html-container::-webkit-scrollbar-thumb,\n.swal2-content::-webkit-scrollbar-thumb,\n.swal2-container::-webkit-scrollbar-thumb {\n  background: #30363d;\n  border-radius: 3px;\n}\n.swal2-popup::-webkit-scrollbar-thumb:hover,\n.swal2-html-container::-webkit-scrollbar-thumb:hover,\n.swal2-content::-webkit-scrollbar-thumb:hover {\n  background: #484f58;\n}\n.swal2-popup::-webkit-scrollbar-track,\n.swal2-html-container::-webkit-scrollbar-track,\n.swal2-content::-webkit-scrollbar-track,\n.swal2-container::-webkit-scrollbar-track {\n  background: transparent;\n}\n.swal2-popup, .swal2-html-container, .swal2-content, .swal2-container {\n  scrollbar-width: thin;\n  scrollbar-color: #30363d transparent;\n}\n";
+declare const LIB_E2E_CYPRESS_FOR_DUMMYS_SWAL2_STYLES = "\n.swal2-container, .swal2-popup {\n  z-index: 99999 !important;\n}\n.swal2-container {\n  padding: 0 !important;\n  align-items: center !important;\n  justify-content: center !important;\n}\n.swal2-popup {\n  background: #161b22 !important;\n  color: #e6edf3 !important;\n  border-radius: 12px !important;\n  box-shadow: 0 24px 64px rgba(0,0,0,0.72), 0 0 0 1px #30363d !important;\n  border: none !important;\n  padding: 0 !important;\n  min-width: 400px;\n  max-width: 90vw;\n  min-height: 200px;\n  max-height: 90vh;\n}\n/* Override SweetAlert2 v11's display:grid on .swal2-popup.swal2-modal */\n.swal2-popup.swal2-modal {\n  display: flex !important;\n  flex-direction: column !important;\n  align-items: stretch !important;\n  overflow: hidden !important;\n}\n.swal2-header {\n  flex-shrink: 0 !important;\n  flex-grow: 0 !important;\n  overflow: hidden !important;\n}\n.swal2-title {\n  color: #e6edf3 !important;\n  font-weight: 600 !important;\n  font-size: 14px !important;\n  background: #161b22;\n  padding: 14px 48px 13px 18px !important;\n  margin: 0 !important;\n  border-bottom: 1px solid #21262d;\n  text-align: left !important;\n  letter-spacing: 0.1px;\n  white-space: nowrap !important;\n  overflow: hidden !important;\n  text-overflow: ellipsis !important;\n}\n.swal2-close {\n  position: absolute !important;\n  top: 10px !important;\n  right: 12px !important;\n  color: #8b949e !important;\n  font-size: 1.1rem !important;\n  z-index: 1 !important;\n  border-radius: 6px !important;\n  width: 28px !important;\n  height: 28px !important;\n  line-height: 28px !important;\n  transition: background 0.15s, color 0.15s !important;\n}\n.swal2-close:hover {\n  background: #21262d !important;\n  color: #e6edf3 !important;\n}\n/* In SweetAlert2 v11, .swal2-html-container is a direct child of .swal2-popup */\n.swal2-html-container {\n  flex: 1 !important;\n  min-height: 0 !important;\n  background: #161b22;\n  padding: 0 !important;\n  margin: 0 !important;\n  width: 100%;\n  display: flex !important;\n  flex-direction: column !important;\n  align-items: stretch;\n  box-sizing: border-box;\n  overflow: hidden !important;\n}\n/* The single wrapper div we inject inside each modal fills the container */\n.swal2-html-container > div {\n  flex: 1 !important;\n  min-height: 0 !important;\n  display: flex !important;\n  flex-direction: column !important;\n  overflow: hidden !important;\n}\n.swal2-actions, .swal2-footer {\n  flex-shrink: 0 !important;\n  flex-grow: 0 !important;\n}\n";
+declare function injectStyles(css: string, id: string): void;
+
+declare function makeModalResizable(modal: HTMLElement, options?: {
+    minWidth?: number;
+    minHeight?: number;
+}): () => void;
+declare function makeSwalDraggable(): void;
+declare function makeSwalDraggableByContentId(contentId: string): void;
+declare function setSwal2DataCyAttribute(dataCy?: string): void;
+
+declare function showToast(message: string, isSuccess?: boolean): void;
+
+declare class TestPrevisualizerElement extends HTMLElement {
+    private shadow;
+    private _commands;
+    private _interceptors;
+    private _showInterceptors;
+    editable: boolean;
+    translation: TranslationService;
+    constructor();
+    connectedCallback(): void;
+    get commands(): string[];
+    set commands(v: string[]);
+    get interceptors(): string[];
+    set interceptors(v: string[]);
+    get showInterceptors(): boolean;
+    toggleInterceptors(): void;
+    copyToClipboard(): void;
+    copyInterceptorsToClipboard(): void;
+    private t;
+    private dispatchDelete;
+    private dispatchMove;
+    private dispatchDeleteInterceptor;
+    private render;
+}
+
+declare class SaveTestElement extends HTMLElement {
+    private shadow;
+    private _step;
+    description: string;
+    tags: string[];
+    translation: TranslationService;
+    constructor();
+    connectedCallback(): void;
+    get step(): 'ask' | 'desc';
+    askSave(): void;
+    confirmSave(): void;
+    confirmSaveAndExport(): void;
+    cancel(): void;
+    restartComponent(): void;
+    addTag(tag: string): void;
+    removeTag(tag: string): void;
+    private t;
+    private dispatch;
+    private render;
+}
+
+declare class TestEditorElement extends HTMLElement {
+    private shadow;
+    persistence: PersistenceService;
+    translation: TranslationService;
+    tests: TestWithDetails[];
+    expandedIndex: number | null;
+    interceptorsByTest: Record<number, string[]>;
+    activeTag: string | null;
+    selectMode: boolean;
+    selectedIds: Set<number>;
+    describeName: string;
+    constructor();
+    connectedCallback(): void;
+    loadTests(): Promise<void>;
+    deleteTest(id: number): Promise<void>;
+    toggleExpand(index: number): void;
+    hasInterceptors(testId: number): boolean;
+    toggleSelectMode(): void;
+    toggleSelectTest(id: number): void;
+    generateDescribe(): void;
+    copyToClipboard(text: string): void;
+    get allTags(): string[];
+    get visibleTests(): TestWithDetails[];
+    private t;
+    private render;
+}
+
+declare class ConfigurationElement extends HTMLElement {
+    private shadow;
+    persistence: PersistenceService;
+    translation: TranslationService;
+    selectedLanguage: string;
+    advancedHttpConfig: boolean;
+    selectorStrategy: SelectorStrategy;
+    smartSelectorEnabled: boolean;
+    private filesystemGranted;
+    private cypressFolderName;
+    constructor();
+    connectedCallback(): void;
+    private t;
+    private loadConfig;
+    onLanguageChange(lang: string): Promise<void>;
+    onAdvancedHttpConfigChange(checked: boolean): void;
+    onSmartSelectorChange(enabled: boolean): Promise<void>;
+    onSelectorStrategyChange(strategy: SelectorStrategy): Promise<void>;
+    changeFolder(): Promise<void>;
+    revokeAccess(): Promise<void>;
+    exportAllData(): Promise<void>;
+    importAllData(file: File): Promise<void>;
+    private render;
+}
+
+declare class AdvancedTestEditorElement extends HTMLElement {
+    private shadow;
+    private readonly transformationService;
+    persistence: PersistenceService;
+    translation: TranslationService;
+    testId?: number;
+    e2eTree: Array<DirectoryNode | FileNode>;
+    selectedFile: unknown;
+    saveButtonEnabled: boolean;
+    selectedFileHandle: FileSystemFileHandle | null;
+    selectedFileContent: string | null;
+    testItBlock: string;
+    interceptorsBlock: string;
+    isPreviewMode: boolean;
+    previewFileName: string | null;
+    previewFileContent: string | null;
+    private hasPermission;
+    private needsReauth;
+    private _dirHandle;
+    constructor();
+    connectedCallback(): void;
+    private t;
+    private init;
+    getFoldersData(): Promise<void>;
+    saveCommandsToFile(): Promise<void>;
+    onFileClick(file: unknown): Promise<void>;
+    markFileAsSelected(file: unknown): void;
+    loadCypressCommandsForTest(testId: number): Promise<void>;
+    copyToClipboard(text: string): void;
+    openEditManually(): void;
+    closePreview(): void;
+    private render;
+}
+
+declare class FilePreviewElement extends HTMLElement {
+    private shadow;
+    private textarea;
+    fileName: string | null;
+    closeLabel: string;
+    translation: TranslationService;
+    itBlock: string;
+    interceptorsBlock: string;
+    commands: string[];
+    interceptors: string[];
+    private _fileContent;
+    private _originalContent;
+    private _showDiff;
+    constructor();
+    connectedCallback(): void;
+    private t;
+    get fileContent(): string | null;
+    set fileContent(v: string | null);
+    saveFile(): void;
+    onClose(): void;
+    launchTest(specPath?: string): Promise<void>;
+    copyToClipboard(text: string): void;
+    toggleDiff(): void;
+    private render;
+}
+
+declare class LibE2eRecorderElement extends HTMLElement {
+    private shadow;
+    private keydownHandler;
+    private recordingUnsub?;
+    private commandsUnsub?;
+    private interceptorsUnsub?;
+    private pauseUnsub?;
+    private selectorNotFoundUnsub?;
+    private controlFirstTimeData;
+    private _previsualizerRef;
+    private httpMonitor?;
+    private smartSelectorEnabled;
+    recording: RecordingService;
+    persistence: PersistenceService;
+    translation: TranslationService;
+    isRecording: boolean;
+    isPaused: boolean;
+    cypressCommands: string[];
+    interceptors: string[];
+    isCommandsDialogOpen: boolean;
+    isSavedTestsDialogOpen: boolean;
+    isSaveTestDialogOpen: boolean;
+    isSettingsDialogOpen: boolean;
+    isAdvancedEditorDialogOpen: boolean;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private initHttpConfig;
+    private initLanguage;
+    private initSubscriptions;
+    private showSelectorPicker;
+    private initSelectorStrategy;
+    toggle(): void;
+    togglePause(): void;
+    setLanguage(lang?: string): void;
+    handleKeyboardEvent(event: KeyboardEvent): void;
+    private saveRecordingHistory;
+    recoverLastRecording(): void;
+    clearRecordingHistory(): void;
+    getRecordingHistory(): Array<{
+        commands: string[];
+        interceptors: string[];
+        savedAt: number;
+    }>;
+    private initFilesystemAccess;
+    private showFilesystemSetupDialog;
+    showCommandsDialog(): void;
+    showSavedTestsDialog(): void;
+    showSaveTestDialog(): void;
+    showSettingsDialog(): void;
+    showAdvancedEditorDialog(testId?: number): void;
+    private showFileEditorDialog;
+    private onSaveTest;
+    private onSaveAndExportTest;
+    private toggleModal;
+    private resizePopup;
+    private render;
+}
+
+declare const VERSION = "0.1.0";
+
+export { AdvancedTestEditorElement, AdvancedTestTransformationService, ConfigurationElement, type DBSchema, type DBStore, type DBStoreIndex, DB_SCHEMA, DB_STORE_NAMES, type DirectoryNode, type FileNode, FilePreviewElement, HttpMonitor, INPUT_TYPES, type InputType, LIB_E2E_CYPRESS_FOR_DUMMYS_SWAL2_STYLES, type Lang, LibE2eRecorderElement, PersistenceService, RecordingService, SCROLLBAR_STYLES, SUPPORTED_LANGS, SaveTestElement, type SelectorStrategy, Subject, type TestDetail, TestEditorElement, TestPrevisualizerElement, type TestWithDetails, TransformationService, TranslationService, VERSION, advancedTestTransformationService, generateAlias, injectStyles, isLang, makeModalResizable, makeSwalDraggable, makeSwalDraggableByContentId, persistenceService, setSwal2DataCyAttribute, showToast, transformationService, translationService };