@onchaindb/sdk 2.1.1 → 4.0.0

package/src/query-sdk/tests/Joins.test.ts

@@ -0,0 +1,154 @@
+import { QueryBuilder } from '../index';
+import { MockHttpClient } from './setup';
+
+const APP = 'test_app';
+
+describe('Join wire format — getQueryRequest() equality', () => {
+    function builder() {
+        return new QueryBuilder(new MockHttpClient(), 'http://localhost:9092', APP);
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // joinWith  ≡  serverJoin (no many)
+    // ─────────────────────────────────────────────────────────────────────────
+
+    test('joinWith produces identical request to serverJoin', () => {
+        const withServerJoin = builder()
+            .collection('tweets')
+            .serverJoin('author', 'users', {
+                find: { address: { is: '$data.author' } },
+                select: { display_name: true, avatar_url: true },
+            })
+            .getQueryRequest();
+
+        const withJoinWith = builder()
+            .collection('tweets')
+            .joinWith('author', 'users')
+                .onField('address').equals('$data.author')
+                .selectFields(['display_name', 'avatar_url'])
+                .build()
+            .getQueryRequest();
+
+        expect(withJoinWith).toEqual(withServerJoin);
+    });
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // joinOne  ≡  serverJoin(…, false)
+    // ─────────────────────────────────────────────────────────────────────────
+
+    test('joinOne produces identical request to serverJoin with many=false', () => {
+        const withServerJoin = builder()
+            .collection('tweets')
+            .serverJoin('author', 'users', {
+                find: { address: { is: '$data.author' } },
+                select: { display_name: true, avatar_url: true },
+            }, false)
+            .getQueryRequest();
+
+        const withJoinOne = builder()
+            .collection('tweets')
+            .joinOne('author', 'users')
+                .onField('address').equals('$data.author')
+                .selectFields(['display_name', 'avatar_url'])
+                .build()
+            .getQueryRequest();
+
+        expect(withJoinOne).toEqual(withServerJoin);
+    });
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // joinMany  ≡  serverJoin(…, true)
+    // ─────────────────────────────────────────────────────────────────────────
+
+    test('joinMany produces identical request to serverJoin with many=true', () => {
+        const withServerJoin = builder()
+            .collection('users')
+            .serverJoin('tweets', 'tweets', {
+                find: { author: { is: '$data.address' } },
+                select: { id: true, content: true, created_at: true },
+            }, true)
+            .getQueryRequest();
+
+        const withJoinMany = builder()
+            .collection('users')
+            .joinMany('tweets', 'tweets')
+                .onField('author').equals('$data.address')
+                .selectFields(['id', 'content', 'created_at'])
+                .build()
+            .getQueryRequest();
+
+        expect(withJoinMany).toEqual(withServerJoin);
+    });
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Multiple joins
+    // ─────────────────────────────────────────────────────────────────────────
+
+    test('multiple joins: serverJoin chain equals joinOne + joinMany chain', () => {
+        const withServerJoin = builder()
+            .collection('tweets')
+            .serverJoin('author', 'users', {
+                find: { address: { is: '$data.author' } },
+                select: { display_name: true },
+            }, false)
+            .serverJoin('likes', 'likes', {
+                find: { tweet_id: { is: '$data.id' } },
+                select: { user: true },
+            }, true)
+            .getQueryRequest();
+
+        const withFluent = builder()
+            .collection('tweets')
+            .joinOne('author', 'users')
+                .onField('address').equals('$data.author')
+                .selectFields(['display_name'])
+                .build()
+            .joinMany('likes', 'likes')
+                .onField('tweet_id').equals('$data.id')
+                .selectFields(['user'])
+                .build()
+            .getQueryRequest();
+
+        expect(withFluent).toEqual(withServerJoin);
+    });
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Joins + whereField
+    // ─────────────────────────────────────────────────────────────────────────
+
+    test('joins combined with whereField: serverJoin equals joinOne', () => {
+        const withServerJoin = builder()
+            .collection('tweets')
+            .whereField('reply_to_id').isNull()
+            .serverJoin('author', 'users', {
+                find: { address: { is: '$data.author' } },
+                select: {},
+            }, false)
+            .getQueryRequest();
+
+        const withJoinOne = builder()
+            .collection('tweets')
+            .whereField('reply_to_id').isNull()
+            .joinOne('author', 'users')
+                .onField('address').equals('$data.author')
+                .build()
+            .getQueryRequest();
+
+        expect(withJoinOne).toEqual(withServerJoin);
+    });
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // getQueryRequest() includes root; buildRawQuery() does not
+    // ─────────────────────────────────────────────────────────────────────────
+
+    test('getQueryRequest includes root, buildRawQuery does not', () => {
+        const qb = builder()
+            .collection('tweets')
+            .joinOne('author', 'users')
+                .onField('address').equals('$data.author')
+                .build();
+
+        expect(qb.getQueryRequest().root).toBe(`${APP}::tweets`);
+        expect((qb.buildRawQuery() as any).root).toBeUndefined();
+    });
+});