create-warlock 4.2.6 → 4.2.8

package/templates/warlock/src/app/auth/utils/locales.ts

@@ -0,0 +1,89 @@
+import { groupedTranslations } from "@warlock.js/core";
+
+groupedTranslations("auth", {
+  // App-level translations
+  invalidCredentials: {
+    en: "Invalid email or password",
+    ar: "البريد الالكتروني أو كلمة المرور غير صحيحة",
+  },
+  loggedOut: {
+    en: "Logged out successfully",
+    ar: "تم تسجيل الخروج بنجاح",
+  },
+  loggedOutAll: {
+    en: "Logged out from all devices",
+    ar: "تم تسجيل الخروج من جميع الأجهزة",
+  },
+  refreshTokenRequired: {
+    en: "Refresh token is required",
+    ar: "رمز التحديث مطلوب",
+  },
+  invalidRefreshToken: {
+    en: "Invalid or expired refresh token",
+    ar: "رمز التحديث غير صالح أو منتهي الصلاحية",
+  },
+
+  userNotFound: {
+    en: "User not found",
+    ar: "المستخدم غير موجود",
+  },
+
+  // OTP translations
+  otpSent: {
+    en: "Verification code sent",
+    ar: "تم إرسال رمز التحقق",
+  },
+  missingOtp: {
+    en: "Verification code not found",
+    ar: "رمز التحقق غير موجود",
+  },
+  otpInvalid: {
+    en: "Invalid verification code",
+    ar: "رمز التحقق غير صالح",
+  },
+  otpExpired: {
+    en: "Verification code has expired",
+    ar: "رمز التحقق منتهي الصلاحية",
+  },
+  otpMaxAttempts: {
+    en: "Too many failed attempts",
+    ar: "عدد المحاولات تجاوز الحد المسموح",
+  },
+  passwordResetSuccess: {
+    en: "Password reset successfully",
+    ar: "تم إعادة تعيين كلمة المرور بنجاح",
+  },
+
+  /**
+   * ============================================
+   * @warlock.js/auth package translations
+   * ============================================
+   * The following translations are used by the @warlock.js/auth package
+   * in the auth middleware. They must be defined here so they can be
+   * translated in your application.
+   */
+  errors: {
+    /**
+     * Called when the access token is missing from Authorization header
+     */
+    missingAccessToken: {
+      en: "Access token is required",
+      ar: "رمز الوصول مطلوب",
+    },
+    /**
+     * Called when an access token is invalid or expired
+     */
+    invalidAccessToken: {
+      en: "Invalid or expired access token",
+      ar: "رمز الوصول غير صالح أو منتهي الصلاحية",
+    },
+    /**
+     * Called when the current user type is not authorized to
+     * access a protected resource for certain user types
+     */
+    unauthorized: {
+      en: "You are not authorized to access this resource",
+      ar: "غير مصرح لك بالوصول إلى هذا المورد",
+    },
+  },
+});

package/templates/warlock/src/app/auth/utils/types.ts

@@ -0,0 +1,14 @@
+/**
+ * OTP delivery channels
+ */
+export type OTPChannel = "email" | "sms" | "whatsapp" | "push";
+
+/**
+ * Common OTP types
+ */
+export type OTPType =
+  | "password-reset"
+  | "email-verification"
+  | "phone-verification"
+  | "two-factor"
+  | string;

package/templates/warlock/src/app/posts/controllers/create-new-post.controller.ts

@@ -0,0 +1,21 @@
+import { type GuardedRequestHandler } from "app/auth/requests/guarded.request";
+import { Post } from "../models/post/post.model";
+import { type CreatePostSchema, createPostSchema } from "../schema/create-post.schema";
+
+export const createNewPostController: GuardedRequestHandler<CreatePostSchema> = async (
+  request,
+  response,
+) => {
+  const post = await Post.create({
+    ...request.validated(),
+    authorId: request.user.id,
+  });
+
+  return response.successCreate({
+    post,
+  });
+};
+
+createNewPostController.validation = {
+  schema: createPostSchema,
+};

package/templates/warlock/src/app/posts/controllers/update-post.controller.ts

@@ -0,0 +1,30 @@
+import { type GuardedRequestHandler } from "app/auth/requests/guarded.request";
+import { Post } from "../models/post/post.model";
+import { type UpdatePostSchema, updatePostSchema } from "../schema/update-post.schema";
+
+export const updatePostController: GuardedRequestHandler<UpdatePostSchema> = async (
+  request,
+  response,
+) => {
+  const id = request.int("id");
+
+  if (!id) {
+    return response.notFound();
+  }
+
+  const post = await Post.find(id);
+
+  if (!post) {
+    return response.notFound();
+  }
+
+  await post.save({ merge: request.validated() });
+
+  return response.success({
+    post,
+  });
+};
+
+updatePostController.validation = {
+  schema: updatePostSchema,
+};

