@owneraio/finp2p-sdk-js 0.27.11 → 0.27.13

package/lib/OwneraAPI/oss-api/executeDynamicQueryWithExternal.js

@@ -0,0 +1,245 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeDynamicQueryWithExternal = executeDynamicQueryWithExternal;
+exports.createStandardExternalDataFetcher = createStandardExternalDataFetcher;
+const externalQueryHandler_1 = require("./externalQueryHandler");
+/**
+ * Executes a dynamic query and automatically fetches and merges external data
+ *
+ * @param executeDynamicQuery - The base executeDynamicQuery function
+ * @param externalDataFetcher - Function to fetch external data
+ * @param options - Query options
+ * @param logger - Logger instance
+ * @returns Query results with external data merged
+ *
+ * @example
+ * ```typescript
+ * const result = await executeDynamicQueryWithExternal(
+ *   api.query.executeDynamicQuery,
+ *   async (graphqlType, filterIds) => {
+ *     if (graphqlType === 'users') {
+ *       const usersResult = await api.oss.getUsers({
+ *         filter: { id: filterIds }
+ *       });
+ *       return usersResult.data;
+ *     }
+ *     return [];
+ *   },
+ *   {
+ *     queryConfig: assetsSchema,
+ *     selectedFields: ['id', 'name', 'country_of_issue'],
+ *     relationshipKey: 'issuer_id',
+ *   },
+ *   logger
+ * );
+ * ```
+ */
+function executeDynamicQueryWithExternal(executeDynamicQuery, externalDataFetcher, options, logger) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { queryConfig, selectedFields, filter, paginate, fetchExternalData = true } = options;
+        // Step 1: Identify external queries needed
+        const externalQueries = (0, externalQueryHandler_1.identifyExternalQueries)(queryConfig, selectedFields);
+        if (externalQueries.size === 0 || !fetchExternalData) {
+            return executeDynamicQuery({ queryConfig, selectedFields, filter, paginate });
+        }
+        // Step 2: Execute main query
+        const mainResult = yield executeDynamicQuery({
+            queryConfig,
+            selectedFields,
+            filter,
+            paginate,
+        });
+        if (!mainResult.data || mainResult.data.length === 0) {
+            return mainResult;
+        }
+        // Step 3: Collect IDs and execute external queries
+        const externalResults = [];
+        const externalQueriesExecuted = [];
+        for (const [queryKey, queryInfo] of externalQueries.entries()) {
+            try {
+                const relationshipIds = new Set();
+                mainResult.data.forEach((item) => {
+                    const id = item[queryInfo.relationshipPath];
+                    if (id) {
+                        // Handle both single values and arrays
+                        if (Array.isArray(id)) {
+                            id.forEach((val) => {
+                                if (val)
+                                    relationshipIds.add(val);
+                            });
+                        }
+                        else {
+                            relationshipIds.add(id);
+                        }
+                    }
+                });
+                logger === null || logger === void 0 ? void 0 : logger.info(`Collected relationship IDs for queryKey ${queryKey}`, {
+                    relationshipPath: queryInfo.relationshipPath,
+                    count: relationshipIds.size,
+                    ids: Array.from(relationshipIds)
+                });
+                if (relationshipIds.size === 0) {
+                    logger === null || logger === void 0 ? void 0 : logger.info(`No relationship IDs found for queryKey ${queryKey}, skipping external query`);
+                    continue;
+                }
+                // Collect intent IDs if any field has intentFilterKey
+                const intentIds = new Set();
+                queryInfo.fields.forEach((field) => {
+                    if (field.intentFilterKey) {
+                        mainResult.data.forEach((item) => {
+                            const intentId = item[field.intentFilterKey];
+                            if (intentId) {
+                                intentIds.add(intentId);
+                            }
+                        });
+                    }
+                });
+                logger === null || logger === void 0 ? void 0 : logger.info(`Fetching external data for queryKey ${queryKey}`, {
+                    graphqlType: queryInfo.graphqlType,
+                    filterFieldName: queryInfo.filterFieldName,
+                    idsToFetch: Array.from(relationshipIds),
+                    intentIdsToFilter: intentIds.size > 0 ? Array.from(intentIds) : undefined
+                });
+                const data = yield externalDataFetcher(queryInfo.graphqlType, queryInfo.filterFieldName, Array.from(relationshipIds), queryInfo.fields, intentIds.size > 0 ? Array.from(intentIds) : undefined);
+                logger === null || logger === void 0 ? void 0 : logger.info(`Fetched external data for queryKey ${queryKey}`, {
+                    recordsReturned: (data === null || data === void 0 ? void 0 : data.length) || 0
+                });
+                externalResults.push({
+                    graphqlType: queryInfo.graphqlType,
+                    queryKey,
+                    data,
+                });
+                externalQueriesExecuted.push(queryKey);
+            }
+            catch (error) {
+                logger === null || logger === void 0 ? void 0 : logger.error(`Failed to fetch external data for queryKey ${queryKey}`, { error: error.message });
+            }
+        }
+        // Step 4: Merge external data into main results
+        const enrichedData = (0, externalQueryHandler_1.mergeExternalData)(mainResult.data, externalResults, externalQueries, queryConfig, selectedFields, logger);
+        return Object.assign(Object.assign({}, mainResult), { data: enrichedData, externalQueriesExecuted });
+    });
+}
+/**
+ * Creates a simplified external data fetcher for common use cases
+ * @param api - The OwneraAPI instance
+ * @returns External data fetcher function
+ *
+ * @example
+ * ```typescript
+ * const fetcher = createStandardExternalDataFetcher(api);
+ * const result = await executeDynamicQueryWithExternal(
+ *   api.query.executeDynamicQuery,
+ *   fetcher,
+ *   options,
+ *   logger
+ * );
+ * ```
+ */
+function createStandardExternalDataFetcher(api) {
+    return (graphqlType, filterFieldName, filterIds, fields, intentIds) => __awaiter(this, void 0, void 0, function* () {
+        // Merge all static filters from fields
+        const staticFilters = fields.reduce((acc, field) => {
+            if (field.staticFilters) {
+                return Object.assign(Object.assign({}, acc), field.staticFilters);
+            }
+            return acc;
+        }, {});
+        // Build filter object with the correct field name
+        const filter = Object.assign({ [filterFieldName]: filterIds }, staticFilters);
+        // Check if any field requires certificates
+        const needsCertificates = fields.some((field) => field.certificateType);
+        switch (graphqlType) {
+            case 'users': {
+                const result = yield api.oss.getUsers({ filter });
+                return result.data || [];
+            }
+            case 'assets': {
+                // Check if intent IDs were provided (meaning we need to filter intents)
+                if (intentIds && intentIds.length > 0) {
+                    // Use intentFragment from the oss module
+                    // The fragment includes all standard intent fields
+                    const result = yield api.oss.getAssetsWithSpecificIntents({
+                        assetIds: filterIds,
+                        intentIds: intentIds,
+                        fields: `
+              id
+              type
+              status
+              start
+              end
+              remainingQuantity
+              intent {
+                ... on PrimarySale {
+                  issuerId
+                  settlementTerm {
+                    details {
+                      ... on PartialSettlement { unitValue }
+                      ... on FullSettlement { amount }
+                    }
+                  }
+                }
+                ... on RedemptionIntent {
+                  issuerId
+                  assetTerm { amount }
+                }
+                ... on BuyingIntent {
+                  buyer
+                  settlementTerm {
+                    details {
+                      ... on PartialSettlement { unitValue }
+                      ... on FullSettlement { amount }
+                    }
+                  }
+                }
+                ... on SellingIntent {
+                  seller
+                  settlementTerm {
+                    details {
+                      ... on PartialSettlement { unitValue }
+                      ... on FullSettlement { amount }
+                    }
+                  }
+                }
+                ... on PrivateOfferIntent {
+                  seller
+                  buyer
+                  assetTerm { amount }
+                }
+                ... on RequestForTransferIntent {
+                  debitor
+                  creditor
+                  assetTerm { amount }
+                }
+                ... on LoanIntent {
+                  borrower
+                  lender
+                  assetTerm { amount }
+                }
+              }
+            `,
+                        assetFields: needsCertificates ? 'certificates { nodes { type data } }' : undefined,
+                    });
+                    return result.data || [];
+                }
+                else {
+                    // No intent filtering needed, use standard getAssets
+                    const result = yield api.oss.getAssets({ filter });
+                    return result.data || [];
+                }
+            }
+            default:
+                throw new Error(`Unsupported external graphqlType: ${graphqlType}`);
+        }
+    });
+}
+//# sourceMappingURL=executeDynamicQueryWithExternal.js.map

