@automattic/jetpack-ai-client 0.6.1 → 0.8.0

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.0] - 2024-02-26
+### Added
+- Add upgrade message for free tier [#35794]
+
+### Changed
+- Updated package dependencies. [#35793]
+- Voice to Content: Add audio analyser to media recording hook [#35877]
+- Voice to Content: Make transcriptions cancelable and add onProcess callback [#35737]
+
+## [0.7.0] - 2024-02-19
+### Added
+- AI Client: add support for audio transcriptions. [#35691]
+- AI Client: add support for transcription post-processing. [#35734]
+
+### Changed
+- AI Client: Update voice to content feature [#35698]
+- Make build usable in projects using tsc with `moduleResolution` set to 'nodenext'. [#35453]
+- Voice to Content: Add states and refactor duration calculation [#35717]
+
 ## [0.6.1] - 2024-02-13
 ### Changed
 - Updated package dependencies. [#35608]
@@ -210,6 +229,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Updated package dependencies. [#31659]
 - Updated package dependencies. [#31785]
 
+[0.8.0]: https://github.com/Automattic/jetpack-ai-client/compare/v0.7.0...v0.8.0
+[0.7.0]: https://github.com/Automattic/jetpack-ai-client/compare/v0.6.1...v0.7.0
 [0.6.1]: https://github.com/Automattic/jetpack-ai-client/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/Automattic/jetpack-ai-client/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/Automattic/jetpack-ai-client/compare/v0.5.0...v0.5.1

package/build/api-fetch/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * External dependencies
+ */
+import apiFetchMod from '@wordpress/api-fetch';
+type ApiFetchType = typeof apiFetchMod.default;
+declare const apiFetch: ApiFetchType;
+export default apiFetch;

package/build/api-fetch/index.js

@@ -0,0 +1,6 @@
+/**
+ * External dependencies
+ */
+import apiFetchMod from '@wordpress/api-fetch';
+const apiFetch = (apiFetchMod.default ?? apiFetchMod);
+export default apiFetch;

package/build/ask-question/index.d.ts

@@ -1,5 +1,5 @@
-import SuggestionsEventSource from '../suggestions-event-source';
-import type { AiModelTypeProp, PromptProp } from '../types';
+import SuggestionsEventSource from '../suggestions-event-source/index.js';
+import type { AiModelTypeProp, PromptProp } from '../types.js';
 export type AskQuestionOptionsArgProps = {
     postId?: number;
     fromCache?: boolean;

package/build/ask-question/index.js

@@ -2,7 +2,7 @@
  * External dependencies
  */
 import debugFactory from 'debug';
-import SuggestionsEventSource from '../suggestions-event-source';
+import SuggestionsEventSource from '../suggestions-event-source/index.js';
 const debug = debugFactory('jetpack-ai-client:ask-question');
 /**
  * An asynchronous function that asks a question

package/build/audio-transcription/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Types
+ */
+import { CancelablePromise } from '../types.js';
+/**
+ * A function that takes an audio blob and transcribes it.
+ *
+ * @param {Blob} audio - The audio to be transcribed, from a recording or from a file.
+ * @param {string} feature - The feature name that is calling the transcription.
+ * @returns {Promise<string>} - The promise of a string containing the transcribed audio.
+ */
+export default function transcribeAudio(audio: Blob, feature?: string): CancelablePromise<string>;

package/build/audio-transcription/index.js

@@ -0,0 +1,51 @@
+/**
+ * External dependencies
+ */
+import debugFactory from 'debug';
+/**
+ * Internal dependencies
+ */
+import apiFetch from '../api-fetch/index.js';
+import requestJwt from '../jwt/index.js';
+const debug = debugFactory('jetpack-ai-client:audio-transcription');
+/**
+ * A function that takes an audio blob and transcribes it.
+ *
+ * @param {Blob} audio - The audio to be transcribed, from a recording or from a file.
+ * @param {string} feature - The feature name that is calling the transcription.
+ * @returns {Promise<string>} - The promise of a string containing the transcribed audio.
+ */
+export default async function transcribeAudio(audio, feature
+// @ts-expect-error Promises are not cancelable by default
+) {
+    debug('Transcribing audio: %o. Feature: %o', audio, feature);
+    // Get a token to use the transcription service
+    let token = '';
+    try {
+        token = (await requestJwt()).token;
+    }
+    catch (error) {
+        debug('Error getting token: %o', error);
+        return Promise.reject(error);
+    }
+    // Build a FormData object to hold the audio file
+    const formData = new FormData();
+    formData.append('audio_file', audio);
+    try {
+        const headers = {
+            Authorization: `Bearer ${token}`,
+        };
+        const response = await apiFetch({
+            url: `https://public-api.wordpress.com/wpcom/v2/jetpack-ai-transcription${feature ? `?feature=${feature}` : ''}`,
+            method: 'POST',
+            body: formData,
+            headers,
+        });
+        debug('Transcription response: %o', response);
+        return response.text;
+    }
+    catch (error) {
+        debug('Transcription error response: %o', error);
+        return Promise.reject(error);
+    }
+}

package/build/components/ai-control/index.d.ts

@@ -6,7 +6,8 @@ import './style.scss';
 /**
  * Types
  */
-import type { RequestingStateProp } from '../../types';
+import type { RequestingStateProp } from '../../types.js';
+import type { ReactElement } from 'react';
 type AiControlProps = {
     disabled?: boolean;
     value: string;
@@ -17,23 +18,23 @@ type AiControlProps = {
     isTransparent?: boolean;
     state?: RequestingStateProp;
     showGuideLine?: boolean;
-    customFooter?: React.ReactElement;
+    customFooter?: ReactElement;
     onChange?: (newValue: string) => void;
     onSend?: (currentValue: string) => void;
     onStop?: () => void;
     onAccept?: () => void;
     onDiscard?: () => void;
     showRemove?: boolean;
-    bannerComponent?: React.ReactElement;
-    errorComponent?: React.ReactElement;
+    bannerComponent?: ReactElement;
+    errorComponent?: ReactElement;
 };
 /**
  * AI Control component.
  *
  * @param {AiControlProps} props       - Component props.
  * @param {React.MutableRefObject} ref - Ref to the component.
- * @returns {React.ReactElement}         Rendered component.
+ * @returns {ReactElement}         Rendered component.
  */
-export declare function AIControl({ disabled, value, placeholder, showAccept, acceptLabel, showButtonLabels, isTransparent, state, showGuideLine, customFooter, onChange, onSend, onStop, onAccept, onDiscard, showRemove, bannerComponent, errorComponent, }: AiControlProps, ref: React.MutableRefObject<null>): React.ReactElement;
+export declare function AIControl({ disabled, value, placeholder, showAccept, acceptLabel, showButtonLabels, isTransparent, state, showGuideLine, customFooter, onChange, onSend, onStop, onAccept, onDiscard, showRemove, bannerComponent, errorComponent, }: AiControlProps, ref: React.MutableRefObject<null>): ReactElement;
 declare const _default: React.ForwardRefExoticComponent<AiControlProps & React.RefAttributes<null>>;
 export default _default;

package/build/components/ai-control/index.js

@@ -5,17 +5,18 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import { PlainText } from '@wordpress/block-editor';
 import { Button, ButtonGroup } from '@wordpress/components';
 import { useKeyboardShortcut } from '@wordpress/compose';
-import { forwardRef, useImperativeHandle, useRef, useEffect, useCallback, } from '@wordpress/element';
+import { useImperativeHandle, useRef, useEffect, useCallback } from '@wordpress/element';
 import { __ } from '@wordpress/i18n';
 import { Icon, closeSmall, check, arrowUp, trash, reusableBlock } from '@wordpress/icons';
 import classNames from 'classnames';
+import { forwardRef } from 'react';
 import React from 'react';
 /**
  * Internal dependencies
  */
 import './style.scss';
-import AiStatusIndicator from '../ai-status-indicator';
-import { GuidelineMessage } from './message';
+import AiStatusIndicator from '../ai-status-indicator/index.js';
+import { GuidelineMessage } from './message.js';
 // eslint-disable-next-line @typescript-eslint/no-empty-function
 const noop = () => { };
 /**
@@ -23,10 +24,9 @@ const noop = () => { };
  *
  * @param {AiControlProps} props       - Component props.
  * @param {React.MutableRefObject} ref - Ref to the component.
- * @returns {React.ReactElement}         Rendered component.
+ * @returns {ReactElement}         Rendered component.
  */
-export function AIControl({ disabled = false, value = '', placeholder = '', showAccept = false, acceptLabel = __('Accept', 'jetpack-ai-client'), showButtonLabels = true, isTransparent = false, state = 'init', showGuideLine = false, customFooter = null, onChange = noop, onSend = noop, onStop = noop, onAccept = noop, onDiscard = null, showRemove = false, bannerComponent = null, errorComponent = null, }, ref // eslint-disable-line @typescript-eslint/ban-types
-) {
+export function AIControl({ disabled = false, value = '', placeholder = '', showAccept = false, acceptLabel = __('Accept', 'jetpack-ai-client'), showButtonLabels = true, isTransparent = false, state = 'init', showGuideLine = false, customFooter = null, onChange = noop, onSend = noop, onStop = noop, onAccept = noop, onDiscard = null, showRemove = false, bannerComponent = null, errorComponent = null, }, ref) {
     const promptUserInputRef = useRef(null);
     const loading = state === 'requesting' || state === 'suggesting';
     const [editRequest, setEditRequest] = React.useState(false);

package/build/components/ai-control/message.d.ts

@@ -27,4 +27,14 @@ export default function Message({ severity, icon, children, }: MessageProps): Re
  * @returns {React.ReactElement } - Message component.
  */
 export declare function GuidelineMessage(): React.ReactElement;
+/**
+ * React component to render a upgrade message.
+ *
+ * @param {number} requestsRemaining - Number of requests remaining.
+ * @returns {React.ReactElement } - Message component.
+ */
+export declare function UpgradeMessage({ requestsRemaining, onUpgradeClick, }: {
+    requestsRemaining: number;
+    onUpgradeClick: () => void;
+}): React.ReactElement;
 export {};

package/build/components/ai-control/message.js

@@ -2,9 +2,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * External dependencies
  */
-import { ExternalLink } from '@wordpress/components';
+import { ExternalLink, Button } from '@wordpress/components';
 import { createInterpolateElement } from '@wordpress/element';
-import { __ } from '@wordpress/i18n';
+import { __, sprintf } from '@wordpress/i18n';
 import { Icon, warning, info, cancelCircleFilled as error, check as success, } from '@wordpress/icons';
 import './style.scss';
 export const MESSAGE_SEVERITY_WARNING = 'warning';
@@ -42,3 +42,16 @@ export function GuidelineMessage() {
             link: _jsx(ExternalLink, { href: "https://automattic.com/ai-guidelines" }),
         }) }));
 }
+/**
+ * React component to render a upgrade message.
+ *
+ * @param {number} requestsRemaining - Number of requests remaining.
+ * @returns {React.ReactElement } - Message component.
+ */
+export function UpgradeMessage({ requestsRemaining, onUpgradeClick, }) {
+    return (_jsx(Message, { severity: MESSAGE_SEVERITY_INFO, children: createInterpolateElement(sprintf(
+        // translators: %1$d: number of requests remaining
+        __('You have %1$d free requests remaining. <link>Upgrade</link> and avoid interruptions', 'jetpack-ai-client'), requestsRemaining), {
+            link: _jsx(Button, { variant: "link", onClick: onUpgradeClick }),
+        }) }));
+}

package/build/components/ai-status-indicator/index.d.ts

@@ -1,4 +1,4 @@
-import type { RequestingStateProp } from '../../types';
+import type { RequestingStateProp } from '../../types.js';
 export type AiStatusIndicatorIconSize = 24 | 32 | 48 | 64;
 import type React from 'react';
 import './style.scss';

package/build/components/audio-duration-display/index.d.ts

@@ -1,6 +1,7 @@
 import type React from 'react';
 type AudioDurationDisplayProps = {
-    url: string;
+    duration: number;
+    className?: string | null;
 };
 /**
  * AudioDurationDisplay component.
@@ -8,5 +9,5 @@ type AudioDurationDisplayProps = {
  * @param {AudioDurationDisplayProps} props - Component props.
  * @returns {React.ReactElement}              Rendered component.
  */
-export default function AudioDurationDisplay({ url, }: AudioDurationDisplayProps): React.ReactElement;
+export default function AudioDurationDisplay({ duration, className, }: AudioDurationDisplayProps): React.ReactElement;
 export {};

package/build/components/audio-duration-display/index.js

@@ -1,25 +1,14 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-/*
- * External dependencies
- */
-import { useState, useEffect } from '@wordpress/element';
 /*
  * Internal dependencies
  */
-import { formatTime, getDuration } from './lib/media';
+import { formatTime } from './lib/media.js';
 /**
  * AudioDurationDisplay component.
  *
  * @param {AudioDurationDisplayProps} props - Component props.
  * @returns {React.ReactElement}              Rendered component.
  */
-export default function AudioDurationDisplay({ url, }) {
-    const [duration, setDuration] = useState(0);
-    useEffect(() => {
-        if (!url) {
-            return;
-        }
-        getDuration(url).then(setDuration);
-    }, [url]);
-    return _jsx("span", { children: formatTime(duration, { addDecimalPart: false }) });
+export default function AudioDurationDisplay({ duration, className, }) {
+    return _jsx("span", { className: className, children: formatTime(duration, { addDecimalPart: false }) });
 }

package/build/components/audio-duration-display/lib/media.d.ts

@@ -1,29 +1,28 @@
-/**
- * Function to get duration of audio file
- *
- * @param {string} url - The url of the audio file
- * @returns {Promise<number>} The duration of the audio file
- * @see https://stackoverflow.com/questions/21522036/html-audio-tag-duration-always-infinity
- */
-export declare function getDuration(url: string): Promise<number>;
 type FormatTimeOptions = {
     /**
      * Whether to add the decimal part to the formatted time.
-     *
      */
     addDecimalPart?: boolean;
+    /**
+     * Whether to show the minutes part of the formatted time even when it's 0.
+     */
+    showMinutes?: boolean;
+    /**
+     * Whether to show the hours part of the formatted time even when it's 0.
+     */
+    showHours?: boolean;
 };
 /**
  * Formats the given time in milliseconds into a string with the format HH:MM:SS.DD,
  * adding hours and minutes only when needed.
  *
- * @param {number} time               - The time in seconds to format.
+ * @param {number} time               - The time in milliseconds to format.
  * @param {FormatTimeOptions} options - The arguments.
  * @returns {string}                    The formatted time string.
  * @example
- * const formattedTime1 = formatTime( 1234567 );                       // Returns "20:34.56"
- * const formattedTime2 = formatTime( 45123 );                         // Returns "45.12"
- * const formattedTime3 = formatTime( 64, { addDecimalPart: false } ); // Returns "01:04"
+ * const formattedTime1 = formatTime( 1234567, { addDecimalPart: true } ); // Returns "20:34.56"
+ * const formattedTime2 = formatTime( 45123 );                             // Returns "00.45"
+ * const formattedTime3 = formatTime( 1200, { showHours: true } );         // Returns "00:00:01"
  */
-export declare function formatTime(time: number, { addDecimalPart }?: FormatTimeOptions): string;
+export declare function formatTime(time: number, { addDecimalPart, showMinutes, showHours }?: FormatTimeOptions): string;
 export {};

package/build/components/audio-duration-display/lib/media.js

@@ -1,48 +1,23 @@
-/**
- * Function to get duration of audio file
- *
- * @param {string} url - The url of the audio file
- * @returns {Promise<number>} The duration of the audio file
- * @see https://stackoverflow.com/questions/21522036/html-audio-tag-duration-always-infinity
- */
-export function getDuration(url) {
-    return new Promise(next => {
-        const tmpAudioInstance = new Audio(url);
-        tmpAudioInstance.addEventListener('durationchange', function () {
-            if (this.duration === Infinity) {
-                return;
-            }
-            const duration = this.duration;
-            tmpAudioInstance.remove(); // remove instance from memory
-            next(duration);
-        }, false);
-        tmpAudioInstance.load();
-        tmpAudioInstance.currentTime = 24 * 60 * 60; // Fake big time
-        tmpAudioInstance.volume = 0;
-        tmpAudioInstance.play(); // This will call `durationchange` event
-    });
-}
 /**
  * Formats the given time in milliseconds into a string with the format HH:MM:SS.DD,
  * adding hours and minutes only when needed.
  *
- * @param {number} time               - The time in seconds to format.
+ * @param {number} time               - The time in milliseconds to format.
  * @param {FormatTimeOptions} options - The arguments.
  * @returns {string}                    The formatted time string.
  * @example
- * const formattedTime1 = formatTime( 1234567 );                       // Returns "20:34.56"
- * const formattedTime2 = formatTime( 45123 );                         // Returns "45.12"
- * const formattedTime3 = formatTime( 64, { addDecimalPart: false } ); // Returns "01:04"
+ * const formattedTime1 = formatTime( 1234567, { addDecimalPart: true } ); // Returns "20:34.56"
+ * const formattedTime2 = formatTime( 45123 );                             // Returns "00.45"
+ * const formattedTime3 = formatTime( 1200, { showHours: true } );         // Returns "00:00:01"
  */
-export function formatTime(time, { addDecimalPart = true } = {}) {
-    time = time * 1000;
+export function formatTime(time, { addDecimalPart = false, showMinutes = true, showHours = false } = {}) {
     const hours = Math.floor(time / 3600000);
     const minutes = Math.floor(time / 60000) % 60;
     const seconds = Math.floor(time / 1000) % 60;
     const deciseconds = Math.floor(time / 10) % 100;
     const parts = [
-        hours > 0 ? hours.toString().padStart(2, '0') + ':' : '',
-        hours > 0 || minutes > 0 ? minutes.toString().padStart(2, '0') + ':' : '',
+        hours > 0 || showHours ? hours.toString().padStart(2, '0') + ':' : '',
+        hours > 0 || minutes > 0 || showMinutes ? minutes.toString().padStart(2, '0') + ':' : '',
         seconds.toString().padStart(2, '0'),
     ];
     if (addDecimalPart) {

package/build/components/index.d.ts

@@ -1,4 +1,4 @@
-export { default as AIControl } from './ai-control';
-export { default as AiStatusIndicator } from './ai-status-indicator';
-export { default as AudioDurationDisplay } from './audio-duration-display';
-export { GuidelineMessage, default as FooterMessage } from './ai-control/message';
+export { default as AIControl } from './ai-control/index.js';
+export { default as AiStatusIndicator } from './ai-status-indicator/index.js';
+export { default as AudioDurationDisplay } from './audio-duration-display/index.js';
+export { GuidelineMessage, UpgradeMessage, default as FooterMessage, } from './ai-control/message.js';

package/build/components/index.js

@@ -1,4 +1,4 @@
-export { default as AIControl } from './ai-control';
-export { default as AiStatusIndicator } from './ai-status-indicator';
-export { default as AudioDurationDisplay } from './audio-duration-display';
-export { GuidelineMessage, default as FooterMessage } from './ai-control/message';
+export { default as AIControl } from './ai-control/index.js';
+export { default as AiStatusIndicator } from './ai-status-indicator/index.js';
+export { default as AudioDurationDisplay } from './audio-duration-display/index.js';
+export { GuidelineMessage, UpgradeMessage, default as FooterMessage, } from './ai-control/message.js';

package/build/data-flow/context.d.ts

@@ -1,12 +1,15 @@
+/**
+ * External dependencies
+ */
 import React from 'react';
 /**
  * Types & Constants
  */
-import SuggestionsEventSource from '../suggestions-event-source';
-import type { AskQuestionOptionsArgProps } from '../ask-question';
-import type { RequestingErrorProps } from '../hooks/use-ai-suggestions';
-import type { PromptProp } from '../types';
-import type { RequestingStateProp } from '../types';
+import SuggestionsEventSource from '../suggestions-event-source/index.js';
+import type { AskQuestionOptionsArgProps } from '../ask-question/index.js';
+import type { RequestingErrorProps } from '../hooks/use-ai-suggestions/index.js';
+import type { PromptProp } from '../types.js';
+import type { RequestingStateProp } from '../types.js';
 export type AiDataContextProps = {
     suggestion: string;
     requestingError: RequestingErrorProps;
@@ -24,7 +27,7 @@ type AiDataContextProviderProps = {
  *
  * @returns {AiDataContextProps} Context.
  */
-export declare const AiDataContext: React.Context<AiDataContextProps>;
+export declare const AiDataContext: React.Context<object | AiDataContextProps>;
 /**
  * AI Data Context Provider
  *

package/build/data-flow/context.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * External dependencies
  */
-import { createContext } from '@wordpress/element';
+import { createContext } from 'react';
 /**
  * AI Data Context
  *

package/build/data-flow/index.d.ts

@@ -1,3 +1,3 @@
-export { AiDataContext, AiDataContextProvider } from './context';
-export { default as withAiDataProvider } from './with-ai-assistant-data';
-export { default as useAiContext } from './use-ai-context';
+export { AiDataContext, AiDataContextProvider } from './context.js';
+export { default as withAiDataProvider } from './with-ai-assistant-data.js';
+export { default as useAiContext } from './use-ai-context.js';

package/build/data-flow/index.js

@@ -1,3 +1,3 @@
-export { AiDataContext, AiDataContextProvider } from './context';
-export { default as withAiDataProvider } from './with-ai-assistant-data';
-export { default as useAiContext } from './use-ai-context';
+export { AiDataContext, AiDataContextProvider } from './context.js';
+export { default as withAiDataProvider } from './with-ai-assistant-data.js';
+export { default as useAiContext } from './use-ai-context.js';

package/build/data-flow/use-ai-context.d.ts

@@ -1,12 +1,12 @@
 /**
  * Internal dependencies
  */
-import { RequestingErrorProps } from '../types';
+import { RequestingErrorProps } from '../types.js';
 /**
  * Types & constants
  */
-import type { AiDataContextProps } from './context';
-import type { AskQuestionOptionsArgProps } from '../ask-question';
+import type { AiDataContextProps } from './context.js';
+import type { AskQuestionOptionsArgProps } from '../ask-question/index.js';
 export type UseAiContextOptions = {
     askQuestionOptions?: AskQuestionOptionsArgProps;
     onDone?: (content: string) => void;

package/build/data-flow/use-ai-context.js

@@ -1,12 +1,12 @@
 /**
  * External dependencies
  */
-import { useCallback, useContext, useEffect } from '@wordpress/element';
+import { useCallback, useContext, useEffect } from 'react';
 /**
  * Internal dependencies
  */
-import { ERROR_RESPONSE } from '../types';
-import { AiDataContext } from '.';
+import { ERROR_RESPONSE } from '../types.js';
+import { AiDataContext } from './index.js';
 /**
  * useAiContext hook to provide access to
  * the AI Assistant data (from context),

package/build/data-flow/with-ai-assistant-data.js

@@ -7,8 +7,8 @@ import { useMemo } from '@wordpress/element';
 /**
  * Internal Dependencies
  */
-import useAiSuggestions from '../hooks/use-ai-suggestions';
-import { AiDataContextProvider } from '.';
+import useAiSuggestions from '../hooks/use-ai-suggestions/index.js';
+import { AiDataContextProvider } from './index.js';
 /**
  * High Order Component that provides the
  * AI Assistant Data context to the wrapped component.

package/build/hooks/use-ai-suggestions/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Types & constants
  */
-import type { AskQuestionOptionsArgProps } from '../../ask-question';
-import type SuggestionsEventSource from '../../suggestions-event-source';
-import type { PromptProp, SuggestionErrorCode } from '../../types';
-import type { RequestingStateProp } from '../../types';
+import type { AskQuestionOptionsArgProps } from '../../ask-question/index.js';
+import type SuggestionsEventSource from '../../suggestions-event-source/index.js';
+import type { PromptProp, SuggestionErrorCode } from '../../types.js';
+import type { RequestingStateProp } from '../../types.js';
 export type RequestingErrorProps = {
     code: SuggestionErrorCode;
     message: string;

package/build/hooks/use-ai-suggestions/index.js

@@ -7,8 +7,8 @@ import debugFactory from 'debug';
 /**
  * Internal dependencies
  */
-import askQuestion from '../../ask-question';
-import { ERROR_MODERATION, ERROR_NETWORK, ERROR_QUOTA_EXCEEDED, ERROR_SERVICE_UNAVAILABLE, ERROR_UNCLEAR_PROMPT, } from '../../types';
+import askQuestion from '../../ask-question/index.js';
+import { ERROR_MODERATION, ERROR_NETWORK, ERROR_QUOTA_EXCEEDED, ERROR_SERVICE_UNAVAILABLE, ERROR_UNCLEAR_PROMPT, } from '../../types.js';
 const debug = debugFactory('jetpack-ai-client:use-suggestion');
 /**
  * Get the error data for a given error code.

package/build/hooks/use-audio-transcription/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Types
+ */
+import type { CancelablePromise } from '../../types.js';
+/**
+ * The response from the audio transcription hook.
+ */
+export type UseAudioTranscriptionReturn = {
+    transcriptionResult: string;
+    isTranscribingAudio: boolean;
+    transcriptionError: string;
+    transcribeAudio: (audio: Blob) => CancelablePromise;
+};
+/**
+ * The props for the audio transcription hook.
+ */
+export type UseAudioTranscriptionProps = {
+    feature: string;
+    onReady?: (transcription: string) => void;
+    onError?: (error: string) => void;
+};
+/**
+ * A hook to handle audio transcription.
+ *
+ * @param {string} feature - The feature name that is calling the transcription.
+ * @returns {UseAudioTranscriptionReturn} - Object with properties to get the transcription data.
+ */
+export default function useAudioTranscription({ feature, onReady, onError, }: UseAudioTranscriptionProps): UseAudioTranscriptionReturn;