@dxtmisha/scripts 0.11.8 → 1.0.0

package/src/classes/Ai/AiOpenAiLite.ts

@@ -1,107 +0,0 @@
-import { OpenAI } from 'openai'
-import { forEach } from '@dxtmisha/functional-basic'
-
-import { AiAbstract } from './AiAbstract'
-
-/**
- * OpenAI implementation of AiAbstract.
- * Initializes OpenAI client and performs text generation requests.
- *
- * Реализация OpenAI поверх AiAbstract.
- * Инициализирует клиент OpenAI и выполняет запросы генерации текста.
- *
- * Responsibilities / Ответственности:
- * - Provide API key / Предоставить API ключ
- * - Initialize OpenAI client / Инициализировать клиент OpenAI
- * - Call chat.completions.create and extract text content / Вызвать chat.completions.create и извлечь текст
- *
- * Notes / Примечания:
- * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
- * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
- */
-export class AiOpenAiLite extends AiAbstract<OpenAI> {
-  /**
-   * Initializes OpenAI client instance.
-   *
-   * Инициализирует экземпляр клиента OpenAI.
-   */
-  protected init(): void {
-    this.ai = new OpenAI({
-      apiKey: this.key
-    })
-  }
-
-  /**
-   * Implementation hook: convert accumulated images to model-specific format.
-   * OpenAI expects images as content blocks with type 'image_url'.
-   *
-   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
-   * OpenAI ожидает изображения как блоки контента с типом 'image_url'.
-   */
-  protected toImages(): any {
-    return forEach(this.images, image => ({
-      type: 'image_url',
-      image_url: {
-        url: `data:${image.mime};base64,${image.base64}`
-      }
-    }))
-  }
-
-  /**
-   * Implementation hook: convert accumulated contents to model-specific format.
-   * OpenAI expects text as content blocks with type 'text'.
-   *
-   * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
-   * OpenAI ожидает текст как блоки контента с типом 'text'.
-   */
-  protected toContents(): any {
-    return forEach(this.contents, content => ({
-      type: 'text',
-      text: content
-    }))
-  }
-
-  /**
-   * Performs content generation request and returns textual result.
-   *
-   * Выполняет запрос генерации контента и возвращает текстовый результат.
-   * @param model Model identifier (e.g., 'gpt-4o') / Идентификатор модели
-   * @param contents Composed contents for generation / Собранный контент для генерации
-   */
-  protected async response(
-    model: string,
-    contents: string
-  ): Promise<string> {
-    console.log('asd', this.ai?.baseURL, JSON.stringify({
-      model,
-      messages: [
-        {
-          role: 'user',
-          content: [
-            ...this.toImages(),
-            ...this.toContents(),
-            { type: 'text', text: contents }
-          ]
-        }
-      ],
-      ...this.config
-    }))
-
-    const response = await this.ai?.chat.completions.create({
-      model,
-      messages: [
-        {
-          role: 'user',
-          content: [
-            ...this.toImages(),
-            ...this.toContents(),
-            { type: 'text', text: contents }
-          ]
-        }
-      ],
-      ...this.config
-    })
-
-    return response?.choices?.[0]?.message?.content ?? ''
-  }
-}

package/src/classes/Ai/AiZAi.ts

@@ -1,17 +0,0 @@
-import { getConfigAi } from '../../functions/getConfigAi'
-import { AiZAiLite } from './AiZAiLite'
-
-/**
- * Z.ai (Zhipu AI) implementation extending AiZAiLite.
- * Automatically configured using project environment settings.
- *
- * Реализация Z.ai (Zhipu AI) расширяющая AiZAiLite.
- * Автоматически настраивается с использованием настроек окружения проекта.
- */
-export class AiZAi extends AiZAiLite {
-  constructor() {
-    super(
-      ...getConfigAi()
-    )
-  }
-}

package/src/classes/Ai/AiZAiLite.ts

