@solidxai/solidctl 0.0.1

package/templates/nest-template/src/main-cli.ts

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+import { Logger } from "@nestjs/common";
+import { existsSync } from "fs";
+import { CommandFactory } from "nest-commander";
+import { resolve } from "path";
+import { AppModule } from "./app.module";
+import { configurePgInt8TypeParser } from "./database.utils";
+
+const logger = new Logger("Bootstrap");
+
+// Suppress punycode deprecation warning from dependencies
+process.removeAllListeners('warning');
+process.on('warning', (warning) => {
+  if (warning.name === 'DeprecationWarning' && warning.message.includes('punycode')) {
+    return; // Ignore known punycode deprecation from dependencies
+  }
+  console.warn(warning); // Still show other warnings
+});
+
+// ---- Global safety nets (must be first) ----
+process.on('unhandledRejection', (reason, promise) => {
+  console.error('Unhandled Rejection at:', promise, 'reason:', reason);
+});
+process.on('uncaughtException', (err) => {
+  console.error('Uncaught Exception:', err);
+});
+
+async function bootstrap() {
+  // setup log levels...
+  const showLogs = process.argv.includes('--verbose') || process.argv.includes('-v');
+  // strip before nest-commander runs...
+  stripArg('--verbose');
+  stripArg('-v');
+
+  // validate project existence
+  validateProjectRootPath();
+
+  // Define log levels based on the flag
+  const logLevels = showLogs ? ['debug', 'error', 'fatal', 'log', 'verbose', 'warn'] : ['error', 'fatal'];
+
+  const appModule = await AppModule.forRoot();
+  // const app = await NestFactory.create(appModule);
+
+  // Create an instance of the application, capture the application context so we can inject it into a service in itself.
+  // @ts-ignore
+  const app = await CommandFactory.createWithoutRunning(appModule, logLevels);
+  // const app = await CommandFactory.createWithoutRunning(AppModule, ['debug', 'error', 'fatal', 'log', 'verbose', 'warn']);
+  // const app = await CommandFactory.createWithoutRunning(AppModule, ['error', 'fatal']);
+
+  // Configure pg type parser before running the app
+  configurePgInt8TypeParser();
+
+  // Now run the command factory.
+  try {
+    await CommandFactory.runApplication(app);
+  }
+  catch (e) {
+    process.exit(1);
+  }
+
+  // Exit explicitly, make sure that any commands you have created and are using Promises, you do not keep them orphan/dangling.
+  process.exit(0);
+}
+
+bootstrap();
+
+// Check if the current directory is a valid Solid API project
+function validateProjectRootPath() {
+  const packageJsonPath = resolve(process.cwd(), "package.json");
+  if (!existsSync(packageJsonPath)) {
+    logger.log("Does not seem to be a valid solid-api project.");
+    process.exit(1);
+  }
+}
+
+// Utility function to strip a specific argument from process.argv
+function stripArg(flag: string) {
+  const idx = process.argv.indexOf(flag);
+  if (idx !== -1) process.argv.splice(idx, 1);
+}

package/templates/nest-template/src/main.ts

