@ncentiva/core 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @ncentiva/core
+
+Shared hooks, classes, and utilities for Ncentiva applications.
+
+## Install
+
+```bash
+npm install @ncentiva/core
+```
+
+## Token client
+
+```ts
+import { TokenClient } from "@ncentiva/core";
+
+const tokenClient = new TokenClient();
+tokenClient.set("access-token");
+tokenClient.get();
+tokenClient.hasToken();
+tokenClient.clear();
+```
+
+`tokenClient` stores the token in the browser's `localStorage` under `access_token`.
+
+## Hooks
+
+```tsx
+import { useDebounce, useMobile } from "@ncentiva/core";
+
+const debouncedSearch = useDebounce(search, 300);
+const isMobile = useMobile();
+```
+
+`useMobile` uses a 768px breakpoint by default. Pass a different breakpoint when needed.

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+declare class TokenClient {
+    private accessToken;
+    private readonly storageKey;
+    set(token: string): void;
+    get(): string | null;
+    clear(): void;
+    hasToken(): boolean;
+}
+
+declare function useDebounce<T>(value: T, delay?: number): T;
+
+declare const MOBILE_BREAKPOINT = 768;
+declare function useMobile(breakpoint?: number): boolean;
+
+export { MOBILE_BREAKPOINT, TokenClient, useDebounce, useMobile };

package/dist/index.js