@@ -1,77 +0,0 @@
-import { createXai, type XaiProvider } from '@ai-sdk/xai'
-import { generateText } from 'ai'
-import { forEach } from '@dxtmisha/functional-basic'
-
-import { AiAbstract } from './AiAbstract'
-
-/**
- * xAI (Grok) implementation of AiAbstract using @ai-sdk/xai and ai SDK.
- * Performs text generation requests via Grok models (e.g. grok-4.5).
- *
- * Реализация xAI (Grok) поверх AiAbstract с использованием @ai-sdk/xai и ai SDK.
- * Выполняет запросы генерации текста через модели Grok (например, grok-4.5).
- *
- * Responsibilities / Ответственности:
- * - Initialize xAI client provider / Инициализировать провайдер клиента xAI
- * - Execute generateText via Grok responses model / Выполнять generateText через модель ответов Grok
- */
-export class AiZAiLite extends AiAbstract<XaiProvider> {
-  /**
-   * Initializes xAI client provider instance.
-   *
-   * Инициализирует экземпляр провайдера клиента xAI.
-   */
-  protected init(): void {
-    this.ai = createXai({
-      apiKey: this.key
-    })
-  }
-
-  /**
-   * Implementation hook: convert accumulated images to model-specific format.
-   *
-   * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
-   */
-  protected toImages(): any[] {
-    return forEach(this.images, image => ({
-      type: 'image',
-      image: `data:${image.mime};base64,${image.base64}`
-    }))
-  }
-
-  /**
-   * Implementation hook: convert accumulated contents to model-specific format.
-   *
-   * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
-   */
-  protected toContents(): any[] {
-    return forEach(this.contents, content => ({
-      type: 'text',
-      text: content
-    }))
-  }
-
-  /**
-   * Performs content generation request using xAI responses model and returns textual result.
-   *
-   * Выполняет запрос генерации контента с использованием модели ответов xAI и возвращает текстовый результат.
-   * @param model - Model identifier (e.g., 'grok-4.5') / Идентификатор модели
-   * @param contents - Composed contents for generation / Собранный контент для генерации
-   * @returns Generated text response / Сгенерированный текстовый ответ
-   */
-  protected async response(
-    model: string,
-    contents: string
-  ): Promise<string> {
-    const client = this.ai ?? createXai({ apiKey: this.key })
-    const activeModel = model || 'grok-4.5'
-
-    const { text } = await generateText({
-      model: client.responses(activeModel as any),
-      prompt: contents,
-      ...this.config
-    })
-
-    return text ?? ''
-  }
-}

package/src/classes/Ai/ApiTmp.ts

@@ -1,43 +0,0 @@
-import { PropertiesFile } from '../Properties/PropertiesFile'
-
-const TEMPORARY_DIR = './ai-tmp'
-
-/**
- * ApiTmp
- */
-export class ApiTmp {
-  protected idFile = 1
-
-  /**
-   * Generates a unique file path for the temporary prompt.
-   *
-   * Генерирует уникальный путь к файлу для временного промпта.
-   */
-  protected getFileName(): string {
-    return `${TEMPORARY_DIR}/Prompt-${this.idFile++}.txt`
-  }
-
-  /**
-   * Creates a temporary file with the prompt content and returns the path formatted for the CLI.
-   *
-   * Создает временный файл с содержимым промпта и возвращает путь, отформатированный для CLI.
-   * @param content Prompt content / Содержимое промпта
-   * @returns Formatted file path (e.g., @./ai-tmp/Prompt-1.txt) / Отформатированный путь к файлу
-   */
-  createFile(content: string): string {
-    const name = this.getFileName()
-
-    PropertiesFile.writeByPath(name, content.trim())
-
-    return `Please read the following file as it contains the prompt instructions: @${name}`
-  }
-
-  /**
-   * Cleans up temporary files and directories.
-   *
-   * Очищает временные файлы и директории.
-   */
-  removeFile(): void {
-    PropertiesFile.removeDir(TEMPORARY_DIR)
-  }
-}

package/src/classes/BrowserItem.ts

