@squidcloud/client 1.0.440 → 1.0.441

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

@@ -0,0 +1,202 @@
+import { AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseSearchResultChunk, AiKnowledgeBaseWithOptionalChatModel } from '../public-types/ai-knowledge-base.public-types';
+import { AiContextId, AiKnowledgeBaseId, AppId } from '../public-types/communication.public-types';
+/**
+ * Request structure for getting an AiKnowledgeBase
+ * @category AI
+ */
+export interface GetAiKnowledgeBaseRequest {
+    /** The id of the app */
+    appId: AppId;
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: AiKnowledgeBaseId;
+}
+/**
+ * Request structure for getting all AiKnowledgeBases
+ * @category AI
+ */
+export interface GetAiKnowledgeBasesRequest {
+    /** The id of the app */
+    appId: AppId;
+}
+/**
+ * Response structure for getting an AiKnowledgeBase
+ * @category AI
+ */
+export interface GetAiKnowledgeBaseResponse {
+    /** The resulting AiKnowledgeBase, if it is found */
+    knowledgeBase: AiKnowledgeBase | undefined;
+}
+/**
+ * Request structure for deleting an AiKnowledgeBase
+ * @category AI
+ */
+export interface DeleteAiKnowledgeBaseRequest {
+    /** The id of the AiKnowledgeBase */
+    id: string;
+}
+/**
+ * Request structure for upserting an AiKnowledgeBase
+ * @category AI
+ */
+export interface UpsertAiKnowledgeBaseRequest {
+    /** The AiKnowledgeBase to upsert */
+    knowledgeBase: Omit<AiKnowledgeBaseWithOptionalChatModel, 'appId' | 'updatedAt'>;
+}
+/**
+ * Response structure for listing AiKnowledgeBases
+ * @category AI
+ */
+export interface ListAiKnowledgeBasesResponse {
+    /** The list of AiKnowledgeBases */
+    knowledgeBases: Array<AiKnowledgeBase>;
+}
+/**
+ * Request structure for listing AiKnowledgeBaseContexts
+ * @category AI
+ */
+export interface ListAiKnowledgeBaseContextsRequest {
+    /** The id of the AiKnowledgeBase */
+    id: string;
+    /** The number of characters after which text is truncated. Optional */
+    truncateTextAfter?: number;
+}
+/**
+ * Response structure to list AiKnowledgeBaseContexts
+ * @category AI
+ */
+export interface ListAiKnowledgeBaseContextsResponse {
+    /** The list of AiKnowledgeBaseContexts */
+    contexts: Array<AiKnowledgeBaseContext>;
+}
+/**
+ * Response structure to list contextids for an AiKnowledgeBase
+ * @category AI
+ */
+export interface ListAiKnowledgeBaseContextIdsResponse {
+    /** The list of AiContextIds */
+    contextIds: Array<AiContextId>;
+}
+/**
+ * Request structure for deleting AiKnowledgeBaseContexts
+ * @category AI
+ */
+export interface DeleteAiKnowledgeBaseContextsRequest {
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: string;
+    /** An array of AiKnowledgeBaseContext ids */
+    contextIds: Array<string>;
+}
+/**
+ * Request structure for getting an AiKnowledgeBaseContext
+ * @category AI
+ */
+export interface GetAiKnowledgeBaseContextRequest {
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: string;
+    /** The id of the AiKnowledgeBaseContext */
+    contextId: string;
+}
+/**
+ * Request structure for getting all AiKnowledgeBaseContexts
+ * for a given knowledge base
+ * @category AI
+ */
+export interface GetAiKnowledgeBaseContextsRequest {
+    /** The id of the app */
+    appId: AppId;
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: AiKnowledgeBaseId;
+    /** The number of characters after which text is truncated. Optional */
+    truncateTextAfter?: number;
+}
+/**
+ * Response structure for getting an AiKnowledgeBaseContext
+ * @category AI
+ */
+export interface GetAiKnowledgeBaseContextResponse {
+    /** The resulting AiKnowledgeBaseContext, if it is found */
+    context: AiKnowledgeBaseContext | undefined;
+}
+/**
+ * Request structure for upserting context for an AiKnowledgeBase
+ * @category AI
+ */
+export interface UpsertAiKnowledgeBaseContextsRequest {
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: string;
+    /** The AiKnowledgeBaseContext data, which could be a file or text */
+    contextRequests: Array<AiKnowledgeBaseContextRequest>;
+    /** The job ID to use for the async upsert job */
+    jobId: string;
+}
+/**
+ * Response structure for searching an AiKnowledgeBase
+ * @category AI
+ */
+export interface AiKnowledgeBaseSearchResponse {
+    /** Array of result chunks from the search */
+    chunks: Array<AiKnowledgeBaseSearchResultChunk>;
+}
+/**
+ * Request structure for getting the size of context
+ * for an AiKnowledgeBase
+ * @category AI
+ */
+export interface AiKnowledgeBaseContextSizeRequest {
+    /** The ID of the App */
+    appId: AppId;
+    /** The ID of the AIKnowledgeBase */
+    knowledgeBaseId: AiKnowledgeBaseId;
+}
+/**
+ * Request structure for identifying a knowledge base to reimport the context files (when possible).
+ */
+export interface AiKnowledgeBaseReimportAllFilesRequest {
+    /** The ID of the AIKnowledgeBase */
+    knowledgeBaseId: AiKnowledgeBaseId;
+}
+/**
+ * Request structure for identifying a knowledge base to reimport the context files (when possible).
+ */
+export interface AiKnowledgeBaseReimportFilesRequest {
+    /** The ID of the AIKnowledgeBase */
+    knowledgeBaseId: AiKnowledgeBaseId;
+    /** The ids of the AiKnowledgeBaseContexts to reimport */
+    contextIds: Array<string>;
+}
+/**
+ * Response structure for getting size of context
+ * @category AI
+ */
+export interface AiKnowledgeBaseContextSizeResponse {
+    /** Size of context bytes, as a number */
+    sizeBytes: number;
+}
+/**
+ * Request structure for getting the values vector of
+ * a specific context
+ *
+ * @category AI
+ */
+export interface AiKnowledgeBaseValueVectorRequest {
+    /** The ID of the App */
+    appId: AppId;
+    /** The ID of the AIKnowledgeBase */
+    knowledgeBaseId: AiKnowledgeBaseId;
+    /** The ID of the context */
+    contextId: AiContextId;
+}
+/**
+ * Response structure for getting values vector of a
+ * specific context
+ * @category AI
+ */
+export interface AiKnowledgeBaseValueVectorResponse {
+    /** The vector */
+    vector: number[];
+}
+export interface AiKnowledgeBaseChatRequest {
+    knowledgeBaseId: AiKnowledgeBaseId;
+    prompt?: string;
+    options?: AiKnowledgeBaseChatOptions;
+}