package/templates/warlock/src/app/posts/models/post/migrations/09-01-2026_02-07-51-post.migration.ts

@@ -0,0 +1,15 @@
+import { bool, integer, json, Migration, string, text, timestamp } from "@warlock.js/cascade";
+import { Post } from "../post.model";
+
+export default Migration.create(Post, {
+  title: string(255),
+  description: text(),
+  slug: string(255).unique(),
+  image: string(500).nullable(),
+  isActive: bool(),
+  authorId: integer().notNullable(),
+  createdBy: json().nullable(),
+  updatedBy: json().nullable(),
+  deletedBy: json().nullable(),
+  deletedAt: timestamp().nullable(),
+});

package/templates/warlock/src/app/posts/models/post/post.model.ts

@@ -0,0 +1,23 @@
+import { Model, RegisterModel } from "@warlock.js/cascade";
+import { useComputedSlug } from "@warlock.js/core";
+import { type Infer, v } from "@warlock.js/seal";
+import { PostResource } from "app/posts/resources/post.resource";
+import { globalColumnsSchema } from "app/shared/utils/global-columns-schema";
+
+export const postSchema = globalColumnsSchema.extend({
+  title: v.string().required(),
+  description: v.string().required(),
+  slug: v.computed(useComputedSlug()),
+  image: v.string().required(),
+});
+
+type PostSchema = Infer<typeof postSchema>;
+
+@RegisterModel()
+export class Post extends Model<PostSchema> {
+  public static table = "posts";
+
+  public static schema = postSchema;
+
+  public static resource = PostResource;
+}

package/templates/warlock/src/app/posts/resources/post.resource.ts

@@ -0,0 +1,14 @@
+import { defineResource } from "@warlock.js/core";
+
+export const PostResource = defineResource({
+  schema: {
+    id: "number",
+    slug: "string",
+    title: "string",
+    description: "string",
+    image: "storageUrl",
+    createdBy: "object",
+    updatedBy: "object",
+    isActive: "boolean",
+  },
+});

package/templates/warlock/src/app/posts/routes.ts

@@ -0,0 +1,8 @@
+import { router } from "@warlock.js/core";
+import { guarded } from "app/shared/utils/router";
+import { createNewPostController } from "./controllers/create-new-post.controller";
+import { updatePostController } from "./controllers/update-post.controller";
+
+guarded(() => {
+  router.route("/posts").create(createNewPostController).update(updatePostController);
+});

package/templates/warlock/src/app/posts/schema/create-post.schema.ts

@@ -0,0 +1,9 @@
+import { type Infer, v } from "@warlock.js/seal";
+
+export const createPostSchema = v.object({
+  title: v.string().required(),
+  description: v.string(),
+  image: v.file().image().maxSize({ size: 2, unit: "MB" }).saveTo("posts"),
+});
+
+export type CreatePostSchema = Infer<typeof createPostSchema>;

package/templates/warlock/src/app/posts/schema/update-post.schema.ts

@@ -0,0 +1,9 @@
+import { type Infer, v } from "@warlock.js/seal";
+
+export const updatePostSchema = v.object({
+  title: v.string().required(),
+  description: v.string(),
+  image: v.file().image().maxSize({ size: 2, unit: "MB" }).saveTo("posts"),
+});
+
+export type UpdatePostSchema = Infer<typeof updatePostSchema>;

package/templates/warlock/src/app/shared/components/HomePageComponent.tsx

