Use TypeScript Project References with PNPM Workspaces (#4137)

Given colocation of package and app sources, this repository lends
itself well to engendering further mono-repository tooling.

This PR proposes utilizing [TypeScript Project
References](https://www.typescriptlang.org/docs/handbook/project-references.html)
to source inter-repository packages locally from the repository rather
than relying on published artifacts.

**Implications:**
- No longer must packages be published publicly before utilizing package
changes in consuming applications.
- All workspace enabled projects in the repository depend directly on
the live code for colocated packages, rather than on published
artifacts.
- Package changes can now be "dogfooded" prior to planned public
release.
- LSP developer experience is improved such that "go-to" calls point
directly to in-repository source rather than `node_modules/*`.
- `test/*` files can now import code exactly as an artifact consumer
would (e.g. `import * as _ from "@unionlabs/sdk"` rather than `import *
as _ from "../src/index.js"`) which allows for unit tests to serve as
usage examples.

It is proposed to leverage PNPM over NPM to additionally improve
mono-repository tooling:
- PNPM should be preferred over NPM for the following reasons:
  - Mature handling for workspaces.
- Defense against [phantom
dependencies](https://rushjs.io/pages/advanced/phantom_deps/).
- Defense against [NPM
doppelgangers](https://rushjs.io/pages/advanced/npm_doppelgangers/).
  - Strict handling for peer dependencies.
- PNPM workspaces allows for patches to be declared once and inherited
by all workspace projects (without the need for `patch-package`).

~This PR additionally introduces, for `@unionlabs/sdk`, the same build
system as `effect` which produces tree-shakeable module-based path
imports in both CJS and ESM formatting.~
CJS determined not a necessary artifact target. `@unionlabs/sdk` build
system been adjusted to leverage `tsc` enhanced with `babel` for
annotating pure calls which should improve tree-shaking with certain
bundlers (especially `webpack`).

**Miscellaneous:**
- Some packages (e.g. `effect` and `viem`) have been moved to
`peerDependencies` where appropriate and gated by major version number
such that consumers are not at risk of bundling multiple versions.
- `"DOM"` added to `@unionlabs/client` TS config `"lib"` entry to ensure
global `Crypto` API is well-defined, which was previously pointing to a
`bun` stub.
- [`dpdm`](https://github.com/acrazing/dpdm) added to `@unionlabs/sdk`
to detect circular dependencies.
- Path-based imports (e.g. `#/path/after/package/src`) have been removed
in `@unionlabs/client` as it provides no benefit and causes issues with
project references.
- Project-speciifc Nix files (e.g. `app2/app2.nix`, `ts-sdk/ts-sdk.nix`)
have been preserved—`buildPnpmPackage.nix` function is provided to make
usage easier than traditional `bulidNpmPackage`.

**Caveats:**
- This does not touch `app` or `sentinel` projects—only projects
required to develop `app2`.
~- Import paths (and thereby modules) must be well-defined in
`@unionlabs/sdk`, which means removal of barrel files (good from a
performance standpoint).~ (slated for future enhancement)

Author: ehegnes

.gitignore

@@ -86,3 +86,5 @@ rustc-ice*
 .docs
 profiles/
 contracts.json
+dist/
+*.tsbuildinfo

app2/app2.nix

@@ -1,42 +1,58 @@
 _: {
   perSystem =
     {
-      lib,
       pkgs,
       pkgsUnstable,
       ensureAtRepositoryRoot,
+      lib,
       ...
     }:
     let
+      buildPnpmPackage = import ../tools/typescript/buildPnpmPackage.nix {
+        inherit pkgs lib;
+      };
       deps = with pkgsUnstable; [
         python3
         stdenv.cc
         pkg-config
         nodePackages_latest.nodejs
-        nodePackages_latest."patch-package"
+        pnpm_10
       ];
-      packageJSON = lib.importJSON ./package.json;
     in
     {
       packages = {
-        app2 = pkgsUnstable.buildNpmPackage {
-          npmDepsHash = "sha256-cgmgvbMV9lIFG4YEA5W2Vk3uvjUIp2BNWcQrEmrortE=";
-          src = ./.;
-          sourceRoot = "app2";
-          npmFlags = [ "--legacy-peer-deps" ];
-          pname = packageJSON.name;
-          inherit (packageJSON) version;
-          nativeBuildInputs = deps;
+        app2 = buildPnpmPackage rec {
+          packageJsonPath = ./package.json;
+          extraSrcs = [
+            ../app2
+            ../typescript-sdk
+            ../ts-sdk
+          ];
+          hash = "sha256-nR7H08cOxhjn1PgbvdBdDoLahV+xQCFw0Xpoi2oCfII=";
           buildInputs = deps;
+          nativeBuildInputs = buildInputs;
+          pnpmWorkspaces = [
+            "app2"
+            "@unionlabs/sdk"
+            "@unionlabs/client"
+          ];
+          buildPhase = ''
+            runHook preBuild
+            pnpm --filter=app2 prepare
+            pnpm --filter=app2 build
+            runHook postBuild
+          '';
+          checkPhase = ''
+            pnpm --filter=app2 check
+          '';
+          doCheck = false; # TODO(ehegnes): enable checks
           installPhase = ''
             mkdir -p $out
-            cp -r ./build/* $out
+            cp -r ./app2/build/* $out
           '';
           doDist = false;
-          NODE_OPTIONS = "--no-warnings";
         };
       };
-
       apps = {
         app2-dev-server = {
           type = "app";
@@ -46,9 +62,8 @@ _: {
             text = ''
               ${ensureAtRepositoryRoot}
               cd app2/
-
-              npm install
-              npm run dev -- --host
+              pnpm install
+              pnpm run dev -- --host
             '';
           };
         };
@@ -60,9 +75,8 @@ _: {
             text = ''
               ${ensureAtRepositoryRoot}
               cd app2/
-              npx gql.tada generate-schema --tsconfig ./tsconfig.json --output "./src/generated/schema.graphql" "https://development.graphql.union.build/v1/graphql"
-
-              npx gql.tada generate-output --disable-preprocessing --tsconfig ./tsconfig.json --output ./src/generated/graphql-env.d.ts
+              pnpm dlx gql.tada generate-schema --tsconfig ./tsconfig.json --output "./src/generated/schema.graphql" "https://development.graphql.union.build/v1/graphql"
+              pnpm dlx gql.tada generate-output --disable-preprocessing --tsconfig ./tsconfig.json --output ./src/generated/graphql-env.d.ts
             '';
           };
         };