@memberjunction/core-actions 2.106.0 → 2.107.0

package/dist/custom/files/list-storage-providers.action.js

@@ -0,0 +1,175 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadListStorageProvidersAction = exports.ListStorageProvidersAction = void 0;
+const global_1 = require("@memberjunction/global");
+const global_2 = require("@memberjunction/global");
+const core_1 = require("@memberjunction/core");
+const storage_1 = require("@memberjunction/storage");
+const base_file_storage_action_1 = require("./base-file-storage.action");
+/**
+ * Action that retrieves a list of active and available file storage providers.
+ *
+ * This action returns storage providers that are:
+ * 1. Marked as IsActive=true in the database
+ * 2. Actually available/configured in the running environment
+ *
+ * This is useful for AI agents (particularly Research Agent) to discover
+ * what storage providers are available before attempting to search or access files.
+ *
+ * Providers are configured in the File Storage Providers entity and can include:
+ * - Google Drive
+ * - SharePoint
+ * - Dropbox
+ * - Box
+ * - AWS S3
+ * - Azure Blob Storage
+ * - Google Cloud Storage
+ *
+ * @example
+ * ```typescript
+ * // Get all available storage providers
+ * await runAction({
+ *   ActionName: 'List Storage Providers',
+ *   Params: []
+ * });
+ *
+ * // Get only providers that support search
+ * await runAction({
+ *   ActionName: 'List Storage Providers',
+ *   Params: [{
+ *     Name: 'SearchSupportedOnly',
+ *     Value: true
+ *   }]
+ * });
+ * ```
+ */
+let ListStorageProvidersAction = class ListStorageProvidersAction extends base_file_storage_action_1.BaseFileStorageAction {
+    /**
+     * List of storage provider driver keys that support native file search.
+     * Used to populate the SupportsSearch field in results.
+     */
+    SEARCH_SUPPORTED_PROVIDERS = [
+        'Google Drive Storage',
+        'SharePoint Storage',
+        'Dropbox Storage',
+        'Box Storage'
+    ];
+    async InternalRunAction(params) {
+        // Optional parameter to filter only providers that support search
+        const searchSupportedOnly = this.getBooleanParam(params, "searchsupportedonly", false);
+        try {
+            // Query for active file storage providers from database
+            const rv = new core_1.RunView();
+            const result = await rv.RunView({
+                EntityName: 'File Storage Providers',
+                ExtraFilter: "IsActive=1",
+                OrderBy: 'Priority, Name',
+                ResultType: 'entity_object'
+            }, params.ContextUser);
+            if (!result.Success) {
+                return this.createErrorResult(`Failed to retrieve storage providers: ${result.ErrorMessage}`, "QUERY_FAILED");
+            }
+            const dbProviders = result.Results || [];
+            const availableProviders = [];
+            // Check which providers are actually available in the running environment
+            for (const provider of dbProviders) {
+                const supportsSearch = this.SEARCH_SUPPORTED_PROVIDERS.includes(provider.ServerDriverKey);
+                // Skip if filtering for search-only and this provider doesn't support it
+                if (searchSupportedOnly && !supportsSearch) {
+                    continue;
+                }
+                try {
+                    // Instantiate the provider and check if it's properly configured
+                    const driver = global_2.MJGlobal.Instance.ClassFactory.CreateInstance(storage_1.FileStorageBase, provider.ServerDriverKey);
+                    if (driver) {
+                        // Provider is registered - check if it has required configuration
+                        const isConfigured = driver.IsConfigured;
+                        availableProviders.push({
+                            Name: provider.Name,
+                            Description: provider.Description || '',
+                            ServerDriverKey: provider.ServerDriverKey,
+                            SupportsSearch: supportsSearch,
+                            IsConfigured: isConfigured,
+                            ConfigurationError: isConfigured ? undefined : 'Missing required configuration (API keys, credentials, etc.)'
+                        });
+                    }
+                    else {
+                        // Provider exists in DB but not registered in class factory
+                        availableProviders.push({
+                            Name: provider.Name,
+                            Description: provider.Description || '',
+                            ServerDriverKey: provider.ServerDriverKey,
+                            SupportsSearch: supportsSearch,
+                            IsConfigured: false,
+                            ConfigurationError: 'Provider not registered in class factory'
+                        });
+                    }
+                }
+                catch (error) {
+                    // Provider exists in DB but failed to instantiate
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    availableProviders.push({
+                        Name: provider.Name,
+                        Description: provider.Description || '',
+                        ServerDriverKey: provider.ServerDriverKey,
+                        SupportsSearch: supportsSearch,
+                        IsConfigured: false,
+                        ConfigurationError: `Instantiation failed: ${errorMessage}`
+                    });
+                }
+            }
+            // Calculate counts
+            const configuredProviders = availableProviders.filter(p => p.IsConfigured);
+            const searchSupportedCount = configuredProviders.filter(p => p.SupportsSearch).length;
+            const totalCount = availableProviders.length;
+            const configuredCount = configuredProviders.length;
+            // Create detailed result message
+            let message = `Found ${totalCount} active storage provider(s) in database`;
+            if (configuredCount < totalCount) {
+                message += `, ${configuredCount} configured and available`;
+            }
+            else {
+                message += `, all configured and available`;
+            }
+            if (searchSupportedOnly) {
+                message += ` with search support`;
+            }
+            else {
+                message += ` (${searchSupportedCount} support search)`;
+            }
+            // Return results
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: message,
+                Providers: availableProviders,
+                TotalCount: totalCount,
+                ConfiguredCount: configuredCount,
+                SearchSupportedCount: searchSupportedCount
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return this.createErrorResult(`Failed to list storage providers: ${errorMessage}`, "LIST_FAILED");
+        }
+    }
+};
+exports.ListStorageProvidersAction = ListStorageProvidersAction;
+exports.ListStorageProvidersAction = ListStorageProvidersAction = __decorate([
+    (0, global_1.RegisterClass)(base_file_storage_action_1.BaseFileStorageAction, "List Storage Providers")
+], ListStorageProvidersAction);
+/**
+ * Load function to ensure the class is registered and not tree-shaken
+ */
+function LoadListStorageProvidersAction() {
+    // This function call ensures the class decorator executes
+    global_2.MJGlobal.Instance.ClassFactory.GetRegistration(base_file_storage_action_1.BaseFileStorageAction, "List Storage Providers");
+}
+exports.LoadListStorageProvidersAction = LoadListStorageProvidersAction;
+//# sourceMappingURL=list-storage-providers.action.js.map

