arcanajs 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mohammed Ben Cheikh
+
+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,284 @@
+# Arcana.js
+
+<p align="center">
+  <img src="https://digiclips.ma/ArcanaJS.png" alt="Arcana.js Logo" width="200" height="200">
+</p>
+
+<p align="center">
+  A powerful full-stack framework combining Express, React, and MongoDB with server-side rendering
+</p>
+
+<p align="center">
+  <a href="#features">Features</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#architecture">Architecture</a> •
+  <a href="#routing">Routing</a> •
+  <a href="#documentation">Documentation</a> •
+  <a href="#examples">Examples</a> •
+  <a href="#contributing">Contributing</a> •
+  <a href="#license">License</a>
+</p>
+
+## Overview
+
+Arcana.js is a comprehensive full-stack JavaScript framework built on top of Express.js and React, designed to create scalable, maintainable web applications with server-side rendering capabilities. By leveraging MongoDB and Mongoose, it provides a complete solution for modern web development following best practices in software architecture.
+
+## Features
+
+- **Express.js Backend**: Fast, unopinionated, minimalist web framework as the foundation
+- **React Frontend**: Component-based UI with server-side rendering out of the box
+- **MongoDB & Mongoose**: Powerful data modeling and integration with MongoDB
+- **MVC Architecture**: Clean separation of concerns with Model-View-Controller pattern
+- **OOP Principles**: Object-oriented design throughout the codebase
+- **Repository Pattern**: Abstraction layer between data access and business logic
+- **Server-Side Rendering**: Improved performance and SEO capabilities
+- **Scalable Architecture**: Designed to grow with your application needs
+- **TypeScript Support**: Optional static typing for better developer experience
+- **Built-in Middleware**: Common functionality pre-configured
+- **Elegant Routing System**: Declarative and flexible route definition
+
+## Installation
+
+```bash
+# Install Arcana.js CLI globally
+npm install -g arcana-cli
+
+# Create a new Arcana.js project
+arcana create my-awesome-app
+
+# Navigate to project directory
+cd my-awesome-app
+
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+```
+
+## Quick Start
+
+After installation, your application will be running at `http://localhost:3000`.
+
+```javascript
+// Example controller: src/controllers/UserController.js
+import { Controller } from 'arcana/core';
+import { UserRepository } from '../repositories/UserRepository';
+
+export class UserController extends Controller {
+  constructor() {
+    super();
+    this.userRepository = new UserRepository();
+  }
+
+  async index(req, res) {
+    const users = await this.userRepository.findAll();
+    return this.render('users/index', { users });
+  }
+
+  async show(req, res) {
+    const user = await this.userRepository.findById(req.params.id);
+    return this.render('users/show', { user });
+  }
+}
+```
+
+## Architecture
+
+Arcana.js follows the MVC (Model-View-Controller) architecture with a strong emphasis on the repository pattern:
+
+```
+my-awesome-app/
+├── config/               # Application configuration
+├── public/               # Static assets
+├── src/
+│   ├── controllers/      # Route controllers
+│   ├── models/           # Mongoose models
+│   ├── repositories/     # Data access layer
+│   ├── services/         # Business logic
+│   ├── views/            # React components for SSR
+│   │   ├── layouts/      # Layout components
+│   │   └── pages/        # Page components
+│   └── routes/           # Route definitions
+├── tests/                # Test files
+├── .env                  # Environment variables
+├── .gitignore
+├── package.json
+└── arcana.config.js      # Arcana.js configuration
+```
+
+## Routing
+
+Arcana.js provides a powerful and flexible routing system that integrates seamlessly with controllers. Routes are defined in dedicated router files and automatically linked to controller methods.
+
+### Basic Router Configuration
+
+```javascript
+// src/routes/userRoutes.js
+import { Router } from 'arcana/core';
+import { UserController } from '../controllers/UserController';
+
+const userController = new UserController();
+const router = new Router();
+
+// Define routes and link to controller methods
+router.get('/users', userController.index);
+router.get('/users/:id', userController.show);
+router.post('/users', userController.create);
+router.put('/users/:id', userController.update);
+router.delete('/users/:id', userController.delete);
+
+export default router;
+```
+
+### Route Groups and Middleware
+
+```javascript
+// src/routes/apiRoutes.js
+import { Router } from 'arcana/core';
+import { authMiddleware } from '../middleware/auth';
+
+const router = new Router();
+
+// Apply middleware to a group of routes
+router.group('/api', [authMiddleware], (r) => {
+  // These routes will all be prefixed with '/api' and use authMiddleware
+  r.use('/users', require('./userRoutes'));
+  r.use('/posts', require('./postRoutes'));
+});
+
+export default router;
+```
+
+### Registering Routes
+
+```javascript
+// src/app.js
+import { Application } from 'arcana/core';
+import userRoutes from './routes/userRoutes';
+import apiRoutes from './routes/apiRoutes';
+
+const app = new Application();
+
+// Register routes
+app.useRoutes([
+  userRoutes,
+  apiRoutes
+]);
+
+app.listen(3000);
+```
+
+### Route Parameters and Validation
+
+```javascript
+// Advanced routing with parameter validation
+router.get('/products/:category/:id', productController.show)
+  .where('category', /^[a-z-]+$/)
+  .where('id', /^\d+$/);
+```
+
+### Named Routes
+
+```javascript
+// Define a named route for easy URL generation
+router.get('/dashboard', dashboardController.index, 'dashboard.index');
+
+// Generate URL in your code or templates
+const dashboardUrl = router.namedRoute('dashboard.index');
+```
+
+## Documentation
+
+For detailed documentation, visit [docs.arcanajs.com](https://docs.arcanajs.com)
+
+### Core Concepts
+
+- **Models**: Define your data structure using Mongoose schemas
+- **Views**: Create React components for rendering
+- **Controllers**: Handle HTTP requests and control flow
+- **Repositories**: Abstract data access operations
+- **Services**: Implement business logic
+- **Middlewares**: Process requests before they reach controllers
+- **Routers**: Define application routes and connect them to controllers
+
+## Examples
+
+### Creating a Model
+
+```javascript
+// src/models/User.js
+import { Model, Schema } from 'arcana/db';
+
+const userSchema = new Schema({
+  username: { type: String, required: true, unique: true },
+  email: { type: String, required: true, unique: true },
+  password: { type: String, required: true },
+  createdAt: { type: Date, default: Date.now },
+  updatedAt: { type: Date, default: Date.now }
+});
+
+export const User = Model('User', userSchema);
+```
+
+### Creating a Repository
+
+```javascript
+// src/repositories/UserRepository.js
+import { Repository } from 'arcana/core';
+import { User } from '../models/User';
+
+export class UserRepository extends Repository {
+  constructor() {
+    super(User);
+  }
+  
+  async findByUsername(username) {
+    return this.model.findOne({ username });
+  }
+}
+```
+
+### Creating a View Component
+
+```jsx
+// src/views/pages/users/Index.jsx
+import React from 'react';
+import { Page } from 'arcana/view';
+
+export default function UsersIndex({ users }) {
+  return (
+    <Page title="All Users">
+      <h1>Users</h1>
+      <ul>
+        {users.map(user => (
+          <li key={user._id}>
+            <a href={`/users/${user._id}`}>{user.username}</a>
+          </li>
+        ))}
+      </ul>
+    </Page>
+  );
+}
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+---
+
+<p align="center">
+  Made with ❤️ by the Arcana.js Team
+</p>

package/bin/arcana.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+// Minimal CLI stub for arcana
+const [, , ...args] = process.argv;
+
+if (!args.length || args.includes("--help") || args.includes("-h")) {
+  console.log(
+    "Arcana CLI\n\nUsage: arcana <command> [options]\n\nCommands:\n  create <app-name>   Create a new Arcana app (stub)\n  help                Show help"
+  );
+  process.exit(0);
+}
+
+const [cmd, name] = args;
+if (cmd === "create") {
+  console.log(`Creating new Arcana app: ${name} (stub).`);
+  console.log("This is a starter CLI. Implement scaffolding logic here.");
+} else {
+  console.log("Unknown command. Use --help for usage.");
+}

package/dist/bin/arcana.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare const args: string[];
+declare const cmd: string, name: string;
+//# sourceMappingURL=arcana.d.ts.map

package/dist/bin/arcana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcana.d.ts","sourceRoot":"","sources":["../../bin/arcana.ts"],"names":[],"mappings":";AAGA,QAAA,MAAc,IAAI,UAAgB,CAAC;AASnC,QAAA,MAAO,GAAG,UAAE,IAAI,QAAQ,CAAC"}

package/dist/bin/arcana.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+"use strict";
+// Minimal CLI stub for arcana
+const [, , ...args] = process.argv;
+if (!args.length || args.includes("--help") || args.includes("-h")) {
+    console.log("Arcana CLI\n\nUsage: arcana <command> [options]\n\nCommands:\n  create <app-name>   Create a new Arcana app (stub)\n  help                Show help");
+    process.exit(0);
+}
+const [cmd, name] = args;
+if (cmd === "create") {
+    console.log(`Creating new Arcana app: ${name} (stub).`);
+    console.log("This is a starter CLI. Implement scaffolding logic here.");
+}
+else {
+    console.log("Unknown command. Use --help for usage.");
+}
+//# sourceMappingURL=arcana.js.map

package/dist/bin/arcana.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcana.js","sourceRoot":"","sources":["../../bin/arcana.ts"],"names":[],"mappings":";;AAEA,8BAA8B;AAC9B,MAAM,CAAC,EAAE,AAAD,EAAG,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAEnC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnE,OAAO,CAAC,GAAG,CACT,qJAAqJ,CACtJ,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;AACzB,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,UAAU,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;AAC1E,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AACxD,CAAC"}

package/dist/config/default.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    app: {
+        name: string;
+    };
+};
+export default _default;
+//# sourceMappingURL=default.d.ts.map

package/dist/config/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../config/default.ts"],"names":[],"mappings":";;;;;AAAA,wBAIE"}

package/dist/config/default.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = {
+    app: {
+        name: "Arcana App",
+    },
+};
+//# sourceMappingURL=default.js.map

package/dist/config/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../config/default.ts"],"names":[],"mappings":";;AAAA,kBAAe;IACb,GAAG,EAAE;QACH,IAAI,EAAE,YAAY;KACnB;CACF,CAAC"}

package/dist/src/controllers/HomeController.d.ts

@@ -0,0 +1,6 @@
+import { Request, Response } from "express";
+declare class HomeController {
+    index(req: Request, res: Response): Promise<Response>;
+}
+export default HomeController;
+//# sourceMappingURL=HomeController.d.ts.map

package/dist/src/controllers/HomeController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HomeController.d.ts","sourceRoot":"","sources":["../../../src/controllers/HomeController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5C,cAAM,cAAc;IACZ,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;CAG5D;AAED,eAAe,cAAc,CAAC"}

package/dist/src/controllers/HomeController.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class HomeController {
+    async index(req, res) {
+        return res.send("<h1>Arcana.js</h1><p>Welcome — HomeController#index</p>");
+    }
+}
+exports.default = HomeController;
+//# sourceMappingURL=HomeController.js.map

package/dist/src/controllers/HomeController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HomeController.js","sourceRoot":"","sources":["../../../src/controllers/HomeController.ts"],"names":[],"mappings":";;AAGA,MAAM,cAAc;IAClB,KAAK,CAAC,KAAK,CAAC,GAAY,EAAE,GAAa;QACrC,OAAO,GAAG,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;CACF;AAED,kBAAe,cAAc,CAAC"}

package/dist/src/middleware/auth.d.ts

@@ -0,0 +1,3 @@
+import { NextFunction, Request, Response } from "express";
+export default function authMiddleware(req: Request, res: Response, next: NextFunction): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/middleware/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,IAAI,CAIN"}

package/dist/src/middleware/auth.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = authMiddleware;
+function authMiddleware(req, res, next) {
+    // Implement real auth logic here
+    // For now allow all
+    next();
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/middleware/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/middleware/auth.ts"],"names":[],"mappings":";;AAGA,iCAQC;AARD,SAAwB,cAAc,CACpC,GAAY,EACZ,GAAa,EACb,IAAkB;IAElB,iCAAiC;IACjC,oBAAoB;IACpB,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/src/models/User.d.ts

@@ -0,0 +1,11 @@
+import mongoose, { Document } from "mongoose";
+export interface IUser extends Document {
+    username: string;
+    email: string;
+    password: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+declare const _default: mongoose.Model<any, {}, {}, {}, any, any>;
+export default _default;
+//# sourceMappingURL=User.d.ts.map

package/dist/src/models/User.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"User.d.ts","sourceRoot":"","sources":["../../../src/models/User.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,EAAE,EAAE,QAAQ,EAAU,MAAM,UAAU,CAAC;AAEtD,MAAM,WAAW,KAAM,SAAQ,QAAQ;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;;AAWD,wBAC4C"}

package/dist/src/models/User.js

@@ -0,0 +1,45 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+// Example Mongoose model (requires mongoose installed)
+const mongoose_1 = __importStar(require("mongoose"));
+const userSchema = new mongoose_1.Schema({
+    username: { type: String, required: true, unique: true },
+    email: { type: String, required: true, unique: true },
+    password: { type: String, required: true },
+}, { timestamps: true });
+exports.default = mongoose_1.default.models.User ||
+    mongoose_1.default.model("User", userSchema);
+//# sourceMappingURL=User.js.map

package/dist/src/models/User.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"User.js","sourceRoot":"","sources":["../../../src/models/User.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAAuD;AACvD,qDAAsD;AAUtD,MAAM,UAAU,GAAG,IAAI,iBAAM,CAC3B;IACE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACrD,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;CAC3C,EACD,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;AAEF,kBAAe,kBAAQ,CAAC,MAAM,CAAC,IAAI;IACjC,kBAAQ,CAAC,KAAK,CAAQ,MAAM,EAAE,UAAU,CAAC,CAAC"}

package/dist/src/repositories/UserRepository.d.ts

@@ -0,0 +1,9 @@
+import { IUser } from "../models/User";
+declare class UserRepository {
+    private model;
+    constructor();
+    findAll(): Promise<IUser[]>;
+    findById(id: string): Promise<IUser | null>;
+}
+export default UserRepository;
+//# sourceMappingURL=UserRepository.d.ts.map

package/dist/src/repositories/UserRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserRepository.d.ts","sourceRoot":"","sources":["../../../src/repositories/UserRepository.ts"],"names":[],"mappings":"AAEA,OAAa,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE7C,cAAM,cAAc;IAClB,OAAO,CAAC,KAAK,CAAe;;IAM5B,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI3B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAG5C;AAED,eAAe,cAAc,CAAC"}

package/dist/src/repositories/UserRepository.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const User_1 = __importDefault(require("../models/User"));
+class UserRepository {
+    constructor() {
+        this.model = User_1.default;
+    }
+    findAll() {
+        return this.model.find().lean();
+    }
+    findById(id) {
+        return this.model.findById(id).lean();
+    }
+}
+exports.default = UserRepository;
+//# sourceMappingURL=UserRepository.js.map

package/dist/src/repositories/UserRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserRepository.js","sourceRoot":"","sources":["../../../src/repositories/UserRepository.ts"],"names":[],"mappings":";;;;;AAEA,0DAA6C;AAE7C,MAAM,cAAc;IAGlB;QACE,IAAI,CAAC,KAAK,GAAG,cAAI,CAAC;IACpB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAsB,CAAC;IACtD,CAAC;IAED,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAA2B,CAAC;IACjE,CAAC;CACF;AAED,kBAAe,cAAc,CAAC"}

package/dist/src/routes/index.d.ts

@@ -0,0 +1,3 @@
+import { Application } from "express";
+export default function registerRoutes(app: Application): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/routes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/routes/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAO7D"}

package/dist/src/routes/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = registerRoutes;
+const HomeController_1 = __importDefault(require("../controllers/HomeController"));
+function registerRoutes(app) {
+    // Example route wiring
+    const home = new HomeController_1.default();
+    app.get("/", home.index.bind(home));
+    // In future, require and register other routers here
+}
+//# sourceMappingURL=index.js.map

package/dist/src/routes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/routes/index.ts"],"names":[],"mappings":";;;;;AAIA,iCAOC;AATD,mFAA2D;AAE3D,SAAwB,cAAc,CAAC,GAAgB;IACrD,uBAAuB;IACvB,MAAM,IAAI,GAAG,IAAI,wBAAc,EAAE,CAAC;IAElC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpC,qDAAqD;AACvD,CAAC"}

package/dist/src/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":""}

package/dist/src/server.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Minimal Express server starter for Arcana.js
+const dotenv_1 = __importDefault(require("dotenv"));
+const express_1 = __importDefault(require("express"));
+const path_1 = __importDefault(require("path"));
+dotenv_1.default.config();
+const app = (0, express_1.default)();
+const port = parseInt(process.env.PORT || "3000", 10);
+// Serve static files
+app.use("/public", express_1.default.static(path_1.default.join(__dirname, "../public")));
+// Basic JSON middleware
+app.use(express_1.default.json());
+app.use(express_1.default.urlencoded({ extended: true }));
+// Register routes
+try {
+    const routes = require("./routes");
+    if (typeof routes === "function") {
+        routes(app);
+    }
+}
+catch (err) {
+    console.warn("No routes registered yet.");
+}
+app.get("/", (req, res) => {
+    res.send("Welcome to Arcana.js — scaffold running.");
+});
+app.listen(port, () => {
+    console.log(`Arcana.js server listening on http://localhost:${port}`);
+});
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":";;;;;AAAA,+CAA+C;AAC/C,oDAA4B;AAC5B,sDAA+C;AAC/C,gDAAwB;AAExB,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,GAAG,GAAgB,IAAA,iBAAO,GAAE,CAAC;AACnC,MAAM,IAAI,GAAW,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAE9D,qBAAqB;AACrB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAO,CAAC,MAAM,CAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;AAEtE,wBAAwB;AACxB,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACxB,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEhD,kBAAkB;AAClB,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;AACH,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;AAC5C,CAAC;AAED,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACxB,GAAG,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,kDAAkD,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC,CAAC,CAAC"}

