@squidcloud/client 1.0.470 → 1.0.471

package/dist/internal-common/src/metric-name.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Names of the Squid metrics.
+ *
+ * This list and its Kotlin counterpart (MetricName.kt) may diverge:
+ * each side declares only the metrics that its own backend emits.
+ * However, metrics emitted by both backends MUST use identical names on both sides —
+ * otherwise dashboards and metric queries that mix data from both sources will break.
+ *
+ * See MetricName.kt for documentation on each value.
+ */
+export declare const ALL_SQUID_METRIC_NAMES: readonly ["squid_functionExecution_count", "squid_functionExecution_time", "squid_aiChatbotContext_size", "squid_aiChatbotChatInputTokens_count", "squid_aiChatbotChatOutputTokens_count", "squid_aiChatbotChatReasoningTokens_count", "squid_aiChatbotChatCacheReadInputTokens_count", "squid_aiChatbotChatCacheWriteInputTokens_count", "squid_aiChatbotChatOutcome_count", "squid_aiImageGeneration_count", "squid_aiImageGeneration_time", "squid_aiRemoveBackground_count", "squid_aiRemoveBackground_time", "squid_aiAudioTranscribe_count", "squid_aiAudioTranscribe_time", "squid_aiAudioCreateSpeech_count", "squid_aiAudioCreateSpeech_time", "squid_aiIntegrationData_count", "squid_aiIntegrationData_time", "squid_aiIntegrationApi_count", "squid_aiIntegrationApi_time", "squid_apiControllerCall_count", "squid_apiControllerCall_time", "squid_aiContextUpsert_count", "squid_aiContextDelete_count", "squid_codeInitialization_count", "squid_codeInitialization_time", "squid_deleteApiKey_count", "squid_deleteApiKey_time", "squid_deleteSecret_count", "squid_deleteSecret_time", "squid_discoverGraphQLConnectionSchema_count", "squid_discoverGraphQLConnectionSchema_time", "squid_discoverOpenApiSchema_count", "squid_discoverOpenApiSchema_time", "squid_discoverOpenApiSchemaFromFile_count", "squid_discoverOpenApiSchemaFromFile_time", "squid_executeBackendFunction_count", "squid_executeBackendFunction_time", "squid_getAiChatbotProfiles_count", "squid_getAiChatbotProfiles_time", "squid_getAllApiKeys_count", "squid_getAllApiKeys_time", "squid_getAllSecrets_count", "squid_getAllSecrets_time", "squid_getAppApiKey_count", "squid_getAppApiKey_time", "squid_getSecret_count", "squid_getSecret_time", "squid_graphql_count", "squid_graphql_time", "squid_graphqlQuery_count", "squid_graphqlQuery_time", "squid_integrationCount_value", "squid_mutate_count", "squid_mutate_time", "squid_metricQuery_count", "squid_metricQuery_time", "squid_metricReport_count", "squid_metricReport_time", "squid_nativeQuery_count", "squid_nativeQuery_time", "squid_openapi_count", "squid_openapi_time", "squid_produceTopicMessage_count", "squid_produceTopicMessage_time", "squid_query_count", "squid_query_time", "squid_registerQuery_count", "squid_registerQuery_time", "squid_rerankChunks_count", "squid_rerankChunks_time", "squid_schedulerJob_count", "squid_schedulerJob_time", "squid_schema_size", "squid_secrets_entries", "squid_storageDeleteFiles_count", "squid_storageDeleteFiles_time", "squid_storageGetDownloadUrl_count", "squid_storageGetDownloadUrl_time", "squid_storageGetFileMetadata_count", "squid_storageGetFileMetadata_time", "squid_storageListDirectoryContents_count", "squid_storageListDirectoryContents_time", "squid_storageUploadFile_count", "squid_storageUploadFile_time", "squid_subscribeToTopic_count", "squid_subscribeToTopic_time", "squid_testGraphQLConnection_count", "squid_testGraphQLConnection_time", "squid_testAgentProtocolConnection_count", "squid_testAgentProtocolConnection_time", "squid_trigger_count", "squid_trigger_time", "squid_upsertApiKey_count", "squid_upsertApiKey_time", "squid_upsertSecret_count", "squid_upsertSecret_time", "squid_vectorChunks_count", "squid_vectorChunks_time", "squid_webhook_count", "squid_webhook_time", "squid_acquireLock_count", "squid_acquireLock_time", "squid_releaseLock_count", "squid_releaseLock_time"];
+export type MetricName = (typeof ALL_SQUID_METRIC_NAMES)[number];
+/** Common prefix for all Squid metrics. */
+export declare const SQUID_METRIC_NAME_PREFIX = "squid_";