@@ -0,0 +1,116 @@
+// import { NestFactory } from '@nestjs/core';
+// import { AppModule } from './app.module';
+
+// async function bootstrap() {
+//   const app = await NestFactory.create(AppModule);
+//   await app.listen(3000);
+// }
+// bootstrap();
+import { ValidationPipe } from '@nestjs/common';
+import { NestFactory } from '@nestjs/core';
+import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
+import { buildDefaultCorsOptions, buildDefaultSecurityHeaderOptions, buildPermissionsPolicyHeader, WrapResponseInterceptor } from '@solidxai/core';
+import { NextFunction, Request, Response } from 'express';
+import helmet from 'helmet';
+import { WINSTON_MODULE_NEST_PROVIDER } from 'nest-winston';
+import { AppModule } from './app.module';
+import { configurePgInt8TypeParser } from './database.utils';
+
+import qs from 'qs';
+
+// ---- Global safety nets (must be first) ----
+process.on('unhandledRejection', (reason, promise) => {
+  console.error('Unhandled Rejection at:', promise, 'reason:', reason);
+});
+process.on('uncaughtException', (err) => {
+  console.error('Uncaught Exception:', err);
+});
+
+async function bootstrap() {
+  const appModule = await AppModule.forRoot();
+  const app = await NestFactory.create(appModule);
+
+  // Enable Helmet middleware for security
+  app.use(helmet(buildDefaultSecurityHeaderOptions()));
+
+  // Enable Permission policy header
+  app.use((req: Request, _res: Response, next: NextFunction) => {
+    _res.setHeader('Permissions-Policy', buildPermissionsPolicyHeader({
+      // Example overrides:
+      // "autoplay": ['self', 'https://player.example.com'],
+      // "camera": 'none',
+    }));
+    next();
+  });
+
+  // setup winston as the default logger.
+  // const app = await NestFactory.create(AppModule);
+  app.useLogger(app.get(WINSTON_MODULE_NEST_PROVIDER));
+
+  // Making the port dynamic
+  const port = process.env.PORT || 3000;
+
+  app.setGlobalPrefix('api');
+  // Middleware to parse deeply nested queries
+  app.use((req: Request, _res: Response, next: NextFunction) => {
+    if (req.query) {
+      req.query = qs.parse(req.url.split('?')[1], {
+        allowDots: true,  // Allows dot notation ($eq, $or, etc.)
+        depth: 10,        // Supports deeply nested structures
+        arrayLimit: 100,  // Prevents indexed arrays from becoming objects
+      });
+    }
+    next();
+  });
+
+  // Apply the ValidationPipe globally in our main.ts file
+  app.useGlobalPipes(new ValidationPipe({
+    // This attribute makes that the system throws an error if a property non existent on our DTO is sent in the payload.
+    // forbidNonWhitelisted: true,
+
+    // This removes the un-necessary fields in the payload. 
+    // whitelist: true,
+
+    // Converts the payload to an actual instance of the DTO type.
+    transform: true,
+
+    transformOptions: {
+      enableImplicitConversion: true,
+    }
+  }));
+
+  // Setting up Swagger document 
+  const options = new DocumentBuilder()
+    .setTitle('Solid Starters')
+    .setDescription('Solid starters starter')
+    .setVersion('1.0')
+    .setExternalDoc('Postman Collection', '/docs-json')
+    .addBearerAuth(
+      {
+        // I was also testing it without prefix 'Bearer ' before the JWT
+        description: `Please enter token in following format: Bearer <JWT>`,
+        name: 'Authorization',
+        bearerFormat: 'Bearer', // I`ve tested not to use this field, but the result was the same
+        scheme: 'Bearer',
+        type: 'http', // I`ve attempted type: 'apiKey' too
+        in: 'Header'
+      },
+      'jwt'
+    )
+    .build();
+
+  const document = SwaggerModule.createDocument(app, options);
+  SwaggerModule.setup('/docs', app, document);
+
+  // Apply interceptor...
+  app.useGlobalInterceptors(
+    new WrapResponseInterceptor(),
+  );
+
+  app.enableCors(buildDefaultCorsOptions());
+
+  configurePgInt8TypeParser();
+
+  await app.listen(port);
+}
+bootstrap();

package/templates/nest-template/test/app.e2e-spec.ts

@@ -0,0 +1,24 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { INestApplication } from '@nestjs/common';
+import * as request from 'supertest';
+import { AppModule } from './../src/app.module';
+
+describe('AppController (e2e)', () => {
+  let app: INestApplication;
+
+  beforeEach(async () => {
+    const moduleFixture: TestingModule = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+
+    app = moduleFixture.createNestApplication();
+    await app.init();
+  });
+
+  it('/ (GET)', () => {
+    return request(app.getHttpServer())
+      .get('/')
+      .expect(200)
+      .expect('Hello World!');
+  });
+});

package/templates/nest-template/test/jest-e2e.json

@@ -0,0 +1,9 @@
+{
+  "moduleFileExtensions": ["js", "json", "ts"],
+  "rootDir": ".",
+  "testEnvironment": "node",
+  "testRegex": ".e2e-spec.ts$",
+  "transform": {
+    "^.+\\.(t|j)s$": "ts-jest"
+  }
+}

package/templates/nest-template/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}

package/templates/nest-template/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": false,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "forceConsistentCasingInFileNames": false,
+    "noFallthroughCasesInSwitch": false,
+    "esModuleInterop": true,
+  }
+}

package/templates/next-template/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

package/templates/next-template/app/GlobalProvider.tsx