package/dist/custom/files/list-storage-providers.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-storage-providers.action.js","sourceRoot":"","sources":["../../../src/custom/files/list-storage-providers.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/files/search-storage-files.action.d.ts

@@ -0,0 +1,61 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseFileStorageAction } from "./base-file-storage.action";
+/**
+ * Action that searches for files across configured storage providers
+ * using each provider's native search capabilities.
+ *
+ * This action leverages MJStorage's SearchFiles method which uses:
+ * - Google Drive: Drive API search with content indexing
+ * - SharePoint: Microsoft Graph Search with KQL queries
+ * - Dropbox: Search API v2 with filename and content search
+ * - Box: Box Search API with Boolean operators
+ *
+ * Providers without native search (AWS S3, Azure Blob, GCS) will return errors.
+ *
+ * @example
+ * ```typescript
+ * // Basic file search
+ * await runAction({
+ *   ActionName: 'Search Storage Files',
+ *   Params: [{
+ *     Name: 'Query',
+ *     Value: 'quarterly report'
+ *   }, {
+ *     Name: 'StorageProvider',
+ *     Value: 'Google Drive - Marketing'
+ *   }]
+ * });
+ *
+ * // Advanced search with filters
+ * await runAction({
+ *   ActionName: 'Search Storage Files',
+ *   Params: [{
+ *     Name: 'Query',
+ *     Value: 'budget 2024'
+ *   }, {
+ *     Name: 'StorageProvider',
+ *     Value: 'SharePoint - Finance'
+ *   }, {
+ *     Name: 'FileTypes',
+ *     Value: 'pdf,xlsx'
+ *   }, {
+ *     Name: 'PathPrefix',
+ *     Value: 'documents/finance'
+ *   }, {
+ *     Name: 'SearchContent',
+ *     Value: true
+ *   }, {
+ *     Name: 'MaxResults',
+ *     Value: 50
+ *   }]
+ * });
+ * ```
+ */
+export declare class SearchStorageFilesAction extends BaseFileStorageAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+/**
+ * Load function to ensure the class is registered and not tree-shaken
+ */
+export declare function LoadSearchStorageFilesAction(): void;
+//# sourceMappingURL=search-storage-files.action.d.ts.map

package/dist/custom/files/search-storage-files.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-storage-files.action.d.ts","sourceRoot":"","sources":["../../../src/custom/files/search-storage-files.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBACa,wBAAyB,SAAQ,qBAAqB;cAE/C,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAkI1F;AAED;;GAEG;AACH,wBAAgB,4BAA4B,SAG3C"}

package/dist/custom/files/search-storage-files.action.js

