@squadbase/react 0.0.1

package/README.md

@@ -0,0 +1,99 @@
+# @squadbase/react
+
+React SDK for Squadbase - A package for handling client-side operations in Squadbase applications with React.
+
+## Installation
+
+```bash
+npm install @squadbase/react
+# or
+yarn add @squadbase/react
+# or
+pnpm add @squadbase/react
+```
+
+## Features
+
+### User Session
+
+```typescript
+import { SquadbaseProvider, useUser } from "@squadbase/react";
+
+// Wrap your app with SquadbaseProvider
+function App() {
+  return (
+    <SquadbaseProvider projectId="your-project-id">
+      <UserProfile />
+    </SquadbaseProvider>
+  );
+}
+
+// Use the useUser hook in your components
+function UserProfile() {
+  const user = useUser();
+
+  if (user.status === "pending") {
+    return <div>Loading...</div>;
+  }
+
+  if (user.status === "error") {
+    return <div>Error: {user.error}</div>;
+  }
+
+  return (
+    <div>
+      <h1>Welcome, {user.data.firstName}!</h1>
+      <p>Email: {user.data.email}</p>
+    </div>
+  );
+}
+```
+
+### Local Development
+
+For local development, you can provide a mock user:
+
+```typescript
+<SquadbaseProvider
+  projectId="your-project-id"
+  mockUser={{
+    username: "test-user",
+    email: "test@example.com",
+    firstName: "Test",
+    lastName: "User",
+    iconUrl: null,
+    roles: ["user"],
+  }}
+>
+  <App />
+</SquadbaseProvider>
+```
+
+## API Reference
+
+### `SquadbaseProvider`
+
+A React context provider that wraps your application and provides access to the Squadbase client.
+
+#### Props
+
+- `projectId` (string): Your Squadbase project ID
+- `mockUser` (optional): Mock user object for local development
+
+### `useUser()`
+
+A React hook that returns the current authenticated user.
+
+#### Returns
+
+```typescript
+type QueryResult<User, string> = {
+  status: "pending" | "success" | "error";
+  data?: User;
+  error?: string;
+};
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,77 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SquadbaseProvider: () => SquadbaseProvider,
+  useUser: () => useUser
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/user.tsx
+var import_react = require("react");
+var import_zod = require("zod");
+var import_jsx_runtime = require("react/jsx-runtime");
+var zUser = import_zod.z.object({
+  username: import_zod.z.string(),
+  email: import_zod.z.string(),
+  firstName: import_zod.z.string(),
+  lastName: import_zod.z.string(),
+  iconUrl: import_zod.z.string().nullable(),
+  roles: import_zod.z.array(import_zod.z.string())
+});
+async function fetchUser() {
+  const response = await fetch("/_sqcore/auth", { method: "POST" });
+  if (!response.ok) {
+    throw new Error("Failed to get user");
+  }
+  return zUser.parse(await response.json());
+}
+var UserContext = (0, import_react.createContext)(null);
+function UserProvider({ children }) {
+  const [state, setState] = (0, import_react.useState)({ status: "pending" });
+  (0, import_react.useEffect)(() => {
+    fetchUser().then((data) => setState({ status: "success", data })).catch(
+      (e) => setState({
+        status: "error",
+        error: e instanceof Error ? e.message : "Failed to get user"
+      })
+    );
+  }, []);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(UserContext.Provider, { value: state, children });
+}
+function useUser() {
+  const state = (0, import_react.useContext)(UserContext);
+  if (!state) {
+    throw new Error("<SquadbaseProvider> is not found");
+  }
+  return state;
+}
+
+// src/provider.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function SquadbaseProvider({ children }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(UserProvider, { children });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SquadbaseProvider,
+  useUser
+});

package/dist/index.d.cts

@@ -0,0 +1,29 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { z } from 'zod';
+
+declare function SquadbaseProvider({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare const zUser: z.ZodObject<{
+    username: z.ZodString;
+    email: z.ZodString;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    iconUrl: z.ZodNullable<z.ZodString>;
+    roles: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type User = z.infer<typeof zUser>;
+type UserState = {
+    status: "pending";
+} | {
+    status: "success";
+    data: User;
+} | {
+    status: "error";
+    error: string;
+};
+declare function useUser(): UserState;
+
+export { SquadbaseProvider, type User, type UserState, useUser };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { z } from 'zod';
+
+declare function SquadbaseProvider({ children }: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare const zUser: z.ZodObject<{
+    username: z.ZodString;
+    email: z.ZodString;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    iconUrl: z.ZodNullable<z.ZodString>;
+    roles: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type User = z.infer<typeof zUser>;
+type UserState = {
+    status: "pending";
+} | {
+    status: "success";
+    data: User;
+} | {
+    status: "error";
+    error: string;
+};
+declare function useUser(): UserState;
+
+export { SquadbaseProvider, type User, type UserState, useUser };

package/dist/index.js

@@ -0,0 +1,54 @@
+// src/user.tsx
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useState
+} from "react";
+import { z } from "zod";
+import { jsx } from "react/jsx-runtime";
+var zUser = z.object({
+  username: z.string(),
+  email: z.string(),
+  firstName: z.string(),
+  lastName: z.string(),
+  iconUrl: z.string().nullable(),
+  roles: z.array(z.string())
+});
+async function fetchUser() {
+  const response = await fetch("/_sqcore/auth", { method: "POST" });
+  if (!response.ok) {
+    throw new Error("Failed to get user");
+  }
+  return zUser.parse(await response.json());
+}
+var UserContext = createContext(null);
+function UserProvider({ children }) {
+  const [state, setState] = useState({ status: "pending" });
+  useEffect(() => {
+    fetchUser().then((data) => setState({ status: "success", data })).catch(
+      (e) => setState({
+        status: "error",
+        error: e instanceof Error ? e.message : "Failed to get user"
+      })
+    );
+  }, []);
+  return /* @__PURE__ */ jsx(UserContext.Provider, { value: state, children });
+}
+function useUser() {
+  const state = useContext(UserContext);
+  if (!state) {
+    throw new Error("<SquadbaseProvider> is not found");
+  }
+  return state;
+}
+
+// src/provider.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+function SquadbaseProvider({ children }) {
+  return /* @__PURE__ */ jsx2(UserProvider, { children });
+}
+export {
+  SquadbaseProvider,
+  useUser
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@squadbase/react",
+  "version": "0.0.1",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup ./src/index.ts",
+    "dev": "tsup ./src/index.ts --watch"
+  },
+  "keywords": [],
+  "author": "Squadbase",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.6.3",
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.2",
+    "react": "^19.0.0"
+  },
+  "peerDependencies": {
+    "@types/react": "17.x || 18.x || 19.x",
+    "react": "17.x || 18.x || 19.x"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  }
+}