@@ -0,0 +1,23 @@
+"use client";
+
+import { SessionProvider } from "next-auth/react";
+import { Toaster } from "react-hot-toast";
+import { Provider } from "react-redux";
+import { initializeStore } from "@/redux/store";
+
+// Load all overrides.
+// TODO: Putting this here as this seems to the most top level component used with "use client"
+import "./solid-extensions";
+
+export function GlobalProvider({ children, entities }: { children: React.ReactNode, entities: string[] }) {
+  const store = initializeStore(entities);
+
+  return (
+    <>
+      <Toaster />
+      <Provider store={store}>
+        <SessionProvider>{children}</SessionProvider>
+      </Provider>
+    </>
+  );
+}

package/templates/next-template/app/admin/core/[moduleName]/[modelName]/form/[id]/page.tsx

@@ -0,0 +1,19 @@
+"use client"
+import { SolidFormLayouts } from "@solidxai/core-ui";
+
+type SolidViewParams = {
+  params: {
+    moduleName: string;
+    modelName: string;
+    id: string;
+  };
+};
+
+const page = ({ params }: SolidViewParams) => {
+
+  return (
+    <SolidFormLayouts params={params} />
+  );
+};
+
+export default page;

package/templates/next-template/app/admin/core/[moduleName]/[modelName]/kanban/page.tsx

@@ -0,0 +1,18 @@
+"use client"
+import { SolidKanbanView } from "@solidxai/core-ui";
+import { camelCase } from "change-case";
+
+type SolidViewParams = {
+  params: {
+    moduleName: string;
+    modelName: string;
+  };
+};
+
+const page = ({ params }: SolidViewParams) => {
+  return (
+    <SolidKanbanView {...params} embeded={false} modelName={camelCase(params.modelName)} />
+  );
+};
+
+export default page;

package/templates/next-template/app/admin/core/[moduleName]/[modelName]/list/page.tsx

@@ -0,0 +1,18 @@
+"use client"
+import { SolidListView } from "@solidxai/core-ui";
+import { camelCase } from "change-case";
+
+type SolidViewParams = {
+  params: {
+    moduleName: string;
+    modelName: string;
+  };
+};
+
+const page = ({ params }: SolidViewParams) => {
+  return (
+    <SolidListView {...params} embeded={false} modelName={camelCase(params.modelName)} />
+  );
+};
+
+export default page;

package/templates/next-template/app/admin/core/[moduleName]/home/page.tsx

@@ -0,0 +1,15 @@
+import { SolidModuleHome } from '@solidxai/core-ui';
+import { capitalCase } from 'change-case';
+
+type SolidViewParams = {
+    params : {
+        moduleName : string
+    }
+}
+export default function ModuleHome({params}: SolidViewParams) {
+    return (
+        <div>
+            <SolidModuleHome moduleName={capitalCase(params.moduleName)} />
+        </div>
+    );
+}

package/templates/next-template/app/admin/core/[moduleName]/settings/[settings]/page.tsx

@@ -0,0 +1,11 @@
+"use client"
+
+import { GeneralSettings } from "@solidxai/core-ui"
+
+const Page = () => {
+    return (
+         <GeneralSettings />
+    )
+}
+
+export default Page

package/templates/next-template/app/admin/layout.tsx

@@ -0,0 +1,11 @@
+import { AdminLayout } from "@solidxai/core-ui";
+const layout = ({ children }: { children: React.ReactNode }) => {
+
+  return (
+    <AdminLayout>
+      {children}
+    </AdminLayout>
+  );
+};
+
+export default layout;

package/templates/next-template/app/admin/loading.tsx

@@ -0,0 +1,8 @@
+"use client"
+import React from "react";
+
+const Loading = () => {
+  return <div className="load"></div>;
+};
+
+export default Loading;

package/templates/next-template/app/admin/page.tsx

@@ -0,0 +1,10 @@
+"use client";
+import { SolidAdmin } from "@solidxai/core-ui"
+
+const page = () => {
+  return (
+    <SolidAdmin />
+  );
+};
+
+export default page;

package/templates/next-template/app/api/auth/[...nextauth]/route.ts

@@ -0,0 +1,6 @@
+import NextAuth from "next-auth";
+import { authProviders } from "@solidxai/core-ui";
+
+const auth = NextAuth(authProviders);
+
+export { auth as GET, auth as POST };

package/templates/next-template/app/auth/confirm-forgot-password/page.tsx

