sailfork / t3code-github / infra/ relay/ src/ environments/ EnvironmentPublishSignatures.ts

import {
  RelayAgentActivityPublishProofPayload,
  RelayAgentActivityPublishProofInvalidReason,
  type RelayAgentActivityPublishRequest,
} from "@t3tools/contracts/relay";
import {
  decodeRelayJwt,
  normalizeRelayIssuer,
  RELAY_ACTIVITY_PUBLISH_TYP,
  verifyRelayJwt,
} from "@t3tools/shared/relayJwt";
import { stableStringify } from "@t3tools/shared/relaySigning";
import * as Context from "effect/Context";
import * as Digest from "effect/crypto/Digest";
import * as Signature from "effect/crypto/Signature";
import * as DateTime from "effect/DateTime";
import * as Effect from "effect/Effect";
import * as Base64Url from "effect/encoding/Base64Url";
import * as Layer from "effect/Layer";
import * as Schema from "effect/Schema";

import * as DpopProofs from "../auth/DpopProofs.ts";
import * as RelayConfiguration from "../Config.ts";

export class EnvironmentPublishSignatureExpired extends Schema.TaggedError<EnvironmentPublishSignatureExpired>()(
  "EnvironmentPublishSignatureExpired",
  {
    environmentId: Schema.String,
    threadId: Schema.String,
    expiresAt: Schema.String,
  },
) {
  override get message(): string {
    return `Environment '${this.environmentId}' publish signature for thread '${this.threadId}' expired at ${this.expiresAt}`;
  }
}

export class EnvironmentPublishSignatureInvalid extends Schema.TaggedError<EnvironmentPublishSignatureInvalid>()(
  "EnvironmentPublishSignatureInvalid",
  {
    environmentId: Schema.String,
    threadId: Schema.String,
    reason: RelayAgentActivityPublishProofInvalidReason,
    stage: Schema.Literals([
      "decode_token",
      "verify_proof",
      "validate_claims",
      "validate_expiration",
      "generate_replay_thumbprint",
      "consume_nonce",
    ]),
    cause: Schema.optional(Schema.Defect()),
  },
) {
  override get message(): string {
    return `Environment '${this.environmentId}' publish signature for thread '${this.threadId}' is invalid during ${this.stage}: ${this.reason}`;
  }
}

export type EnvironmentPublishSignatureError =
  | EnvironmentPublishSignatureExpired
  | EnvironmentPublishSignatureInvalid
  | DpopProofs.DpopProofReplayPersistenceError;

export class EnvironmentPublishSignatures extends Context.Service<
  EnvironmentPublishSignatures,
  {
    readonly verify: (input: {
      readonly environmentId: string;
      readonly environmentPublicKey: string;
      readonly threadId: string;
      readonly request: RelayAgentActivityPublishRequest;
    }) => Effect.Effect<void, EnvironmentPublishSignatureError>;
  }
>()("t3code-relay/environments/EnvironmentPublishSignatures") {}

function environmentPublishReplayThumbprintData(input: {
  readonly environmentId: string;
  readonly environmentPublicKey: string;
}) {
  return new TextEncoder().encode(
    stableStringify({
      environmentId: input.environmentId,
      environmentPublicKey: input.environmentPublicKey,
    }),
  );
}

const formatEnvironmentPublishReplayThumbprint = (digest: Uint8Array) =>
  `env-publish:${Base64Url.encode(digest)}`;

const make = Effect.gen(function* () {
  const proofReplay = yield* DpopProofs.DpopProofReplay;
  const config = yield* RelayConfiguration.RelayConfiguration;
  const crypto = yield* Digest.Digest;
  const signature = yield* Signature.Signature;

  return EnvironmentPublishSignatures.of({
    verify: Effect.fn("relay.environment_publish_signatures.verify")(function* (input) {
      yield* Effect.annotateCurrentSpan({
        "relay.environment_id": input.environmentId,
        "relay.thread_id": input.threadId,
      });
      const now = yield* DateTime.now;
      const decoded = yield* decodeRelayJwt(input.request.proof).pipe(
        Effect.mapError(
          (cause) =>
            new EnvironmentPublishSignatureInvalid({
              environmentId: input.environmentId,
              threadId: input.threadId,
              reason: "invalid_signature_or_payload",
              stage: "decode_token",
              cause,
            }),
        ),
      );
      if (
        typeof decoded.exp === "number" &&
        decoded.exp <= Math.floor(now.epochMilliseconds / 1_000)
      ) {
        return yield* new EnvironmentPublishSignatureExpired({
          environmentId: input.environmentId,
          threadId: input.threadId,
          expiresAt: DateTime.formatIso(DateTime.makeUnsafe(decoded.exp * 1_000)),
        });
      }
      const proof = yield* verifyRelayJwt(RelayAgentActivityPublishProofPayload, {
        publicKey: input.environmentPublicKey,
        token: input.request.proof,
        typ: RELAY_ACTIVITY_PUBLISH_TYP,
        issuer: `t3-env:${input.environmentId}`,
        audience: normalizeRelayIssuer(config.relayIssuer),
      }).pipe(
        Effect.provideService(Signature.Signature, signature),
        Effect.mapError(
          (cause) =>
            new EnvironmentPublishSignatureInvalid({
              environmentId: input.environmentId,
              threadId: input.threadId,
              reason: "invalid_signature_or_payload",
              stage: "verify_proof",
              cause,
            }),
        ),
      );
      if (
        proof.environmentId !== input.environmentId ||
        proof.threadId !== input.threadId ||
        proof.sub !== input.environmentId ||
        stableStringify(proof.state) !== stableStringify(input.request.state) ||
        (input.request.state !== null &&
          (input.request.state.environmentId !== input.environmentId ||
            input.request.state.threadId !== input.threadId))
      ) {
        return yield* new EnvironmentPublishSignatureInvalid({
          environmentId: input.environmentId,
          threadId: input.threadId,
          reason: "invalid_signature_or_payload",
          stage: "validate_claims",
        });
      }
      const expiresAt = DateTime.make(proof.exp * 1_000);
      if (expiresAt._tag === "None") {
        return yield* new EnvironmentPublishSignatureInvalid({
          environmentId: input.environmentId,
          threadId: input.threadId,
          reason: "invalid_signature_or_payload",
          stage: "validate_expiration",
        });
      }
      const thumbprint = yield* crypto
        .digest(
          Digest.sha256,
          environmentPublishReplayThumbprintData({
            environmentId: input.environmentId,
            environmentPublicKey: input.environmentPublicKey,
          }),
        )
        .pipe(
          Effect.map(formatEnvironmentPublishReplayThumbprint),
          Effect.mapError(
            (cause) =>
              new EnvironmentPublishSignatureInvalid({
                environmentId: input.environmentId,
                threadId: input.threadId,
                reason: "invalid_signature_or_payload",
                stage: "generate_replay_thumbprint",
                cause,
              }),
          ),
        );
      const consumedNonce = yield* proofReplay.consume({
        thumbprint,
        jti: proof.jti,
        iat: proof.iat,
        expiresAt: expiresAt.value,
      });
      if (!consumedNonce) {
        return yield* new EnvironmentPublishSignatureInvalid({
          environmentId: input.environmentId,
          threadId: input.threadId,
          reason: "replayed_nonce",
          stage: "consume_nonce",
        });
      }
    }),
  });
});

export const layer = Layer.effect(EnvironmentPublishSignatures, make);