package/dist/internal-common/src/types/ai-matchmaking.types.d.ts

@@ -0,0 +1,59 @@
+import { MmEntity, MmEntityMatch, MmFindMatchesOptions, MmListEntitiesOptions, MmMatchMaker } from '../public-types/ai-matchmaking.public-types';
+export interface MmCreateMatchMakerRequest {
+    matchMaker: MmMatchMaker;
+}
+export interface MmDeleteMatchMakerRequest {
+    matchMakerId: string;
+}
+export interface MmGetMatchMakerRequest {
+    matchMakerId: string;
+}
+export interface MmGetMatchMakerResponse {
+    matchMaker: MmMatchMaker | undefined;
+}
+export interface MmDeleteEntityRequest {
+    matchMakerId: string;
+    entityId: string;
+}
+export interface MmInsertEntityRequest {
+    matchMakerId: string;
+    entity: MmEntity;
+}
+export interface MmInsertEntitiesRequest {
+    matchMakerId: string;
+    entities: Array<MmEntity>;
+}
+export interface MmFindMatchesRequest {
+    matchMakerId: string;
+    entityId: string;
+    options: MmFindMatchesOptions;
+}
+export interface MmFindMatchesResponse {
+    matches: Array<MmEntityMatch>;
+}
+export interface MmFindMatchesForEntityRequest {
+    matchMakerId: string;
+    entity: Omit<MmEntity, 'metadata' | 'id'>;
+    options: MmFindMatchesOptions;
+}
+export interface MmFindMatchesForEntityResponse {
+    matches: Array<MmEntityMatch>;
+}
+export interface MmListMatchMakersResponse {
+    matchMakers: Array<MmMatchMaker>;
+}
+export interface MmListEntitiesRequest {
+    matchMakerId: string;
+    categoryId: string;
+    options: MmListEntitiesOptions;
+}
+export interface MmListEntitiesResponse {
+    entities: Array<MmEntity>;
+}
+export interface MmGetEntityRequest {
+    matchMakerId: string;
+    entityId: string;
+}
+export interface MmGetEntityResponse {
+    entity: MmEntity | undefined;
+}