@@ -0,0 +1,183 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadSearchStorageFilesAction = exports.SearchStorageFilesAction = void 0;
+const global_1 = require("@memberjunction/global");
+const global_2 = require("@memberjunction/global");
+const storage_1 = require("@memberjunction/storage");
+const base_file_storage_action_1 = require("./base-file-storage.action");
+/**
+ * Action that searches for files across configured storage providers
+ * using each provider's native search capabilities.
+ *
+ * This action leverages MJStorage's SearchFiles method which uses:
+ * - Google Drive: Drive API search with content indexing
+ * - SharePoint: Microsoft Graph Search with KQL queries
+ * - Dropbox: Search API v2 with filename and content search
+ * - Box: Box Search API with Boolean operators
+ *
+ * Providers without native search (AWS S3, Azure Blob, GCS) will return errors.
+ *
+ * @example
+ * ```typescript
+ * // Basic file search
+ * await runAction({
+ *   ActionName: 'Search Storage Files',
+ *   Params: [{
+ *     Name: 'Query',
+ *     Value: 'quarterly report'
+ *   }, {
+ *     Name: 'StorageProvider',
+ *     Value: 'Google Drive - Marketing'
+ *   }]
+ * });
+ *
+ * // Advanced search with filters
+ * await runAction({
+ *   ActionName: 'Search Storage Files',
+ *   Params: [{
+ *     Name: 'Query',
+ *     Value: 'budget 2024'
+ *   }, {
+ *     Name: 'StorageProvider',
+ *     Value: 'SharePoint - Finance'
+ *   }, {
+ *     Name: 'FileTypes',
+ *     Value: 'pdf,xlsx'
+ *   }, {
+ *     Name: 'PathPrefix',
+ *     Value: 'documents/finance'
+ *   }, {
+ *     Name: 'SearchContent',
+ *     Value: true
+ *   }, {
+ *     Name: 'MaxResults',
+ *     Value: 50
+ *   }]
+ * });
+ * ```
+ */
+let SearchStorageFilesAction = class SearchStorageFilesAction extends base_file_storage_action_1.BaseFileStorageAction {
+    async InternalRunAction(params) {
+        // Required parameters
+        const query = this.getStringParam(params, "query");
+        if (!query) {
+            return this.createErrorResult("Query parameter is required", "MISSING_QUERY");
+        }
+        // Get storage driver (uses StorageProvider parameter via base class)
+        const { driver, error } = await this.getDriverFromParams(params);
+        if (error) {
+            return error;
+        }
+        // Optional parameters
+        const maxResults = this.getNumericParam(params, "maxresults", 100);
+        const pathPrefix = this.getStringParam(params, "pathprefix");
+        const searchContent = this.getBooleanParam(params, "searchcontent", false);
+        const modifiedAfterStr = this.getStringParam(params, "modifiedafter");
+        const modifiedBeforeStr = this.getStringParam(params, "modifiedbefore");
+        // Parse file types (comma-separated)
+        const fileTypesParam = this.getStringParam(params, "filetypes");
+        const fileTypes = fileTypesParam
+            ? fileTypesParam.split(',').map(ft => ft.trim()).filter(ft => ft.length > 0)
+            : undefined;
+        // Parse dates
+        let modifiedAfter;
+        let modifiedBefore;
+        if (modifiedAfterStr) {
+            const date = new Date(modifiedAfterStr);
+            if (!isNaN(date.getTime())) {
+                modifiedAfter = date;
+            }
+            else {
+                return this.createErrorResult(`Invalid ModifiedAfter date format: ${modifiedAfterStr}. Use ISO 8601 format (e.g., '2024-01-01')`, "INVALID_DATE_FORMAT");
+            }
+        }
+        if (modifiedBeforeStr) {
+            const date = new Date(modifiedBeforeStr);
+            if (!isNaN(date.getTime())) {
+                modifiedBefore = date;
+            }
+            else {
+                return this.createErrorResult(`Invalid ModifiedBefore date format: ${modifiedBeforeStr}. Use ISO 8601 format (e.g., '2024-12-31')`, "INVALID_DATE_FORMAT");
+            }
+        }
+        try {
+            // Build search options
+            const searchOptions = {
+                maxResults,
+                searchContent
+            };
+            if (fileTypes) {
+                searchOptions.fileTypes = fileTypes;
+            }
+            if (pathPrefix) {
+                searchOptions.pathPrefix = pathPrefix;
+            }
+            if (modifiedAfter) {
+                searchOptions.modifiedAfter = modifiedAfter;
+            }
+            if (modifiedBefore) {
+                searchOptions.modifiedBefore = modifiedBefore;
+            }
+            // Perform the search
+            const searchResults = await driver.SearchFiles(query, searchOptions);
+            // Format results for output
+            const formattedResults = searchResults.results.map((file) => ({
+                Path: file.path,
+                Name: file.name,
+                Size: file.size,
+                ContentType: file.contentType,
+                LastModified: file.lastModified.toISOString(),
+                Relevance: file.relevance,
+                Excerpt: file.excerpt,
+                MatchInFilename: file.matchInFilename,
+                CustomMetadata: file.customMetadata,
+                ProviderData: file.providerData
+            }));
+            // Create success result with detailed information
+            const resultData = {
+                SearchResults: formattedResults,
+                ResultCount: searchResults.results.length,
+                TotalMatches: searchResults.totalMatches,
+                HasMore: searchResults.hasMore,
+                NextPageToken: searchResults.nextPageToken,
+                Query: query,
+                SearchOptions: searchOptions
+            };
+            return {
+                Success: true,
+                ResultCode: "SUCCESS",
+                Message: `Found ${searchResults.results.length} file(s) matching query '${query}'`,
+                // Store detailed results in message as JSON for now (ActionResultSimple doesn't have Results property)
+                ...resultData
+            };
+        }
+        catch (error) {
+            // Handle specific error types
+            if (error instanceof storage_1.UnsupportedOperationError) {
+                return this.createErrorResult(`Storage provider does not support file search. Providers with search support: Google Drive, SharePoint, Dropbox, Box. Consider using a different provider or List Objects action with filtering.`, "SEARCH_NOT_SUPPORTED");
+            }
+            // Handle other errors
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return this.createErrorResult(`Search failed: ${errorMessage}`, "SEARCH_FAILED");
+        }
+    }
+};
+exports.SearchStorageFilesAction = SearchStorageFilesAction;
+exports.SearchStorageFilesAction = SearchStorageFilesAction = __decorate([
+    (0, global_1.RegisterClass)(base_file_storage_action_1.BaseFileStorageAction, "Search Storage Files")
+], SearchStorageFilesAction);
+/**
+ * Load function to ensure the class is registered and not tree-shaken
+ */
+function LoadSearchStorageFilesAction() {
+    // This function call ensures the class decorator executes
+    global_2.MJGlobal.Instance.ClassFactory.GetRegistration(base_file_storage_action_1.BaseFileStorageAction, "Search Storage Files");
+}
+exports.LoadSearchStorageFilesAction = LoadSearchStorageFilesAction;
+//# sourceMappingURL=search-storage-files.action.js.map

