@9d8/pager 0.1.0-beta.0

package/README.md

@@ -0,0 +1,29 @@
+# pager
+
+Minimal SDK for sending pages to a Pager deployment.
+
+## Install
+
+```bash
+bun add pager
+```
+
+## Usage
+
+```ts
+import { page } from "pager";
+
+await page("Database latency is climbing", ["prod", "db"]);
+```
+
+## Environment
+
+- `PAGER_API_KEY`: required API key created in the Pager dashboard
+- `PAGER_API_URL`: optional base URL override, useful for local or staging deployments
+
+Example:
+
+```bash
+export PAGER_API_KEY=pager_...
+export PAGER_API_URL=http://localhost:3000/api/v1
+```

package/dist/index.cjs

@@ -0,0 +1,78 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  createPagerClient: () => createPagerClient,
+  page: () => page
+});
+module.exports = __toCommonJS(index_exports);
+var import_fetch = require("@better-fetch/fetch");
+var DEFAULT_PAGER_API_URL = "https://pager.dev/api/v1";
+var pageImpl = null;
+var cachedApiKey;
+var cachedApiUrl;
+function createPagerClient(options = {}) {
+  const apiKey = options.apiKey ?? process.env.PAGER_API_KEY;
+  const baseURL = options.baseURL ?? process.env.PAGER_API_URL ?? DEFAULT_PAGER_API_URL;
+  const fetchFactory = options.fetchFactory ?? import_fetch.createFetch;
+  if (!apiKey) {
+    throw new Error("PAGER_API_KEY is not set");
+  }
+  const $fetch = fetchFactory({
+    baseURL,
+    throw: true,
+    headers: {
+      "X-API-Key": apiKey
+    }
+  });
+  return async (message, tags) => {
+    const data = await $fetch("/", {
+      method: "POST",
+      body: {
+        message,
+        tags: tags?.length ? tags : void 0
+      }
+    });
+    return data.messageId;
+  };
+}
+function getPageImpl() {
+  const apiKey = process.env.PAGER_API_KEY;
+  const apiUrl = process.env.PAGER_API_URL ?? DEFAULT_PAGER_API_URL;
+  if (pageImpl && cachedApiKey === apiKey && cachedApiUrl === apiUrl) {
+    return pageImpl;
+  }
+  cachedApiKey = apiKey;
+  cachedApiUrl = apiUrl;
+  pageImpl = createPagerClient({
+    apiKey,
+    baseURL: apiUrl
+  });
+  return pageImpl;
+}
+async function page(message, tags) {
+  return getPageImpl()(message, tags);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPagerClient,
+  page
+});

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+import { createFetch } from '@better-fetch/fetch';
+
+type PageFn = (message: string, tags?: string[]) => Promise<string>;
+type FetchFactory = typeof createFetch;
+type PagerClientOptions = {
+    apiKey?: string;
+    baseURL?: string;
+    fetchFactory?: FetchFactory;
+};
+declare function createPagerClient(options?: PagerClientOptions): PageFn;
+/**
+ * Page a message to the pager, pass in the message and optional tags
+ *
+ * Pager API Key can be created in the pager dashboard
+ * https://pager.dev/settings
+ *
+ * @param message - The message to page
+ * @param tags - Optional tags to add to the message
+ * @returns The messageId from the pager API
+ */
+declare function page(message: string, tags?: string[]): Promise<string>;
+
+export { createPagerClient, page };

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { createFetch } from '@better-fetch/fetch';
+
+type PageFn = (message: string, tags?: string[]) => Promise<string>;
+type FetchFactory = typeof createFetch;
+type PagerClientOptions = {
+    apiKey?: string;
+    baseURL?: string;
+    fetchFactory?: FetchFactory;
+};
+declare function createPagerClient(options?: PagerClientOptions): PageFn;
+/**
+ * Page a message to the pager, pass in the message and optional tags
+ *
+ * Pager API Key can be created in the pager dashboard
+ * https://pager.dev/settings
+ *
+ * @param message - The message to page
+ * @param tags - Optional tags to add to the message
+ * @returns The messageId from the pager API
+ */
+declare function page(message: string, tags?: string[]): Promise<string>;
+
+export { createPagerClient, page };

package/dist/index.js

@@ -0,0 +1,52 @@
+// index.ts
+import { createFetch } from "@better-fetch/fetch";
+var DEFAULT_PAGER_API_URL = "https://pager.dev/api/v1";
+var pageImpl = null;
+var cachedApiKey;
+var cachedApiUrl;
+function createPagerClient(options = {}) {
+  const apiKey = options.apiKey ?? process.env.PAGER_API_KEY;
+  const baseURL = options.baseURL ?? process.env.PAGER_API_URL ?? DEFAULT_PAGER_API_URL;
+  const fetchFactory = options.fetchFactory ?? createFetch;
+  if (!apiKey) {
+    throw new Error("PAGER_API_KEY is not set");
+  }
+  const $fetch = fetchFactory({
+    baseURL,
+    throw: true,
+    headers: {
+      "X-API-Key": apiKey
+    }
+  });
+  return async (message, tags) => {
+    const data = await $fetch("/", {
+      method: "POST",
+      body: {
+        message,
+        tags: tags?.length ? tags : void 0
+      }
+    });
+    return data.messageId;
+  };
+}
+function getPageImpl() {
+  const apiKey = process.env.PAGER_API_KEY;
+  const apiUrl = process.env.PAGER_API_URL ?? DEFAULT_PAGER_API_URL;
+  if (pageImpl && cachedApiKey === apiKey && cachedApiUrl === apiUrl) {
+    return pageImpl;
+  }
+  cachedApiKey = apiKey;
+  cachedApiUrl = apiUrl;
+  pageImpl = createPagerClient({
+    apiKey,
+    baseURL: apiUrl
+  });
+  return pageImpl;
+}
+async function page(message, tags) {
+  return getPageImpl()(message, tags);
+}
+export {
+  createPagerClient,
+  page
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@9d8/pager",
+  "version": "0.1.0-beta.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "tsup": "^8.5.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@better-fetch/fetch": "^1.1.21"
+  }
+}