package/dist/internal-common/src/public-types/ai-knowledge-base.public-types.d.ts

@@ -2,6 +2,7 @@ import { AgentContextRequest, AiChatModelSelection, UpsertContextStatusError } f
 import { AiEmbeddingsModelSelection, AiRerankProvider } from './ai-common.public-types';
 import { AiContextId, AiKnowledgeBaseId, AppId } from './communication.public-types';
 import { DocumentExtractionMethod } from './extraction.public-types';
+import { MetadataAndFilter, MetadataFieldFilter, MetadataFilter, MetadataOrFilter, MetadataSimpleFilter, MetadataValue, MetadataValueArray } from './metadata-filter.public-types';
 /**
  * The set of supported vector store backends for a knowledge base. The authoritative backend for a
  * given KB is persisted on its record; reads/writes route through the matching vector provider.
@@ -57,67 +58,37 @@ export interface AiKnowledgeBaseMetadataField {
 export type AiContextMetadata = Record<string, AiContextMetadataValue>;
 /**
  * @category AI
+ * @deprecated Use {@link MetadataValue} from `metadata-filter.public-types` instead.
  */
-export type AiContextMetadataValue = number | string | boolean | undefined;
+export type AiContextMetadataValue = MetadataValue;
 /**
  * @category AI
+ * @deprecated Use {@link MetadataValueArray} from `metadata-filter.public-types` instead.
  */
-export type AiContextMetadataValueArray = AiContextMetadataValue[];
-interface AiContextMetadataEqFilter {
-    $eq: AiContextMetadataValue;
-}
-interface AiContextMetadataNeFilter {
-    $ne: AiContextMetadataValue;
-}
-interface AiContextMetadataGtFilter {
-    $gt: number;
-}
-interface AiContextMetadataGteFilter {
-    $gte: number;
-}
-interface AiContextMetadataLtFilter {
-    $lt: number;
-}
-interface AiContextMetadataLteFilter {
-    $lte: number;
-}
-interface AiContextMetadataInFilter {
-    $in: AiContextMetadataValueArray;
-}
-interface AiContextMetadataNinFilter {
-    $nin: AiContextMetadataValueArray;
-}
-interface AiContextMetadataExistsFilter {
-    $exists: boolean;
-}
+export type AiContextMetadataValueArray = MetadataValueArray;
 /**
  * @category AI
+ * @deprecated Use {@link MetadataSimpleFilter} from `metadata-filter.public-types` instead.
  */
-export type AiContextMetadataSimpleFilter = AiContextMetadataEqFilter | AiContextMetadataNeFilter | AiContextMetadataGtFilter | AiContextMetadataGteFilter | AiContextMetadataLtFilter | AiContextMetadataLteFilter | AiContextMetadataInFilter | AiContextMetadataNinFilter | AiContextMetadataExistsFilter;
+export type AiContextMetadataSimpleFilter = MetadataSimpleFilter;
 /**
  * A filter for AI context metadata based on field-specific conditions or values.
  * @category AI
+ * @deprecated Use {@link MetadataFieldFilter} from `metadata-filter.public-types` instead.
  */
-export interface AiContextMetadataFieldFilter {
-    /** A record where keys are field names and values are either simple filters or direct metadata values. */
-    [field: string]: AiContextMetadataSimpleFilter | AiContextMetadataValue;
-}
+export type AiContextMetadataFieldFilter = MetadataFieldFilter;
 /**
  * A filter combining multiple AI context metadata filters with a logical AND operation.
  * @category AI
+ * @deprecated Use {@link MetadataAndFilter} from `metadata-filter.public-types` instead.
  */
-export interface AiContextMetadataAndFilter {
-    /** An array of filters that must all be true for the condition to pass. */
-    $and: AiContextMetadataFilter[];
-}
+export type AiContextMetadataAndFilter = MetadataAndFilter;
 /**
  * A filter combining multiple AI context metadata filters with a logical OR operation.
  * @category AI
+ * @deprecated Use {@link MetadataOrFilter} from `metadata-filter.public-types` instead.
  */