package/dist/src/services/UserService.d.ts

@@ -0,0 +1,8 @@
+import { IUser } from "../models/User";
+declare class UserService {
+    private repo;
+    constructor();
+    listUsers(): Promise<IUser[]>;
+}
+export default UserService;
+//# sourceMappingURL=UserService.d.ts.map

package/dist/src/services/UserService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserService.d.ts","sourceRoot":"","sources":["../../../src/services/UserService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,cAAM,WAAW;IACf,OAAO,CAAC,IAAI,CAAiB;;IAMvB,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;CAGpC;AAED,eAAe,WAAW,CAAC"}

package/dist/src/services/UserService.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const UserRepository_1 = __importDefault(require("../repositories/UserRepository"));
+class UserService {
+    constructor() {
+        this.repo = new UserRepository_1.default();
+    }
+    async listUsers() {
+        return this.repo.findAll();
+    }
+}
+exports.default = UserService;
+//# sourceMappingURL=UserService.js.map

package/dist/src/services/UserService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserService.js","sourceRoot":"","sources":["../../../src/services/UserService.ts"],"names":[],"mappings":";;;;;AAEA,oFAA4D;AAE5D,MAAM,WAAW;IAGf;QACE,IAAI,CAAC,IAAI,GAAG,IAAI,wBAAc,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;CACF;AAED,kBAAe,WAAW,CAAC"}