@@ -0,0 +1,12 @@
+"use client"
+import {SolidResetPassword} from "@solidxai/core-ui";
+
+const ForgotPasswordPage = () => {
+  return (
+    <div>
+      <SolidResetPassword />
+    </div>
+  );
+};
+
+export default ForgotPasswordPage;

package/templates/next-template/app/auth/forgot-password/page.tsx

@@ -0,0 +1,11 @@
+import { SolidForgotPassword } from "@solidxai/core-ui";
+
+const ForgotPasswordPage = () => {
+  return (
+    <div>
+      <SolidForgotPassword />
+    </div>
+  );
+};
+
+export default ForgotPasswordPage;

package/templates/next-template/app/auth/initiate-forgot-password/page.tsx

@@ -0,0 +1,11 @@
+import {SolidForgotPassword} from "@solidxai/core-ui";
+
+const InitiateForgotPassword = () => {
+  return (
+    <div>
+      <SolidForgotPassword />
+    </div>
+  );
+};
+
+export default InitiateForgotPassword;

package/templates/next-template/app/auth/initiate-forgot-password-thank-you/page.tsx

@@ -0,0 +1,11 @@
+"use client"
+
+import { ForgotPasswordThankYou } from "@solidxai/core-ui";
+
+const InitiateForgotPasswordThankYou = () => {
+    return (
+        <ForgotPasswordThankYou />
+    );
+};
+
+export default InitiateForgotPasswordThankYou;

package/templates/next-template/app/auth/initiate-google-oauth/page.tsx

@@ -0,0 +1,9 @@
+import { GoogleAuthChecking } from "@solidxai/core-ui";
+
+const InitiateGoogleOAuth = () => {
+    return (
+        <GoogleAuthChecking />
+    )
+}
+
+export default InitiateGoogleOAuth

package/templates/next-template/app/auth/initiate-login/page.tsx

@@ -0,0 +1,13 @@
+"use client"
+import { SolidInitialLoginOtp } from "@solidxai/core-ui";
+import { useSearchParams } from "next/navigation";
+
+const InitiateLoginConfirm = () => {
+    return (
+        <div>
+            <SolidInitialLoginOtp />
+        </div>
+    );
+};
+
+export default InitiateLoginConfirm;

package/templates/next-template/app/auth/initiate-register/page.tsx

@@ -0,0 +1,14 @@
+"use client"
+import { SolidInitiateRegisterOtp } from "@solidxai/core-ui";
+
+import { useSearchParams } from "next/navigation";
+
+const InitiateRegisterConfirm = () => {
+    return (
+        <div>
+            <SolidInitiateRegisterOtp />
+        </div>
+    );
+};
+
+export default InitiateRegisterConfirm;

package/templates/next-template/app/auth/layout.tsx

@@ -0,0 +1,10 @@
+import { AuthLayout } from "@solidxai/core-ui";
+
+const AuthLayoutContainer = ({ children }: { children: React.ReactNode }) => {
+    return (
+        <AuthLayout>
+            {children}
+        </AuthLayout>
+    )
+}
+export default AuthLayoutContainer

package/templates/next-template/app/auth/login/page.tsx

@@ -0,0 +1,12 @@
+"use client"
+import {SolidLogin} from "@solidxai/core-ui";
+
+const LoginPage = () => {
+  return (
+    <div>
+      <SolidLogin />
+    </div>
+  );
+};
+
+export default LoginPage;

package/templates/next-template/app/auth/otp-verify/page.tsx

@@ -0,0 +1,12 @@
+import {SolidOTPVerify} from "@solidxai/core-ui";
+import React from "react";
+
+const SolidOTPVerifyPage = () => {
+  return (
+    <div>
+      <SolidOTPVerify />
+    </div>
+  );
+};
+
+export default SolidOTPVerifyPage;

package/templates/next-template/app/auth/register/page.tsx

@@ -0,0 +1,12 @@
+"use client";
+import { SolidRegister } from "@solidxai/core-ui";
+
+const RegisterPage = () => {
+  return (
+    <div>
+      <SolidRegister />
+    </div>
+  );
+};
+
+export default RegisterPage;

package/templates/next-template/app/auth/reset-password/page.tsx

@@ -0,0 +1,13 @@
+
+import { SolidResetPassword } from "@solidxai/core-ui";
+import React from "react";
+
+const ResetPasswordPage = () => {
+  return (
+    <div>
+      <SolidResetPassword />
+    </div>
+  );
+};
+
+export default ResetPasswordPage;