sync-debug

Start by running ntn workers sync status and ntn workers runs list to find failed runs, then fetch logs with ntn workers runs logs <runId>. Cross-reference the error messages with your sync code in src/index.ts to identify the root cause.

Check OAuth configuration with ntn workers oauth token <oauthKey> and verify environment variables with ntn workers env list. Push missing variables with ntn workers env push, or re-authenticate an expired token using ntn workers oauth start <key>.

An infinite loop happens when hasMore stays true because the cursor is not advancing. Check that nextState changes between iterations and that the termination condition in your execute function is actually reachable.

State errors usually come from first runs where state is undefined, or from persisted state having an old shape after a code update. Fix it by running ntn workers sync state reset <key> to clear state and re-backfill from scratch.

Empty results typically mean the API returned no data due to a wrong endpoint, incorrect query parameters, or insufficient permissions despite working auth. Test the API call directly with curl or local execution to isolate the cause.