@orello/auth 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Workstudio
+
+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,69 @@
+# @orello/auth
+
+A lightweight, type-safe authentication provider for Orello applications. Built to simplify OAuth integration with Orello accounts.
+
+## Features
+
+- **Simple Redirect**: Easy-to-use method to initiate the Orello OAuth flow.
+- **Token Exchange**: Standardized handling of authorization codes for access tokens.
+- **User Info Retrieval**: Fetch authenticated user profiles with a single call.
+- **TypeScript First**: Full type safety for authentication configurations and responses.
+
+## Installation
+
+```bash
+pnpm add @orello/auth
+# or
+npm install @orello/auth
+```
+
+## Quick Start
+
+### Basic Configuration
+
+```typescript
+import { OrelloAuthProvider } from "@orello/auth";
+
+const auth = new OrelloAuthProvider({
+  clientKey: process.env.ORELLO_CLIENT_KEY,
+  clientSecret: process.env.ORELLO_CLIENT_SECRET, // Required for handleCallback
+  redirectUri: "https://your-app.com/callback",
+  scope: "openid profile email" // Optional
+});
+```
+
+### Authentication Flow
+
+#### 1. Redirect to Orello
+
+```typescript
+// This will redirect the user to Orello's login page
+await auth.continueWithOrello();
+```
+
+#### 2. Handle Callback
+
+```typescript
+// On your redirect page, get the 'code' from URL params
+const code = new URLSearchParams(window.location.search).get("code");
+
+if (code) {
+  const tokens = await auth.handleCallback(code);
+  console.log("Access Token:", tokens.access_token);
+}
+```
+
+#### 3. Get User Information
+
+```typescript
+const user = await auth.getUser(tokens.access_token);
+console.log("Logged in user:", user.name);
+```
+
+## Contributing
+
+Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for details on how to get involved.
+
+## License
+
+MIT © [HB Group](https://github.com/hb-group)

package/dist/core/interfaces/config.d.ts

@@ -0,0 +1,8 @@
+interface OrelloAuthConfig {
+    clientKey: string;
+    clientSecret: string;
+    redirectUri: string;
+    scope?: string;
+    state?: string;
+}
+export { OrelloAuthConfig };

package/dist/core/interfaces/config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/interfaces/struct.d.ts

@@ -0,0 +1,11 @@
+interface Agent {
+    instructions: string[];
+    context: string[];
+    responseSchema: any;
+    tools?: {
+        name: string;
+        description: string;
+        parameters: any;
+    }[];
+}
+export { Agent };

package/dist/core/interfaces/struct.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import OrelloAuthProvider from "./providers/auth.provider";
+export * from "./core/interfaces/config";
+export { OrelloAuthProvider };

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrelloAuthProvider = void 0;
+const auth_provider_1 = __importDefault(require("./providers/auth.provider"));
+exports.OrelloAuthProvider = auth_provider_1.default;
+__exportStar(require("./core/interfaces/config"), exports);

package/dist/providers/auth.provider.d.ts

@@ -0,0 +1,14 @@
+import { OrelloAuthConfig } from "../core/interfaces/config";
+declare class OrelloAuthProvider {
+    baseUrl: string;
+    private clientKey;
+    private clientSecret;
+    private redirectUri;
+    private scope;
+    private state;
+    constructor(options: OrelloAuthConfig);
+    continueWithOrello(): Promise<string>;
+    handleCallback(code: string): Promise<any>;
+    getUser(accessToken: string): Promise<any>;
+}
+export default OrelloAuthProvider;

package/dist/providers/auth.provider.js

@@ -0,0 +1,72 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+class OrelloAuthProvider {
+    constructor(options) {
+        this.baseUrl = "https://accounts.orello.space/o/oauth/auth";
+        if (!options.clientKey)
+            throw new Error("Client Key was not provided.");
+        if (!options.redirectUri)
+            throw new Error("Redirect URI was not provided.");
+        this.clientKey = options.clientKey;
+        this.clientSecret = options.clientSecret || "";
+        this.redirectUri = options.redirectUri;
+        this.scope = options.scope || "openid profile email";
+        this.state = options.state || Math.random().toString(36).substring(7);
+    }
+    continueWithOrello() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const url = `${this.baseUrl}?client_id=${this.clientKey}&redirect_uri=${encodeURIComponent(this.redirectUri)}&response_type=code&scope=${encodeURIComponent(this.scope)}&state=${this.state}`;
+            if (typeof window !== "undefined") {
+                window.location.href = url;
+            }
+            return url;
+        });
+    }
+    handleCallback(code) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.clientSecret) {
+                throw new Error("Client Secret is required for token exchange.");
+            }
+            const response = yield fetch("https://accounts.orello.space/o/oauth/token", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/x-www-form-urlencoded",
+                },
+                body: new URLSearchParams({
+                    grant_type: "authorization_code",
+                    code,
+                    client_id: this.clientKey,
+                    client_secret: this.clientSecret,
+                    redirect_uri: this.redirectUri,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error("Failed to exchange token");
+            }
+            return yield response.json();
+        });
+    }
+    getUser(accessToken) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield fetch("https://accounts.orello.space/o/oauth/userinfo", {
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                },
+            });
+            if (!response.ok) {
+                throw new Error("Failed to fetch user info");
+            }
+            return yield response.json();
+        });
+    }
+}
+exports.default = OrelloAuthProvider;

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@orello/auth",
+  "version": "1.0.0",
+  "private": false,
+  "description": "Authentication package for Orello.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "nodemon --watch 'src/**/*.ts' --exec 'ts-node' src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "auth",
+    "oauth",
+    "orello",
+    "authentication"
+  ],
+  "author": "Workstudio",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hb-group/orello.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hb-group/orello/issues"
+  },
+  "homepage": "https://github.com/hb-group/orello#readme",
+  "dependencies": {
+    "dotenv": "^16.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "nodemon": "^3.1.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2"
+  }
+}