package/lib/OwneraAPI/oss-api/executeDynamicQueryWithExternal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeDynamicQueryWithExternal.js","sourceRoot":"","sources":["../../../src/OwneraAPI/oss-api/executeDynamicQueryWithExternal.ts"],"names":[],"mappings":"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"}

package/lib/OwneraAPI/oss-api/externalQueryHandler.d.ts

@@ -0,0 +1,67 @@
+import { QueryConfig } from '../../types/Oss/Oss';
+import { Logger } from '../../types/Core';
+/**
+ * Information about an external query that needs to be executed
+ */
+export interface ExternalQueryInfo {
+    graphqlType: string;
+    relationshipKey: string;
+    relationshipPath: string;
+    filterFieldName: string;
+    fields: {
+        apiField: string;
+        path: string;
+        graphqlPath: string;
+        idField?: string;
+        certificateType?: string;
+        staticFilters?: Record<string, any>;
+        intentFilterKey?: string;
+    }[];
+}
+/**
+ * Result from executing external queries
+ */
+export interface ExternalQueryResult {
+    graphqlType: string;
+    data: any[];
+}
+/**
+ * Identifies all external fields in selected fields and groups them by graphqlType + relationshipKey
+ * @param config - The query configuration
+ * @param selectedFields - Array of selected field names
+ * @returns Map of unique key (graphqlType:relationshipKey) to external field information
+ */
+export declare function identifyExternalQueries(config: QueryConfig, selectedFields: string[]): Map<string, ExternalQueryInfo>;
+/**
+ * Gets the value from a nested path in an object
+ * Supports array notation:
+ * - [i] to get all array elements (e.g., "nodes[i].name")
+ * - [field=value] to filter by field value (e.g., "nodes[type=NAV].data")
+ * - [0], [1] for specific index (e.g., "nodes[0]")
+ * Supports alternative field names with pipe syntax (e.g., "unitValue|amount")
+ * @param obj - The object to extract value from
+ * @param path - Dot notation path (e.g., "certificates.nodes[type=NAV].data.currentNAV.navValue")
+ * @param intentId - Optional intent ID to filter intents array
+ * @returns The value at the path, or undefined if not found
+ */
+export declare function getValueFromPath(obj: any, path: string, intentId?: string): any;
+/**
+ * Merges external query results into the main data
+ * @param mainData - The main query result data
+ * @param externalResults - Results from external queries with queryKey
+ * @param externalQueriesMap - Map of queryKey to ExternalQueryInfo (includes relationshipKey)
+ * @param config - The query configuration
+ * @param selectedFields - Array of selected field names
+ * @param logger - Logger instance
+ * @returns Main data enriched with external field values
+ */
+export declare function mergeExternalData(mainData: any[], externalResults: Array<ExternalQueryResult & {
+    queryKey: string;
+}>, _externalQueriesMap: Map<string, ExternalQueryInfo>, // Prefix with _ to indicate intentionally unused
+config: QueryConfig, selectedFields: string[], logger?: Logger): any[];
+/**
+ * Validates external query configuration
+ * @param config - The query configuration
+ * @throws Error if external query configuration is invalid
+ */
+export declare function validateExternalQueryConfig(config: QueryConfig): void;

