@squidcloud/backend 1.0.402 → 1.0.404

package/dist/backend/src/actions.d.ts

@@ -1,6 +1,6 @@
 import { AiFunctionId, ApiEndpointId, CollectionName, IntegrationId, IntegrationType, TopicName } from '@squidcloud/client';
 import { JSONSchema } from 'json-schema-typed';
-import { ActionMethodDecorator, AiFunctionAction, ClientConnectionStateChangeAction, ExecutableAction, LimiterConfig, LimitsAction, LlmAskAction, McpAuthorizerAction, McpToolAction, SchedulerAction, SecureAiAgentAction, SecureApiAction, SecureDatabaseAction, SecureDistributedLockAction, SecureGraphQLAction, SecureMetricAction, SecureNativeQueryAction, SecureStorageAction, SecureTopicAction, TriggerAction, WebhookAction } from '../../internal-common/src/public-types-backend/bundle-api.public-types';
+import { ActionMethodDecorator, AiFunctionAction, ClientConnectionStateChangeAction, ExecutableAction, LimiterConfig, LimitsAction, LlmAskAction, McpAuthorizerAction, McpToolAction, SchedulerAction, SecureAiAgentAction, SecureAiQueryAction, SecureApiAction, SecureDatabaseAction, SecureDistributedLockAction, SecureGraphQLAction, SecureMetricAction, SecureNativeQueryAction, SecureStorageAction, SecureTopicAction, TriggerAction, WebhookAction } from '../../internal-common/src/public-types-backend/bundle-api.public-types';
 import { AiFunctionAttributes, AiFunctionParam, DatabaseActionType, MetricActionType, StorageActionType, TopicActionType } from '../../internal-common/src/public-types-backend/bundle-data.public-types';
 import { AiFunctionsConfiguratorRequest, AiFunctionsConfiguratorResponse, CronExpression, CronExpressionString, LlmServiceOptions, McpServerOptions, MutationType, SchedulerId, TriggerId, WebhookId } from './public-types';
 /**
@@ -21,6 +21,23 @@ import { AiFunctionsConfiguratorRequest, AiFunctionsConfiguratorResponse, CronEx
  * @category Decorator
  */
 export declare function secureDatabase<T extends DatabaseActionType>(type: T, integrationId?: IntegrationId): ActionMethodDecorator<SecureDatabaseAction<T>>;
+/**
+ * Decorator that marks a function for securing a database for querying it with AI (`executeAiQuery`).
+ *
+ * The decorator takes an optional integration ID.
+ * If no integration ID is provided, the `built_in_db` integration is used.
+ *
+ * The function should return a boolean or a `Promise` of a boolean indicating
+ * whether the action is allowed.
+ * In addition, the function takes a context object as a parameter.
+ * The context object contains information about the action.
+ *
+ * @param integrationId The ID of the integration to secure.
+ * @category Database
+ * @category Decorator
+ * @category AI
+ */
+export declare function secureAiQuery(integrationId?: IntegrationId): ActionMethodDecorator<SecureAiQueryAction>;
 /**
  * Decorator that marks a function for securing a collection inside a database.
  * The decorator takes the collection, type of action, and an optional integration ID.

package/dist/backend/src/project.d.ts

@@ -1,7 +1,12 @@
+import { Squid } from '@squidcloud/client';
 /**
  * The SquidProject class is the entry point for the Squid backend project.
  */
 export declare class SquidProject {
-    private metadata;
-    private cleanup;
+    /**
+     * Initializes lifecycle metadata so the runtime knows which hooks the connector implements.
+     */
+    constructor();
+    /** Returns the main Squid instance with the current backend configuration. */
+    get squid(): Squid;
 }

package/dist/backend/src/public-types.d.ts

@@ -2,6 +2,7 @@ export * from '../../internal-common/src/public-types-backend/ai-agent.public-co
 export * from '../../internal-common/src/public-types-backend/api-call.public-context';
 export * from '../../internal-common/src/public-types-backend/application.public-types';
 export * from '../../internal-common/src/public-types-backend/bundle-api.public-types';
+export * from '../../internal-common/src/public-types-backend/bundle-data.public-types';
 export * from '../../internal-common/src/public-types-backend/distributed-lock.public-context';
 export * from '../../internal-common/src/public-types-backend/graphql.public-context';
 export * from '../../internal-common/src/public-types-backend/llm.public-types';

package/dist/backend/src/squid.service.d.ts

@@ -1,5 +1,6 @@
 import { AiStatusMessage, AuthWithApiKey, AuthWithBearer, ClientId, RunContext, SecretKey, SecretValue, Squid, SquidRegion } from '@squidcloud/client';
 import { SquidFile } from '../../internal-common/src/public-types-backend/bundle-api.public-types';
+import { TenantModuleId } from '../../internal-common/src/public-types-backend/bundle-data.public-types';
 /**
  * A base class for all the different types of Squid backend services. This class serves as a container
  * for the various methods implemented in the backend in order to customize the Squid backend for an application.
@@ -9,7 +10,6 @@ export declare class SquidService {
      * Your application's region. When developing locally, the region will be set to `local`.
      */
     readonly region: SquidRegion;
-    private readonly consoleRegion;
     readonly backendBaseUrl: string;
     private readonly config;
     constructor();
@@ -129,5 +129,15 @@ export declare class SquidService {
  * Returns a singleton instance of Squid service. Creates the service if needed.
  * Inherits code bundle info from the caller service: should only be called from the services within the same code
  * bundle (user code, connector, etc...).
+ * @deprecated: Use `squidInject`.
+ * This method will be removed in the future.
  */
-export declare function getSquidService<T extends SquidService>(ctor: new () => T, callerService: unknown): T;
+export declare function getSquidService<T extends SquidService>(ctor: new () => T, callerService?: unknown): T;
+/**
+ * Returns a singleton instance of Squid service. Creates the service if needed.
+ * This method can only be used after the Squid module is initialized:
+ *  not from the static context when the module is loading.
+ */
+export declare function squidInject<T extends SquidService>(ctor: new () => T, moduleId?: TenantModuleId): T;
+/** Returns the main Squid instance with the current backend configuration. */
+export declare function getSquid(): Squid;