@consentify/react 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Roman Denysov
+
+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,82 @@
+# @consentify/react
+
+[![npm version](https://img.shields.io/npm/v/@consentify/react.svg)](https://www.npmjs.com/package/@consentify/react)
+[![npm downloads](https://img.shields.io/npm/dm/@consentify/react.svg)](https://www.npmjs.com/package/@consentify/react)
+[![license](https://img.shields.io/npm/l/@consentify/react.svg)](./LICENSE)
+
+> React hook for [@consentify/core](https://www.npmjs.com/package/@consentify/core) — headless cookie consent SDK.
+
+## Install
+
+```bash
+npm install @consentify/react
+# or
+pnpm add @consentify/react
+# or
+yarn add @consentify/react
+```
+
+## Usage
+
+```tsx
+import { createConsentify, defaultCategories, useConsentify } from '@consentify/react';
+
+// Create once at module level
+const consent = createConsentify({
+  policy: { identifier: 'v1.0', categories: defaultCategories },
+});
+
+function CookieBanner() {
+  const state = useConsentify(consent);
+
+  if (state.decision === 'decided') return null;
+
+  return (
+    <div className="cookie-banner">
+      <p>We use cookies to enhance your experience.</p>
+      <button onClick={() => consent.client.set({
+        analytics: true,
+        marketing: true,
+        preferences: true
+      })}>
+        Accept All
+      </button>
+      <button onClick={() => consent.client.set({
+        analytics: false,
+        marketing: false,
+        preferences: false
+      })}>
+        Essential Only
+      </button>
+    </div>
+  );
+}
+```
+
+## API
+
+### `useConsentify(instance)`
+
+React hook that subscribes to consent state changes using `useSyncExternalStore`.
+
+**Parameters:**
+- `instance` — The object returned by `createConsentify()`
+
+**Returns:** `ConsentState<T>`
+- `{ decision: 'unset' }` — No consent given yet
+- `{ decision: 'decided', snapshot }` — User has made a choice
+
+### Re-exports
+
+This package re-exports everything from `@consentify/core`:
+- `createConsentify`
+- `defaultCategories`
+- All types (`ConsentState`, `Snapshot`, `Choices`, etc.)
+
+## SSR Support
+
+The hook uses `useSyncExternalStore` with a server snapshot that returns `{ decision: 'unset' }`, ensuring hydration works correctly in SSR frameworks like Next.js.
+
+## License
+
+MIT © 2025 [Roman Denysov](https://github.com/RomanDenysov)

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { ConsentState } from "@consentify/core";
+interface ConsentifyClient<T extends string> {
+    subscribe: (callback: () => void) => () => void;
+    get: () => ConsentState<T>;
+    getServerSnapshot: () => ConsentState<T>;
+}
+interface ConsentifyInstance<T extends string> {
+    client: ConsentifyClient<T>;
+}
+export declare function useConsentify<T extends string>(instance: ConsentifyInstance<T>): ConsentState<T>;
+export * from "@consentify/core";

package/dist/index.js

@@ -0,0 +1,6 @@
+"use client";
+import { useSyncExternalStore } from "react";
+export function useConsentify(instance) {
+    return useSyncExternalStore(instance.client.subscribe, instance.client.get, instance.client.getServerSnapshot);
+}
+export * from "@consentify/core";

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@consentify/react",
+  "version": "1.0.0",
+  "description": "React hook for @consentify/core",
+  "author": {
+    "name": "Roman Denysov",
+    "url": "https://github.com/RomanDenysov"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/RomanDenysov"
+    },
+    {
+      "type": "ko-fi",
+      "url": "https://ko-fi.com/romandenysov"
+    },
+    {
+      "type": "buymeacoffee",
+      "url": "https://buymeacoffee.com/romandenysov"
+    }
+  ],
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9"
+  },
+  "keywords": [
+    "cookie",
+    "consent",
+    "gdpr",
+    "ccpa",
+    "privacy",
+    "typescript",
+    "react",
+    "hooks"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RomanDenysov/consentify.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/RomanDenysov/consentify/issues"
+  },
+  "homepage": "https://github.com/RomanDenysov/consentify#readme",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@consentify/core": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "rimraf": "^6.0.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit"
+  }
+}