9fb6876f3b
* [AI] sync-server: use workspace reference for @actual-app/crdt Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Update build script in sync-server package to use TypeScript's build mode * Package electron * [AI] crdt: add conditional exports so Node can load the built bundle Before this change the root exports entry pointed at `./src/index.ts`, so any pure-Node consumer (notably the sync server that Electron forks as a utility process) failed to import `@actual-app/crdt` — Node can't execute TypeScript source directly. Sync-server had been masking this by pulling `@actual-app/crdt@npm:2.1.0` where `publishConfig.exports` resolves to `./dist/index.js`; once sync-server switched to `workspace:*`, the Functional Desktop App CI job timed out waiting for the sync server to boot. Switch to conditional exports in the same shape `@actual-app/api` already uses: - `types` → `./dist/index.d.ts` for TypeScript tooling - `development` → `./src/index.ts` for Vite/Vitest (HMR, fast feedback) - `default` → `./dist/index.js` for Node runtime Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@actual-app/crdt
This package contains the core CRDT logic that enables Actual's syncing. It is shared between the client and server. We may or may not follow semver when updating this package; any usage of it outside Actual is undocumented and at your own risk.
protobuf
We use protobuf to encode messages as binary data to send across the network.
Generating protobuf
The protobuf is generated by using the protoc compiler.
This can be installed by downloading one of the pre-built binaries and placing it in your $PATH. The version used to build the current protobuf is v3.20.1. You'll also need to download the latest version of protoc-gen-js. For convenience, you can put both of these binaries in ./bin.
Once installed, the protobuf can be generated by running ./bin/generate-proto.
However there is one very important thing to remember! The default output includes this near the top:
var global = (function() { return this || window || global || self || Function('return this')(); }).call(null);
This will not work with our CSP directives. You must manually modify this to this:
var global = globalThis;