@veloxts/auth 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 VeloxTS Framework Contributors
+
+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,59 @@
+# @veloxts/auth
+
+Authentication and authorization system for VeloxTS Framework.
+
+> **Note:** This package is a placeholder in v0.1.0. Full implementation coming in v1.1.
+
+## Status
+
+This package is reserved for future functionality. The current release includes only type definitions and stub implementations to allow other packages to reference it.
+
+## Planned Features (v1.1+)
+
+- **Session Management** - Secure session handling with configurable stores
+- **JWT Authentication** - Token-based authentication with refresh tokens
+- **Guards and Policies** - Declarative authorization for procedures
+- **Role-Based Access Control** - Define roles and permissions
+- **User Model Integration** - Seamless integration with Prisma user models
+- **OAuth Providers** - Social login support (Google, GitHub, etc.)
+
+## Current Exports
+
+The following are available but not fully implemented:
+
+```typescript
+import { createAuth, guard, User } from '@veloxts/auth';
+
+// User interface for type definitions
+interface User {
+  id: string;
+  email: string;
+  [key: string]: unknown;
+}
+
+// Placeholder - returns stub implementation
+const auth = createAuth({ secret: 'your-secret' });
+
+// Placeholder decorator
+@guard(['admin'])
+class AdminProcedures { }
+```
+
+## Roadmap
+
+| Version | Features |
+|---------|----------|
+| v0.1.0 | Placeholder with type definitions |
+| v1.1.0 | JWT authentication, session management |
+| v1.2.0 | Guards, policies, RBAC |
+| v1.3.0 | OAuth providers |
+
+## Related Packages
+
+- [@veloxts/core](../core) - Application framework
+- [@veloxts/router](../router) - Procedure definitions and routing
+- [@veloxts/orm](../orm) - Database integration
+
+## License
+
+[MIT](../../LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @veloxts/auth - Authentication and authorization system
+ *
+ * Provides authentication middleware, session management, and authorization
+ * guards for VeloxTS applications. Deferred to v1.1+ release.
+ *
+ * @note This package is a placeholder for MVP (v0.1.0)
+ */
+export declare const AUTH_VERSION = "0.1.0";
+/**
+ * User interface for authenticated requests
+ */
+export interface User {
+    id: string;
+    email: string;
+    [key: string]: unknown;
+}
+/**
+ * Creates an authentication plugin for VeloxTS
+ *
+ * @param config - Authentication configuration
+ * @returns Auth plugin
+ *
+ * @note Full implementation coming in v1.1+
+ */
+export declare function createAuth(_config?: {
+    secret?: string;
+    sessionStore?: unknown;
+}): {
+    version: string;
+    middleware: () => void;
+};
+/**
+ * Authorization guard decorator (placeholder)
+ *
+ * @note Full implementation coming in v1.1+
+ */
+export declare function guard(permissions: string[]): (target: unknown) => unknown;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO;;;EAOnF;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,IACjC,QAAQ,OAAO,aAIxB"}

package/dist/index.js

@@ -0,0 +1,37 @@
+/**
+ * @veloxts/auth - Authentication and authorization system
+ *
+ * Provides authentication middleware, session management, and authorization
+ * guards for VeloxTS applications. Deferred to v1.1+ release.
+ *
+ * @note This package is a placeholder for MVP (v0.1.0)
+ */
+export const AUTH_VERSION = '0.1.0';
+/**
+ * Creates an authentication plugin for VeloxTS
+ *
+ * @param config - Authentication configuration
+ * @returns Auth plugin
+ *
+ * @note Full implementation coming in v1.1+
+ */
+export function createAuth(_config = {}) {
+    return {
+        version: AUTH_VERSION,
+        middleware: () => {
+            console.log('Auth middleware placeholder (v1.1+)');
+        },
+    };
+}
+/**
+ * Authorization guard decorator (placeholder)
+ *
+ * @note Full implementation coming in v1.1+
+ */
+export function guard(permissions) {
+    return (target) => {
+        console.log(`Guard decorator placeholder: ${permissions.join(', ')}`);
+        return target;
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAWpC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,UAAuD,EAAE;IAClF,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,UAAU,EAAE,GAAG,EAAE;YACf,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,WAAqB;IACzC,OAAO,CAAC,MAAe,EAAE,EAAE;QACzB,OAAO,CAAC,GAAG,CAAC,gCAAgC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@veloxts/auth",
+  "version": "0.1.0",
+  "description": "Authentication and authorization system for VeloxTS framework (v1.1+)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@veloxts/core": "0.1.0",
+    "@veloxts/router": "0.1.0",
+    "@veloxts/orm": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3"
+  },
+  "keywords": [
+    "velox",
+    "auth",
+    "authentication",
+    "authorization",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/veloxts/velox-ts-framework",
+    "directory": "packages/auth"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  }
+}