package/dist/src/views/pages/home.d.ts

@@ -0,0 +1,2 @@
+export default function HomePage(): JSX.Element;
+//# sourceMappingURL=home.d.ts.map

package/dist/src/views/pages/home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../../../src/views/pages/home.tsx"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,QAAQ,IAAI,GAAG,CAAC,OAAO,CAO9C"}

package/dist/src/views/pages/home.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = HomePage;
+const react_1 = __importDefault(require("react"));
+function HomePage() {
+    return (react_1.default.createElement("div", null,
+        react_1.default.createElement("h1", null, "Arcana.js \u2014 Home"),
+        react_1.default.createElement("p", null, "This is a starter React page for server-side rendering.")));
+}
+//# sourceMappingURL=home.js.map

package/dist/src/views/pages/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../../../src/views/pages/home.tsx"],"names":[],"mappings":";;;;;AAEA,2BAOC;AATD,kDAA0B;AAE1B,SAAwB,QAAQ;IAC9B,OAAO,CACL;QACE,kEAAyB;QACzB,mGAA8D,CAC1D,CACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "arcanajs",
+  "author": {
+    "name": "Mohammed Ben Cheikh",
+    "email": "mohammed.bencheikh.dev@gmail.com",
+    "url": "https://mohammedbencheikh.com/"
+  },
+  "version": "0.2.2",
+  "description": "A powerful full-stack framework combining Express, React and MongoDB with server-side rendering",
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "build:watch": "tsc -p tsconfig.json --watch",
+    "prepare": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pack:verify": "npm pack --dry-run",
+    "dev": "nodemon --watch src --exec ts-node src/server.ts",
+    "start": "node dist/server.js",
+    "lint": "eslint . || true",
+    "test": "jest --runInBand"
+  },
+  "peerDependencies": {
+    "react": ">=16 <20",
+    "react-dom": ">=16 <20"
+  },
+  "dependencies": {
+    "dotenv": "^16.0.0",
+    "express": "^4.18.2",
+    "mongoose": "^7.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "url-join": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/dotenv": "^6.1.1",
+    "@types/express": "^5.0.5",
+    "@types/mongoose": "^5.11.96",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@types/url-join": "^4.0.3",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "nodemon": "^3.0.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.2.0"
+  },
+  "keywords": [
+    "framework",
+    "full-stack",
+    "express",
+    "react",
+    "mongodb",
+    "ssr",
+    "mvc",
+    "arcana",
+    "routing",
+    "server-side-rendering"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Mohammed-Ben-Cheikh/arcanajs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Mohammed-Ben-Cheikh/arcanajs/issues"
+  },
+  "homepage": "https://github.com/Mohammed-Ben-Cheikh/arcanajs#readme",
+  "bin": {
+    "arcana": "dist/bin/arcana.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "license": "MIT"
+}