feat: modular domain driven boilerplate

modules/identity/routes/identities/get/handle.ts

@@ -0,0 +1,16 @@
+import { ForbiddenError, NotFoundError } from "@platform/relay";
+
+import { getIdentityById } from "../../../database.ts";
+import route from "./spec.ts";
+
+export default route.access("session").handle(async ({ params: { id } }, { access }) => {
+  const identity = await getIdentityById(id);
+  if (identity === undefined) {
+    return new NotFoundError("Identity does not exist, or has been removed.");
+  }
+  const decision = await access.isAllowed({ kind: "identity", id: identity.id, attr: {} }, "read");
+  if (decision === false) {
+    return new ForbiddenError("You do not have permission to view this identity.");
+  }
+  return identity;
+});

modules/identity/routes/identities/get/spec.ts

@@ -0,0 +1,12 @@
+import { ForbiddenError, NotFoundError, route, UnauthorizedError } from "@platform/relay";
+import z from "zod";
+
+import { IdentitySchema } from "../../../models/identity.ts";
+
+export default route
+  .get("/api/v1/identities/:id")
+  .params({
+    id: z.string(),
+  })
+  .errors([UnauthorizedError, ForbiddenError, NotFoundError])
+  .response(IdentitySchema);

modules/identity/routes/identities/me/handle.ts

@@ -0,0 +1,12 @@
+import { UnauthorizedError } from "@platform/relay";
+
+import { getIdentityById } from "../../../database.ts";
+import route from "./spec.ts";
+
+export default route.access("session").handle(async ({ principal }) => {
+  const identity = await getIdentityById(principal.id);
+  if (identity === undefined) {
+    return new UnauthorizedError("You must be signed in to view your session.");
+  }
+  return identity;
+});

modules/identity/routes/identities/me/spec.ts

@@ -0,0 +1,5 @@
+import { NotFoundError, route, UnauthorizedError } from "@platform/relay";
+
+import { IdentitySchema } from "../../../models/identity.ts";
+
+export default route.get("/api/v1/identities/me").response(IdentitySchema).errors([UnauthorizedError, NotFoundError]);

modules/identity/routes/identities/register/handle.ts

@@ -0,0 +1,11 @@
+import { Identity, isEmailClaimed } from "../../../aggregates/identity.ts";
+import { IdentityEmailClaimedError } from "../../../errors.ts";
+import { eventStore } from "../../../event-store.ts";
+import route from "./spec.ts";
+
+export default route.access("public").handle(async ({ body: { name, email } }) => {
+  if ((await isEmailClaimed(email)) === true) {
+    return new IdentityEmailClaimedError(email);
+  }
+  return eventStore.aggregate.from(Identity).create().addName(name).addEmailStrategy(email).addRole("user").save();
+});

modules/identity/routes/identities/register/spec.ts

@@ -0,0 +1,17 @@
+import { route } from "@platform/relay";
+import z from "zod";
+
+import { IdentityEmailClaimedError } from "../../../errors.ts";
+import { IdentitySchema } from "../../../models/identity.ts";
+import { NameSchema } from "../../../schemas/name.ts";
+
+export default route
+  .post("/api/v1/identities")
+  .body(
+    z.object({
+      name: NameSchema,
+      email: z.email(),
+    }),
+  )
+  .errors([IdentityEmailClaimedError])
+  .response(IdentitySchema);

modules/identity/routes/identities/resolve/handle.ts

@@ -0,0 +1,13 @@
+import { NotFoundError } from "@platform/relay";
+
+import { config } from "../../../config.ts";
+import { getIdentityById } from "../../../database.ts";
+import route from "./spec.ts";
+
+export default route.access(["internal:public", config.internal.privateKey]).handle(async ({ params: { id } }) => {
+  const identity = await getIdentityById(id);
+  if (identity === undefined) {
+    return new NotFoundError();
+  }
+  return identity;
+});

modules/identity/routes/identities/resolve/keys.ts

@@ -0,0 +1,5 @@
+import { importVault } from "@platform/vault";
+
+import { config } from "../../../config.ts";
+
+export const vault = importVault(config.internal);

modules/identity/routes/identities/resolve/spec.ts

@@ -0,0 +1,12 @@
+import { NotFoundError, route, UnauthorizedError } from "@platform/relay";
+import z from "zod";
+
+import { IdentitySchema } from "../../../models/identity.ts";
+
+export default route
+  .get("/api/v1/identities/:id/resolve")
+  .params({
+    id: z.string(),
+  })
+  .response(IdentitySchema)
+  .errors([UnauthorizedError, NotFoundError]);