package/dist/internal-common/src/types/backend-function.types.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/internal-common/src/types/communication.types.d.ts

@@ -0,0 +1 @@
+export type ChatId = string;

package/dist/internal-common/src/types/document.types.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/internal-common/src/types/file.types.d.ts

@@ -0,0 +1,6 @@
+export interface Base64File {
+    filename: string;
+    mimetype: string;
+    base64: string;
+    __isSquidBase64File__: true;
+}

package/dist/internal-common/src/types/headers.types.d.ts

@@ -0,0 +1,17 @@
+/** HTTP header names used by Squid for request metadata. */
+export declare const SquidHeaders: {
+    /** Correlates logs and spans across distributed calls. */
+    readonly TRACE_ID: "x-squid-traceid";
+    /** Shared secret header for internal authentication. */
+    readonly SECRET: "x-squid-secret";
+    /** API key provided by the calling application. */
+    readonly APP_API_KEY: "x-app-api-key";
+    /** Unique identifier of the client application. */
+    readonly APP_ID: "x-squid-appid";
+    /** Unique identifier of the end user or service client. */
+    readonly CLIENT_ID: "x-squid-clientid";
+    /** Version string of the Squid client library. */
+    readonly CLIENT_VERSION: "x-squid-client-version";
+    /** Originating IP address of the request. */
+    readonly SOURCE_IP: "x-squid-source-ip";
+};

package/dist/internal-common/src/types/management-api-key.types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Status lifecycle for management API keys.
+ * Keys must be suspended before they can be deleted.
+ * @category ManagementApiKey
+ */
+export type ManagementApiKeyStatus = 'active' | 'suspended' | 'deleted';
+/**
+ * Prefix for all management API keys.
+ * Used to identify and validate management keys.
+ * @category ManagementApiKey
+ */
+export declare const MANAGEMENT_API_KEY_PREFIX = "squid_mgmt_";
+/**
+ * Represents a user-level management API key.
+ * These keys provide programmatic access to manage organizations and applications
+ * where the user is an admin.
+ * @category ManagementApiKey
+ */
+export interface ManagementApiKey {
+    /** Unique identifier for the API key */
+    id: string;
+    /** The user ID who owns this key */
+    userId: string;
+    /** Optional description for the key */
+    description?: string;
+    /** Current status of the key */
+    status: ManagementApiKeyStatus;
+    /** Timestamp when the key was created */
+    createdAt: Date;
+    /** Timestamp when the key was last updated */
+    updatedAt: Date;
+    /** Timestamp when the key was last used, if ever */
+    lastUsedAt?: Date;
+}
+/**
+ * Request to create a new management API key.
+ * @category ManagementApiKey
+ */
+export interface CreateManagementApiKeyRequest {
+    /** Optional description for the key */
+    description?: string;
+}
+/**
+ * Response when creating a new management API key.
+ * The keyValue is only returned once during creation.
+ * @category ManagementApiKey
+ */
+export interface CreateManagementApiKeyResponse {
+    /** The created key with its value (only shown once) */
+    key: ManagementApiKey & {
+        keyValue: string;
+    };
+}
+/**
+ * Request to update a management API key's status.
+ * @category ManagementApiKey
+ */
+export interface UpdateManagementApiKeyRequest {
+    /** The ID of the key to update */
+    keyId: string;
+    /** New status (can only toggle between active and suspended) */
+    status: 'active' | 'suspended';
+}
+/**
+ * Request to delete a management API key.
+ * The key must be suspended before deletion.
+ * @category ManagementApiKey
+ */
+export interface DeleteManagementApiKeyRequest {
+    /** The ID of the key to delete */
+    keyId: string;
+}
+/**
+ * Response containing a list of user's management API keys.
+ * @category ManagementApiKey
+ */
+export interface ListManagementApiKeysResponse {
+    /** List of management API keys (without key values) */
+    keys: ManagementApiKey[];
+}
+/**
+ * Response from validating a management API key.
+ * @category ManagementApiKey
+ */
+export interface ValidateManagementApiKeyResponse {
+    /** Whether the key is valid and active */
+    valid: boolean;
+    /** The user ID associated with the key (if valid) */
+    userId?: string;
+    /** The key ID (if valid) */
+    keyId?: string;
+}

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

