@squidcloud/client 1.0.502 → 1.0.504

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

@@ -1,4 +0,0 @@
-import { AppId } from '../public-types/communication.public-types';
-import { Stage } from '../types/stage';
-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): string;

package/dist/internal-common/src/utils/integration-access-tokens.d.ts

@@ -1,15 +0,0 @@
-import { AiChatRequestCredentials } from '../public-types/ai-agent.public-types';
-import { IntegrationId } from '../public-types/communication.public-types';
-/** Access tokens a caller supplies for one request, keyed by integration ID. */
-export type IntegrationAccessTokens = Record<IntegrationId, string>;
-/** Serializes [tokens] into the value of the {@link SquidHeaders.INTEGRATION_ACCESS_TOKENS} header. */
-export declare function serializeIntegrationAccessTokens(tokens: IntegrationAccessTokens): string;
-/** Parses the {@link SquidHeaders.INTEGRATION_ACCESS_TOKENS} header value; a malformed value is a bad request. */
-export declare function parseIntegrationAccessTokens(headerValue: string): IntegrationAccessTokens;
-/** Builds the request headers that carry [tokens]; empty when there is nothing to send. */
-export declare function toIntegrationAccessTokenHeaders(tokens: IntegrationAccessTokens | undefined): Record<string, string>;
-/** Splits the tokens off the call [options]: the headers that carry them, and the options the request body takes. */
-export declare function splitIntegrationAccessTokens<T extends AiChatRequestCredentials>(options: T | undefined): {
-    headers: Record<string, string>;
-    options: Omit<T, 'integrationAccessTokens'> | undefined;
-};

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

@@ -1,14 +0,0 @@
-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

@@ -1,4 +0,0 @@
-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

