@ductape/sdk 0.0.4-v55 → 0.0.4-v57

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ImportDocsTypes, IApp, IAppConstants, IAppEnv, IAppVariables, IAppWebhook, IAppWebhookEvent, ICreateAppBuilder, IProduct, IProductApp, IProductCache, IProductDatabase, IProductEnv, IProductJobs, IProductStorage, IActionProcessorInput, IProductMessageBroker, IProductNotification, INotificationProcessorInput, IProductNotificationTemplate, IStorageProcessorInput, IParsedSample, IRegisterWebhook, IGenerateWebhookLink, IAppAuth, IProductMessageBrokerTopic, IAppAction, LogQueryParams, IProductQuota, FetchRemoteCachePayload, IFileReadResult, IProductSession, IActionUpdate, IProductFallback, IFetchUsersPayload, IProductAppHealth, IActionDispatchInput, INotificationDispatchInput, IStorageDispatchInput, IPublishDispatchInput, IDispatchResult } from './types';
+import { ImportDocsTypes, IApp, IAppConstants, IAppEnv, IAppVariables, IAppWebhook, IAppWebhookEvent, ICreateAppBuilder, IProduct, IProductApp, IProductCache, IProductDatabase, IProductEnv, IProductJobs, IProductStorage, IActionProcessorInput, IProductMessageBroker, IProductNotification, INotificationProcessorInput, IProductNotificationTemplate, IStorageProcessorInput, IParsedSample, IRegisterWebhook, IGenerateWebhookLink, IAppAuth, IProductMessageBrokerTopic, IAppAction, LogQueryParams, IProductQuota, FetchRemoteCachePayload, IFileReadResult, IProductSession, IActionUpdate, IProductFallback, IFetchUsersPayload, IActionDispatchInput, INotificationDispatchInput, IStorageDispatchInput, IPublishDispatchInput, IDispatchResult, IDispatchSchedule } from './types';
 import { IDuctapeInit } from './types/index.types';
 import { PublicStates } from './types/enums';
 import { DatabaseService, IActionCreateOptions, IActionUpdateOptions, ISimpleSchemaDefinition, ISimpleCreateOptions, ISimpleDropOptions, ISimpleFieldDefinition, SimpleFieldType, ISimpleIndexOptions, ISchemaOperationResult, IIndexFieldDefinition, ITableSchema, IIndexInfo } from './database';
@@ -6,6 +6,7 @@ import { IConstraintDefinition as IMigrationConstraintDefinition } from './datab
 import { IDBActionDispatchInput } from './types/processor.types';
 import { GraphService } from './graph';
 import { WorkflowService } from './workflows';
+import { IHealthcheckDefineOptions, IDefinedHealthcheck, IQuotaDefineOptions, IDefinedQuota, IFallbackDefineOptions, IDefinedFallback } from './resilience';
 import { AgentsService } from './agents';
 import { ModelService } from './models';
 import { VectorDatabaseService } from './vector';
