hide-a-bed 5.0.0 → 5.0.2

package/README.md

@@ -1,5 +1,22 @@
-API 
--------------
+### API Quick Reference
+
+🍭 denotes a *Sugar* api - helps makes some tasks sweet and easy, but may hide some complexities you might want to deal with. 
+
+| Document Operations | Bulk Operations | View Operations | Changes Feed |
+|-------------------|-----------------|-----------------|-----------------|
+| [`get()`](#get) | [`bulkGet()`](#bulkget) | [`query()`](#query) | [`changes()`](#changes) |
+| [`put()`](#put) | [`bulkSave()`](#bulksave) | [`queryStream()`](#querystream) | [`watchDocs()`](#watchDocs) 🍭 |
+| [`patch()`](#patch) 🍭 | [`bulkRemove()`](#bulkremove) |  | |
+| [`patchDangerously()`](#patchdangerously) 🍭 | [`bulkGetDictionary()`](#bulkgetdictionary) 🍭 | | |
+| [`getAtRev()`](#getatrev) 🍭 | [`bulkSaveTransaction()`](#bulksavetransaction) 🍭 | | |
+| [`createLock()`](#createLock) 🍭 | | | |
+| [`removeLock()`](#removeLock) 🍭 | | | |
+
+And some utility apis
+
+ - [`createQuery()`](#createquery) 🍭
+ - [`withRetry()`](#withretry)
+ 
 
 ### Setup
 
@@ -26,24 +43,6 @@ const db = bindConfig(process.env)
 const doc = db.get('doc-123')
 ```
 
-### API Quick Reference
-
-| Document Operations | Bulk Operations | View Operations |
-|-------------------|-----------------|-----------------|
-| [`get()`](#get) | [`bulkGet()`](#bulkget) | [`query()`](#query) |
-| [`put()`](#put) | [`bulkSave()`](#bulksave) | [`queryStream()`](#querystream) |
-| [`patch()`](#patch) | [`bulkRemove()`](#bulkremove) | [`createQuery()`](#createquery) |
-| [`patchDangerously()`](#patchdangerously) | [`bulkGetDictionary()`](#bulkgetdictionary) | |
-| [`getAtRev()`](#getatrev) | [`bulkSaveTransaction()`](#bulksavetransaction) | |
-
-
-Some *Sugar* API helpers
-
- - [`createLock()`](#createLock)
- - [`removeLock()`](#removeLock)
- - [`changes()`](#changes)
- - [`watchDocs()`](#watchDocs)
-
 ### Document Operations
 
 #### get
@@ -284,7 +283,7 @@ const results = await bulkRemove(config, ids)
 
 #### bulkGetDictionary
 
-Adds some convenience to bulkGet. Found and notFound documents are separated. Both properties are records of id to result. This makes it easy to deal with the results.
+Adds some convenience to bulkGet. Organizes found and notFound documents into properties that are {id:result}. This makes it easy to deal with the results.
 
 **Parameters:**
 - `config`: Object with `couch` URL string
@@ -480,79 +479,9 @@ const init = async () => {
 }
 init()
 ```
-Advanced Config Options
-=======================
-
-The config object supports the following properties:
-
-| Property | Type | Default | Description |
-|----------|------|---------|-------------|
-| couch | string | required | The URL of the CouchDB database |
-| throwOnGetNotFound | boolean | false | If true, throws an error when get() returns 404. If false, returns undefined |
-| bindWithRetry | boolean | true | When using bindConfig(), adds retry logic to bound methods |
-| maxRetries | number | 3 | Maximum number of retry attempts for retryable operations |
-| initialDelay | number | 1000 | Initial delay in milliseconds before first retry |
-| backoffFactor | number | 2 | Multiplier for exponential backoff between retries |
-| useConsoleLogger | boolean | false | If true, enables console logging when no logger is provided |
-| logger | object/function | undefined | Custom logging interface (winston-style object or function) |
-
-Example configuration with all options:
-```javascript
-const config = {
-  couch: 'http://localhost:5984/mydb',
-  throwOnGetNotFound: true,
-  bindWithRetry: true,
-  maxRetries: 5,
-  initialDelay: 2000,
-  backoffFactor: 1.5,
-  useConsoleLogger: true,
-  logger: (level, ...args) => console.log(level, ...args)
-}
-```
 
-
-Logging Support
-==============
-
-The library supports flexible logging options that can be configured through the config object:
-
-```javascript
-// Enable console logging (error, warn, info, debug)
-const config = { 
-  couch: 'http://localhost:5984/mydb',
-  useConsoleLogger: true
-}
-
-// Use a custom logger object (winston-style)
-const config = {
-  couch: 'http://localhost:5984/mydb',
-  logger: {
-    error: (msg) => console.error(msg),
-    warn: (msg) => console.warn(msg),
-    info: (msg) => console.info(msg),
-    debug: (msg) => console.debug(msg)
-  }
-}
-
-// Use a simple function logger
-const config = {
-  couch: 'http://localhost:5984/mydb',
-  logger: (level, ...args) => console.log(level, ...args)
-}
-```
-
-The logger will track operations including:
-- Document operations (get, put, patch)
-- Bulk operations
-- View queries
-- Streaming operations
-- Retries and error handling
-
-Each operation logs appropriate information at these levels:
-- error: Fatal/unrecoverable errors
-- warn: Retryable errors, conflicts
-- info: Operation start/completion
-- debug: Detailed operation information
+Want to consume this in the browser? I'd recomment https://www.npmjs.com/package/ndjson-readablestream 
+here is a react component that consumes it https://github.com/Azure-Samples/azure-search-openai-demo/pull/532/files#diff-506debba46b93087dc46a916384e56392808bcc02a99d9291557f3e674d4ad6c
 
 #### changes()
 
@@ -659,3 +588,77 @@ Watch specific documents for changes in real-time.
  - Triggering actions when particular documents change
  - Maintaining cached copies of frequently accessed documents
 
+Advanced Config Options
+=======================
+
+The config object supports the following properties:
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| couch | string | required | The URL of the CouchDB database |
+| throwOnGetNotFound | boolean | false | If true, throws an error when get() returns 404. If false, returns undefined |
+| bindWithRetry | boolean | true | When using bindConfig(), adds retry logic to bound methods |
+| maxRetries | number | 3 | Maximum number of retry attempts for retryable operations |
+| initialDelay | number | 1000 | Initial delay in milliseconds before first retry |
+| backoffFactor | number | 2 | Multiplier for exponential backoff between retries |
+| useConsoleLogger | boolean | false | If true, enables console logging when no logger is provided |
+| logger | object/function | undefined | Custom logging interface (winston-style object or function) |
+
+Example configuration with all options:
+```javascript
+const config = {
+  couch: 'http://localhost:5984/mydb',
+  throwOnGetNotFound: true,
+  bindWithRetry: true,
+  maxRetries: 5,
+  initialDelay: 2000,
+  backoffFactor: 1.5,
+  useConsoleLogger: true,
+  logger: (level, ...args) => console.log(level, ...args)
+}
+```
+
+
+Logging Support
+==============
+
+The library supports flexible logging options that can be configured through the config object:
+
+```javascript
+// Enable console logging (error, warn, info, debug)
+const config = { 
+  couch: 'http://localhost:5984/mydb',
+  useConsoleLogger: true
+}
+
+// Use a custom logger object (winston-style)
+const config = {
+  couch: 'http://localhost:5984/mydb',
+  logger: {
+    error: (msg) => console.error(msg),
+    warn: (msg) => console.warn(msg),
+    info: (msg) => console.info(msg),
+    debug: (msg) => console.debug(msg)
+  }
+}
+
+// Use a simple function logger
+const config = {
+  couch: 'http://localhost:5984/mydb',
+  logger: (level, ...args) => console.log(level, ...args)
+}
+```
+
+The logger will track operations including:
+- Document operations (get, put, patch)
+- Bulk operations
+- View queries
+- Streaming operations
+- Retries and error handling
+
+Each operation logs appropriate information at these levels:
+- error: Fatal/unrecoverable errors
+- warn: Retryable errors, conflicts
+- info: Operation start/completion
+- debug: Detailed operation information
+

package/impl/changes.mjs

@@ -12,15 +12,10 @@ import { Changes } from '../schema/changes.mjs'
  * }} ChangeInfo */
 // @ts-ignore
 import ChangesStream from 'changes-stream'
-import { createLogger } from './logger.mjs'
-import { sleep } from './patch.mjs'
-
-const MAX_RETRY_DELAY = 30000 // 30 seconds
 
 /** @type { import('../schema/changes.mjs').ChangesSchema } */
 export const changes = Changes.implement(async (config, onChange, options = {}) => {
   const emitter = new EventEmitter()
-  const logger = createLogger(config)
   options.db = config.couch
   if (options.since && options.since === 'now') {
     const opts = {
@@ -37,12 +32,12 @@ export const changes = Changes.implement(async (config, onChange, options = {})
   const changes = ChangesStream(options)
 
   changes.on('readable', () => {
-    const change = changes.read();
+    const change = changes.read()
     if (change.results && Array.isArray(change.results)) {
       // emit each one seperate
       change.results.forEach((/** @type {ChangeInfo} */ c) => emitter.emit('change', c))
     } else emitter.emit('change', change)
-  });
+  })
 
   // Bind the provided change listener
   emitter.on('change', onChange)

package/impl/errors.mjs

@@ -11,7 +11,7 @@ export class NotFoundError extends Error {
    * @param {string} docId - The ID of the document that wasn't found
    * @param {string} [message] - Optional error message
    */
-  constructor(docId, message = 'Document not found') {
+  constructor (docId, message = 'Document not found') {
     super(message)
     this.name = 'NotFoundError'
     this.docId = docId

package/impl/query.mjs

@@ -22,7 +22,6 @@ export const query = SimpleViewQuery.implement(async (config, view, options = {}
 
   // @ts-ignore
   let qs = queryString(options, ['key', 'startkey', 'endkey', 'reduce', 'group', 'group_level', 'stale', 'limit'])
-  logger.debug('Generated query string:', qs)
   let method = 'GET'
   let payload = null
   const opts = {
@@ -35,21 +34,30 @@ export const query = SimpleViewQuery.implement(async (config, view, options = {}
   // If keys are supplied, issue a POST to circumvent GET query string limits
   // see http://wiki.apache.org/couchdb/HTTP_view_API#Querying_Options
   if (typeof options.keys !== 'undefined') {
-    const MAX_URL_LENGTH = 2000;
+    const MAX_URL_LENGTH = 2000
     // according to http://stackoverflow.com/a/417184/680742,
     // the de facto URL length limit is 2000 characters
 
-    const keysAsString = `keys=${encodeURIComponent(JSON.stringify(options.keys))}`;
+    const _options = structuredClone(options)
+    delete _options.keys
+    qs = queryString(_options, ['key', 'startkey', 'endkey', 'reduce', 'group', 'group_level', 'stale', 'limit'])
+
+    const keysAsString = `keys=${JSON.stringify(options.keys)}`
+
     if (keysAsString.length + qs.length + 1 <= MAX_URL_LENGTH) {
       // If the keys are short enough, do a GET. we do this to work around
       // Safari not understanding 304s on POSTs (see pouchdb/pouchdb#1239)
-      qs += (qs[0] === '?' ? '&' : '?') + keysAsString;
+      method = 'GET'
+      if (qs.length > 0) qs += '&'
+      else qs = '?'
+      qs += keysAsString
     } else {
-      method = 'POST';
-      payload = {keys: options.keys};
+      method = 'POST'
+      payload = { keys: options.keys }
     }
   }
 
+  logger.debug('Generated query string:', qs)
   const url = `${config.couch}/${view}?${qs.toString()}`
   // @ts-ignore
   let results

package/impl/stream.mjs

@@ -25,7 +25,7 @@ export const queryStream = (rawConfig, view, options, onRow) => new Promise((res
   if (typeof options.keys !== 'undefined') {
     const MAX_URL_LENGTH = 2000
     const keysAsString = `keys=${encodeURIComponent(JSON.stringify(options.keys))}`
-    
+
     if (keysAsString.length + qs.length + 1 <= MAX_URL_LENGTH) {
       // If the keys are short enough, do a GET
       qs += (qs[0] === '?' ? '&' : '?') + keysAsString
@@ -70,7 +70,7 @@ export const queryStream = (rawConfig, view, options, onRow) => new Promise((res
     resolve(undefined) // all work should be done in the stream
   })
 
-  const req = method === 'GET' 
+  const req = method === 'GET'
     ? needle.get(url, opts)
     : needle.post(url, payload, opts)
 

package/impl/sugar/lock.mjs

@@ -5,7 +5,7 @@ import { createLogger } from '../logger.mjs'
 /** @type {import('../../schema/sugar/lock.mjs').CreateLockSchema} */
 export const createLock = CreateLock.implement(async (config, docId, options) => {
   const logger = createLogger(config)
-  
+
   if (!options.enableLocking) {
     logger.debug('Locking disabled, returning true')
     return true
@@ -37,7 +37,7 @@ export const createLock = CreateLock.implement(async (config, docId, options) =>
 /** @type {import('../../schema/sugar/lock.mjs').RemoveLockSchema} */
 export const removeLock = RemoveLock.implement(async (config, docId, options) => {
   const logger = createLogger(config)
-  
+
   if (!options.enableLocking) {
     logger.debug('Locking disabled, skipping unlock')
     return
@@ -50,7 +50,7 @@ export const removeLock = RemoveLock.implement(async (config, docId, options) =>
 
   const _id = `lock-${docId}`
   const existingLock = await get(config, _id)
-  
+
   if (!existingLock) {
     logger.debug(`No lock found for ${docId}`)
     return

package/impl/sugar/watch.mjs

@@ -28,7 +28,7 @@ export const watchDocs = WatchDocs.implement((config, docIds, onChange, options
     const includeDocs = options.include_docs ?? false
     const ids = _docIds.join('","')
     const url = `${config.couch}/_changes?feed=${feed}&since=${lastSeq}&include_docs=${includeDocs}&filter=_doc_ids&doc_ids=["${ids}"]`
-    
+
     const opts = {
       headers: { 'Content-Type': 'application/json' },
       parse_response: false
@@ -37,79 +37,79 @@ export const watchDocs = WatchDocs.implement((config, docIds, onChange, options
     let buffer = ''
     currentRequest = needle.get(url, opts)
 
-  currentRequest.on('data', chunk => {
-    buffer += chunk.toString()
-    const lines = buffer.split('\n')
-    
-    // Keep the last partial line in the buffer
-    buffer = lines.pop() || ''
+    currentRequest.on('data', chunk => {
+      buffer += chunk.toString()
+      const lines = buffer.split('\n')
 
-    // Process complete lines
-    for (const line of lines) {
-      if (line.trim()) {
-        try {
-          const change = JSON.parse(line)
-          if (!change.id) return null // ignore just last_seq
-          logger.debug(`Change detected, watching [${_docIds}]`, change)
-          lastSeq = change.seq || change.last_seq
-          emitter.emit('change', change)
-        } catch (err) {
-          logger.error('Error parsing change:', err, 'Line:', line)
+      // Keep the last partial line in the buffer
+      buffer = lines.pop() || ''
+
+      // Process complete lines
+      for (const line of lines) {
+        if (line.trim()) {
+          try {
+            const change = JSON.parse(line)
+            if (!change.id) return null // ignore just last_seq
+            logger.debug(`Change detected, watching [${_docIds}]`, change)
+            lastSeq = change.seq || change.last_seq
+            emitter.emit('change', change)
+          } catch (err) {
+            logger.error('Error parsing change:', err, 'Line:', line)
+          }
         }
       }
-    }
-  })
+    })
 
-  currentRequest.on('response', response => {
-    logger.debug(`Received response with status code, watching [${_docIds}]: ${response.statusCode}`)
-    if (RetryableError.isRetryableStatusCode(response.statusCode)) {
-      logger.warn(`Retryable status code received: ${response.statusCode}`)
-      currentRequest.abort()
-      handleReconnect()
-    } else {
-      // Reset retry count on successful connection
-      retryCount = 0
-    }
-  })
-
-  currentRequest.on('error', async err => {
-    if (stopping) {
-      logger.info('stopping in progress, ignore stream error')
-      return
-    }
-    logger.error(`Network error during stream, watching [${_docIds}]:`, err.toString())
-    try {
-      RetryableError.handleNetworkError(err)
-    } catch (filteredError) {
-      if (filteredError instanceof RetryableError) {
-        logger.info(`Retryable error, watching [${_docIds}]:`, filteredError.toString())
+    currentRequest.on('response', response => {
+      logger.debug(`Received response with status code, watching [${_docIds}]: ${response.statusCode}`)
+      if (RetryableError.isRetryableStatusCode(response.statusCode)) {
+        logger.warn(`Retryable status code received: ${response.statusCode}`)
+        currentRequest.abort()
         handleReconnect()
       } else {
-        logger.error(`Non-retryable error, watching [${_docIds}]`, nonRetryErr)
-        emitter.emit('error', nonRetryErr)
+      // Reset retry count on successful connection
+        retryCount = 0
       }
-    }
-  })
+    })
 
-  currentRequest.on('end', () => {
-    // Process any remaining data in buffer
-    if (buffer.trim()) {
+    currentRequest.on('error', async err => {
+      if (stopping) {
+        logger.info('stopping in progress, ignore stream error')
+        return
+      }
+      logger.error(`Network error during stream, watching [${_docIds}]:`, err.toString())
       try {
-        const change = JSON.parse(buffer)
-        logger.debug('Final change detected:', change)
-        emitter.emit('change', change)
-      } catch (err) {
-        logger.error('Error parsing final change:', err)
+        RetryableError.handleNetworkError(err)
+      } catch (filteredError) {
+        if (filteredError instanceof RetryableError) {
+          logger.info(`Retryable error, watching [${_docIds}]:`, filteredError.toString())
+          handleReconnect()
+        } else {
+          logger.error(`Non-retryable error, watching [${_docIds}]`, filteredError.toString())
+          emitter.emit('error', filteredError)
+        }
       }
-    }
-    logger.info('Stream completed. Last seen seq: ', lastSeq)
-    emitter.emit('end', { lastSeq })
-    
-    // If the stream ends and we're not stopping, attempt to reconnect
-    if (!stopping) {
-      handleReconnect()
-    }
-  })
+    })
+
+    currentRequest.on('end', () => {
+    // Process any remaining data in buffer
+      if (buffer.trim()) {
+        try {
+          const change = JSON.parse(buffer)
+          logger.debug('Final change detected:', change)
+          emitter.emit('change', change)
+        } catch (err) {
+          logger.error('Error parsing final change:', err)
+        }
+      }
+      logger.info('Stream completed. Last seen seq: ', lastSeq)
+      emitter.emit('end', { lastSeq })
+
+      // If the stream ends and we're not stopping, attempt to reconnect
+      if (!stopping) {
+        handleReconnect()
+      }
+    })
   }
 
   const handleReconnect = async () => {
@@ -123,10 +123,10 @@ export const watchDocs = WatchDocs.implement((config, docIds, onChange, options
 
     const delay = Math.min(initialDelay * Math.pow(2, retryCount), maxDelay)
     retryCount++
-    
+
     logger.info(`Attempting to reconnect in ${delay}ms (attempt ${retryCount} of ${maxRetries})`)
     await sleep(delay)
-    
+
     try {
       connect()
     } catch (err) {

package/log.txt

@@ -0,0 +1,84 @@
+[Tue, 25 Feb 2025 02:45:58 GMT] [info] [<0.000.0>] pouchdb-server has started on http://127.0.0.1:8985/
+[Tue, 25 Feb 2025 02:45:58 GMT] [info] [<0.000.0>] database is in-memory; no changes will be saved.
+[Tue, 25 Feb 2025 02:45:58 GMT] [info] [<0.000.0>] navigate to http://127.0.0.1:8985/_utils for the Fauxton UI.
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/testdoc 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc 200
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc-not-there 404
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc-not-there 404
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/notThereDoc 409
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-1 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-2 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-2 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-3 201
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:45:59 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/a 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-3 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/conflict-test 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:conflict-error 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:bulk-error 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 409
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 404
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Tue, 25 Feb 2025 02:46:00 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock-2 404
+[Tue, 25 Feb 2025 02:48:53 GMT] [info] [<0.000.0>] pouchdb-server has started on http://127.0.0.1:8985/
+[Tue, 25 Feb 2025 02:48:53 GMT] [info] [<0.000.0>] database is in-memory; no changes will be saved.
+[Tue, 25 Feb 2025 02:48:53 GMT] [info] [<0.000.0>] navigate to http://127.0.0.1:8985/_utils for the Fauxton UI.
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/testdoc 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc-not-there 404
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc-not-there 404
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/notThereDoc 409
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-1 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-2 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-2 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-3 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/a 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-3 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/conflict-test 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:conflict-error 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:bulk-error 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 409
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 404
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Tue, 25 Feb 2025 02:48:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock-2 404

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hide-a-bed",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "description": "An abstraction over couchdb calls that includes easy mock/stubs with pouchdb",
   "module": "index.mjs",
   "main": "cjs/index.cjs",

package/schema/changes.mjs

@@ -4,7 +4,7 @@ import { CouchDoc } from './crud.mjs'
 
 export const ChangesOptions = z.object({
   feed: z.enum(['continuous', 'longpoll']).default('continuous'),
-  filter: z.any(), //z.union([z.string(), z.array()]).optional(),
+  filter: z.any(), // z.union([z.string(), z.array()]).optional(),
   inactivity_ms: z.number().default(60 * 60 * 1000),
   /** @type {number} */
   timeout: z.number().optional(),