mirror of
https://github.com/gosticks/DefinitelyTyped.git
synced 2026-10-26 17:40:33 +00:00
71 lines
3.1 KiB
TypeScript
71 lines
3.1 KiB
TypeScript
// Type definitions for pouchdb-upsert 2.2
|
|
// Project: https://github.com/pouchdb/upsert
|
|
// Definitions by: Keith D. Moore <https://github.com/keithdmoore>, Andrew Mitchell <https://github.com/hotforfeature>, Eddie Hsu <https://github.com/apolkingg8>
|
|
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
|
|
// TypeScript Version: 2.4
|
|
|
|
/// <reference types="pouchdb-core" />
|
|
|
|
declare namespace PouchDB {
|
|
interface Database<Content extends {} = {}> {
|
|
/**
|
|
* Perform an upsert (update or insert) operation. Returns a Promise.
|
|
*
|
|
* @param docId - the _id of the document.
|
|
* @param diffFun - function that takes the existing doc as input and returns an updated doc.
|
|
* If this diffFunc returns falsey, then the update won't be performed (as an optimization).
|
|
* If the document does not already exist, then {} will be the input to diffFunc.
|
|
*
|
|
*/
|
|
upsert<Model>(docId: Core.DocumentId, diffFun: UpsertDiffCallback<Content & Model>): Promise<UpsertResponse>;
|
|
|
|
/**
|
|
* Perform an upsert (update or insert) operation. If a callback is not provided, the Promise based version
|
|
* of this function will be called.
|
|
*
|
|
* @param docId - the _id of the document.
|
|
* @param diffFun - function that takes the existing doc as input and returns an updated doc.
|
|
* If this diffFunc returns falsey, then the update won't be performed (as an optimization).
|
|
* If the document does not already exist, then {} will be the input to diffFunc.
|
|
* @param callback - called with the results after operation is completed.
|
|
*/
|
|
upsert<Model>(docId: Core.DocumentId, diffFun: UpsertDiffCallback<Content & Model>,
|
|
callback: Core.Callback<UpsertResponse>): void;
|
|
|
|
/**
|
|
* Put a new document with the given docId, if it doesn't already exist. Returns a Promise.
|
|
*
|
|
* @param doc - the document to insert. Should contain an _id if docId is not specified
|
|
* If the document already exists, then the Promise will just resolve immediately.
|
|
*/
|
|
putIfNotExists<Model>(doc: Core.Document<Content & Model>): Promise<UpsertResponse>;
|
|
|
|
//
|
|
/**
|
|
* Put a new document with the given docId, if it doesn't already exist. If a callback is not provided,
|
|
* the Promise based version of this function will be called.
|
|
*
|
|
* @param doc - the document to insert. Should contain an _id if docId is not specified
|
|
* If the document already exists, then the Promise will just resolve immediately.
|
|
* @param callback - called with the results after operation is completed.
|
|
* If you don't specify a callback, then the Promise version of this function will be invoked and it
|
|
* will return a Promise.
|
|
*/
|
|
putIfNotExists<Model>(doc: Core.Document<Content & Model>,
|
|
callback: Core.Callback<UpsertResponse>): void;
|
|
}
|
|
|
|
type UpsertDiffCallback<Content extends {}> = (doc: Core.Document<Content> | {}) => Core.Document<Content> | boolean;
|
|
|
|
interface UpsertResponse {
|
|
id: Core.DocumentId;
|
|
rev: Core.RevisionId;
|
|
updated: boolean;
|
|
}
|
|
}
|
|
|
|
declare module 'pouchdb-upsert' {
|
|
const plugin: PouchDB.Plugin;
|
|
export = plugin;
|
|
}
|