@allem-sdk/ai 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,105 @@
+<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" />
+</p>
+
+# @allem-sdk/ai
+
+AI hooks for React built on [Vercel AI SDK v6](https://sdk.vercel.ai). Multi-provider support (Google, Anthropic, OpenAI) with a unified API.
+
+## Installation
+
+```bash
+npm install @allem-sdk/ai ai @ai-sdk/react
+
+# Install at least one provider
+npm install @ai-sdk/google    # Google Gemini
+npm install @ai-sdk/anthropic # Anthropic Claude
+npm install @ai-sdk/openai    # OpenAI GPT
+```
+
+## Client Usage
+
+```tsx
+import { useState } from "react";
+import { AllemAIProvider, useAllemChat } from "@allem-sdk/ai";
+
+function App() {
+  return (
+    <AllemAIProvider api="/api/chat" provider="google">
+      <Chat />
+    </AllemAIProvider>
+  );
+}
+
+function Chat() {
+  const [input, setInput] = useState("");
+  const { messages, sendMessage, status } = useAllemChat();
+  const isLoading = status === "submitted" || status === "streaming";
+
+  return (
+    <div>
+      {messages.map((m) => (
+        <div key={m.id}>
+          {m.parts?.filter((p) => p.type === "text").map((p) => p.text).join("")}
+        </div>
+      ))}
+      <form onSubmit={async (e) => {
+        e.preventDefault();
+        const text = input;
+        setInput("");
+        await sendMessage({ text });
+      }}>
+        <input value={input} onChange={(e) => setInput(e.target.value)} disabled={isLoading} />
+        <button type="submit">Send</button>
+      </form>
+    </div>
+  );
+}
+```
+
+## Server Usage
+
+```ts
+// app/api/chat/route.ts (Next.js)
+import { createAllemChatHandler } from "@allem-sdk/ai";
+import { google } from "@ai-sdk/google";
+import { anthropic } from "@ai-sdk/anthropic";
+
+export const POST = createAllemChatHandler({
+  providers: {
+    google: (model) => google(model ?? "gemini-2.0-flash"),
+    anthropic: (model) => anthropic(model ?? "claude-sonnet-4-20250514"),
+  },
+  defaultProvider: "google",
+});
+```
+
+## Exports
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `useAllemChat` | Hook | Chat hook with streaming, provider context, and message history |
+| `useAllemCompletion` | Hook | Text completion hook for single-turn prompts |
+| `AllemAIProvider` | Component | React context provider for default API and provider config |
+| `createAllemChatHandler` | Server | Server-side API route handler with multi-provider routing |
+
+## Part of [Allem SDK](https://github.com/kingofmit/allem-sdk)
+
+This package can be used standalone or as part of the full SDK. Install `allem-sdk` to get all packages in one install.
+
+## 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/client.d.mts

@@ -0,0 +1,49 @@
+import { UseChatHelpers, UseCompletionOptions, UseCompletionHelpers } from '@ai-sdk/react';
+export { UseChatHelpers, UseCompletionHelpers } from '@ai-sdk/react';
+import { ChatInit, UIMessage } from 'ai';
+export { UIMessage } from 'ai';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type AllemProvider = "google" | "anthropic" | "openai";
+interface UseAllemChatOptions extends Omit<ChatInit<UIMessage>, "transport"> {
+    /** Override the API endpoint from AllemAIProvider. */
+    api?: string;
+    /** Model identifier sent in the request body (e.g. "gemini-2.0-flash"). */
+    model?: string;
+    /** Provider name sent in the request body. */
+    provider?: AllemProvider;
+    /** System prompt sent in the request body. */
+    systemPrompt?: string;
+    /** Extra headers merged with AllemAIProvider headers. */
+    headers?: Record<string, string>;
+    /** Custom throttle wait in ms for updates. */
+    experimental_throttle?: number;
+}
+declare function useAllemChat(options?: UseAllemChatOptions): UseChatHelpers<UIMessage>;
+
+interface UseAllemCompletionOptions extends UseCompletionOptions {
+    /** Override the API endpoint from AllemAIProvider. */
+    api?: string;
+    /** Extra headers merged with AllemAIProvider headers. */
+    headers?: Record<string, string>;
+}
+declare function useAllemCompletion(options?: UseAllemCompletionOptions): UseCompletionHelpers;
+
+interface AllemAIConfig {
+    /** API endpoint for chat. Default: "/api/chat" */
+    api: string;
+    /** Default model identifier (e.g. "gemini-2.0-flash", "claude-sonnet-4-20250514"). */
+    model?: string;
+    /** Default provider. */
+    provider?: "google" | "anthropic" | "openai";
+    /** Extra headers sent with every request. */
+    headers?: Record<string, string>;
+}
+interface AllemAIProviderProps extends Partial<AllemAIConfig> {
+    children: ReactNode;
+}
+declare function AllemAIProvider({ children, ...config }: AllemAIProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAllemAIConfig(): AllemAIConfig;
+
+export { type AllemAIConfig, AllemAIProvider, type AllemAIProviderProps, type AllemProvider, type UseAllemChatOptions, type UseAllemCompletionOptions, useAllemAIConfig, useAllemChat, useAllemCompletion };

package/dist/client.d.ts

@@ -0,0 +1,49 @@
+import { UseChatHelpers, UseCompletionOptions, UseCompletionHelpers } from '@ai-sdk/react';
+export { UseChatHelpers, UseCompletionHelpers } from '@ai-sdk/react';
+import { ChatInit, UIMessage } from 'ai';
+export { UIMessage } from 'ai';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type AllemProvider = "google" | "anthropic" | "openai";
+interface UseAllemChatOptions extends Omit<ChatInit<UIMessage>, "transport"> {
+    /** Override the API endpoint from AllemAIProvider. */
+    api?: string;
+    /** Model identifier sent in the request body (e.g. "gemini-2.0-flash"). */
+    model?: string;
+    /** Provider name sent in the request body. */
+    provider?: AllemProvider;
+    /** System prompt sent in the request body. */
+    systemPrompt?: string;
+    /** Extra headers merged with AllemAIProvider headers. */
+    headers?: Record<string, string>;
+    /** Custom throttle wait in ms for updates. */
+    experimental_throttle?: number;
+}
+declare function useAllemChat(options?: UseAllemChatOptions): UseChatHelpers<UIMessage>;
+
+interface UseAllemCompletionOptions extends UseCompletionOptions {
+    /** Override the API endpoint from AllemAIProvider. */
+    api?: string;
+    /** Extra headers merged with AllemAIProvider headers. */
+    headers?: Record<string, string>;
+}
+declare function useAllemCompletion(options?: UseAllemCompletionOptions): UseCompletionHelpers;
+
+interface AllemAIConfig {
+    /** API endpoint for chat. Default: "/api/chat" */
+    api: string;
+    /** Default model identifier (e.g. "gemini-2.0-flash", "claude-sonnet-4-20250514"). */
+    model?: string;
+    /** Default provider. */
+    provider?: "google" | "anthropic" | "openai";
+    /** Extra headers sent with every request. */
+    headers?: Record<string, string>;
+}
+interface AllemAIProviderProps extends Partial<AllemAIConfig> {
+    children: ReactNode;
+}
+declare function AllemAIProvider({ children, ...config }: AllemAIProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAllemAIConfig(): AllemAIConfig;
+
+export { type AllemAIConfig, AllemAIProvider, type AllemAIProviderProps, type AllemProvider, type UseAllemChatOptions, type UseAllemCompletionOptions, useAllemAIConfig, useAllemChat, useAllemCompletion };

package/dist/client.js

@@ -0,0 +1,103 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  AllemAIProvider: () => AllemAIProvider,
+  useAllemAIConfig: () => useAllemAIConfig,
+  useAllemChat: () => useAllemChat,
+  useAllemCompletion: () => useAllemCompletion
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/useAllemChat.ts
+var import_react2 = require("@ai-sdk/react");
+var import_ai = require("ai");
+
+// src/AllemAIProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var defaults = {
+  api: "/api/chat",
+  provider: "google"
+};
+var AllemAIContext = (0, import_react.createContext)(defaults);
+function AllemAIProvider({
+  children,
+  ...config
+}) {
+  const value = { ...defaults, ...config };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AllemAIContext.Provider, { value, children });
+}
+function useAllemAIConfig() {
+  return (0, import_react.useContext)(AllemAIContext);
+}
+
+// src/useAllemChat.ts
+function useAllemChat(options = {}) {
+  const config = useAllemAIConfig();
+  const {
+    api,
+    model,
+    provider,
+    systemPrompt,
+    headers,
+    experimental_throttle,
+    ...restOptions
+  } = options;
+  const resolvedApi = api ?? config.api;
+  const resolvedModel = model ?? config.model;
+  const resolvedProvider = provider ?? config.provider;
+  const resolvedHeaders = { ...config.headers, ...headers };
+  const transport = new import_ai.DefaultChatTransport({
+    api: resolvedApi,
+    headers: resolvedHeaders,
+    body: {
+      ...resolvedModel && { model: resolvedModel },
+      ...resolvedProvider && { provider: resolvedProvider },
+      ...systemPrompt && { systemPrompt }
+    }
+  });
+  return (0, import_react2.useChat)({
+    transport,
+    experimental_throttle,
+    ...restOptions
+  });
+}
+
+// src/useAllemCompletion.ts
+var import_react3 = require("@ai-sdk/react");
+function useAllemCompletion(options = {}) {
+  const config = useAllemAIConfig();
+  const { api, headers, ...restOptions } = options;
+  return (0, import_react3.useCompletion)({
+    api: api ?? config.api,
+    headers: { ...config.headers, ...headers },
+    ...restOptions
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AllemAIProvider,
+  useAllemAIConfig,
+  useAllemChat,
+  useAllemCompletion
+});

package/dist/client.mjs

@@ -0,0 +1,76 @@
+"use client";
+
+// src/useAllemChat.ts
+import { useChat } from "@ai-sdk/react";
+import { DefaultChatTransport } from "ai";
+
+// src/AllemAIProvider.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var defaults = {
+  api: "/api/chat",
+  provider: "google"
+};
+var AllemAIContext = createContext(defaults);
+function AllemAIProvider({
+  children,
+  ...config
+}) {
+  const value = { ...defaults, ...config };
+  return /* @__PURE__ */ jsx(AllemAIContext.Provider, { value, children });
+}
+function useAllemAIConfig() {
+  return useContext(AllemAIContext);
+}
+
+// src/useAllemChat.ts
+function useAllemChat(options = {}) {
+  const config = useAllemAIConfig();
+  const {
+    api,
+    model,
+    provider,
+    systemPrompt,
+    headers,
+    experimental_throttle,
+    ...restOptions
+  } = options;
+  const resolvedApi = api ?? config.api;
+  const resolvedModel = model ?? config.model;
+  const resolvedProvider = provider ?? config.provider;
+  const resolvedHeaders = { ...config.headers, ...headers };
+  const transport = new DefaultChatTransport({
+    api: resolvedApi,
+    headers: resolvedHeaders,
+    body: {
+      ...resolvedModel && { model: resolvedModel },
+      ...resolvedProvider && { provider: resolvedProvider },
+      ...systemPrompt && { systemPrompt }
+    }
+  });
+  return useChat({
+    transport,
+    experimental_throttle,
+    ...restOptions
+  });
+}
+
+// src/useAllemCompletion.ts
+import {
+  useCompletion
+} from "@ai-sdk/react";
+function useAllemCompletion(options = {}) {
+  const config = useAllemAIConfig();
+  const { api, headers, ...restOptions } = options;
+  return useCompletion({
+    api: api ?? config.api,
+    headers: { ...config.headers, ...headers },
+    ...restOptions
+  });
+}
+export {
+  AllemAIProvider,
+  useAllemAIConfig,
+  useAllemChat,
+  useAllemCompletion
+};

package/dist/index.d.mts

@@ -0,0 +1,84 @@
+import { UseChatHelpers, UseCompletionOptions, UseCompletionHelpers } from '@ai-sdk/react';
+export { UseChatHelpers, UseCompletionHelpers } from '@ai-sdk/react';
+import { ChatInit, UIMessage, LanguageModel, ToolSet } from 'ai';
+export { UIMessage } from 'ai';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type AllemProvider = "google" | "anthropic" | "openai";
+interface UseAllemChatOptions extends Omit<ChatInit<UIMessage>, "transport"> {
+    /** Override the API endpoint from AllemAIProvider. */
+    api?: string;
+    /** Model identifier sent in the request body (e.g. "gemini-2.0-flash"). */
+    model?: string;
+    /** Provider name sent in the request body. */
+    provider?: AllemProvider;
+    /** System prompt sent in the request body. */
+    systemPrompt?: string;
+    /** Extra headers merged with AllemAIProvider headers. */
+    headers?: Record<string, string>;
+    /** Custom throttle wait in ms for updates. */
+    experimental_throttle?: number;
+}
+declare function useAllemChat(options?: UseAllemChatOptions): UseChatHelpers<UIMessage>;
+
+interface UseAllemCompletionOptions extends UseCompletionOptions {
+    /** Override the API endpoint from AllemAIProvider. */
+    api?: string;
+    /** Extra headers merged with AllemAIProvider headers. */
+    headers?: Record<string, string>;
+}
+declare function useAllemCompletion(options?: UseAllemCompletionOptions): UseCompletionHelpers;
+
+interface AllemAIConfig {
+    /** API endpoint for chat. Default: "/api/chat" */
+    api: string;
+    /** Default model identifier (e.g. "gemini-2.0-flash", "claude-sonnet-4-20250514"). */
+    model?: string;
+    /** Default provider. */
+    provider?: "google" | "anthropic" | "openai";
+    /** Extra headers sent with every request. */
+    headers?: Record<string, string>;
+}
+interface AllemAIProviderProps extends Partial<AllemAIConfig> {
+    children: ReactNode;
+}
+declare function AllemAIProvider({ children, ...config }: AllemAIProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAllemAIConfig(): AllemAIConfig;
+
+type AllemProviderName = "google" | "anthropic" | "openai";
+interface AllemChatHandlerConfig {
+    /** Map of provider name to a function that returns a LanguageModel for a given model ID. */
+    providers: Partial<Record<AllemProviderName, (modelId?: string) => LanguageModel>>;
+    /** Default provider when none is specified in the request. Default: "google". */
+    defaultProvider?: AllemProviderName;
+    /** Default model ID when none is specified in the request. */
+    defaultModel?: string;
+    /** Default system prompt. */
+    systemPrompt?: string;
+    /** Tools available to the model. */
+    tools?: ToolSet;
+}
+/**
+ * Creates an API route handler for AI chat.
+ * Works with Next.js App Router, Remix, and any framework that uses
+ * the Web Request/Response API.
+ *
+ * @example
+ * ```ts
+ * // app/api/chat/route.ts (Next.js)
+ * import { createAllemChatHandler } from "@allem-sdk/ai";
+ * import { google } from "@ai-sdk/google";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ *
+ * export const POST = createAllemChatHandler({
+ *   providers: {
+ *     google: (model) => google(model ?? "gemini-2.0-flash"),
+ *     anthropic: (model) => anthropic(model ?? "claude-sonnet-4-20250514"),
+ *   },
+ * });
+ * ```
+ */
+declare function createAllemChatHandler(config: AllemChatHandlerConfig): (req: Request) => Promise<Response>;
+
+export { type AllemAIConfig, AllemAIProvider, type AllemAIProviderProps, type AllemChatHandlerConfig, type AllemProvider, type AllemProviderName, type UseAllemChatOptions, type UseAllemCompletionOptions, createAllemChatHandler, useAllemAIConfig, useAllemChat, useAllemCompletion };

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+import { UseChatHelpers, UseCompletionOptions, UseCompletionHelpers } from '@ai-sdk/react';
+export { UseChatHelpers, UseCompletionHelpers } from '@ai-sdk/react';
+import { ChatInit, UIMessage, LanguageModel, ToolSet } from 'ai';
+export { UIMessage } from 'ai';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type AllemProvider = "google" | "anthropic" | "openai";
+interface UseAllemChatOptions extends Omit<ChatInit<UIMessage>, "transport"> {
+    /** Override the API endpoint from AllemAIProvider. */
+    api?: string;
+    /** Model identifier sent in the request body (e.g. "gemini-2.0-flash"). */
+    model?: string;
+    /** Provider name sent in the request body. */
+    provider?: AllemProvider;
+    /** System prompt sent in the request body. */
+    systemPrompt?: string;
+    /** Extra headers merged with AllemAIProvider headers. */
+    headers?: Record<string, string>;
+    /** Custom throttle wait in ms for updates. */
+    experimental_throttle?: number;
+}
+declare function useAllemChat(options?: UseAllemChatOptions): UseChatHelpers<UIMessage>;
+
+interface UseAllemCompletionOptions extends UseCompletionOptions {
+    /** Override the API endpoint from AllemAIProvider. */
+    api?: string;
+    /** Extra headers merged with AllemAIProvider headers. */
+    headers?: Record<string, string>;
+}
+declare function useAllemCompletion(options?: UseAllemCompletionOptions): UseCompletionHelpers;
+
+interface AllemAIConfig {
+    /** API endpoint for chat. Default: "/api/chat" */
+    api: string;
+    /** Default model identifier (e.g. "gemini-2.0-flash", "claude-sonnet-4-20250514"). */
+    model?: string;
+    /** Default provider. */
+    provider?: "google" | "anthropic" | "openai";
+    /** Extra headers sent with every request. */
+    headers?: Record<string, string>;
+}
+interface AllemAIProviderProps extends Partial<AllemAIConfig> {
+    children: ReactNode;
+}
+declare function AllemAIProvider({ children, ...config }: AllemAIProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAllemAIConfig(): AllemAIConfig;
+
+type AllemProviderName = "google" | "anthropic" | "openai";
+interface AllemChatHandlerConfig {
+    /** Map of provider name to a function that returns a LanguageModel for a given model ID. */
+    providers: Partial<Record<AllemProviderName, (modelId?: string) => LanguageModel>>;
+    /** Default provider when none is specified in the request. Default: "google". */
+    defaultProvider?: AllemProviderName;
+    /** Default model ID when none is specified in the request. */
+    defaultModel?: string;
+    /** Default system prompt. */
+    systemPrompt?: string;
+    /** Tools available to the model. */
+    tools?: ToolSet;
+}
+/**
+ * Creates an API route handler for AI chat.
+ * Works with Next.js App Router, Remix, and any framework that uses
+ * the Web Request/Response API.
+ *
+ * @example
+ * ```ts
+ * // app/api/chat/route.ts (Next.js)
+ * import { createAllemChatHandler } from "@allem-sdk/ai";
+ * import { google } from "@ai-sdk/google";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ *
+ * export const POST = createAllemChatHandler({
+ *   providers: {
+ *     google: (model) => google(model ?? "gemini-2.0-flash"),
+ *     anthropic: (model) => anthropic(model ?? "claude-sonnet-4-20250514"),
+ *   },
+ * });
+ * ```
+ */
+declare function createAllemChatHandler(config: AllemChatHandlerConfig): (req: Request) => Promise<Response>;
+
+export { type AllemAIConfig, AllemAIProvider, type AllemAIProviderProps, type AllemChatHandlerConfig, type AllemProvider, type AllemProviderName, type UseAllemChatOptions, type UseAllemCompletionOptions, createAllemChatHandler, useAllemAIConfig, useAllemChat, useAllemCompletion };

package/dist/index.js

@@ -0,0 +1,138 @@
+"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 src_exports = {};
+__export(src_exports, {
+  AllemAIProvider: () => AllemAIProvider,
+  createAllemChatHandler: () => createAllemChatHandler,
+  useAllemAIConfig: () => useAllemAIConfig,
+  useAllemChat: () => useAllemChat,
+  useAllemCompletion: () => useAllemCompletion
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/useAllemChat.ts
+var import_react2 = require("@ai-sdk/react");
+var import_ai = require("ai");
+
+// src/AllemAIProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var defaults = {
+  api: "/api/chat",
+  provider: "google"
+};
+var AllemAIContext = (0, import_react.createContext)(defaults);
+function AllemAIProvider({
+  children,
+  ...config
+}) {
+  const value = { ...defaults, ...config };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AllemAIContext.Provider, { value, children });
+}
+function useAllemAIConfig() {
+  return (0, import_react.useContext)(AllemAIContext);
+}
+
+// src/useAllemChat.ts
+function useAllemChat(options = {}) {
+  const config = useAllemAIConfig();
+  const {
+    api,
+    model,
+    provider,
+    systemPrompt,
+    headers,
+    experimental_throttle,
+    ...restOptions
+  } = options;
+  const resolvedApi = api ?? config.api;
+  const resolvedModel = model ?? config.model;
+  const resolvedProvider = provider ?? config.provider;
+  const resolvedHeaders = { ...config.headers, ...headers };
+  const transport = new import_ai.DefaultChatTransport({
+    api: resolvedApi,
+    headers: resolvedHeaders,
+    body: {
+      ...resolvedModel && { model: resolvedModel },
+      ...resolvedProvider && { provider: resolvedProvider },
+      ...systemPrompt && { systemPrompt }
+    }
+  });
+  return (0, import_react2.useChat)({
+    transport,
+    experimental_throttle,
+    ...restOptions
+  });
+}
+
+// src/useAllemCompletion.ts
+var import_react3 = require("@ai-sdk/react");
+function useAllemCompletion(options = {}) {
+  const config = useAllemAIConfig();
+  const { api, headers, ...restOptions } = options;
+  return (0, import_react3.useCompletion)({
+    api: api ?? config.api,
+    headers: { ...config.headers, ...headers },
+    ...restOptions
+  });
+}
+
+// src/createAllemChatHandler.ts
+var import_ai2 = require("ai");
+function createAllemChatHandler(config) {
+  const {
+    providers,
+    defaultProvider = "google",
+    defaultModel,
+    systemPrompt: defaultSystemPrompt,
+    tools
+  } = config;
+  return async function handler(req) {
+    const body = await req.json();
+    const providerName = body.provider ?? defaultProvider;
+    const modelId = body.model ?? defaultModel;
+    const system = body.systemPrompt ?? defaultSystemPrompt;
+    const providerFactory = providers[providerName];
+    if (!providerFactory) {
+      return new Response(
+        JSON.stringify({ error: `Provider "${providerName}" is not configured.` }),
+        { status: 400, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    const model = providerFactory(modelId);
+    const modelMessages = await (0, import_ai2.convertToModelMessages)(body.messages);
+    const result = (0, import_ai2.streamText)({
+      model,
+      system,
+      messages: modelMessages,
+      tools
+    });
+    return result.toUIMessageStreamResponse();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AllemAIProvider,
+  createAllemChatHandler,
+  useAllemAIConfig,
+  useAllemChat,
+  useAllemCompletion
+});

package/dist/index.mjs

@@ -0,0 +1,112 @@
+// src/useAllemChat.ts
+import { useChat } from "@ai-sdk/react";
+import { DefaultChatTransport } from "ai";
+
+// src/AllemAIProvider.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var defaults = {
+  api: "/api/chat",
+  provider: "google"
+};
+var AllemAIContext = createContext(defaults);
+function AllemAIProvider({
+  children,
+  ...config
+}) {
+  const value = { ...defaults, ...config };
+  return /* @__PURE__ */ jsx(AllemAIContext.Provider, { value, children });
+}
+function useAllemAIConfig() {
+  return useContext(AllemAIContext);
+}
+
+// src/useAllemChat.ts
+function useAllemChat(options = {}) {
+  const config = useAllemAIConfig();
+  const {
+    api,
+    model,
+    provider,
+    systemPrompt,
+    headers,
+    experimental_throttle,
+    ...restOptions
+  } = options;
+  const resolvedApi = api ?? config.api;
+  const resolvedModel = model ?? config.model;
+  const resolvedProvider = provider ?? config.provider;
+  const resolvedHeaders = { ...config.headers, ...headers };
+  const transport = new DefaultChatTransport({
+    api: resolvedApi,
+    headers: resolvedHeaders,
+    body: {
+      ...resolvedModel && { model: resolvedModel },
+      ...resolvedProvider && { provider: resolvedProvider },
+      ...systemPrompt && { systemPrompt }
+    }
+  });
+  return useChat({
+    transport,
+    experimental_throttle,
+    ...restOptions
+  });
+}
+
+// src/useAllemCompletion.ts
+import {
+  useCompletion
+} from "@ai-sdk/react";
+function useAllemCompletion(options = {}) {
+  const config = useAllemAIConfig();
+  const { api, headers, ...restOptions } = options;
+  return useCompletion({
+    api: api ?? config.api,
+    headers: { ...config.headers, ...headers },
+    ...restOptions
+  });
+}
+
+// src/createAllemChatHandler.ts
+import {
+  streamText,
+  convertToModelMessages
+} from "ai";
+function createAllemChatHandler(config) {
+  const {
+    providers,
+    defaultProvider = "google",
+    defaultModel,
+    systemPrompt: defaultSystemPrompt,
+    tools
+  } = config;
+  return async function handler(req) {
+    const body = await req.json();
+    const providerName = body.provider ?? defaultProvider;
+    const modelId = body.model ?? defaultModel;
+    const system = body.systemPrompt ?? defaultSystemPrompt;
+    const providerFactory = providers[providerName];
+    if (!providerFactory) {
+      return new Response(
+        JSON.stringify({ error: `Provider "${providerName}" is not configured.` }),
+        { status: 400, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    const model = providerFactory(modelId);
+    const modelMessages = await convertToModelMessages(body.messages);
+    const result = streamText({
+      model,
+      system,
+      messages: modelMessages,
+      tools
+    });
+    return result.toUIMessageStreamResponse();
+  };
+}
+export {
+  AllemAIProvider,
+  createAllemChatHandler,
+  useAllemAIConfig,
+  useAllemChat,
+  useAllemCompletion
+};

package/dist/server.d.mts

@@ -0,0 +1,38 @@
+import { LanguageModel, ToolSet } from 'ai';
+
+type AllemProviderName = "google" | "anthropic" | "openai";
+interface AllemChatHandlerConfig {
+    /** Map of provider name to a function that returns a LanguageModel for a given model ID. */
+    providers: Partial<Record<AllemProviderName, (modelId?: string) => LanguageModel>>;
+    /** Default provider when none is specified in the request. Default: "google". */
+    defaultProvider?: AllemProviderName;
+    /** Default model ID when none is specified in the request. */
+    defaultModel?: string;
+    /** Default system prompt. */
+    systemPrompt?: string;
+    /** Tools available to the model. */
+    tools?: ToolSet;
+}
+/**
+ * Creates an API route handler for AI chat.
+ * Works with Next.js App Router, Remix, and any framework that uses
+ * the Web Request/Response API.
+ *
+ * @example
+ * ```ts
+ * // app/api/chat/route.ts (Next.js)
+ * import { createAllemChatHandler } from "@allem-sdk/ai";
+ * import { google } from "@ai-sdk/google";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ *
+ * export const POST = createAllemChatHandler({
+ *   providers: {
+ *     google: (model) => google(model ?? "gemini-2.0-flash"),
+ *     anthropic: (model) => anthropic(model ?? "claude-sonnet-4-20250514"),
+ *   },
+ * });
+ * ```
+ */
+declare function createAllemChatHandler(config: AllemChatHandlerConfig): (req: Request) => Promise<Response>;
+
+export { type AllemChatHandlerConfig, type AllemProviderName, createAllemChatHandler };

package/dist/server.d.ts

@@ -0,0 +1,38 @@
+import { LanguageModel, ToolSet } from 'ai';
+
+type AllemProviderName = "google" | "anthropic" | "openai";
+interface AllemChatHandlerConfig {
+    /** Map of provider name to a function that returns a LanguageModel for a given model ID. */
+    providers: Partial<Record<AllemProviderName, (modelId?: string) => LanguageModel>>;
+    /** Default provider when none is specified in the request. Default: "google". */
+    defaultProvider?: AllemProviderName;
+    /** Default model ID when none is specified in the request. */
+    defaultModel?: string;
+    /** Default system prompt. */
+    systemPrompt?: string;
+    /** Tools available to the model. */
+    tools?: ToolSet;
+}
+/**
+ * Creates an API route handler for AI chat.
+ * Works with Next.js App Router, Remix, and any framework that uses
+ * the Web Request/Response API.
+ *
+ * @example
+ * ```ts
+ * // app/api/chat/route.ts (Next.js)
+ * import { createAllemChatHandler } from "@allem-sdk/ai";
+ * import { google } from "@ai-sdk/google";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ *
+ * export const POST = createAllemChatHandler({
+ *   providers: {
+ *     google: (model) => google(model ?? "gemini-2.0-flash"),
+ *     anthropic: (model) => anthropic(model ?? "claude-sonnet-4-20250514"),
+ *   },
+ * });
+ * ```
+ */
+declare function createAllemChatHandler(config: AllemChatHandlerConfig): (req: Request) => Promise<Response>;
+
+export { type AllemChatHandlerConfig, type AllemProviderName, createAllemChatHandler };

package/dist/server.js

@@ -0,0 +1,63 @@
+"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/server.ts
+var server_exports = {};
+__export(server_exports, {
+  createAllemChatHandler: () => createAllemChatHandler
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/createAllemChatHandler.ts
+var import_ai = require("ai");
+function createAllemChatHandler(config) {
+  const {
+    providers,
+    defaultProvider = "google",
+    defaultModel,
+    systemPrompt: defaultSystemPrompt,
+    tools
+  } = config;
+  return async function handler(req) {
+    const body = await req.json();
+    const providerName = body.provider ?? defaultProvider;
+    const modelId = body.model ?? defaultModel;
+    const system = body.systemPrompt ?? defaultSystemPrompt;
+    const providerFactory = providers[providerName];
+    if (!providerFactory) {
+      return new Response(
+        JSON.stringify({ error: `Provider "${providerName}" is not configured.` }),
+        { status: 400, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    const model = providerFactory(modelId);
+    const modelMessages = await (0, import_ai.convertToModelMessages)(body.messages);
+    const result = (0, import_ai.streamText)({
+      model,
+      system,
+      messages: modelMessages,
+      tools
+    });
+    return result.toUIMessageStreamResponse();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAllemChatHandler
+});

package/dist/server.mjs

@@ -0,0 +1,39 @@
+// src/createAllemChatHandler.ts
+import {
+  streamText,
+  convertToModelMessages
+} from "ai";
+function createAllemChatHandler(config) {
+  const {
+    providers,
+    defaultProvider = "google",
+    defaultModel,
+    systemPrompt: defaultSystemPrompt,
+    tools
+  } = config;
+  return async function handler(req) {
+    const body = await req.json();
+    const providerName = body.provider ?? defaultProvider;
+    const modelId = body.model ?? defaultModel;
+    const system = body.systemPrompt ?? defaultSystemPrompt;
+    const providerFactory = providers[providerName];
+    if (!providerFactory) {
+      return new Response(
+        JSON.stringify({ error: `Provider "${providerName}" is not configured.` }),
+        { status: 400, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    const model = providerFactory(modelId);
+    const modelMessages = await convertToModelMessages(body.messages);
+    const result = streamText({
+      model,
+      system,
+      messages: modelMessages,
+      tools
+    });
+    return result.toUIMessageStreamResponse();
+  };
+}
+export {
+  createAllemChatHandler
+};

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@allem-sdk/ai",
+  "version": "0.1.0",
+  "description": "AI hooks for React — useChat, useAgent, useStreaming. Built on Vercel AI SDK.",
+  "license": "MIT",
+  "author": "Ahmed Allem",
+  "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"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.mjs",
+      "require": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.78",
+    "@ai-sdk/google": "^3.0.75",
+    "@ai-sdk/openai": "^3.0.64",
+    "@ai-sdk/react": "^3.0.187",
+    "@types/react": "^19.0.0",
+    "ai": "^6.0.185",
+    "react": "^19.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": ">=3.0.0",
+    "@ai-sdk/google": ">=3.0.0",
+    "@ai-sdk/openai": ">=3.0.0",
+    "@ai-sdk/react": ">=3.0.0",
+    "ai": ">=6.0.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kingofmit/allem-sdk.git",
+    "directory": "packages/ai"
+  },
+  "keywords": [
+    "allem-sdk",
+    "ai",
+    "react",
+    "hooks",
+    "useChat",
+    "useAgent",
+    "vercel-ai-sdk",
+    "llm"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}