package/dist/custom/files/search-storage-files.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-storage-files.action.js","sourceRoot":"","sources":["../../../src/custom/files/search-storage-files.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/web/google-custom-search.action.d.ts

@@ -0,0 +1,55 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that performs web search using the Google Custom Search JSON API
+ * and returns structured results.
+ *
+ * @example
+ * ```typescript
+ * // Basic Google search
+ * await runAction({
+ *   ActionName: 'Google Custom Search',
+ *   Params: [{
+ *     Name: 'Query',
+ *     Value: 'latest trends in renewable energy'
+ *   }]
+ * });
+ *
+ * // Search with additional options
+ * await runAction({
+ *   ActionName: 'Google Custom Search',
+ *   Params: [{
+ *     Name: 'Query',
+ *     Value: 'AI regulation whitepapers'
+ *   }, {
+ *     Name: 'MaxResults',
+ *     Value: 5
+ *   }, {
+ *     Name: 'SafeSearch',
+ *     Value: 'high'
+ *   }, {
+ *     Name: 'SiteSearch',
+ *     Value: 'europa.eu'
+ *   }]
+ * });
+ * ```
+ */
+export declare class GoogleCustomSearchAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private transformItem;
+    private extractFirstString;
+    private normalizeSafeSearch;
+    private normalizeSiteSearchFilter;
+    private normalizeLanguageRestriction;
+    private normalizeSearchType;
+    private clamp;
+    private getStringParam;
+    private getNumericParam;
+    private addOutputParam;
+    private createErrorResult;
+}
+/**
+ * Loader function to ensure the GoogleCustomSearchAction class is included in the bundle.
+ */
+export declare function LoadGoogleCustomSearchAction(): void;
+//# sourceMappingURL=google-custom-search.action.d.ts.map

package/dist/custom/web/google-custom-search.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-custom-search.action.d.ts","sourceRoot":"","sources":["../../../src/custom/web/google-custom-search.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA6BrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBACa,wBAAyB,SAAQ,UAAU;cAEpC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6JvF,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,4BAA4B;IAiBpC,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;CAO5B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,SAE3C"}