@@ -0,0 +1 @@
+export {};

package/dist/internal-common/src/types/notification.types.d.ts

@@ -0,0 +1,5 @@
+import { ClientId } from '../public-types/communication.public-types';
+export interface PublishNotificationRequest {
+    clientIds: Array<ClientId>;
+    payload: unknown;
+}

package/dist/internal-common/src/types/observability.types.d.ts

@@ -0,0 +1,107 @@
+import { MetricName } from '../metric-name';
+import { AppId } from '../public-types/communication.public-types';
+export interface ObservableNameMetrics {
+    count: MetricName;
+    time: MetricName;
+}
+export declare const ObservableNames: {
+    readonly functionExecution: ObservableNameMetrics;
+    readonly codeInitialization: ObservableNameMetrics;
+    readonly getAiChatbotProfiles: ObservableNameMetrics;
+    readonly aiImageGeneration: ObservableNameMetrics;
+    readonly aiRemoveBackground: ObservableNameMetrics;
+    readonly aiAudioTranscribe: ObservableNameMetrics;
+    readonly aiAudioCreateSpeech: ObservableNameMetrics;
+    readonly discoverGraphQLConnectionSchema: ObservableNameMetrics;
+    readonly discoverOpenApiSchema: ObservableNameMetrics;
+    readonly discoverOpenApiSchemaFromFile: ObservableNameMetrics;
+    readonly graphqlQuery: ObservableNameMetrics;
+    readonly testGraphQLConnection: ObservableNameMetrics;
+    readonly testAgentProtocolConnection: ObservableNameMetrics;
+    readonly graphql: ObservableNameMetrics;
+};
+export type ObservableName = keyof typeof ObservableNames;
+export interface MetricEvent {
+    appId: AppId;
+    name: MetricName;
+    tags: Record<string, string>;
+    timestamp: Date;
+    value: number;
+    isExposedToUser: boolean;
+}
+export interface LogEvent {
+    message: string;
+    level: string;
+    tags: Record<string, string>;
+    timestamp: Date;
+    isExposedToUser: boolean;
+    host: string;
+    source?: string;
+    service?: string;
+}
+export declare const AUDIT_LOG_EVENT_NAMES: readonly ["ai_agent"];
+export type AuditLogEventName = (typeof AUDIT_LOG_EVENT_NAMES)[number];
+export interface AuditLogEvent {
+    appId: AppId;
+    name: AuditLogEventName;
+    timestamp: Date;
+    context: {
+        clientId?: string;
+        userId: string;
+    };
+    tags: Record<string, string>;
+}
+/** Agent audit log entry - one per agent invocation */
+export interface AgentAuditLogEvent {
+    appId: AppId;
+    /** Agent ID (nullable for query-with-AI operations without an agent) */
+    agentId?: string;
+    jobId: string;
+    prompt: string;
+    tags: Record<string, string>;
+    createdAt: Date;
+    /** Integration ID for query-with-AI operations (nullable, used when not invoked via agent) */
+    integrationId?: string;
+}
+export type AgentAuditLogUpdateType = 'statusUpdate' | 'response';
+/** Agent audit log update entry - status updates and responses for agent invocations */
+export interface AgentAuditLogUpdateEvent {
+    appId: AppId;
+    /** Agent ID (nullable for query-with-AI operations without an agent) */
+    agentId?: string;
+    jobId: string;
+    statusUpdateId: string;
+    title: string;
+    parentStatusUpdateId?: string;
+    tags: Record<string, string>;
+    body: string;
+    type: AgentAuditLogUpdateType;
+    createdAt: Date;
+    /** Integration ID for query-with-AI operations (nullable, used when not invoked via agent) */
+    integrationId?: string;
+}
+/** Tag for metric events. Value: '0' - not an error, '1' - is an error. */
+export declare const O11Y_TAG_IS_ERROR = "isError";
+/** Tag for log events. Metrics have an explicit appId field. */
+export declare const O11Y_TAG_APP_ID = "appId";
+/** Tag for metric and log events. */
+export declare const O11Y_TAG_INTEGRATION_ID = "integrationId";
+/** Tag for AI events. */
+export declare const O11Y_TAG_AI_MODEL = "aiModel";
+export declare const O11Y_TAG_AI_PROFILE = "aiProfile";
+/** Tag for AI KnowledgeBase events */
+export declare const O11Y_TAG_AI_KNOWLEDGE_BASE_MODEL = "aiKnowledgeBaseModel";
+export declare const O11Y_TAG_API_KEY_SOURCE = "apiKeySource";
+/** Tag for metric and log events. Value: '0' - not a tenant originated, '1' - is a tenant originated. */
+export declare const O11Y_TAG_IS_TENANT_ORIGINATED = "isTenantOriginated";
+/** Contains a full (with a service name) function name for backend functions. */
+export declare const O11Y_TAG_FUNCTION_NAME = "functionName";
+/** Contains a type of the function name for backend functions (See ExecuteFunctionAnnotationType.). */
+export declare const O11Y_TAG_FUNCTION_TYPE = "functionType";
+/** Tag for the trace ID. Used in logs. */
+export declare const O11Y_TAG_TRACE_ID = "trace_id";
+/** Tag for the span ID. Used in logs. */
+export declare const O11Y_TAG_SPAN_ID = "span_id";
+export declare function getBooleanMetricTagValue(value: boolean): string;
+export declare const COUNT_METRIC_SUFFIXES: string[];
+export declare const GAUGE_METRIC_SUFFIXES: string[];

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