@@ -0,0 +1,229 @@
+import { Application, publicUrl } from "@warlock.js/core";
+
+export function HomePageComponent() {
+  return (
+    <html>
+      <head>
+        <meta charSet="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>Warlock.js - Modern Backend TypeScript Framework</title>
+        <meta
+          name="description"
+          content="A powerful, elegant TypeScript framework for building modern web applications with ease."
+        />
+        <link rel="stylesheet" href={publicUrl("home.css")} />
+        <link rel="preconnect" href="https://fonts.googleapis.com" />
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossOrigin="anonymous" />
+        <link
+          href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800;900&display=swap"
+          rel="stylesheet"
+        />
+      </head>
+      <body>
+        <div className="warlock-home">
+          <div className="warlock-container">
+            {/* Header */}
+            <header className="warlock-header">
+              <a href="/" className="warlock-logo">
+                <span className="warlock-logo-icon">⚡</span>
+                <span>Warlock.js</span>
+              </a>
+              <nav className="warlock-nav">
+                <a href="https://warlock.js.org" target="_blank" rel="noopener noreferrer">
+                  Docs
+                </a>
+                <a href="https://github.com/warlockjs" target="_blank" rel="noopener noreferrer">
+                  GitHub
+                </a>
+                <a href="https://discord.gg/x3W9SN2jvx" target="_blank" rel="noopener noreferrer">
+                  Discord
+                </a>
+              </nav>
+            </header>
+            {/* Hero Section */}
+            <section className="warlock-hero">
+              <h1>
+                Build Modern Web Apps
+                <br />
+                with Confidence
+              </h1>
+              <p>
+                A powerful, elegant TypeScript framework designed for developers who demand
+                excellence. Ship faster, scale better, and enjoy the journey.
+              </p>
+              <div className="warlock-cta">
+                <a href="https://warlock.js.org" className="warlock-btn warlock-btn-primary">
+                  <span>Get Started</span>
+                  <span>→</span>
+                </a>
+                <a
+                  href="https://github.com/warlockjs"
+                  className="warlock-btn warlock-btn-secondary"
+                >
+                  <span>View on GitHub</span>
+                </a>
+              </div>
+            </section>
+
+            {/* Features Section */}
+            <section className="warlock-features">
+              <h2 className="warlock-section-title">Why Warlock.js?</h2>
+              <p className="warlock-section-subtitle">
+                Everything you need to build production-ready applications
+              </p>
+
+              <div className="warlock-features-grid">
+                <div className="warlock-feature-card">
+                  <span className="warlock-feature-icon">🚀</span>
+                  <h3>Lightning Fast</h3>
+                  <p>
+                    Blazing fast development server with instant hot reload. Build and deploy
+                    optimized production bundles in seconds.
+                  </p>
+                </div>
+
+                <div className="warlock-feature-card">
+                  <span className="warlock-feature-icon">🎯</span>
+                  <h3>Type-Safe</h3>
+                  <p>
+                    Built with TypeScript from the ground up. Enjoy full type safety across your
+                    entire application with intelligent auto-completion.
+                  </p>
+                </div>
+
+                <div className="warlock-feature-card">
+                  <span className="warlock-feature-icon">🏗️</span>
+                  <h3>Battle-Tested Architecture</h3>
+                  <p>
+                    Proven patterns and best practices baked in. From routing to database
+                    management, we've got you covered.
+                  </p>
+                </div>
+
+                <div className="warlock-feature-card">
+                  <span className="warlock-feature-icon">🔌</span>
+                  <h3>Powerful CLI</h3>
+                  <p>
+                    Scaffold components, run migrations, manage seeds, and more with an intuitive
+                    command-line interface that boosts productivity.
+                  </p>
+                </div>
+
+                <div className="warlock-feature-card">
+                  <span className="warlock-feature-icon">🎨</span>
+                  <h3>Flexible & Extensible</h3>
+                  <p>
+                    Plugin architecture allows you to extend core functionality. Build your own
+                    tools or use community packages.
+                  </p>
+                </div>
+
+                <div className="warlock-feature-card">
+                  <span className="warlock-feature-icon">🌍</span>
+                  <h3>Multi-Tenant Ready</h3>
+                  <p>
+                    Built-in support for multi-tenancy. Scale from single to multi-tenant
+                    applications without architectural changes.
+                  </p>
+                </div>
+              </div>
+            </section>
+
+            {/* Quick Start Section */}
+            <section className="warlock-quickstart">
+              <h2 className="warlock-section-title">Extend with Features</h2>
+              <p className="warlock-section-subtitle">
+                Add powerful features to your project instantly
+              </p>
+
+              <div className="warlock-code-block">
+                <div className="warlock-code-header">
+                  <span className="warlock-code-dot"></span>
+                  <span className="warlock-code-dot"></span>
+                  <span className="warlock-code-dot"></span>
+                </div>
+                <div className="warlock-code-content">
+                  <code className="warlock-code-line">
+                    <span className="warlock-code-comment">
+                      # Add React for rendering & email templates
+                    </span>
+                  </code>
+                  <code className="warlock-code-line">
+                    <span className="warlock-code-command">npx</span> warlock add{" "}
+                    <span className="warlock-code-flag">react</span>
+                  </code>
+                  <code className="warlock-code-line">&nbsp;</code>
+                  <code className="warlock-code-line">
+                    <span className="warlock-code-comment">
+                      # Add MongoDB, Redis & testing support
+                    </span>
+                  </code>
+                  <code className="warlock-code-line">
+                    <span className="warlock-code-command">npx</span> warlock add{" "}
+                    <span className="warlock-code-flag">mongodb redis test</span>
+                  </code>
+                  <code className="warlock-code-line">&nbsp;</code>
+                  <code className="warlock-code-line">
+                    <span className="warlock-code-comment"># List all available features</span>
+                  </code>
+                  <code className="warlock-code-line">
+                    <span className="warlock-code-command">npx</span> warlock add{" "}
+                    <span className="warlock-code-flag">--list</span>
+                  </code>
+                  <code className="warlock-code-line">&nbsp;</code>
+                  <code className="warlock-code-line">
+                    <span className="warlock-code-comment">
+                      # ✨ Features: react, mongodb, postgres, mysql, redis, s3, mail, image, test,
+                      swagger, scheduler & more
+                    </span>
+                  </code>
+                </div>
+              </div>
+            </section>
+
+            {/* Footer */}
+            <footer className="warlock-footer">
+              <div className="warlock-social-links">
+                <a
+                  href="https://discord.gg/x3W9SN2jvx"
+                  className="warlock-social-link"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  <span className="warlock-social-icon">💬</span>
+                  <span>Join Discord</span>
+                </a>
+                <a
+                  href="https://github.com/warlockjs"
+                  className="warlock-social-link"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  <span className="warlock-social-icon">⭐</span>
+                  <span>Star on GitHub</span>
+                </a>
+                <a
+                  href="https://warlock.js.org"
+                  className="warlock-social-link"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  <span className="warlock-social-icon">📚</span>
+                  <span>Read Docs</span>
+                </a>
+              </div>
+              <p className="warlock-footer-text">
+                Built with ⚡ by the{" "}
+                <a href="https://github.com/warlockjs" target="_blank" rel="noopener noreferrer">
+                  Warlock.js Team
+                </a>
+                {" · "}
+                <span>v{Application.version}</span>
+              </p>
+            </footer>
+          </div>
+        </div>
+      </body>
+    </html>
+  );
+}

