shivanya-sdk 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2026 Aditya Thute
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1 +1,114 @@
-# shivanya-sdk
+# Shivanya SDK
+
+Reusable TypeScript packages for building Shivanya applications.
+
+Shivanya SDK provides shared frontend building blocks that can be used across Shivanya applications and other React projects.
+
+## Packages
+
+### shivanya-ui
+
+Reusable React UI components.
+
+```bash
+npm install shivanya-ui
+```
+
+### shivanya-shell
+
+Reusable application shell and layout components.
+
+```bash
+npm install shivanya-shell
+```
+
+`shivanya-shell` uses `shivanya-ui` as a package dependency.
+
+## Development
+
+The SDK is maintained as a pnpm monorepo.
+
+Requirements:
+
+- Node.js
+- pnpm
+
+Install dependencies:
+
+```bash
+pnpm install
+```
+
+Build all packages and the development workspace:
+
+```bash
+pnpm build
+```
+
+## Repository Structure
+
+```text
+shivanya-sdk/
+├── packages/
+│   ├── ui/
+│   └── shell/
+│
+├── playground/
+│
+├── package.json
+├── pnpm-workspace.yaml
+└── pnpm-lock.yaml
+```
+
+## Playground
+
+The repository includes a small development playground for contributors to test SDK packages locally.
+
+The playground is not part of the published npm packages.
+
+See:
+
+```text
+playground/README.md
+```
+
+## Package Development
+
+Package source code is located under:
+
+```text
+packages/
+```
+
+Build a specific package:
+
+```bash
+pnpm --filter shivanya-ui build
+```
+
+```bash
+pnpm --filter shivanya-shell build
+```
+
+## Contributing
+
+1. Create a branch.
+2. Make the required package changes.
+3. Test the changes in the playground.
+4. Run the workspace build.
+5. Review the Git changes.
+6. Commit the changes.
+7. Push the branch.
+8. Open a pull request.
+
+Useful commands:
+
+```bash
+git status
+git diff
+pnpm build
+```
+
+## License
+
+ISC

package/package.json

@@ -1,31 +1,30 @@
 {
-    "name": "shivanya-sdk",
-    "version": "0.0.1",
-    "description": "Shivanya SDK",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsc"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/adityathute/shivanya-sdk.git"
-    },
-    "keywords": [],
-    "author": "",
-    "license": "ISC",
-    "type": "commonjs",
-    "bugs": {
-        "url": "https://github.com/adityathute/shivanya-sdk/issues"
-    },
-    "homepage": "https://github.com/adityathute/shivanya-sdk#readme",
-    "devDependencies": {
-        "typescript": "^7.0.2"
-    }
+  "name": "shivanya-sdk",
+  "version": "0.1.0",
+  "description": "Shivanya SDK monorepo",
+  "scripts": {
+    "build": "pnpm -r build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adityathute/shivanya-sdk.git"
+  },
+  "keywords": [
+    "shivanya",
+    "shivanya-sdk",
+    "sdk",
+    "typescript",
+    "react",
+    "react-components",
+    "frontend",
+    "ui",
+    "shell",
+    "authentication",
+    "analytics",
+    "developer-tools",
+    "open-source"
+  ],
+  "author": "Aditya Thute",
+  "license": "ISC",
+  "packageManager": "pnpm@11.9.0"
 }

package/packages/ai/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "shivanya-ai",
+  "version": "0.1.1",
+  "description": "AI client for the Shivanya platform",
+  "main": "dist/index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "shivanya-core": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  },
+  "repository": {
+    "type": "module",
+    "url": "git+https://github.com/adityathute/shivanya-sdk.git"
+  },
+  "keywords": [
+    "shivanya",
+    "ai",
+    "sdk",
+    "typescript",
+    "api",
+    "chat"
+  ],
+  "author": "Aditya Thute",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/packages/ai/src/ai.ts

