@jcbuisson/express-x-plugins 4.0.2 → 4.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcbuisson/express-x-plugins",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "description": "Plugins for express-x",
   "type": "module",
   "main": "./src/electric-server-plugin.mjs",

package/src/electric-client-plugin.mjs

@@ -1,5 +1,5 @@
 import { Shape, ShapeStream } from '@electric-sql/client'
-import { Observable } from 'rxjs'
+import { firstValueFrom, Observable } from 'rxjs'
 import { getCurrentScope, onScopeDispose, ref } from 'vue'
 
 
@@ -54,6 +54,10 @@ export function electricClientPlugin(app, options = {}) {
          return value
       }
 
+      function firstResult(where = {}) {
+         return firstValueFrom(getObservable(where))
+      }
+
       async function create(data) {
          assertPlainObject(data, 'mutation data')
          const uid = globalThis.crypto?.randomUUID?.()
@@ -73,7 +77,7 @@ export function electricClientPlugin(app, options = {}) {
          return value
       }
 
-      return { getObservable, getVueRef, create, update, remove }
+      return { getObservable, getVueRef, firstResult, create, update, remove }
    }
 
    return Object.assign(app, { createElectricModel })

package/test/electric-client-plugin.test.mjs

@@ -61,6 +61,21 @@ test('getVueRef returns Shape rows in a Vue ref and cleans up with its scope', (
    assert.equal(shape.unsubscribed, true)
 })
 
+test('firstResult resolves with the first Shape rows and cleans up its subscription', async () => {
+   const app = { service: () => ({}) }
+   electricClientPlugin(app, { ShapeStream: FakeStream, Shape: FakeShape })
+   const todo = app.createElectricModel('todos')
+
+   const rows = await todo.firstResult({ completed: false })
+
+   assert.deepEqual(rows, [{ uid: 'one', completed: false }])
+   const stream = FakeStream.instances.at(-1)
+   assert.deepEqual(stream.options.params, {
+      where: '"completed" = $1', params: ['false'],
+   })
+   assert.equal(stream.shape.unsubscribed, true)
+})
+
 test('model mutations retain the simple Express-X API', async () => {
    const calls = []
    const service = {