@mesheshq/events 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 CodeChop LLC
+
+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,237 @@
+# meshes-events-client (@mesheshq/events)
+
+[![Tests](https://github.com/mesheshq/node-meshes-events-client/actions/workflows/tests.yml/badge.svg)](https://github.com/mesheshq/node-meshes-events-client/actions/workflows/tests.yml)
+[![NPM Version][npm-version-image]][npm-url]
+[![NPM Install Size][npm-install-size-image]][npm-install-size-url]
+
+A minimal JavaScript client for emitting events into **Meshes** using a **publishable key**.
+
+This package is designed to be tiny and predictable:
+
+- Supports **Promise**, **async/await**, and **callback** styles
+- Works with both **ESM** and **CommonJS**
+- Allows safe custom headers (with contract headers protected)
+- Optional timeout support using `AbortController` when available
+
+## Installation
+
+```bash
+npm i @mesheshq/events
+# or
+pnpm add @mesheshq/events
+# or
+yarn add @mesheshq/events
+```
+
+## Quick Start
+
+The package exports:
+
+- `MeshesEventsClient` (default export + named export)
+- `MeshesApiError`
+
+```js
+// CommonJS
+// const { MeshesEventsClient } = require("@mesheshq/events");
+
+// ESM
+import MeshesEventsClient, {
+  MeshesEventsClient as NamedClient,
+} from "@mesheshq/events";
+
+const publishableKey = process.env.WORKSPACE_PUBLISHABLE_KEY!;
+const client = new MeshesEventsClient(publishableKey);
+
+// Promise style
+client
+  .emit({
+    event: "user.signed_up",
+    payload: { email: "a@b.com" },
+  })
+  .then((result) => {
+    // success handling
+  })
+  .catch((err) => {
+    // error handling
+  });
+
+// Using async/await
+try {
+  const result = await client.emit({
+    event: "user.signed_up",
+    payload: { email: "a@b.com" },
+  });
+
+  // success handling
+} catch (err) {
+  // error handling
+}
+```
+
+### Callback style (no Promise returned)
+
+If you provide a callback, the method returns `undefined` and invokes the callback when complete.
+
+```js
+client.emit(
+  { event: "user.signed_up", payload: { email: "a@b.com" } },
+  {},
+  function (err, result) {
+    if (err) {
+      // error handling
+    } else {
+      // success handling
+    }
+  }
+);
+```
+
+## Publishable Key Format
+
+Publishable keys can be found in the workspace settings and must be in a valid format
+
+Example:
+
+```
+mesh_pub_abc.def_ghi-jkl_asdf123
+```
+
+If the publishable key is missing or invalid, the client throws a `MeshesApiError` immediately when constructing the client.
+
+## Usage
+
+### Initialization
+
+```js
+import MeshesEventsClient from "@mesheshq/events";
+
+const client = new MeshesEventsClient(process.env.WORKSPACE_PUBLISHABLE_KEY!, {
+  version: "v1", // only "v1" currently supported
+  timeout: 10000, // 1000..30000 ms
+  debug: false, // logs to console.debug / console.error when true
+
+  // Optional: extra default headers applied to all requests
+  headers: {
+    "X-Request-Id": "req_123",
+  },
+});
+```
+
+### Emitting a Single Event
+
+```js
+await client.emit({
+  event: "user.signed_up",
+  payload: {
+    email: "a@b.com",
+    name: "Test User",
+  },
+});
+```
+
+### Emitting a Batch of Events
+
+Batch requests support up to **100 events** per call.
+
+```js
+await client.emitBatch([
+  { event: "user.signed_up", payload: { email: "a@b.com" } },
+  { event: "membership.started", payload: { email: "a@b.com", tier: "pro" } },
+]);
+```
+
+## Request Options
+
+Both `emit()` and `emitBatch()` accept an optional `options` object:
+
+```js
+await client.emit(
+  { event: "x", payload: { email: "a@b.com" } },
+  {
+    // Add request-specific headers
+    headers: {
+      "Idempotency-Key": "idem_456",
+      "X-Request-Id": "req_789",
+    },
+
+    // Override timeout for this call only (1000..30000 ms)
+    timeout: 15000,
+  }
+);
+```
+
+### Protected / Forbidden Headers
+
+To keep the API contract consistent, the following headers cannot be overridden via `options.headers`:
+
+- `X-Meshes-Publishable-Key`
+- `X-Meshes-Client`
+- `Content-Type`
+- `Accept`
+
+If you pass these in **constructor** `headers`, the client throws a `MeshesApiError`.
+
+If you pass them in **per-request** `options.headers`, they are silently dropped (and the client’s contract headers remain in effect).
+
+## Errors
+
+All client errors are thrown as `MeshesApiError`.
+
+```js
+import MeshesEventsClient, { MeshesApiError } from "@mesheshq/events";
+
+try {
+  const client = new MeshesEventsClient(process.env.WORKSPACE_PUBLISHABLE_KEY!);
+  await client.emit({ event: "x", payload: { email: "a@b.com" } });
+} catch (err) {
+  if (err instanceof MeshesApiError) {
+    // `err.data` may include HTTP status, response body, etc.
+    console.error("Meshes error:", err.message, err.data);
+  } else {
+    console.error("Unexpected error:", err);
+  }
+}
+```
+
+### HTTP Failures
+
+If the Meshes API returns a non-2xx response, the client throws `MeshesApiError` and includes:
+
+```js
+err.data = {
+  status: 401,
+  statusText: "Unauthorized",
+  data: { ...parsedResponseBodyOrText },
+};
+```
+
+## Response Body Parsing
+
+Responses are parsed as:
+
+- JSON (if the response body is valid JSON)
+- otherwise plain text
+- `null` if the response body is empty
+
+## Timeouts and AbortController
+
+Timeout support uses `AbortController` when available (modern Node versions have it globally).  
+If `AbortController` is not available, requests still work, but timeouts cannot be enforced by aborting the request.
+
+Timeout range: **1000ms** to **30000ms**.
+
+## Node / Runtime Notes
+
+This client uses `fetch`. Ensure your runtime provides a global `fetch`:
+
+- Node 18+ has global `fetch`
+- For Node 16/17 you may need a polyfill (e.g. `undici`) or run in an environment that provides it
+
+## License
+
+MIT
+
+[npm-install-size-image]: https://badgen.net/packagephobia/publish/@mesheshq/events?cache=300
+[npm-install-size-url]: https://packagephobia.com/result?p=%mesheshq%2Fevents
+[npm-url]: https://www.npmjs.com/package/@mesheshq/events
+[npm-version-image]: https://badgen.net/npm/v/@mesheshq/events?cache=300

package/dist/cjs/index.cjs

@@ -0,0 +1,9 @@
+"use strict";var y=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var E=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var S=(i,e)=>{for(var t in e)y(i,t,{get:e[t],enumerable:!0})},T=(i,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of E(e))!A.call(i,a)&&a!==t&&y(i,a,{get:()=>e[a],enumerable:!(s=p(e,a))||s.enumerable});return i};var x=i=>T(y({},"__esModule",{value:!0}),i);var U={};S(U,{MeshesApiError:()=>r,MeshesEventsClient:()=>o,default:()=>O});module.exports=x(U);var r=class extends Error{constructor(e,t){super(e),this.name=this.constructor.name,typeof t<"u"&&(this.data=t)}};r.prototype.toJSON=function(i=!1){let e=i===!0?{stack:this.stack}:{};return typeof this.data>"u"?{name:this.name,message:this.message,...e}:{name:this.name,message:this.message,data:this.data,...e}};var w=async i=>{let e=await i.text();if(!e)return null;try{return JSON.parse(e)}catch{return e}};var R=/^mesh_pub_([A-Za-z0-9\-.]+)_([A-Za-z0-9\-.]+)_([^_]+)$/,v=3e4,I=new Set(["x-meshes-publishable-key","x-meshes-client","content-type","accept"]),$=["POST"],k={version:"v1",timeout:5e3,debug:!1},o=class{#r;#a;#i;#u;#h;#s;constructor(e,t={}){if(typeof e!="string"||!{publishableKey:R}.publishableKey.test(e))throw new r(`Missing or invalid publishable key: ${e}`);if(!t||typeof t!="object")throw new r(`Invalid options object: ${typeof t}`,t);if(t={...k,...t},typeof t.version!="string")throw new r(`Invalid API version: ${t.version}`);if(t.version!=="v1")throw new r(`Unsupported API version: ${t.version}`);if(typeof t.timeout<"u"){if(typeof t.timeout!="number")throw new r(`Invalid request timeout: ${t.timeout}`);if(t.timeout<1e3||t.timeout>v)throw new r(`Unsupported request timeout: ${t.timeout}`)}if(typeof t.headers<"u"){if(!t.headers||typeof t.headers!="object"||Array.isArray(t.headers))throw new r(`Invalid additional request headers: ${typeof t.headers}`,t.headers);for(let[a,d]of Object.entries(t.headers)){if(typeof d!="string")throw new r(`Invalid request header value for ${a}: ${typeof d}`,t.headers);if(I.has(a.toLowerCase()))throw new r(`Header not allowed: ${a}`,t.headers)}}this.#a=t,this.#r=e,this.#i=t.apiBaseUrl??`https://api.meshes.io/api/${t.version}`,this.#u={...this.#d(t.headers),"X-Meshes-Client":"Meshes Events Client v1.0.0","Content-Type":"application/json",Accept:"application/json"},this.#h=t.timeout,this.#s=t.debug===!0}#e(){this.#s&&console.debug(...arguments)}#t(){this.#s&&console.error(...arguments)}#l(e){if(this.#r)e.headers["X-Meshes-Publishable-Key"]=this.#r;else throw new r("No Publishable Key Data");return e}#n(e){if(!e||typeof e!="object")throw new r("Invalid event: must be an object",e);if(typeof e.event!="string"||!e.event.trim())throw new r("Invalid event: missing 'event' string",e);if(!e.payload||typeof e.payload!="object")throw new r("Invalid event: missing 'payload' object",e);if(typeof e.payload.email!="string"||!e.payload.email.trim())throw new r("Invalid event: missing payload.email",e)}#d(e){if(!e||typeof e!="object")return{};let t={};for(let[s,a]of Object.entries(e)){if(typeof s!="string"||typeof a!="string"){this.#e("Invalid Header",s,a);continue}let d=s.trim(),l=a.trim();!d||!l||I.has(d.toLowerCase())||(t[d]=l)}return t}#f(e,t){this.#e("Request Options",e,t?"Callback":"Promise");let s=globalThis.AbortController??void 0,a=s?new s:void 0,d=typeof(e==null?void 0:e.timeout)=="number"?e.timeout:this.#h,l=s?setTimeout(()=>a==null?void 0:a.abort(),d):void 0;a===void 0&&this.#e("AbortController","Not Supported; Timeouts won't be enforced");let P=new Promise((n,c)=>{var b;if(typeof e!="object")throw this.#e("Invalid Request Options",e),new r("Invalid request options",e);let m=(b=e==null?void 0:e.method)==null?void 0:b.toUpperCase();if(!m||typeof m!="string")throw this.#e("Invalid Request Method",e),new r("Invalid request method",e);if(!$.includes(m))throw this.#e("Invalid Request Method Option",e),new r("Unsupported request method",e);if(!(e!=null&&e.path)||typeof e.path!="string"||e.path.trim().length===0||e.path.trim()==="/")throw this.#e("Invalid Request Path",e),new r("Invalid request path",e);if(typeof(e==null?void 0:e.timeout)<"u"){if(typeof e.timeout!="number")throw this.#e("Invalid Request Timeout",e),new r("Invalid request timeout",e);if(e.timeout<1e3||e.timeout>v)throw this.#e("Unsupported Request Timeout",e),new r("Unsupported request timeout",e)}if(typeof e.query<"u"&&(!e.query||typeof e.query!="object"||Array.isArray(e.query)))throw this.#e("Invalid Request Query Params",e),new r("Invalid request query params",e);try{let f=e.query?`?${new URLSearchParams(e.query).toString()}`:"",g=this.#l({method:m,headers:{...this.#d(e.headers),...this.#u},body:e.body?typeof e.body=="string"?e.body:JSON.stringify(e.body):null,signal:a==null?void 0:a.signal}),q=e.path.charAt(0)!=="/"?`/${e.path}`:e.path;return this.#e("Fetch Options",{method:g.method,path:q,query:f}),fetch(`${this.#i}${q}${f}`,g).then(u=>{u.ok?w(u).then(h=>{this.#e("Response Success"),n(h)}).catch(h=>{this.#t("Response Parsing Error",h),c(new r("Error parsing response data",h))}):w(u).then(h=>{this.#e("Response Error",h),c(new r("Meshes API request failed",{status:u.status,statusText:u.statusText,data:h}))}).catch(h=>{this.#t("Response Parsing Failure",h),c(new r("Error parsing request failure",{status:u.status,statusText:u.statusText,error:h}))})}).catch(u=>{this.#t("Request Failure",u),c(new r("Request Failure",u))})}catch(f){throw this.#t("Unexpected Error",f),c(new r("Unexpected Error",f)),f}}).then(n=>{if(this.#e("Promise Success",n),t){this.#e("Promise Success","Callback Success"),t(null,n);return}return n}).catch(n=>{if(this.#e("Promise Error",n),t){this.#e("Promise Error","Callback Error"),t(n);return}throw n}).finally(()=>{l&&clearTimeout(l)});if(!t)return this.#e("Promise Returned","No callback"),P}emit(e,t={},s=void 0){return this.#n(e),this.#f({...this.#a,...t,path:"/events",method:"POST",body:e},s)}emitBatch(e,t={},s=void 0){if(!Array.isArray(e))throw new r("Events must be an array",e);if(e.length===0)throw new r("Events array cannot be empty");if(e.length>100)throw new r("Bulk emit supports up to 100 events per request",{count:e.length});for(let a of e)this.#n(a);return this.#f({...this.#a,...t,path:"/events/bulk",method:"POST",body:e},s)}},O=o;0&&(module.exports={MeshesApiError,MeshesEventsClient});
+/**
+ * JavaScript Meshes Events Client
+ * @module meshes-events-client
+ * @license MIT
+ * @since 1.0.0
+ * @description Meshes events client for emitting events with a publishable key.
+ * @repository https://github.com/mesheshq/node-meshes-events-client
+ */

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Typescript type definitions for Meshes Events API
+ * @module meshes-events-client
+ * @license MIT
+ * @since 1.0.0
+ * @description Meshes events client for emitting events with a publishable key.
+ * @repository https://github.com/mesheshq/node-meshes-events-client
+ */
+/**
+ * Callback function to use rather than promises
+ */
+export type CallbackFunction = (err: any, data?: any) => void;
+/**
+ * Request headers
+ */
+export type Headers = {
+    [key: string]: string;
+};
+/**
+ * Query parameters
+ */
+export type QueryParams = {
+    [key: string]: string | number | boolean;
+};
+/**
+ * Meshes API Config Options
+ */
+export type MeshesOptions = {
+    /**
+     * API version
+     */
+    version: "v1";
+    /**
+     * Request timeout in milliseconds
+     * @constraint [1000-30000]
+     */
+    timeout: number;
+    /**
+     * Additional request headers
+     */
+    headers: Headers;
+    /**
+     * If true, will enable debug mode.
+     */
+    debug?: boolean;
+    /**
+     * API Base Url.  This is optional and can be useful for testing.
+     * @default "https://api.meshes.io/api/v1"
+     */
+    apiBaseUrl?: string;
+};
+/**
+ * Meshes API Optional Request Options
+ */
+export type MeshesOptionalRequestOptions = {
+    /**
+     * Request headers
+     */
+    headers?: Headers;
+    /**
+     * Query parameters
+     */
+    query?: QueryParams;
+    /**
+     * Request timeout in milliseconds
+     */
+    timeout?: number;
+};
+/**
+ * Meshes event payload structure.
+ */
+export type MeshesEventPayload = {
+    /**
+     * The payload email.  This is required.
+     */
+    email: string;
+    first_name?: string | undefined;
+    id?: string | undefined;
+    ip_address?: string | undefined;
+    last_name?: string | undefined;
+    name?: string | undefined;
+    phone?: string | undefined;
+    resource_url?: string | undefined;
+} & {
+    [k: string]: unknown;
+};
+/**
+ * Meshes event structure.
+ */
+export type MeshesEventBody = {
+    /**
+     * The event type for the event.
+     */
+    event: string;
+    /**
+     * The custom resource.  Defaults to 'global'.
+     */
+    resource?: string | undefined;
+    /**
+     * The resource ID for a custom resource.
+     */
+    resource_id?: string | undefined;
+    /**
+     * The event payload that will be used.
+     */
+    payload: MeshesEventPayload;
+};
+/**
+ * Meshes Events API Client
+ * @class
+ * @property {Function} emit - Create (emit) a single event
+ * @property {Function} emitBatch - Create (emit) multiple events up to 100 at a time
+ */
+export type MeshesEventsClient = {
+    /**
+     * Create (emit) a single event
+     * @param {MeshesEventBody} event - The event to emit
+     * @param {MeshesOptionalRequestOptions} options - Optional request options
+     * @param {CallbackFunction} done - Optional callback function
+     * @returns {Promise<any> | undefined} - Request promise or undefined if a callback is provided
+     */
+    emit(event: MeshesEventBody, options?: MeshesOptionalRequestOptions, done?: CallbackFunction): Promise<any> | undefined;
+    /**
+     * Create (emit) multiple events up to 100 at a time
+     * @param {MeshesEventBody[]} events - The events to emit
+     * @param {MeshesOptionalRequestOptions} options - Optional request options
+     * @param {CallbackFunction} done - Optional callback function
+     * @returns {Promise<any> | undefined} - Request promise or undefined if a callback is provided
+     */
+    emitBatch(events: MeshesEventBody[], options?: MeshesOptionalRequestOptions, done?: CallbackFunction): Promise<any> | undefined;
+};
+/**
+ * Meshes API Error
+ */
+export type MeshesApiError = {
+    name: string;
+    message: string;
+    data?: any;
+    stack?: any;
+};

package/dist/mjs/index.js

@@ -0,0 +1,9 @@
+var r=class extends Error{constructor(e,t){super(e),this.name=this.constructor.name,typeof t<"u"&&(this.data=t)}};r.prototype.toJSON=function(f=!1){let e=f===!0?{stack:this.stack}:{};return typeof this.data>"u"?{name:this.name,message:this.message,...e}:{name:this.name,message:this.message,data:this.data,...e}};var o=async f=>{let e=await f.text();if(!e)return null;try{return JSON.parse(e)}catch{return e}};var P=/^mesh_pub_([A-Za-z0-9\-.]+)_([A-Za-z0-9\-.]+)_([^_]+)$/,q=3e4,v=new Set(["x-meshes-publishable-key","x-meshes-client","content-type","accept"]),p=["POST"],E={version:"v1",timeout:5e3,debug:!1},y=class{#r;#a;#i;#u;#h;#s;constructor(e,t={}){if(typeof e!="string"||!{publishableKey:P}.publishableKey.test(e))throw new r(`Missing or invalid publishable key: ${e}`);if(!t||typeof t!="object")throw new r(`Invalid options object: ${typeof t}`,t);if(t={...E,...t},typeof t.version!="string")throw new r(`Invalid API version: ${t.version}`);if(t.version!=="v1")throw new r(`Unsupported API version: ${t.version}`);if(typeof t.timeout<"u"){if(typeof t.timeout!="number")throw new r(`Invalid request timeout: ${t.timeout}`);if(t.timeout<1e3||t.timeout>q)throw new r(`Unsupported request timeout: ${t.timeout}`)}if(typeof t.headers<"u"){if(!t.headers||typeof t.headers!="object"||Array.isArray(t.headers))throw new r(`Invalid additional request headers: ${typeof t.headers}`,t.headers);for(let[a,n]of Object.entries(t.headers)){if(typeof n!="string")throw new r(`Invalid request header value for ${a}: ${typeof n}`,t.headers);if(v.has(a.toLowerCase()))throw new r(`Header not allowed: ${a}`,t.headers)}}this.#a=t,this.#r=e,this.#i=t.apiBaseUrl??`https://api.meshes.io/api/${t.version}`,this.#u={...this.#d(t.headers),"X-Meshes-Client":"Meshes Events Client v1.0.0","Content-Type":"application/json",Accept:"application/json"},this.#h=t.timeout,this.#s=t.debug===!0}#e(){this.#s&&console.debug(...arguments)}#t(){this.#s&&console.error(...arguments)}#l(e){if(this.#r)e.headers["X-Meshes-Publishable-Key"]=this.#r;else throw new r("No Publishable Key Data");return e}#n(e){if(!e||typeof e!="object")throw new r("Invalid event: must be an object",e);if(typeof e.event!="string"||!e.event.trim())throw new r("Invalid event: missing 'event' string",e);if(!e.payload||typeof e.payload!="object")throw new r("Invalid event: missing 'payload' object",e);if(typeof e.payload.email!="string"||!e.payload.email.trim())throw new r("Invalid event: missing payload.email",e)}#d(e){if(!e||typeof e!="object")return{};let t={};for(let[s,a]of Object.entries(e)){if(typeof s!="string"||typeof a!="string"){this.#e("Invalid Header",s,a);continue}let n=s.trim(),l=a.trim();!n||!l||v.has(n.toLowerCase())||(t[n]=l)}return t}#f(e,t){this.#e("Request Options",e,t?"Callback":"Promise");let s=globalThis.AbortController??void 0,a=s?new s:void 0,n=typeof(e==null?void 0:e.timeout)=="number"?e.timeout:this.#h,l=s?setTimeout(()=>a==null?void 0:a.abort(),n):void 0;a===void 0&&this.#e("AbortController","Not Supported; Timeouts won't be enforced");let I=new Promise((h,c)=>{var w;if(typeof e!="object")throw this.#e("Invalid Request Options",e),new r("Invalid request options",e);let m=(w=e==null?void 0:e.method)==null?void 0:w.toUpperCase();if(!m||typeof m!="string")throw this.#e("Invalid Request Method",e),new r("Invalid request method",e);if(!p.includes(m))throw this.#e("Invalid Request Method Option",e),new r("Unsupported request method",e);if(!(e!=null&&e.path)||typeof e.path!="string"||e.path.trim().length===0||e.path.trim()==="/")throw this.#e("Invalid Request Path",e),new r("Invalid request path",e);if(typeof(e==null?void 0:e.timeout)<"u"){if(typeof e.timeout!="number")throw this.#e("Invalid Request Timeout",e),new r("Invalid request timeout",e);if(e.timeout<1e3||e.timeout>q)throw this.#e("Unsupported Request Timeout",e),new r("Unsupported request timeout",e)}if(typeof e.query<"u"&&(!e.query||typeof e.query!="object"||Array.isArray(e.query)))throw this.#e("Invalid Request Query Params",e),new r("Invalid request query params",e);try{let d=e.query?`?${new URLSearchParams(e.query).toString()}`:"",b=this.#l({method:m,headers:{...this.#d(e.headers),...this.#u},body:e.body?typeof e.body=="string"?e.body:JSON.stringify(e.body):null,signal:a==null?void 0:a.signal}),g=e.path.charAt(0)!=="/"?`/${e.path}`:e.path;return this.#e("Fetch Options",{method:b.method,path:g,query:d}),fetch(`${this.#i}${g}${d}`,b).then(i=>{i.ok?o(i).then(u=>{this.#e("Response Success"),h(u)}).catch(u=>{this.#t("Response Parsing Error",u),c(new r("Error parsing response data",u))}):o(i).then(u=>{this.#e("Response Error",u),c(new r("Meshes API request failed",{status:i.status,statusText:i.statusText,data:u}))}).catch(u=>{this.#t("Response Parsing Failure",u),c(new r("Error parsing request failure",{status:i.status,statusText:i.statusText,error:u}))})}).catch(i=>{this.#t("Request Failure",i),c(new r("Request Failure",i))})}catch(d){throw this.#t("Unexpected Error",d),c(new r("Unexpected Error",d)),d}}).then(h=>{if(this.#e("Promise Success",h),t){this.#e("Promise Success","Callback Success"),t(null,h);return}return h}).catch(h=>{if(this.#e("Promise Error",h),t){this.#e("Promise Error","Callback Error"),t(h);return}throw h}).finally(()=>{l&&clearTimeout(l)});if(!t)return this.#e("Promise Returned","No callback"),I}emit(e,t={},s=void 0){return this.#n(e),this.#f({...this.#a,...t,path:"/events",method:"POST",body:e},s)}emitBatch(e,t={},s=void 0){if(!Array.isArray(e))throw new r("Events must be an array",e);if(e.length===0)throw new r("Events array cannot be empty");if(e.length>100)throw new r("Bulk emit supports up to 100 events per request",{count:e.length});for(let a of e)this.#n(a);return this.#f({...this.#a,...t,path:"/events/bulk",method:"POST",body:e},s)}},R=y;export{r as MeshesApiError,y as MeshesEventsClient,R as default};
+/**
+ * JavaScript Meshes Events Client
+ * @module meshes-events-client
+ * @license MIT
+ * @since 1.0.0
+ * @description Meshes events client for emitting events with a publishable key.
+ * @repository https://github.com/mesheshq/node-meshes-events-client
+ */

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@mesheshq/events",
+  "version": "1.0.0",
+  "description": "Meshes events client for emitting events with a publishable key.",
+  "author": "Todd Schlomer <todd@meshes.io> (https://meshes.io)",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/mjs/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/mjs/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mesheshq/node-meshes-events-client"
+  },
+  "bugs": {
+    "url": "https://github.com/mesheshq/node-meshes-events-client/issues"
+  },
+  "homepage": "https://github.com/mesheshq/node-meshes-events-client#readme",
+  "scripts": {
+    "build": "rm -rf dist && node esbuild.js && tsc",
+    "watch": "npm run build -- --watch src",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run --testTimeout 10000",
+    "test:watch": "vitest watch --testTimeout 10000",
+    "test:ci": "export CI=true && vitest run --coverage",
+    "coverage": "vitest run --coverage"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@vitest/coverage-v8": "3.2.4",
+    "esbuild": "^0.27.2",
+    "esbuild-node-externals": "^1.20.1",
+    "prettier": "^3.2.5",
+    "typescript": "^5.1.6",
+    "vitest": "3.2.4"
+  },
+  "keywords": [
+    "Meshes",
+    "Meshes Events",
+    "Meshes Events Client"
+  ],
+  "engines": {
+    "node": ">=v18.20.8"
+  }
+}