@@ -0,0 +1,33 @@
+import type { ShivanyaClient } from "shivanya-core";
+
+import type {
+  AIChatRequest,
+  AIChatResponse,
+} from "./types.js";
+
+export class ShivanyaAI {
+  constructor(
+    private readonly client: ShivanyaClient
+  ) {}
+
+  async chat(
+    request: AIChatRequest
+  ): Promise<AIChatResponse> {
+    return this.client.request<AIChatResponse>(
+      "/api/ai/chat",
+      {
+        method: "POST",
+        body: JSON.stringify({
+          messages: [
+            {
+              role: "user",
+              content: request.message,
+            },
+          ],
+          model: request.model,
+          temperature: request.temperature,
+        }),
+      }
+    );
+  }
+}

package/packages/ai/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./ai.js";
+export * from "./types.js";

package/packages/ai/src/types.ts

@@ -0,0 +1,10 @@
+export interface AIChatRequest {
+  message: string;
+  model?: string;
+  temperature?: number;
+}
+
+export interface AIChatResponse {
+  content: string;
+  model: string;
+}

package/packages/ai/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}

package/packages/core/package.json

@@ -0,0 +1,34 @@
+{
+    "name": "shivanya-core",
+    "version": "1.0.0",
+    "description": "Core client for the Shivanya platform",
+    "main": "dist/index.js",
+    "type": "module",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc"
+    },
+    "devDependencies": {
+        "typescript": "^7.0.2"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/adityathute/shivanya-sdk.git"
+    },
+    "keywords": [
+        "shivanya",
+        "core",
+        "sdk",
+        "typescript",
+        "api",
+        "client"
+    ],
+    "author": "Aditya Thute",
+    "license": "ISC",
+    "publishConfig": {
+        "access": "public"
+    }
+}

package/packages/core/src/client.ts

@@ -0,0 +1,48 @@
+import { ShivanyaError } from "./errors.js";
+
+export interface ShivanyaClientOptions {
+  baseURL: string;
+  apiKey?: string;
+}
+
+export class ShivanyaClient {
+  private readonly baseURL: string;
+  private readonly apiKey?: string;
+
+  constructor(options: ShivanyaClientOptions) {
+    this.baseURL = options.baseURL.replace(/\/+$/, "");
+    this.apiKey = options.apiKey;
+  }
+
+  async request<T>(
+    path: string,
+    options: RequestInit = {}
+  ): Promise<T> {
+    const headers = new Headers(options.headers);
+
+    headers.set("Content-Type", "application/json");
+
+    if (this.apiKey) {
+      headers.set("Authorization", `Bearer ${this.apiKey}`);
+    }
+
+    const response = await fetch(
+      `${this.baseURL}${path}`,
+      {
+        ...options,
+        headers
+      }
+    );
+
+    const data = await response.json().catch(() => null);
+
+    if (!response.ok) {
+      throw new ShivanyaError(
+        data?.error ?? "Shivanya API request failed",
+        response.status
+      );
+    }
+
+    return data as T;
+  }
+}

package/packages/core/src/errors.ts

@@ -0,0 +1,9 @@
+export class ShivanyaError extends Error {
+  constructor(
+    message: string,
+    public readonly status?: number
+  ) {
+    super(message);
+    this.name = "ShivanyaError";
+  }
+}

package/packages/core/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./client.js";
+export * from "./errors.js";

package/packages/core/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "src"
+  ]
+}

package/packages/shell/README.md

