@cohostvip/cohost-react 0.0.2

package/README.md

@@ -0,0 +1,90 @@
+# @cohostvip/cohost-react
+
+React bindings for the [Cohost API](https://cohost.vip), built on top of [`@cohostvip/cohost-node`](https://www.npmjs.com/package/@cohostvip/cohost-node).
+
+Use this package to easily connect your React or Next.js app to Cohost's event and order APIs using a provider/hook pattern.
+
+---
+
+## 📦 Installation
+
+```bash
+pnpm add @cohostvip/cohost-react
+```
+
+Or with npm:
+
+```bash
+npm install @cohostvip/cohost-react
+```
+
+---
+
+## 🚀 Usage
+
+Wrap your app (or part of it) in the `CohostProvider` and use the `useCohost()` hook to access the API client.
+
+### Example
+
+```tsx
+// app.tsx or layout.tsx
+import { CohostProvider } from '@cohostvip/cohost-react';
+
+export function App() {
+  return (
+    <CohostProvider token="your-api-token">
+      <MyComponent />
+    </CohostProvider>
+  );
+}
+```
+
+```tsx
+// inside your component
+import { useCohost } from '@cohostvip/cohost-react';
+
+function MyComponent() {
+  const cohost = useCohost();
+
+  useEffect(() => {
+    cohost.events.list().then(console.log);
+  }, []);
+
+  return <div>Loaded events</div>;
+}
+```
+
+---
+
+## 🔐 Auth
+
+Pass your API `token` to the `CohostProvider`. This token is required for all authenticated requests.  
+You can optionally pass:
+
+- `baseUrl` — override the default API URL (e.g. for staging)
+- `debug` — enable console debugging of API requests
+
+---
+
+## 📘 API Reference
+
+This wrapper gives you access to the full Cohost API as defined in [`@cohostvip/cohost-node`](https://www.npmjs.com/package/@cohostvip/cohost-node).  
+See its documentation for available methods like:
+
+- `client.events.list()`
+- `client.orders.fetch(orderId, userId)`
+- etc.
+
+---
+
+## ✅ Requirements
+
+- React 18 or 19
+- Next.js 14 or 15
+
+---
+
+## 🛠️ Support
+
+If you're building something custom or need help integrating, reach out at [cohost.vip](https://cohost.vip) or open an issue.
+

package/dist/context/CohostContext.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { type CohostClient } from '@cohostvip/cohost-node';
+export interface CohostProviderProps {
+    token: string;
+    children: React.ReactNode;
+}
+export declare const CohostProvider: React.FC<CohostProviderProps>;
+export declare const useCohostClient: () => CohostClient;
+//# sourceMappingURL=CohostContext.d.ts.map

package/dist/context/CohostContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CohostContext.d.ts","sourceRoot":"","sources":["../../src/context/CohostContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAID,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAWxD,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,YAIlC,CAAC"}

package/dist/context/CohostContext.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+import { createCohostClient } from '@cohostvip/cohost-node';
+const CohostContext = createContext(null);
+export const CohostProvider = ({ token, children, }) => {
+    const client = createCohostClient({ token }); // assumes a factory fn in cohost-node
+    return (_jsx(CohostContext.Provider, { value: client, children: children }));
+};
+export const useCohostClient = () => {
+    const ctx = useContext(CohostContext);
+    if (!ctx)
+        throw new Error("useCohostClient must be used within a CohostProvider");
+    return ctx;
+};

package/dist/hooks/useCohost.d.ts

@@ -0,0 +1,2 @@
+export { useCohostClient as useCohost } from '../context/CohostContext';
+//# sourceMappingURL=useCohost.d.ts.map

package/dist/hooks/useCohost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCohost.d.ts","sourceRoot":"","sources":["../../src/hooks/useCohost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/hooks/useCohost.js

@@ -0,0 +1 @@
+export { useCohostClient as useCohost } from '../context/CohostContext';

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { CohostProvider } from './context/CohostContext';
+export { useCohost } from './hooks/useCohost';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { CohostProvider } from './context/CohostContext';
+export { useCohost } from './hooks/useCohost';

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@cohostvip/cohost-react",
+  "version": "0.0.2",
+  "description": "React bindings for the Cohost API",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "dev": "tsc --watch --project tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@cohostvip/cohost-node": "0.0.2"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "19.0.10",
+    "@types/react-dom": "19.0.4",
+    "jsdom": "26.0.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cohostvip/cohost-react.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cohostvip/cohost-react/issues"
+  },
+  "homepage": "https://github.com/cohostvip/cohost-react",
+  "author": "Cohost <support@cohost.vip> (https://cohost.vip)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "cohost",
+    "react",
+    "nextjs",
+    "api",
+    "context",
+    "provider",
+    "sdk",
+    "typescript"
+  ]
+}