@@ -0,0 +1,13 @@
+import { Condition, SimpleCondition } from '../public-types/query.public-types';
+/**
+ * Generates the regex pattern, handling special characters as follows:
+ *  - `_` is replaced with a `.`
+ *  - `%` is replaced with `[\s\S]*`.
+ *  - The above characters can be escaped with \, eg. `\_` is replaced with `_` and `\%` with `%`.
+ *  - All special characters in regex (-, /, \, ^, $, *, +, ?, ., (, ), |, [, ], {, }) get escaped with \
+ *
+ *  Exported for testing purposes.
+ * */
+export declare function replaceSpecialCharacters(input: string): string;
+/** Returns true if the condition is a 'SimpleCondition' or false otherwise. */
+export declare function isSimpleCondition(condition: Condition): condition is SimpleCondition;

package/dist/internal-common/src/types/secret.types.d.ts

@@ -0,0 +1,7 @@
+import { ApiKeyEntry } from '../public-types/secret.public-types';
+export declare const BACKEND_API_KEY = "_BACKEND_API_KEY";
+export declare const APP_API_KEY = "APP_API_KEY";
+export declare const AGENT_API_HEADER = "x-squid-agent-api-key";
+export interface AgentSecrets {
+    apiKey: ApiKeyEntry | undefined;
+}

package/dist/internal-common/src/types/socket.types.d.ts

@@ -0,0 +1 @@
+export declare const SOCKET_RECONNECT_TIMEOUT: number;

