@kba/anno-store
Open Annotation Store (base class)
Last updated 2 years ago by kba .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @kba/anno-store 
SYNC missed versions from official npm registry.

anno-store

Interface for stores

Implementing a store

To implement a store, override the Public API with this convention:

  • Prepend and underscore to the method name
  • Method takes exactly two parameters: context and callback
  • All positional parameters become keys in the context object

For example to override the create(anno, options, callback) method:

// my-store/index.js
class MyStore extends require('@kba/anno-store') {
  
  _create(options, callback) {
    const anno = options.anno
    // ...
    return callback(...)
  }
}

Public API

static load(loadingModule)

Modules may call this static method to instantiate a store from the environment and using the packages installed in the calling package.

// my-package/index.js
const store = require('@kba/anno-store').load(module)
store.init(...)

use(middleware)

Use middleware for auth etc.

init(options, cb)

Initialize a connection to the store.

  • @param {Options} options
  • @param {String} options.user
  • @param {function} callback

wipe(options, callback)

Wipe the store, revisions and all.

  • @param {Options} options
  • @param {String} options.user
  • @param {function} callback

disconnect(options, callback)

Disconnect a store. A disconnected store cannot be used until init is called again.

  • @param {Options} options
  • @param {String} options.user
  • @param {function} callback

get(annoId, options, cb)

Retrieve an annotation.

  • @param {String|Array<String>} annoIds
  • @param {Object} options
    • @param {Boolean} options.latest Return the latest revision only
    • @param {Boolean} options.metadataOnly Return only metadata
    • @param {Boolean} options.skipVersions Omit versions
    • @param {Boolean} options.skipReplies Omit replies
  • @param {String} options.user
  • @param {function} callback

create(anno, options, callback)

Create an annotation.

  • @param {Object} anno
  • @param {Options} options
  • @param String options.slug Proposal for the ID to create
  • @param {String} options.user
  • @param {function} callback

revise(annoId, anno, options, callback)

Revise an annotation.

  • @param {String} annoId
  • @param {Object} anno
  • @param {Options} options
    • @param {String} options.user
  • @param {function} callback

delete(annoId, options, callback)

remove(annoId, options, callback)

Delete an annotation, i.e. set the deleted date.

  • @param {String} annoId
  • @param {Options} options
  • @param {Boolean} options.forceDelete Set to true to hint the store to actually delete, not just mark deleted
  • @param {String} options.user
  • @param {function} callback

search(query, options, callback)

Search the store.

  • @param {Object} query
  • @param {Options} options
  • @param {String} options.user
  • @param {function} callback

reply(annoId, anno, options, callback)

comment(annoId, anno, options, callback)

Reply to an annotation

  • @param {String} annoId
  • @param {Object} anno
  • @param {Options} options
  • @param {String} options.user
  • @param {function} callback

aclcheck(targets, options, callback)

  • @param {Array} targets
  • @param {Options} options
  • @param {function} callback

import(anno, options, callback)

Replaces the complete annotation with the passed annotation, not just revise it.

  • @param {Object} anno
  • @param {Options} options
    • @param String options.slug Proposal for the ID to create
    • @param {String} options.user
  • @param {function} callback

Protected API

These methods are available for store implementations but should not be used by consumers.

_idFromURL(url)

Get only the slug part of a URL

_urlFromId(annoId)

Generate a full URL to an annotation by its id.

_normalizeTarget(annoDoc)

TODO no idempotency of targets with normalization -> disabled for now

_normalizeType(anno)

Make sure anno.type exists, is an Array and contains Annotation

deleteId(anno)

Delete the id and store it in via.

  • @param Object anno

_genid(slug='')

Generate an ID for the annotation from slug and a "nice" slugid

Current Tags

  • 0.0.8                                ...           latest (2 years ago)

6 Versions

  • 0.0.8                                ...           2 years ago
  • 0.0.6                                ...           3 years ago
  • 0.0.4                                ...           3 years ago
  • 0.0.3                                ...           3 years ago
  • 0.0.2                                ...           3 years ago
  • 0.0.1                                ...           3 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 7
Last Month 11
Dependencies (7)
Dev Dependencies (0)
None

Copyright 2014 - 2016 © taobao.org |