@@ -1,7 +0,0 @@
-/**
- * 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;

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

@@ -1,93 +0,0 @@
-/** Splits a field path into the segments `getInPath` walks: a dot or a bracket separates them. */
-export declare const SPLIT_REGEX_FOR_GET_IN_PATH: RegExp;
-/** Returns a value by the `path`. Works with array indexes, like a.b[0]. */
-export declare function getInPath(obj: unknown, path: string): any;
-export declare function isDateObject(value: unknown): value is Date;
-/** Sets a value by path . Does not support array indexes. */
-export declare function setInPath(obj: object, path: string, value: unknown, delimiter?: string): void;
-export declare function deleteInPath(obj: object, path: string, delimiter?: string): void;
-export declare function replaceKeyInMap<K, T>(map: Map<K, T | undefined>, a: K, b: K): void;
-export declare function replaceKeyInRecord<K extends keyof any, T>(record: Record<K, T>, a: K, b: K): void;
-export declare function isNil(obj: unknown): obj is null | undefined;
-export declare function isEqual(a: unknown, b: unknown): boolean;
-export declare function isEmpty(a: unknown): boolean;
-export declare function omit<T extends object, K extends PropertyKey[]>(object: T | null | undefined, ...fieldsToRemove: K): Pick<T, Exclude<keyof T, K[number]>>;
-export type CloneCustomizer = (value: unknown) => unknown | undefined;
-/**
- * Creates a deep copy of the specified object, including all nested objects and specifically handling Date, Map, and
- * Set fields.
- *
- * The customizer function can modify the cloning process for the object and its fields. If the customizer
- * returns 'undefined' for any input, the function falls back to the standard cloning logic.
- *
- * The cloning process is recursive, ensuring deep cloning of all objects.
- *
- * Note: This function does not support cloning objects with circular dependencies and will throw a system stack
- * overflow error if encountered.
- */
-export declare function cloneDeep<R = unknown>(value: R, customizer?: CloneCustomizer): R;
-/** Creates a shallow clone of the object. */
-export declare function cloneShallow<T>(value: T): T;
-export declare function deepMerge<T extends object, U extends object>(target: T, source: U): T & U;
-/** Returns true if the `value` is a defined object and is not an array. */
-export declare function isPlainObject(value: unknown): value is object;
-/**
- * Returns true if the `value` is an object that JSON can hold as it is: a plain object whose values are JSON at any
- * depth, with no `__proto__` key. A `Date` or another class instance is not one.
- */
-export declare function isJsonObject(value: unknown): value is Record<string, unknown>;
-/** Compares 2 values. 'null' and 'undefined' values are considered equal and are less than any other values. */
-export declare function compareValues(v1: unknown, v2: unknown): number;
-/** Returns a new object with all top-level object fields re-mapped using `valueMapperFn`. */
-export declare function mapValues<ResultType extends object = Record<string, unknown>, InputType extends Record<string, unknown> = Record<string, unknown>>(obj: InputType, valueMapperFn: (value: any, key: keyof InputType, obj: InputType) => unknown): ResultType;
-/** Groups elements of the array by key. See _.groupBy for details. */
-export declare function groupBy<T, K extends PropertyKey>(array: T[], getKey: (item: T) => K): Record<K, T[]>;
-/**
- * Picks selected fields from the object and returns a new object with the fields selected.
- * The selected fields are assigned by reference (there is no cloning).
- */
-export declare function pick<T extends object, K extends keyof T>(obj: T, keys: ReadonlyArray<K>): Pick<T, K>;
-/** Inverts the record: swaps keys and values. */
-export declare function invert<K extends string | number, V extends string | number>(record: Record<K, V>): Record<V, K>;
-/**
- * Creates an array of numbers (positive and/or negative) progressing from start up to, but not including, end.
- * If end is less than start a zero-length range is created unless a negative step is specified.
- *
- * Same as lodash range but with an additional parameter: `maximumNumberOfItems`.
- */
-export declare function range(start: number, end: number, step: number, maximumNumberOfItems?: number): number[];
-/** Returns count of top level properties in object. */
-export declare function countObjectKeys(obj: object | undefined | null): number;
-/** Returns object entries sorted by name. */
-export declare function getSortedEntries<T>(record: Record<string, T>): Array<[string, T]>;
-/** Removes top level fields which are empty objects. May be used for value formatting. */
-export declare function removeEmptyTopLevelRecords<T extends object>(record: T): Partial<T>;
-export declare function removeUndefinedValues<V>(tags: Record<string, V | undefined>): Record<string, V>;
-export declare function extractKey(line: string | undefined): string | null;
-/** Represents a line in a diff output */
-export interface DiffLine {
-    lineNumber: number;
-    text: string;
-    type: 'unchanged' | 'added' | 'removed' | 'changed';
-}
-/** Result of computing a line-by-line diff between two objects */
-export interface DiffResult {
-    leftLines: Array<DiffLine>;
-    rightLines: Array<DiffLine>;
-    hasChanges: boolean;
-}
-/**
- * Computes a line-by-line diff between two objects.
- * Objects are serialized to JSON with sorted keys for consistent comparison.
- * @param before The previous/left object (can be undefined for new objects)
- * @param after The current/right object
- * @returns DiffResult with left and right lines and whether there are changes
- */
-export declare function computeObjectDiff(before: unknown, after: unknown): DiffResult;
-/**
- * Formats an object as diff lines (all unchanged).
- * Useful for displaying a single object without comparison.
- * @param obj The object to format
- * @returns Array of DiffLine with all lines marked as unchanged
- */
-export declare function formatObjectAsLines(obj: unknown): Array<DiffLine>;

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

