Kitsas Addon Library

Library for Kitsas Addons. See also Template for Kitsas Addons and Kitsas Library

Documentation on GitHub Pages

Installation

npm install --save kitsas-addon-library
Copy

Creating an addon

Create an addon instance

import { KitsasAddon } from 'kitsas-addon-library';
const addon = new KitsasAddon({
  appName: 'My Addon',
});

export default addon;
Copy

Options can be configured with AddonOptions or environment variables.

Create routers

import addon from './addon';
import { AddonCall } from 'kitsas-addon-library';
import { Request, Response } from 'express';
const router = addon.createRouter('/addon');

router.get('/', async (req: Request, res: Response) => {
  const call = new AddonCall(req);
  const logs = await call.getLogs();

  if (call.isActive()) {
    res.render('main', { logs: logs });
  } else {
    res.render('introduction');
  }
});

export default router;
Copy

Usually router handles get an AddonCall object containing information about the call and methods to interact with the Kitsas Server.

Create index.ts

import addon from './addon';

import addonRouter from './addonRouter';

void addon.start([addonRouter]);
Copy

Remember to include all the routers in the start call!