-export interface AiContextMetadataOrFilter {
-    /** An array of filters where at least one must be true for the condition to pass. */
-    $or: AiContextMetadataFilter[];
-}
+export type AiContextMetadataOrFilter = MetadataOrFilter;
 /**
  * The options for the AI knowledgebase search method.
  * @category AI
@@ -167,8 +138,9 @@ export interface AiHybridSearchWeights {
 }
 /**
  * @category AI
+ * @deprecated Use {@link MetadataFilter} from `metadata-filter.public-types` instead.
  */
-export type AiContextMetadataFilter = AiContextMetadataFieldFilter | AiContextMetadataAndFilter | AiContextMetadataOrFilter;
+export type AiContextMetadataFilter = MetadataFilter;
 /**
  * Represents an AI knowledge base's context entry with metadata and content.
  * @category AI

package/dist/internal-common/src/public-types/extraction.public-types.d.ts

@@ -35,6 +35,15 @@ export interface ExtractDataFromDocumentOptions {
      * the content. Only consulted by extractors that handle text input.
      */
     textFormat?: 'auto' | 'markdown' | 'html' | 'plain';
+    /**
+     * Whether to read document-level properties (title/author/dates) from the source container and
+     * return them as `documentMetadata`. Off by default: container parsing has a real per-file cost
+     * (zip/PDF re-parse), so callers opt in only when the owning knowledge base declares metadata fields.
+     *
+     * Honored only by file-based extraction (which owns the original buffer for every format);
+     * URL-based extraction ignores it and never returns `documentMetadata`.
+     */
+    collectDocumentMetadata?: boolean;
 }
 /**
  * Request payload for extracting data from a document via URL.
@@ -108,6 +117,11 @@ export interface ExtractDataFromDocumentResponse {
      * Path to the original file in cloud storage, if applicable.
      */
     longTermStoragePath?: string;
+    /**
+     * Document-level metadata extracted from the source container (best-effort). Present only when the
+     * extractor was able to read it.
+     */
+    documentMetadata?: DocumentMetadata;
 }
 /**
  * Create PDF request type.
@@ -186,3 +200,22 @@ export interface CreatePdfResponse {
     /** The generated filename. */
     fileName?: string;
 }
+/**
+ * Document-level properties read from the source container during extraction. Every field is optional
+ * and best-effort: when a container does not expose a property (or parsing fails) the field is simply
+ * absent. Consumed by schema-driven metadata extraction as the deterministic source for matching
+ * knowledge-base `metadataFields` before falling back to LLM extraction.
+ * @category AI
+ */
+export interface DocumentMetadata {
+    /** Document title (e.g. OOXML `dc:title`, PDF `/Title`, front-matter `title`, `<title>`). */
+    docTitle?: string;
+    /** Document author (e.g. OOXML `dc:creator`, PDF `/Author`, front-matter / `<meta author>`). */
+    docAuthor?: string;
+    /** Creation timestamp, ISO 8601. */
+    docCreatedAt?: string;
+    /** Last-modified timestamp, ISO 8601. */
+    docModifiedAt?: string;
+    /** Source document type: `pdf` | `docx` | `pptx` | `xlsx` | `md` | `html` | `txt`. */
+    docType?: string;
+}

