@eik/common

This package contains common utilities and schemas used in other Eik modules.

Schema

The schema for eik.json can be found here in this repo. Here is how you can use it in your eik.json.

{
    "$schema": "https://raw.githubusercontent.com/eik-lib/common/main/lib/schemas/eikjson.schema.json",
    "name": "my-app",
    "version": "1.0.0",
    "server": "https://eik.store.com",
    "files": "./public",
    "import-map": ["https://eik.store.com/map/store/v1"]
}

@eik/common has a JavaScript API to check against the schema.

API

helpers

helpers has utility functions used by several other Eik modules.

import { helpers } from '@eik/common';

let config = helpers.getDefaults();

These are the available functions on helpers.

| Name | Description | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | getDefaults | Reads configuration from eik.json or package.json. Includes defaults for missing optional settings. | | localAssets | Sets up asset routes for local development. Mounted paths match those on Eik server and values are read from projects eik.json file. | | typeSlug | Maps between Eik configuration values for the package type and its URL/file system value. | | typeTitle | Maps between a type config value and its title. Essentially uppercases the input. | | addTrailingSlash | | | removeTrailingSlash | | | addLeadingSlash | | | removeLeadingSlash | | | resolveFiles | Uses an Eik JSON "files" definition to resolve files on disk into a data structure. Returns a list of ResolvedFile. | | configStore | Collection of helper methods for reading and writing Eik configuration files. |

localAssets

Sets up asset routes for local development. Mounted paths match those on Eik server and values are read from projects eik.json file.

Given this server and eik.json, the following routes would be added to your app.

import { helpers } from '@eik/common';
import express from 'express';

let app = express();

await helpers.localAssets(app);

{
    "name": "my-app",
    "version": "1.0.0",
    "server": "https://eik.store.com",
    "files": {
        "esm.js": "./assets/esm.js",
        "esm.css": "./assets/esm.css",
        "/": "./assets/**/*.map"
    }
}

/pkg/my-app/1.0.0/esm.js
/pkg/my-app/1.0.0/esm.css
/pkg/my-app/1.0.0/esm.js.map
/pkg/my-app/1.0.0/esm.css.map

schemas

schemas has functions to check values against the eik.json schema. You can check a value against the schema for eik.json as a whole, or for individual values in the schema.

import { schemas } from '@eik/common';

let { error, value } = schemas.validate.eikJSON(eikConfig);
if (error) {
    // fallback
}

If you prefer, you can use the assert API which throws on error.

import { schemas } from '@eik/common';

try {
    schemas.assert.eikJSON(eikConfig);
} catch {
    // fallback
}

These are the available functions on schemas.validate and schemas.assert.

| Name | Description | | ----------- | ----------------------------------------------------------------------- | | eikJSON | Checks that the given value includes required fields that are valid | | name | Checks name | | version | Checks version | | type | Checks type | | server | Checks server | | files | Checks files | | importMap | Checks import-map | | out | Checks out |

stream

stream has functions to check that a value is a Stream.

import { stream } from '@eik/common';

if (stream.isStream(maybeStream)) {
    // yup, it's a Stream
}

if (stream.isReadableStream(maybeReadableStream)) {
    // yup, it's a ReadableStream
}

validators

validators functions return the provided string normalized to lowercase, or throw an Error if the value does not pass the validation rules. Where possible, prefer using the schemas API.

import { validators } from '@eik/common';

let alias = validators.alias('1');

These are the available functions on validators.

| Name | Description | | ------------ | ---------------------------------------------------------------- | | alias | Checks that a value is a valid alias value (ex 1) | | name | Checks that a value is a valid package name | | org | Checks that a value is a valid organisation name. | | origin | Check that a value looks like an HTTP origin. | | version | Checks that a value is a valid semver version | | semverType | Checks that a value is a valid semver type (major, minor, patch) | | type | Checks that the value is a valid Eik type (pkg, npm, map) |