package/lib/OwneraAPI/oss-api/externalQueryHandler.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.identifyExternalQueries = identifyExternalQueries;
+exports.getValueFromPath = getValueFromPath;
+exports.mergeExternalData = mergeExternalData;
+exports.validateExternalQueryConfig = validateExternalQueryConfig;
+/**
+ * Identifies all external fields in selected fields and groups them by graphqlType + relationshipKey
+ * @param config - The query configuration
+ * @param selectedFields - Array of selected field names
+ * @returns Map of unique key (graphqlType:relationshipKey) to external field information
+ */
+function identifyExternalQueries(config, selectedFields) {
+    const externalQueriesMap = new Map();
+    const selectedFieldsSet = new Set(selectedFields);
+    const selectedColumns = config.columns.filter((col) => selectedFieldsSet.has(col.apiField));
+    selectedColumns.forEach((col) => {
+        if (col.dataSource === 'external' && col.externalQuery) {
+            const { graphqlType, path, graphqlPath, relationshipKey, relationshipPath, filterFieldName, idField, certificateType, staticFilters, intentFilterKey } = col.externalQuery;
+            const queryKey = `${graphqlType}:${relationshipKey}:${filterFieldName}`;
+            if (!externalQueriesMap.has(queryKey)) {
+                externalQueriesMap.set(queryKey, {
+                    graphqlType,
+                    relationshipKey,
+                    relationshipPath,
+                    filterFieldName,
+                    fields: [],
+                });
+            }
+            externalQueriesMap.get(queryKey).fields.push({
+                apiField: col.apiField,
+                path,
+                graphqlPath,
+                idField,
+                certificateType,
+                staticFilters,
+                intentFilterKey,
+            });
+        }
+    });
+    return externalQueriesMap;
+}
+/**
+ * Gets the value from a nested path in an object
+ * Supports array notation:
+ * - [i] to get all array elements (e.g., "nodes[i].name")
+ * - [field=value] to filter by field value (e.g., "nodes[type=NAV].data")
+ * - [0], [1] for specific index (e.g., "nodes[0]")
+ * Supports alternative field names with pipe syntax (e.g., "unitValue|amount")
+ * @param obj - The object to extract value from
+ * @param path - Dot notation path (e.g., "certificates.nodes[type=NAV].data.currentNAV.navValue")
+ * @param intentId - Optional intent ID to filter intents array
+ * @returns The value at the path, or undefined if not found
+ */
+function getValueFromPath(obj, path, intentId) {
+    var _a;
+    if (!obj || !path)
+        return undefined;
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (!current)
+            return undefined;
+        // Special handling for 'intents' field when intentId is provided
+        if (part === 'intents' && intentId) {
+            // Check if intents is wrapped in nodes
+            const intentsArray = Array.isArray((_a = current.intents) === null || _a === void 0 ? void 0 : _a.nodes)
+                ? current.intents.nodes
+                : Array.isArray(current.intents)
+                    ? current.intents
+                    : undefined;
+            if (intentsArray) {
+                const matchingIntent = intentsArray.find((intent) => intent.id === intentId);
+                if (!matchingIntent) {
+                    return undefined;
+                }
+                current = matchingIntent;
+                continue;
+            }
+        }
+        // Handle array notation [i] for all elements
+        if (part.endsWith('[i]')) {
+            const arrayKey = part.slice(0, -3);
+            const array = current[arrayKey];
+            if (!Array.isArray(array))
+                return undefined;
+            // Return array of values from all elements
+            const remainingPath = parts.slice(parts.indexOf(part) + 1).join('.');
+            if (!remainingPath)
+                return array;
+            return array.map((item) => getValueFromPath(item, remainingPath, intentId)).filter((v) => v !== undefined);
+        }
+        // Handle array notation [field=value] for filtering (e.g., nodes[type=NAV])
+        const filterMatch = part.match(/^(.+)\[(\w+)=([^\]]+)\]$/);
+        if (filterMatch) {
+            const arrayKey = filterMatch[1];
+            const filterField = filterMatch[2];
+            const filterValue = filterMatch[3];
+            const array = current[arrayKey];
+            if (!Array.isArray(array))
+                return undefined;
+            // Find the first element where field matches value
+            const matchingElement = array.find((item) => item && item[filterField] === filterValue);
+            if (!matchingElement)
+                return undefined;
+            current = matchingElement;
+            continue;
+        }
+        // Handle array notation [0], [1], etc. for specific index
+        const arrayMatch = part.match(/^(.+)\[(\d+)\]$/);
+        if (arrayMatch) {
+            const arrayKey = arrayMatch[1];
+            const index = parseInt(arrayMatch[2], 10);
+            const array = current[arrayKey];
+            if (!Array.isArray(array) || index >= array.length)
+                return undefined;
+            current = array[index];
+            continue;
+        }
+        // Handle alternative field names with pipe syntax (e.g., "unitValue|amount")
+        if (part.includes('|')) {
+            const alternatives = part.split('|');
+            let found = false;
+            for (const alt of alternatives) {
+                if (current[alt] !== undefined) {
+                    current = current[alt];
+                    found = true;
+                    break;
+                }
+            }
+            if (!found)
+                return undefined;
+            continue;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Merges external query results into the main data
+ * @param mainData - The main query result data
+ * @param externalResults - Results from external queries with queryKey
+ * @param externalQueriesMap - Map of queryKey to ExternalQueryInfo (includes relationshipKey)
+ * @param config - The query configuration
+ * @param selectedFields - Array of selected field names
+ * @param logger - Logger instance
+ * @returns Main data enriched with external field values
+ */
+function mergeExternalData(mainData, externalResults, _externalQueriesMap, // Prefix with _ to indicate intentionally unused
+config, selectedFields, logger) {
+    if (externalResults.length === 0) {
+        return mainData;
+    }
+    const selectedFieldsSet = new Set(selectedFields);
+    const externalFields = config.columns.filter((col) => selectedFieldsSet.has(col.apiField) && col.dataSource === 'external');
+    if (externalFields.length === 0) {
+        return mainData;
+    }
+    // Build lookup maps for external data by ID
+    const externalDataMaps = new Map();
+    externalResults.forEach((result) => {
+        var _a;
+        const dataMap = new Map();
+        const queryInfo = _externalQueriesMap.get(result.queryKey);
+        const idFieldName = ((_a = queryInfo === null || queryInfo === void 0 ? void 0 : queryInfo.fields[0]) === null || _a === void 0 ? void 0 : _a.idField) || 'id';
+        result.data.forEach((item) => {
+            const id = item[idFieldName];
+            if (id) {
+                dataMap.set(id, item);
+            }
+        });
+        logger === null || logger === void 0 ? void 0 : logger.info(`Built external data map for queryKey ${result.queryKey}`, {
+            idFieldName,
+            recordCount: dataMap.size,
+            ids: Array.from(dataMap.keys())
+        });
+        externalDataMaps.set(result.queryKey, dataMap);
+    });
+    // Cache relationshipPath lookups
+    const queryInfoCache = new Map();
+    externalFields.forEach((field) => {
+        if (!field.externalQuery)
+            return;
+        const { graphqlType, relationshipKey, filterFieldName } = field.externalQuery;
+        const queryKey = `${graphqlType}:${relationshipKey}:${filterFieldName}`;
+        if (!queryInfoCache.has(queryKey)) {
+            const queryInfo = _externalQueriesMap.get(queryKey);
+            queryInfoCache.set(queryKey, {
+                relationshipPath: (queryInfo === null || queryInfo === void 0 ? void 0 : queryInfo.relationshipPath) || relationshipKey
+            });
+        }
+    });
+    // Merge external data into main results
+    const enrichedData = mainData.map((mainItem) => {
+        let enrichedItem = mainItem;
+        let hasEnrichment = false;
+        externalFields.forEach((field) => {
+            var _a, _b;
+            if (!field.externalQuery)
+                return;
+            const { graphqlType, path, relationshipKey, filterFieldName, certificateType } = field.externalQuery;
+            const queryKey = `${graphqlType}:${relationshipKey}:${filterFieldName}`;
+            const externalDataMap = externalDataMaps.get(queryKey);
+            if (!externalDataMap) {
+                return;
+            }
+            const cachedInfo = queryInfoCache.get(queryKey);
+            const relationshipPath = (cachedInfo === null || cachedInfo === void 0 ? void 0 : cachedInfo.relationshipPath) || relationshipKey;
+            const relationshipValue = mainItem[relationshipPath];
+            if (!relationshipValue) {
+                return;
+            }
+            // Handle both single values and arrays for relationship value
+            let externalItem;
+            if (Array.isArray(relationshipValue)) {
+                // For arrays, try to find the first matching external item
+                for (const val of relationshipValue) {
+                    externalItem = externalDataMap.get(val);
+                    if (externalItem)
+                        break;
+                }
+                if (!externalItem) {
+                    return;
+                }
+            }
+            else {
+                externalItem = externalDataMap.get(relationshipValue);
+                if (!externalItem) {
+                    return;
+                }
+            }
+            // Extract value from certificate if specified
+            if (certificateType) {
+                const certsList = ((_a = externalItem.certificates) === null || _a === void 0 ? void 0 : _a.nodes) || externalItem.certificates;
+                if (certsList && Array.isArray(certsList)) {
+                    const matchingCert = certsList.find((cert) => cert.type === certificateType);
+                    if (matchingCert) {
+                        let parsedData = {};
+                        try {
+                            parsedData = typeof matchingCert.data === 'string'
+                                ? JSON.parse(matchingCert.data)
+                                : matchingCert.data;
+                        }
+                        catch (error) {
+                            logger === null || logger === void 0 ? void 0 : logger.warning(`Failed to parse certificate data for type ${certificateType}`, {
+                                error: error.message,
+                                certificateId: matchingCert.id
+                            });
+                            return;
+                        }
+                        externalItem = parsedData;
+                    }
+                    else {
+                        return;
+                    }
+                }
+            }
+            // Get intent ID if intentFilterKey is specified
+            const intentFilterKey = (_b = field.externalQuery) === null || _b === void 0 ? void 0 : _b.intentFilterKey;
+            const intentId = intentFilterKey ? mainItem[intentFilterKey] : undefined;
+            const value = getValueFromPath(externalItem, path, intentId);
+            if (!hasEnrichment) {
+                enrichedItem = Object.assign({}, mainItem);
+                hasEnrichment = true;
+            }
+            enrichedItem[field.apiField] = value;
+        });
+        return enrichedItem;
+    });
+    return enrichedData;
+}
+/**
+ * Validates external query configuration
+ * @param config - The query configuration
+ * @throws Error if external query configuration is invalid
+ */
+function validateExternalQueryConfig(config) {
+    const externalFields = config.columns.filter((col) => col.dataSource === 'external');
+    externalFields.forEach((field) => {
+        if (!field.externalQuery) {
+            throw new Error(`External field ${field.apiField} missing externalQuery configuration`);
+        }
+        if (!field.externalQuery.graphqlType) {
+            throw new Error(`External field ${field.apiField} missing externalQuery.graphqlType`);
+        }
+        if (!field.externalQuery.path) {
+            throw new Error(`External field ${field.apiField} missing externalQuery.path`);
+        }
+        if (!field.externalQuery.graphqlPath) {
+            throw new Error(`External field ${field.apiField} missing externalQuery.graphqlPath`);
+        }
+    });
+}
+//# sourceMappingURL=externalQueryHandler.js.map

package/lib/OwneraAPI/oss-api/externalQueryHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalQueryHandler.js","sourceRoot":"","sources":["../../../src/OwneraAPI/oss-api/externalQueryHandler.ts"],"names":[],"mappings":"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"}

package/lib/OwneraAPI/oss-api/filterUtils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Filter utilities for sanitizing and formatting GraphQL filter values
+ * These functions prevent injection attacks and ensure type safety
+ */
+/**
+ * Sanitizes a filter key to prevent injection attacks
+ * Only allows alphanumeric characters and underscores (GraphQL field naming convention)
+ */
+export declare const sanitizeFilterKey: (key: string) => string;
+/**
+ * Sanitizes a filter value to prevent injection attacks
+ * Escapes special characters in strings to prevent GraphQL injection
+ */
+export declare const sanitizeFilterValue: (value: any) => string;
+/**
+ * Formats a filter value based on its type for GraphQL query construction
+ * Wraps values in quotes and handles boolean, number, and string types
+ */
+export declare const formatFilterValue: (value: any) => string;