@reddb-io/client 1.22.0 → 1.23.0-rc.302

package/README.md

@@ -58,6 +58,14 @@ const kv = db.kv('settings')
 await kv.put('characters:hansel', 'crumbs')
 console.log(await kv.get('characters:hansel'))
 
+await db.queues.create('jobs')
+await db.queues.push('jobs', { task: 'email', orderId: 42 }, { dedup: 'outbox:email:42' })
+await db.queues.push(
+  'jobs',
+  { task: 'rebuild_account', accountId: 'acct_123' },
+  { key: 'acct_123' },
+)
+
 await db.close()
 ```
 

package/index.browser.d.ts

@@ -183,7 +183,7 @@ export class QueueClient {
   push(
     queue: string,
     value: unknown,
-    options?: { priority?: number },
+    options?: { priority?: number; key?: string; dedup?: string; delay?: string; at?: number },
   ): Promise<QueryResult>
   pop(queue: string, count?: number): Promise<unknown[]>
   peek(queue: string, count?: number): Promise<unknown[]>

package/index.d.ts

@@ -179,7 +179,7 @@ export class QueueClient {
   push(
     queue: string,
     value: unknown,
-    options?: { priority?: number },
+    options?: { priority?: number; key?: string; dedup?: string; delay?: string; at?: number },
   ): Promise<QueryResult>
   pop(queue: string, count?: number): Promise<unknown[]>
   peek(queue: string, count?: number): Promise<unknown[]>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reddb-io/client",
-  "version": "1.22.0",
+  "version": "1.23.0-rc.302",
   "description": "Thin remote-only RedDB driver. Downloads the `red_client` binary on install. Speaks RedWire/gRPC/HTTP. Embedded URIs (memory://, file://, red:///path) are rejected — use @reddb-io/sdk for those.",
   "type": "module",
   "main": "src/index.js",

package/src/queue.js

@@ -6,9 +6,9 @@ export class QueueClient {
   }
 
   push(queue, value, options = {}) {
-    const priority = options.priority != null ? ` PRIORITY ${queuePriority(options.priority)}` : ''
+    const suffix = queuePushOptions(options)
     return this.client.call('query', {
-      sql: `QUEUE PUSH ${queueIdentifier(queue)} ${queueValueLiteral(value)}${priority}`,
+      sql: `QUEUE PUSH ${queueIdentifier(queue)} ${queueValueLiteral(value)}${suffix}`,
     })
   }
 
@@ -90,13 +90,33 @@ function queuePriority(priority) {
   return String(priority)
 }
 
+function queuePushOptions(options) {
+  if (options.key != null && (options.delay != null || options.at != null)) {
+    throw new RedDBError(
+      'INVALID_ARGUMENT',
+      'QUEUE PUSH KEY cannot be combined with DELAY / AVAILABLE AT',
+    )
+  }
+  let suffix = ''
+  if (options.priority != null) suffix += ` PRIORITY ${queuePriority(options.priority)}`
+  if (options.key != null) suffix += ` KEY ${queueStringLiteral(options.key)}`
+  if (options.dedup != null) suffix += ` DEDUP ${queueStringLiteral(options.dedup)}`
+  if (options.delay != null) suffix += ` DELAY ${options.delay}`
+  if (options.at != null) suffix += ` AVAILABLE AT ${options.at}`
+  return suffix
+}
+
 function queueValueLiteral(value) {
   if (typeof value === 'number' || typeof value === 'boolean') return String(value)
   if (value == null) return 'NULL'
-  if (typeof value === 'string') return `'${value.replace(/'/g, "''")}'`
+  if (typeof value === 'string') return queueStringLiteral(value)
   return JSON.stringify(value)
 }
 
+function queueStringLiteral(value) {
+  return `'${String(value).replace(/'/g, "''")}'`
+}
+
 function queuePayloads(result) {
   return Array.isArray(result?.rows) ? result.rows.map((row) => row.payload) : []
 }