@promptbook/cli 0.112.0-96 → 0.112.0-98

package/umd/src/book-components/Chat/Chat/ChatActionsBar.d.ts

@@ -1,5 +1,6 @@
 import { type MouseEvent, type MutableRefObject, type ReactNode } from 'react';
 import type { Promisable } from 'type-fest';
+import type { ChatSaveFormatHandlerMap } from '../save/_common/ChatSaveFormatHandler';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
@@ -27,6 +28,7 @@ export type ChatActionsBarProps = {
     onUseTemplate?: () => void;
     extraActions?: ReactNode;
     saveFormats?: Array<string_chat_format_name>;
+    saveFormatHandlers?: ChatSaveFormatHandlerMap;
     isSaveButtonEnabled: boolean;
     shouldFadeActions: boolean;
     /**

package/umd/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -8,6 +8,7 @@ import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
+import type { ChatSaveFormatHandlerMap } from '../save/_common/ChatSaveFormatHandler';
 /**
  * Response data returned by the optional `onFeedback` handler.
  *
@@ -629,6 +630,11 @@ export type ChatProps = {
      * @default * All supported formats (see `string_chat_format_name` type)
      */
     readonly saveFormats?: Array<string_chat_format_name>;
+    /**
+     * Optional host-provided handlers that replace the default browser download flow
+     * for selected save formats.
+     */
+    readonly saveFormatHandlers?: ChatSaveFormatHandlerMap;
     /**
      * Is the writing textarea automatically focused?
      *

package/umd/src/book-components/Chat/save/_common/ChatSaveFormatHandler.d.ts

@@ -0,0 +1,35 @@
+import type { Promisable } from 'type-fest';
+import type { ChatMessage } from '../../types/ChatMessage';
+import type { ChatParticipant } from '../../types/ChatParticipant';
+import type { string_chat_format_name } from './string_chat_format_name';
+/**
+ * Serializable chat payload exposed to custom save-format handlers.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandlerOptions = {
+    /**
+     * Exported chat title used by downstream filename or document generation.
+     */
+    readonly title: string;
+    /**
+     * Messages included in the export.
+     */
+    readonly messages: ReadonlyArray<ChatMessage>;
+    /**
+     * Participant metadata included in the export.
+     */
+    readonly participants: ReadonlyArray<ChatParticipant>;
+};
+/**
+ * Custom handler used to override one chat save format.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandler = (options: ChatSaveFormatHandlerOptions) => Promisable<void>;
+/**
+ * Optional map of chat save formats handled by the host application.
+ *
+ * @private Internal helper for chat save integrations.
+ */
+export type ChatSaveFormatHandlerMap = Partial<Record<string_chat_format_name, ChatSaveFormatHandler>>;

package/umd/src/book-components/Chat/save/_common/createChatExportFilename.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Builds one normalized filename for a chat export download.
+ *
+ * @param title - Human-readable chat title.
+ * @param fileExtension - Output file extension without a leading dot.
+ * @param date - Export date used in the filename.
+ * @returns Stable filename suitable for browser downloads and HTTP headers.
+ *
+ * @private Internal helper shared by chat export flows.
+ */
+export declare function createChatExportFilename(title: string, fileExtension: string, date?: Date): string;

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-94`).
+ * It follows semantic versioning (e.g., `0.112.0-97`).
  *
  * @generated
  */

package/src/conversion/validation/_importPipeline.ts

@@ -1,88 +0,0 @@
-import { readFile } from 'fs/promises';
-import { join } from 'path';
-import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
-import type { PipelineString } from '../../pipeline/PipelineString';
-import { validatePipelineString } from '../../pipeline/validatePipelineString';
-import { unpreparePipeline } from '../../prepare/unpreparePipeline';
-import { $provideFilesystemForNode } from '../../scrapers/_common/register/$provideFilesystemForNode';
-import type { string_filename } from '../../types/string_filename';
-import { loadArchive } from '../archive/loadArchive';
-
-/**
- * Import the pipeline.book or pipeline.bookc file
- *
- * Note: Using here custom import to work in jest tests
- * Note: Using sync version is 💩 in the production code, but it's ok here in tests
- *
- * @param path - The path to the file relative to examples/pipelines directory
- *
- * @private internal function of tests
- */
-export async function importPipelineWithoutPreparation(path: `${string}.book`): Promise<PipelineString>;
-/**
- * Imports pipeline without preparation.
- *
- * @private internal utility of `_importPipeline`
- */
-export async function importPipelineWithoutPreparation(path: `${string}.bookc`): Promise<PipelineJson>;
-/**
- * Imports pipeline without preparation.
- *
- * @private internal utility of `_importPipeline`
- */
-export async function importPipelineWithoutPreparation(path: string_filename): Promise<PipelineString | PipelineJson> {
-    const examplesDir = '../../../examples/pipelines'; // <- TODO: [🚏] DRY, to config
-    const filePath = join(__dirname, examplesDir, path);
-
-    if (path.endsWith('.bookc')) {
-        const pipelines = await loadArchive(filePath, $provideFilesystemForNode());
-
-        if (pipelines.length !== 1) {
-            throw new Error('The archive must contain exactly one pipeline');
-        }
-
-        let pipeline = pipelines[0]!;
-
-        pipeline = unpreparePipeline(pipeline);
-        return pipeline;
-    } else if (path.endsWith('.book')) {
-        const content = await readFile(filePath, 'utf-8');
-
-        return validatePipelineString(content);
-    } else {
-        throw new Error('This should be used only for .book.md or .bookc files');
-    }
-}
-
-/**
- * Import the pipeline.bookc file as parsed JSON
- *
- * @private internal function of tests
- */
-export async function importPipelineJson(path: `${string}.bookc`): Promise<PipelineJson> {
-    const examplesDir = '../../../examples/pipelines'; // <- TODO: [🚏] DRY, to config
-
-    const pipelines = await loadArchive(join(__dirname, examplesDir, path), $provideFilesystemForNode());
-
-    if (pipelines.length !== 1) {
-        throw new Error('The archive must contain exactly one pipeline');
-    }
-
-    const pipeline = pipelines[0]!;
-
-    return pipeline;
-}
-
-/*
-TODO: [👩🏽‍🤝‍🧑🏾]
-/**
- * Import the pipeline.bookc file as string
- *
- * @private internal function of tests
- * /
-ex_port async function importPipelineJsonAsString(path: `${string}.bookc`): Promise<string_json<PipelineJson>> {
-}
-*/
-
-// Note: [⚫] Code for private pipeline import shim [_importPipeline](src/conversion/validation/_importPipeline.ts) should never be published in any package
-// Note: [💞] Ignore a discrepancy between file name and entity name