package/dist/internal-common/src/public-types/metadata-filter.public-types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Generic metadata filter types used across the platform.
+ *
+ * These types define a MongoDB-style filter syntax for filtering records by metadata
+ * fields. They support field-level operators (`$eq`, `$ne`, `$gt`, `$gte`, `$lt`,
+ * `$lte`, `$in`, `$nin`, `$exists`) and boolean combinators (`$and`, `$or`).
+ *
+ * Originally created for AI knowledge base context filtering, these types are now
+ * shared across metrics tag filtering, matchmaking, and other subsystems.
+ */
+/** Primitive metadata value. */
+export type MetadataValue = number | string | boolean | undefined;
+/** Array of metadata values (used by `$in` / `$nin`). */
+export type MetadataValueArray = MetadataValue[];
+interface MetadataEqFilter {
+    $eq: MetadataValue;
+}
+interface MetadataNeFilter {
+    $ne: MetadataValue;
+}
+interface MetadataGtFilter {
+    $gt: number;
+}
+interface MetadataGteFilter {
+    $gte: number;
+}
+interface MetadataLtFilter {
+    $lt: number;
+}
+interface MetadataLteFilter {
+    $lte: number;
+}
+interface MetadataInFilter {
+    $in: MetadataValueArray;
+}
+interface MetadataNinFilter {
+    $nin: MetadataValueArray;
+}
+interface MetadataExistsFilter {
+    $exists: boolean;
+}
+/** A single-field operator: one of `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$exists`. */
+export type MetadataSimpleFilter = MetadataEqFilter | MetadataNeFilter | MetadataGtFilter | MetadataGteFilter | MetadataLtFilter | MetadataLteFilter | MetadataInFilter | MetadataNinFilter | MetadataExistsFilter;
+/**
+ * A filter for metadata based on field-specific conditions or direct values.
+ * @category Metadata
+ */
+export interface MetadataFieldFilter {
+    /** A record where keys are field names and values are either operator objects or direct scalar values. */
+    [field: string]: MetadataSimpleFilter | MetadataValue;
+}
+/**
+ * A filter combining multiple metadata filters with a logical AND operation.
+ * @category Metadata
+ */
+export interface MetadataAndFilter {
+    /** An array of filters that must all be true for the condition to pass. */
+    $and: MetadataFilter[];
+}
+/**
+ * A filter combining multiple metadata filters with a logical OR operation.
+ * @category Metadata
+ */
+export interface MetadataOrFilter {
+    /** An array of filters where at least one must be true for the condition to pass. */
+    $or: MetadataFilter[];
+}
+/**
+ * A composable metadata filter supporting field operators and boolean combinators.
+ *
+ * @example Simple equality
+ * ```ts
+ * { status: 'active' }
+ * ```
+ * @example Operators
+ * ```ts
+ * { age: { $gte: 18 }, role: { $in: ['admin', 'editor'] } }
+ * ```
+ * @example Boolean combinators
+ * ```ts
+ * { $or: [{ status: 'active' }, { role: { $ne: 'guest' } }] }
+ * ```
+ */
+export type MetadataFilter = MetadataFieldFilter | MetadataAndFilter | MetadataOrFilter;
+export {};

package/dist/internal-common/src/public-types/metric.public-types.d.ts

@@ -1,3 +1,11 @@
+import { MetadataFilter } from './metadata-filter.public-types';
+/**
+ * Tag filter for metric queries. Accepts either a simple key-value record (backward compatible)
+ * or the full {@link MetadataFilter} tree with `$eq`, `$ne`, `$in`, `$nin`, `$exists`,
+ * `$gt`, `$gte`, `$lt`, `$lte`, `$and`, `$or`.
+ * @category Metrics
+ */
+export type MetricTagFilter = Record<string, string> | MetadataFilter;
 /**
  * Name of metrics publicly provided by the system.
  * - Metrics suffixed by '_time' are 'gauge' metrics.
@@ -49,10 +57,22 @@ export interface QueryMetricsRequestCommon {
      */
     fillValue?: number | null;
     /**
-     * Tag filters.
-     * TODO: add operations to exclude tags: !=, !contains...
+     * Tag filters. Supports two formats:
+     * - Simple: `Record<string, string>` — each key-value pair is an exact equality match.
+     * - Advanced: `AiContextMetadataFilter` — the same filter syntax used by AI knowledge base
+     *   metadata, supporting `$eq`, `$ne`, `$in`, `$nin`, `$exists`, `$and`, `$or`, and
+     *   comparison operators (`$gt`, `$gte`, `$lt`, `$lte` — numeric comparisons on string tags).
+     *
+     * @example Simple format
+     * ```ts
+     * tagFilter: { aiModel: 'claude-sonnet-4-5-20250514', isError: '0' }
+     * ```
+     * @example Advanced format
+     * ```ts
+     * tagFilter: { $or: [{ aiModel: { $in: ['claude-sonnet-4-5-20250514', 'gpt-4o'] } }, { isError: { $ne: '0' } }] }
+     * ```
      */