package/dist/internal-common/src/types/stage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stage of the Squid deployment:
+ * - 'local' - Squid is run locally.
+ * - 'prod' - Production environment (https://console.getsquid.ai).
+ * - 'sandbox' - One of the sandbox environments  (https://console.sandbox.squid.cloud).
+ * - 'staging' - One of the staging environments  (https://console.staging.squid.cloud).
+ */
+export declare const STAGES: readonly ["local", "prod", "sandbox", "staging"];
+export type Stage = (typeof STAGES)[number];

package/dist/internal-common/src/types/time-units.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/internal-common/src/types/url-shortener.types.d.ts

@@ -0,0 +1,45 @@
+import { AppId } from '../public-types/communication.public-types';
+/**
+ * Request to create a shortened URL.
+ */
+export interface ShortUrlRequest {
+    /** The URL to shorten. It must be a valid URL and should include the protocol (start with http:// or https://). */
+    url: string;
+    /** The application ID that will own this shortened URL. */
+    appId: AppId;
+    /** Seconds to live for the shortened URL. If set to 0, the URL will never expire. Defaults to 1 day. */
+    secondsToLive?: number;
+    /** Optional file extension to include in the shortened URL ID (e.g., 'pdf', 'html'). The extension becomes part of the ID, so 'abc123.pdf' and 'abc123.jpg' are distinct URLs. */
+    fileExtension?: string;
+}
+/**
+ * Request to create shortened URLs.
+ */
+export interface ShortUrlBulkRequest {
+    /** The URLs to shorten. They must be valid URLs and should include the protocol (start with http:// or https://). */
+    urls: string[];
+    /** The application ID that will own these shortened URLs. */
+    appId: AppId;
+    /** Seconds to live for all shortened URLs. If set to 0, the URLs will never expire. Defaults to 1 day. */
+    secondsToLive?: number;
+    /** Optional file extension to include in all shortened URL IDs (e.g., 'pdf', 'html'). The extension becomes part of each ID, so 'abc123.pdf' and 'abc123.jpg' are distinct URLs. */
+    fileExtension?: string;
+}
+/**
+ * Request to delete a shortened URL.
+ */
+export interface ShortUrlDeleteRequest {
+    /** The ID of the shortened URL to delete. */
+    id: string;
+    /** The application ID that owns the shortened URL. */
+    appId: AppId;
+}
+/**
+ * Request to delete a shortened URL.
+ */
+export interface ShortUrlBulkDeleteRequest {
+    /** The IDs of the shortened URLs to delete. */
+    ids: string[];
+    /** The application ID that owns the shortened URLs. */
+    appId: AppId;
+}

package/dist/internal-common/src/utils/array.d.ts

@@ -0,0 +1,7 @@
+export declare function truncateOrPadArray(arr: number[], length: number): number[];
+/**
+ * Computes a single “recommended” chunk size so that if you loop
+ * `for (let i = 0; i < length; i += chunkSize)`,
+ * no slice will exceed `maxChunkSize` and all chunk sizes are 'almost' equal.
+ */
+export declare function computeRecommendedChunkSize(length: number, maxChunkSize: number): number;

package/dist/internal-common/src/utils/e2e-test-utils.d.ts

@@ -0,0 +1,2 @@
+/** Returns true if the application is run by a Playwright test. */
+export declare function isPlaywrightTestMode(): boolean | undefined;

package/dist/internal-common/src/utils/file-utils.d.ts

@@ -0,0 +1,2 @@
+/** Gets file extension from filename. */
+export declare function getFileExtension(filename: string): string | undefined;

package/dist/internal-common/src/utils/global.utils.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/internal-common/src/utils/http.d.ts

@@ -0,0 +1,5 @@
+import { AppId } from '../public-types/communication.public-types';
+import { Stage } from '../types/stage';
+export declare const KOTLIN_CONTROLLERS: string[];
+export declare function getEnvironmentPrefix(shard: string | undefined, region: string, cloudId: string, stage: Stage): string;
+export declare function getApplicationUrl(environmentPrefix: string, appId: string, path: string, appIdPlaceholder?: AppId, environmentPrefixPlaceholder?: string, forceKotlin?: boolean): string;

package/dist/internal-common/src/utils/lock.manager.d.ts

@@ -0,0 +1,14 @@
+type LockMutex = string;
+/**
+ * A simple lock manager that locks a list of mutexes.
+ * When locking a list of mutexes, the lock will start only when all the mutexes are available - preventing partial lock
+ * and potential deadlocks.
+ */
+export declare class LockManager {
+    private readonly locks;
+    lock(...mutexes: LockMutex[]): Promise<void>;
+    release(...mutexes: LockMutex[]): void;
+    canGetLock(...mutexes: LockMutex[]): boolean;
+    lockSync(...mutexes: LockMutex[]): void;
+}
+export {};

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

@@ -0,0 +1,4 @@
+import { QueryMetricsRequestCommon, QueryMetricsResultGroup } from '../public-types/metric.public-types';
+export type QueryMetricsRequestIntervals = Required<Pick<QueryMetricsRequestCommon, 'fillValue' | 'fn' | 'groupByTags' | 'periodEndSeconds' | 'periodStartSeconds' | 'pointIntervalAlignment' | 'pointIntervalSeconds' | 'tagDomains' | 'noDataBehavior'>>;
+/** Adds missed known tag domain groups and fills all missed points with a request.fillValue. */
+export declare function fillMissedPoints(request: QueryMetricsRequestIntervals, resultGroups: Array<QueryMetricsResultGroup>): void;

package/dist/internal-common/src/utils/metrics.types.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Type suffixes defines the type of the metric and can be used for
+ * metric value validation for incoming metrics.
+ */
+export declare const SQUID_METRIC_TYPE_SUFFIXES: readonly ["_count", "_time", "_size", "_entries", "_value"];
+/** Returns true if the given metric has a valid metric type. */
+export declare function hasValidMetricTypeSuffix(metricName: string): boolean;