@nexly/core 0.4.0 → 0.6.0

package/README.md

@@ -23,6 +23,16 @@ nexly.event({ name: 'click', type: 'engagement', data: { id: 'x' } })
 
 Constructor options use the `NexlyInit` type from the published typings.
 
+### Singleton
+
+When using a provider (`@nexly/react-web` or `@nexly/next`), the client is also available as a singleton — useful for plain functions outside the React tree:
+
+```ts
+import { Nexly } from '@nexly/core'
+
+Nexly.getInstance()?.event({ name: 'click', type: 'engagement' })
+```
+
 ## API
 
 The package ships `.d.ts` files; use your editor or `node_modules` typings for the full export list.

package/dist/nexly.d.ts

@@ -1,6 +1,7 @@
 /** Options for {@link Nexly}. `key` is the ingest API token (sent as `api_token` on the wire). */
 export type NexlyInit = {
-    collectUrl: string;
+    /** Override the ingest endpoint. Defaults to the Nexly production gateway. */
+    collectUrl?: string;
     appId: string;
     key: string;
 };
@@ -15,6 +16,14 @@ export type NexlyEventInput = {
  * High-level browser client: page views, custom events, optional engagement auto-tracking.
  */
 export declare class Nexly {
+    private static instance;
+    /**
+     * Creates (or replaces) the global singleton and returns it.
+     * The provider calls this; plain functions use {@link getInstance}.
+     */
+    static init(options: NexlyInit): Nexly;
+    /** Returns the singleton created by {@link init}, or `null` if not yet initialized. */
+    static getInstance(): Nexly | null;
     readonly collectUrl: string;
     readonly appId: string;
     readonly key: string;

package/dist/nexly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexly.d.ts","sourceRoot":"","sources":["../src/nexly.ts"],"names":[],"mappings":"AAIA,kGAAkG;AAClG,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAA;AAED;;GAEG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,IAAI,EAAE,SAAS;IAM3B,OAAO,KAAK,WAAW,GAMtB;IAED,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IActC;;OAEG;IACH,eAAe,IAAI,MAAM,IAAI;CAG9B"}
+{"version":3,"file":"nexly.d.ts","sourceRoot":"","sources":["../src/nexly.ts"],"names":[],"mappings":"AAMA,kGAAkG;AAClG,MAAM,MAAM,SAAS,GAAG;IACtB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAA;AAED;;GAEG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAE5C;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,KAAK;IAKtC,uFAAuF;IACvF,MAAM,CAAC,WAAW,IAAI,KAAK,GAAG,IAAI;IAIlC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,IAAI,EAAE,SAAS;IAM3B,OAAO,KAAK,WAAW,GAMtB;IAED,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IActC;;OAEG;IACH,eAAe,IAAI,MAAM,IAAI;CAG9B"}

package/dist/nexly.js

@@ -1,15 +1,29 @@
 import { collectBrowserMeta } from './browser-meta.js';
 import { sendBeaconCollect } from './collect.js';
 import { getDefaultPathname, sendPageViewBeacon, startEngagementTracking } from './events/index.js';
+const DEFAULT_COLLECT_URL = 'https://gate.nexly.to/v1/collect';
 /**
  * High-level browser client: page views, custom events, optional engagement auto-tracking.
  */
 export class Nexly {
+    static instance = null;
+    /**
+     * Creates (or replaces) the global singleton and returns it.
+     * The provider calls this; plain functions use {@link getInstance}.
+     */
+    static init(options) {
+        Nexly.instance = new Nexly(options);
+        return Nexly.instance;
+    }
+    /** Returns the singleton created by {@link init}, or `null` if not yet initialized. */
+    static getInstance() {
+        return Nexly.instance;
+    }
     collectUrl;
     appId;
     key;
     constructor(init) {
-        this.collectUrl = init.collectUrl.trim();
+        this.collectUrl = (init.collectUrl ?? DEFAULT_COLLECT_URL).trim();
         this.appId = init.appId.trim();
         this.key = init.key.trim();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexly/core",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Nexly browser ingest core (sendBeacon, Nexly client, context, engagement)",
   "license": "MIT",
   "keywords": [