-    tagFilter?: Record<string, string>;
+    tagFilter?: MetricTagFilter;
     /**
      * A mapping of known tag values that must be present in the response groups.
      *

package/dist/internal-common/src/public-types-backend/api-call.public-context.d.ts

@@ -0,0 +1,30 @@
+import { ApiOptions } from '../public-types/api-client.public-types';
+import { ApiEndpointId, HttpMethod } from '../public-types/api.public-types';
+import { IntegrationId } from '../public-types/communication.public-types';
+/** The headers of an API call. */
+export type ApiHeaders = Record<string, string | number | boolean>;
+/** The context of an API call. */
+export declare class ApiCallContext {
+    readonly integrationId: IntegrationId;
+    readonly endpointId: ApiEndpointId;
+    readonly url: string;
+    readonly method: HttpMethod;
+    readonly body: unknown;
+    readonly options: ApiOptions;
+}
+/**
+ * Represents a request to call an API through a specified integration and endpoint.
+ * Includes optional method override and additional request options.
+ */
+export interface CallApiRequest<BodyType = any> {
+    /** The identifier of the integration through which the API is called. */
+    integrationId: IntegrationId;
+    /** Target API endpoint to invoke. */
+    endpointId: ApiEndpointId;
+    /** Optional request payload. */
+    body?: BodyType;
+    /** Optional HTTP method override. Default is POST. */
+    overrideMethod?: HttpMethod;
+    /** Additional request options. */
+    options: ApiOptions;
+}

package/dist/internal-common/src/public-types-backend/mutation.public-context.d.ts

@@ -0,0 +1,148 @@
+import { SquidDocIdObj, SquidDocument } from '../public-types/document.public-types';
+import { Paths } from '../public-types/typescript.public-types';
+/**
+ * The mutation type.
+ * @category Database
+ */
+export declare const MUTATION_TYPES: readonly ["insert", "update", "delete"];
+/**
+ * @category Database
+ */
+export type MutationType = (typeof MUTATION_TYPES)[number];
+interface BaseMutation {
+    type: MutationType;
+    squidDocIdObj: SquidDocIdObj;
+}
+/**
+ * A mutation on a document.
+ * @category Database
+ */
+export type Mutation<T = any> = UpdateMutation<T> | InsertMutation<T> | DeleteMutation;
+/**
+ * Represents a delete mutation on a document.
+ * @category Database
+ */
+export interface DeleteMutation extends BaseMutation {
+    /** Specifies that the mutation is a deletion. */
+    type: 'delete';
+}
+/**
+ * Represents an update mutation on a document.
+ * @category Database
+ */
+export interface UpdateMutation<T = any> extends BaseMutation {
+    /** Specifies that the mutation is an update. */
+    type: 'update';
+    /** The updated properties */
+    properties: {
+        [key in keyof T & string]?: Array<PropertyMutation<T[key]>>;
+    };
+}
+/**
+ * Represents an insert mutation on a document.
+ * @category Database
+ */
+export interface InsertMutation<T = any> extends BaseMutation {
+    /** Specifies that the mutation is an insertion. */
+    type: 'insert';
+    /** The inserted document */
+    properties: T;
+}
+/**
+ * A representation of a single property update.
+ * @category Database
+ */
+export type PropertyMutation<Value = any> = ApplyNumericFnPropertyMutation | ApplyStringFnPropertyMutation | ValueUpdatePropertyMutation<Value> | RemovePropertyMutation;
+/**
+ * A value update property mutation.
+ * @category Database
+ */
+export interface ValueUpdatePropertyMutation<Value = any> {
+    /** Specifies that the mutation updates a value. */
+    type: 'update';
+    /** New value to be set. */
+    value: Value;
+}
+/**
+ * Applying a numeric function to a property.
+ * @category Database
+ */
+export interface ApplyNumericFnPropertyMutation {
+    /** Specifies that the mutation applies a numeric function. */
+    type: 'applyNumericFn';
+    /** Numeric function to apply. */
+    fn: 'increment';
+    /** Value to use in the numeric function. */
+    value: number;
+}
+/**
+ * A property update that removes a property from a document.
+ * @category Database
+ */
+export interface RemovePropertyMutation {
+    /** Specifies that the mutation removes a property. */
+    type: 'removeProperty';
+}
+interface ApplyExtendString {
+    /** Specifies that the mutation applies a string function. */
+    type: 'applyStringFn';
+    /** String function to extend the existing string. */
+    fn: 'extendString';
+    /** String value to append. */
+    value: string;
+}
+interface ApplyTrimString {
+    /** Specifies that the mutation applies a string function. */
+    type: 'applyStringFn';
+    /** String function to trim the existing string. */
+    fn: 'trim';
+}
+/**
+ * A property mutation that modifies a string.
+ * @category Database
+ */
+export type ApplyStringFnPropertyMutation = ApplyExtendString | ApplyTrimString;
+/**
+ * The before and after documents of a document change.
+ * @category Database
+ */
+export interface BeforeAndAfterDocs<T = SquidDocument> {
+    /** Document state before the mutation. */
+    before: T | undefined;
+    /** Document state after the mutation. */
+    after: T | undefined;
+}
+/**
+ * The mutation context that will be provided to the security function.
+ * @category Database
+ */
+export declare class MutationContext<T = any> {
+    readonly mutation: Mutation<T>;
+    readonly beforeAndAfterDocs: BeforeAndAfterDocs<T>;
+    readonly serverTimeStamp: Date;
+    /**
+     * Returns the state of the document before the mutation was applied.
+     */
+    get before(): T | undefined;
+    /**
+     * Returns the state of the document after the mutation was applied.
+     */
+    get after(): T | undefined;
+    /**
+     * Returns the type of the mutation (insert, update, or delete).
+     */
+    getMutationType(): MutationType;
+    /** Returns true if the mutation affects the provided path. */
+    affectsPath(path: Paths<T>): boolean;
+    /**
+     * Find all affected paths starting from a root path.
+     *
+     * @example
+     * doc before - { a: { b: 1, c: 2 }, d: 3 }
+     * doc after - { a: { b: 1, c: 3 }, d: 4 }
+     * doc.affectedPaths('a') // ['a.c']
+     */
+    affectedPaths(startingRoot?: Paths<T> | string): Array<Paths<T>>;
+    private checkPath;
+}
+export {};

