@owneraio/finp2p-sdk-js 0.27.11 → 0.27.13

package/lib/OwneraAPI/finp2p-node-api/custodies.d.ts

@@ -0,0 +1,5 @@
+import { AxiosInstance } from 'axios';
+import { Logger } from '../../types';
+import { Custodies } from '../../types/Ledgers';
+declare const custodies: (connector: AxiosInstance, logger: Logger) => Custodies;
+export default custodies;

package/lib/OwneraAPI/finp2p-node-api/custodies.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../utils");
+const custodies = (connector, logger) => ({
+    /**
+     * Bind a new custody provider
+     *
+     * @param request - The bind custody request
+     * @param options - Optional request options
+     * @returns Promise<CustodyProvider>
+     */
+    bind(request, options) {
+        logger.debug('BindCustody: POST /custody/bind', request);
+        return (0, utils_1.apiPost)('/custody/bind', request, connector, logger, options);
+    },
+    /**
+     * Update an existing custody provider binding
+     *
+     * @param name - The name of the custody provider to update
+     * @param request - The update request
+     * @param options - Optional request options
+     * @returns Promise<CustodyProvider>
+     */
+    update(name, request, options) {
+        logger.debug(`UpdateCustody: PATCH /custody/${name}/update`, request);
+        return (0, utils_1.apiPatch)(`/custody/${encodeURIComponent(name)}/update`, request, connector, logger, options);
+    },
+});
+exports.default = custodies;
+//# sourceMappingURL=custodies.js.map

package/lib/OwneraAPI/finp2p-node-api/custodies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custodies.js","sourceRoot":"","sources":["../../../src/OwneraAPI/finp2p-node-api/custodies.ts"],"names":[],"mappings":";;AAIA,oCAA6C;AAE7C,MAAM,SAAS,GAAG,CAAC,SAAwB,EAAE,MAAc,EAAa,EAAE,CAAC,CAAC;IAC1E;;;;;;OAMG;IACH,IAAI,CAAC,OAA2B,EAAE,OAAwB;QACxD,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,IAAA,eAAO,EAAsC,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAY,EAAE,OAAoC,EAAE,OAAwB;QACjF,MAAM,CAAC,KAAK,CAAC,iCAAiC,IAAI,SAAS,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO,IAAA,gBAAQ,EACb,YAAY,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAC7C,OAAO,EACP,SAAS,EACT,MAAM,EACN,OAAO,CACR,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,kBAAe,SAAS,CAAC"}

package/lib/OwneraAPI/index.js

@@ -49,6 +49,7 @@ const payments_1 = __importDefault(require("./finp2p-node-api/payments"));
 const operations_1 = __importDefault(require("./finp2p-node-api/operations"));
 const messages_1 = __importDefault(require("./finp2p-node-api/messages"));
 const ledgers_1 = __importDefault(require("./finp2p-node-api/ledgers"));