@@ -278,6 +279,9 @@ export default class Ductape implements IDuctape {
     private _cacheService;
     private _jobsService;
     private _secretsService;
+    private _quotaService;
+    private _fallbackService;
+    private _healthcheckService;
     private loggerService;
     private importService;
     private environment;
@@ -445,38 +449,6 @@ export default class Ductape implements IDuctape {
                  */
                 generateLink: (data: IGenerateWebhookLink) => Promise<string>;
             };
-            health: {
-                /**
-                 * Creates a health check for an app.
-                 * @param {string} product - The product tag.
-                 * @param {Partial<IProductAppHealth>} data - The health check data.
-                 * @returns {Promise<void>} Resolves when the health check is created. Throws on error.
-                 */
-                create: (product: string, data: Partial<IProductAppHealth>) => Promise<void>;
-                /**
-                 * Updates a health check by tag.
-                 * @param {string} product - The product tag.
-                 * @param {string} tag - The health check tag.
-                 * @param {Partial<IProductAppHealth>} data - The health check data to update.
-                 * @returns {Promise<void>} Resolves when the health check is updated. Throws on error.
-                 */
-                update: (product: string, tag: string, data: Partial<IProductAppHealth>) => Promise<void>;
-                /**
-                 * Fetches a health check by access tag and tag.
-                 * @param {string} product - The product tag.
-                 * @param {string} access_tag - The app access tag.
-                 * @param {string} tag - The health check tag.
-                 * @returns {Promise<IProductAppHealth|null>} The fetched health check, or null if not found.
-                 */
-                fetch: (product: string, access_tag: string, tag: string) => Promise<IProductAppHealth>;
-                /**
-                 * Fetches all health checks for an app by access tag.
-                 * @param {string} product - The product tag.
-                 * @param {string} access_tag - The app access tag.
-                 * @returns {Promise<IProductAppHealth[]>} The list of health checks.
-                 */
-                list: (product: string, access_tag: string) => Promise<IProductAppHealth[]>;
-            };
         };
     };
     /**
@@ -585,42 +557,54 @@ export default class Ductape implements IDuctape {
         }) => Promise<import("./sessions").IListSessionsResult>;
     };
     /**
-     * Quota-related operations for managing product quotas.
+     * Quota-related operations for managing product quotas with weighted distribution.
      */
     quota: {
+        /**
+         * Defines a quota using code-first API.
+         * @param {IQuotaDefineOptions} options - The quota definition options.
+         * @param {string} [options.product] - The product tag (if provided, registers immediately).
+         * @param {string} options.tag - The quota tag.
+         * @param {string} [options.name] - The quota name.
+         * @param {string} [options.description] - The quota description.
+         * @param {Object} [options.input] - The input schema definition.
+         * @param {Function} options.handler - The handler function to configure the quota.
+         * @returns {Promise<IDefinedQuota>} The defined quota.
+         */
+        define: (options: IQuotaDefineOptions) => Promise<IDefinedQuota>;
         /**
          * Creates a quota for a product.
          * @param {string} product - The product tag.
-         * @param {Partial<IProductQuota>} data - The quota data.
-         * @returns {Promise<void>} Resolves when the quota is created. Throws on error.
+         * @param {any} data - The quota data (schema or defined quota).
+         * @returns {Promise<any>} The created quota schema.
          */
-        create: (product: string, data: Partial<IProductQuota>) => Promise<void>;
+        create: (product: string, data: any) => Promise<IProductQuota>;
         /**
          * Fetches a quota by tag.
          * @param {string} product - The product tag.
          * @param {string} tag - The quota tag.
-         * @returns {IProductQuota|null} The fetched quota, or null if not found.
+         * @returns {Promise<any>} The fetched quota.
          */
         fetch: (product: string, tag: string) => Promise<IProductQuota>;
         /**
          * Fetches all quotas for a product.
          * @param {string} product - The product tag.
-         * @returns {IProductQuota[]} The list of quotas.
+         * @returns {Promise<any[]>} The list of quotas.
          */
         list: (product: string) => Promise<IProductQuota[]>;
         /**
          * Updates a quota by tag.
          * @param {string} product - The product tag.
          * @param {string} tag - The quota tag.
-         * @param {Partial<IProductQuota>} data - The quota data to update.
-         * @returns {Promise<void>} Resolves when the quota is updated. Throws on error.
+         * @param {any} data - The quota data to update.
+         * @returns {Promise<any>} The updated quota schema.
          */
-        update: (product: string, tag: string, data: Partial<IProductQuota>) => Promise<void>;
+        update: (product: string, tag: string, data: any) => Promise<void>;
         /**
          * Deletes a quota by tag.
          * @param {string} product - The product tag.
          * @param {string} tag - The quota tag.
-         * @returns {Promise<void>} Resolves when the quota is deleted. Throws on error.
+         * @returns {Promise<void>} Resolves when the quota is deleted.
          */
         delete: (product: string, tag: string) => Promise<void>;
         /**
@@ -637,45 +621,76 @@ export default class Ductape implements IDuctape {
             env: string;
             tag: string;
             input: Record<string, unknown>;
-        }) => Promise<unknown>;
+        }) => Promise<import("./resilience/quota.service").IQuotaRunResult<unknown>>;
+        /**
+         * Dispatches a quota for deferred execution.
+         * @param {Object} data - The quota dispatch input.
+         * @param {string} data.product - The product tag.
+         * @param {string} data.env - The environment slug.
+         * @param {string} data.tag - The quota tag.
+         * @param {Record<string, unknown>} data.input - The input data for the quota.
+         * @param {IDispatchSchedule} [data.schedule] - Optional schedule for deferred execution.
+         * @returns {Promise<{ jobId: string }>} The dispatch result with job ID.
+         */
+        dispatch: (data: {
+            product: string;
+            env: string;
+            tag: string;
+            input: Record<string, unknown>;
+            schedule?: IDispatchSchedule;
+        }) => Promise<{
+            jobId: string;
+        }>;
     };
     /**
-     * Fallback-related operations for managing product fallbacks.
+     * Fallback-related operations for managing product fallbacks with sequential failover.
      */
     fallback: {
+        /**
+         * Defines a fallback using code-first API.
+         * @param {IFallbackDefineOptions} options - The fallback definition options.
+         * @param {string} [options.product] - The product tag (if provided, registers immediately).
+         * @param {string} options.tag - The fallback tag.
+         * @param {string} [options.name] - The fallback name.
+         * @param {string} [options.description] - The fallback description.
+         * @param {Object} [options.input] - The input schema definition.
+         * @param {Function} options.handler - The handler function to configure the fallback.
+         * @returns {Promise<IDefinedFallback>} The defined fallback.
+         */
+        define: (options: IFallbackDefineOptions) => Promise<IDefinedFallback>;
         /**
          * Creates a fallback for a product.
          * @param {string} product - The product tag.
-         * @param {Partial<IProductFallback>} data - The fallback data.
-         * @returns {Promise<void>} Resolves when the fallback is created. Throws on error.
+         * @param {any} data - The fallback data (schema or defined fallback).
+         * @returns {Promise<any>} The created fallback schema.
          */
-        create: (product: string, data: Partial<IProductFallback>) => Promise<void>;
+        create: (product: string, data: any) => Promise<IProductFallback>;
         /**
          * Fetches a fallback by tag.
          * @param {string} product - The product tag.
          * @param {string} tag - The fallback tag.
-         * @returns {IProductFallback|null} The fetched fallback, or null if not found.
+         * @returns {Promise<any>} The fetched fallback.
          */
         fetch: (product: string, tag: string) => Promise<IProductFallback>;
         /**
          * Fetches all fallbacks for a product.
          * @param {string} product - The product tag.
-         * @returns {IProductFallback[]} The list of fallbacks.
+         * @returns {Promise<any[]>} The list of fallbacks.
          */
         list: (product: string) => Promise<IProductFallback[]>;
         /**
          * Updates a fallback by tag.
          * @param {string} product - The product tag.
          * @param {string} tag - The fallback tag.
-         * @param {Partial<IProductFallback>} data - The fallback data to update.
-         * @returns {Promise<void>} Resolves when the fallback is updated. Throws on error.
+         * @param {any} data - The fallback data to update.
+         * @returns {Promise<any>} The updated fallback schema.
          */
-        update: (product: string, tag: string, data: Partial<IProductFallback>) => Promise<void>;
+        update: (product: string, tag: string, data: any) => Promise<void>;
         /**
          * Deletes a fallback by tag.
          * @param {string} product - The product tag.
          * @param {string} tag - The fallback tag.
-         * @returns {Promise<void>} Resolves when the fallback is deleted. Throws on error.
+         * @returns {Promise<void>} Resolves when the fallback is deleted.
          */
         delete: (product: string, tag: string) => Promise<void>;
         /**
@@ -692,7 +707,116 @@ export default class Ductape implements IDuctape {
             env: string;
             tag: string;
             input: Record<string, unknown>;
-        }) => Promise<unknown>;
+        }) => Promise<import("./resilience/fallback.service").IFallbackRunResult<unknown>>;
+        /**
+         * Dispatches a fallback for deferred execution.
+         * @param {Object} data - The fallback dispatch input.
+         * @param {string} data.product - The product tag.
+         * @param {string} data.env - The environment slug.
+         * @param {string} data.tag - The fallback tag.
+         * @param {Record<string, unknown>} data.input - The input data for the fallback.
+         * @param {IDispatchSchedule} [data.schedule] - Optional schedule for deferred execution.
+         * @returns {Promise<{ jobId: string }>} The dispatch result with job ID.
+         */
+        dispatch: (data: {
+            product: string;
+            env: string;
+            tag: string;
+            input: Record<string, unknown>;
+            schedule?: IDispatchSchedule;
+        }) => Promise<{
+            jobId: string;
+        }>;
+    };
+    /**
+     * Healthcheck-related operations for managing product healthchecks.
+     */
+    health: {
+        /**
+         * Defines a healthcheck using code-first API.
+         * @param {IHealthcheckDefineOptions} options - The healthcheck definition options.
+         * @param {string} [options.product] - The product tag (if provided, registers immediately).
+         * @param {string} options.tag - The healthcheck tag.
+         * @param {string} [options.name] - The healthcheck name.
+         * @param {string} [options.description] - The healthcheck description.
+         * @param {Function} options.handler - The handler function to configure the healthcheck.
+         * @returns {Promise<IDefinedHealthcheck>} The defined healthcheck.
+         */
+        define: (options: IHealthcheckDefineOptions) => Promise<IDefinedHealthcheck>;
+        /**
+         * Creates a healthcheck for a product.
+         * @param {string} product - The product tag.
+         * @param {Object} data - The healthcheck data (schema or defined healthcheck).
+         * @returns {Promise<IHealthcheckSchema>} The created healthcheck schema.
+         */
+        create: (product: string, data: any) => Promise<import("./resilience").IHealthcheckSchema>;
+        /**
+         * Fetches a healthcheck by tag.
+         * @param {string} product - The product tag.
+         * @param {string} tag - The healthcheck tag.
+         * @returns {Promise<IHealthcheckSchema>} The fetched healthcheck.
+         */
+        fetch: (product: string, tag: string) => Promise<import("./resilience").IHealthcheckSchema>;
+        /**
+         * Fetches all healthchecks for a product.
+         * @param {string} product - The product tag.
+         * @returns {Promise<IHealthcheckSchema[]>} The list of healthchecks.
+         */
+        list: (product: string) => Promise<import("./resilience").IHealthcheckSchema[]>;
+        /**
+         * Updates a healthcheck by tag.
+         * @param {string} product - The product tag.
+         * @param {string} tag - The healthcheck tag.
+         * @param {Object} data - The healthcheck data to update.
+         * @returns {Promise<IHealthcheckSchema>} The updated healthcheck schema.
+         */
+        update: (product: string, tag: string, data: any) => Promise<import("./resilience").IHealthcheckSchema>;
+        /**
+         * Deletes a healthcheck by tag.
+         * @param {string} product - The product tag.
+         * @param {string} tag - The healthcheck tag.
+         * @returns {Promise<void>} Resolves when the healthcheck is deleted.
+         */
+        delete: (product: string, tag: string) => Promise<void>;
+        /**
+         * Gets the current status of a healthcheck.
+         * @param {Object} options - The status check options.
+         * @param {string} options.product - The product tag.
+         * @param {string} options.env - The environment slug.
+         * @param {string} options.tag - The healthcheck tag.
+         * @returns {Promise<IHealthcheckStatus>} The healthcheck status.
+         */
+        status: (options: {
+            product: string;
+            env: string;
+            tag: string;
+        }) => Promise<import("./resilience").IHealthcheckStatus>;
+        /**
+         * Manually triggers a healthcheck run.
+         * @param {Object} options - The run options.
+         * @param {string} options.product - The product tag.
+         * @param {string} options.env - The environment slug.
+         * @param {string} options.tag - The healthcheck tag.
+         * @returns {Promise<IHealthcheckRunResult>} The result of the healthcheck run.
+         */
+        run: (options: {
+            product: string;
+            env: string;
+            tag: string;
+        }) => Promise<import("./resilience").IHealthcheckRunResult>;
+        /**
+         * Checks the health of a service (alias for status).
+         * @param {Object} options - The check options.
+         * @param {string} options.product - The product tag.
+         * @param {string} options.env - The environment slug.
+         * @param {string} options.tag - The healthcheck tag.
+         * @returns {Promise<IHealthcheckStatus>} The healthcheck status.
+         */
+        check: (options: {
+            product: string;
+            env: string;
+            tag: string;
+        }) => Promise<import("./resilience").IHealthcheckStatus>;
     };
     /**
      * Storage-related operations for managing product storages.
@@ -1417,9 +1541,364 @@ export default class Ductape implements IDuctape {
      */
     graph: {
         /**
-         * Get the underlying GraphService instance
+         * Get the underlying GraphService instance for advanced operations.
+         * @returns {Promise<GraphService>} The graph service instance.
          */
         getService: () => Promise<GraphService>;
+        /**
+         * Creates a graph configuration for a product.
+         * @param {any} graphConfig - The graph configuration.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<void>} Resolves when the graph is created.
+         */
+        create: (graphConfig: any, productTag?: string) => Promise<void>;
+        /**
+         * Fetches a graph configuration by tag.
+         * @param {string} graphTag - The graph tag.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<any>} The fetched graph configuration.
+         */
+        fetch: (graphTag: string, productTag?: string) => Promise<import("./graph").IGraphConfig>;
+        /**
+         * Fetches all graph configurations for a product.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<any[]>} The list of graph configurations.
+         */
+        list: (productTag?: string) => Promise<import("./graph").IGraphConfig[]>;
+        /**
+         * Updates a graph configuration by tag.
+         * @param {string} graphTag - The graph tag.
+         * @param {any} updates - The updates to apply.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<void>} Resolves when the graph is updated.
+         */
+        update: (graphTag: string, updates: any, productTag?: string) => Promise<void>;
+        /**
+         * Deletes a graph configuration by tag.
+         * @param {string} graphTag - The graph tag.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<void>} Resolves when the graph is deleted.
+         */
+        delete: (graphTag: string, productTag?: string) => Promise<void>;
+        /**
+         * Connects to a graph database.
+         * @param {any} config - The connection configuration.
+         * @returns {Promise<any>} The connection result.
+         */
+        connect: (config: any) => Promise<import("./graph").IGraphConnectionResult>;
+        /**
+         * Disconnects from the current graph database.
+         * @returns {Promise<void>} Resolves when disconnected.
+         */
+        disconnect: () => Promise<void>;
+        /**
+         * Closes all graph database connections.
+         * @returns {Promise<void>} Resolves when all connections are closed.
+         */
+        closeAll: () => Promise<void>;
+        /**
+         * Tests a connection to a graph database without persisting.
+         * @param {any} config - The connection configuration.
+         * @returns {Promise<any>} The test connection result.
+         */
+        testConnection: (config: any) => Promise<import("./graph").IGraphTestConnectionResult>;
+        /**
+         * Creates a node in the graph.
+         * @param {any} options - The node creation options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The created node result.
+         */
+        createNode: (options: any, transaction?: any) => Promise<import("./graph").ICreateNodeResult<any>>;
+        /**
+         * Finds nodes by criteria.
+         * @param {any} options - The find options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The found nodes result.
+         */
+        findNodes: (options: any, transaction?: any) => Promise<import("./graph").IFindNodesResult<any>>;
+        /**
+         * Finds a node by ID.
+         * @param {string | number} id - The node ID.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The found node or null.
+         */
+        findNodeById: (id: string | number, transaction?: any) => Promise<import("./graph").INode<any>>;
+        /**
+         * Updates a node.
+         * @param {any} options - The update options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The updated node result.
+         */
+        updateNode: (options: any, transaction?: any) => Promise<import("./graph").IUpdateNodeResult<any>>;
+        /**
+         * Deletes a node.
+         * @param {any} options - The delete options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The delete result.
+         */
+        deleteNode: (options: any, transaction?: any) => Promise<import("./graph").IDeleteNodeResult>;
+        /**
+         * Merges a node (create or update).
+         * @param {any} options - The merge options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The merge result.
+         */
+        mergeNode: (options: any, transaction?: any) => Promise<import("./graph").IMergeNodeResult<any>>;
+        /**
+         * Adds labels to an existing node.
+         * @param {any} options - The add labels options (id, labels).
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The result with added labels.
+         */
+        addLabels: (options: any, transaction?: any) => Promise<import("./graph").IAddLabelsResult<any>>;
+        /**
+         * Removes labels from an existing node.
+         * @param {any} options - The remove labels options (id, labels).
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The result with removed labels.
+         */
+        removeLabels: (options: any, transaction?: any) => Promise<import("./graph").IRemoveLabelsResult<any>>;
+        /**
+         * Sets labels on a node (replaces all existing labels).
+         * @param {any} options - The set labels options (id, labels).
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The result with previous and new labels.
+         */
+        setLabels: (options: any, transaction?: any) => Promise<import("./graph").ISetLabelsResult<any>>;
+        /**
+         * Creates a relationship between nodes.
+         * @param {any} options - The relationship creation options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The created relationship result.
+         */
+        createRelationship: (options: any, transaction?: any) => Promise<import("./graph").ICreateRelationshipResult<any>>;
+        /**
+         * Finds relationships by criteria.
+         * @param {any} options - The find options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The found relationships result.
+         */
+        findRelationships: (options: any, transaction?: any) => Promise<import("./graph").IFindRelationshipsResult<any>>;
+        /**
+         * Finds a relationship by ID.
+         * @param {string | number} id - The relationship ID.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The found relationship or null.
+         */
+        findRelationshipById: (id: string | number, transaction?: any) => Promise<import("./graph").IRelationship<any>>;
+        /**
+         * Updates a relationship.
+         * @param {any} options - The update options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The updated relationship result.
+         */
+        updateRelationship: (options: any, transaction?: any) => Promise<import("./graph").IUpdateRelationshipResult<any>>;
+        /**
+         * Deletes a relationship.
+         * @param {any} options - The delete options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The delete result.
+         */
+        deleteRelationship: (options: any, transaction?: any) => Promise<import("./graph").IDeleteRelationshipResult>;
+        /**
+         * Merges a relationship (create or update).
+         * @param {any} options - The merge options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The merge result.
+         */
+        mergeRelationship: (options: any, transaction?: any) => Promise<import("./graph").IMergeRelationshipResult<any>>;
+        /**
+         * Traverses the graph from a starting node.
+         * @param {any} options - The traversal options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The traversal result.
+         */
+        traverse: (options: any, transaction?: any) => Promise<import("./graph").ITraverseResult<any, any>>;
+        /**
+         * Finds the shortest path between two nodes.
+         * @param {any} options - The shortest path options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The shortest path result.
+         */
+        shortestPath: (options: any, transaction?: any) => Promise<import("./graph").IShortestPathResult<any, any>>;
+        /**
+         * Finds all paths between two nodes.
+         * @param {any} options - The all paths options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The all paths result.
+         */
+        allPaths: (options: any, transaction?: any) => Promise<import("./graph").IAllPathsResult<any, any>>;
+        /**
+         * Gets the neighborhood of a node.
+         * @param {any} options - The neighborhood options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The neighborhood result.
+         */
+        getNeighborhood: (options: any, transaction?: any) => Promise<import("./graph").INeighborhoodResult<any, any>>;
+        /**
+         * Finds connected components in the graph.
+         * @param {any} options - The connected components options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The connected components result.
+         */
+        findConnectedComponents: (options: any, transaction?: any) => Promise<import("./graph").IConnectedComponentsResult<any>>;
+        /**
+         * Executes a raw Cypher query against the graph database.
+         * @param {string} query - The Cypher query string.
+         * @param {Record<string, any>} [params] - Query parameters.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The query result.
+         */
+        query: (query: string, params?: Record<string, any>, transaction?: any) => Promise<import("./graph").IRawQueryResult<any>>;
+        /**
+         * Gets graph statistics.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The graph statistics.
+         */
+        getStatistics: (transaction?: any) => Promise<import("./graph").IGraphStatistics>;
+        /**
+         * Counts nodes matching criteria.
+         * @param {string[]} [labels] - Node labels to filter by.
+         * @param {any} [where] - Where clause for filtering.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The count result.
+         */
+        countNodes: (labels?: string[], where?: any, transaction?: any) => Promise<import("./graph").ICountNodesResult>;
+        /**
+         * Counts relationships matching criteria.
+         * @param {string[]} [types] - Relationship types to filter by.
+         * @param {any} [where] - Where clause for filtering.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The count result.
+         */
+        countRelationships: (types?: string[], where?: any, transaction?: any) => Promise<import("./graph").ICountRelationshipsResult>;
+        /**
+         * Performs full-text search.
+         * @param {any} options - The search options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The search result.
+         */
+        fullTextSearch: (options: any, transaction?: any) => Promise<import("./graph").IFullTextSearchResult<any>>;
+        /**
+         * Performs vector similarity search.
+         * @param {any} options - The search options.
+         * @param {any} [transaction] - Optional transaction.
+         * @returns {Promise<any>} The search result.
+         */
+        vectorSearch: (options: any, transaction?: any) => Promise<import("./graph").IVectorSearchResult<any>>;
+        /**
+         * Creates a node index.
+         * @param {any} options - The index creation options.
+         * @returns {Promise<any>} The index creation result.
+         */
+        createNodeIndex: (options: any) => Promise<import("./graph").ICreateIndexResult>;
+        /**
+         * Creates a node constraint.
+         * @param {any} options - The constraint creation options.
+         * @returns {Promise<any>} The constraint creation result.
+         */
+        createNodeConstraint: (options: any) => Promise<import("./graph").ICreateConstraintResult>;
+        /**
+         * Creates a relationship index.
+         * @param {any} options - The index creation options.
+         * @returns {Promise<any>} The index creation result.
+         */
+        createRelationshipIndex: (options: any) => Promise<import("./graph").ICreateIndexResult>;
+        /**
+         * Lists all indexes.
+         * @returns {Promise<any>} The list of indexes.
+         */
+        listIndexes: () => Promise<import("./graph").IListIndexesResult>;
+        /**
+         * Lists all constraints.
+         * @returns {Promise<any>} The list of constraints.
+         */
+        listConstraints: () => Promise<import("./graph").IListConstraintsResult>;
+        /**
+         * Drops an index by name.
+         * @param {string} name - The index name.
+         * @returns {Promise<any>} The drop result.
+         */
+        dropIndex: (name: string) => Promise<import("./graph").IDropIndexResult>;
+        /**
+         * Drops a constraint by name.
+         * @param {string} name - The constraint name.
+         * @returns {Promise<any>} The drop result.
+         */
+        dropConstraint: (name: string) => Promise<import("./graph").IDropConstraintResult>;
+        /**
+         * Lists all node labels.
+         * @returns {Promise<any>} The list of labels.
+         */
+        listLabels: () => Promise<import("./graph").IListLabelsResult>;
+        /**
+         * Lists all relationship types.
+         * @returns {Promise<any>} The list of relationship types.
+         */
+        listRelationshipTypes: () => Promise<import("./graph").IListRelationshipTypesResult>;
+        /**
+         * Creates a graph action.
+         * @param {any} options - The action creation options.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<any>} The created action.
+         */
+        createAction: (options: any, productTag?: string) => Promise<import("./graph").IGraphAction>;
+        /**
+         * Lists graph actions.
+         * @param {string} [graphTag] - The graph tag.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<any>} The list of actions.
+         */
+        listActions: (graphTag?: string, productTag?: string) => Promise<import("./graph").IListGraphActionsResult>;
+        /**
+         * Gets a graph action by tag.
+         * @param {string} actionTag - The action tag.
+         * @param {string} [graphTag] - The graph tag.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<any>} The action or null.
+         */
+        getAction: (actionTag: string, graphTag?: string, productTag?: string) => Promise<import("./graph").IGraphAction>;
+        /**
+         * Updates a graph action.
+         * @param {string} actionTag - The action tag.
+         * @param {any} updates - The updates to apply.
+         * @param {string} [graphTag] - The graph tag.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<any>} The updated action.
+         */
+        updateAction: (actionTag: string, updates: any, graphTag?: string, productTag?: string) => Promise<import("./graph").IGraphAction>;
+        /**
+         * Deletes a graph action.
+         * @param {string} actionTag - The action tag.
+         * @param {string} [graphTag] - The graph tag.
+         * @param {string} [productTag] - The product tag.
+         * @returns {Promise<void>} Resolves when the action is deleted.
+         */
+        deleteAction: (actionTag: string, graphTag?: string, productTag?: string) => Promise<void>;
+        /**
+         * Begins a new transaction.
+         * @param {any} [options] - Transaction options.
+         * @returns {Promise<any>} The transaction object.
+         */
+        beginTransaction: (options?: any) => Promise<import("./graph").IGraphTransaction>;
+        /**
+         * Commits a transaction.
+         * @param {any} transaction - The transaction to commit.
+         * @returns {Promise<void>} Resolves when committed.
+         */
+        commitTransaction: (transaction: any) => Promise<void>;
+        /**
+         * Rolls back a transaction.
+         * @param {any} transaction - The transaction to rollback.
+         * @returns {Promise<void>} Resolves when rolled back.
+         */
+        rollbackTransaction: (transaction: any) => Promise<void>;
+        /**
+         * Dispatches a graph operation for deferred execution.
+         * @param {any} data - The dispatch input.
+         * @returns {Promise<any>} The dispatch result.
+         */
+        dispatch: (data: any) => Promise<IDispatchResult>;
     };
     /**
      * Workflow service for building and executing durable workflows.
@@ -2450,14 +2929,19 @@ export default class Ductape implements IDuctape {
     private createNewBrokersService;
     /**
      * Create a new QuotaService instance with authenticated config
-     * @returns QuotaService instance
+     * @returns QuotaService instance (cached)
      */
     private createNewQuotaService;
     /**
      * Create a new FallbackService instance with authenticated config
-     * @returns FallbackService instance
+     * @returns FallbackService instance (cached)
      */
     private createNewFallbackService;
+    /**
+     * Create a new HealthcheckService instance with authenticated config
+     * @returns HealthcheckService instance (cached)
+     */
+    private createNewHealthcheckService;
     private fetchSession;
     private validateWorkspace;
     private createNewAppBuilderSession;