@squidcloud/client 1.0.168 → 1.0.169

package/dist/typescript-client/src/secret.client.d.ts

@@ -0,0 +1,23 @@
+import { SetSecretRequestEntry } from '../../internal-common/src/types/secret.types';
+import { SecretEntry, SecretKey, SecretValue } from './public-types';
+import { RpcManager } from './rpc.manager';
+export declare class SecretClient {
+    private readonly rpcManager;
+    constructor(rpcManager: RpcManager);
+    get(key: SecretKey): Promise<SecretEntry | undefined>;
+    getAll(): Promise<Record<SecretKey, SecretEntry>>;
+    upsert(key: SecretKey, value: SecretValue): Promise<SecretEntry>;
+    upsertMany(entries: Array<SetSecretRequestEntry>): Promise<Array<SecretEntry>>;
+    delete(key: SecretKey): Promise<void>;
+    deleteMany(keys: Array<SecretKey>): Promise<void>;
+    get apiKeys(): ApiKeysSecretClient;
+}
+declare class ApiKeysSecretClient {
+    private readonly rpcManager;
+    constructor(rpcManager: RpcManager);
+    get(key: SecretKey): Promise<SecretEntry | undefined>;
+    getAll(): Promise<Record<SecretKey, SecretEntry>>;
+    upsert(key: SecretKey): Promise<SecretEntry>;
+    delete(key: SecretKey): Promise<void>;
+}
+export {};

package/dist/typescript-client/src/socket.manager.d.ts

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

package/dist/typescript-client/src/squid.d.ts

