#CSCorporateSDK This SDK allows you to access information about Česká spořitelna a.s. Corporate API Corporate API.
If you just want to use the SDK, there are compiled files ready to be used in the
You can just copy these files directly from the repository or preferably, use
npm to install it into your project:
npm install https://github.com/Ceskasporitelna/cs-corporate-sdk-js.git --save
##Usage in browser
For usage in browser, pickup the following files from the
cs-corporate-sdk.sfx.js- CSCorporateSDK packaged for browsers
cs-corporate-sdk.sfx.d.ts- CSCorporateSDK typings for browsers
cs-corporate-sdk.sfx.js.map- CSCorporateSDK sourcemap for browsers
Corporate SDK is dependent on the CSCoreSDK.
You can find the appropriate verion of CSCoreSDK in
node_modules of corporate SDK if you installed it through
cs-core-sdk.sfx.js in your page before the
<script src="./node_modules/cs-corporate-sdk/node_modules/cs-core-sdk/dist/cs-core-sdk.sfx.js"></script> <script src="./node_modules/cs-corporate-sdk/dist/cs-corporate-sdk.sfx.js"></script>
The corporate SDK will be available in global variable
##Usage in node
For usage in node, install it through
npm (see above). You can then require it by:
var CSCorporateSDK = require('cs-corporate-sdk');
##Configuration Before using any CSAS SDKs in your application, you need to initialize CSCoreSDK by providing it your WebApiKey.
CSCoreSDK.useWebApiKey( "YourApiKey" ) //Get the corporate client var corporateClient = CSCorporateSDK.getClient();
See CoreSDK configuration guide for all the available configuration options.
##Usage Guide See Usage Guide for usage instructions.
#Development The SDK itself is written in TypeScript, packaged by webpack, tested by jasmine & karma and distributed thorugh npm. It uses tsd for TypeScript definitions.
In order to to develop upon this SDK, you will need the following installed globally:
webpack- For packaging
karma- For testing
tsd- For downloading typescript definitions
##Setup After cloning the repo, run the following command to initialize the repository for development:
npm install && tsd install
You can verify everything worked as expected by running:
##Directory structure This project uses the following directory structure:
dist- Packaged version of this SDK ready for use.
build- Build artifacts (not checked in repository)
lib- The SDK itself
spec- Tests for the SDK
typings- Typings used by the SDK
tooling- Commands for building and packaging
npm run clean- cleans
npm run build- performs
cleanand builds the SDK into
bulidfolder. It also generates
npm run dist- performs
buildcommand and copies the packaged SDK files into
npm run test- performs
buildand runs tests in node and browser.
npm run test-browser- performs tests only in browser
npm run test-node- performs tests only in node
npm version [major|minor|patch]- releases new version of the SDK. Requires write access to repository. See npm-version for more details.
#Contributing Contributions are more than welcome!
Please read our contribution guide to learn how to contribute to this project.
Please read our terms & conditions.