SEB Spark

Public packages published under the @sebspark organisation on NPM.

Packages

@sebspark/logging

A pubsub subscriber helper.

@sebspark/pubsub

A wrapper around Google PubSub adding support for typing, serialization/deserialization, naming of subscriptions for specific topics, push routes and some more.

@sebspark/typed-router

An Express router wrapped with additional TypeScript typings and defintions for our purposes.

@sebspark/tsconfig

Default TypeScript configuration

@sebspark/iso-10383

ISO-10383 Market Identification Codes (MIC).

@sebspark/iso-4217

ISO-4217 currency codes.

@sebspark/avsc-ts

Generates Typescript from avro files

@sebspark/avsc-isometric

A stripped down version of avsc which works in node, browser and react-native

@sebspark/openapi-typegen

Generates types and a routerdefinition from OpenAPI specs

@sebspark/openapi-express

A typed router for express based on type definitions from openapi-typegen

@sebspark/openapi-core

Base types for OpenAPI/Typescript

@sebspark/openapi-client

A typed REST client for the definitions from openapi-typegen

@sebspark/openapi-e2e

End to end tests for openapi generator, express and client

@sebspark/retry

A helper for retrying any promise call (ex an http request) with error rules and backoff

@sebspark/opensearch

A wrapper for OpenSearch Client to assist with typed queries, indices etc

@sebspark/promise-cache

A simple caching wrapper for promises.

@sebspark/trading-hours

Find trading hours of a market, when it's closed for holidays, or when it's only open for part of the day.

@sebspark/tracing

Use Opentelemetry for collecting traces and exporting to Cloud Trace

@sebspark/gcp-iam

Google IAM utilities.

@sebspark/spanner-mock

A (so far incomplete) mocking library for Spanner DB

@sebspark/spanner-migrate

Migration tool for Spanner DB

Contributing

Get started

Install dependencies with yarn.

yarn

Run TypeScript for all packages in watch mode using yarn dev or a specific package using the filter flag, e.g., yarn dev --filter logging. Additional scripts for testing, linting, and building can be found in package.json.

Adding a new package

We use Turborepo's code generation to create new packages. Run the following command, provide it with information, and it will create a package with some default scripts and TypeScript configured.

yarn generate:package

Install dependencies to package

We use Yarn workspaces. To install a dependency to a specific workspace (package) use, for instance, yarn workspace @sebspark/logging add @types/jest. Note that the workspace name is the name defined in package.json, not the folder name.