allem-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Allem
+
+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,76 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kingofmit/allem-sdk/main/.github/AllemSDK.png" alt="Allem SDK" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/kingofmit/allem-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
+  <img src="https://img.shields.io/badge/react-18+-61dafb" alt="React 18+" />
+  <img src="https://img.shields.io/badge/typescript-strict-blue" alt="TypeScript" />
+  <img src="https://img.shields.io/badge/AI_SDK-v6-black" alt="AI SDK v6" />
+  <img src="https://img.shields.io/badge/tests-44_passing-brightgreen" alt="Tests" />
+</p>
+
+# allem-sdk
+
+The complete Allem SDK for React — hooks, AI, forms, analytics, and auth in a single install.
+
+## Installation
+
+```bash
+npm install allem-sdk
+```
+
+Or install individual packages:
+
+```bash
+npm install @allem-sdk/hooks       # React hooks
+npm install @allem-sdk/ai          # AI chat & completions
+npm install @allem-sdk/forms       # Form management
+npm install @allem-sdk/analytics   # Analytics tracking
+npm install @allem-sdk/auth        # Authentication
+```
+
+## Quick Start
+
+```tsx
+import { useDebounce, useLocalStorage } from "allem-sdk/hooks";
+import { useAllemChat } from "allem-sdk/ai";
+import { useForm, required, email } from "allem-sdk/forms";
+import { AnalyticsProvider, useTrack } from "allem-sdk/analytics";
+import { AuthProvider, useAuth, ProtectedRoute } from "allem-sdk/auth";
+
+// Or import everything from the root
+import { useDebounce, useAllemChat, useForm, useAuth } from "allem-sdk";
+```
+
+## Packages
+
+| Package | Description |
+|---------|-------------|
+| [`@allem-sdk/hooks`](https://www.npmjs.com/package/@allem-sdk/hooks) | 8 essential React hooks — useDebounce, useLocalStorage, useMediaQuery, and more |
+| [`@allem-sdk/ai`](https://www.npmjs.com/package/@allem-sdk/ai) | AI hooks built on Vercel AI SDK v6 — multi-provider chat & completions |
+| [`@allem-sdk/forms`](https://www.npmjs.com/package/@allem-sdk/forms) | Lightweight form management with 9 built-in validators |
+| [`@allem-sdk/analytics`](https://www.npmjs.com/package/@allem-sdk/analytics) | Provider-agnostic analytics — works with Mixpanel, Segment, PostHog, etc. |
+| [`@allem-sdk/auth`](https://www.npmjs.com/package/@allem-sdk/auth) | Authentication helpers — session management, protected routes |
+
+## Features
+
+- **SSR-safe** — works with Next.js, Vite, and Remix out of the box
+- **TypeScript strict** — full type safety with exported types
+- **Zero lock-in** — adapter pattern for AI, analytics, and auth providers
+- **Tree-shakeable** — ESM + CJS builds, import only what you need
+- **Lightweight** — no heavy dependencies, just React hooks
+
+## Part of Allem SDK
+
+This is the meta-package for the [Allem SDK](https://github.com/kingofmit/allem-sdk) monorepo. Install this package to get everything, or install individual `@allem-sdk/*` packages for smaller bundles.
+
+## Support
+
+If you find Allem SDK useful, consider supporting its development:
+
+<a href="https://buymeacoffee.com/kingofmit" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50" /></a>
+
+## License
+
+[MIT](https://github.com/kingofmit/allem-sdk/blob/main/LICENSE) - [Ahmed Allem](https://kingallem.com)

package/dist/ai.d.mts

@@ -0,0 +1,5 @@
+export * from '@allem-sdk/ai';
+import '@allem-sdk/analytics';
+import '@allem-sdk/auth';
+import '@allem-sdk/forms';
+import '@allem-sdk/hooks';

package/dist/ai.d.ts

@@ -0,0 +1,5 @@
+export * from '@allem-sdk/ai';
+import '@allem-sdk/analytics';
+import '@allem-sdk/auth';
+import '@allem-sdk/forms';
+import '@allem-sdk/hooks';

package/dist/ai.js

@@ -0,0 +1,25 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/ai.ts
+var ai_exports = {};
+module.exports = __toCommonJS(ai_exports);
+__reExport(ai_exports, require("@allem-sdk/ai"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("@allem-sdk/ai")
+});

package/dist/ai.mjs

@@ -0,0 +1,4 @@
+"use client";
+
+// src/ai.ts
+export * from "@allem-sdk/ai";

package/dist/analytics.d.mts

@@ -0,0 +1 @@
+export * from '@allem-sdk/analytics';

package/dist/analytics.d.ts

@@ -0,0 +1 @@
+export * from '@allem-sdk/analytics';

package/dist/analytics.js

@@ -0,0 +1,25 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/analytics.ts
+var analytics_exports = {};
+module.exports = __toCommonJS(analytics_exports);
+__reExport(analytics_exports, require("@allem-sdk/analytics"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("@allem-sdk/analytics")
+});

package/dist/analytics.mjs

@@ -0,0 +1,4 @@
+"use client";
+
+// src/analytics.ts
+export * from "@allem-sdk/analytics";

package/dist/auth.d.mts

@@ -0,0 +1 @@
+export * from '@allem-sdk/auth';

package/dist/auth.d.ts

@@ -0,0 +1 @@
+export * from '@allem-sdk/auth';

package/dist/auth.js

@@ -0,0 +1,25 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/auth.ts
+var auth_exports = {};
+module.exports = __toCommonJS(auth_exports);
+__reExport(auth_exports, require("@allem-sdk/auth"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("@allem-sdk/auth")
+});

package/dist/auth.mjs

@@ -0,0 +1,4 @@
+"use client";
+
+// src/auth.ts
+export * from "@allem-sdk/auth";

package/dist/forms.d.mts

@@ -0,0 +1 @@
+export * from '@allem-sdk/forms';

package/dist/forms.d.ts

@@ -0,0 +1 @@
+export * from '@allem-sdk/forms';

package/dist/forms.js

@@ -0,0 +1,25 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/forms.ts
+var forms_exports = {};
+module.exports = __toCommonJS(forms_exports);
+__reExport(forms_exports, require("@allem-sdk/forms"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("@allem-sdk/forms")
+});

package/dist/forms.mjs

@@ -0,0 +1,4 @@
+"use client";
+
+// src/forms.ts
+export * from "@allem-sdk/forms";

package/dist/hooks.d.mts

@@ -0,0 +1 @@
+export * from '@allem-sdk/hooks';

package/dist/hooks.d.ts

@@ -0,0 +1 @@
+export * from '@allem-sdk/hooks';

package/dist/hooks.js

@@ -0,0 +1,25 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks.ts
+var hooks_exports = {};
+module.exports = __toCommonJS(hooks_exports);
+__reExport(hooks_exports, require("@allem-sdk/hooks"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("@allem-sdk/hooks")
+});

package/dist/hooks.mjs

@@ -0,0 +1,4 @@
+"use client";
+
+// src/hooks.ts
+export * from "@allem-sdk/hooks";

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+export { useClickOutside, useCopyToClipboard, useDebounce, useIntersectionObserver, useLocalStorage, useMediaQuery, useToggle, useWindowSize } from '@allem-sdk/hooks';
+export * from '@allem-sdk/ai';
+export { FieldConfig, FormConfig, FormErrors, FormTouched, UseFieldOptions, UseFieldReturn, UseFormReturn, ValidationRule, custom, email, max, maxLength, min, minLength, pattern, required, url, useField, useForm } from '@allem-sdk/forms';
+export { AnalyticsAdapter, AnalyticsProvider, AnalyticsProviderProps, useIdentify, usePageView, useTrack } from '@allem-sdk/analytics';
+export { AuthAdapter, AuthProvider, AuthProviderProps, AuthSession, AuthStatus, AuthUser, ProtectedRoute, ProtectedRouteProps, UseAuthReturn, UseSessionReturn, useAuth, useSession } from '@allem-sdk/auth';

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { useClickOutside, useCopyToClipboard, useDebounce, useIntersectionObserver, useLocalStorage, useMediaQuery, useToggle, useWindowSize } from '@allem-sdk/hooks';
+export * from '@allem-sdk/ai';
+export { FieldConfig, FormConfig, FormErrors, FormTouched, UseFieldOptions, UseFieldReturn, UseFormReturn, ValidationRule, custom, email, max, maxLength, min, minLength, pattern, required, url, useField, useForm } from '@allem-sdk/forms';
+export { AnalyticsAdapter, AnalyticsProvider, AnalyticsProviderProps, useIdentify, usePageView, useTrack } from '@allem-sdk/analytics';
+export { AuthAdapter, AuthProvider, AuthProviderProps, AuthSession, AuthStatus, AuthUser, ProtectedRoute, ProtectedRouteProps, UseAuthReturn, UseSessionReturn, useAuth, useSession } from '@allem-sdk/auth';

package/dist/index.js

@@ -0,0 +1,89 @@
+"use client";
+"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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AnalyticsProvider: () => import_analytics.AnalyticsProvider,
+  AuthProvider: () => import_auth.AuthProvider,
+  ProtectedRoute: () => import_auth.ProtectedRoute,
+  custom: () => import_forms.custom,
+  email: () => import_forms.email,
+  max: () => import_forms.max,
+  maxLength: () => import_forms.maxLength,
+  min: () => import_forms.min,
+  minLength: () => import_forms.minLength,
+  pattern: () => import_forms.pattern,
+  required: () => import_forms.required,
+  url: () => import_forms.url,
+  useAuth: () => import_auth.useAuth,
+  useClickOutside: () => import_hooks.useClickOutside,
+  useCopyToClipboard: () => import_hooks.useCopyToClipboard,
+  useDebounce: () => import_hooks.useDebounce,
+  useField: () => import_forms.useField,
+  useForm: () => import_forms.useForm,
+  useIdentify: () => import_analytics.useIdentify,
+  useIntersectionObserver: () => import_hooks.useIntersectionObserver,
+  useLocalStorage: () => import_hooks.useLocalStorage,
+  useMediaQuery: () => import_hooks.useMediaQuery,
+  usePageView: () => import_analytics.usePageView,
+  useSession: () => import_auth.useSession,
+  useToggle: () => import_hooks.useToggle,
+  useTrack: () => import_analytics.useTrack,
+  useWindowSize: () => import_hooks.useWindowSize
+});
+module.exports = __toCommonJS(index_exports);
+var import_hooks = require("@allem-sdk/hooks");
+__reExport(index_exports, require("@allem-sdk/ai"), module.exports);
+var import_forms = require("@allem-sdk/forms");
+var import_analytics = require("@allem-sdk/analytics");
+var import_auth = require("@allem-sdk/auth");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AnalyticsProvider,
+  AuthProvider,
+  ProtectedRoute,
+  custom,
+  email,
+  max,
+  maxLength,
+  min,
+  minLength,
+  pattern,
+  required,
+  url,
+  useAuth,
+  useClickOutside,
+  useCopyToClipboard,
+  useDebounce,
+  useField,
+  useForm,
+  useIdentify,
+  useIntersectionObserver,
+  useLocalStorage,
+  useMediaQuery,
+  usePageView,
+  useSession,
+  useToggle,
+  useTrack,
+  useWindowSize,
+  ...require("@allem-sdk/ai")
+});

package/dist/index.mjs

@@ -0,0 +1,68 @@
+"use client";
+
+// src/index.ts
+import {
+  useDebounce,
+  useLocalStorage,
+  useMediaQuery,
+  useClickOutside,
+  useToggle,
+  useCopyToClipboard,
+  useIntersectionObserver,
+  useWindowSize
+} from "@allem-sdk/hooks";
+export * from "@allem-sdk/ai";
+import {
+  useForm,
+  useField,
+  required,
+  minLength,
+  maxLength,
+  pattern,
+  min,
+  max,
+  email,
+  url,
+  custom
+} from "@allem-sdk/forms";
+import {
+  AnalyticsProvider,
+  useTrack,
+  usePageView,
+  useIdentify
+} from "@allem-sdk/analytics";
+import {
+  AuthProvider,
+  useAuth,
+  useSession,
+  ProtectedRoute
+} from "@allem-sdk/auth";
+export {
+  AnalyticsProvider,
+  AuthProvider,
+  ProtectedRoute,
+  custom,
+  email,
+  max,
+  maxLength,
+  min,
+  minLength,
+  pattern,
+  required,
+  url,
+  useAuth,
+  useClickOutside,
+  useCopyToClipboard,
+  useDebounce,
+  useField,
+  useForm,
+  useIdentify,
+  useIntersectionObserver,
+  useLocalStorage,
+  useMediaQuery,
+  usePageView,
+  useSession,
+  useToggle,
+  useTrack,
+  useWindowSize
+};

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "allem-sdk",
+  "version": "0.1.0",
+  "description": "The complete Allem SDK — hooks, AI, forms, analytics, and auth for React",
+  "license": "MIT",
+  "author": "Ahmed Allem (https://kingallem.com)",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks.d.ts",
+      "import": "./dist/hooks.mjs",
+      "require": "./dist/hooks.js"
+    },
+    "./ai": {
+      "types": "./dist/ai.d.ts",
+      "import": "./dist/ai.mjs",
+      "require": "./dist/ai.js"
+    },
+    "./forms": {
+      "types": "./dist/forms.d.ts",
+      "import": "./dist/forms.mjs",
+      "require": "./dist/forms.js"
+    },
+    "./analytics": {
+      "types": "./dist/analytics.d.ts",
+      "import": "./dist/analytics.mjs",
+      "require": "./dist/analytics.js"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.mjs",
+      "require": "./dist/auth.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@allem-sdk/hooks": "0.1.0",
+    "@allem-sdk/forms": "0.1.0",
+    "@allem-sdk/analytics": "0.1.0",
+    "@allem-sdk/auth": "0.1.0",
+    "@allem-sdk/ai": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "@ai-sdk/react": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingofmit/allem-sdk.git",
+    "directory": "packages/allem-sdk"
+  },
+  "keywords": [
+    "allem-sdk",
+    "react",
+    "hooks",
+    "ai",
+    "forms",
+    "analytics",
+    "auth",
+    "sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist"
+  }
+}