package/dist/internal-common/src/public-types-backend/native-query.public-context.d.ts

@@ -0,0 +1,72 @@
+import { IntegrationId } from '../public-types/communication.public-types';
+/**
+ * Represents the type of native query request, either relational, elastic or MongoDB.
+ * @category Database
+ */
+export type NativeQueryRequestType = 'relational' | 'mongo' | 'elasticsearch' | 'pure';
+interface BaseNativeQueryContext {
+    /** Type of the native query request. */
+    type: NativeQueryRequestType;
+    /** Identifier for the integration. */
+    integrationId: IntegrationId;
+}
+/**
+ * Context for executing a relational database query.
+ * @category Database
+ */
+export interface RelationalNativeQueryContext extends BaseNativeQueryContext {
+    /** Specifies that the query is for a relational database. */
+    type: 'relational';
+    /** SQL query string to be executed. */
+    query: string;
+    /** Parameters to be used in the query. */
+    params: Record<string, any>;
+}
+/**
+ * Context for executing a MongoDB query.
+ * @category Database
+ */
+export interface MongoNativeQueryContext extends BaseNativeQueryContext {
+    /** Specifies that the query is for a Mongo database. */
+    type: 'mongo';
+    /** Name of the MongoDB collection to query. */
+    collectionName: string;
+    /** Array of aggregation pipeline stages. */
+    aggregationPipeline: Array<any | undefined>;
+}
+/**
+ * Context for executing an Elasticsearch query.
+ * @category Database
+ */
+export interface ElasticsearchNativeQueryContext {
+    /** Specifies that the query is for an Elasticsearch database. */
+    type: 'elasticsearch';
+    /** Elasticsearch index to query. */
+    index: string;
+    /** Elasticsearch query string. */
+    endpoint?: string;
+    /** HTTP method to use for the request. */
+    method?: 'GET' | 'POST';
+    /** Body of the request. */
+    body: Record<string, any>;
+    /** Headers to include in the request. */
+    integrationId: IntegrationId;
+}
+/**
+ * Context for executing a pure database query.
+ * @category Database
+ */
+export interface PureNativeQueryContext extends BaseNativeQueryContext {
+    /** Specifies that the query is for a relational database. */
+    type: 'pure';
+    /** SQL query string to be executed. */
+    query: string;
+    /** Parameters to be used in the query. */
+    params: Record<string, any>;
+}
+/**
+ * Union type representing either a relational or MongoDB native query context.
+ * @category Database
+ */
+export type NativeQueryContext = RelationalNativeQueryContext | MongoNativeQueryContext | ElasticsearchNativeQueryContext | PureNativeQueryContext;
+export {};