Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@surfskip/api-types

Package Overview
Dependencies
Maintainers
2
Versions
102
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@surfskip/api-types

Gives up-to-date typings for our SurfSkip API to use with @elysiajs/eden to provide a full client with type safety.

  • 0.43.5
  • npm
  • Socket score

Version published
Maintainers
2
Created
Source

surfskip-api

An API written using Bun and Elysia for our web application.

This repository hosts the server code, but as you can see, we export typings for our NPM package to use them with @elysiajs/eden to deliver a full type safe client.

Usage of the NPM package with @elysiajs/eden

Install the packages using...

# With pnpm...
pnpm add @surfskip/api-types @elysiajs/eden

and import them wherever in your code...

import type { SurfSkipApi } from "@surfskip/api-types";
import { edenTreaty } from "@elysiajs/eden";

export const api = edenTreaty<SurfSkipApi>("https://api.surfskip.com");

You're setup! You can now use this api object to call whatever function from our API. If needed, you can read more about how @elysiajs/eden works.

Contributing to repository

We use Bun for that API. That means that we have to use WSL for development on Windows, else a Linux or macOS machine works fine.

Windows support is currently in development.

Bun can be installed with the following command:

curl -fsSL https://bun.sh/install | bash

If you have Bun installed, you can now install the dependencies with the following command:

bun install

Add environment variables

Make a copy of .env.example to .env. This file will contain the secrets variables, and should not be pushed to GitHub.

cp .env.example .env

Scripts

Here's an overview of the scripts defined in package.json.

CommandDescription
bun startStarts the development servers without hot reloading.
bun run devStarts the development servers with hot reloading.
bun releaseStarts the development servers with hot reloading.
bun run build:typesCreates the typings for the actual server code and put them into the /dist folder. These are the typings we'll publish to NPM.
bun run build:binaryCreates a binary for the actual server code. The binary built is then used in our production servers.

Install as a service on Linux

Bundle the app using bun run build:binary, this will create a binary named bin in the root folder.

We'll now create a service to run the binary. Run...

sudo nano /lib/systemd/system/surfskip-api.service

and input in that file, the following content...

[Unit]
Description=
After=network.target

[Service]
Type=simple
ExecStart=/home/ubuntu/surfskip-api/bin

[Install]
WantedBy=multi-user.target

Don't forget to change the ExecStart property with the one for your case.

Now, we'll start and enable the service using systemctl.

sudo systemctl enable --now surfskip-api

Now you can check its logs using...

sudo systemctl status surfskip-api

and restart using...

sudo systemctl restart surfskip-api

You're now good to go !

FAQs

Package last updated on 15 Nov 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc