carbonldp

CarbonLDP JavaScript SDK

Official JavaScript SDK for Carbon LDP applications. Simplifies the use of Carbon LDP's REST API.

For information on how to use the SDK, please refer to the JavaScript SDK user guide on the Carbon LDP website.

Installing

npm install carbonldp

Development setup

• Install dependencies
  • node.js 6+
• cd into the project's root directory
• Run npm install
• Build the source code by running npm start

Main gulp tasks

• build: Same as npm start. Build the source code and prepare it for production (inside the dist/ folder)
• lint: Same as npm lint. Run TSLint over the source code to perform static code analysis.
• test: Same as npm test. Run the test in both Node.js and Google Chrome.

File structure

├── .circleci                           # CircleCI's configuration files (automated build and deploy system)
├── .idea                               # WebStorm shared configuration files (like code style)
├── build                               # Build related scripts
│   ├── license.js                      # Contains the license to append to the build
│   ├── sfx.ts                          # Main file that feeds the SFX building process
│   └── docs                            # Templates for build the different types of API documentation
│       ├── html                        # Templates for html documentation (used for github pages)
│       └── markdown                    # Templates for markdown documentation
├── config                              # Configuration files used while bundling the application
│   ├── karma.conf.js                   # Actual Karma test runner configuration file
│   ├── webpack.common.js               # Webpack's settings used by every mode
│   ├── webpack.prod.js                 # Webpack bundling settings for PRODUCTION mode
│   └── webpack.test.js                 # Webpack bundling settings for TESTING mode
├── dist                                # Distribution related files
│   └── bundles                         # Contains the bundled versions of the entire SDK
├── docs                                # JS SDK's API docucmentation files
├── node_modules                        # npm dependencies (don't touch them)
├── playground                          # Informal testing ground (TODO: Clean directory)
├── src                                 # All source files
├── test                                # Test framework related files (not the real tests)
├── .gitignore                          # Ignore file for git
├── .nvmrc                              # nvm configuration file that specifies supported Node.js version (for development)
├── CHANGELOG.md                        # File to track package changes
├── gulpfile.ts                         # Gulp's configuration file
├── karma.conf.js                       # Karma configuration file used for the Browser tests
├── LICENSE                             # Self explanatory
├── package.json                        # npm's configuration file
├── package-lock.json                   # npm's with the exact desired dependency tree
├── README.md                           # this
├── tsconfig.json                       # Typescript compiler configuration file
├── tslint.json                         # TSLint configuration file
└── webpack.config.js                   # Webpack configuration used to bundle the SDK

License

Copyright (c) 2015-present, Base22 Technology Group, LLC
All rights reserved.

This source code is licensed under the BSD-style license found in the
LICENSE file in the root directory of this source tree.

Changelog

[5.2.0] - 2019-04-10

Added

• #336 - Support TypeScript's strict mode
• #345 - Support for TypeScript 3.2
• #337 - Retrieve all properties of a document with additional sub-properties<br> Example:<br>

  carbonldp.documents.$get( "posts/a-post/", _ => _
      .properties( _.all )
      .properties( {
          "comments": {
          "query": _ => _
              .properties( {
                  "author": _.inherit,
                  "content": _.inherit,
              } ),
          },
      } )
  );
  

• Improve bundle size using rollup

Fixed

• #338 - Fix $removeMember()/$removeMembers() in Node.js
• #366 - Fix error in bundle with undefined global variable
• #368 - Fix ignore of _.withType() filter when used along _.properties( _.all )