@@ -0,0 +1,48 @@
+import { useState, useEffect } from 'react';
+
+// src/classes/token-client.ts
+var TokenClient = class {
+  accessToken = null;
+  storageKey = "access_token";
+  set(token) {
+    this.accessToken = token;
+    localStorage.setItem(this.storageKey, token);
+  }
+  get() {
+    if (!this.accessToken) {
+      this.accessToken = localStorage.getItem(this.storageKey);
+    }
+    return this.accessToken;
+  }
+  clear() {
+    this.accessToken = null;
+    localStorage.removeItem(this.storageKey);
+  }
+  hasToken() {
+    return Boolean(this.get());
+  }
+};
+function useDebounce(value, delay = 300) {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+  useEffect(() => {
+    const timeout = window.setTimeout(() => {
+      setDebouncedValue(value);
+    }, Math.max(0, delay));
+    return () => window.clearTimeout(timeout);
+  }, [delay, value]);
+  return debouncedValue;
+}
+var MOBILE_BREAKPOINT = 768;
+function useMobile(breakpoint = MOBILE_BREAKPOINT) {
+  const query = `(max-width: ${Math.max(0, breakpoint - 1)}px)`;
+  const [isMobile, setIsMobile] = useState(false);
+  useEffect(() => {
+    const mediaQuery = window.matchMedia(query);
+    setIsMobile(mediaQuery.matches);
+  }, [query]);
+  return isMobile;
+}
+
+export { MOBILE_BREAKPOINT, TokenClient, useDebounce, useMobile };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/classes/token-client.ts","../src/hooks/use-debounce.ts","../src/hooks/use-mobile.ts"],"names":["useState","useEffect"],"mappings":";;;AAAO,IAAM,cAAN,MAAkB;AAAA,EACf,WAAA,GAA6B,IAAA;AAAA,EACpB,UAAA,GAAa,cAAA;AAAA,EAE9B,IAAI,KAAA,EAAqB;AACvB,IAAA,IAAA,CAAK,WAAA,GAAc,KAAA;AACnB,IAAA,YAAA,CAAa,OAAA,CAAQ,IAAA,CAAK,UAAA,EAAY,KAAK,CAAA;AAAA,EAC7C;AAAA,EAEA,GAAA,GAAqB;AACnB,IAAA,IAAI,CAAC,KAAK,WAAA,EAAa;AACrB,MAAA,IAAA,CAAK,WAAA,GAAc,YAAA,CAAa,OAAA,CAAQ,IAAA,CAAK,UAAU,CAAA;AAAA,IACzD;AAEA,IAAA,OAAO,IAAA,CAAK,WAAA;AAAA,EACd;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AACnB,IAAA,YAAA,CAAa,UAAA,CAAW,KAAK,UAAU,CAAA;AAAA,EACzC;AAAA,EAEA,QAAA,GAAoB;AAClB,IAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,GAAA,EAAK,CAAA;AAAA,EAC3B;AACF;ACvBO,SAAS,WAAA,CAAe,KAAA,EAAU,KAAA,GAAQ,GAAA,EAAQ;AACvD,EAAA,MAAM,CAAC,cAAA,EAAgB,iBAAiB,CAAA,GAAI,SAAS,KAAK,CAAA;AAE1D,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,OAAA,GAAU,MAAA,CAAO,UAAA,CAAW,MAAM;AACtC,MAAA,iBAAA,CAAkB,KAAK,CAAA;AAAA,IACzB,CAAA,EAAG,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAK,CAAC,CAAA;AAErB,IAAA,OAAO,MAAM,MAAA,CAAO,YAAA,CAAa,OAAO,CAAA;AAAA,EAC1C,CAAA,EAAG,CAAC,KAAA,EAAO,KAAK,CAAC,CAAA;AAEjB,EAAA,OAAO,cAAA;AACT;ACZO,IAAM,iBAAA,GAAoB;AAE1B,SAAS,SAAA,CAAU,aAAa,iBAAA,EAA4B;AACjE,EAAA,MAAM,QAAQ,CAAA,YAAA,EAAe,IAAA,CAAK,IAAI,CAAA,EAAG,UAAA,GAAa,CAAC,CAAC,CAAA,GAAA,CAAA;AAExD,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIA,SAAS,KAAK,CAAA;AAE9C,EAAAC,UAAU,MAAM;AACd,IAAA,MAAM,UAAA,GAAa,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AAC1C,IAAA,WAAA,CAAY,WAAW,OAAO,CAAA;AAAA,EAChC,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,QAAA;AACT","file":"index.js","sourcesContent":["export class TokenClient {\n  private accessToken: string | null = null;\n  private readonly storageKey = \"access_token\";\n\n  set(token: string): void {\n    this.accessToken = token;\n    localStorage.setItem(this.storageKey, token);\n  }\n\n  get(): string | null {\n    if (!this.accessToken) {\n      this.accessToken = localStorage.getItem(this.storageKey);\n    }\n\n    return this.accessToken;\n  }\n\n  clear(): void {\n    this.accessToken = null;\n    localStorage.removeItem(this.storageKey);\n  }\n\n  hasToken(): boolean {\n    return Boolean(this.get());\n  }\n}\n","import { useEffect, useState } from \"react\";\n\nexport function useDebounce<T>(value: T, delay = 300): T {\n  const [debouncedValue, setDebouncedValue] = useState(value);\n\n  useEffect(() => {\n    const timeout = window.setTimeout(() => {\n      setDebouncedValue(value);\n    }, Math.max(0, delay));\n\n    return () => window.clearTimeout(timeout);\n  }, [delay, value]);\n\n  return debouncedValue;\n}\n","import { useEffect, useState } from \"react\";\n\nexport const MOBILE_BREAKPOINT = 768;\n\nexport function useMobile(breakpoint = MOBILE_BREAKPOINT): boolean {\n  const query = `(max-width: ${Math.max(0, breakpoint - 1)}px)`;\n\n  const [isMobile, setIsMobile] = useState(false);\n\n  useEffect(() => {\n    const mediaQuery = window.matchMedia(query);\n    setIsMobile(mediaQuery.matches);\n  }, [query]);\n\n  return isMobile;\n}\n"]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@ncentiva/core",
+  "version": "0.1.0",
+  "description": "Shared hooks, classes, and utilities for Ncentiva applications.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.13",
+    "react": "^19.1.1",
+    "tsup": "^8.5.1",
+    "typescript": "~5.8.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  }
+}