refactor: new package architecture

jonathanlab · jonathanlab · commit 444f7a0ab5ab · 2026-05-27T15:26:08.000+02:00
diff --git a/biome.jsonc b/biome.jsonc
@@ -162,6 +162,173 @@
         }
       }
     },
+    {
+      "includes": ["packages/core/src/**/*.ts", "packages/core/src/**/*.tsx"],
+      "linter": {
+        "rules": {
+          "style": {
+            "noRestrictedImports": {
+              "level": "error",
+              "options": {
+                "patterns": [
+                  {
+                    "group": [
+                      "electron",
+                      "react",
+                      "react-dom",
+                      "node:*",
+                      "@posthog/*"
+                    ],
+                    "message": "core is a pure layer that must not depend on any platform-specific dependencies."
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "includes": [
+        "packages/api-client/src/**/*.ts",
+        "packages/api-client/src/**/*.tsx"
+      ],
+      "linter": {
+        "rules": {
+          "style": {
+            "noRestrictedImports": {
+              "level": "error",
+              "options": {
+                "patterns": [
+                  {
+                    "group": [
+                      "electron",
+                      "node:*",
+                      "@posthog/*",
+                      "!@posthog/core"
+                    ],
+                    "message": "api-client must run in any JS environment."
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "includes": [
+        "packages/workspace-client/src/**/*.ts",
+        "packages/workspace-client/src/**/*.tsx"
+      ],
+      "linter": {
+        "rules": {
+          "style": {
+            "noRestrictedImports": {
+              "level": "error",
+              "options": {
+                "patterns": [
+                  {
+                    "group": [
+                      "electron",
+                      "node:*",
+                      "@posthog/*",
+                      "!@posthog/core",
+                      "!@posthog/api-client",
+                      "!@posthog/workspace-server"
+                    ],
+                    "message": "workspace-client must run in any JS environment."
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "includes": [
+        "packages/platform/src/**/*.ts",
+        "packages/platform/src/**/*.tsx"
+      ],
+      "linter": {
+        "rules": {
+          "style": {
+            "noRestrictedImports": {
+              "level": "error",
+              "options": {
+                "patterns": [
+                  {
+                    "group": [
+                      "electron",
+                      "node:*",
+                      "@posthog/*",
+                      "!@posthog/core"
+                    ],
+                    "message": "platform is interface-only."
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "includes": [
+        "packages/workspace-server/src/**/*.ts",
+        "packages/workspace-server/src/**/*.tsx"
+      ],
+      "linter": {
+        "rules": {
+          "style": {
+            "noRestrictedImports": {
+              "level": "error",
+              "options": {
+                "paths": {
+                  "electron": "workspace-server must be host-agnostic."
+                },
+                "patterns": [
+                  {
+                    "group": ["@posthog/ui", "@posthog/api-client"],
+                    "message": "workspace-server must not depend on UI or the PostHog API."
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "includes": ["packages/ui/src/**/*.ts", "packages/ui/src/**/*.tsx"],
+      "linter": {
+        "rules": {
+          "style": {
+            "noRestrictedImports": {
+              "level": "error",
+              "options": {
+                "patterns": [
+                  {
+                    "group": [
+                      "electron",
+                      "node:*",
+                      "@posthog/*",
+                      "!@posthog/core",
+                      "!@posthog/api-client",
+                      "!@posthog/workspace-client",
+                      "!@posthog/platform",
+                      "!@posthog/platform/*"
+                    ],
+                    "message": "ui must run in any JS environment."
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
     {
       // Renderer code should use path aliases
       "includes": [
diff --git a/packages/api-client/package.json b/packages/api-client/package.json
@@ -0,0 +1,32 @@
+{
+  "name": "@posthog/api-client",
+  "version": "1.0.0",
+  "description": "Client for the PostHog API (auth, projects, task metadata, billing). Pure HTTPS, runs in any JS environment. Constructed via factory function — no DI container.",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "node ../../scripts/rimraf.mjs dist .turbo"
+  },
+  "dependencies": {
+    "@posthog/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@posthog/tsconfig": "workspace:*",
+    "@posthog/tsup-config": "workspace:*",
+    "tsup": "catalog:",
+    "typescript": "catalog:"
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*"
+  ]
+}
diff --git a/packages/api-client/src/index.ts b/packages/api-client/src/index.ts
@@ -0,0 +1 @@
+export {};
diff --git a/packages/api-client/tsconfig.json b/packages/api-client/tsconfig.json
@@ -0,0 +1,4 @@
+{
+  "extends": "@posthog/tsconfig/base.json",
+  "include": ["src/**/*"]
+}
diff --git a/packages/api-client/tsup.config.ts b/packages/api-client/tsup.config.ts
@@ -0,0 +1,3 @@
+import { defineLibPackage } from "@posthog/tsup-config";
+
+export default defineLibPackage();
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -0,0 +1,29 @@
+{
+  "name": "@posthog/core",
+  "version": "1.0.0",
+  "description": "Zero-dependency pure domain layer. Types, schemas, pure functions. Runs in any JS environment (Node, Bun, browser, RN, edge). No I/O, no platform calls, no framework deps.",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "node ../../scripts/rimraf.mjs dist .turbo"
+  },
+  "devDependencies": {
+    "@posthog/tsconfig": "workspace:*",
+    "@posthog/tsup-config": "workspace:*",
+    "tsup": "catalog:",
+    "typescript": "catalog:"
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*"
+  ]
+}
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
@@ -0,0 +1 @@
+export {};
diff --git a/packages/core/tsconfig.json b/packages/core/tsconfig.json
@@ -0,0 +1,4 @@
+{
+  "extends": "@posthog/tsconfig/base.json",
+  "include": ["src/**/*"]
+}
diff --git a/packages/core/tsup.config.ts b/packages/core/tsup.config.ts
@@ -0,0 +1,3 @@
+import { defineLibPackage } from "@posthog/tsup-config";
+
+export default defineLibPackage();
diff --git a/packages/ui/package.json b/packages/ui/package.json
@@ -0,0 +1,43 @@
+{
+  "name": "@posthog/ui",
+  "version": "1.0.0",
+  "description": "React UI layer. Components, stores, hooks. Pure rendering and UI state — no I/O, no business logic. Built on @posthog/quill. Consumed by every host app (desktop, web, mobile-web).",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "node ../../scripts/rimraf.mjs dist .turbo"
+  },
+  "dependencies": {
+    "@posthog/api-client": "workspace:*",
+    "@posthog/core": "workspace:*",
+    "@posthog/platform": "workspace:*",
+    "@posthog/workspace-client": "workspace:*"
+  },
+  "peerDependencies": {
+    "react": "catalog:",
+    "react-dom": "catalog:"
+  },
+  "devDependencies": {
+    "@posthog/tsconfig": "workspace:*",
+    "@posthog/tsup-config": "workspace:*",
+    "@types/react": "catalog:",
+    "@types/react-dom": "catalog:",
+    "react": "catalog:",
+    "react-dom": "catalog:",
+    "tsup": "catalog:",
+    "typescript": "catalog:"
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*"
+  ]
+}
diff --git a/packages/ui/src/index.ts b/packages/ui/src/index.ts
@@ -0,0 +1 @@
+export {};
diff --git a/packages/ui/tsconfig.json b/packages/ui/tsconfig.json
@@ -0,0 +1,4 @@
+{
+  "extends": "@posthog/tsconfig/react-package.json",
+  "include": ["src/**/*"]
+}
diff --git a/packages/ui/tsup.config.ts b/packages/ui/tsup.config.ts
@@ -0,0 +1,5 @@
+import { defineLibPackage } from "@posthog/tsup-config";
+
+export default defineLibPackage({
+  external: ["react", "react-dom"],
+});
diff --git a/packages/workspace-client/package.json b/packages/workspace-client/package.json
@@ -0,0 +1,34 @@
+{
+  "name": "@posthog/workspace-client",
+  "version": "1.0.0",
+  "description": "Client for a workspace-server (local OR sandbox-via-relay). Thin tRPC client; routes via api-client to resolve sandbox endpoints. Runs in any JS environment.",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "node ../../scripts/rimraf.mjs dist .turbo"
+  },
+  "dependencies": {
+    "@posthog/api-client": "workspace:*",
+    "@posthog/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@posthog/tsconfig": "workspace:*",
+    "@posthog/tsup-config": "workspace:*",
+    "@posthog/workspace-server": "workspace:*",
+    "tsup": "catalog:",
+    "typescript": "catalog:"
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*"
+  ]
+}
diff --git a/packages/workspace-client/src/index.ts b/packages/workspace-client/src/index.ts
@@ -0,0 +1 @@
+export {};
diff --git a/packages/workspace-client/tsconfig.json b/packages/workspace-client/tsconfig.json
@@ -0,0 +1,4 @@
+{
+  "extends": "@posthog/tsconfig/base.json",
+  "include": ["src/**/*"]
+}
diff --git a/packages/workspace-client/tsup.config.ts b/packages/workspace-client/tsup.config.ts
@@ -0,0 +1,3 @@
+import { defineLibPackage } from "@posthog/tsup-config";
+
+export default defineLibPackage();
diff --git a/packages/workspace-server/package.json b/packages/workspace-server/package.json
@@ -0,0 +1,22 @@
+{
+  "name": "@posthog/workspace-server",
+  "version": "1.0.0",
+  "description": "Workspace server: hosts privileged local/sandbox work (git, fs, watchers, processes) behind a tRPC server",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "clean": "node ../../scripts/rimraf.mjs .turbo"
+  },
+  "devDependencies": {
+    "@posthog/tsconfig": "workspace:*",
+    "@types/node": "catalog:",
+    "typescript": "catalog:"
+  }
+}
diff --git a/packages/workspace-server/src/index.ts b/packages/workspace-server/src/index.ts
@@ -0,0 +1 @@
+export {};
diff --git a/packages/workspace-server/tsconfig.json b/packages/workspace-server/tsconfig.json
@@ -0,0 +1,4 @@
+{
+  "extends": "@posthog/tsconfig/node-package.json",
+  "include": ["src/**/*"]
+}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
diff --git a/tooling/tsup-config/index.ts b/tooling/tsup-config/index.ts
diff --git a/tooling/tsup-config/package.json b/tooling/tsup-config/package.json
diff --git a/tooling/typescript/base.json b/tooling/typescript/base.json
diff --git a/tooling/typescript/node-package.json b/tooling/typescript/node-package.json
diff --git a/tooling/typescript/package.json b/tooling/typescript/package.json
diff --git a/tooling/typescript/react-package.json b/tooling/typescript/react-package.json

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +{
 +  "extends": "@posthog/tsconfig/base.json",
 +  "include": ["src/**/*"]
 +}
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+import { defineLibPackage } from "@posthog/tsup-config";`
	`2`	`+`
	`3`	`+export default defineLibPackage();`