@@ -1,408 +0,0 @@
-import {
-  type Browser,
-  type EvaluateFunc,
-  type HTTPResponse,
-  launch,
-  type Page,
-  type PuppeteerLifeCycleEvent
-} from 'puppeteer'
-import { sleep } from '@dxtmisha/functional-basic'
-
-import {
-  type ScreenshotMetrics,
-  type ScreenshotOptions,
-  SCREENSHOT_ARGS,
-  SCREENSHOT_FORMAT,
-  SCREENSHOT_HEIGHTS,
-  SCREENSHOT_TIMEOUT,
-  SCREENSHOT_QUALITY,
-  SCREENSHOT_WAIT_UNTIL,
-  SCREENSHOT_WIDTHS
-} from '../types/screenshotTypes'
-
-/**
- * Class for managing browser instances and taking screenshots using Puppeteer.
- *
- * Класс для управления экземплярами браузера и создания скриншотов с помощью Puppeteer.
- */
-export class BrowserItem {
-  /** Browser instance / Экземпляр браузера */
-  protected browser?: Browser
-
-  /** Page instance / Экземпляр страницы */
-  protected page?: Page
-
-  /** HTTP Response from page loading / HTTP-ответ при загрузке страницы */
-  protected response?: HTTPResponse
-
-  /** Total scrollable width of the loaded page / Полная прокручиваемая ширина загруженной страницы */
-  protected pageWidth: number = -1
-
-  /** Total scrollable height of the loaded page / Полная прокручиваемая высота загруженной страницы */
-  protected pageHeight: number = -1
-
-  /**
-   * Constructor
-   * @param url component path / путь к компоненту
-   * @param options additional options for capture / дополнительные опции захвата
-   */
-  constructor(
-    protected url: string,
-    protected readonly options: ScreenshotOptions = {}
-  ) {
-  }
-
-  /** Additional arguments for browser launch / Дополнительные аргументы для запуска браузера */
-  get args(): string[] {
-    return this.options.args ?? SCREENSHOT_ARGS
-  }
-
-  /** Condition to wait for when navigating to the page / Условие, которое нужно дождаться при переходе на страницу */
-  get waitUntil(): PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[] {
-    return this.options.waitUntil ?? SCREENSHOT_WAIT_UNTIL
-  }
-
-  /** Timeout for navigating to the page / Таймаут для перехода на страницу */
-  get timeout(): number {
-    return this.options.timeout ?? SCREENSHOT_TIMEOUT
-  }
-
-  /** Image format for screenshots / Формат изображения для скриншотов */
-  get format(): ScreenshotOptions['format'] {
-    return this.options.format ?? SCREENSHOT_FORMAT
-  }
-
-  /** Viewport width for the initial capture / Ширина порта просмотра для начального захвата */
-  get width(): number {
-    return this.options.width ?? SCREENSHOT_WIDTHS
-  }
-
-  /** Viewport height for the initial capture and page-by-page slicing / Высота порта просмотра для начального захвата и постраничной нарезки */
-  get height(): number {
-    return this.options.height ?? SCREENSHOT_HEIGHTS
-  }
-
-  /** Quality for JPEG/WebP formats (0-100) / Качество для форматов JPEG/WebP (0-100) */
-  get quality(): number {
-    return this.options.quality ?? SCREENSHOT_QUALITY
-  }
-
-  /** Whether to capture the whole scrollable page at once or in slices / Захватывать ли всю прокручиваемую страницу сразу или по частям */
-  get fullPage(): boolean {
-    return this.options.fullPage ?? false
-  }
-
-  /** File extension based on the selected format / Расширение файла на основе выбранного формата */
-  get extension(): string {
-    const format = this.format
-
-    if (format === 'jpeg') {
-      return '.jpg'
-    }
-
-    return `.${format}`
-  }
-
-  /**
-   * launches or returns the browser instance.
-   *
-   * Запускает или возвращает экземпляр браузера.
-   * @returns browser instance / экземпляр браузера
-   */
-  async getBrowser(): Promise<Browser> {
-    if (!this.browser) {
-      this.browser = await launch({
-        headless: true,
-        args: this.args
-      })
-    }
-
-    return this.browser
-  }
-
-  /**
-   * Creates or returns the page instance.
-   *
-   * Создает или возвращает экземпляр страницы.
-   * @returns page instance / экземпляр страницы
-   */
-  async getPage(): Promise<Page> {
-    if (!this.page) {
-      this.page = await (await this.getBrowser()).newPage()
-
-      await this.page.setViewport({
-        width: this.width,
-        height: this.height
-      })
-
-      this.page.on(
-        'console',
-        msg => this.toConsole(`Log: ${msg.text()}`)
-      )
-
-      this.page.on(
-        'pageerror',
-        err => this.toConsole(`Error: ${(err as any)?.message}`)
-      )
-    }
-
-    return this.page
-  }
-
-  /**
-   * Navigates to the URL and returns the HTTP response.
-   *
-   * Переходит по URL и возвращает HTTP-ответ.
-   * @returns HTTP response or undefined / HTTP-ответ или undefined
-   */
-  async getResponse(): Promise<HTTPResponse | undefined> {
-    if (!this.response) {
-      const response = await (await this.getPage()).goto(this.url, {
-        waitUntil: this.waitUntil,
-        timeout: this.timeout
-      })
-
-      if (
-        response
-        && response.ok()
-      ) {
-        this.response = response
-      } else {
-        this.toConsole(
-          `Failed to load page: ${this.url}. Status: ${response?.status()}`
-        )
-      }
-    }
-
-    return this.response
-  }
-
-  /**
-   * Retrieves the HTML content of the page.
-   *
-   * Извлекает HTML-содержимое страницы.
-   * @returns html content string / HTML-содержимое
-   */
-  async getDom(): Promise<string> {
-    return await (await this.getPage()).content()
-  }
-
-  /**
-   * Retrieves the HTML content of the body.
-   *
-   * Извлекает HTML-содержимое тела (body) страницы.
-   * @returns body html content string / HTML-содержимое body
-   */
-  async getBody(): Promise<string> {
-    return await this.evaluate(() => document.body.innerHTML) ?? ''
-  }
-
-  /**
-   * Retrieves all CSS styles from the page.
-   *
-   * Извлекает все CSS-стили со страницы.
-   * @returns CSS content string / CSS-содержимое
-   */
-  async getStyles(): Promise<string> {
-    return await this.evaluate(() => {
-      return Array.from(document.styleSheets)
-        .map((sheet) => {
-          try {
-            return Array.from(sheet.cssRules)
-              .map(rule => rule.cssText)
-              .join('\n')
-          } catch (e) {
-            console.error('Error getting CSS rules:', e)
-            return ''
-          }
-        })
-        .join('\n')
-    }) ?? ''
-  }
-
-  /**
-   * Extracts scrollable dimensions of the page.
-   *
-   * Извлекает прокручиваемые размеры страницы.
-   * @returns object with width and height / объект с шириной и высотой
-   */
-  async getMetrics(): Promise<ScreenshotMetrics> {
-    if (
-      await this.getResponse()
-      && (
-        this.pageWidth === -1
-        || this.pageHeight === -1
-      )
-    ) {
-      const metrics = await this.evaluate(() => {
-        return {
-          height: document.documentElement.scrollHeight,
-          width: document.documentElement.scrollWidth
-        }
-      })
-
-      if (metrics) {
-        this.pageWidth = metrics.width
-        this.pageHeight = metrics.height
-      }
-    }
-
-    return {
-      height: this.pageHeight,
-      width: this.pageWidth
-    }
-  }
-
-  /**
-   * Evaluates a function in the browser context.
-   *
-   * Выполняет функцию в контексте браузера.
-   * @param pageFunction function to evaluate / функция для выполнения
-   * @param args arguments for the function / аргументы для функции
-   * @returns result of evaluation / результат выполнения
-   */
-  async evaluate<
-    Params extends unknown[],
-    Func extends EvaluateFunc<Params> = EvaluateFunc<Params>
-  >(
-    pageFunction: Func | string,
-    ...args: Params
-  ): Promise<Awaited<ReturnType<Func>> | undefined> {
-    return await (await this.getPage()).evaluate<Params, Func>(
-      pageFunction,
-      ...args
-    )
-  }
-
-  /**
-   * Captures screenshots based on the fullPage option.
-   *
-   * Создает скриншоты в зависимости от опции fullPage.
-   * @param outputPath base path for saving / базовый путь для сохранения
-   * @returns this instance / этот экземпляр
-   */
-  async screenshot(outputPath: string): Promise<this> {
-    if (this.fullPage) {
-      await this.screenshotFull(outputPath)
-    } else {
-      await this.screenshotPages(outputPath)
-    }
-
-    return this
-  }
-
-  /**
-   * Resets internal page and response states.
-   *
-   * Сбрасывает состояние страницы и ответа.
-   * @returns this instance / этот экземпляр
-   */
-  async reset(): Promise<this> {
-    this.page = undefined
-    this.pageWidth = -1
-    this.pageHeight = -1
-
-    this.response = undefined
-
-    return this
-  }
-
-  /**
-   * Formats the final file path based on current state and index.
-   *
-   * Форматирует итоговый путь к файлу на основе состояния и индекса.
-   * @param outputPath original output path / исходный путь сохранения
-   * @param index current page index / текущий индекс страницы
-   * @param max total pages count / общее количество страниц
-   * @returns formatted path string / отформатированная строка пути
-   */
-  protected getOutputPath(
-    outputPath: string,
-    index: number = 1,
-    max: number = 1
-  ): string {
-    if (this.fullPage) {
-      return outputPath + this.extension
-    }
-
-    return outputPath + `-${max}_${index}` + this.extension
-  }
-
-  /**
-   * Internal wrapper for Puppeteer's screenshot method.
-   *
-   * Внутренняя обертка для метода скриншота Puppeteer.
-   * @param path specific file path / путь к конкретному файлу
-   * @returns this instance / этот экземпляр
-   */
-  protected async saveScreenshot(path: string): Promise<this> {
-    const type = this.format
-    const quality = type === 'png' ? undefined : this.quality
-
-    await (await this.getPage()).screenshot({
-      path,
-      type,
-      quality,
-      fullPage: this.fullPage
-    })
-
-    return this
-  }
-
-  /**
-   * Iterates through page slices and saves multiple screenshots.
-   *
-   * Проходит по частям страницы и сохраняет несколько скриншотов.
-   * @param outputPath base output path / базовый путь сохранения
-   * @returns this instance / этот экземпляр
-   */
-  protected async screenshotPages(outputPath: string): Promise<this> {
-    const {
-      height: pageHeight
-    } = await this.getMetrics()
-
-    const viewportHeight = this.height
-    const pages = Math.ceil(pageHeight / viewportHeight)
-
-    this.toConsole(`Page height: ${pageHeight}px, viewport height: ${viewportHeight}px, total pages: ${pages}`)
-
-    for (let i = 0; i < pages; i++) {
-      const currentY = i * viewportHeight
-      const fileOutputPath = this.getOutputPath(outputPath, i + 1, pages)
-
-      await this.evaluate(y => window.scrollTo(0, y), currentY)
-      await sleep(320)
-      await this.saveScreenshot(fileOutputPath)
-
-      this.toConsole(`Saved screenshot page ${i + 1}/${pages} to ${fileOutputPath}`)
-    }
-
-    return this
-  }
-
-  /**
-   * Captures a single full page screenshot.
-   *
-   * Создает один скриншот всей страницы.
-   * @param outputPath output path / путь сохранения
-   * @returns this instance / этот экземпляр
-   */
-  protected async screenshotFull(outputPath: string): Promise<this> {
-    const outputPathFull = this.getOutputPath(outputPath)
-    await this.saveScreenshot(outputPathFull)
-
-    this.toConsole(`Saved full page screenshot to ${outputPathFull}`)
-
-    return this
-  }
-
-  /**
-   * Logs text with a "Browser" prefix.
-   *
-   * Выводит текст в консоль с префиксом "Browser".
-   * @param text text to log / текст для вывода
-   */
-  protected toConsole(text: string): void {
-    console.log('Browser', text)
-  }
-}