@owneraio/finp2p-sdk-js 0.27.10 → 0.27.12

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

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

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

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Test for external query handler utilities
+const externalQueryHandler_1 = require("../externalQueryHandler");
+const queryValidation_1 = require("../queryValidation");
+describe('External Query Handler', () => {
+    // Mock query config
+    const mockAssetsConfig = {
+        name: 'Assets',
+        graphqlType: 'assets',
+        columns: [
+            {
+                apiField: 'id',
+                header: 'id',
+                path: 'id',
+                graphqlPath: 'id',
+            },
+            {
+                apiField: 'name',
+                header: 'name',
+                path: 'name',
+                graphqlPath: 'name',
+            },
+            {
+                apiField: 'issuer_id',
+                header: 'issuer_id',
+                path: 'issuerId',
+                graphqlPath: 'issuerId',
+            },
+            {
+                apiField: 'country_of_issue',
+                header: 'country_of_issue',
+                dataSource: 'external',
+                externalQuery: {
+                    graphqlType: 'users',
+                    relationshipKey: 'issuer_id',
+                    relationshipPath: 'issuerId',
+                    filterFieldName: 'id',
+                    idField: 'userId',
+                    certificateType: 'individual_info',
+                    path: 'address.country',
+                    graphqlPath: 'id certificates { nodes { type data } }',
+                },
+            },
+            {
+                apiField: 'issuer_name',
+                header: 'issuer_name',
+                dataSource: 'external',
+                externalQuery: {
+                    graphqlType: 'users',
+                    relationshipKey: 'issuer_id',
+                    relationshipPath: 'issuerId',
+                    filterFieldName: 'id',
+                    idField: 'userId',
+                    path: 'name',
+                    graphqlPath: 'name',
+                },
+            },
+        ],
+    };
+    const selectedFields = ['id', 'name', 'issuer_id', 'country_of_issue', 'issuer_name'];
+    describe('identifyExternalQueries', () => {
+        it('should identify external queries and group them correctly', () => {
+            const externalQueries = (0, externalQueryHandler_1.identifyExternalQueries)(mockAssetsConfig, selectedFields);
+            expect(externalQueries.size).toBe(1);
+            // QueryKey is now "graphqlType:relationshipKey:filterFieldName"
+            const queryKey = 'users:issuer_id:id';
+            const usersQuery = externalQueries.get(queryKey);
+            expect(usersQuery).toBeDefined();
+            expect(usersQuery.fields.length).toBe(2);
+            expect(usersQuery.graphqlType).toBe('users');
+            expect(usersQuery.relationshipKey).toBe('issuer_id');
+            expect(usersQuery.filterFieldName).toBe('id');
+        });
+    });
+    describe('getValueFromPath', () => {
+        const testObject = {
+            name: 'John Doe',
+            certificates: {
+                nodes: [
+                    { type: 'kyc', data: { verified: true } },
+                    { type: 'individual_info', data: { country: 'USA', state: 'CA' } },
+                    { type: 'tax', data: { id: '123' } },
+                ],
+            },
+        };
+        it('should extract values from nested array paths', () => {
+            const countryValue = (0, externalQueryHandler_1.getValueFromPath)(testObject, 'certificates.nodes[i].data.country');
+            expect(Array.isArray(countryValue)).toBe(true);
+            expect(countryValue).toContain('USA');
+        });
+        it('should extract simple field values', () => {
+            const nameValue = (0, externalQueryHandler_1.getValueFromPath)(testObject, 'name');
+            expect(nameValue).toBe('John Doe');
+        });
+    });
+    describe('mergeExternalData', () => {
+        const mainData = [
+            { id: 'asset-1', name: 'Asset One', issuerId: 'user-1' },
+            { id: 'asset-2', name: 'Asset Two', issuerId: 'user-2' },
+            { id: 'asset-3', name: 'Asset Three', issuerId: 'user-1' },
+        ];
+        const externalResults = [
+            {
+                graphqlType: 'users',
+                queryKey: 'users:issuer_id:id',
+                data: [
+                    {
+                        userId: 'user-1',
+                        name: 'Issuer One',
+                        certificates: {
+                            nodes: [{ type: 'individual_info', data: '{"address":{"country":"USA"}}' }],
+                        },
+                    },
+                    {
+                        userId: 'user-2',
+                        name: 'Issuer Two',
+                        certificates: {
+                            nodes: [{ type: 'individual_info', data: '{"address":{"country":"UK"}}' }],
+                        },
+                    },
+                ],
+            },
+        ];
+        const mockLogger = {
+            debug: jest.fn(),
+            info: jest.fn(),
+            warn: jest.fn(),
+            error: jest.fn(),
+        };
+        it('should merge external data into main results correctly', () => {
+            const externalQueries = (0, externalQueryHandler_1.identifyExternalQueries)(mockAssetsConfig, selectedFields);
+            const enrichedData = (0, externalQueryHandler_1.mergeExternalData)(mainData, externalResults, externalQueries, mockAssetsConfig, selectedFields, mockLogger);
+            expect(enrichedData).toHaveLength(3);
+            // Check Asset One
+            expect(enrichedData[0].country_of_issue).toBe('USA');
+            expect(enrichedData[0].issuer_name).toBe('Issuer One');
+            // Check Asset Two
+            expect(enrichedData[1].country_of_issue).toBe('UK');
+            expect(enrichedData[1].issuer_name).toBe('Issuer Two');
+            // Check Asset Three (should also have Issuer One data)
+            expect(enrichedData[2].country_of_issue).toBe('USA');
+            expect(enrichedData[2].issuer_name).toBe('Issuer One');
+        });
+    });
+    describe('validateExternalQueryConfig', () => {
+        it('should validate a correct configuration', () => {
+            expect(() => (0, externalQueryHandler_1.validateExternalQueryConfig)(mockAssetsConfig)).not.toThrow();
+        });
+        it('should throw error for missing externalQuery', () => {
+            const invalidConfig = {
+                name: 'Invalid',
+                graphqlType: 'invalid',
+                columns: [
+                    {
+                        apiField: 'bad_field',
+                        header: 'bad_field',
+                        dataSource: 'external',
+                        // Missing externalQuery
+                    },
+                ],
+            };
+            expect(() => (0, externalQueryHandler_1.validateExternalQueryConfig)(invalidConfig)).toThrow();
+        });
+    });
+});
+describe('Query Validation', () => {
+    describe('validateSelectedFields', () => {
+        it('should detect GraphQL syntax in field names', () => {
+            const invalidFields = ['id', 'certificates', '{', 'nodes', '}'];
+            expect(() => (0, queryValidation_1.validateSelectedFields)(invalidFields)).toThrow(/GraphQL syntax/);
+            expect(() => (0, queryValidation_1.validateSelectedFields)(invalidFields)).toThrow(/graphqlPath/);
+        });
+        it('should pass for valid field names', () => {
+            const validFields = ['id', 'name', 'issuer_id', 'country_of_issue'];
+            expect(() => (0, queryValidation_1.validateSelectedFields)(validFields)).not.toThrow();
+        });
+    });
+    describe('validateFieldsExistInConfig', () => {
+        const mockConfig = {
+            name: 'Test',
+            graphqlType: 'testType',
+            columns: [
+                { apiField: 'id', header: 'id', path: 'id', graphqlPath: 'id' },
+                { apiField: 'name', header: 'name', path: 'name', graphqlPath: 'name' },
+            ],
+        };
+        it('should detect GraphQL tokens in invalid fields', () => {
+            const invalidFields = ['id', 'nodes', 'data', '{'];
+            expect(() => (0, queryValidation_1.validateFieldsExistInConfig)(invalidFields, mockConfig)).toThrow(/GraphQL path tokens/);
+            expect(() => (0, queryValidation_1.validateFieldsExistInConfig)(invalidFields, mockConfig)).toThrow(/apiField names/);
+        });
+        it('should provide helpful message for regular invalid fields', () => {
+            const invalidFields = ['id', 'unknown_field'];
+            expect(() => (0, queryValidation_1.validateFieldsExistInConfig)(invalidFields, mockConfig)).toThrow(/Available fields/);
+        });
+        it('should pass for valid fields', () => {
+            const validFields = ['id', 'name'];
+            expect(() => (0, queryValidation_1.validateFieldsExistInConfig)(validFields, mockConfig)).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=externalQueryHandler.test.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { ComputedValueType } from '../../types/Oss/Oss';
+/**
+ * Computes a runtime value based on the ComputedValueType
+ * @param computedValue - The type of computed value to generate
+ * @returns The computed value
+ */
+export declare function computeRuntimeValue(computedValue: ComputedValueType | string): any;
+/**
+ * Applies computed values to a data row based on column configuration
+ * @param row - The data row to populate
+ * @param columns - Array of column configurations
+ * @returns The row with computed values populated
+ */
+export declare function applyComputedValues(row: Record<string, any>, columns: Array<{
+    apiField: string;
+    computedValue?: string;
+}>): Record<string, any>;

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeRuntimeValue = computeRuntimeValue;
+exports.applyComputedValues = applyComputedValues;
+/**
+ * Computes a runtime value based on the ComputedValueType
+ * @param computedValue - The type of computed value to generate
+ * @returns The computed value
+ */
+function computeRuntimeValue(computedValue) {
+    switch (computedValue) {
+        case 'currentTimestamp':
+            // Returns milliseconds since epoch
+            return Date.now();
+        case 'currentDate':
+            // Returns ISO 8601 date string (e.g., "2025-01-15T10:30:45.123Z")
+            return new Date().toISOString();
+        case 'currentDateLocal':
+            // Returns localized date string
+            return new Date().toLocaleString();
+        case 'currentUnixTime':
+            // Returns seconds since epoch
+            return Math.floor(Date.now() / 1000);
+        default:
+            // For custom computed values, return undefined
+            // This allows for future extensibility
+            return undefined;
+    }
+}
+/**
+ * Applies computed values to a data row based on column configuration
+ * @param row - The data row to populate
+ * @param columns - Array of column configurations
+ * @returns The row with computed values populated
+ */
+function applyComputedValues(row, columns) {
+    columns.forEach((col) => {
+        if (col.computedValue) {
+            const value = computeRuntimeValue(col.computedValue);
+            if (value !== undefined) {
+                row[col.apiField] = value;
+            }
+        }
+    });
+    return row;
+}
+//# sourceMappingURL=computedValues.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"computedValues.js","sourceRoot":"","sources":["../../../src/OwneraAPI/oss-api/computedValues.ts"],"names":[],"mappings":";;AAOA,kDAuBC;AAQD,kDAaC;AAjDD;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,aAAyC;IAC3E,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,kBAAkB;YACrB,mCAAmC;YACnC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;QAEpB,KAAK,aAAa;YAChB,kEAAkE;YAClE,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAElC,KAAK,kBAAkB;YACrB,gCAAgC;YAChC,OAAO,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;QAErC,KAAK,iBAAiB;YACpB,8BAA8B;YAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAEvC;YACE,+CAA+C;YAC/C,uCAAuC;YACvC,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,GAAwB,EACxB,OAA4D;IAE5D,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,126 @@
+import { QueryConfig } from '../../types/Oss/Oss';
+import { PaginateInput } from '../../types/Oss';
+import { Logger } from '../../types/Core';
+/**
+ * Options for executing dynamic query with external data
+ */
+export interface ExecuteDynamicQueryWithExternalOptions {
+    queryConfig: QueryConfig;
+    selectedFields: string[];
+    filter?: Record<string, any>;
+    paginate?: PaginateInput;
+    relationshipKey?: string;
+    fetchExternalData?: boolean;
+}
+/**
+ * External data fetcher function type
+ * This function should execute the external query and return the results
+ *
+ * @param graphqlType - The GraphQL type to query (e.g., 'users', 'assets')
+ * @param filterFieldName - The field name to use for filtering (e.g., 'id', 'assetIds')
+ * @param filterIds - Array of IDs to filter by
+ * @param fields - Array of field configurations from the external query definition.
+ *                 IMPORTANT: The `graphqlPath` in these fields describes the GraphQL structure
+ *                 for extracting values AFTER fetching, not the fields to query.
+ *                 Use `apiField` to identify which values to extract, and `path` for extraction logic.
+ *
+ * @returns Promise resolving to array of fetched records
+ *
+ * @example Standard implementation using hardcoded methods
+ * ```typescript
+ * const fetcher = async (graphqlType, filterFieldName, filterIds, fields) => {
+ *   if (graphqlType === 'users') {
+ *     const result = await api.oss.getUsers({
+ *       filter: { [filterFieldName]: filterIds }
+ *     });
+ *     return result.data;
+ *   }
+ *   // ... handle other types
+ * };
+ * ```
+ *
+ * @example Custom implementation using executeDynamicQuery
+ * ```typescript
+ * const fetcher = async (graphqlType, filterFieldName, filterIds, fields) => {
+ *   if (graphqlType === 'users') {
+ *     const usersSchema = getUsersSchema(); // Get proper QueryConfig for users
+ *     // Use schema's apiField names, NOT the graphqlPath strings from fields parameter
+ *     const result = await api.query.executeDynamicQuery({
+ *       queryConfig: usersSchema,
+ *       selectedFields: ['user_id', 'account_fin_id'], // Use actual field names from schema
+ *       filter: { [filterFieldName]: filterIds }
+ *     });
+ *     return result.data;
+ *   }
+ * };
+ * ```
+ */
+export type ExternalDataFetcher = (graphqlType: string, filterFieldName: string, filterIds: string[], fields: {
+    apiField: string;
+    path: string;
+    graphqlPath: string;
+    certificateType?: string;
+    staticFilters?: Record<string, any>;
+    intentFilterKey?: string;
+}[], intentIds?: string[]) => Promise<any[]>;
+/**
+ * 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
+ * );
+ * ```
+ */
+export declare function executeDynamicQueryWithExternal(executeDynamicQuery: (request: {
+    queryConfig: QueryConfig;
+    selectedFields: string[];
+    filter?: Record<string, any>;
+    paginate?: PaginateInput;
+}) => Promise<{
+    data: any[];
+    pageInfo?: any;
+}>, externalDataFetcher: ExternalDataFetcher, options: ExecuteDynamicQueryWithExternalOptions, logger?: Logger): Promise<{
+    data: any[];
+    pageInfo?: any;
+    externalQueriesExecuted?: string[];
+}>;
+/**
+ * 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
+ * );
+ * ```
+ */
+export declare function createStandardExternalDataFetcher(api: any): ExternalDataFetcher;

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