@simple-auth-kit/cli 1.4.2 → 1.5.0

package/registry/combos/express-prisma/variants/workspaces/src/admin.router.ts

@@ -1,330 +0,0 @@
-import type { NextFunction, Request, RequestHandler, Response } from "express";
-import { AuthService } from "./auth.service.js";
-import { HttpError } from "./http-error.js";
-import { ability, createTieredRouter } from "./route-tiers.js";
-import { WorkspaceRepository } from "./workspace.repository.js";
-import { hashPassword } from "@/lib/auth/core/crypto.js";
-import "./request-context.js";
-
-function requireString(value: unknown, field: string): string {
-  if (typeof value !== "string" || value.length === 0) throw new HttpError(400, `${field} is required`);
-  return value;
-}
-
-const optionalString = (value: unknown): string | undefined => (typeof value === "string" ? value : undefined);
-
-export interface AdminRouterDeps {
-  auth: AuthService;
-  workspaces: WorkspaceRepository;
-  authentication: RequestHandler;
-  /** The mandatory workspace resolution — every route here acts inside one. See authz.middleware.ts. */
-  workspaceScope: RequestHandler;
-}
-
-/**
- * Administration *of one workspace*, named by the `X-Workspace-Id` header. Authority is a
- * permission, never a role name: the workspace middleware resolves the caller's membership and the
- * roles and permissions it carries **in that workspace**, builds the CASL ability from them, and
- * each route's `ability(...)` tier checks its slugs against it. There is no role-based bypass —
- * holding a role called "admin" that carries no permissions gets exactly the same 403 as holding no
- * role at all, which is why `npm run seed` (which provisions the catalog and the roles that carry
- * it) is a prerequisite for this router doing anything.
- *
- * Every handler passes `req.authz` down to the service, and every service method reaches the
- * database through a workspace-scoped query. That is the security property this model rests on: an
- * admin of one workspace has no expressible way to name a row in another.
- *
- * Each route says what it demands; the rows say who is granted it. The slugs below are checked at
- * compile time against `PERMISSION_CATALOG` in `rbac.defaults.ts`, while who holds them — and
- * whether the permission is active at all — is edited through this very router and takes effect on
- * the next request. `GET /auth/me` returns the caller's slugs, and a console rebuilds the same
- * ability from them with the same function the middleware used.
- *
- * Replaces the reference combo's `AdminController`. Mounted under `/auth/admin` by
- * create-auth-app.ts; `createTieredRouter` stands in for its
- * `@UseGuards(AuthGuard, AuthzGuard, AbilityGuard)` — see route-tiers.ts for why the tier is a
- * required argument rather than a decorator.
- */
-export function createAdminRouter(deps: AdminRouterDeps): RequestHandler {
-  const { auth, workspaces, authentication, workspaceScope } = deps;
-  const admin = createTieredRouter({ authentication, authorization: workspaceScope });
-
-  admin.route("get", "/users", ability("users:read"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const { search, page, limit } = req.query as Record<string, string | undefined>;
-      res.status(200).json(await auth.listUsers(req.authz!, { search, page: page ? Number(page) : undefined, limit: limit ? Number(limit) : undefined }));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  // No invitation email — the account is usable immediately with the password given here.
-  admin.route("post", "/users", ability("users:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const body = req.body as Record<string, unknown>;
-      const passwordHash = await hashPassword(requireString(body.password, "password"));
-      const member = await workspaces.createMember(
-        req.authz!.workspaceId,
-        {
-          email: requireString(body.email, "email"),
-          passwordHash,
-          firstName: optionalString(body.firstName),
-          lastName: optionalString(body.lastName),
-          displayName: optionalString(body.displayName),
-          phone: optionalString(body.phone),
-          username: optionalString(body.username),
-          roles: Array.isArray(body.roles) ? body.roles.filter((role): role is string => typeof role === "string") : undefined,
-        },
-        req.auth!.sub,
-      );
-      res.status(201).json(await auth.getUser(req.authz!, member.userId));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("get", "/users/:userId", ability("users:read"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      res.status(200).json(await auth.getUser(req.authz!, requireString(req.params.userId, "userId")));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  // Profile fields only — email is the login identifier and is not editable here.
-  admin.route("patch", "/users/:userId", ability("users:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const userId = requireString(req.params.userId, "userId");
-      const body = req.body as Record<string, unknown>;
-      res.status(200).json(
-        await auth.updateUser(
-          req.authz!,
-          userId,
-          {
-            firstName: body.firstName === null ? null : optionalString(body.firstName),
-            lastName: body.lastName === null ? null : optionalString(body.lastName),
-            displayName: body.displayName === null ? null : optionalString(body.displayName),
-            phone: body.phone === null ? null : optionalString(body.phone),
-            username: body.username === null ? null : optionalString(body.username),
-            photo: body.photo === null ? null : optionalString(body.photo),
-          },
-          req.auth!.sub,
-        ),
-      );
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  // Soft-delete: the row survives for audit purposes, stops appearing in listings, and can no
-  // longer authenticate. This disables the account across every workspace it belongs to, not
-  // just this one — the same reach `block` already has.
-  admin.route("delete", "/users/:userId", ability("users:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const userId = requireString(req.params.userId, "userId");
-      if (userId === req.auth!.sub) throw new HttpError(403, "cannot delete your own account");
-      await auth.deleteUser(req.authz!, userId, req.auth!.sub, optionalString((req.body as Record<string, unknown> | undefined)?.reason));
-      res.status(200).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("get", "/audit-log", ability("audit-log:read"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const { userId, action, since, until, page, limit } = req.query as Record<string, string | undefined>;
-      res.status(200).json(
-        await auth.listAuditLog(req.authz!, { userId, action, since, until, page: page ? Number(page) : undefined, limit: limit ? Number(limit) : undefined }),
-      );
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("get", "/permissions", ability("permissions:read"), async (_req: Request, res: Response, next: NextFunction) => {
-    try {
-      res.status(200).json(await auth.listPermissions());
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/permissions", ability("permissions:define"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const body = req.body as Record<string, unknown>;
-      res.status(201).json(
-        await auth.definePermission(
-          {
-            slug: requireString(body.slug, "slug"),
-            name: optionalString(body.name),
-            displayName: optionalString(body.displayName),
-            description: body.description === null ? null : optionalString(body.description),
-            group: optionalString(body.group),
-            groupOrder: typeof body.groupOrder === "number" ? body.groupOrder : undefined,
-            order: typeof body.order === "number" ? body.order : undefined,
-            isActive: typeof body.isActive === "boolean" ? body.isActive : undefined,
-          },
-          req.auth!.sub,
-        ),
-      );
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("get", "/roles", ability("roles:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      res.status(200).json(await auth.listRoles(req.authz!));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/roles", ability("roles:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const body = req.body as Record<string, unknown>;
-      res.status(201).json(
-        await auth.createRole(
-          req.authz!,
-          {
-            slug: requireString(body.slug, "slug"),
-            name: optionalString(body.name),
-            displayName: optionalString(body.displayName),
-            description: optionalString(body.description) ?? null,
-          },
-          req.auth!.sub,
-        ),
-      );
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("patch", "/roles/:roleId", ability("roles:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const roleId = requireString(req.params.roleId, "roleId");
-      const body = req.body as Record<string, unknown>;
-      res.status(200).json(
-        await auth.updateRole(
-          req.authz!,
-          roleId,
-          {
-            name: optionalString(body.name),
-            displayName: optionalString(body.displayName),
-            description: body.description === null ? null : optionalString(body.description),
-            isActive: typeof body.isActive === "boolean" ? body.isActive : undefined,
-          },
-          req.auth!.sub,
-        ),
-      );
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  // Soft-delete: existing assignments are left in place rather than cascade-deleted, and the role
-  // simply stops being resolved.
-  admin.route("delete", "/roles/:roleId", ability("roles:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const roleId = requireString(req.params.roleId, "roleId");
-      await auth.deleteRole(req.authz!, roleId, req.auth!.sub, optionalString((req.body as Record<string, unknown> | undefined)?.reason));
-      res.status(200).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/roles/:roleId/permissions", ability("roles:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const body = req.body as Record<string, unknown>;
-      await auth.attachPermissionToRole(req.authz!, requireString(req.params.roleId, "roleId"), requireString(body.permission, "permission"), req.auth!.sub);
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/users/:userId/roles", ability("roles:assign"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const body = req.body as Record<string, unknown>;
-      await auth.assignRole(req.authz!, requireString(req.params.userId, "userId"), requireString(body.role, "role"));
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/users/:userId/roles/:roleSlug/revoke", ability("roles:assign"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const userId = requireString(req.params.userId, "userId");
-      // Revoking your own `admin` would strip the very permission that let you call this,
-      // with no route back in. Assigning to yourself is fine — it can't lock anyone out.
-      if (userId === req.auth!.sub) throw new HttpError(403, "cannot change your own roles");
-      await auth.revokeRole(req.authz!, userId, requireString(req.params.roleSlug, "roleSlug"));
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/users/:userId/permissions", ability("permissions:grant"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const body = req.body as Record<string, unknown>;
-      await auth.grantPermission(req.authz!, requireString(req.params.userId, "userId"), requireString(body.permission, "permission"), req.auth!.sub);
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/users/:userId/permissions/:permissionSlug/revoke", ability("permissions:grant"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      await auth.revokePermission(req.authz!, requireString(req.params.userId, "userId"), requireString(req.params.permissionSlug, "permissionSlug"));
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/users/:userId/block", ability("users:block"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const userId = requireString(req.params.userId, "userId");
-      if (userId === req.auth!.sub) throw new HttpError(403, "cannot block your own account");
-      await auth.block(req.authz!, userId, { userId: req.auth!.sub, ip: req.ip });
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/users/:userId/unblock", ability("users:block"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      await auth.unblock(req.authz!, requireString(req.params.userId, "userId"), { userId: req.auth!.sub, ip: req.ip });
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/users/:userId/deactivate", ability("users:block"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const userId = requireString(req.params.userId, "userId");
-      if (userId === req.auth!.sub) throw new HttpError(403, "cannot deactivate your own account");
-      await auth.deactivate(req.authz!, userId, { userId: req.auth!.sub, ip: req.ip });
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  admin.route("post", "/users/:userId/activate", ability("users:block"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      await auth.activate(req.authz!, requireString(req.params.userId, "userId"), { userId: req.auth!.sub, ip: req.ip });
-      res.status(201).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  return admin.handler;
-}

package/registry/combos/express-prisma/variants/workspaces/src/workspace.router.ts

@@ -1,123 +0,0 @@
-import { Router } from "express";
-import type { NextFunction, Request, RequestHandler, Response } from "express";
-import { HttpError } from "./http-error.js";
-import { RbacRepository } from "./rbac.repository.js";
-import { ability, authenticated, createTieredRouter } from "./route-tiers.js";
-import { WorkspaceRepository } from "./workspace.repository.js";
-import "./request-context.js";
-
-function requireString(value: unknown, field: string): string {
-  if (typeof value !== "string" || value.length === 0) throw new HttpError(400, `${field} is required`);
-  return value;
-}
-
-function requireStringArray(value: unknown, field: string): string[] {
-  if (!Array.isArray(value) || value.some((v) => typeof v !== "string")) throw new HttpError(400, `${field} must be an array of strings`);
-  return value as string[];
-}
-
-export interface WorkspaceRouterDeps {
-  workspaces: WorkspaceRepository;
-  rbac: RbacRepository;
-  authentication: RequestHandler;
-  /** Resolves a workspace when the request names one, and does nothing when it does not. */
-  authorization: RequestHandler;
-  /** The same resolution, but the `X-Workspace-Id` header is mandatory. */
-  workspaceScope: RequestHandler;
-}
-
-/**
- * Workspace membership. Every route below that acts *inside* a workspace names it with the
- * `X-Workspace-Id` header rather than a path segment — the same rule the `/auth/admin/*` routes
- * follow, so there is exactly one way a request says which workspace it means.
- *
- * Three routes here are deliberately tier 2 — `authenticated()`, any logged-in caller — and the
- * permission catalog mints no slugs for them. That is a decision written on each route, not an
- * omission: the tier is a required argument, so a route with none is a compile error
- * (route-tiers.ts).
- *   • `POST /workspaces` and `GET /workspaces` are outside every workspace — any authenticated
- *     user may create one or list their own. There is no workspace whose permissions could be
- *     checked, and gating them on a permission granted *inside* some other workspace would mean
- *     your first workspace could only be created by someone who already had one.
- *   • `GET /workspaces/members` is gated on membership itself: the workspace middleware already
- *     proved the caller belongs to the workspace, and seeing who else is in a room you are in is
- *     not an administrative capability.
- * The three that mutate membership are permission-gated — see `rbac.defaults.ts` for the catalog.
- *
- * Two tiered routers, because the tier's middleware is what enforces the tier: the unscoped
- * routes resolve a workspace only if one is named, while everything under a workspace uses the
- * mandatory resolution. Mounting them in this order matters — the scoped router is consulted
- * first, so `/workspaces/members` reaches it rather than falling through.
- *
- * Replaces the reference combo's `WorkspaceController`.
- */
-export function createWorkspaceRouter(deps: WorkspaceRouterDeps): RequestHandler {
-  const { workspaces, rbac, authentication, authorization, workspaceScope } = deps;
-
-  const scoped = createTieredRouter({ authentication, authorization: workspaceScope });
-  const unscoped = createTieredRouter({ authentication, authorization });
-
-  unscoped.route("post", "/", authenticated(), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const body = req.body as Record<string, unknown>;
-      res.status(201).json(await workspaces.create(req.auth!.sub, requireString(body.name, "name")));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  unscoped.route("get", "/", authenticated(), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      res.status(200).json(await workspaces.listForUser(req.auth!.sub));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  scoped.route("get", "/members", authenticated(), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      res.status(200).json(await workspaces.listMembers(req.authz!.workspaceId));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  scoped.route("post", "/members", ability("members:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const body = req.body as Record<string, unknown>;
-      // No `roles` in the body means "whatever this workspace flags as the default role" — the
-      // default lives in a row, not in this line.
-      const roles = body.roles === undefined ? undefined : requireStringArray(body.roles, "roles");
-      res.status(201).json(await workspaces.addMember(req.authz!.workspaceId, requireString(body.email, "email"), roles));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  scoped.route("put", "/members/:memberId/roles", ability("roles:assign"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const memberId = requireString(req.params.memberId, "memberId");
-      if (memberId === req.authz!.memberId) throw new HttpError(403, "cannot change your own roles");
-      const body = req.body as Record<string, unknown>;
-      res.status(200).json(await rbac.setMemberRoles(req.authz!.workspaceId, memberId, requireStringArray(body.roles, "roles")));
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  scoped.route("delete", "/members/:memberId", ability("members:manage"), async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const memberId = requireString(req.params.memberId, "memberId");
-      if (memberId === req.authz!.memberId) throw new HttpError(403, "cannot remove yourself from a workspace you administer");
-      await workspaces.removeMember(req.authz!.workspaceId, memberId);
-      res.status(200).json({ ok: true });
-    } catch (err) {
-      next(err);
-    }
-  });
-
-  const router = Router();
-  router.use(scoped.handler);
-  router.use(unscoped.handler);
-  return router;
-}

package/registry/combos/nestjs-drizzle/shared/src/oauth.repository.ts

@@ -1,36 +0,0 @@
-import { BadRequestException, Inject, Injectable } from "@nestjs/common";
-import { and, eq } from "drizzle-orm";
-import type { OAuthStoreDeps } from "@/lib/auth/core/oauth.js";
-import { DRIZZLE_DB, type Database } from "./db.js";
-import { oauthAccounts, users } from "./schema.js";
-import { toId } from "./id.helper.js";
-
-@Injectable()
-export class OAuthRepository implements OAuthStoreDeps {
-  constructor(@Inject(DRIZZLE_DB) private readonly db: Database) {}
-
-  async findAccountByProvider(provider: string, providerAccountId: string): Promise<{ userId: string } | null> {
-    const [row] = await this.db
-      .select()
-      .from(oauthAccounts)
-      .where(and(eq(oauthAccounts.provider, provider), eq(oauthAccounts.providerAccountId, providerAccountId)))
-      .limit(1);
-    return row ? { userId: row.userId.toString() } : null;
-  }
-
-  async linkAccount(input: { userId: string; provider: string; providerAccountId: string; email?: string }): Promise<void> {
-    await this.db.insert(oauthAccounts).values({ ...input, userId: toId(input.userId) });
-  }
-
-  async findUserByVerifiedEmail(email: string): Promise<{ id: string } | null> {
-    const [row] = await this.db.select().from(users).where(eq(users.email, email)).limit(1);
-    return row ? { id: row.id.toString() } : null;
-  }
-
-  /** OAuth-only signup: no password is ever set, which is why `User.passwordHash` is nullable. */
-  async createUserFromOAuth(input: { email?: string }): Promise<{ id: string }> {
-    if (!input.email) throw new BadRequestException("OAuth provider did not return an email address");
-    const [row] = await this.db.insert(users).values({ email: input.email, passwordHash: null }).returning();
-    return { id: row.id.toString() };
-  }
-}

package/registry/combos/nestjs-drizzle/shared/src/password-reset.repository.ts

@@ -1,29 +0,0 @@
-import { Inject, Injectable } from "@nestjs/common";
-import { eq } from "drizzle-orm";
-import type { PasswordResetStoreDeps } from "@/lib/auth/core/password-reset.js";
-import { DRIZZLE_DB, type Database } from "./db.js";
-import { passwordResetTokens, users } from "./schema.js";
-import { toId } from "./id.helper.js";
-
-@Injectable()
-export class PasswordResetRepository implements PasswordResetStoreDeps {
-  constructor(@Inject(DRIZZLE_DB) private readonly db: Database) {}
-
-  async saveResetToken(input: { userId: string; tokenHash: string; expiresAt: string }): Promise<void> {
-    await this.db.insert(passwordResetTokens).values({ userId: toId(input.userId), tokenHash: input.tokenHash, expiresAt: new Date(input.expiresAt) });
-  }
-
-  async findValidResetToken(tokenHash: string): Promise<{ userId: string; expiresAt: string; consumedAt: string | null } | null> {
-    const [row] = await this.db.select().from(passwordResetTokens).where(eq(passwordResetTokens.tokenHash, tokenHash)).limit(1);
-    if (!row) return null;
-    return { userId: row.userId.toString(), expiresAt: row.expiresAt.toISOString(), consumedAt: row.consumedAt?.toISOString() ?? null };
-  }
-
-  async consumeResetToken(tokenHash: string): Promise<void> {
-    await this.db.update(passwordResetTokens).set({ consumedAt: new Date() }).where(eq(passwordResetTokens.tokenHash, tokenHash));
-  }
-
-  async setPasswordHash(userId: string, passwordHash: string): Promise<void> {
-    await this.db.update(users).set({ passwordHash }).where(eq(users.id, toId(userId)));
-  }
-}