@odecloud/odecloud NPM

Official Site of @odecloud/odecloud

Summary ✨

Package contain helper functions currently utilized by a varieties of apps developed @odecloud.

Requirements

The package currently depend on these versions of Node and NPM.

$ node --version
v0.10.24

$ npm --version
1.3.21

Installation

Make you are currently in a Node project that contains a valid package.json file. Run the following below to download the package.

npm install @odecloud/odecloud

Usage Example

The example below assumes that your current project is using the latest ES6.

import OdeCloud from '@odecloud/odecloud';

// Instantiate the service
const odecloud = new OdeCloud({
  endpoint: "http://localhost:3000",
});

// Login to OdeCloud
// If you don't have an active OdeCloud's user account,
// then you can create one for free here: https://odecloud.app/signup
await odecloud.authenticate({
  email: "",    // your email
  password: "", // your password
});

const articles = await odecloud.articles.get({
  title: "Karl, San Francisco fog",
}); // return a list of articles matching the title

Local Testing/Development

You can download the package locally to your machine using:

$ git clone https://gitlab.com/odetech/odecloud.git @odecloud/odecloud

Publishing to NPM

On the root of the directory, open up package.json
Bump the version by the following guideline:
- Our version numbering follows Major.Minor.Patch (e.g. 2.10.1)
  - Major: Stable release.
  - Minor: Incremental changes--including new apis, remove apis, or change of behavior of apis.
  - Patch: Small efficient changes--including a fixed to a bug.
- Note: in regards to Patch if the old functionality was always erroneous, then it will be considered a Patch.
Publish a new tag on the repository by going to https://gitlab.com/odetech/odecloud/-/tags/new.
- Note: make sure that the "Tag Name" is an exact match to the version inside package.json on step #2.
- In regards to the "Release notes": we encourage detail and consistent format in order for other developers to understand the new version update.

Commands

npm test - Run tests with linting and coverage results.
npm type-check - TypeScript checking
type-check:watch - TypeScript checking and watching
npm run build - Babel will transpile ES6 and TypeScript => ES5 and minify the code.