@@ -1,30 +0,0 @@
-export declare function sortKeys(json: unknown): any;
-export declare function normalizeJsonAsString(json: unknown): string;
-export declare function serializeObj(obj: unknown): string;
-/**
- * A `JSON.stringify` replacer writing a `Date` as `{ $date }`, the form {@link deserializeObj} reads back,
- * for callers that keep every other value's own `toJSON`. The date is read off the holder, since a
- * replacer is handed the `toJSON` text of a date; an invalid date keeps that text, `null`.
- */
-export declare function writeDateAsBson(this: Record<string, unknown>, key: string, value: unknown): unknown;
-export declare function deserializeObj<T = any>(str: string): T;
-/**
- * Deserializes a multipart request payload when present.
- * NestJS does not pull the body out of a multipart request, and leaves the JSON payload in its `body` form field;
- * plain JSON requests carry the payload as-is.
- */
-export declare function deserializeMultipartBody<T>(request: T): T;
-export declare function encodeValueForMapping(value: unknown): string;
-export declare function decodeValueForMapping(encodedString: string): any;
-/**
- * Compares 2 objects by their normalized JSON value.
- * This function should not be used with objects with circular references.
- * Returns true if the object are equal.
- */
-export declare function compareByNormalizedJsonValue<T>(v1: T | undefined, v2: T | undefined): boolean;
-/**
- * Compares 2 objects by their normalized JSON value for specific fields only.
- * This function should not be used with objects with circular references.
- * Returns true if the specified fields are equal.
- */
-export declare function compareByNormalizedJsonValueForFields<T>(v1: T | undefined, v2: T | undefined, fields: Array<keyof T>): boolean;

package/dist/internal-common/src/utils/squid.constants.d.ts

@@ -1,3 +0,0 @@
-export declare const SQUID_SUPPORT_EMAIL = "support@getsquid.ai";
-/** Error code when application is not found. */
-export declare const APPLICATION_NOT_FOUND_ERROR = "APPLICATION_NOT_FOUND";

package/dist/internal-common/src/utils/trace-id-generator.d.ts

@@ -1 +0,0 @@
-export declare function generateTraceId(prefix?: string): string;

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

@@ -1,21 +0,0 @@
-import { HttpStatusCode } from '../public-types/http-status.public-types';
-export declare class ValidationError extends Error {
-    readonly statusCode: HttpStatusCode;
-    readonly details?: any;
-    constructor(error: string, statusCode: HttpStatusCode, details?: Record<string, unknown>);
-}
-export declare function isValidId(id: unknown, maxLength?: number): boolean;
-export declare function validateFieldSort(fieldSort: unknown): void;
-/** The largest limit one query may carry. */
-export declare const MAX_QUERY_LIMIT = 20000;
-export declare function validateQueryLimit(limit: unknown): void;
-/**
- * All type names returned by 'typeof' supported by JavaScript:
- * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/typeof}.
- * and a few other supported types.
- */
-export type JavascriptTypeName = 'undefined' | 'object' | 'boolean' | 'number' | 'bigint' | 'string' | 'symbol' | 'function';
-/** Returns true if 'typeof' of the 'value' is 'type' or 'type[]'. */
-export declare function isRightType(value: unknown, type: JavascriptTypeName): boolean;
-/** Returns true if 'obj' has only keys listed in the 'keys'. Object can't be an array. */
-export declare function hasOnlyKeys(obj: object, keys: string[]): boolean;

package/dist/internal-common/src/websocket.impl.d.ts

@@ -1,26 +0,0 @@
-interface Options {
-    maxAttempts?: number;
-    protocols?: string[];
-    onmessage?: (event: any) => void;
-    onopen?: (event: any) => void;
-    onclose?: (event: any) => void;
-    onerror?: (event: any) => void;
-    onreconnect?: (event: any) => void;
-    onmaximum?: (event: any) => void;
-    timeoutMillis?: number;
-}
-export interface WebSocketWrapper {
-    open: () => void;
-    reconnect: (e: any) => void;
-    json: (x: any) => void;
-    send: (x: string) => void;
-    close: (x?: number, y?: string) => void;
-    connected: boolean;
-    /**
-     * Websocket is explicitly closed by calling socket.close().
-     * Used to ignore errors after socket.closed() is called.
-     */
-    closeCalled: boolean;
-}
-export declare function createWebSocketWrapper(url: string, opts?: Options): WebSocketWrapper;
-export {};