@@ -0,0 +1,245 @@
+import { CollectionReference } from './collection-reference';
+import { ConnectionDetails } from './connection-details';
+import { DistributedLock } from './distributed-lock.manager';
+import { GraphQLClient } from './graphql-client';
+import { SecretClient } from './secret.client';
+import { TransactionId } from './types';
+import { AiClient } from './ai.types';
+import { ApiEndpointId, ApiKey, AppId, CollectionName, DocumentData, EnvironmentId, IntegrationId, SquidDeveloperId, SupportedSquidRegion } from './public-types';
+import { QueueManager } from './queue.manager';
+/** The different options that can be used to initialize a Squid instance. */
+export interface SquidOptions {
+    /**
+     * A function that can be used to wrap messages coming from Squid to the application. This is useful for
+     * different frameworks that need to wrap messages in order to detect changes (like Angular).
+     * @param fn The function to wrap.
+     */
+    messageNotificationWrapper?: (fn: () => any) => any;
+    /**
+     * The application ID that is used to identify the application in Squid. The ID can be found in the Squid Cloud
+     * Console.
+     */
+    appId: AppId;
+    /**
+     * The application API key, using the API key can be used to bypass security rules and other restrictions.
+     * The API key can be found in the Squid Cloud Console.
+     */
+    apiKey?: ApiKey;
+    /**
+     * Access token provider for the Squid instance.
+     * Used for managing the process of verifying the identity and authorization of users who attempt to access this
+     * application via the current Squid instance.
+     *
+     * When the authProvider is set, the Squid service will fetch a token and include it with every request to the Squid
+     * backend.
+     *
+     * On the backend, Squid will validate the access token.
+     */
+    authProvider?: SquidAuthProvider;
+    /**
+     * The region that the application is running in. This is used to determine the URL of the Squid Cloud API.
+     */
+    region: SupportedSquidRegion;
+    /**
+     * The environment ID to work with, if not specified the default environment (prod) will be used.
+     */
+    environmentId?: EnvironmentId;
+    /**
+     * The user ID of the developer that runs the environment locally.
+     */
+    squidDeveloperId?: SquidDeveloperId;
+    /**
+     * A list of API endpoints that can be used for overriding the default API endpoints for the different integrations.
+     * This is useful for APIs that have multiple base urls hosted in different regions.
+     */
+    apiServerUrlOverrideMapping?: Record<IntegrationId, string>;
+}
+/** Authentication data provider for Squid requests. */
+export interface SquidAuthProvider {
+    /**
+     * Returns a valid AccessToken or undefined if there is no active authorized session.
+     * Called by Squid every time a Squid client makes requests to the Squid backend.
+     */
+    getToken(): Promise<string | undefined> | string | undefined;
+    /**
+     * Optional Auth integration id.
+     * Sent as a part of all Squid requests to the backend.
+     */
+    integrationId?: string;
+}
+/**
+ * The main entry point to the Squid Client SDK.
+ *
+ * The Squid class provides a comprehensive array of functionality for accessing the different integrations, executing
+ * backend functions, managing data, and more. Upon instantiating the Squid class, you will have access to all of these
+ * capabilities.
+ * All public Squid functions are bound to `this` and can be used with a destructuring patterns,
+ * like `const {setAuthProvider} = useSquid()`
+ */
+export declare class Squid {
+    readonly options: SquidOptions;
+    private readonly socketManager;
+    private readonly rpcManager;
+    private readonly dataManager;
+    private readonly documentReferenceFactory;
+    private readonly documentStore;
+    private readonly lockManager;
+    private readonly querySubscriptionManager;
+    private readonly localQueryManager;
+    private readonly queryBuilderFactory;
+    private readonly collectionReferenceFactory;
+    private readonly backendFunctionManager;
+    private readonly nativeQueryManager;
+    private readonly apiManager;
+    private readonly graphqlClientFactory;
+    private readonly destructManager;
+    private readonly documentIdentityService;
+    private readonly distributedLockManager;
+    private readonly authManager;
+    private readonly clientIdService;
+    private readonly aiClientFactory;
+    private readonly _connectionDetails;
+    private readonly secretClient;
+    private readonly querySender;
+    private static readonly squidInstancesMap;
+    private readonly aiClient;
+    private readonly queueManagerFactory;
+    /**
+     * Creates a new instance of Squid with the given options.
+     *
+     * @param options The options for initializing the Squid instance.
+     */
+    constructor(options: SquidOptions);
+    /**
+     * Returns the global Squid instance with the given options, creating a new instance if one with the same options
+     * does not exist.
+     *
+     * @param options The options for initializing the Squid instance.
+     * @returns A global Squid instance with the given options.
+     */
+    static getInstance(options: SquidOptions): Squid;
+    /**
+     * Returns all the global Squid instances.
+     *
+     * @returns An array of all the global Squid instances.
+     */
+    static getInstances(): Array<Squid>;
+    /**
+     * Sets the authorization access token (OAuth2.0) provider that will be sent to the server and will be used for
+     * providing the `auth` object to the security rules.
+     *
+     * @param authProvider The OAuth2.0 access token provider invoked for every backend request by Squid.
+     *    When the provider returns undefined, no authorization information is sent.
+     *    When a new provider is set, all future Squid backend requests will use the new token provider, and exising
+     *    in-flight requests won't be affected.
+     * @returns void.
+     */
+    setAuthProvider(authProvider: SquidAuthProvider): void;
+    /**
+     * Returns a reference to the collection in the provided integration.
+     *
+     * If the integrationId is not provided, the `built_in_db` integration id will be used.
+     *
+     * For more information on the CollectionReference object, please refer to the
+     * {@link https://docs.squid.cloud/docs/development-tools/client-sdk/collection-reference documentation}.
+     *
+     * @param collectionName The name of the collection.
+     * @param integrationId The id of the integration, default to `built_in_db`.
+     * @returns A reference to the collection in the provided integration.
+     * @typeParam T The type of the documents in the collection.
+     */
+    collection<T extends DocumentData>(collectionName: CollectionName, integrationId?: IntegrationId): CollectionReference<T>;
+    /**
+     * Runs the given callback as an atomic change. All the mutations that are executed using the provided transactionId
+     * will be atomic. Note that mutations for different integrations will not be atomic.
+     *
+     * For more information about transactions in Squid, please refer to the
+     * {@link https://docs.squid.cloud/docs/development-tools/client-sdk/transactions documentation}.
+     *
+     * @param fn The callback to run as an atomic change. The function receives a transactionId that should be used for
+     * all the mutations that should be atomic. The function should return a promise.
+     *
+     * @returns A promise that resolves when the transactions are committed on the server.
+     */
+    runInTransaction<T = any>(fn: (transactionId: TransactionId) => Promise<T>): Promise<T>;
+    /**
+     * Executes the given backend function with the given parameters and returns a promise with the result.
+     *
+     * For more information about backend functions in Squid, please refer to the
+     * {@link https://docs.squid.cloud/docs/development-tools/backend/executables documentation}.
+     *
+     * @param functionName The name of the function to execute on the server.
+     * @param params The parameters to pass to the function.
+     * @returns A promise that resolves with the result of the function.
+     * @typeParam T The type of the result of the function.
+     */
+    executeFunction<T = any>(functionName: string, ...params: any[]): Promise<T>;
+    /**
+     * Executes a native relational query with the given parameters and returns a promise with the result.
+     *
+     * Native queries allow you to execute raw SQL or other database-specific queries directly against the database.
+     * This can be useful when you need to perform operations that are not easily accomplished with other high-level
+     * abstractions.
+     *
+     * @param integrationId The id of the integration that the query is associated with.
+     * @param query The raw SQL or other database-specific query to execute.
+     * @param params (Optional) The parameters to pass to the query. Defaults to an empty object.
+     * @returns A promise that resolves with the result of the query.
+     * @type {Promise<Array<SquidDocument>>}
+     */
+    executeNativeRelationalQuery<T = any>(integrationId: IntegrationId, query: string, params?: Record<string, any>): Promise<Array<T>>;
+    /**
+     * Invokes the given HTTP API (defined by the integration ID and the endpoint ID) with the given request parameters
+     * and returns a promise with the response. The structure of the request and the response is defined in the
+     * integration's schema page.
+     *
+     * For more information about API integrations in Squid, please refer to the
+     * {@link https://docs.squid.cloud/docs/integrations/api/httpapi documentation}.
+     *
+     * @param integrationId The id of the integration that the API is defined with.
+     * @param endpointId The id of the endpoint in the API integration.
+     * @param request The request parameters to pass to the API.
+     * @returns A promise that resolves with the response of the API.
+     * @typeParam T The type of the response of the API.
+     */
+    callApi<T = any>(integrationId: IntegrationId, endpointId: ApiEndpointId, request?: Record<string, any>): Promise<T>;
+    /**
+     * Returns a GraphQL client for the given integration. The GraphQL client can be used to execute GraphQL queries and
+     * mutations. For more information about GraphQL in Squid, please refer to the
+     * {@link https://docs.squid.cloud/docs/integrations/api/graphql documentation}.
+     *
+     * @param integrationId The id of the integration that the GraphQL API is defined with.
+     * @returns A GraphQL client for the given integration.
+     */
+    graphql(integrationId: IntegrationId): GraphQLClient;
+    /**
+     * Returns a set of AI specific clients.
+     *
+     * @returns A set of AI specific clients.
+     */
+    ai(): AiClient;
+    get secrets(): SecretClient;
+    /**
+     * Returns a distributed lock for the given mutex. The lock can be used to synchronize access to a shared resource.
+     * The lock will be released when the release method on the returned object is invoked or whenever the connection
+     * with the server is lost.
+     * @param mutex A string that uniquely identifies the lock.
+     * @returns A promise that resolves with the lock object. The promise will reject if failed to acquire the lock.
+     */
+    acquireLock(mutex: string): Promise<DistributedLock>;
+    /**
+     * Returns a queue manager for the given topic name and integration id. Using the queue manager you can consume and
+     * produce messages
+     */
+    queue(topicName: string, integrationId?: IntegrationId): QueueManager;
+    /**
+     * Destructs the Squid Client. Unsubscribes from all ongoing queries or requests, and clears the local data.
+     * After invoking this method, the Squid client will not be usable.
+     *
+     * @returns A promise that resolves when the destruct process is complete.
+     */
+    destruct(): Promise<void>;
+    /** Provides information about the connection to the Squid Server. */
+    connectionDetails(): ConnectionDetails;
+    private _validateNotDestructed;
+}

package/dist/typescript-client/src/state/state.service.spec.d.ts

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

package/dist/typescript-client/src/testing/setup-tests.d.ts

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

package/dist/typescript-client/src/types.d.ts

@@ -0,0 +1,6 @@
+/** A transactionId - alias for string */
+export type TransactionId = string;
+export interface BlobAndFilename {
+    blob: Blob;
+    name: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.168",
+  "version": "1.0.169",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "types": "dist/typescript-client/src/index.d.ts",
@@ -14,6 +14,8 @@
     "build:prod": "webpack --mode=production",
     "watch": "webpack --watch",
     "lint": "eslint . --ext .ts",
+    "build-and-check-public-types": "npm run prebuild && npm run build && npm run check-public-types",
+    "check-public-types": "tsc -p tsconfig.types.json",
     "test": "jest --detectOpenHandles",
     "test:watch": "jest --watch",
     "test:cov": "jest --coverage",