package/templates/warlock/src/app/shared/controllers/home-page.controller.ts

@@ -0,0 +1,18 @@
+import { Application, type RequestHandler } from "@warlock.js/core";
+
+/**
+ * Default welcome route — a dependency-free JSON response.
+ *
+ * Projects scaffolded with the `react` feature get the richer HTML welcome
+ * page (`home-page.controller.tsx` + `HomePageComponent.tsx`) instead; this
+ * plain controller is removed at scaffold time when React is selected.
+ */
+export const homePageController: RequestHandler = async (_request, response) => {
+  return response.success({
+    message: "Welcome to Warlock 🧙 — your app is up and running!",
+    version: Application.version,
+    docs: "https://warlock.js.org",
+  });
+};
+
+homePageController.description = "Welcome Home Page";

package/templates/warlock/src/app/shared/controllers/home-page.controller.tsx

@@ -0,0 +1,8 @@
+import { type Request, type RequestHandler, type Response } from "@warlock.js/core";
+import { HomePageComponent } from "../components/HomePageComponent";
+
+export const homePageController: RequestHandler = async (_request: Request, response: Response) => {
+  return response.render(<HomePageComponent />);
+};
+
+homePageController.description = "Welcome Home Page";

package/templates/warlock/src/app/shared/routes.ts

@@ -0,0 +1,4 @@
+import { router } from "@warlock.js/core";
+import { homePageController } from "./controllers/home-page.controller";
+
+router.get("/", homePageController);

package/templates/warlock/src/app/shared/services/scheduler.service.ts

@@ -0,0 +1,3 @@
+import { Scheduler } from "@warlock.js/scheduler";
+
+export const scheduler = new Scheduler();

package/templates/warlock/src/app/shared/tests/infrastructure.test.ts

@@ -0,0 +1,22 @@
+/**
+ * Sample test to verify test infrastructure
+ */
+import { testGet } from "@warlock.js/core";
+import { describe, expect, it } from "vitest";
+
+describe("Test Infrastructure", () => {
+  it("should have database connection available", async () => {
+    // This test verifies the per-worker setup works
+    // The setupTest function should have initialized connectors
+    expect(true).toBe(true);
+  });
+
+  it("should be able to make HTTP requests to test server", async () => {
+    // This test verifies the global HTTP server is running
+    const response = await testGet("/");
+
+    // We expect some response (even 404 is fine - means server is reachable)
+    expect(response.status).toBeDefined();
+    expect(response.headers.get("content-type")).toBe("text/html");
+  });
+});

package/templates/warlock/src/app/shared/utils/global-columns-schema.ts

@@ -0,0 +1,8 @@
+import { v } from "@warlock.js/seal";
+
+export const globalColumnsSchema = v.object({
+  createdBy: v.embed("User"),
+  updatedBy: v.embed("User"),
+  deletedBy: v.embed("User"),
+  isActive: v.boolean().default(true),
+});