+const custodies_1 = __importDefault(require("./finp2p-node-api/custodies"));
 const policies_1 = __importDefault(require("./finp2p-node-api/policies"));
 const pinningConfig_1 = __importStar(require("./finp2p-node-api/pinningConfig"));
 exports.default = (options) => {
@@ -97,6 +98,7 @@ exports.default = (options) => {
         operations: (0, operations_1.default)(apiConnector, logger),
         messages: (0, messages_1.default)(apiConnector, logger),
         ledgers: (0, ledgers_1.default)(apiConnector, logger),
+        custodies: (0, custodies_1.default)(apiConnector, logger),
         policies: (0, policies_1.default)(apiConnector, logger),
         getPinningConfig: (0, pinningConfig_1.default)(gqlClient, logger),
         createPinningConfig: (0, pinningConfig_1.createPinningConfig)(apiConnector, logger),

package/lib/OwneraAPI/index.js.map

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

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":";;AAAA,4CAA4C;AAC5C,kEAKiC;AACjC,wDAAyF;AAGzF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,oBAAoB;IACpB,MAAM,gBAAgB,GAAgB;QACpC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE;YACP;gBACE,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,IAAI;gBACV,WAAW,EAAE,IAAI;aAClB;YACD;gBACE,QAAQ,EAAE,MAAM;gBAChB,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,MAAM;aACpB;YACD;gBACE,QAAQ,EAAE,WAAW;gBACrB,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,UAAU;aACxB;YACD;gBACE,QAAQ,EAAE,kBAAkB;gBAC5B,MAAM,EAAE,kBAAkB;gBAC1B,UAAU,EAAE,UAAU;gBACtB,aAAa,EAAE;oBACb,WAAW,EAAE,OAAO;oBACpB,eAAe,EAAE,WAAW;oBAC5B,gBAAgB,EAAE,UAAU;oBAC5B,eAAe,EAAE,IAAI;oBACrB,OAAO,EAAE,QAAQ;oBACjB,eAAe,EAAE,iBAAiB;oBAClC,IAAI,EAAE,iBAAiB;oBACvB,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD;gBACE,QAAQ,EAAE,aAAa;gBACvB,MAAM,EAAE,aAAa;gBACrB,UAAU,EAAE,UAAU;gBACtB,aAAa,EAAE;oBACb,WAAW,EAAE,OAAO;oBACpB,eAAe,EAAE,WAAW;oBAC5B,gBAAgB,EAAE,UAAU;oBAC5B,eAAe,EAAE,IAAI;oBACrB,OAAO,EAAE,QAAQ;oBACjB,IAAI,EAAE,MAAM;oBACZ,WAAW,EAAE,MAAM;iBACpB;aACF;SACF;KACF,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAEtF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,MAAM,eAAe,GAAG,IAAA,8CAAuB,EAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;YAElF,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAErC,gEAAgE;YAChE,MAAM,QAAQ,GAAG,oBAAoB,CAAC;YACtC,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAEjD,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,CAAC,UAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,UAAW,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,CAAC,UAAW,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,CAAC,UAAW,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,MAAM,UAAU,GAAG;YACjB,IAAI,EAAE,UAAU;YAChB,YAAY,EAAE;gBACZ,KAAK,EAAE;oBACL,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;oBACzC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;oBAClE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE;iBACrC;aACF;SACF,CAAC;QAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,YAAY,GAAG,IAAA,uCAAgB,EAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;YACxF,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,SAAS,GAAG,IAAA,uCAAgB,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,MAAM,QAAQ,GAAG;YACf,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE;YACxD,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE;YACxD,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAC3D,CAAC;QAEF,MAAM,eAAe,GAAG;YACtB;gBACE,WAAW,EAAE,OAAO;gBACpB,QAAQ,EAAE,oBAAoB;gBAC9B,IAAI,EAAE;oBACJ;wBACE,MAAM,EAAE,QAAQ;wBAChB,IAAI,EAAE,YAAY;wBAClB,YAAY,EAAE;4BACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC;yBAC5E;qBACF;oBACD;wBACE,MAAM,EAAE,QAAQ;wBAChB,IAAI,EAAE,YAAY;wBAClB,YAAY,EAAE;4BACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;yBAC3E;qBACF;iBACF;aACF;SACF,CAAC;QAEF,MAAM,UAAU,GAAG;YACjB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;SACjB,CAAC;QAEF,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;YAChE,MAAM,eAAe,GAAG,IAAA,8CAAuB,EAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;YAClF,MAAM,YAAY,GAAG,IAAA,wCAAiB,EACpC,QAAQ,EACR,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,UAAiB,CAClB,CAAC;YAEF,MAAM,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAErC,kBAAkB;YAClB,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAEvD,kBAAkB;YAClB,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAEvD,uDAAuD;YACvD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kDAA2B,EAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,aAAa,GAAgB;gBACjC,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,SAAS;gBACtB,OAAO,EAAE;oBACP;wBACE,QAAQ,EAAE,WAAW;wBACrB,MAAM,EAAE,WAAW;wBACnB,UAAU,EAAE,UAAU;wBACtB,wBAAwB;qBAClB;iBACT;aACF,CAAC;YAEF,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,kDAA2B,EAAC,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YAChE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,wCAAsB,EAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAC9E,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,wCAAsB,EAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;YACpE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,wCAAsB,EAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,MAAM,UAAU,GAAgB;YAC9B,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,UAAU;YACvB,OAAO,EAAE;gBACP,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;gBAC/D,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;aACxE;SACF,CAAC;QAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;YACnD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6CAA2B,EAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;YACpG,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6CAA2B,EAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACjG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YAC9C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6CAA2B,EAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACnG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,6CAA2B,EAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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;