@jerome-benoit/sap-ai-provider 4.6.9 → 4.7.0

package/dist/chunk-GMMX46AH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/base-embedding-model-strategy.ts"],"sourcesContent":["/** Base class for embedding model strategies using the Template Method pattern. */\nimport type {\n  EmbeddingModelV3CallOptions,\n  EmbeddingModelV3Embedding,\n  EmbeddingModelV3Result,\n  SharedV3Warning,\n} from \"@ai-sdk/provider\";\n\nimport { TooManyEmbeddingValuesForCallError } from \"@ai-sdk/provider\";\n\nimport type { SAPAIEmbeddingSettings } from \"./sap-ai-settings.js\";\nimport type { EmbeddingModelAPIStrategy, EmbeddingModelStrategyConfig } from \"./sap-ai-strategy.js\";\n\nimport { deepMerge } from \"./deep-merge.js\";\nimport { convertToAISDKError } from \"./sap-ai-error.js\";\nimport {\n  buildEmbeddingResult,\n  type EmbeddingProviderOptions,\n  type EmbeddingType,\n  prepareEmbeddingCall,\n  type ResponseMetadata,\n} from \"./strategy-utils.js\";\nimport { VERSION } from \"./version.js\";\n\n/**\n * Abstract base class for embedding model strategies using the Template Method pattern.\n * @template TClient - The SDK client type (e.g., AzureOpenAiEmbeddingClient, OrchestrationEmbeddingClient).\n * @template TResponse - The API response type from the SDK client.\n * @internal\n */\nexport abstract class BaseEmbeddingModelStrategy<\n  TClient,\n  TResponse,\n> implements EmbeddingModelAPIStrategy {\n  /**\n   * Template method implementing the shared embedding algorithm.\n   * @param config - Strategy configuration.\n   * @param settings - Embedding model settings.\n   * @param options - AI SDK call options.\n   * @param maxEmbeddingsPerCall - Maximum embeddings per call.\n   * @returns Complete embedding result for AI SDK.\n   * @internal\n   */\n  async doEmbed(\n    config: EmbeddingModelStrategyConfig,\n    settings: SAPAIEmbeddingSettings,\n    options: EmbeddingModelV3CallOptions,\n    maxEmbeddingsPerCall: number,\n  ): Promise<EmbeddingModelV3Result> {\n    const { abortSignal, values } = options;\n\n    try {\n      const { embeddingOptions, providerName } = await prepareEmbeddingCall(\n        { maxEmbeddingsPerCall, modelId: config.modelId, provider: config.provider },\n        options,\n      );\n\n      const embeddingType = embeddingOptions?.type ?? settings.type ?? \"text\";\n\n      const warnings: SharedV3Warning[] = [];\n      this.resolveWarnings(settings, warnings);\n\n      const client = this.createClient(config, settings, embeddingOptions);\n\n      const response = await this.executeCall(client, values, embeddingType, abortSignal);\n\n      const embeddings = this.extractEmbeddings(response);\n      const totalTokens = this.extractTokenCount(response);\n      const { headers: responseHeaders, requestId } = this.extractResponseMetadata(response);\n\n      return buildEmbeddingResult({\n        embeddings,\n        modelId: config.modelId,\n        providerName,\n        requestId,\n        responseHeaders,\n        totalTokens,\n        version: VERSION,\n        warnings,\n      });\n    } catch (error) {\n      if (error instanceof TooManyEmbeddingValuesForCallError) {\n        throw error;\n      }\n      throw convertToAISDKError(error, {\n        operation: \"doEmbed\",\n        requestBody: { values: values.length },\n        url: this.getUrl(),\n      });\n    }\n  }\n\n  /**\n   * Creates the appropriate SDK client for this API.\n   * @param config - Strategy configuration.\n   * @param settings - Embedding model settings.\n   * @param embeddingOptions - Parsed provider options from the call.\n   * @returns SDK client instance.\n   * @internal\n   */\n  protected abstract createClient(\n    config: EmbeddingModelStrategyConfig,\n    settings: SAPAIEmbeddingSettings,\n    embeddingOptions: EmbeddingProviderOptions | undefined,\n  ): TClient;\n\n  /**\n   * Executes the embedding API call.\n   * @param client - SDK client instance.\n   * @param values - Input strings to embed.\n   * @param embeddingType - Type of embedding (text, query, document).\n   * @param abortSignal - Optional abort signal.\n   * @returns SDK response containing embeddings.\n   * @internal\n   */\n  protected abstract executeCall(\n    client: TClient,\n    values: string[],\n    embeddingType: EmbeddingType,\n    abortSignal: AbortSignal | undefined,\n  ): Promise<TResponse>;\n\n  /**\n   * Extracts embeddings from the SDK response.\n   * @param response - SDK response containing embedding data.\n   * @returns Array of normalized embedding vectors.\n   * @internal\n   */\n  protected abstract extractEmbeddings(response: TResponse): EmbeddingModelV3Embedding[];\n\n  /**\n   * Extracts response metadata (request id and HTTP headers) from the SDK response.\n   *\n   * Default returns both fields as `undefined`; subclasses override to extract from the SDK response.\n   * @param _response - SDK response.\n   * @returns Combined `{ headers, requestId }` metadata.\n   * @internal\n   */\n  protected extractResponseMetadata(_response: TResponse): ResponseMetadata {\n    return { headers: undefined, requestId: undefined };\n  }\n\n  /**\n   * Extracts total token count from the SDK response.\n   * @param response - SDK response containing usage data.\n   * @returns Total token count used for the embedding request.\n   * @internal\n   */\n  protected abstract extractTokenCount(response: TResponse): number;\n\n  /**\n   * Returns the URL identifier for this API (used in error messages).\n   * @returns URL string identifier.\n   * @internal\n   */\n  protected abstract getUrl(): string;\n\n  protected mergeModelParams(\n    settings: SAPAIEmbeddingSettings,\n    embeddingOptions: EmbeddingProviderOptions | undefined,\n  ): Record<string, unknown> {\n    return deepMerge(\n      (settings.modelParams as Record<string, unknown> | undefined) ?? {},\n      embeddingOptions?.modelParams ?? {},\n    );\n  }\n\n  /**\n   * Pushes API-specific deprecation or migration warnings into the shared\n   * sink. Default no-op; subclasses override to surface settings-level\n   * warnings (e.g. orchestration's masking_providers deprecation).\n   * @param _settings - Embedding model settings.\n   * @param _warnings - Shared warnings sink for the current call.\n   * @internal\n   */\n  protected resolveWarnings(_settings: SAPAIEmbeddingSettings, _warnings: SharedV3Warning[]): void {\n    return;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAQA,SAAS,0CAA0C;AAsB5C,IAAe,6BAAf,MAGgC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUrC,MAAM,QACJ,QACA,UACA,SACA,sBACiC;AACjC,UAAM,EAAE,aAAa,OAAO,IAAI;AAEhC,QAAI;AACF,YAAM,EAAE,kBAAkB,aAAa,IAAI,MAAM;AAAA,QAC/C,EAAE,sBAAsB,SAAS,OAAO,SAAS,UAAU,OAAO,SAAS;AAAA,QAC3E;AAAA,MACF;AAEA,YAAM,gBAAgB,kBAAkB,QAAQ,SAAS,QAAQ;AAEjE,YAAM,WAA8B,CAAC;AACrC,WAAK,gBAAgB,UAAU,QAAQ;AAEvC,YAAM,SAAS,KAAK,aAAa,QAAQ,UAAU,gBAAgB;AAEnE,YAAM,WAAW,MAAM,KAAK,YAAY,QAAQ,QAAQ,eAAe,WAAW;AAElF,YAAM,aAAa,KAAK,kBAAkB,QAAQ;AAClD,YAAM,cAAc,KAAK,kBAAkB,QAAQ;AACnD,YAAM,EAAE,SAAS,iBAAiB,UAAU,IAAI,KAAK,wBAAwB,QAAQ;AAErF,aAAO,qBAAqB;AAAA,QAC1B;AAAA,QACA,SAAS,OAAO;AAAA,QAChB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,SAAS;AAAA,QACT;AAAA,MACF,CAAC;AAAA,IACH,SAAS,OAAO;AACd,UAAI,iBAAiB,oCAAoC;AACvD,cAAM;AAAA,MACR;AACA,YAAM,oBAAoB,OAAO;AAAA,QAC/B,WAAW;AAAA,QACX,aAAa,EAAE,QAAQ,OAAO,OAAO;AAAA,QACrC,KAAK,KAAK,OAAO;AAAA,MACnB,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgDU,wBAAwB,WAAwC;AACxE,WAAO,EAAE,SAAS,QAAW,WAAW,OAAU;AAAA,EACpD;AAAA,EAiBU,iBACR,UACA,kBACyB;AACzB,WAAO;AAAA,MACJ,SAAS,eAAuD,CAAC;AAAA,MAClE,kBAAkB,eAAe,CAAC;AAAA,IACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUU,gBAAgB,WAAmC,WAAoC;AAC/F;AAAA,EACF;AACF;","names":[]}