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

package/README.md

@@ -358,6 +358,12 @@ is the plural `db.queues`; `db.queue` remains as an alias.
 ```js
 await db.queues.create('jobs')           // CREATE QUEUE IF NOT EXISTS (idempotent)
 await db.queues.push('jobs', { task: 'ship' })
+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.queues.peek('jobs')             // does NOT decrement length
 await db.queues.pop('jobs')              // empty queue → [] (never NOT_FOUND)
 await db.queues.len('jobs')

package/index.d.ts

@@ -292,7 +292,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/sdk",
-  "version": "1.22.0",
+  "version": "1.23.0-rc.302",
   "description": "Official embedded RedDB SDK — launches a local red binary over stdio JSON-RPC. Use @reddb-io/client for remote HTTP, gRPC, and RedWire.",
   "type": "module",
   "main": "src/index.js",

package/src/queue.js

@@ -14,9 +14,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}`,
     })
   }
 
@@ -103,13 +103,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) : []
 }