Node

One call that wraps the HTTP API's bearer door, with nothing else in the dependency tree. The token is your source's ylk_…, from its page.

Install

Node 18 and up, Bun and Deno. ESM and CommonJS, with types. The same package runs in React Native and Expo.

$ npm install youlmk

Send

import { notify } from "youlmk";
await notify(process.env.YOULMK_TOKEN, "deploy finished", {
body: "production · 4 min 12 s",
priority: "normal",
url: "https://example.com/deploys/2041",
});

For code that sends more than once, new YouLMK(token) keeps the token and .notify(title, options) sends. Options are the payload's fields in camelCase (urlLabel, fields, group, image, actions) plus idempotencyKey. The answer is { id, receipt, grouped, held }. An error is a YouLMKError with status, the door's code, the field for a 422 and retryAfter for a 429.

Which to use

A shell has curl and the command line, which is this package's npx youlmk. A server has this. An app you ship sends through its own server, or through a source whose Reach you are happy to let strangers reach, since a token inside an app is public.

Next

Python: One call from Python 3.9 and up, with the standard library only. · React Native · Command line