@squidcloud/client 1.0.483 → 1.0.485

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

@@ -0,0 +1,196 @@
+import type { CanonicalReasoningEffort } from './ai-agent.public-types';
+import type { IntegrationInfo } from './integration.public-types';
+/** Identifies the source-code analysis AI function. */
+export declare const SOURCE_CODE_ANALYZE_FUNCTION_ID = "analyzeCode";
+/** Limits the number of repositories selected for analysis. */
+export declare const SOURCE_CODE_MAX_REPOSITORIES = 20;
+/** Limits each supplemental instruction field supplied to source-code analysis. */
+export declare const SOURCE_CODE_MAX_SUPPLEMENTAL_INSTRUCTIONS_LENGTH = 20000;
+/** Lists CLI providers available for source-code analysis. */
+export declare const SOURCE_CODE_ANALYZER_MODELS: readonly ["claude-code", "codex"];
+/** Identifies a CLI provider available for source-code analysis. */
+export type SourceCodeAnalyzerModel = (typeof SOURCE_CODE_ANALYZER_MODELS)[number];
+/** Lists supported source-control providers. */
+export declare const SOURCE_CONTROL_PROVIDERS: readonly ["github", "bitbucket"];
+/** Identifies a supported source-control provider. */
+export type SourceControlProvider = (typeof SOURCE_CONTROL_PROVIDERS)[number];
+/** Lists integration types that provide source repositories. */
+export declare const SOURCE_CODE_INTEGRATION_TYPES: readonly ["github", "bitbucket"];
+/** Identifies an integration type that provides source repositories. */
+export type SourceCodeIntegrationType = (typeof SOURCE_CODE_INTEGRATION_TYPES)[number];
+/** Configures source-code analysis for an AI agent integration. */
+export interface AiAgentSourceCodeIntegrationOptions {
+    /** Enables repository-backed code analysis. */
+    codeAnalysisEnabled: boolean;
+    /** Selects the CLI provider used for code analysis. */
+    analyzerModel?: SourceCodeAnalyzerModel;
+    /** Selects a concrete model from the analyzer provider's CLI registry. */
+    analyzerModelId?: string;
+    /** Selects the reasoning effort used by the analyzer CLI. */
+    analyzerReasoningEffort?: CanonicalReasoningEffort;
+    /** Provides supplemental code-analysis instructions. */
+    analyzerInstructions?: string;
+}
+/** Stores the immutable GitHub identity and access metadata for a selected repository. */
+export interface GitHubRepositoryConfiguration {
+    /** Stores GitHub's numeric repository identifier. */
+    id: number;
+    /** Stores the owner/repository name. */
+    fullName: string;
+    /** Stores the credential-free HTTPS clone URL. */
+    cloneUrl: string;
+    /** Stores the credential-free HTTPS web URL. */
+    htmlUrl: string;
+    /** Stores the default branch name. */
+    defaultBranch: string;
+}
+/** Stores the immutable Bitbucket identity and access metadata for a selected repository. */
+export interface BitbucketRepositoryConfiguration {
+    /** Stores Bitbucket's immutable repository UUID. */
+    uuid: string;
+    /** Stores the workspace/repository name. */
+    fullName: string;
+    /** Stores the credential-free HTTPS clone URL. */
+    cloneUrl: string;
+    /** Stores the credential-free HTTPS web URL. */
+    webUrl: string;
+    /** Stores the default branch name. */
+    defaultBranch: string;
+}
+/** Represents the repository-selection portion of a GitHub integration configuration. */
+interface GitHubRepositorySelectionConfiguration {
+    /** Stores the legacy owner/repository selection. */
+    repository?: string;
+    /** Stores canonical selected repository metadata. */
+    repositories?: GitHubRepositoryConfiguration[];
+    /** Stores the selected default owner/repository name. */
+    defaultRepository?: string;
+}
+/** Represents the repository-selection portion of a Bitbucket integration configuration. */
+interface BitbucketRepositorySelectionConfiguration {
+    /** Stores the configured Bitbucket workspace slug. */
+    workspace: string;
+    /** Stores canonical selected repository metadata. */
+    repositories: BitbucketRepositoryConfiguration[];
+    /** Stores the selected default workspace/repository name. */
+    defaultRepository: string;
+}
+/** Describes a source repository that can be prepared for analysis. */
+export interface SourceRepository {
+    /** Identifies the source-control provider. */
+    provider: SourceControlProvider;
+    /** Stores the provider's immutable repository identifier. */
+    providerRepositoryId: string;
+    /** Stores the owner/repository name. */
+    fullName: string;
+    /** Stores the credential-free clone URL. */
+    cloneUrl: string;
+    /** Stores the repository web URL. */
+    webUrl: string;
+    /** Stores the repository's default branch. */
+    defaultBranch: string;
+}
+/** Requests analysis of selected source-code repositories. */
+export interface AnalyzeCodeRequest {
+    /** Contains the question to answer. */
+    question: string;
+    /** Narrows repository selection. */
+    repositoryHints?: string;
+    /** Narrows analysis to a captured reference. */
+    refHint?: string;
+    /** Supplies customer context for the answer. */
+    customerContext?: string;
+}
+/** Marks an inclusive range of lines in a repository path. */
+export interface SourceCodeLineRange {
+    /** Stores the first included line number. */
+    start: number;
+    /** Stores the last included line number. */
+    end: number;
+}
+/** Identifies a path supporting a source-code finding. */
+export interface SourceCodePathEvidence {
+    /** Stores the path relative to the repository root. */
+    path: string;
+    /** Marks the supporting line range when available. */
+    lines?: SourceCodeLineRange;
+}
+/** Identifies the captured repository reference behind a finding. */
+export interface SourceCodeRef {
+    /** Identifies the reference kind. */
+    type: 'branch' | 'tag' | 'commit';
+    /** Stores the captured reference name. */
+    name: string;
+}
+/** Records repository evidence supporting a source-code answer. */
+export interface SourceCodeRepositoryEvidence {
+    /** Stores the owner/repository name. */
+    repository: string;
+    /** Identifies the inspected captured reference. */
+    ref: SourceCodeRef;
+    /** Stores the immutable commit SHA. */
+    commitSha: string;
+    /** Lists paths supporting the finding. */
+    paths: SourceCodePathEvidence[];
+    /** Stores the snapshot fetch time. */
+    fetchedAt: string;
+    /** Marks evidence from a stale snapshot. */
+    stale: boolean;
+}
+/** Returns a source-code analysis answer and its evidence. */
+export interface AnalyzeCodeResult {
+    /** Contains the concise answer. */
+    answer: string;
+    /** Lists repository evidence supporting the answer. */
+    repositories: SourceCodeRepositoryEvidence[];
+    /** Stores the latest snapshot fetch time. */
+    fetchTimestamp: string;
+    /** Marks whether any source snapshot is stale. */
+    stale: boolean;
+    /** Lists warnings encountered during analysis. */
+    warnings: string[];
+    /** Warns when a prepared workspace cannot persist. */
+    workspacePersistenceWarning?: string;
+}
+/** Requests discovery from an existing or draft source-code integration. */
+export type DiscoverSourceRepositoriesRequest = {
+    /** Identifies the source-code integration type. */
+    integrationType: SourceCodeIntegrationType;
+    /** Identifies the persisted integration. */
+    integrationId: string;
+    /** Prevents draft and persisted integration inputs from mixing. */
+    draftIntegration?: never;
+} | {
+    /** Identifies the source-code integration type. */
+    integrationType: SourceCodeIntegrationType;
+    /** Prevents draft and persisted integration inputs from mixing. */
+    integrationId?: never;
+    /** Supplies an integration that has not been persisted. */
+    draftIntegration: IntegrationInfo;
+};
+/** Returns repositories discovered from a source-code integration. */
+export interface DiscoverSourceRepositoriesResponse {
+    /** Lists repositories available for selection. */
+    repositories: SourceRepository[];
+}
+/** Represents a normalized GitHub repository selection. */
+export interface NormalizedGitHubRepositorySelection {
+    /** Stores the accepted legacy selection when canonical metadata is absent. */
+    legacyRepository?: string;
+    /** Lists validated canonical repository metadata. */
+    repositories: GitHubRepositoryConfiguration[];
+    /** Stores the validated default owner/repository name. */
+    defaultRepository: string;
+}
+/** Represents a normalized Bitbucket repository selection. */
+export interface NormalizedBitbucketRepositorySelection {
+    /** Lists validated canonical repository metadata. */
+    repositories: BitbucketRepositoryConfiguration[];
+    /** Stores the validated default workspace/repository name. */
+    defaultRepository: string;
+}
+/** Normalizes selected GitHub repositories for persistence and connector use. */
+export declare function normalizeGitHubRepositorySelection(configuration: GitHubRepositorySelectionConfiguration): NormalizedGitHubRepositorySelection;
+/** Normalizes selected Bitbucket repositories for persistence and connector use. */
+export declare function normalizeBitbucketRepositorySelection(configuration: BitbucketRepositorySelectionConfiguration): NormalizedBitbucketRepositorySelection;
+export {};

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,161 @@
+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];
+/**
+ * Base fields shared by all document mutations.
+ * @category Database
+ */
+export interface BaseMutation {
+    /** The type of the mutation. */
+    type: MutationType;
+    /** The identity of the mutated document. */
+    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';
+}
+/**
+ * A property mutation that appends a value to the existing string.
+ * @category Database
+ */
+export 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;
+}
+/**
+ * A property mutation that trims the existing string.
+ * @category Database
+ */
+export 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;
+}

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

@@ -0,0 +1,75 @@
+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';
+/**
+ * Base fields shared by all native query contexts.
+ * @category Database
+ */
+export 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;

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

@@ -0,0 +1,193 @@
+import { AiQueryOptions } from '../public-types/ai-query.public-types';
+import { IntegrationId } from '../public-types/communication.public-types';
+import { CollectionName, DocumentData, FieldName } from '../public-types/document.public-types';
+import { FieldSort, Operator, Query, SimpleCondition } from '../public-types/query.public-types';
+import { DeepRecord, FieldOf, PartialBy, Paths } from '../public-types/typescript.public-types';
+/**
+ * The information provided to the secureAiQuery function about the AI query being executed.
+ * @category AI
+ */
+export interface AiQueryContext {
+    /** The prompt provided for the AI query. */
+    prompt: string;
+    /** The options used for executing the AI query. */
+    options: AiQueryOptions;
+}
+/**
+ * Represents the Squid query context.
+ * Passed to methods that require query details, such as those annotated with the `@secureCollection` annotation.
+ * @category Database
+ */
+export declare class QueryContext<T extends DocumentData = any> {
+    readonly query: Query<T>;
+    /**
+     * The ID of the integration being queried.
+     */
+    get integrationId(): IntegrationId;
+    /**
+     * The name of the collection being queried.
+     */
+    get collectionName(): CollectionName;
+    /**
+     * The query limit if one exists, -1 otherwise.
+     */
+    get limit(): number;
+    /**
+     * The fields to project (include) in query results, or undefined if all fields should be returned.
+     */
+    get projectFields(): Array<FieldName> | undefined;
+    /**
+     * Verifies that the query's sort order aligns with the provided field sorts. The fields specified in the `sorts`
+     * parameter must appear in the exact order at the beginning of the query's sort sequence. The query can include
+     * additional fields in its sort order, but only after the specified sorts.
+     *
+     * @param sorts An array of field sorts.
+     * @returns Whether the query's sorts matches the provided field sorts.
+     */
+    sortedBy(sorts: Array<PartialBy<FieldSort<T>, 'asc'>>): boolean;
+    /**
+     * Verifies that the query's sort order exactly matches the provided field sorts. The fields specified in the
+     * `sorts` parameter must appear in the exact order in the query's sort sequence. No additional sorts may be present
+     * in the query.
+     *
+     * @param sorts An array of field sorts.
+     * @returns Whether the query's sorts exactly match the provided field sorts.
+     */
+    sortedByExact(sorts: Array<PartialBy<FieldSort<T>, 'asc'>>): boolean;
+    /**
+     * Verifies that the query is a subquery of the specified condition. A subquery is defined as a query that evaluates
+     * to a subset of the results that would be obtained by applying the parent condition. The subquery may also include
+     * additional conditions, as these only narrow the result set.
+     *
+     * @param fieldName The name of the field for the condition.
+     * @param operator The operator of the condition.
+     * @param value The value of the condition.
+     * @returns Whether the query is a subquery of the parent condition.
+     */
+    isSubqueryOf<F extends Paths<T>, O extends AllOperators>(fieldName: F, operator: O, value: GenericValue<T, F, O> | null): boolean;
+    /**
+     * Verifies that the query is a subquery of the specified condition. A subquery is defined as a query that evaluates
+     * to a subset of the results that would be obtained by applying the parent condition. The subquery may also include
+     * additional conditions, as these only narrow the result set.
+     *
+     * @param condition The condition to validate.
+     * @returns Whether the query is a subquery of the parent condition.
+     */
+    isSubqueryOfCondition(condition: GeneralCondition<T>): boolean;
+    /**
+     * Verifies that the query is a subquery of the specified conditions. A subquery is defined as a query that evaluates
+     * to a subset of the results that would be obtained by applying the parent conditions. The subquery may also include
+     * additional conditions, as these only narrow the result set.
+     *
+     * @param conditions The conditions to validate.
+     * @returns Whether the query includes subquery of the parent conditions.
+     */
+    isSubqueryOfConditions(conditions: GeneralConditions<T>): boolean;
+    /**
+     * Verifies that the query is a subquery of the specified query. A subquery is defined as a query that evaluates
+     * to a subset of the results that obtained for the parent query, including sorts and limits.
+     *
+     * @param query The query to validate.
+     * @returns Whether the query is a subquery of the parent query.
+     */
+    isSubqueryOfQuery(query: Query<T>): boolean;
+    /**
+     * Checks if this query's projectFields are a subset of the parent query's projectFields.
+     * A query can only be a child of another if the parent provides all fields the child needs.
+     *
+     * @param childFields - The projectFields of this query (the potential child)
+     * @param parentFields - The projectFields of the candidate parent query
+     * @returns Whether the child's fields are available from the parent
+     */
+    private isProjectFieldsSubset;
+    /**
+     * Returns all conditions that apply to any of the specified field names. This method
+     * provides a convenient way to retrieve all conditions that involve a specific set of fields.
+     *
+     * @param fieldNames The field names for which to retrieve conditions.
+     * @returns An array of conditions that involve any of the specified field names.
+     */
+    getConditionsFor<K extends Paths<T>>(...fieldNames: Array<K>): ContextConditions<T, K>;
+    /**
+     * Returns all conditions that apply to the specified field name. This method provides
+     * a convenient way to retrieve all conditions that involve a specific field.
+     *
+     * @param fieldName The field name for which to retrieve conditions.
+     * @returns An array of conditions that involve the specified field name.
+     */
+    getConditionsForField<K extends Paths<T>>(fieldName: K): ContextConditions<T>;
+    /**
+     * Returns true if the given document can be a result of the query.
+     * The method does not account for limit and sort order.
+     */
+    documentMatchesQuery(doc: DocumentData): boolean;
+}
+/**
+ * A list of context conditions.
+ * @category Database
+ */
+export type ContextConditions<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> = Array<ContextCondition<Doc, F>>;
+/**
+ * A Context condition - a condition that replaces multiple '==' or '!=' conditions with 'in' and 'not in'.
+ * @category Database
+ */
+export type ContextCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> = InContextCondition<Doc, F> | NotInContextCondition<Doc, F> | OtherContextCondition<Doc, F>;
+/**
+ * A condition using the 'in' operator to match values within a set.
+ * @category Database
+ */
+export interface InContextCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> extends SimpleCondition<Doc, F, 'in'> {
+    /** Specifies the 'in' operator to check if a value exists within an array. */
+    operator: 'in';
+    /** An array of values to match against the field. */
+    value: Array<FieldOf<DeepRecord<Doc>, Paths<Doc>> | any>;
+}
+/**
+ * A condition using the 'not in' operator to exclude values within a set.
+ * @category Database
+ */
+export interface NotInContextCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> extends SimpleCondition<Doc, F, 'not in'> {
+    /** Specifies the 'not in' operator to check if a value does not exist within an array. */
+    operator: 'not in';
+    /** An array of values to exclude from the field. */
+    value: Array<FieldOf<DeepRecord<Doc>, Paths<Doc>> | any>;
+}
+/**
+ * A condition using operators other than 'in' or 'not in' for field comparisons.
+ * @category Database
+ */
+export interface OtherContextCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> extends SimpleCondition<Doc, F, Exclude<ContextOperator, 'in' | 'not in'>> {
+    /** The operator to use for the comparison, excluding 'in' and 'not in'. */
+    operator: Exclude<ContextOperator, 'in' | 'not in'>;
+    /** The value to compare against the field. */
+    value: FieldOf<DeepRecord<Doc>, Paths<Doc>> | any;
+}
+/**
+ * A condition that includes all operators, including 'in' and 'not in', for general use.
+ * @category Database
+ */
+export interface GeneralCondition<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> extends SimpleCondition<Doc, F, AllOperators> {
+    /** The operator to apply to the condition, including all possible operators. */
+    operator: AllOperators;
+    /** The value to use in the condition comparison. */
+    value: any;
+}
+/**
+ * A list of general conditions.
+ * @category Database
+ */
+export type GeneralConditions<Doc extends DocumentData = any, F extends Paths<Doc> = Paths<Doc>> = Array<GeneralCondition<Doc, F>>;
+/**
+ * @category Database
+ */
+export type ContextOperator = Exclude<Operator, '==' | '!='> | 'in' | 'not in';
+/**
+ * Set of operators supported by query context conditions, including list membership.
+ * @category Database
+ */
+export type AllOperators = Operator | 'in' | 'not in';
+/**
+ * A generic value that can exist in a query.
+ * @category Database
+ */
+export type GenericValue<Doc = any, F extends Paths<Doc> = Paths<Doc>, O extends AllOperators = any> = O extends 'in' ? Array<DeepRecord<Doc>[F]> | null : O extends 'not in' ? Array<DeepRecord<Doc>[F]> | null : DeepRecord<Doc>[F] | null;