hide-a-bed 5.0.5 → 5.1.1

package/README.md

@@ -40,9 +40,22 @@ A convience method to bind the config, so you dont need to pass it in.
 ```
 import { bindConfig } from 'hide-a-bed'
 const db = bindConfig(process.env)
-const doc = db.get('doc-123')
+const doc = await db.get('doc-123')
 ```
 
+##### Config Overrides
+
+You also can quickly change one (or more) config settings for a particular call with the db.config(options)
+
+eg
+
+```
+const doc = await db.config({ throwOnGetNotFound: true }).get('doc-id') 
+```
+
+You can pass any of [Config Options](#advanced-config-options) to db.config to override the original bindings.
+
+
 ### Document Operations
 
 #### get
@@ -412,6 +425,15 @@ const result = await query(config, view, options)
 // }
 ```
 
+Some notes on the keys. Use native js things for arrays keys, rather then strings. Eg
+
+ - ```{ startkey: ['ryan'], endkey: ['ryan', {}] }```
+ - ```{ startkey: [47, null], endkey: [48, null] }```
+ - ```{ startkey: [customerIdVar], endkey: [customerIdVar, {}] }```
+ - ```{ startkey: [teamId, userId, startTimestamp], endkey: [teamId, userId, endTimestamp] }```
+
+
+
 #### createQuery()
 Create a query builder to help construct view queries with a fluent interface. Note we have stuck to couch naming conventions and not camel case.
 
@@ -439,6 +461,11 @@ const options = createQuery()
 const result = await query(config, view, options)
 ```
 
+Again, use js types for array keys
+
+  - ```.startkey([teamId, userId]).endkey([teamId, userId, {}])```
+  - ```.startkey([teamId, userId, startTimestamp]).endkey([teamId, userId, endTimestamp])```
+
 #### queryStream
 
 Use Cases *Streaming Data*

package/cjs/index.cjs

@@ -86,13 +86,13 @@ const schema = {
   ChangesOptions: import_changes2.ChangesOptions,
   ChangesResponse: import_changes2.ChangesResponse
 };
-const bindConfig = import_bind.Bind.implement((config) => {
+function doBind(config) {
   const retryOptions = {
     maxRetries: config.maxRetries ?? 10,
     initialDelay: config.initialDelay ?? 1e3,
     backoffFactor: config.backoffFactor ?? 2
   };
-  return {
+  const result = {
     get: config.bindWithRetry ? (0, import_retry.withRetry)(import_crud.get.bind(null, config), retryOptions) : import_crud.get.bind(null, config),
     getAtRev: config.bindWithRetry ? (0, import_retry.withRetry)(import_crud.getAtRev.bind(null, config), retryOptions) : import_crud.getAtRev.bind(null, config),
     put: config.bindWithRetry ? (0, import_retry.withRetry)(import_crud.put.bind(null, config), retryOptions) : import_crud.put.bind(null, config),
@@ -112,4 +112,15 @@ const bindConfig = import_bind.Bind.implement((config) => {
     watchDocs: import_watch.watchDocs.bind(null, config),
     changes: import_changes.changes.bind(null, config)
   };
+  return result;
+}
+const bindConfig = import_bind.Bind.implement((config) => {
+  const parsedConfig = import_config.CouchConfig.parse(config);
+  const funcs = doBind(parsedConfig);
+  const reconfig = (_overrides) => {
+    const newConfig = { ...config, ..._overrides };
+    return bindConfig(newConfig);
+  };
+  const all = { ...funcs, options: reconfig };
+  return all;
 });

package/cjs/schema/bind.cjs

@@ -18,7 +18,9 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var bind_exports = {};
 __export(bind_exports, {
-  Bind: () => Bind
+  Bind: () => Bind,
+  BindBase: () => BindBase,
+  BindReturns: () => BindReturns
 });
 module.exports = __toCommonJS(bind_exports);
 var import_zod = require("zod");
@@ -31,7 +33,7 @@ var import_stream = require("./stream.cjs");
 var import_lock = require("./sugar/lock.cjs");
 var import_changes = require("./changes.cjs");
 var import_watch = require("./sugar/watch.cjs");
-const BindReturns = import_zod.z.object({
+const BindBase = import_zod.z.object({
   bulkGet: import_bulk.BulkGetBound,
   bulkSave: import_bulk.BulkSaveBound,
   bulkRemove: import_bulk.BulkRemoveBound,
@@ -48,4 +50,8 @@ const BindReturns = import_zod.z.object({
   changes: import_changes.ChangesBound,
   watchDocs: import_watch.WatchDocsBound
 });
+const RebindOptions = import_config.CouchConfig.omit({ couch: true });
+const BindReturns = BindBase.extend({
+  options: import_zod.z.function().args(RebindOptions).returns(BindBase)
+});
 const Bind = import_zod.z.function().args(import_config.CouchConfig).returns(BindReturns);

package/impl/retry.mjs

@@ -1,39 +1,49 @@
 import { RetryableError } from './errors.mjs'
 import { sleep } from './patch.mjs'
 
+/**
+ * Wraps a function with retry logic for RetryableError instances
+ * @param {Function} fn - The function to retry
+ * @param {Object} options - Retry options
+ * @param {number} [options.maxRetries=3] - Maximum number of retry attempts
+ * @param {number} [options.initialDelay=1000] - Initial delay in ms
+ * @param {number} [options.backoffFactor=2] - Multiplier for exponential backoff
+ * @param {number} [options.maxDelay] - Maximum delay between retries in ms
+ * @returns {Function} - Wrapped function with retry logic
+ */
 export function withRetry (fn, options = {}) {
   const {
     maxRetries = 3,
     initialDelay = 1000, // 1 second
-    backoffFactor = 2 // exponential backoff multiplier
+    backoffFactor = 2, // exponential backoff multiplier
+    maxDelay = 30000 // 30 seconds max delay
   } = options
 
   return async (...args) => {
-    let lastError
     let delay = initialDelay
 
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       try {
-        return await fn(...args)
+        // Clear any references to previous attempts
+        const result = await fn(...args)
+        return result
       } catch (error) {
-        lastError = error
-
         // Only retry if it's a RetryableError
         if (!(error instanceof RetryableError)) {
           throw error
         }
 
-        // If we've used all retries, throw the last error
+        // If we've used all retries, throw the error
         if (attempt === maxRetries) {
           throw error
         }
 
+        // Calculate next delay with a maximum cap
+        const nextDelay = Math.min(delay, maxDelay)
         // Wait with exponential backoff
-        await sleep(delay)
+        await sleep(nextDelay)
         delay *= backoffFactor
       }
     }
-
-    throw lastError
   }
 }

package/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["index.mjs"],"names":[],"mappings":"oBAEmC,iBAAiB;yBAAjB,iBAAiB;oBAAjB,iBAAiB;wBADkC,iBAAiB;yBAAjB,iBAAiB;sBAMjF,kBAAkB;4BACZ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAJP,kBAAkB;iCAAlB,kBAAkB;2BAH4B,iBAAiB;kCAAjB,iBAAiB;oCAAjB,iBAAiB;AAkDvG,uDAAuD;AACvD,yBADY,OAAO,mBAAmB,EAAE,UAAU,CA+BhD;0BAxEwB,kBAAkB;4BADhB,yBAAyB;2BAJd,uBAAuB;2BAAvB,uBAAuB;4BAOlC,qBAAqB;gCACQ,oBAAoB;wCAApB,oBAAoB;sCAEhC,qBAAqB;sBAArB,qBAAqB;yBAJoB,mBAAmB;wBAAnB,mBAAmB;2BAAnB,mBAAmB;kCAAnB,mBAAmB;oCAAnB,mBAAmB;yBAQ3B,mBAAmB;yBAAnB,mBAAmB;yBAAnB,mBAAmB;iCAAnB,mBAAmB;sBAHzD,oBAAoB;iCAApB,oBAAoB;8BAGkB,mBAAmB;qBAC5E,mBAAmB;qBAHkB,yBAAyB;0BACzD,0BAA0B;4BADM,yBAAyB;2BAAzB,yBAAyB;2BAAzB,yBAAyB;wBAH1B,sBAAsB;+BAAtB,sBAAsB;gCAAtB,sBAAsB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["index.mjs"],"names":[],"mappings":"oBAEmC,iBAAiB;yBAAjB,iBAAiB;oBAAjB,iBAAiB;wBADkC,iBAAiB;yBAAjB,iBAAiB;sBAMjF,kBAAkB;4BACZ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAJP,kBAAkB;iCAAlB,kBAAkB;2BAH4B,iBAAiB;kCAAjB,iBAAiB;oCAAjB,iBAAiB;AAoFvG,uDAAuD;AACvD,yBADY,OAAO,mBAAmB,EAAE,UAAU,CAuBhD;0BAlGwB,kBAAkB;4BADhB,yBAAyB;2BAJd,uBAAuB;2BAAvB,uBAAuB;4BAOlC,qBAAqB;gCACQ,oBAAoB;wCAApB,oBAAoB;sCAEhC,qBAAqB;sBAArB,qBAAqB;yBAJoB,mBAAmB;wBAAnB,mBAAmB;2BAAnB,mBAAmB;kCAAnB,mBAAmB;oCAAnB,mBAAmB;yBAQ3B,mBAAmB;yBAAnB,mBAAmB;yBAAnB,mBAAmB;iCAAnB,mBAAmB;sBAHzD,oBAAoB;iCAApB,oBAAoB;8BAGkB,mBAAmB;qBAC5E,mBAAmB;qBAHkB,yBAAyB;0BACzD,0BAA0B;4BADM,yBAAyB;2BAAzB,yBAAyB;2BAAzB,yBAAyB;wBAH1B,sBAAsB;+BAAtB,sBAAsB;gCAAtB,sBAAsB"}

package/index.mjs

@@ -48,12 +48,10 @@ const schema = {
   ChangesOptions,
   ChangesResponse
 }
-
-/** @type { import('./schema/bind.mjs').BindSchema } */
-const bindConfig = Bind.implement((
-  /** @type { import('./schema/config.mjs').CouchConfigSchema } */
-  config
-) => {
+/**
+  * @param {import('./schema/config.mjs').CouchConfigSchema } config
+  */
+function doBind (config) {
   // Default retry options
   const retryOptions = {
     maxRetries: config.maxRetries ?? 10,
@@ -61,7 +59,8 @@ const bindConfig = Bind.implement((
     backoffFactor: config.backoffFactor ?? 2
   }
 
-  return {
+  // Create the object without the config property first
+  const result = {
     get: config.bindWithRetry ? withRetry(get.bind(null, config), retryOptions) : get.bind(null, config),
     getAtRev: config.bindWithRetry ? withRetry(getAtRev.bind(null, config), retryOptions) : getAtRev.bind(null, config),
     put: config.bindWithRetry ? withRetry(put.bind(null, config), retryOptions) : put.bind(null, config),
@@ -80,6 +79,33 @@ const bindConfig = Bind.implement((
     watchDocs: watchDocs.bind(null, config),
     changes: changes.bind(null, config)
   }
+
+  return result
+}
+
+/** @type { import('./schema/bind.mjs').BindSchema } */
+const bindConfig = Bind.implement((
+  /** @type { import('./schema/config.mjs').CouchConfigSchema } */
+  config
+) => {
+  const parsedConfig = CouchConfig.parse(config)
+
+  /** @type { import('./schema/bind.mjs').BindBaseSchema } funcs */
+  const funcs = doBind(parsedConfig)
+
+  // Add the options function that returns a new bound instance
+  // this allows the user to override some options
+  const reconfig = (
+    /** @type any  */
+    _overrides
+  ) => {
+    // override the config and return doBind again
+    const newConfig = { ...config, ..._overrides }
+    return bindConfig(newConfig)
+  }
+  /** @type { import('./schema/bind.mjs').BindReturnsSchema } */
+  const all = { ...funcs, options: reconfig }
+  return all
 })
 
 export {

package/log.txt

@@ -0,0 +1,43 @@
+[Wed, 12 Mar 2025 14:28:53 GMT] [info] [<0.000.0>] pouchdb-server has started on http://127.0.0.1:8985/
+[Wed, 12 Mar 2025 14:28:53 GMT] [info] [<0.000.0>] database is in-memory; no changes will be saved.
+[Wed, 12 Mar 2025 14:28:53 GMT] [info] [<0.000.0>] navigate to http://127.0.0.1:8985/_utils for the Fauxton UI.
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/testdoc 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc-not-there 404
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc-not-there-override 404
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/testdoc-not-there 404
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/notThereDoc 409
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-1 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-2 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-2 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-3 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/a 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_bulk_docs 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:fsda-3 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/conflict-test 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:conflict-error 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/txn:bulk-error 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - POST /testdb/_all_docs?include_docs=true 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 409
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 404
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - PUT /testdb/lock-doc-to-lock 201
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Wed, 12 Mar 2025 14:28:54 GMT] [info] [<0.000.0>] 127.0.0.1 - - GET /testdb/lock-doc-to-lock 200
+[Wed, 12 Mar 2025 14:28: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.5",
+  "version": "5.1.1",
   "description": "An abstraction over couchdb calls that includes easy mock/stubs with pouchdb",
   "module": "index.mjs",
   "main": "cjs/index.cjs",
@@ -57,4 +57,4 @@
     "node": "20.17.0",
     "npm": "10.8.2"
   }
-}
+}