@@ -0,0 +1,97 @@
+# shivanya-shell
+
+Reusable application shell and layout components for Shivanya applications.
+
+The package provides common layout infrastructure that can be shared across different Shivanya applications without coupling the shell to a specific application.
+
+## Installation
+
+```bash
+npm install shivanya-shell
+```
+
+## Usage
+
+```tsx
+import {
+  AppShell,
+  PageContainer,
+} from "shivanya-shell";
+
+export function App() {
+  return (
+    <AppShell>
+      <PageContainer>
+        Your application content
+      </PageContainer>
+    </AppShell>
+  );
+}
+```
+
+## Available Components
+
+Current components:
+
+- `AppShell`
+- `PageContainer`
+- `LayoutProvider`
+- `LayoutContext`
+- `useLayout`
+
+Additional reusable shell components will be added as the SDK develops.
+
+## Development
+
+This package is developed inside the Shivanya SDK pnpm workspace.
+
+From the SDK root:
+
+```bash
+pnpm install
+```
+
+Build the package:
+
+```bash
+pnpm --filter shivanya-shell build
+```
+
+Test changes using the SDK playground:
+
+```bash
+pnpm --filter playground dev
+```
+
+## Dependencies
+
+`shivanya-shell` uses:
+
+```text
+shivanya-ui
+```
+
+as a package dependency.
+
+React and React DOM are peer dependencies.
+
+## Package Structure
+
+```text
+packages/shell/
+├── src/
+│   ├── context/
+│   ├── hooks/
+│   ├── layouts/
+│   └── index.ts
+├── package.json
+└── tsconfig.json
+```
+
+## Contributing
+
+Make changes in the package source, test them through the playground, build the package, and submit a pull request.
+
+## License
+
+ISC

package/packages/shell/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "shivanya-shell",
+  "version": "1.0.1",
+  "type": "module",
+  "description": "Reusable React shell, layout, and application structure components for Shivanya applications",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles": "./src/styles/shell.css"
+  },
+  "files": [
+    "dist",
+    "src/styles"
+  ],
+  "scripts": {
+    "build": "tsc && shx mkdir -p dist/styles && shx cp src/styles/shell.css dist/styles/shell.css"
+  },
+  "dependencies": {
+    "shivanya-ui": "^1.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "shx": "^0.4.0",
+    "typescript": "^7.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adityathute/shivanya-sdk.git"
+  },
+  "keywords": [
+    "shivanya",
+    "shivanya-shell",
+    "shell",
+    "layout",
+    "react",
+    "react-components",
+    "typescript",
+    "frontend",
+    "application-shell",
+    "open-source"
+  ],
+  "author": "Aditya Thute",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/packages/shell/src/components/DrawerHeader.tsx

@@ -0,0 +1,19 @@
+import type { ShellBranding } from "../types/shell.js";
+import { ShellBrand } from "./ShellBrand.js";
+
+export function DrawerHeader({
+  branding,
+  onClose,
+}: {
+  branding?: ShellBranding;
+  onClose?: () => void;
+}) {
+  return (
+    <header className="shivanya-shell-drawer-header">
+      {branding && <ShellBrand branding={{ ...branding, href: undefined }} />}
+      <button type="button" onClick={onClose} aria-label="Close menu">
+        ×
+      </button>
+    </header>
+  );
+}

package/packages/shell/src/components/ShellBrand.tsx

@@ -0,0 +1,32 @@
+import type { ShellBranding } from "../types/shell.js";
+
+export function ShellBrand({
+  branding,
+  compact = false,
+}: {
+  branding: ShellBranding;
+  compact?: boolean;
+}) {
+  const content = (
+    <span className="shivanya-shell-brand-content">
+      {branding.src ? (
+        <img
+          src={branding.src}
+          alt={branding.alt || ""}
+          className="shivanya-shell-brand-image"
+        />
+      ) : null}
+      <span className="shivanya-shell-brand-text">
+        {branding.name && <strong>{branding.name}</strong>}
+        {!compact && branding.subtitle && <small>{branding.subtitle}</small>}
+      </span>
+    </span>
+  );
+  if (branding.href)
+    return (
+      <a className="shivanya-shell-brand" href={branding.href}>
+        {content}
+      </a>
+    );
+  return <span className="shivanya-shell-brand">{content}</span>;
+}

package/packages/shell/src/components/ShellFooter.tsx

@@ -0,0 +1,18 @@
+import type { ShellFooterProps } from "../types/shell.js";
+import { ShellBrand } from "./ShellBrand.js";
+
+export function ShellFooter({
+  children,
+  branding,
+  className = "",
+}: ShellFooterProps) {
+  return (
+    <footer className={`shivanya-shell-footer ${className}`.trim()}>
+      {branding && <ShellBrand branding={branding} />}
+      {children}
+      <span className="shivanya-shell-footer-copy">
+        © {new Date().getFullYear()}
+      </span>
+    </footer>
+  );
+}