telesink 1.0.0

package/LICENSE.md

@@ -0,0 +1,20 @@
+# The MIT License
+
+Copyright © 2026 Telesink
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the 'Software'), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# Telesink SDK for JavaScript
+
+**Know what your product is doing. Right now.**
+
+Official JavaScript client for [telesink.com](https://telesink.com) - real-time
+event tracking.
+
+## Requirements
+
+- Node.js 18+
+- Any modern browser (with native `fetch` and `AbortController`)
+
+## Getting started
+
+### Install
+
+```sh
+npm install telesink
+```
+
+### Configuration
+
+#### Node.js
+
+Set the environment variable:
+
+```sh
+export TELESINK_ENDPOINT=https://app.telesink.com/api/v1/sinks/your_sink_token_here/events
+```
+
+#### Browsers
+
+```sh
+window.TELESINK_ENDPOINT = "https://app.telesink.com/api/v1/sinks/your_sink_token_here/events";
+```
+
+To disable tracking (e.g. in test/dev):
+
+```sh
+export TELESINK_DISABLED=true
+```
+
+(or `window.TELESINK_DISABLED = true` in the browser)
+
+### Usage
+
+#### Node.js and modern bundlers
+
+```js
+import telesink from "telesink";
+
+telesink.track({
+  event: "user.signed.up",
+  text: "user@example.com",
+  emoji: "👤",
+  properties: {
+    user_id: 123,
+    email_address: "user@example.com",
+  },
+  occurredAt: new Date(),
+  idempotencyKey: "my-key",
+});
+```
+
+#### Browser without bundler (Import Maps)
+
+```html
+<script type="importmap">
+  {
+    "imports": {
+      "telesink": "https://esm.sh/telesink"
+    }
+  }
+</script>
+
+<script type="module">
+  import telesink from "telesink";
+
+  telesink.track({
+    event: "page.viewed",
+    text: "Homepage visited",
+  });
+</script>
+```
+
+#### Returns
+
+- `true` — event sent successfully
+- `false` — disabled, missing endpoint, or network error
+
+### License
+
+MIT (see [LICENSE.md](/LICENSE.md)).

package/index.js

@@ -0,0 +1,69 @@
+const VERSION = "1.0.0";
+
+const endpoint = () => {
+  if (typeof process !== "undefined") return process.env?.TELESINK_ENDPOINT;
+  if (typeof window !== "undefined") return window.TELESINK_ENDPOINT;
+  return null;
+};
+
+const enabled = () => {
+  if (typeof process !== "undefined") return !process.env?.TELESINK_DISABLED;
+  if (typeof window !== "undefined") return !window.TELESINK_DISABLED;
+  return true;
+};
+
+const uuid = () =>
+  typeof crypto !== "undefined" && crypto.randomUUID
+    ? crypto.randomUUID()
+    : "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        return (c === "x" ? r : (r & 0x3) | 0x8).toString(16);
+      });
+
+const track = async ({
+  event,
+  text,
+  emoji,
+  properties = {},
+  occurredAt,
+  idempotencyKey,
+} = {}) => {
+  if (!enabled() || !endpoint()) return false;
+
+  const payload = Object.fromEntries(
+    Object.entries({
+      event,
+      text,
+      emoji,
+      properties,
+      occurred_at: new Date(occurredAt ?? Date.now()).toISOString(),
+      idempotency_key: idempotencyKey ?? uuid(),
+      sdk: { name: "telesink", version: VERSION },
+    }).filter(([, v]) => v != null),
+  );
+
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 3000);
+
+  try {
+    const res = await fetch(endpoint(), {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": `telesink/${VERSION}`,
+        "Idempotency-Key": payload.idempotency_key,
+      },
+      body: JSON.stringify(payload),
+      signal: controller.signal,
+    });
+    return res.ok;
+  } catch (e) {
+    console.error(`[Telesink] ${e.constructor.name}: ${e.message}`);
+    return false;
+  } finally {
+    clearTimeout(timeout);
+  }
+};
+
+export { track };
+export default { track };

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "telesink",
+  "version": "1.0.0",
+  "description": "Official JavaScript SDK for Telesink — real-time event tracking",
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/telesink/telesink-javascript.git"
+  },
+  "keywords": [
+    "telesink",
+    "event-tracking",
+    "analytics",
+    "real-time",
+    "monitoring",
+    "notifications",
+    "sdk"
+  ],
+  "author": "Kyrylo Silin",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/telesink/telesink-javascript/issues"
+  },
+  "homepage": "https://github.com/telesink/telesink-javascript#readme"
+}